Agregar número de seguimiento a ordenes

El siguiente endpoint te permite realizar carga de números de seguimiento a las órdenes pendientes de envío. El proceso de carga de guías de seguimiento a las órdenes es muy sencillo, necesitas hacer referencia de la orden con el identificador y/o el número de orden interno de tu comercio, agregar el código de la compañía de mensajería como parámetro opcional, y por último el número de seguimiento.

Este servicio dará como respuesta un resumen de las órdenes aceptadas, órdenes rechazadas y órdenes no encontradas. Así mismo con el detalle de órdenes de números de seguimiento fallidos.

💡 Recuerda que debes de utilizar el Bearer Token anteriormente generado Token de acceso

ENDPOINT

POST  https://api.zenki.fi/v1/api/tracking

Headers
- Accept: application/json
- Authorization: Bearer Tokens
Authorization [Bearer Token]
- Token: (token)
Body [raw / json]
- orderId : (string | required)
- merchantOrderId : (string)
- courier : (string)
- trackingId : (string | required)
Atributos de respuesta
- acceptedOrders: (number)
- rejectedOrders: (number)
- ordersNotFound: (number)
- ordersSelectCourier: (number)
- shipmentFailed: (Array)
  - orderId: (string)
  - merchantOrderId: (string)
  - trackingId: (string)
  - courier: (string)
  - errorMessage: (string)
- shipmentSelectCourier: (Array)
  - orderId: (string)
  - merchantOrderId: (string)
  - trackingId: (string)
  - courier: (string)
  - possibleCouriers: (Array)
    - key: (string)
    - country: (string)
    - url: (string)
    - name: (string)
    - nameZhCn: (string)
    - nameZhHk: (string)
    - group: (string)

cURL

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


curl --request POST \
     --url https://api.zenki.fi/v1/api/tracking \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICIwenJMTnEwbzBab1R4NTlaeWVPaTI1RGxZLWl6cV91SVFSLThWS0RaWjlFIn0.eyJleHAiOjE2NjE3OTg0NDgsImlhdCI6MTY2MTc5NjY0OCwianRpIjoiOWNlZjIwNjItYTc1OS00NzllLWJlYTctZDQ1NzRiYWIzYzM5IiwiaXNzIjoiaHR0cHM6Ly9kZXYtYXV0aC56ZW5raS5maS9hdXRoL3JlYWxtcy9wYnciLCJhdWQiOiJhY2NvdW50Iiwic3ViIjoiZWQ3ZWQ1ZmMtZjBmNy00OWEwLWEwNWYtNWNiZTFkMjZkYTlkIiwidHlwIjoiQmVhcmVyIiwiYXpwIjoiemVua2ktcGF5Iiwic2Vzc2lvbl9zdGF0ZSI6IjdiOGJmOWQ5LWE5MjEtNDEzYi1hZTU5LWU4ODMwMDViMmViZCIsImFjciI6IjEiLCJhbGxvd2VkLW9yaWdpbnMiOlsiIl0sInJlYWxtX2FjY2VzcyI6eyJyb2xlcyI6WyJhcGkiLCJhcGlfemVua2lwYXkiLCJkZWZhdWx0LXJvbGVzLW1ldGFiYW4iXX0sInJlc291cmNlX2FjY2VzcyI6eyJhY2NvdW50Ijp7InJvbGVzIjpbIm1hbmFnZS1hY2NvdW50IiwibWFuYWdlLWFjY291bnQtbGlua3MiLCJ2aWV3LXByb2ZpbGUiXX19LCJzY29wZSI6InByb2ZpbGUgZW1haWwiLCJzaWQiOiI3YjhiZjlkOS1hOTIxLTQxM2ItYWU1OS1lODgzMDA1YjJlYmQiLCJlbWFpbF92ZXJpZmllZCI6dHJ1ZSwibmFtZSI6IlJlYWwgTWFkcmlkIEZDIFJlYWwgTWFkcmlkIEZDIiwicHJlZmVycmVkX3VzZXJuYW1lIjoiOGRjNDY5YTFkZTRiNDI3NTljMDdjNGYyYmQ2YzAzZjQiLCJnaXZlbl9uYW1lIjoiUmVhbCBNYWRyaWQgRkMiLCJsb2NhbGUiOiJlbiIsImZhbWlseV9uYW1lIjoiUmVhbCBNYWRyaWQgRkMiLCJlbWFpbCI6IjhkYzQ2OWExZGU0YjQyNzU5YzA3YzRmMmJkNmMwM2Y0In0.NxCesCEovDZoTXeLJqOnFdPPZ6WflbBdlokqcehmxRraGFxGQDsrVZTdvPa9JyaK86F4RzHBElZrGBbrKOgACxMXJHj-kbftxD3GCbvJIjtN1eTefhQE8q7D27wAKGMAMmRNKbGZ0mGiEpLDODQkNrcue6f3SnQv3ed4A7AeqfzxH02BrZpTHuq3ZL4_3JtlL5OvRcBQ8hA7pnnDA5ukSlcfuztnNzxkd7o3ktM1Wclni4RKtl_Flu4Du2FaFU9sub7LPJMb_BlHmXphWUNOe5JF_csncvPK-6O0qYokMUWlxi48O2y8fNkC0kWlUZHqEjm2PT7QeHW3oq515kV3Vg' \
     --header 'Content-Type: application/json' \
     --data '
[{
     "orderId": "79d8d1bae04642cc8f86cce2f521f3a0",
     "trackingId": "3212434451",
     "courier": "1",
     "merchantOrderId": "290822A"
}]
'

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45


{
    "acceptedOrders": 1,
    "rejectedOrders": 1,
    "ordersNotFound": 0,
    "ordersSelectCourier": 1,
    "shipmentFailed": [
        {
            "orderId": "79d8d1bae04642cc8f86cce2f521f3a0",
            "merchantOrderId": "67643321241",
            "trackingId": "1456456",
            "courier": 12,
            "errorMessage": "The value of '12' is invalid."
        }
    ],
    "shipmentSelectCourier": [
        {
            "orderId": "717df0e00fe849aeaa76ff27355ff3a0",
            "merchantOrderId": null,
            "trackingId": "906587618687",
            "courier": null,
            "possibleCouriers": [
                {
                    "key": "100003",
                    "country": "0",
                    "countryIso": "",
                    "url": "http://www.fedex.com/",
                    "name": "Fedex",
                    "nameZhCn": "Fedex",
                    "nameZhHk": "Fedex",
                    "group": "11"
                },
                {
                    "key": "100005",
                    "country": "0",
                    "countryIso": "",
                    "url": "https://gls-group.eu/EU/en/home",
                    "name": "GLS",
                    "nameZhCn": "GLS",
                    "nameZhHk": "GLS",
                    "group": "11"
                }
              ]
        }
    ]
}

Errores

Codigo	Descripción	json
401	La petición (request) no ha sido ejecutada porque carece de credenciales válidas de autenticación para el recurso solicitado.	Unauthorized