Pedido (Order / Invoice)
Entidade central no GO: solicitação de entrega recebida de um embarcador, com nota fiscal, status, envios e vínculo com rotas
Pedido é a entidade central que representa uma solicitação de entrega (ou coleta/retorno) recebida de um embarcador e vinculada a uma 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 Abbiamonumber— número do pedidoexternal_id— ID do embarcadortracking— código de rastreio
Nota fiscal / Invoice
invoice_number— número da NFaccess_keys— chave de acesso da NFcontent_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.
Tipo
type— Entrega (DELIVERY), Retirada em loja (TAKEOUT) ou Reversa (RETURN)
Relacionamentos
| Relação | Descrição |
|---|---|
| Filial | A qual filial o pedido pertence |
| Embarcador | O 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 à 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 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.
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.