Árvore de páginas

CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Tela PARÂMETROS DA OFERTA DE CARGA
    1. Outras Ações / Ações relacionadas
  4. Tela OFERTA DE CARGA
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas
  6. Vídeo webinar - 17/07/2020 - Integração Totvs Backoffice Linha Datasul X FreteBras


01. VISÃO GERAL

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. 

A TOTVS alinhada com essa demanda do mercado, a partir dessa 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.


02. EXEMPLO DE UTILIZAÇÃO

O Fluxo de Integração entre o Sistema Datasul x o Portal FreteBras x o Motorista ocorre da seguinte maneira.

03. TELA 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.

Outras Ações / Ações relacionadas

Na interface de cadastro de um novo parâmetro, será solicitado o preenchimento de algumas informações em tela.

AçãoDescrição
ID ParâmetroIdentificador único para o parâmetro, gerado automaticamente pelo sistema
EstabelecimentoDetermina para qual estabelecimento o parâmetro será utilizado
ID Cliente PortalInformação obtida quando a empresa contrata um plano de uso na plataforma FreteBras
Credenciais do ClienteInformação obtida quando a empresa contrata um plano de uso na plataforma FreteBras
UsuárioInformação obtida quando a empresa contrata um plano de uso na plataforma FreteBras
SenhaInformaçã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.

AçãoDescrição
TokenToken utilizado para comunicação Datasul > FreteBras
Limite de Acesso MensalDetermina qual a quantidade de publicações e renovações de Oferta de Carga que o plano contratado na FreteBras disponibiliza
Quantidade RestanteApresenta a quantidade restante de publicações e renovações de Oferta de Carga
Última AtualizaçãoApresenta a data da última atualização dos parâmetros Datasul com a FreteBras

Parâmetros de contratação Totvs.

AçãoDescrição
URL Totvs BillingEndereç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 AtivaIndica se o token está ativo, parâmetro de consulta, não permite edição
Validar Credencial TotvsBotão para validar se o token está ativo

Contratação Totvs


04. TELA 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, ainda será possível editar e movimentar ofertas de cargas criadas antes do fim do período de degustação. Para continuar usando a inclusão de ofertas de cargas devera ser feita a inclusão dos parâmetros de contratação Totvs (URL Totvs Billing e Credencial Totvs (Token)).



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)


Principais Campos e Parâmetros

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 InterfaceObjetivo
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:
→ Data de Publicação Inicial: 01/01/ano corrente
→ Data de Publicação Final: 31/12/ano corrente

BuscarRealiza uma pesquisa simples nas informações das colunas "Estabelecimento", "Embarque", "ID. Portal", "Origem" e "Destino"
Nova Oferta de CargaDisponibiliza a interface para cadastro da Oferta de Carga
AçõesObjetivo
DetalharApresenta a interface para consulta da Oferta de Carga
EditarApresenta a interface para alteração da Oferta de Carga
NegociarApresenta a interface de Negociação da Oferta de Carga
RenovarRenova a Oferta de Carga no Portal da FreteBras
CancelarCancela a Oferta de Carga no Portal da FreteBras
RemoverElimina a Oferta de Carga no Datasul



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.


CampoDescrição
ID. PortalIdentificado único da Oferta de Carga (Datasul e FreteBras)
SituaçãoSituação da Oferta de Carga
Data/Hora PublicaçãoData e Hora da publicação da Oferta de Carga no Portal FreteBras
VinculoDetermina com qual informação a Oferta de Carga será vinculada
EstabelecimentoEstabelecimento da Oferta de Carga (informação será utilizada em novas fases do projeto)
EmbarqueEmbarque da Oferta de Carga (disponível quando o vinculo selecionado for Embarque)
Pedido de VendaPedido de Venda da Oferta de Carga (disponível quando o vinculo selecionado for Pedido de Venda)
Estado OrigemApresenta uma lista para seleção do estado de origem
Cidade OrigemApresenta uma lista para seleção da cidade de origem
Estado DestinoApresenta uma lista para seleção do estado de destino
Cidade DestinoApresenta uma lista para seleção da cidade de origem
Trecho para TransporteEssa informação é de uso exclusivo do Datasul, indica se o transporte é total ou parcial
Descrição da CargaA FreteBras exige uma descrição simples da carga
Espécie da CargaApresenta uma lista proveniente do Portal FreteBras para seleção da espécie da carga
Complemento da CargaIndica se a carga é um complemento
Quantidade Quantidade
PesoPeso
DimensãoDimensão
Tipo do PreçoApresenta uma lista proveniente do Portal FreteBras para seleção do tipo de preço
Valor em RealValor pago pelo frete exigido quando o Tipo do Preço for diferente de "A combinar"
Pedágio Pago pela EmpresaIndica se o pedágio será pago pela empresa
Exige RastreamentoIndica se exige rastreamento
Informações AdicionaisInformações adicionais
VeículoDescrição do veículo
CarroceriaDescriçã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.


05. TABELAS UTILIZADAS

  • 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. VÍDEO WEBINAR - 17/07/2020 - INTEGRAÇÃO TOTVS BACKOFFICE LINHA DATASUL X FRETEBRAS