Totvs custom tabs box items |
---|
| Pré-requisitoRegistro dos certificados da FreteBras na instalação Progress do AppserverPara 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. ![](/download/attachments/551444536/image2020-7-14_15-34-25.png?version=1&modificationDate=1594751666113&api=v2)
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 PortalO 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. ![](/download/attachments/551444536/Picture1.PNG?version=1&modificationDate=1592501107003&api=v2)
No pop-up que será exibido, localize a parte de Certificado e clique em "Válido". ![](/download/attachments/551444536/Picture2.png?version=1&modificationDate=1592501107050&api=v2)
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Passo 2 - Download dos CertificadosApó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. ![](/download/attachments/551444536/Picture3.PNG?version=1&modificationDate=1592501107087&api=v2)
Para baixar o certificado, selecione o desejável, vá para aba de "Detalhes" e clique em Copiar para Arquivo... ![](/download/attachments/551444536/Picture4.PNG?version=1&modificationDate=1592501107130&api=v2)
Clique em "Avançar". ![](/download/attachments/551444536/Picture5.PNG?version=1&modificationDate=1592501107163&api=v2)
Marque a opção "X.509 binário codificado por DER (*.cer)" e clique em "Avançar". ![](/download/attachments/551444536/Picture6.PNG?version=1&modificationDate=1592501107203&api=v2)
Selecione o diretório que deseja baixar o certificado e clique em "Avançar". ![](/download/attachments/551444536/Picture7.PNG?version=1&modificationDate=1592501107247&api=v2)
Clique em concluir. ![](/download/attachments/551444536/Picture8.PNG?version=1&modificationDate=1592501107303&api=v2)
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
| Passo 3 - Registro dos certificados no ProgressPara 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 |
---|
| 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 |
---|
| ParâmetrosListagem dos Parâmetros da Oferta de CargaA interface apresenta uma listagem dos parâmetros cadastrados e ações para pesquisa e manutenção do parâmetro. Exemplo da interface![](/download/attachments/551444536/image2020-7-20_13-59-28.png?version=1&modificationDate=1595264368487&api=v2)
Interface Cadastrado e Manutenção do Parâmetro de Oferta de CargaNa 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. Pivot Table |
---|
| id | 1603395583034_1518942547 |
---|
| 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![](/download/attachments/551444536/image2020-7-20_14-2-57.png?version=1&modificationDate=1595264577413&api=v2)
![](/download/attachments/551444536/image2020-10-22_16-36-48.png?version=1&modificationDate=1603395408310&api=v2)
Totvs custom tabs box items |
---|
| Oferta de CargaListagem das Ofertas de CargaEssa 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![](/download/attachments/551444536/image2020-7-20_14-4-35.png?version=1&modificationDate=1595264675677&api=v2)
Busca avançada![](/download/attachments/551444536/image2020-7-14_15-42-19.png?version=1&modificationDate=1594752139247&api=v2)
Inclusão e Alteração da Oferta de CargaEssa 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 |
![](/download/attachments/551444536/image2020-7-14_15-8-17.png?version=1&modificationDate=1594750097577&api=v2) ![](/download/attachments/551444536/image2020-7-14_15-2-42.png?version=1&modificationDate=1594749762813&api=v2)
Negociação de Oferta de CargaEssa 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.
![](/download/attachments/551444536/image2020-8-6_16-11-49.png?version=1&modificationDate=1596741109897&api=v2)
- 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.
![](/download/attachments/551444536/image2020-7-17_8-23-57.png?version=1&modificationDate=1594985037997&api=v2)
- 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.
![](/download/attachments/551444536/image2020-7-17_8-44-54.png?version=1&modificationDate=1594986294977&api=v2)
- 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 CargaEssa 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.
![](/download/attachments/551444536/image2020-7-14_15-45-18.png?version=1&modificationDate=1594752319037&api=v2)
![](/download/attachments/551444536/image2020-7-14_15-45-36.png?version=1&modificationDate=1594752336217&api=v2)
![](/download/attachments/551444536/image2020-7-14_15-46-35.png?version=1&modificationDate=1594752395407&api=v2)
Cancelamento de Oferta de CargaEssa 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.
![](/download/attachments/551444536/image2020-7-14_15-47-7.png?version=1&modificationDate=1594752427673&api=v2)
![](/download/attachments/551444536/image2020-7-14_15-47-37.png?version=1&modificationDate=1594752457467&api=v2)
![](/download/attachments/551444536/image2020-7-14_15-48-7.png?version=1&modificationDate=1594752487703&api=v2)
|
Totvs custom tabs box items |
---|
| Cálculo de Embarque/Cálculo de PedidosQuando 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 |
---|
| 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. ![](/download/attachments/551444536/image2020-7-16_16-56-40.png?version=1&modificationDate=1594929400117&api=v2)
|
|