Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Totvs custom tabs box
tabsPré Requisito,Parâmetros,Oferta de Carga,Cálculo de Embarque/Cálculo de Pedidos
idstab0,tab1,tab2,tab3
Totvs custom tabs box items
defaultyes
referenciatab0

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.

Totvs custom tabs box
tabsPasso 1 - Identificar Certificados da URL Portal,Passo 2 - Download dos Certificados,Passo 3 - Registro dos certificados no Progress
idspasso1,passo2,passo3

Exemplo de registro de certificados na instalação Progress


Totvs custom tabs box items
defaultyes
referenciapasso1

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

Totvs custom tabs box items
defaultno
referenciapasso2

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. 

Totvs custom tabs box items
defaultno
referenciapasso3

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
titleImportante

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

Totvs custom tabs box items
defaultno
referenciatab1

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.

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

CampoObjetivo
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
Exemplo da interface

Image Added

Totvs custom tabs box items
defaultno
referenciatab2

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 interfaceObjetivo
Nova Oferta de CargaDisponibiliza a interface para cadastro da Oferta de Carga
BuscarRealiza 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
titleData 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 tabelaObjetivo
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
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

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

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.


Totvs custom tabs box items
defaultno
referenciatab3

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 Parcialo sistema irá gerar automaticamente o transportador da Oferta de Carga como transportador de Redespacho da nota fiscal.

Aviso
titleImportante

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.

...

08. ASSUNTOS RELACIONADOS

Expandir
titleEVENTO WEBINAR - 17/07/2020 - Integração Totvs Backoffice Linha Datasul X FreteBras

Conector de Widget
width720
urlhttps://www.youtube.com/watch?v=J-fXPryR0XI&feature=youtu.be
height480

...