Todas as funcionalidades desse processo estão centralizadas no programa "Oferta de Carga" do menu Datasul.

Menu Datasul

Image Modified

Totvs custom tabs box

tabs	Pré Requisito,Parâmetros,Oferta de Carga,Cálculo de Embarque/Cálculo de Pedidos
ids	tab0,tab1,tab2,tab3

Totvs custom tabs box items

default	yes
referencia	tab0

Pré-requisito

Registro dos certificados da FreteBras na instalação Progress do Appserver

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.

Image Removed

Totvs custom tabs box

tabs	Passo 1 - Identificar Certificados da URL Portal,Passo 2 - Download dos Certificados,Passo 3 - Registro dos certificados no Progress
ids	passo1,passo2,passo3

Exemplo de registro de certificados na instalação Progress

Totvs custom tabs box items

default	yes
referencia	passo1

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.

Image Modified

No pop-up que será exibido, localize a parte de Certificado e clique em "Válido".

Image Modified

Totvs custom tabs box items

default	no
referencia	passo2

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.

Image Modified

Para baixar o certificado, selecione o desejável, vá para aba de "Detalhes" e clique em Copiar para Arquivo...

Image Modified

Clique em "Avançar".

Image Modified

Marque a opção "X.509 binário codificado por DER (*.cer)" e clique em "Avançar".

Image Modified

Selecione o diretório que deseja baixar o certificado e clique em "Avançar".

Image Modified

Clique em concluir.

Image Modified

Totvs custom tabs box items

default	no
referencia	passo3

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).

Informações

title	Importante

Os certificados devem ser baixados do último para o primeiro. E importados no PROENV da mesma maneira, do último para o primeiro.

.cer).

Informações

title	Importante

Os certificados devem ser baixados do último para o primeiro. E importados no PROENV da mesma maneira, do último para o primeiro.

Nota

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.

Image Added

Totvs custom tabs box items

default	no
referencia	tab1

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

Image Modified

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

Image Modified

Totvs custom tabs box items

default	no
referencia	tab2

Oferta de Carga

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

Nota

title	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

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

Image Modified

Busca avançada

Image Modified

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

Image ModifiedImage Modified

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.

Image Modified

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.

Image Modified

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.

Image Modified

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.

Image Modified

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.

Image Modified

Totvs custom tabs box items

default	no
referencia	tab3

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.

Aviso

title	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.

Image Modified

...

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

EVENTO WEBINAR

Section

Documento de Referência: Oferta de Carga (Integração com FreteBras) - html-meq.freightOffer

Expandir

title

Vídeo webinar - 17/07/2020 - Integração Totvs Backoffice Linha Datasul X FreteBras

Conector de Widget

width	720
url	https://www.youtube.com/watch?v=J-fXPryR0XI&feature=youtu.be
height	480

Templatedocumentos

HTML

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>

Árvore de páginas

Versões comparadas

Versão antiga 66

Nova versão 67

Chave

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

Passo 2 - Download dos Certificados

Passo 3 - Registro dos certificados no Progress

Parâmetros

Listagem dos Parâmetros da Oferta de Carga

Exemplo da interface

Interface Cadastrado e Manutenção do Parâmetro de Oferta de Carga

Exemplo da interface

Oferta de Carga

Listagem das Ofertas de Carga

Listagem das Ofertas de Carga

Busca avançada

Inclusão e Alteração da Oferta de Carga

Image ModifiedImage Modified

Negociação de Oferta de Carga

Renovação de Oferta de Carga

Cancelamento de Oferta de Carga

Cálculo de Embarque/Cálculo de Pedidos

05. DEMAIS INFORMAÇÕES

06. ASSUNTOS RELACIONADOS

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 66

Nova versão 67

Chave

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

Passo 2 - Download dos Certificados

Passo 3 - Registro dos certificados no Progress

Parâmetros

Listagem dos Parâmetros da Oferta de Carga

Exemplo da interface

Interface Cadastrado e Manutenção do Parâmetro de Oferta de Carga

Exemplo da interface

Oferta de Carga

Listagem das Ofertas de Carga

Listagem das Ofertas de Carga

Busca avançada

Inclusão e Alteração da Oferta de Carga

Image ModifiedImage Modified

Negociação de Oferta de Carga

Renovação de Oferta de Carga

Cancelamento de Oferta de Carga

Cálculo de Embarque/Cálculo de Pedidos

05. DEMAIS INFORMAÇÕES

06. ASSUNTOS RELACIONADOS