Barcode Information V2


DESCRIPTION

The customer can use this API to obtain detailed information about the pieces (boxes) associated with a specific shipment, providing full visibility and real-time traceability. This service returns data for both coordinated pieces (planned but not yet physically received) and received pieces.

Request

Method: GET

URL:

Test Environment: https://training.logiztikalliance.com:5005/logCloudWSPre/api/v2/ClientesExternosA/ListarCodigosDeBarraPorClienteNew/{CUSTOMERCODE}/{SHIPMENTNR}
Production Environment: https://cloud.logiztikalliance.com:5005/logCloudWS/api/v2/ClientesExternosA/ListarCodigosDeBarraPorClienteNew/{CUSTOMERCODE}/{SHIPMENTNR}
API Test Environment Access
To access the API test environment, please contact our Customer Service team at customerservice.ec@logiztikalliance.com. Be sure to include the IP address from which testing will be performed.
Example: 123.123.125.14

INPUT PARAMETERS
Name Type Required Description
customerCode String (50) Yes Customer code.
shipmentNr String (50) Yes Shipment number.
authenticationToken String (128) Yes Alliance cloud security token (Api Key).

BODY

Pieces Received

[
{
“barcode”: “GM495597976”,
“hawb”: “LA1602077283”,
“consigneeName”: “TEST IN & OUT”,
“consigneeCode”: “CLI0128222”,
“exporterName”: “TEST.”,
“exporterCode”: “SIR”,
“carrierName”: “LUNA TRANSPORT”,
“carrierCode”: “LUN”,
“length”: 100.000,
“width”: 30.000,
“height”: 18.000,
“unitOfMeasurement”: “CM”,
“grossWeight”: 6.700,
“volumeWeight”: 9.000,
“shipmentMeasureVolume”: true,
“productCode”: “73489”,
“productDescription”: “ROSAS”,
“packing”: 182,
“piecePrice”: 648.000,
“supplierDeliveryDate”: “2026-02-24 22:04:09”,
“boxSize”: “QB”,
“status”: “RECEIVED”
},



Coordinated Pieces

[
{
“barcode”: “”,
“hawb”: “LA12525865”,
“consigneeName”: ” MSG MIX “,
“consigneeCode”: “CLI0569”,
“exporterName”: “AGRINAG S.A.S.”,
“exporterCode”: “FL-5696”,
“carrierName”: “”,
“carrierCode”: “”,
“length”: 0.0,
“width”: 0.0,
“height”: 0.0,
“unitOfMeasurement”: “CM”,
“grossWeight”: 0.0,
“volumeWeight”: 0.0,
“shipmentMeasureVolume”: false,
“productCode”: “ROS”,
“productDescription”: “”,
“packing”: 0,
“piecePrice”: 0.0,
“supplierDeliveryDate”: “”,
“boxSize”: “HB”,
“status”: “confirmed”
}
]

 

 

RESPONSE

BODY

Name Type Obligatory Description
barcode string(16) Yes Barcode number that was shipped on the specific shipment.
hawb string(16) No House airway bill assigned to the piece
consigneeName string(512) No Name of the consignee assigned to the piece
consigneeCode string(32) No Customer relation code of the consignee
exporterName string(512) No Name of the exporter that delivered the piece
exporterCode string(32) No Exporter relation code
carrierName string(512) No Carrier name assigned to the piece
carrierCode decimal(9,3) No Length of the piece
length decimal(9,3) No Length of the piece
width decimal(9,3) No Width of the piece
height decimal(9,3) No Height of the piece
unitOfMeasurement string(16) Yes Unit of measure for the dimensions, CM or INCH.
grossWeight decimal(9,3) No Gross weight of the piece
volumeWeight decimal(9,3) No Volume weight of the piece
shipmentMeasureVolume boolean Yes True if the shipment was charged by volume weight, false if the shipment was charged by gross weight.
productCode string(32) No Product category code (ex. ROS for roses).
productDescription string(128) No Product variety, whatever text the customer or the supplier sent us.
packing int No Number of units in the box.
piecePrice decimal(9,3) No Supplier price of the box.
supplierDeliveryDate datetime(yyyy-MM-dd HH:mm:ss) No Supplier delivery date and time.
boxSize string(16) No Type of box
status string Yes Status of the piece (Received or Confirmed).

OUTPUT ERROR MESSAGES

Wrong token:

“Unauthorized”

Error in customer code:

{

“error”: “The ApiKey does not have access to that customer code”

}

Error in shipment number:

{

“error”: “The shipment number does not contain pieces of the customer.”

}

Missing parameters:

{

“error”: “Missing input parameters. Please send Authentication Token, Shipment Number and Customer Code. ”

}

Error in database connection:

{

“error”: “Error in database connection.”

}

Customer does not exist:

{

“error”: “Customer does not exist.”

}