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} |
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.”
}
