Totvs custom tabs box items |
---|
| Pré-requisitoRegistro dos certificados da FreteBras na instalação Progress do Appserver 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. |
|
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 Modified
|
|
|
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-12-8_17-28-36.png?version=1&modificationDate=1607462917177&api=v2)
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![](/download/attachments/551444536/image2020-10-27_9-36-27.png?version=1&modificationDate=1603802187537&api=v2) ![](/download/attachments/551444536/image2020-10-27_9-36-1.png?version=1&modificationDate=1603802161453&api=v2)
Informações |
---|
icon | false |
---|
title | Contratação Totvs |
---|
| ![](/download/attachments/551444536/image2020-10-27_10-57-0.png?version=1&modificationDate=1603807261130&api=v2)
|
|
Totvs custom tabs box items |
---|
| Oferta de CargaDegustaçãoO 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.
Informações |
---|
| É 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
![](/download/attachments/551444536/totvs_tasting_01.png?version=1&modificationDate=1603893110560&api=v2)
![](/download/attachments/551444536/totvs_tasting_02.png?version=1&modificationDate=1603893110740&api=v2)
![](/download/attachments/551444536/totvs_tasting_03.png?version=1&modificationDate=1603893110887&api=v2)
Informaçõ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) ![](/download/attachments/551444536/image2020-12-8_17-36-21.png?version=1&modificationDate=1607463381473&api=v2)
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. ![](/download/attachments/551444536/image2020-12-8_17-41-54.png?version=1&modificationDate=1607463714200&api=v2)
|
Listagem 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.
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 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)
|
|