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.
POST/integrations/v1/orders

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.

Authorization

X-Drop-Key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/integrations/v1/orders" \  -H "Content-Type: application/json" \  -d '{    "externalOrderId": "string",    "customer": {      "name": "string",      "lastName": "string",      "phoneAreaCode": "string",      "phone": "string"    },    "shipping": {      "address": "string",      "referencePoint": "string",      "stateId": "string",      "cityId": "string"    },    "items": [      {        "catalogId": "string",        "quantity": 0      }    ],    "cod": true  }'
{  "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",    "requestedCourier": {      "id": "67ddf4a61285369140537bf6",      "reason": "no_coverage"    }  }}