KTHIntNXMAPS

Integração entre o ERP Sankhya e a NXMAPS, plataforma de gestão de abastecimento da frota. Aqui o ERP é quem publica a API: a NXMAPS consulta o que precisa e devolve a autorização.

O problema

Abastecer na estrada depende de três informações que moram em lugares diferentes: a viagem em curso, o preço negociado com cada posto e o veículo autorizado. Sem contrato entre os sistemas, a autorização vira telefonema e o abastecimento entra no ERP à mão, depois, por quem não estava lá.

O que ele faz

• Expõe viagens, veículos e preços negociados por posto em endpoints consultados pela NXMAPS.
• Recebe a autorização de abastecimento com posto, motorista, veículo, combustível, quantidade e valor, valida cada campo e grava a solicitação no ERP.
• Aceita o cancelamento de uma autorização já enviada.
• Mantém o cadastro de postos sincronizado a partir dos parceiros do ERP, por gatilho no banco.

Decisões de projeto

A autorização chega em lote e é validada item a item: o que está fora do contrato é recusado com a mensagem do campo que falhou, e o resto do lote segue. Recusar o lote inteiro por causa de um item transformaria um erro de cadastro em parada de abastecimento na estrada.

O vínculo com o planejamento da viagem viaja junto da autorização, então o abastecimento nasce no ERP já preso à viagem que o originou.

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