Los endpoints de fulfillment cubren toda la ruta desde un pedido aceptado hasta un paquete enviado: preparación, selección de paquetería, generación de guías y actualizaciones de rastreo.
Por pedido vs. masivo
Usa los endpoints por pedido (/orders/{id}/...) para flujos interactivos. Usa los endpoints masivos /orders/fulfillment/* cuando proceses lotes desde el dashboard del comerciante o una tarea programada.
Marca un pedido como en preparación. El arreglo items es opcional — omítelo para preparar todos los ítems. Requiere permiso orders:fulfill.
curl -X POST https://api.fenicia.io/orders/ord_01HXYZ/prepare \
-H "Authorization: Bearer fn_live_tu_api_key" \
-H "Content-Type: application/json" \
-d '{"items":[{"sku":"ABC-123","quantity":1}]}'Procesa un pedido y opcionalmente adjunta información de rastreo. Requiere permiso orders:fulfill.
curl -X POST https://api.fenicia.io/orders/ord_01HXYZ/fulfill \
-H "Authorization: Bearer fn_live_tu_api_key" \
-H "Content-Type: application/json" \
-d '{"items":[{"sku":"ABC-123","quantity":1}],"trackingNumber":"1Z999AA10123456784","carrier":"fedex"}'Devuelve las capacidades de fulfillment por pedido (qué acciones están disponibles y cuáles bloqueadas). Requiere permiso orders:read.
curl -X POST https://api.fenicia.io/orders/fulfillment/capabilities \
-H "Authorization: Bearer fn_live_tu_api_key" \
-H "Content-Type: application/json" \
-d '{"orderIds":["ord_01","ord_02"]}'Devuelve las paqueterías disponibles para los pedidos indicados según destino, peso y configuración de la cuenta. Requiere permiso orders:read.
curl -X POST https://api.fenicia.io/orders/fulfillment/carriers \
-H "Authorization: Bearer fn_live_tu_api_key" \
-H "Content-Type: application/json" \
-d '{"orderIds":["ord_01"]}'Genera guías de envío para uno o varios pedidos. Los PDFs se devuelven como cadenas base64. Requiere permiso orders:fulfill.
curl -X POST https://api.fenicia.io/orders/fulfillment/labels \
-H "Authorization: Bearer fn_live_tu_api_key" \
-H "Content-Type: application/json" \
-d '{"orderIds":["ord_01","ord_02"],"format":"pdf"}'Adjunta o actualiza información de rastreo para pedidos procesados. Requiere permiso orders:fulfill.
curl -X POST https://api.fenicia.io/orders/fulfillment/tracking \
-H "Authorization: Bearer fn_live_tu_api_key" \
-H "Content-Type: application/json" \
-d '{"orderId":"ord_01","trackingNumber":"1Z999...","carrier":"fedex"}'Marca múltiples pedidos como enviados en una sola llamada. Requiere permiso orders:fulfill.
curl -X POST https://api.fenicia.io/orders/fulfillment/ship \
-H "Authorization: Bearer fn_live_tu_api_key" \
-H "Content-Type: application/json" \
-d '{"orderIds":["ord_01","ord_02"],"carrier":"fedex"}'Descarga guías de envío generadas previamente para un pedido específico. Requiere permiso orders:read.
curl https://api.fenicia.io/orders/ord_01/download-shipping-label \
-H "Authorization: Bearer fn_live_tu_api_key"Tip
Para impresión en lote de alto volumen, llama a /orders/fulfillment/labels con hasta 100 IDs de pedido a la vez y decodifica los PDFs en base64 en el servidor para combinarlos en un único PDF unificado.