> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/guias/processar-pedido.md).

# 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.

{% hint style="info" %}
Cada passo abaixo tem uma página dedicada com todos os detalhes. Aqui mostramos como eles se **encaixam** em um processo real.
{% endhint %}

## 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.

{% content-ref url="/pages/rbiZGRer0EGAGyswrCCw" %}
[Webhook](/funcionamento/webhook.md)
{% endcontent-ref %}

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):

{% content-ref url="/pages/MmarhErcLW6IbvhC3bZX" %}
[Detalhes do Pedido](/pedidos/detalhes-do-pedido.md)
{% endcontent-ref %}

## 3️⃣ 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"):

{% content-ref url="/pages/XbCkfnDdDIoHsqwnsigd" %}
[Informações](/informacoes/informacoes.md)
{% endcontent-ref %}

## 4️⃣ Atualize o status do pedido

Conforme o pedido avança, altere o status (opcionalmente notificando o cliente por e-mail):

{% content-ref url="/pages/Z9rIbMa20RTCqjphukbt" %}
[Alterar Status](/pedidos/alterar-status.md)
{% endcontent-ref %}

## 5️⃣ Informe o código de rastreio

Ao despachar o pedido, registre o código de rastreio para o cliente acompanhar a entrega:

{% content-ref url="/pages/tti0G7q5dyajLfILqHdJ" %}
[Informar Código de Rastreio](/pedidos/informar-rastreio.md)
{% endcontent-ref %}

## 6️⃣ Informe a nota fiscal

Registre os dados da NF-e emitida para o pedido:

{% content-ref url="/pages/uOUqWCJNmzqo4LjNsyjy" %}
[Informar Nota Fiscal](/pedidos/informar-nota-fiscal.md)
{% endcontent-ref %}

## 🔄 Resumo do fluxo

| Passo | Ação                          | Endpoint                                          |
| ----- | ----------------------------- | ------------------------------------------------- |
| 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/`     |