Label Generation

Translate an order into shipment parcel(s), and get in return the shipment label and documents

Order Processing

1. From Order to Shipment: An order of multiple products can be split into multiple fulfilments and parcels to maximise inventory usage and minimise delivery time. Glopal amends the original order and creates a new order entity per fulfilment and eventually parcel, and recomputes total landing costs separately for each entity.

2. Shipping Label Generation: Once the shipment entities are known, Glopal can prepare the shipping documents and request the shipping labels from its network of pre-integrated carriers.

Native API Integration

Announce order fulfillment structure and/or process parcel labels and documents

POSThttps://ws.xport.glopalservice.com/outbound/immediate_shipment

Header parameters

Body

application/json

orderobject

Response

200

OK

Body

application/json

error*enum

Boolean defining call success

Example: 0

10

errorsarray of object

List of errors

warningsarray of object

List of warnings

advicearray of object

Shipment document details

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://ws.xport.glopalservice.com/outbound/immediate_shipment', {
    method: 'POST',
    headers: {
      "x-login": "username",
      "x-signature": "40b976b35a08bb951439ea7bbfa0a7bd73dab7c813399a31d9d1a157bc08929b",
      "x-timestamp": "1680010295.775523",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "order": {
        "reference": "test123",
        "carrier_service": "XXX_Expres_worldwide",
        "async_mode": 1,
        "switch_b2b2c": 1,
        "delivery_instruction": "Fragile",
        "parcel": [
          {
            "consolidation_id": "CON1234",
            "shipment_reference": "test123",
            "height": 23.45,
            "width": 34.56,
            "depth": 13.57,
            "box_code": "BIGBOX",
            "weight_unit": "kg",
            "dimension_unit": "cm",
            "weight": 12.34,
            "outboundawb": "AWB1234567890_23",
            "wms_hubcode": "TRT",
            "wms_id": "WMS12345",
            "sale_id": "SALE1233",
            "fulfillment_id": "FU.123OMS",
            "eei_itn": "X20191024012345",
            "item": [
              {
                "qty": 1,
                "gtin": 1234567890,
                "merchant_sku": 1234567890,
                "alt_merchant_sku": [
                  1234567890
                ]
              }
            ]
          }
        ]
      }
    }),
});
const data = await response.json();

Response

200

{
  "error": 0,
  "errors": [
    {
      "code": "ISSUE_CODE",
      "details": "Issue description",
      "field": "field"
    }
  ],
  "warnings": [
    {
      "code": "ISSUE_CODE",
      "details": "Issue description",
      "field": "field"
    }
  ],
  "advice": [
    {
      "ship_from": {
        "name": "Test Testington",
        "user_reference": "testref",
        "address1": "Test street 1",
        "address2": "Second floor",
        "address3": "Room 37",
        "postcode": 90210,
        "state": "CA",
        "city": "Beverly Hills",
        "country": "US"
      },
      "ship_to": {
        "name": "Test Testington",
        "user_reference": "testref",
        "address1": "Test street 1",
        "address2": "Second floor",
        "address3": "Room 37",
        "postcode": 90210,
        "state": "CA",
        "city": "Beverly Hills",
        "country": "US"
      },
      "date": "2023-01-23 12:13:14",
      "outboundawb": "AWB1234567890_23",
      "web_order": "test123",
      "shipment_id": 123456,
      "pod_id": 1,
      "suite_number": "5432-1234",
      "vat_number": "T12344434",
      "reason_for_export": "Permanent",
      "product": [
        {
          "qty": 1,
          "measure": "Item",
          "mnfgr": "FR",
          "hs_code": 330310,
          "sku": 1234567890,
          "description": "Pink summer dress",
          "note": "Special packaging",
          "unit_value": 234.56,
          "sub_total": 234.56,
          "alt_merchant_sku": [
            1234567890
          ],
          "documentation": [
            {
              "code": "Dress",
              "description": "Test description"
            }
          ]
        }
      ],
      "declared_value": 234.56,
      "invoice_total": 234.56,
      "currency": "text",
      "terms_of_trade": "DDP",
      "total_packages": 1,
      "package": {
        "height": 23.45,
        "width": 34.56,
        "depth": 13.57,
        "weight_unit": "kg",
        "dimension_unit": "cm",
        "dead_weight": 12.34
      },
      "transport": {
        "carrier": "DHL",
        "service": "DHL Express"
      },
      "fulfillment_id": "FU.123OMS",
      "transaction_id": "642edad40de2f361ba4d1684aaf3c53a0afc687b",
      "wms_id": "WMS12345",
      "outbound": {
        "is_paperless": 1,
        "transit_number": "TRANS12344",
        "awb": "AWB1234567890_23",
        "tracking_url": "https://test.xport.glopalservice.com/test",
        "carrier_tracking_url": "https://test.xport.glopalservice.com/test",
        "carrier_name": "DHL Express",
        "label_file_zpl": "document/example.zpl",
        "label_file_pdf": "document/example.pdf",
        "advice_file_pdf": "document/example.pdf",
        "label_url_zpl": "https://test.xport.glopalservice.com/test",
        "label_url_pdf": "https://test.xport.glopalservice.com/test",
        "advice_url_pdf": "https://test.xport.glopalservice.com/test",
        "label_dpi_density": 300,
        "label_type": "BL4x6"
      },
      "return": {
        "awb": "AWB1234567890_23",
        "tracking_url": "https://test.xport.glopalservice.com/test",
        "carrier_tracking_url": "https://test.xport.glopalservice.com/test",
        "carrier_name": "DHL Express",
        "label_file_zpl": "document/example.zpl",
        "label_file_pdf": "document/example.pdf",
        "advice_file_pdf": "document/example.pdf",
        "label_url_zpl": "https://test.xport.glopalservice.com/test",
        "label_url_pdf": "https://test.xport.glopalservice.com/test",
        "advice_url_pdf": "https://test.xport.glopalservice.com/test",
        "label_dpi_density": 300,
        "label_type": "BL4x6"
      },
      "last_mile": {
        "awb": "AWB1234567890_23",
        "tracking_url": "https://test.xport.glopalservice.com/test",
        "carrier_tracking_url": "https://test.xport.glopalservice.com/test",
        "carrier_name": "DHL Express",
        "label_file_zpl": "document/example.zpl",
        "label_file_pdf": "document/example.pdf",
        "advice_file_pdf": "document/example.pdf",
        "label_url_zpl": "https://test.xport.glopalservice.com/test",
        "label_url_pdf": "https://test.xport.glopalservice.com/test",
        "advice_url_pdf": "https://test.xport.glopalservice.com/test",
        "label_dpi_density": 300,
        "label_type": "BL4x6"
      }
    }
  ]
}