| 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. 
| 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. 
No pop-up que será exibido, localize a parte de Certificado e clique em "Válido". 
|
| 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. 
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 |
|---|
| 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
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. | 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 Added
|
| 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
Busca avançada
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 |
 
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.
- 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 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.
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.
|
| 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. 
|
|
