Notifica órdenes

Notificar órdenes de tipo servicio entregado

El siguiente endpoint te permite confirmar el envío del servicio relacionado con una orden. El proceso de notificación para órdenes de tipo servicio es muy sencillo, necesitas hacer referencia de la orden con el identificador ‘orderId’.

Este servicio dará como respuesta un resumen del estatus de la orden y de sus servicios.

💡 Recuerda que debes de utilizar él Bearer Token anteriormente generado Token de acceso

ENDPOINT

POST  https://api.zenki.fi/v1/api/escrow/orders/services/fulfillments

Headers
- Accept: application/json
- Authorization: Bearer Tokens
Authorization [Bearer Token]
- Token: (token)
Body [raw / json]
- orderId : (string | required)
Atributos de respuesta
- orderId: (string)
- merchantOrderId: (string)
- orderStatus: (string)
- orderPlacedAt: (timestamp)
- approvedAt: (timestamp)
- orderApprovals: (Array)
  - serviceId: (string)
  - deliveryServiceStatus: (string)
  - fulfillmentServiceExpiresAt: (timestamp)
  - fulfillmentAt: (timestamp)
  - serviceDeliveryBy: (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/escrow/orders/services/fulfillments \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICIwenJMTnEwbzBab1R4NTlaeWVPaTI1RGxZLWl6cV91SVFSLThWS0RaWjlFIn0.eyJleHAiOjE2NjE3ODk3NTQsImlhdCI6MTY2MTc4Nzk1NCwianRpIjoiYTczZDUwN2MtZmJkMS00MjE0LThjMjUtMDBlN2ZiYTk5Nzc0IiwiaXNzIjoiaHR0cHM6Ly9kZXYtYXV0aC56ZW5raS5maS9hdXRoL3JlYWxtcy9wYnciLCJhdWQiOiJhY2NvdW50Iiwic3ViIjoiZWQ3ZWQ1ZmMtZjBmNy00OWEwLWEwNWYtNWNiZTFkMjZkYTlkIiwidHlwIjoiQmVhcmVyIiwiYXpwIjoiemVua2ktcGF5Iiwic2Vzc2lvbl9zdGF0ZSI6IjhmNmJkYzYzLWFiYTctNGMxNy1hZTcyLWEwNDcyZjA1ZmQ4NyIsImFjciI6IjEiLCJhbGxvd2VkLW9yaWdpbnMiOlsiIl0sInJlYWxtX2FjY2VzcyI6eyJyb2xlcyI6WyJhcGkiLCJhcGlfemVua2lwYXkiLCJkZWZhdWx0LXJvbGVzLW1ldGFiYW4iXX0sInJlc291cmNlX2FjY2VzcyI6eyJhY2NvdW50Ijp7InJvbGVzIjpbIm1hbmFnZS1hY2NvdW50IiwibWFuYWdlLWFjY291bnQtbGlua3MiLCJ2aWV3LXByb2ZpbGUiXX19LCJzY29wZSI6InByb2ZpbGUgZW1haWwiLCJzaWQiOiI4ZjZiZGM2My1hYmE3LTRjMTctYWU3Mi1hMDQ3MmYwNWZkODciLCJlbWFpbF92ZXJpZmllZCI6dHJ1ZSwibmFtZSI6IlJlYWwgTWFkcmlkIEZDIFJlYWwgTWFkcmlkIEZDIiwicHJlZmVycmVkX3VzZXJuYW1lIjoiOGRjNDY5YTFkZTRiNDI3NTljMDdjNGYyYmQ2YzAzZjQiLCJnaXZlbl9uYW1lIjoiUmVhbCBNYWRyaWQgRkMiLCJsb2NhbGUiOiJlbiIsImZhbWlseV9uYW1lIjoiUmVhbCBNYWRyaWQgRkMiLCJlbWFpbCI6IjhkYzQ2OWExZGU0YjQyNzU5YzA3YzRmMmJkNmMwM2Y0In0.CnshdJfvJp6Memb7BQ8yJo0YuzvXPZ8egs52nzPqWKTLHYPqxPSm1QeWXZh8u5EpdWiVsDW4csIBtKEkCUlwI0pO9U9nFtV-_vaAk0NIH0ArOOhRhiDGggkkIWbudXUaSpnG5jyLNLg_nvbPcMWOp5jSbDlc6p3KY67h_LWzT8qLGnSoTdX05NKSYnjUe9woqm5aGXBcKbCPQsxPOLlVPFeGCjDW-n1oKEQsh8HIKoMvH07J4cO_wAukz9GvoCcz1GG8j8T8kZy-LGxRwqLervTbor4RhYeAZODwiVLmj-mGILppJqgZLBhiJebxDeoExqukQ1mpfBGaugCZM5Eai' \
     --header 'Content-Type: application/json' \
     --data '

{

     "orderId": "f325da2b8e3f476caa07e039406e72f0"

}
'

Respuesta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


{

  "orderId": "f325da2b8e3f476caa07e039406e72f0",
  "merchantOrderId": "l94jakpc3jpvdhzm",
  "orderStatus": "SETTLED",
  "orderPlacedAt": "2022-10-11T18:26:14.784+00:00",
  "approvedAt": "2022-10-11T23:54:34.220+00:00",
  "orderApprovals": [

    {

      "serviceId": "4bc1abeff4154050b327504f56263436",
      "deliveryServiceStatus": "COMPLETED",
      "fulfillmentServiceExpiresAt": "2022-10-11T19:32:38.761+00:00",
      "fulfillmentAt": "2022-10-11T23:34:01.580+00:00",
      "serviceDeliveryBy": "API"
    }
  ]

}

Errores

Codigo	Descripción
400	La petición (request) no tiene el formato solicitado.
401	La petición (request) no ha sido ejecutada porque carece de credenciales válidas de autenticación para el recurso solicitado.
404	No se ha encontrado un número de orden para el comercio.