KTHIntTecnomyl

Integração entre o ERP Sankhya e o portal AltaTrack, por onde a Tecnomyl acompanha as entregas que a transportadora faz para ela.

O problema

O cliente cobra visibilidade da entrega: onde está, quando chega, o que aconteceu e o canhoto assinado. Sem integração isso vira consulta por telefone e planilha reenviada, e a informação que já existe no ERP chega atrasada justamente a quem paga o frete.

O que ele faz

• Envia previsão de entrega, ocorrência e posição de GPS por nota fiscal, lendo a fila montada em packages PL/SQL.
• Envia o comprovante de entrega digitalizado, o canhoto, direto do repositório de anexos do ERP.
• Registra o que foi enviado e o que voltou em log de integração, com o status de cada documento.

Decisões de projeto

Sucesso não vem só do código HTTP: a API responde 200 com um indicador de erro no corpo, então a leitura do resultado olha o conteúdo da resposta antes de dar o envio por bom.

A configuração, endereço e credenciais, é lida do banco uma vez por execução e passa adiante pelo lote inteiro. Nada de endereço fixo no código, e nada de uma consulta de configuração por item.

Cada rotina tem teto de itens por execução e marca a tentativa em cada documento: uma nota que a API recusa sempre para de consumir a janela de envio das outras.

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