01. DADOS GERAIS
| Produto: | TOTVS Backoffice |
|---|---|
| Linha de Produto: | Linha Datasul |
| Segmento: | Backoffice |
| Módulo: | MEQ - Embarques |
| Função: | html-meq.freightOffer - Oferta de Carga |
| Requisito/Story/Issue: | DMANFAT1-15729, DMANFAT1-16134, DMANFAT1-17420, DMANFAT1-17421, DMANFAT1-17422, DMANFAT1-15917 |
02. SITUAÇÃO/REQUISITO
O “last-mile” (tradução literal para "última milha" ou também "último quilômetro") é o último estágio do transporte, é nele que as mercadorias são distribuídas para entregas para seus destinos finais, sejam para consumidores pessoas físicas (B2C), ou para clientes pessoas jurídicas (B2B).
No segmento dos transportes significa a última etapa de entrega de uma mercadoria, normalmente essa etapa é caracterizada como o momento que a encomenda sai do centro de distribuição e vai até o cliente final.
Por este motivo essa última etapa do transporte é tão importante, pois ela é decisiva para a experiência do cliente com a empresa, onde ele avaliará o tempo da entrega e as condições em que a encomenda chegou às suas mãos, o que garante suas recorrência de compra e fidelização.
03. SOLUÇÃO
A TOTVS alinhada com essa demanda do mercado, a partir desse Release incorporou em sua solução Padrão Datasul o programa de Oferta de Carga integrado com o Portal da FreteBras.
Essa é uma empresa focada no Last-mile, desenvolvendo soluções para o setor de transporte, sendo uma plataforma online para a divulgação de fretes, veículos, produtos e serviços do setor de transporte rodoviários de cargos. A integração entre o Datasul e o FreteBras visa a divulgação de fretes disponíveis de maneira automática, dentro do Datasul com a visibilidade proporcionada por essa plataforma.
A FreteBras não participa diretamente do fechamento das negociações. portanto, não monetiza sobre as transações efetuadas (match). Na prática funciona como um grande portal de classificados, eliminando 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 nesse segmento.
A solução possui um aplicativo WEB no qual os embarcadores ou transportadoras ofertam suas cargas. As empresas que são assinantes deste aplicativo, se conectam e cadastram as cargas que estão disponíveis para serem transportadas. Disponibiliza APIs via JSON, para que as transportadoras ou embarcadores envie as informações. Na oferta de frete as informações de carga ficam disponíveis para a consulta de motoristas assinantes da plataforma FreteBras. Por meio da localização geográfica, o motorista visualiza as ofertas que os embarcadores ou transportadoras inseriram no sistema.
A negociação caso exista interesse, o motorista deve entrar em contato com o embarcador ou transportadora para que a negociação seja feita diretamente entre ambas as partes.
O Fluxo de Integração entre o Sistema Datasul x o Portal FreteBras x o Motorista ocorre da seguinte maneira.
A seguir, serão detalhadas todas as implementações realizadas no Produto Datasul para atender a essa demanda.
04. PRÉ-REQUISITO, PARÂMETROS E PROGRAMAS
Todas as funcionalidades desse processo estão centralizadas no programa "Oferta de Carga" do menu Datasul.
Menu Datasul
Pré-requisito
Registro dos certificados da FreteBras na instalação Progress do Appserver
Exemplo de registro de certificados na instalação Progress
Passo 1 - Identificar certificados da URL Portal
O exemplo abaixo utiliza os certificados do Google como exemplo, porém, para a integração com a FreteBras é necessário efetuar o download do site informado no campo URL Portal, nos Parâmetros da Oferta de Carga.
Para localizar os certificados da URL, pressione para Visualizar as Informações do site.
No pop-up que será exibido, localize a parte de Certificado e clique em "Válido".
Passo 2 - Download dos Certificados
Após concluir o Passo 1, localize a aba "Caminho de Certificação" na janela que é aberta. Nessa tela são exibidos todos os certificados da URL.
Para baixar o certificado, selecione o desejável, vá para aba de "Detalhes" e clique em Copiar para Arquivo...
Clique em "Avançar".
Marque a opção "X.509 binário codificado por DER (*.cer)" e clique em "Avançar".
Selecione o diretório que deseja baixar o certificado e clique em "Avançar".
Clique em concluir.
Passo 3 - Registro dos certificados no Progress
Para cada certificado baixado executar o seguinte comando no proenv: certutil -format DER -import diretorio\nome_certificado.cer (Exemplo: certutil -format DER -import C:\Temp\nome_do_certificao.cer).
Importante
Os certificados devem ser baixados do último para o primeiro. E importados no PROENV da mesma maneira, do último para o primeiro.
Para que a integração Datasul > FreteBras funcione corretamente, é necessário aplicar os certificados da FreteBras em cada instalação Progress. Se a funcionalidade for executada sem a conclusão desse pré-requisito, será apresentada a mensagem de erro "Falta de certificado para conexões SSL". Para corrigir o erro, é necessário efetuar o download de cada certificado disponibilizado pela FreteBras e importá-lo na instalação Progress do Appserver Datasul.
Parâmetros
Listagem dos Parâmetros da Oferta de Carga
A interface apresenta uma listagem dos parâmetros cadastrados e ações para pesquisa e manutenção do parâmetro.
Exemplo da interface
Interface Cadastrado e Manutenção do Parâmetro de Oferta de Carga
Na interface de cadastro de um novo parâmetro, será solicitado o preenchimento de algumas informações em tela.
Campo | Objetivo |
|---|---|
ID Parâmetro | Identificador único para o parâmetro, gerado automaticamente pelo sistema |
Estabelecimento | Determina para qual estabelecimento o parâmetro será utilizado |
ID Cliente Portal | Informação obtida quando a empresa contrata um plano de uso na plataforma FreteBras |
Credenciais do Cliente | Informação obtida quando a empresa contrata um plano de uso na plataforma FreteBras |
Usuário | Informação obtida quando a empresa contrata um plano de uso na plataforma FreteBras |
Senha | Informação obtida quando a empresa contrata um plano de uso na plataforma FreteBras |
URL Portal | Informação obtida quando a empresa contrata um plano de uso na plataforma FreteBras |
Após confirmar a inclusão do parâmetro, o Datasul irá se comunicar com a FreteBras utilizando as informações preenchidas anteriormente e caso a conexão seja realizada com sucesso, os campos abaixo serão preenchidos, indicando que o processo ocorreu com sucesso.
| Campo | Objetivo |
|---|---|
| Token | Token utilizado para comunicação Datasul > FreteBras |
| Limite de Acesso Mensal | Determina qual a quantidade de publicações e renovações de Oferta de Carga que o plano contratado na FreteBras disponibiliza |
| Quantidade Restante | Apresenta a quantidade restante de publicações e renovações de Oferta de Carga |
| Última Atualização | Apresenta a data da última atualização dos parâmetros Datasul com a FreteBras |
Parâmetros de contratação Totvs.
| Campo | Objetivo |
|---|---|
| URL Totvs Billing | Endereço para realizar a cobrança do uso, por padrão esse campo é preenchido com a URL de produção |
| Credencial Totvs (Token) | Token utilizado para realizar a cobrança do uso, esse token é gerado na Totvs Apps para o aplicativo Publicacarga |
| Credencial Totvs Ativa | Indica se o token está ativo, parâmetro de consulta, não permite edição |
| Validar Credencial Totvs | Botão para validar se o token está ativo |
Exemplo da interface
Contratação Totvs
- A URL Totvs Billing por padrão deve ser o link abaixo: http://plan-usage-tracker.k8s-platform-prod-us-east-1.fluig.io
- A Credencial Totvs (Token) ficará disponível após a contratação da funcionalidade pela TOTVS Store. O Token pode ser gerado nesta interface do TOTVS Apps.
Oferta de Carga
Degustação
O programa possui um período de degustação, onde é possível criar até 50 ofertas de cargas sem precisar contratar o TOTVS publicação automática de carga (https://totvs.store/br/produto/publicacao-automatica-de-cargas.html). Após a utilização de todas as 50 ofertas de cargas não será mais possível incluir uma nova oferta de carga.
Observação
É possível editar e movimentar ofertas de cargas criadas antes do fim do período de degustação, mas não será possível criar uma nova oferta de carga sem antes configurar os parâmetros de contratação Totvs (URL Totvs Billing e Credencial Totvs (Token))
Mensagens de Degustação
Validações
Parâmetros de Oferta de Carga
Caso exista a contratação já configurada para um Parâmetro de Oferta de Carga, o sistema não permite atualizar a edição de um novo Parâmetro sem que sejam informados os dados de Contratação Totvs: URL Totvs Billing e Credencial Totvs (Token)
Oferta de Carga
Da mesma forma, caso o estabelecimento utilizado para cadastro de Nova Oferta de Carga esteja com a Situação da Credencial inválida, o sistema não permite salvar o registro.
Listagem das Ofertas de Carga
Essa interface apresenta uma listagem das Ofertas de Carga cadastradas e ações para pesquisa e manutenção da Oferta de Carga.
| Ações disponíveis na interface | Objetivo |
|---|---|
| Nova Oferta de Carga | Disponibiliza a interface para cadastro da Oferta de Carga |
| Buscar | Realiza uma pesquisa simples nas informações das colunas "Estabelecimento", "Embarque", "ID. Portal", "Origem" e "Destino" |
| Busca avançada | Disponibiliza uma interface com campos que permitem uma pesquisa aprimorada Data de Publicação Inicial/Final Para maior abrangência na busca, as datas serão previamente sugeridas como: |
| Ações disponíveis na tabela | Objetivo |
|---|---|
| Detalhar | Apresenta a interface para consulta da Oferta de Carga |
| Editar | Apresenta a interface para alteração da Oferta de Carga |
| Negociar | Apresenta a interface de Negociação da Oferta de Carga |
| Renovar | Renova a Oferta de Carga no Portal da FreteBras |
| Cancelar | Cancela a Oferta de Carga no Portal da FreteBras |
| Remover | Elimina a Oferta de Carga no Datasul |
Listagem das Ofertas de Carga
Busca avançada
Inclusão e Alteração da Oferta de Carga
Essa interface possibilita a inclusão e alteração de uma Oferta de Carga
- Ao confirmar a inclusão ou alteração, é realizada a integração com o Portal da FreteBras e todas as mensagens de erro ou de inconsistências serão apresentadas nesse momento.
- Após aberta a Oferta de Carga, ela ficará disponível no Portal FreteBras por 7 dias, depois disso ela é expirada. Para renovar uma Oferta de Carga, deve-se utilizar a opção "Renovar".
- Apenas Oferta de Carga com a situação "Aberta" podem ser alteradas.
Campo | Objetivo |
|---|---|
ID. Portal | Identificado único da Oferta de Carga (Datasul e FreteBras) |
Situação | Situação da Oferta de Carga |
Data/Hora Publicação | Data e Hora da publicação da Oferta de Carga no Portal FreteBras |
| Vinculo | Determina com qual informação a Oferta de Carga será vinculada |
Estabelecimento | Estabelecimento da Oferta de Carga (informação será utilizada em novas fases do projeto) |
| Embarque | Embarque da Oferta de Carga (disponível quando o vinculo selecionado for Embarque) |
| Pedido de Venda | Pedido de Venda da Oferta de Carga (disponível quando o vinculo selecionado for Pedido de Venda) |
| Estado Origem | Apresenta uma lista para seleção do estado de origem |
| Cidade Origem | Apresenta uma lista para seleção da cidade de origem |
| Estado Destino | Apresenta uma lista para seleção do estado de destino |
| Cidade Destino | Apresenta uma lista para seleção da cidade de origem |
| Trecho para Transporte | Essa informação é de uso exclusivo do Datasul, indica se o transporte é total ou parcial |
| Descrição da Carga | A FreteBras exige uma descrição simples da carga |
| Espécie da Carga | Apresenta uma lista proveniente do Portal FreteBras para seleção da espécie da carga |
| Complemento da Carga | Indica se a carga é um complemento |
Quantidade | Quantidade |
| Peso | Peso |
| Dimensão | Dimensão |
| Tipo do Preço | Apresenta uma lista proveniente do Portal FreteBras para seleção do tipo de preço |
| Valor em Real | Valor pago pelo frete exigido quando o Tipo do Preço for diferente de "A combinar" |
| Pedágio Pago pela Empresa | Indica se o pedágio será pago pela empresa |
| Exige Rastreamento | Indica se exige rastreamento |
| Informações Adicionais | Informações adicionais |
| Veículo | Descrição do veículo |
| Carroceria | Descrição da carroceria |
Negociação de Oferta de Carga
Essa interface possibilita a negociação de uma Oferta de Carga.
- Após a empresa receber o contato do transportador interessado na Oferta de Carga, a confirmação desse serviço deve ser realizada por essa interface, na qual permite informar/cadastrar o transportador, o veículo que será utilizado para o frete e uma observação da negociação.
- Caso o transportador interessado em fechar a Oferta de Carga não esteja cadastrado no programa CD0402 - Transportadores, será possível criar um novo Transportador através de um cadastro facilitado, na tela de Negociação de Oferta de Carga, clicando em Cadastrar Novo Transportador.
- Será aberta a modal, onde constam informações obrigatórias a serem preenchidas para cadastro do novo transportador.
- O transportador criado poderá ser consultado no programa CD0402 - Transportadores, tendo a possibilidade de complementar com as demais informações que se considerem necessárias.
- Após a inclusão, será possível a criação facilitada de um novo Veículo para o transportador selecionado no campo de Código do Transportador, clicando em Cadastrar Novo Veículo do Transportador.
- Os campos informados no Novo Veículo do Transportador poderão ser consultados no programa CD0152 - Cadastro de Veículo, observando que os campos de CPF, Nome, Tipo Proprietário e Tara Kg são setados automaticamente, podendo ser alterados acessando ao CD0152.
- Após confirmar a negociação, a situação da Oferta de Carga no Datasul muda para "Fechada", impossibilitando novas alterações.
Renovação de Oferta de Carga
Essa função possibilita a renovação de uma Oferta de Carga
Quando uma oferta de frete é renovada, a sua data de publicação passa a ser a data atual.
Essa operação é útil, pois os fretes na plataforma cadastrados com mais de 7 dias são expirados automaticamente e através dessa função pode-se alterar a data de publicação do frete sem alterar o restante do seu conteúdo.
Cancelamento de Oferta de Carga
Essa função possibilita o cancelamento de uma Oferta de Carga
O cancelamento de uma oferta de carga elimina a publicação da oferta no Portal FreteBras.
- Ao solicitar o cancelamento, será solicitado ao usuário uma justificativa, porém, essa informação é interna e não é enviada para o Portal FreteBras.
Com a situação Cancelada, ainda é possível consultar a Oferta de Carga no Datasul como histórico, e também é possível remover a Oferta de Carga no Datasul, eliminando-a do sistema.
Cálculo de Embarque/Cálculo de Pedidos
Quando realizado o cálculo do Embarque via FT4001, caso exista o vínculo entre Oferta de Carga e o Embarque que está sendo calculado serão buscados os dados do transportador relacionado a Oferta de Carga, quando a mesma estiver com a situação "Fechada".
Quando realizado o cálculo do Pedido via FT4002, caso exista o vínculo entre Oferta de Carga e o Pedido que está sendo calculado serão buscados os dados do transportador relacionado a Oferta de Carga, quando a mesma estiver com a situação "Fechada".
Caso o "Trecho para Transporte" for de Transporte Total, o sistema irá gerar automaticamente o transportador da Oferta de Carga como transportador principal da nota fiscal e atualizará também os dados da Placa e UF relacionados ao veículo.
Se o "Trecho para Transporte" for de Transporte Parcial, o sistema irá gerar automaticamente o transportador da Oferta de Carga como transportador de Redespacho da nota fiscal.
Importante
Mesmo que exista uma oferta de carga cadastrada para o número do pedido que está vinculado ao embarque, quando o cálculo for realizado via FT4001 (Cálculo de Embarque) a busca da oferta será realizada para o "Vínculo" do tipo "Embarque".
Quando o cálculo for realizado pelo FT4002 (Cálculo de Pedidos) a busca da oferta será realizada para o "Vínculo" do tipo "Pedido".
Nos cálculos via FT4001 e FT4002, se a Oferta de Carga estiver com a situação "Aberta", será demonstrado o alerta ao usuário com o "ID. Portal" da oferta encontrada, e os dados do transportador não serão atualizados, pois quando a oferta está em aberto não há dados referente ao transportador.
05. DEMAIS INFORMAÇÕES
Para atender as necessidades trazidas por essa implementação, foi necessário a criação de duas novas tabelas no sistema, sendo elas:
- Tabela OFERTA-CARG = Oferta de Carga (banco MGMOV)
- Tabela PARAM-CARG = Parâmetros de Carga (banco MGCAD)
06. ASSUNTOS RELACIONADOS
Documento de Referência: Oferta de Carga (Integração com FreteBras) - html-meq.freightOffer
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas