🛒 Pedidos Fulfillment

A API de Pedidos oferece um conjunto completo de endpoints para gerenciar o ciclo de vida de pedidos dentro da plataforma de Fulfillment.

Esta API foi desenvolvida para centralizar todas as operações relacionadas a pedidos oriundos de diferentes canais integrados, como marketplaces (Mercado Livre, Amazon), sistemas de gestão (ERPs), ou fluxos próprios da empresa.

🎯 Objetivos Principais

Esta API serve como o ponto de entrada unificado para:

Criação de pedidos: Entrada e saída de mercadorias com validação de estoque avançada

Consulta e rastreamento: Acompanhamento completo do status e localização dos itens

Gestão documental: Controle de notas fiscais, etiquetas de identificação e documentos para impressão

Automação logística: Agendamento de coletas/entregas e execução automatizada do workflow

Integração fiscal: Sincronização com sistemas contábeis e de faturamento

Principais Funcionalidades

🆕 Criação de Pedidos

Permite criar novos pedidos de entrada ou saída com validação automática de estoque.

Endpoint: POST /api/v1/orders

🔍 Consulta de Pedidos

Recupera informações detalhadas de um pedido específico, incluindo status atual, itens, documentos fiscais e histórico de movimentações.

Endpoint: GET /api/v1/orders/{order_number}

📦 Gerenciamento de Itens

Permite modificar itens do pedido apenas quando o pedido está em status draft. Após o pedido ser confirmado, os itens ficam bloqueados para edição.

Endpoints principais:

GET|POST /api/v1/orders/{order_number}/items

GET|PUT|DELETE /api/v1/orders/{order_number}/items/{item_id}

🧬 Rastreabilidade (Série/Lote)

Sistema avançado de rastreamento individual por item, essencial para produtos que exigem controle de lote, validade ou número de série.

Endpoints principais:

POST /api/v1/orders/{order_number}/items/{item_id}/traces

GET|PUT|DELETE /api/v1/orders/{order_number}/items/{item_id}/traces/{trace_id}

Aplicações:

Produtos farmacêuticos: Controle de lote e validade obrigatórios

Eletrônicos: Rastreamento por número de série/IMEI

Alimentos: Gestão de prazos de validade e recall

Produtos regulamentados: Compliance com órgãos fiscalizadores

🧾 Documentos Fiscais

Centralização de toda documentação fiscal relacionada ao pedido, com validação automática e integração com sistemas contábeis.

Endpoints principais:

GET|POST /api/v1/orders/{order_number}/documents

GET|DELETE /api/v1/orders/{order_number}/documents/{document_id}

Tipos de documentos suportados:

Notas fiscais de entrada/saída (XML/PDF)

Conhecimentos de transporte (CT-e) beta

Manifesto de carga (MDF-e) beta

Documentos auxiliares (DANFE, laudos técnicos) beta

🏷️ Etiquetas de Identificação

Geração automatizada de etiquetas personalizadas para identificação e rastreamento de produtos no armazém.

Formatos suportados: ZPL (Zebra)

Endpoints principais:

POST /api/v1/orders/{order_number}/product-identification/items/{item_id}/labels/render

POST /api/v1/orders/{order_number}/product-identification/items/{item_id}/labels/mark-as-printed

Tipos de etiquetas:

Etiquetas de produto: Código QR e informações básicas

Etiquetas de controle: Lote, validade e série

🖨️ Documentos para Impressão

Sistema centralizado para anexar e gerenciar documentos diversos que precisam ser impressos junto com o pedido.

Documentos suportados:

Laudos técnicos: Certificados de qualidade, análises laboratoriais

Etiquetas customizadas: PDF ou ZPL para impressão especializada

Orçamentos e propostas: Documentos comerciais

Instruções especiais: Manuais de manuseio, cuidados especiais

Certificações: ISO, ANVISA, outros órgãos reguladores

Endpoints principais:

POST /api/v1/orders/{order_number}/print-documents

GET /api/v1/orders/{order_number}/print-documents

GET /api/v1/orders/{order_number}/print-documents/{documentId}

GET /api/v1/orders/{order_number}/print-documents/{documentId}/preview

📅 Agendamento Fulfillment

Controle completo de agendamentos para coletas e entregas, otimizando o uso da capacidade logística do armazém.

Fluxo de agendamento:

1.
Consulta de disponibilidade: Verificar slots livres por dock/período
2.
Reserva temporária: Bloquear horário por tempo limitado
3.
Confirmação: Efetivar o agendamento

Endpoints principais:

GET /api/v1/orders/{order_number}/schedules/available

POST /api/v1/orders/{order_number}/schedules/reserve

POST /api/v1/orders/{order_number}/schedules/confirm

GET /api/v1/orders/{order_number}/schedules

POST /api/v1/orders/{order_number}/schedules/cancel

🔄 Controle de Workflow

Através deste módulo, o usuário pode visualizar em que etapa o pedido se encontra e confirmar as ações pelas quais é responsável, como envio de notas fiscais, confirmação de itens ou outras aprovações necessárias no fluxo.

Endpoints principais:

GET /api/v1/orders/{order_number}/workflow/status

GET /api/v1/orders/{order_number}/workflow/available-actions

POST /api/v1/orders/{order_number}/workflow/execute

POST /api/v1/orders/{order_number}/workflow/cancel

🎯 Objetivos Principais#

Principais Funcionalidades#

🆕 Criação de Pedidos#

🔍 Consulta de Pedidos#

📦 Gerenciamento de Itens#

🧬 Rastreabilidade (Série/Lote)#

🧾 Documentos Fiscais#

🏷️ Etiquetas de Identificação#

🖨️ Documentos para Impressão#

📅 Agendamento Fulfillment#

🔄 Controle de Workflow#

🎯 Objetivos Principais

Principais Funcionalidades

🆕 Criação de Pedidos

🔍 Consulta de Pedidos

📦 Gerenciamento de Itens

🧬 Rastreabilidade (Série/Lote)

🧾 Documentos Fiscais

🏷️ Etiquetas de Identificação

🖨️ Documentos para Impressão

📅 Agendamento Fulfillment

🔄 Controle de Workflow