DOS010 - Documento Técnico

ERP-0586 – Revitalização do Frete Embarcador

V.2

Criado para:
 ___________________________________________________________________________________________________

DOS010 - Documento Técnico ERP-0586 – Revitalização do Frete Embarcador

2

SUMÁRIO
1. REVISÕES ...................................................................................................................................................................... 3

2. ENVOLVIDOS NO PROJETO .......................................................................................................................................... 3

3. SIGLAS........................................................................................................................................................................... 3

4. SISTEMA/ROTINAS ....................................................................................................................................................... 3

5. OBJETIVO ...................................................................................................................................................................... 3

6. PREMISSAS ................................................................................................................................................................... 3

7. FLUXO OPERACIONAL DO PROJETO ............................................................................................................................ 4

8. ARQUITETURA/INTEGRAÇÃO ...................................................................................................................................... 4

9. BANCO DE DADOS ........................................................................................................................................................ 5

10. CONTEÚDO ............................................................................................................................................................... 5

10.1.1 – CONTROLE DE PRÉ-FATURAS. ...................................................................................................................... 5

10.1.2 – AUDITORIA DE FRETE .................................................................................................................................. 6

10.2.1 – DASHBOARD SIGAFE.................................................................................................................................... 7

10.3.1 – INTEGRAÇÃO FRETEFY ................................................................................................................................. 9

10.4.1 – DEPLOY ....................................................................................................................................................... 9

10.4.2 – ACOMPANHAMENTO ................................................................................................................................ 10

Curitiba – PR | comercial@samcorp.com.br | samcorp.com.br

ANTES DE IMPRIMIR pense em sua responsabilidade e compromisso com o MEIO AMBIENTE
 ___________________________________________________________________________________________________

DOS010 - Documento Técnico ERP-0586 – Revitalização do Frete Embarcador

3

1. REVISÕES

DATA VERSÃO DESCRIÇÃO AUTOR

07/01/2022 1.0 Criação do documento Luis Claudio Drohomereski

2. ENVOLVIDOS NO PROJETO

EMPRESA NOME FUNÇÃO/SEGOR E-MAIL / TELEFONE DE CONTATO

Samcorp Luis Claudio Arquiteto de Soluções luis.claudio@samcorp.com.br
Samcorp Marcia Bezerra Executiva de Vendas marcia.bezerra@samcorp.com.br
Prodiet Jonatas Gerencia de TI jpaiva@prodiet.com.br
Prodiet Pedro Domingues Logística pdomingues@prodiet.com.br

3. SIGLAS

TERMO DESCRIÇÃO
GFE gestão frete embarcador
API Application Programming Interface
P12 Protheus 12
texto itálico descrição sintética das tarefas / atividades do projeto
{} entre chaves Nomes de rotinas, transações, tabelas ou parâmetros para área técnica do projeto

4. SISTEMA/ROTINAS

TOTVS | PROTHEUS | SIGAGFE

API - FRETEFY

5. OBJETIVO

Revitalizar o module de gerenciamento de fretes sob visão do embarcador – Prodiet – garantindo que os
procedimentos administrativos e gerenciais sobre os custos de fretes na distribuição sejam auditáveis.
Apresentar os indicadores de gestão dos fretes de distribuição.

Descrever em cenários possíveis com integração a sistema terceiros de gerenciamento de fretes - FreteFly

6. PREMISSAS

Curitiba – PR | comercial@samcorp.com.br | samcorp.com.br

ANTES DE IMPRIMIR pense em sua responsabilidade e compromisso com o MEIO AMBIENTE
 ___________________________________________________________________________________________________

DOS010 - Documento Técnico ERP-0586 – Revitalização do Frete Embarcador

4

o Desenvolvimento de mínimo produto viável de integração;

o Manter as regras de negócio (padrão) SIGAGFE;
o Disponibilizar ambiente de homologação e produção a consultoria;
o Disponibilizar usuários chaves para validações e aceites.

7. FLUXO OPERACIONAL DO PROJETO

Fluxograma padrão SIGAGFE

