DT Integração SIGATMS X FreteBras

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

A solução FreteBras é uma plataforma que disponibiliza ofertas de carga para caminhoneiros autônomos, através da publicação dos anúncios de frete das empresas assinantes. O caminhoneiro visualiza as cargas próximas em seu Smartphone e entra em contato com a empresa anunciante para negociar diretamente o frete, sem intermediários. 

A integração visa a divulgação de fretes disponíveis de maneira automática, dentro do SIGATMS Protheus, e o respectivo vínculo com as viagens planejadas.

03. SOLUÇÃO

Configuração Fretebras

Foi adicionado ao menu do módulo TOTVS SIGATMS a rotina responsável por realizar a Configuração da FreteBras (TMSAC13).

A rotina está no menu SIGATMS > Cadastros > Configurador FreteBras.

Após ser realizada a inclusão da tabela responsável pela configuração da Fretebras (DM1), é possível realizar o teste de conexão através da opção Outras Ações >Testar Conexão.

Caso a conexão esteja funcionando com os dados informados na tabela DM1, o número do token obtido deverá ser exibido em tela, e também armazenado na própria tabela DM1.

O Token é obtido também de maneira automática a cada disparo de integração é verificado se o token continua válido.

Oferta de Frete → Incluir

Foi disponibilizada no menu da viagem as opções para realizar o vínculo entre as viagens do tipo 3=Planejadas e a Oferta de Frete.

Ao acionar o menu, o usuário deve preencher os campos referentes a Oferta de Frete, e no momento que concluir a operação, as informações serão enviadas a plataforma FreteBras; caso a operação seja incluída com sucesso, será retornado um Id do frete; caso ocorra algum o erro, o mesmo será exibido em tela.

Esse ID é uma numeração única, que identificará a Oferta de Frete da unidade, e o mesmo ID constará na plataforma da FreteBras.

Oferta de Frete →Visualizar

Foi disponibilizada no menu da viagem a opção para visualizar a Oferta de Frete registrada.

Oferta de Frete →Renovação

A cada 7 dias úteis a oferta de frete expira automaticamente, e sendo assim é necessário realizar a renovação para que a mesma continue ativa.

Foi disponibilizada no menu da viagem a opção para Renovar a Oferta de Frete. Ao fim da renovação a data do frete (DM2_DTFRT) será atualizada com a data corrente.

Oferta de Frete →Alteração

Foi disponibilizada no menu da viagem a opção para Alterar a Oferta de Frete. A alteração pode ser realizada para atualizar ou complementar alguma informação que não foi enviada durante a sua criação.  O ID do frete deve continuar o mesmo.

Oferta de Frete →Concluir

As Ofertas de Frete ficam disponíveis aos motoristas profissionais de carga, e caso o motorista tenha interesse ele deve realizar o contato direto com a empresa ofertante. A empresa deve realizar o cadastramento do Motorista e Veículo, e informar o Código do Motorista e Código do Veículo na Oferta de Frete.

Foi disponibilizada no menu da viagem a opção para Concluir a Oferta de Frete. Ao realizar a conclusão da oferta, a mesma ficará com o status igual a 2=Concretizada (DM2_STATUS).

As informações que serão enviadas para a FreteBras são: Placa do Veículo e CPF do Motorista. A inclusão de ambos pode ser realizada dentro da opção Oferta de Frete → Concluir. 

Após concretizar a oferta de frete, a mesma não poderá receber alterações e o processo será encerrado, ficando a cargo da empresa a continuidade no processo da viagem. 

Oferta de Frete →Excluir

Foi disponibilizada no menu da viagem a opção para Excluir a Oferta de Frete. Apenas Ofertas de Frete com status igual a 1=Em aberto (DM2_STATUS) podem ser excluídas.

04. DEMAIS INFORMAÇÕES   

Pacotes de Dicionários:

• 007500 - Dicionário;
• 007157 - Menu;

O pacote irá criar as tabelas:

• DM1 - Configurador Fretebras
• DM2 - Ofertas de Frete

Rotinas envolvidas neste processo:

• TMSAC12 - Classe Fretebras

• TMSAC13 - Configurador FreteBras

• TMSAC14 - Histórico Fretebras

• TMSA144 - Viagem