Intake de paquetes por dimensionadoras

Cómo enviar paquetes medidos desde una dimensionadora o asistente de almacén al buffer de Droka.

Las dimensionadoras y asistentes de almacén envían cada paquete con un POST al buffer siempre activo de Droka. Droka recibe el paquete de forma asíncrona; no hace falta esperar a que el sistema principal lo procese para considerar el envío aceptado.

Droka Ops le entrega un token Bearer por organización. Guárdelo como secreto. Al rotarlo, el token anterior deja de valer de inmediato.

URL base y endpoint


URL base	`https://intake-buffer.drokaos.com`
Endpoint	`POST /v1/packages`
URL completa	`https://intake-buffer.drokaos.com/v1/packages`

Autenticación

Envíe el token en el encabezado:

Authorization: Bearer <token>

El token lo emite Droka Ops. Si lo rotan, deje de usar el anterior: las peticiones con el token viejo responden 401.

Cuerpo del request

JSON con Content-Type: application/json. Un objeto por paquete.

Obligatorio

body

_idstring

Required

Identidad del paquete. Debe ser un string no vacío. Use el mismo valor si reintenta el mismo paquete.

Campo	Tipo	Notas
`trackingId`	string	Código de tracking visible
`length`	number	Largo
`width`	number	Ancho
`height`	number	Alto
`weight`	number	Peso
`units`	string	Unidades de medida (p. ej. `in`/`lb` o `cm`/`kg`)
`photos`	array o string	Referencias a fotos si existen
`consignee`	string	Consignatario, si está disponible
`shipper`	string	Remitente, si está disponible

Respuestas

HTTP	Significado
202	Aceptado; el paquete queda pendiente de procesamiento en Droka
200	Ya procesado o duplicado seguro (mismo `_id` para esa organización)
401	Token ausente, inválido o rotado
422	`_id` faltante o no válido
503	Buffer mal configurado; reintente más tarde o contacte a Droka Ops

Idempotencia

Reenviar el mismo _id con el mismo Bearer (misma organización) es un reintento seguro. No crea un segundo paquete distinto.

Ejemplo con curl

curl -X POST "https://intake-buffer.drokaos.com/v1/packages" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "_id": "PKG-20261027-001",
    "trackingId": "1Z999AA10123456784",
    "length": 12,
    "width": 8,
    "height": 6,
    "weight": 3.2,
    "units": "in/lb",
    "consignee": "Cliente Demo",
    "shipper": "Bodega Miami"
  }'

Respuesta típica de aceptación:

{
  "status": "pending"
}

Tip Postman

Método POST, URL https://intake-buffer.drokaos.com/v1/packages.
Pestaña Authorization → Type Bearer Token → pegue el token (Postman agrega Authorization: Bearer …).
Body → raw → JSON con al menos _id.
Envíe. Espere 202 en el primer intento o 200 si ya lo había enviado.

No ponga el token en la URL ni en el body. Solo en el encabezado Authorization.

Was this page helpful?