8. ARQUITETURA/INTEGRAÇÃO

Integração SIGAGFE – API – FRETEFY

Curitiba – PR | comercial@samcorp.com.br | samcorp.com.br

ANTES DE IMPRIMIR pense em sua responsabilidade e compromisso com o MEIO AMBIENTE
 ___________________________________________________________________________________________________

DOS010 - Documento Técnico ERP-0586 – Revitalização do Frete Embarcador

5

9. BANCO DE DADOS

SQL SERVER
API FRETEFY (https://fretefy.docs.apiary.io/#introduction/requisitos)

10. CONTEÚDO

São propostos dois cenários:

a) Uso extensivo do SIGAGFE até o geração de indicadores DASHBOARD nativos;
b) Uso de INTEGRAÇÃO SIGAGFE (documentos de carga) com a plataforma FRETEFLY;

10.1.1 – Controle de Pré-Faturas.

Conceito: A pré-fatura é uma prévia da fatura de frete, que enumera os documentos de cargas transportados e
suas respectivas características de carga e valores de frete. Gerada pelo Embarcador, com base nos cálculos de
frete dos Romaneios de Carga e enviada para o Transportador, que confere e negocia as eventuais divergências.

Regras de Negócio: A geração das pré-faturas ocorre de acordo com os parâmetros especificados, para cada
Transportador (exceto autônomos) da faixa informada, sendo localizados os cálculos de frete sem pré-faturas
relacionadas. Quando as condições definidas nos parâmetros forem atendidas, o sistema gera uma pré-fatura
para cada critério de agrupamento informado no Cadastro do Emitente, para o qual haja pelo menos um cálculo.

A fatura é bloqueada, caso exista divergência entre o valor da Fatura e os Documentos de Frete. Por ser o
instrumento de cobrança dos Documentos de Frete, a Fatura deve apresentar exatamente o total dos valores
daqueles documentos. O parâmetro Valor - MV_CFVLFAT marcado com a opção 1 - Sim, indica que o valor total
da Fatura será conferido com o valor total das Pré-Faturas, considerando as tolerâncias parametrizadas.

As tolerâncias cadastradas são consideradas apenas para divergências entre Faturas e Pré-Faturas, não
considerando a tolerância para as divergências entre o valor das Faturas e Documentos de Frete.

Na conferência, o valor total da Fatura é considerado sem descontos e juros. Esse total é comparado com o total
dos Documentos de Frete, sem considerar a tolerância. Se a Fatura for bloqueada por esse motivo, não pode ser
aprovada manualmente. Por ser o instrumento de cobrança dos Documentos de Frete, a Fatura deve apresentar
exatamente o total dos valores daqueles documentos.

Técnica: a rotina Pré-fatura {GFEA055 – SIGAGFE; GWJ, GWH} possibilita a geração e a simulação de pré-fatura
(neste, realiza o cálculo dos documentos de cobrança feitos pelo transportador.)

Tarefa: capacitar sobre a configurações, parametrizações e uso dos eventos da rotina de pré-faturas. Validar a
integração com ERP Protheus através das ações de atualização ou estorno ao SIGAFIN. Uma pré-fatura poderá
gerar um título provisório no Financeiro, para que seja provisionados o valor de frete. Poderá anexar documentos
ao processo.

Curitiba – PR | comercial@samcorp.com.br | samcorp.com.br

ANTES DE IMPRIMIR pense em sua responsabilidade e compromisso com o MEIO AMBIENTE
 ___________________________________________________________________________________________________

DOS010 - Documento Técnico ERP-0586 – Revitalização do Frete Embarcador

6

Campo Descrição

Tipo Tipo de geração das pré-faturas:

Geração  Simulação: determina que somente deve ser gerada uma simulação da geração das pré-faturas, não ocorrendo a geração
delas. Ao final da execução é aberta uma tela apresentando as pré-faturas com opção de detalhamento dos cálculos
relacionados e de efetivação das pré-faturas.
 Geração: determina que a pré-fatura deve ser gerada quando os parâmetros forem confirmados.

