Integração SIGATMS X Fretebras (Integrações - SIGATMS)

01. INTEGRAÇÃO OFERTAS DE FRETE - SIGATMS X FRETEBRAS

 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 FreteBras não participa diretamente do fechamento das negociações! Ela, portanto, não monetiza sobre as transações efetuadas (match). Na prática funciona como um grande portal de classificados! Elimina agentes tradicionais de frete do processo, no entanto não faz a conexão entre as partes.

Com a base expressiva de empresas e motoristas conquistada, e as facilidades oferecidas por suas ferramentas, tornou-se referência neste mercado.

Diante deste cenário o módulo Gestão de Transportes (SIGATMS) uniu a sua expertise em gestão de transporte com a solução Fretebras para que transportadores, embarcadores em geral, e agenciadores publiquem suas ofertas de frete, tendo como objetivo a negociação de motoristas autônomos e até mesmo transportadores (Pessoa Jurídica). Após a publicação da oferta diretamente pelo módulo Gestão de Transportes (SIGATMS), a oferta de frete estará vinculada a um viagem planejada, e todas as operações das Ofertas de Frete serão realizadas dentro do módulo: Inclusão, Alteração, Renovação, Concretização e Exclusão. 

Dessa maneira, ganha-se agilidade ao vincular as viagens planejadas (tipo 3=Planejada) e ofertas de frete.

O módulo passa a utilizar as APIs fornecidas pela Fretebras para solucionar e consumir os serviços da plataforma:

• Autenticação - Obter Token de acesso - POST- /oauth/token;

• Veículos - Lista tipos de veículos - GET - v1/veículos/tipos;

• Carrocerias - Lista carrocerias de veículos  - GET - v1/veiculos/carrocerias;

• Espécies - Lista espécies de carga - GET -  v1/especies;

• Tipos de preço - Lista os tipos de preço - GET - v1/tipos/precos;

• Criar frete  - Cria oferta de frete por assinante - POST - v1/assinantes/fretes;

• Altera frete - Altera uma oferta de frete - PUT - /v1/assinantes/fretes/{id};

• Deleta frete - Deleta uma oferta de frete - DELETE - /v1/assinantes/fretes/{id};

• Renovar frete - Renova uma oferta de frete -PUT - /v1/assinantes/fretes/{id}/renovar;

• Fechar Frete - Concretiza uma oferta de frete - POST - /v1/assinantes/fretes/{id}/concretizar;

02. SISTEMAS ENVOLVIDOS

• SIGATMS - As funcionalidades e rotinas que estão envolvidas no processo são: Viagem de Entrega e Transporte, Motoristas (OMSA040) e Veículos (OMSA060).

• FRETEBRAS- As APIs envolvidas são: Token, Tipos, Carrocerias, Espécies, Preços, Fretes, Renovar e Concretizar. Para obter mais informações, acesse o link.

03. INTEGRAÇÃO

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 permanecer 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) poderão ser excluídas.

04. ESCOPO

A comunicação com as APIS e plataforma Frebras ocorrem a partir das rotinas:

• Configurador Fretebras→ Testar Conexão;
• Viagem Planejada (DTQ_TIPVIA=3) → Outras Ações → Oferta de Frete;
• Incluir
  • Tipos de Veículos - DM2_TIPVEI;
  • Tipos de Carrocerias - DM2_TIPCAR;
  • Tipos de Preço - DM2_TIPPRE;
  • Espécie de Carga - DM2_TIPESP;
• Alterar;
  • Tipos de Veículos - DM2_TIPVEI;
  • Tipos de Carrocerias - DM2_TIPCAR;
  • Tipos de Preço - DM2_TIPPRE;
  • Espécie de Carga - DM2_TIPESP;
• Renovar;
• Concretizar;
• Deletar;
  
  

05. PRÉ-REQUISITOS PARA INSTALAÇÃO/IMPLANTAÇÃO/UTILIZAÇÃO

Premissas para o correto funcionamento:

• Protheus versão 12.1.30 ou superior. 
• Build superior à 191205P.
• Dicionário de dados atualizado com tabelas referente a integração.
  • DM1 - Configuração Integração;
  • DM2 - Oferta de Frete;
• Repositório de dados atualizado com programas referente a integração;
  • TMSA144.prw - Viagem;
  • TMSAC12.prw - Classe fretebras;
  • TMSAC13.prw - Configurador fretebras;
  • TMSAC14.prw - Ofertas de frete;
• Menu SIGATMS.XNU atualizado.

06. INSTALAÇÃO/ATUALIZAÇÃO

Este tópico tem por objetivo orientar a instalação da integração, visando o seu funcionamento completo. Instalação de produtos ou ferramentas necessárias podem referenciar outros documentos existentes, desde que estejam disponíveis no repositório de documentação da TOTVS ou sejam enviados junto com o documento da integração em si.

As informações mínimas necessárias para teste do tópico são:

• Execute a rotina UPDDISTR - Atualizador de dicionário e base de dados - UPDDISTR.
• Atualize o menu SIGATMS.XNU.
• Até o dia28/12/2020será possível realizar o download dos pacotes de dicionários neste link, após esta data recomendamos a solicitação via Suporte TMS (pacotes 007500 e 007157).

07. PROTHEUS - EXEMPLO DE UTILIZAÇÃO

CONFIGURAÇÃO:

No módulo SIGATMS acesse o menu Cadastro > Config. Fretebras (TMSAC13) para acessar o Configurador Fretebras.

