ST23 - Update carrier tracking information for shipments

Request

Description

If the carrier is not registered, the complete tracking url can be provided. Limited to 1000 shipments at a time.

Call Frequency

Recommended usage: On each shipment tracking info update

Maximum usage: On each shipment tracking info update

Security

Shop-API-Key(Required scopes: ROLE_SHOP_ADMIN)

Query

shop_idinteger, (int64)

Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

Bodyapplication/json

shipmentsArray of objects, [ 1 .. 1000 ] itemsrequired

Shipments list

curl -i -X POST \
  'https://your-instance.mirakl.net/api/shipments/tracking?shop_id=0' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "shipments": [
      {
        "id": "f40bf65e-a320-41d3-878c-36ce9e1144ce",
        "tracking": {
          "carrier_code": "UPS",
          "carrier_name": "UPS",
          "carrier_standard_code": "UPS",
          "tracking_number": "1Z2356F1ZJ98L9733M5",
          "tracking_url": "https://wwwapps.ups.com/WebTracking/track?track=yes&trackNums={trackingId}"
        }
      },
      {
        "id": "ff341bfe-ebeb-4211-848b-77fcbcd91723",
        "tracking": {
          "carrier_code": "UPS",
          "carrier_name": "UPS",
          "carrier_standard_code": "UPS",
          "tracking_number": "1Z2356F1ZJ98L9733M5",
          "tracking_url": "https://wwwapps.ups.com/WebTracking/track?track=yes&trackNums={trackingId}"
        }
      }
    ]
  }'

Responses

OK

Bodyapplication/json

shipment_errorsArray of objects

Shipment workflow update errors

shipment_successArray of objects

Shipment workflow update success

Response

{
  "shipment_errors": [
    { … }
  ],
  "shipment_success": [
    { … }
  ]
}