Integração de Pedido (Order Integration)

Configuração que liga uma filial a um provedor externo (VTEX, Intelipost, etc.) para receber pedidos automaticamente

Integração de pedido é a configuração que liga uma filial a um provedor externo de pedidos (marketplace, ERP, e-commerce) para receber pedidos automaticamente. No código e na API aparece como OrderIntegration.

O que compõe uma integração de pedido

Campo	Descrição
`id`	Identificador interno
`type`	Tipo do provedor (ex.: VTEX, INTELIPOST, LINX, OMNIK, LINX_ECOMMERCE)
`seller_id` / `seller`	De qual filial vêm os pedidos
`active`	Se está ativa ou não
`data`	Credenciais e metadados (tokens, URLs etc.) para a API do provedor
`external_identification`	Identificador próprio do provedor, quando aplicável
`created_at` / `updated_at`	Datas de criação e última atualização

Cada tipo de provedor tem um schema de dados (order_integration_data_schema) que define quais campos configurar.

Para que serve

Receber pedidos automaticamente do provedor (VTEX, Intelipost etc.) e criar os pedidos no sistema Abbiamo
Atualizar o provedor quando o pedido muda de status na Abbiamo (ex.: com solicitação de coleta feita, em rota, entregue) — quando a integração suporta
Eliminar operação manual de cadastro de pedidos
Reduzir erros de digitação e atrasos
Escalar facilmente a operação

Fluxo

O provedor externo gera um pedido (ex.: cliente faz uma compra na VTEX)
A integração de pedido recebe esse pedido via API/webhook
O sistema cria o pedido na Abbiamo, vinculado à filial correspondente
O pedido segue para solicitação de coleta — manualmente ou via automação de envio
Quando o pedido é atualizado na Abbiamo (com solicitação de coleta feita, em rota, entregue), a integração atualiza o provedor de volta, quando possível

Integrações disponíveis

Provedor	Documentação
VTEX	Ver guia

Onde aparece

Cada filial pode ter uma ou mais integrações de pedido configuradas
Relatórios de Integrações de Pedidos exportam essas configurações por filial

Relação com os outros conceitos

A integração de pedido é o ponto de entrada dos pedidos no sistema. Depois de criado, o pedido segue para solicitação de coleta — manualmente ou via automação de envio — que aciona uma integração de transportadora para gerar um envio.