API de Frete
A API de Frete cota o envio em tempo real a partir de multiplas origens, contrata a transportadora escolhida, gera a etiqueta e devolve o codigo de rastreamento. Para comecar, gere um token em /docs/ e chame POST /frete/cotacoes.
O que é API de Frete?
A API de Frete expoe a malha logistica do Ecossistema Precode (allPost) por meio de um contrato REST unico. Ela abstrai as diferencas entre transportadoras: sua aplicacao cota, contrata e rastreia sempre pelo mesmo formato, sem integrar cada parceiro individualmente.
Recursos principais
- POST /frete/cotacoes — retorna opcoes de frete por origem, prazo e preco, considerando peso, dimensoes e CEP de destino.
- POST /frete/envios — contrata a opcao escolhida e gera a etiqueta e a nota de despacho.
- GET /frete/envios/{id}/rastreamento — consulta os eventos de transito com status normalizado entre transportadoras.
- GET /frete/transportadoras — lista as transportadoras disponiveis para a conta e suas modalidades.
Casos de uso
Exibir o valor do frete no checkout, escolher automaticamente a opcao de menor custo dentro do SLA (leilao de frete), gerar etiquetas em lote na expedicao e notificar o cliente final sobre o andamento da entrega.
Como funciona a integração
A autenticacao usa token Bearer no cabecalho Authorization, com requisicoes e respostas em JSON sobre HTTPS no padrao REST. A cotacao e sincrona e retorna varias opcoes em uma unica chamada; a contratacao devolve os arquivos de etiqueta prontos para impressao.
Os eventos de rastreamento (postagem, transito, tentativa e entrega) podem ser entregues em tempo quase real pela API de Webhooks, dispensando o polling continuo. Consulte a Biblioteca Tecnica para o esquema de dimensoes, codigos de ocorrencia e ambientes de teste.
Documentação técnica
Consulte a Biblioteca Técnica para a referência completa de API de Frete: endpoints REST, autenticação, webhooks, exemplos de código, coleção Postman e especificação OpenAPI.
Quer integrar API de Frete com o Ecossistema Precode?
Fale com um especialista Precode e receba um plano de integração para API de Frete, com marketplaces, ERPs, transportadoras e gateways conectados em um só hub.