Drop · API de Integraciones
ReferenciaÓrdenes

Firma HMAC en cada petición

Los headers X-Drop-Timestamp, X-Drop-Nonce y X-Drop-Signature se calculan por request a partir de tu secreto; los ejemplos los muestran como marcadores. Cómo armarlos, con una implementación de referencia, en Autenticación. Esta página no permite enviar peticiones desde el navegador por ese mismo motivo.
GET/integrations/v1/orders

Solo las órdenes que este partner originó. Contraparte de los webhooks: permite reconciliar cuando se pierde una entrega.

Authorization

X-Drop-Key<token>

In: header

Query Parameters

page?number
Default1
limit?number
Rangevalue <= 100
Default20
status?string

Filtra por estado, en el vocabulario público del API

Value in

  • "registered_in_courier"
  • "recollected"
  • "inroute"
  • "delivered"
  • "cancelled_in_boxful"
  • "issue"
  • "not_delivered"
  • "returned_to_warehouse"
  • "not_recollected"
  • "in_locker"
  • "in_agency"
  • "registered"
  • "pending_correction"
  • "rejected"
  • "cancelled"
  • "fulfilled"
  • "created"
updatedSince?string

Solo órdenes modificadas desde esta fecha

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/integrations/v1/orders"
{  "data": [    {      "id": "65b000000000000000000301",      "orderNumber": "DR-10233",      "externalOrderId": "ICF-10024",      "status": "in_transit",      "statusLabel": "Orden registrada",      "sellerId": "65b0000000000000000000f1",      "codAmount": 49.98,      "cod": true,      "shippingCost": 3.5,      "codCommissionAmount": 2,      "codCommissionPercentage": 0.04,      "estimatedCodCommissionAmount": 2,      "shipmentNumber": "BX-99120",      "trackingUrl": "https://track.goboxful.com/BX-99120",      "courier": {        "id": "692dc52174c1647295ece2cc",        "name": "Guatex"      },      "createdAt": "2026-07-28T00:00:00.000Z",      "updatedAt": "2026-07-28T12:31:04.118Z"    }  ],  "meta": {    "page": 1,    "limit": 20,    "total": 213,    "totalPages": 11,    "hasNextPage": true  }}

Crear una orden POST

El sellerId no se envía: se deriva de los catalogId de las líneas, que deben pertenecer todas al mismo dropshipper. El monto a cobrar lo calcula Drop. Repetir el mismo externalOrderId devuelve la orden ya creada.

Consultar una orden por id GET

Solo las órdenes que este partner originó. Una orden ajena responde 404, no 403, para no confirmar que ese id existe.