A integração Intelipost gera corridas (OS) automaticamente a partir dos pedidos enviados pela Intelipost e envia à Intelipost os eventos de coleta e entrega.
1. Como funciona a integração
A comunicação acontece em dois sentidos:
- Intelipost para MaisEntregas: os pedidos são enviados automaticamente para a criação de corridas (OS).
- MaisEntregas para Intelipost: os eventos de pedido coletado e pedido entregue são enviados conforme o andamento da corrida.
2. Informações necessárias para configurar
Responsável pela solicitação: Equipe MaisEntregas. Responsável pelo fornecimento: Cliente Solicitante ou Intelipost.
Antes de iniciar a configuração, solicite:
| Informação | Descrição |
|---|---|
| Payload de Produção (JSON) | Exemplo real da estrutura utilizada pelo Cliente Solicitante na Intelipost. |
logistic-provider-api-key |
Chave de API da integração. |
logistic-provider_id |
Identificador do provedor logístico. |
logistic-provider_name |
Nome do provedor logístico. |
| Endereço de coleta | Endereço fixo utilizado nas corridas originadas pela Intelipost para o Cliente Solicitante. |
Importante: toda nova integração exige o Payload de Produção (JSON) específico do Cliente Solicitante, fornecido pelo próprio cliente ou pela Intelipost. Não utilize o JSON de outra integração sem validação.
Padrão do endereço de coleta
O endereço deve seguir o formato:
Logradouro, número, bairro, cidade - UF, CEP, Brasil
Exemplos:
- Porto Alegre/RS: Av. da Cavalhada, 4517, Cavalhada, Porto Alegre - RS, 91740-001, Brasil
- Rio de Janeiro/RJ: R. Vandenkolk, 137, Olaria, Rio de Janeiro - RJ, 21073-290, Brasil
Atenção: o endereço de coleta será configurado como fixo para todos os pedidos enviados pela Intelipost para aquele Cliente Solicitante.
3. Como solicitar a integração à Intelipost
Responsável: Equipe MaisEntregas.
A solicitação é feita por meio de um chamado à Intelipost. Existem duas modalidades:
Integração API sem auditoria de faturas
- Solicite a integração à Intelipost.
- Aguarde a configuração pelo administrador e a disponibilização da chave de API.
- Envie um pedido de teste.
- Valide a criação da corrida (OS) na MaisEntregas.
- Confirme o envio dos eventos de coleta e entrega à Intelipost.
Integração API com auditoria de faturas
Siga o mesmo procedimento anterior. Nesta modalidade, a Intelipost também disponibiliza acesso às pastas SFTP para envio dos arquivos:
- CONEMB
- XML-CTE
4. Como abrir o chamado na Intelipost
Responsável: Equipe MaisEntregas.
- Acesse o portal de atendimento da Intelipost.
- Faça login com a conta corporativa autorizada.
- Selecione "Canal do Transportador".
- Clique em "Problema, dúvida ou requisição".
- Informe os dados do Cliente Solicitante e da integração.
- Solicite o Payload de Produção (JSON) específico do cliente, caso ainda não tenha sido fornecido.
- Envie a solicitação e registre o número do chamado.
Segurança: use apenas as credenciais corporativas autorizadas. Não compartilhe senhas ou chaves de API em documentos públicos.
5. Como validar o funcionamento da integração
Após a configuração, confirme se:
- O Payload de Produção corresponde ao Cliente Solicitante.
- As credenciais da integração estão corretas.
- O endereço fixo de coleta foi configurado.
- O pedido de teste gera uma corrida (OS) na MaisEntregas.
- Os eventos de coleta e entrega são enviados corretamente à Intelipost.
A integração está pronta para uso após a conclusão dos testes.