Guia
Criar uma solicitação de logística reversa pela API
Para quem lidera a operação e quem implementa a integração.
O POST reúne identificador de credencial, endereço, serviço e, quando aplicável, vínculo a pedido — tudo em /api-docs/logistica-reversa/criar. A resposta de sucesso e os códigos de erro (incluindo cota) seguem a própria documentação: os times de dados e operação devem ligar `message` e o corpo de erro a processos (reprocessar, comercial, abrir chamado de contrato com o operador, etc.).
Não trate o texto deste guia como esquema congelado: a página de criação manda no conjunto de campos obrigatórios e exemplos da versão publicada hoje.
Checklist para subir a integração de criação
- Ter um credentialId válido. Use o guia e a documentação de listagem de credenciais.
- Montar o corpo. Obrigatórios e exemplos na página Criar; evite reaproveitar JSON antigo sem revalidar na doc.
- Ler a resposta. Sucesso traz o identificador; 4xx/5xx com corpo alinhado à tabela; cota alinhada a /planos quando a doc indicar.
Falha na criação: o que o time precisa enxergar
Serviço, CEP ou credencial incompatíveis com o acordo costumam devolver mensagem explicativa. Registre código e texto (sem vazar dado pessoal em registro de log exposto) e ajuste o corpo da requisição ou o cadastro, conforme a tabela. Dúvida de processo: /contato; dúvida de contrato: a doc Criar e os exemplos.
Perguntas frequentes
Dúvidas comuns de quem coloca a integração em produção.
- A criação precisa obrigatoriamente vincular pedido interno?
- Depende do modelo no corpo, descrito na documentação de criação e exemplos. Alinhe a regra de negócio com a operação antes de congelar o seu ERP.
Próximo passo: documentação oficial
Parâmetros, tabelas de resposta, limites e exemplos em código — tudo na referência de API pública.
Atualizado em 23/04/2026