KTHIntIHARA

Integração EDI com a IHARA, embarcadora que contrata o frete. Os documentos que ela exige saem do ERP Sankhya em XML, e a nota fiscal que origina a viagem entra pelo mesmo caminho.

O problema

A embarcadora cobra o conhecimento embarcado, a ocorrência de rastreamento e o XML do CT-e em layout próprio, a cada rodada. Isso era exportação manual de um lado e digitação da nota fiscal do outro: dois trabalhos repetidos por viagem, cada um com sua chance de erro.

O que ele faz

• Monta e envia o CONEMB, o conhecimento embarcado, com as notas fiscais, a composição do frete e os dados do CT-e lidos do próprio ERP.
• Envia o OCOREN, as ocorrências de rastreamento de cada entrega.
• Publica o XML do CT-e no repositório da embarcadora.
• Recebe a nota fiscal e o XML da SEFAZ por endpoint próprio, autenticado por CNPJ e chave de acesso, e registra no ERP a carga que dá origem à viagem.

Decisões de projeto

Cada documento enviado guarda a requisição, a resposta e a mensagem de erro ao lado do próprio registro. Quando o embarcador diz que não recebeu, a conversa termina no dado: dá para mostrar o XML que saiu e o retorno que voltou, sem depender de log de servidor.

O envio roda como tarefa agendada e também como endpoint sob demanda, apontando para o mesmo código. Reprocessar uma remessa presa não exige esperar a próxima janela do agendador.

Código fechado. O projeto roda em ambiente corporativo da Kothe SA.