Processar um Pedido
Este guia mostra um fluxo completo de processamento de um pedido, do recebimento até a entrega, combinando vários endpoints da API.
1️⃣ Seja notificado de um novo pedido pago
Em vez de consultar a listagem repetidamente, configure um Webhook para o evento Pedidos_Pagos. Assim, sua aplicação é avisada assim que um pedido tem o pagamento confirmado.
O webhook envia o código do pedido (CodigoPedido), que você usa nos próximos passos.
2️⃣ Consulte os detalhes do pedido
Com o código em mãos, obtenha os dados completos (cliente, itens, valores, endereço):
Detalhes do Pedido3️⃣ Descubra o código do próximo status
Os status possuem códigos. Consulte a lista para saber qual código usar (por exemplo, "Em separação" ou "Enviado"):
Informações4️⃣ Atualize o status do pedido
Conforme o pedido avança, altere o status (opcionalmente notificando o cliente por e-mail):
Alterar Status5️⃣ Informe o código de rastreio
Ao despachar o pedido, registre o código de rastreio para o cliente acompanhar a entrega:
Informar Código de Rastreio6️⃣ Informe a nota fiscal
Registre os dados da NF-e emitida para o pedido:
Informar Nota Fiscal🔄 Resumo do fluxo
1
Ser notificado do pedido pago
Webhook Pedidos_Pagos
2
Consultar detalhes
GET /pedidos/{Codigo}/
3
Descobrir código do status
GET /informacoes/status/
4
Alterar status
PUT /pedidos/{Codigo}/alterar-status/
5
Informar rastreio
PUT /pedidos/{Codigo}/informar-codigo-rastreio/
6
Informar nota fiscal
PUT /pedidos/{Codigo}/informar-nota-fiscal/
Last updated