• Clique em Incluir;
• No campo Client ID digite o ID de cliente informado pela Fretebras;
• No campo Client Secret digite o client secret informado pela Fretebras;
• No campo Usuário digite o usuário informado pela Fretebras;
• No campo Senha digite a senha informada pela Fretebras;
• No campo URL Envio digite a URL de envio:
  • Produção: URL Produção;
  • Homologação: URL Homologação;
• No campo ID Totvs digite o ID gerado pela Totvs Store.
• No campo URL Registro digite a URL de registro informada pela Totvs Store (Fluig);
• No campo URL Bilhetagem digite a URL de bilhetagem informada pela Totvs Store (Fluig);

No módulo SIGATMS acesse a rotina Viagem > Outras Ações > Oferta de Frete e selecione a operação desejada para incluir, alterar, renovar, concretizar e/ou deletar.

Detalhamento abaixo:

INCLUSÃO/ALTERAÇÃO: 

• Preencha o campo UF origem e Cidade origem com os dados de origem da oferta de frete;
• Preencha o campo UF destino e Cidade destino com os dados de destino da oferta de frete;
• Preencha o campo Produto com uma descrição da carga a ser transportada;
• Pressione F3 sob os campos:
  • Tp. Espécie para informar e visualizar as espécies de carga disponíveis;
  • Tp. Veículos para informar e visualizar os tipos de veículos disponíveis;
  • Carrocerias para informar e visualizar os tipos de carroceria disponíveis;
  • Tp. Preços para informar e visualizar os tipos de preços disponíveis;
• Preencha o campo Volume, Peso e Dimensões com os dados da carga;
• Preencha o campo Informações Adicionais, para adicionar eventuais observações;

Observação: Todas as validações serão realizadas de acordo com a Fretebras, não cabendo nesse momento a pré-validação das informações digitas dentro do Módulo SIGATMS. 

Se ocorrer alguma inconsistência, será exibido em tela o detalhamento.

RENOVAÇÃO:

De acordo com as regras da Fretebras, uma oferta de frete não atendida, expira automaticamente no período de 7 dias úteis, contando a data de sua publicação. Para realizar a renovação do frete, foi disponibilizada a opção no menu, em que não há interface, e a funcionalidade registra a renovação, e caso tenha sido renovado com sucesso a data do frete (DM2_DATFRT) será atualizada com a nova data. 

Observação: Todas as validações serão realizadas de acordo com a Fretebras, não cabendo nesse momento a pré-validação das informações digitadas dentro do módulo SIGATMS. 

Se ocorrer alguma inconsistência, será exibido em tela o detalhamento.

CONCRETIZAR:

Após algum motorista demonstrar o interesse pelas ofertas de carga publicadas, o mesmo irá entrar em contato com a empresa ofertante, que deverá realizar o cadastramento do Motorista e do Veículo a ser utilizado para o transporte da Oferta de Carga publicada. As informações enviadas para a Fretebras serão CPF do motorista e Placa do Veículo.

• Preencha o campo Código do Veículo para informar o veículo que irá realizar o transporte da carga;
• Preencha o campo Código do Motorista para informar o motorista que irá realizar o transporte da carga;

EXCLUSÃO

Apenas a exclusão de ofertas de carga que estão com o status 1=Em aberto (DM2_STATUS) poderão ser excluídas.

A validação foi incluída internamente no SIGATMS. 

08. FLUXO DAS INFORMAÇÕES

09. CADASTROS

Configurador Fretebras (TMSAC12)

As informações abaixo devem ser disponibilizadas pela Fretebras, com exceção dos campos ID Totvs, URL Registro e URL Bilhetagem que devem ser disponibilizados após a aquisição do serviço pela Totvs Store, e/ou através do link. 

• Client ID;
• Client Secret;
• User;
• Senha;
• URL;
• ID Totvs;
• URL Registro;
• URL Bilhetagem.

10. INTEGRAÇÃO

OFERTA DE FRETE Incluir/Alterar:

• origem
  • estado - Estado de Origem - DM2_UFORIG
  • cidade - Município de Origem - DM2_MUNORI
• destino
  • estado - Estado de Destino - DM2_UFDEST
  • cidade - Cidade de Destino - DM2_MUNDES
• carga
  • descricao - Produto - DM2_PROD
  • complemento 
    • Verdadeiro; se quantidade, peso ou dimensão maior que "0" zero.
    • Falso; se quantidade, peso e dimensão igual a "0" zero.
  • especie - Espécies de carga - DM2_TIPESP 
  • volume 
    • quantidade -DM2_VOLUME
    • peso - DM2_PESO
    • dimensao - DM2_DIMENS
• preco
  • tipo - Tipos de Preço - DM2_TIPPRE
  • valor -  Valor do Frete - DM2_FRETE
• pedagio_pago_pela_empresa - Pedágio será pago pela empresa? - DM2_PEDPAG
• informacoes_adicionais - Informações adicionais da carga - DM2_INFOAD
• exige_rastreamento - Exige Rastreamento? - DM2_RASTRE
• veiculos - Lista dos tipos de veículo aptos a realizar o transporte - { DM2_TIPVEI } 
• carrocerias - Lista dos tipos de carrocerias aptas a realizar o transporte - { DM2_TIPCAR }

OFERTA DE FRETE :

• Placa - Placa do veículo - DA3_PLACA;
• CPF - CPF do Motorista - DA4_CGC;

11. LIMITAÇÕES/RESTRIÇÕES GERAIS

A integração ocorrerá somente para Viagens do tipo 3=Planejada (DTQ_TIPVIA);