API de Pedidos
A API de Pedidos centraliza a captura, a consulta e a atualizacao de pedidos de todos os marketplaces integrados em um unico contrato REST. Para comecar, gere um token na Biblioteca Tecnica e faca uma chamada GET /pedidos.
O que é API de Pedidos?
A API de Pedidos unifica o ciclo de vida do pedido de multiplos canais de venda em um unico modelo de dados. Em vez de tratar cada marketplace com um formato proprio, sua aplicacao consome pedidos ja normalizados — mesmo esquema de status, itens, valores, cliente e endereco de entrega — independentemente da origem.
Recursos principais
- GET /pedidos — lista pedidos com filtros por data, canal, status e paginacao por cursor.
- GET /pedidos/{id} — recupera o detalhe completo de um pedido, incluindo itens, pagamentos e histórico de status.
- POST /pedidos — cria pedidos manuais ou de canais proprios (loja D2C, venda assistida).
- PATCH /pedidos/{id}/status — avanca o status do pedido (faturado, enviado, entregue, cancelado) com validacao de transicoes.
Casos de uso
Sincronizar pedidos de marketplaces com o ERP, alimentar um WMS para separacao e expedicao, disparar faturamento automatico e consolidar um painel unico de vendas multicanal.
Como funciona a integração
A autenticacao usa token Bearer enviado no cabecalho Authorization. Todas as requisicoes e respostas trafegam em JSON sobre HTTPS, seguindo o padrao REST com verbos e codigos de status HTTP convencionais.
Para reagir a novas vendas e mudancas de status sem ficar consultando a API em loop (polling), assine os eventos de pedido pela API de Webhooks e receba notificacoes assinadas em tempo quase real. Consulte a Biblioteca Tecnica para o esquema completo de payloads, limites de taxa (rate limit) e ambientes de teste (sandbox).
Documentação técnica
Consulte a Biblioteca Técnica para a referência completa de API de Pedidos: endpoints REST, autenticação, webhooks, exemplos de código, coleção Postman e especificação OpenAPI.
Quer integrar API de Pedidos com o Ecossistema Precode?
Fale com um especialista Precode e receba um plano de integração para API de Pedidos, com marketplaces, ERPs, transportadoras e gateways conectados em um só hub.