Orders API

Referencia completa de la API de Orders.

API de Órdenes

Introducción a la API de Órdenes de Fenicia — envelope de respuesta, autenticación, paginación, filtros comunes y mapa de la sección

Listar pedidos

Consulta el listado paginado de pedidos con filtros por estado, canal, fechas y más, además de los endpoints de conteo por grupo y estado individual.

Buscar pedidos

Busca pedidos con texto libre combinado con los mismos filtros de fecha, estado, canal y cliente que ofrece el listado paginado de pedidos.

Consultar un pedido

Consulta el detalle completo de un pedido, sus transiciones de estado válidas y el desglose financiero de utilidad por pedido.

Crear un pedido

Crea pedidos manualmente enviando el envelope order con sus 10 campos raíz requeridos, o impórtalos en lote con POST /orders/import

Actualizar un pedido

Actualiza campos de un pedido existente, cambia los datos del cliente por separado, o agrega un comentario a su historial

Transiciones de estado

La máquina de estados completa de un pedido (23 estados) y los endpoints para aceptar, rechazar, cancelar y transicionar pedidos

Preparación y Envío

Prepara pedidos para su envío, procesa el fulfillment y gestiona guías, rastreo y paqueterías tanto por pedido individual como en lote

Entrega y Envíos

Marca pedidos como entregados, confirma la entrega, sube evidencia y guías, adjunta información de envío y gestiona el costo de un shipment

Devoluciones y Reembolsos

Ciclo completo de una devolución sobre un pedido — creación, aprobación, envío, recepción y reembolso, más listados y conteos

Adjuntos

Sube, lista, descarga y elimina archivos adjuntos de un pedido — facturas, CFDI, guías de envío, evidencia de entrega y más

Carritos abandonados

Lista, busca, cuenta e inspecciona carritos abandonados, dispara acciones de recuperación y ciérralos cuando ya no sean recuperables

Actividad, exportación y sincronización

Audita el historial de un pedido, exporta pedidos y liquidaciones vencidas a CSV, y dispara la sincronización con los canales conectados

Catálogo de Errores

Catálogo completo y verificado de códigos de error de la API de Pedidos de Fenicia, agrupado por namespace, con status HTTP y cuándo ocurre cada uno