📄 Integração por E-mail via XML de Nota Fiscal (NFe / NFSe)
Criação Automática de Pedidos de Entrega na Plataforma Husky
Visão Geral
Para facilitar a integração com empresas que ainda não possuem estrutura técnica para integrar via API, a Husky agora permite criar pedidos automaticamente a partir do envio de arquivos XML de Nota Fiscal (NFe ou NFSe).
🔧 Como funciona a integração
1. Liberação de E-mail para recebimento do XML da Nota Fiscal
O primeiro passo para que utilize essa forma de integração é entrar em contato com o Suporte Técnico para que o e-mail utilizado para envio dos XML’s das Notas Fiscais seja liberado aqui no nosso sistema.
Somente e-mails cadastrados previamente na nossa lista de remetentes autorizados poderão enviar arquivos para processamento.
2. Identificação da conta correta para criação do Pedido
O sistema verifica o CNPJ da nota para localizar qual conta logística deve receber o pedido.
Caso existam múltiplos subclientes cadastrados com o mesmo CNPJ, o pedido será direcionado para o subcliente mais recente.
Para cadastrar o CNPJ corretamente, pode acessar o seu painel administrativo, ir até Cadastros > Clientes, localizar o cliente desejado e Editar.
Selecione como Pessoa Jurídica, preencha o CNPJ e aperte em Salvar Alterações.
3. Envio do XML da Nota Fiscal
O e-mail em que recebemos os XML das Notas Ficais para criação de pedidos na plataforma é:
[email protected]
Toda vez que uma nota fiscal for emitida, o XML pode ser:
1 – Disparado automaticamente para o email acima, pelo sistema de emissão, ou
2 – Enviado manualmente pelo cliente.
4. Criação do pedido na Husky
Assim que recebemos o XML através do e-mail, o sistema cria automaticamente o pedido de entrega, preenchendo:
- Nome do destinatário
- Endereço de entrega
- Valor da corrida
- Identificador da nota
- Origem: “API-Mailbox” (identificação da origem do pedido)
O processo é 100% automático e não exige interação manual.
5. Prevenção contra duplicidade
Se o mesmo XML for enviado duas vezes (isso acontece quando sistemas emitem nota + confirmação), o sistema automaticamente bloqueia a criação duplicada.
Somente uma entrega será criada para cada número de nota.
📥 Resumo da Integração
- Enviar a lista dos e-mails autorizados que irão disparar os XMLs para nosso Suporte Técnico
- Preencher corretamente o CNPJ no cadastro do cliente.
- Configurar o sistema de emissão de notas para enviar os XMLs para o e-mail fornecido pela Husky.