# Pedido (Order / Invoice)

**Pedido** é a entidade central que representa uma solicitação de entrega (ou coleta/retorno) recebida de um [embarcador](https://abbiamo-guide.netlify.app/go/conceitos/embarcador/) e vinculada a uma [filial](https://abbiamo-guide.netlify.app/go/conceitos/filial/). No sistema, a mesma entidade é chamada de **order** na API e, em parte do contexto de negócio, de **invoice** quando se fala da nota fiscal ou do documento do pedido.

---

## O que compõe um pedido

### Identificação

- `id` — identificador interno Abbiamo
- `number` — número do pedido
- `external_id` — ID do embarcador
- `tracking` — código de rastreio

### Nota fiscal / Invoice

- `invoice_number` — número da NF
- `access_keys` — chave de acesso da NF
- `content_declaration` — dados da DC-e quando o pedido foi criado com declaração de conteúdo informada pelo embarcador (`key`, `serie`, `number`)
- Dados de emissão

### Valores

- `amount` — valor total do pedido
- **Preço e prazo prometido ao cliente** — valor do frete e data de entrega prometidos

### Status

- `status` / `sub_status` — refletem o estado atual do pedido. Para a lista completa de códigos e traduções, veja [Status de pedido](https://abbiamo-guide.netlify.app/go/conceitos/status-de-pedido/).

### Tipo

- `type` — Entrega (DELIVERY), Retirada em loja (TAKEOUT) ou Reversa (RETURN)

### Relacionamentos

| Relação | Descrição |
|---------|-----------|
| **Filial** | A qual [filial](https://abbiamo-guide.netlify.app/go/conceitos/filial/) o pedido pertence |
| **Embarcador** | O [embarcador](https://abbiamo-guide.netlify.app/go/conceitos/embarcador/) que originou o pedido |
| **Cliente** | Destinatário e dados de contato |
| **Endereços** | Origem (endereço da filial) e destino |
| **Volumes e itens** | Volumes e itens associados |
| **Envios** | Um pedido pode ter um ou mais envios (ex.: reenvio) |
| **Rota** | A [rota](https://abbiamo-guide.netlify.app/go/conceitos/rota/) à qual o pedido está associado (quando houver) |

### Outros dados

- **Entrega:** dados da última entrega — motorista, data de entrega, janela de entrega etc.
- **Marcadores:** tags/labels associadas ao pedido
- **Datas:** criação, atualização de status, data prevista de entrega

---

## Como um pedido chega ao GO

- **Do embarcador Abbiamo (LOG)** — pedidos chegam automaticamente via integração quando o embarcador usa o [LOG](https://abbiamo-guide.netlify.app/log/onboarding/) e configura uma integração de transportadora apontando para a sua operação GO.
- **De embarcador externo** — pedidos entram via API ou importação manual para embarcadores cadastrados diretamente no GO.
- **Criação manual** — pelo formulário na tela de [Pedidos](https://abbiamo-guide.netlify.app/go/products/pedidos/).

---

## Pedido vs. Invoice
**Na Abbiamo, são a mesma coisa:** Na Abbiamo, **pedido** e **invoice** representam a mesma entidade. Um pedido carrega as informações de uma nota fiscal (número, chave de acesso, dados de emissão), mas não são entidades separadas — é tudo o mesmo registro.