Integração Plataforma de Fretes com
A integração entre a Plataforma de Fretes e o é composta por três principais tipos de operações:
- Consultas (Plataforma → GKO): permitem que a Plataforma de Fretes consulte dados diretamente no GKO Frete.
- Carga de Dados (Plataforma → GKO): permitem que a Plataforma envie informações ao GKO Frete.
- Recebimento de Dados (GKO → Plataforma): permitem que o GKO Frete envie informações para a Plataforma de Fretes.
Cada um desses tipos possui funcionalidades específicas, detalhadas a seguir:
Integrações de Consulta (Plataforma → GKO)
As integrações de consulta permitem que a Plataforma de Fretes acesse informações do GKO Frete. Para o funcionamento adequado, é necessário configurar as opções na seção Configurações > Integrações da Plataforma. Atualmente, existem duas integrações deste tipo:
- Consulta da Tabela de Frete do GKO Frete (Simulação Rápida / Oferta Contrato)
- Permite consultar valores de tabelas de frete para cotações pré-definidas.
- Consulta de CT-es cadastrados no GKO Frete
- Recupera informações sobre CT-es armazenados no GKO Frete para exibição na Plataforma de Fretes.
Integrações de Carga de Dados (Plataforma → GKO)
Essas integrações permitem o envio de informações da Plataforma para o GKO Frete. Para funcionamento adequado, a seção Configurações > Integrações da Plataforma deve ser configurada. Atualmente, existem três integrações deste tipo:
- Envio de Oferta Spot
- Transfere informações de ofertas pontuais com os preços acordados, criando fretes combinados no GKO Frete.
- Envio de Oferta Contrato
- Transfere dados de cotações aceitas com a transportadora selecionada.
- Importação de CT-es para Inclusão/Alteração
- Permite modificar ou adicionar dados de CT-es diretamente no GKO Frete.
Integrações de Recebimento de Dados (GKO → Plataforma)
Nessas integrações, o envia informações para a Plataforma de Fretes. Para garantir o envio adequado, é necessário configurar corretamente o . Atualmente, existem duas integrações deste tipo:
- Integração de Pedidos
- O GKO Frete envia pedidos cadastrados para a Plataforma, permitindo a criação de ofertas de frete.
- Integração de Fatura
- Envia dados e status das faturas para a Plataforma, possibilitando o acompanhamento das transportadoras.
Detalhamento das Integrações
Pré-requisitos
- Empresas, CD, Embarcadores devem estar cadastrados na Plataforma: acesse o manual de cadastro de empresas na Plataforma.
- Transportadoras devem ser parceiras na Plataforma: acesso o manual para convidar transportadoras.
A Oferta Contrato permite formalizar cotações com preços pré-definidos, garantindo compliance e eficiência. Diferente do GKO Frete, onde o cliente precisava acionar transportadoras manualmente, a Plataforma de Fretes permite:
- Visualizar o melhor transportador.
- Disparar cotações diretamente.
- Gerar a Ordem de Coleta após o aceite da transportadora.
Configuração
- As tabelas de frete devem estar cadastradas no GKO Frete.
- A configuração deve ser realizada na Plataforma de Fretes: acesse o manual de configuração da Oferta Contrato.
O envio de ofertas tem como objetivo agilizar e simplificar o dia a dia do usuário, permitindo o envio automático de ofertas finalizadas para o GKO Frete.
Funcionamento
- Ofertas com status Cotação escolhida Spot ou Contrato são enviadas automaticamente ao GKO Frete, onde serão registradas como Frete Combinado.
- O envio pode ser automático ou manual.
Observação
Caso o cliente deseje associar uma nota ao frete combinado que foi enviado pela Plataforma, este processo deverá ser realizado manualmente no GKO Frete.
Dados enviados pela Plataforma para o GKO Frete:
- Documento de Negociação: número da oferta de frete.
- Data do Acordo: data de aceite do frete.
- Tipo de Transação: entrada ou saída.
- Tipo de Acordo: Spot ou Contrato.
- Valor do Acordo: valor fechado na oferta.
- CNPJ da Transportadora: CNPJ da transportadora cadastrado no .
- Imposto: sempre enviado como “1”.
Permite inclusão ou alteração de dados no – Integração de Carga
Pré-requisitos
- Configuração da Integração para importação e consulta de CT-es na Plataforma de Fretes,
- Acesso ao :
- A transportadora deve possuir um usuário de acesso ao do tipo Transportador. Para isso, serão necessárias as seguintes informações:
- Banco de dados do GKO Frete
- Usuário no GKO do tipo Transportadora
- Senha do usuário do tipo Transportadora
Esses dados devem ser solicitado para o time de suporte.
- A transportadora deve possuir um usuário de acesso ao do tipo Transportador. Para isso, serão necessárias as seguintes informações:
- Perfil de Usuário na Plataforma:
- O usuário deve ser do tipo Transportadora na Plataforma de Fretes para acessar o portal.
- As transportadoras precisam estar cadastradas como parceiras na Plataforma
- Acesse o manual para saber como convidar transportadoras para serem parceiras.
Esta integração foi desenvolvida para substituir o antigo Portal do Transportador no , trazendo mais eficiência e acessibilidade para transportadoras.
Com essa mudança, pequenas e médias transportadoras — que muitas vezes não possuem equipes de infraestrutura dedicadas — poderão realizar as seguintes operações de forma simplificada:
- Importação de CT-es
- Importação de Faturas
- Importação de EDIs de Ocorrências
Funcionalidades
Atualmente, a plataforma permite a importação de CT-es normais diretamente pela Plataforma de Fretes.
Como criar um CT-e:
- Manual: inserindo os dados do CT-e diretamente na Plataforma.
- Automático: importando o arquivo XML do CT-e para a Plataforma, que será enviado automaticamente ao .
Limitações
O CT-e Complementar não é aceito nesta integração.
Transportadoras podem seguir os passos abaixo para realizar a importação de um CT-e:
- Acesse o Portal do Transportador;
- Escolha uma das opções de importação:
- Inserção manual de dados do CT-e.
- Upload do arquivo XML do CT-e.
- Confirme os dados e envie para o .
Essa integração foi desenvolvida para proporcionar maior agilidade na criação de ofertas de frete, aproveitando os dados já existentes nos pedidos cadastrados.
Benefícios
- Otimização do Processo: permite que os clientes utilizem os dados dos pedidos diretamente para criar ofertas de frete, eliminando retrabalho.
- Ofertas com Múltiplos Pedidos: facilita a criação de ofertas contendo mais de um pedido vinculado, atendendo a cenários de operações complexas.
- Velocidade na Criação: com os dados dos pedidos disponíveis na Plataforma, a criação das ofertas torna-se mais rápida e eficiente.
Configuração
- No :
- A integração deve ser configurada quase que integralmente no . Para isso, acesso o manual de integração do com a Plataforma de Fretes
- Na Plataforma de Fretes:
- Empresas, CD, Embarcadores devem estar cadastrados na Plataforma: acesse o manual cadastro de empresas na Plataforma.
- Criação de um usuário API.
- Esse usuário será responsável pela comunicação entre a Plataforma de Fretes e o portanto fique atento a gestão do usuário. Para configurar basta seguir as instruções do manual Criação de usuário API.
Esta funcionalidade permite que as transportadoras visualizem as informações de suas faturas cadastradas no diretamente na Plataforma de Fretes.
Benefício para o Embarcador:
- Ao disponibilizar as informações de faturas para as transportadoras, elas poderão compreender melhor a situação de suas faturas, entrando em contato com o cliente apenas quando necessário.
Funcionamento
Para que o processo funcione corretamente, os status das faturas no devem ser padronizados de acordo com os status definidos na Plataforma de Fretes. Isso garante que o usuário final compreenda claramente a situação da fatura.
Padronização de Status
A seguir, estão os status padronizados entre o e a Plataforma de Fretes:
| Código GKO | Descrição GKO | Descrição Plataforma |
|---|---|---|
| 1 | EM AUDITORIA | EM AUDITORIA |
| 2 | FATURA AGUARDANDO AUTORIZAÇÃO | EM AUDITORIA |
| 3 | OK - AUTORIZADO PAGAMENTO | AUTORIZADO PARA PAGAMENTO |
| 10 | GERANDO FATURA PRÓPRIA / RPA | EM AUDITORIA |
| 20 | FATURA PAGA | FATURA PAGA |
| 30 | FATURA COM CRÍTICAS | PENDÊNCIA COM TRANSPORTADOR |
Observações Importantes:
-
Associação de códigos:
- O que importa para a integração é o código (COD) enviado para a Plataforma, não a descrição existente no .
- Se o cliente tiver códigos de status diferentes, será necessário associá-los aos códigos padronizados.
- Exemplo de padronização:
- Um cliente possui os seguintes status:
- COD 3 = Fatura Liberada.
- COD 4 = Fatura Autorizada.
- Ambos se referem ao mesmo processo. Para a integração funcionar corretamente, o COD 4 deve ser ajustado para o COD 3, que é o padrão correspondente a Autorizado para Pagamento na Plataforma.
- Um cliente possui os seguintes status:
- Consequências de não realizar a padronização:
-
A Plataforma continuará recebendo os dados, porém:
- Não será possível calcular os valores de forma automática.
- Status não padronizados serão classificados como Outros.
-
A Plataforma continuará recebendo os dados, porém:
Essa padronização é fundamental para garantir uma comunicação clara e eficaz entre a Plataforma de Fretes e o GKO Frete, beneficiando todos os usuários envolvidos.
Agora acesse o manual de integração do com a Plataforma de Fretes
English
Español
English
Español