Tipo de Tipos de cálculos a serem considerados para a geração das pré-faturas:

Cálculo  Tipo Normal;
 Tipo Compl. Valor;
 Tipo Compl. Imposto;
 Tipo Reentregar;
 Tipo Devolução;
 Tipo Redespacho;
 Tipo Serviço.
Para que o tipo de cálculo seja considerado, o seu valor deve ser igual a Sim.

Demanda Específica: EDI (Ocorren e Conemb) – A Prodiet não usa |EDI DOCCOB| nem o que é remessa para as
transportadoras. Customizamos aviso para notificar cliente, quando há registro de entrega no Protheus (sic).

Atividade: configurar a importação de documentos de frete (ct-e) e faturas de frete (nota fiscais de prestação de
serviço de transporte e realizar a integração ao Financeiro através da rotina Pré-fatura {GFEA055}.

10.1.2 – AUDITORIA DE FRETE

Conceito: efetuar a aprovação ou rejeição dos documentos de frete que apresentam divergências.

Regra de Negócio: Todos os documentos de frete são conferidos automaticamente, de acordo com os critérios
de conferência informados nos Parâmetros de Controle de Frete.

VALORES:
1. Quando estiver parametrizado para conferir Dados dos Documentos: quantidade de volumes, peso
real, peso cubado, volume e valor dos itens.
2. Quando estiver parametrizado para conferir Valores Detalhados: frete unidade, frete valor, taxas e
valor do pedágio.
3. Quando estiver parametrizado para conferir Valor Total: valor total do frete, alíquota e valor do
imposto (ICMS ou ISS).

OCORRÊNCIAS:
1. Bloquear documentos de frete com documentos de carga que tenham ocorrências, quando o tipo de
ocorrência indicar que o documento de frete deve ser bloqueado.
2. Bloquear documentos de frete com documentos de carga sem data de entrega (trecho respectivo)
quando no cadastro do transportador indicar que a entrega é obrigatória.

AGRUPAMENTOS
1. Bloquear documentos de frete sem documentos de carga vinculados.

Curitiba – PR | comercial@samcorp.com.br | samcorp.com.br

ANTES DE IMPRIMIR pense em sua responsabilidade e compromisso com o MEIO AMBIENTE
 ___________________________________________________________________________________________________

DOS010 - Documento Técnico ERP-0586 – Revitalização do Frete Embarcador

7

2. Bloquear documentos de frete com documentos de carga diferentes dos documentos de carga dos
cálculos de frete (verificar apenas os cálculos com mesmo tipo de frete do documento de frete).

TOLERÂNCIA
1. Bloquear quando o valor calculado for maior que o valor informado mais ou menos o valor absoluto
da tolerância.
2. Bloquear quando o valor calculado for maior que o valor informado mais ou menos o percentual de
tolerância.
3. Quando o parâmetro que indica que diferenças negativas não bloqueiam o documento, não bloquear
os documentos quando os valores calculados forem maiores que os valores informados.

ENTREGA:
1. Bloquear documentos de frete com documentos de carga que não tenham informação/prova de
entrega, quando o transportador estiver configurado para exigir tal registro.

Técnica: a rotina Aprovação de Documentos de Frete {GFEA066 – SIGAGFE; GW3 -} realiza a aprovação
automática somente ocorre quando os documentos não possuem divergências. Quando bloqueados, são
aprovados manualmente por intermédio dessa função. Neste caso, a situação do documento de frete passa para
Aprovado Usuário.

Na Auditoria de Taxas Detalhadas em tela própria será possível analisar e comparar as Taxas importadas x Taxas
calculadas de forma detalhada. Estará disponível através do caminho: Atualizações > Movimentação > Auditoria
de Frete > Aprovação de Documentos de Frete. Após selecionar o documento, clique em Ações Relacionadas >
Aprovar > Outras Ações > Cons. Taxas. Será aberta nova tela para consulta apenas das Taxas. A tela "Cons. Taxas"
apresentará o mesmo layout da tela de aprovação com as colunas: Campo, Informado, Calculado e Diferença, e,
portanto, as taxas contidas no CT-e serão comparadas com as taxas utilizadas no cálculo do frete. Para que a
comparação fique correta, é importante que as taxas recebidas da transportadora tenham o mesmo nome das
taxas calculadas. Caso contrário, a tela não irá vinculá-las

Auditoria Bloqueio por Entrega o processo de auditoria automática é verificado os parâmetros do transportador
com relação a exigência de Entrega. Quando o Emissor do Documento de Frete está parametrizado para exigir
Prova ou Informação de Entrega, significa que os documentos de frete somente poderão ser pagos quando há
a entrega dos documentos de carga relacionados. Se o documento de frete que está sendo auditado não tiver
as entregas registradas nos documentos de carga, então ficará com a situação Bloqueado por Entrega. Este
documento não ficará disponível para aprovação do usuário nesta função, pois este processo ocorrerá
automaticamente quando todas as entregas forem registradas, seja de forma manual ou via EDI. Ao registrar a
entrega o documento é novamente auditado, podendo ficar com sua situação de Aprovado Sistema ou ainda
bloqueado, caso cair em outra regra da auditoria. Nesse caso, ficará disponível para aprovação do usuário nesta
função.

Tarefas: capacitar para utilizar os processos de auditoria de frete e integração ao ERP Protheus.

10.2.1 – DASHBOARD SIGAFE

Demanda: requisitos e controles que para a boa gestão de transportes são fundamentais (sic).

Curitiba – PR | comercial@samcorp.com.br | samcorp.com.br

ANTES DE IMPRIMIR pense em sua responsabilidade e compromisso com o MEIO AMBIENTE
 ___________________________________________________________________________________________________

DOS010 - Documento Técnico ERP-0586 – Revitalização do Frete Embarcador

8

KPI Descrição

Auditoria  Nível de serviços, número de entregas realizadas no prazo ou em atraso, geral e por transportadora;
 Índice de ocorrências nas entregas, geral e por transportadora;
 Acompanhamento das entregas em tempo real;
 Auditoria de fretes e bloqueios deles em faturas caso ocorra cobranças incorretas;
 Acompanhamento das ocorrências no tempo atual;

Indicadores Índice de ocupação de veículos;

Tonelada transportadora inbound e outbound
Custo TONELADA X KM

Conceitos: o SIGAGFE dispõe de diversas consultas e painéis que constroem o DASHBOARD que permite verificar, por
intermédio das Curvas ABC, as divergências relacionadas ao Prestador. A CURVA ABC é uma forma de classificação de
informações na qual os elementos são ordenados em ordem decrescente de relevância. Para atribuir a relevância
considera-se um dado comum a todos os elementos. Na gestão de contratação de transportes, essa forma de apresentação
de dados permite visualizar quais entidades correspondem a maior participação em movimentação de cargas ou despesa
financeira e, tendo por referência essa análise, são tomadas ações de melhoria ou correção com prioridade para as
entidades com maior relevância nos processos.

KPI Descrição

% de corte A
Define o percentual acumulado para classificação dos transportadores como "A".

% de corte B Define o percentual acumulado para classificação dos transportadores como "B", sendo que os demais
transportadores automaticamente recebem a classificação "C".

Qtd de Séries Define a quantidade máxima de barras a serem apresentadas no gráfico de Curva ABC.

Por Valor Doc Frete Apresenta a Curva ABC por Transportador, considerando o valor das divergências dos documentos de frete
Divergente relacionados ao mesmo.

Por Qtde Doc Frete Apresenta a Curva ABC por Transportador, considerando a quantidade das divergências nos documentos de frete
Divergente relacionados ao mesmo.

Por Valor Fatura Apresenta a Curva ABC por Transportador, considerando o valor das divergências das faturas de frete relacionadas ao
Divergente mesmo.

Por Qtde Fatura Apresenta a Curva ABC por Transportador, considerando a quantidade de divergências ocorridas nas faturas de frete
Divergente relacionadas ao mesmo.

Curitiba – PR | comercial@samcorp.com.br | samcorp.com.br

ANTES DE IMPRIMIR pense em sua responsabilidade e compromisso com o MEIO AMBIENTE
 ___________________________________________________________________________________________________

DOS010 - Documento Técnico ERP-0586 – Revitalização do Frete Embarcador

9

Técnica: Monitor de Entregas {GFEC041} permite monitorar as entregas dos documentos de carga, na qual são
apresentados os documentos de carga de saída filtrados pelos parâmetros informados, demonstrando as principais
informações de controle como tempo de atraso, possibilitando um acesso rápido ao detalhamento dos agentes envolvidos
no processo como Ação Relacionada (consulta dos dados do transportador, destinatário, entre outros).

Tarefa: capacitar nas configurações e parametrizações nos painéis monitores do SIGAGFE.

10.3.1 – INTEGRAÇÃO FRETEFY

Conceito: a empresa FRETEFY disponibiliza ferramentas para gerenciamento de cargas e torre logística, sob os mesmos
moldes, conceitos do SIGAGFE. Trata-se de uma plataforma que permite que empresas, sejam embarcadores ou
transportadores, publiquem cargas online para caminhoneiros autônomos que procuram os fretes compatíveis com seus
veículos e disponibilidades. Dessa forma, o caminhoneiro busca no aplicativo a carga que mais lhe convém e entra em
contato com a empresa anunciante para negociar diretamente o frete, sem intermediários. Devido a base expressiva de
empresas e motoristas conquistadas, e as facilidades oferecidas por suas ferramentas. Diante deste cenário, o módulo
Gestão de Frete Embarcador (SIGAGFE) pode integrar para que os Embarcadores ou empresas que atuem como tal possam
publicar sua oferta de carga automaticamente a partir do sistema. A oferta pode ser gerada a partir do romaneio de carga,
com o objetivo de encontrar um motorista autônomo ou até mesmo um transportador que possa operacionalizar a
demanda do Embarcador. A oferta ficará vinculada ao romaneio e todas as operações da Oferta serão realizadas dentro do
módulo: Inclusão, Alteração, Exclusão e Concretização.

Técnica: O módulo SIGAGFE utiliza as APIs fornecidas pela FRETEFY para solucionar e consumir os serviços da plataforma:

 Autenticação - Obter Token de acesso - POST- /oauth/token;

 Veículos - Lista tipos de veículos - GET - v1/veículos/tipos;

 Carrocerias - Lista carrocerias de veículos - GET - v1/veiculos/carrocerias;

 Espécies - Lista espécies de carga - GET - v1/especies;

 Tipos de preço - Lista os tipos de preço - GET - v1/tipos/precos;

 Criar frete - Cria oferta de frete por assinante - POST - v1/assinantes/fretes;

 Altera frete - Altera uma oferta de frete - PUT - /v1/assinantes/fretes/{id};

 Deleta frete - Deleta uma oferta de frete - DELETE - /v1/assinantes/fretes/{id};

 Fechar Frete - Concretiza uma oferta de frete - POST - /v1/assinantes/fretes/{id}/concretizar;

Tarefa: desenvolver e validar a API de integração SIGAGFE e API FRETEFY conforme a documentação técnica complementar
a este projeto.

10.4.1 – DEPLOY

Curitiba – PR | comercial@samcorp.com.br | samcorp.com.br

ANTES DE IMPRIMIR pense em sua responsabilidade e compromisso com o MEIO AMBIENTE
 ___________________________________________________________________________________________________

DOS010 - Documento Técnico ERP-0586 – Revitalização do Frete Embarcador

10

Depois da validação, será aplicado em produção.

10.4.2 – ACOMPANHAMENTO

Será feito acompanhamento para possíveis ajustes e dúvidas dos usuários.

Curitiba – PR | comercial@samcorp.com.br | samcorp.com.br

ANTES DE IMPRIMIR pense em sua responsabilidade e compromisso com o MEIO AMBIENTE