Central de Documentação Manuais de usuário do CRTI ERP
← Central de Documentação

Integração de Abastecimentos

Guia de preenchimento da tela Configuração de Integração de Abastecimento.

Visão geral

Esta tela cadastra, por filial, como o CRTI ERP deve buscar os dados de abastecimento de um posto de combustível. Cada filial pode ter apenas uma configuração. Escolha primeiro o Tipo de utilização: Web Service (integração automática por API) ou Excel (importação manual de arquivo). Os campos exibidos no formulário mudam de acordo com essa escolha e com a integração selecionada.

Campos comuns

Presentes independente do tipo de utilização ou da integração escolhida.

Campo Obrigatório Como preencher
Filial Sim Filial dona da configuração. Cada filial só pode ter uma configuração cadastrada.
Fornecedor Sim Fornecedor de combustível vinculado aos lançamentos de estoque gerados pela integração.
Conta Contábil Sim Conta contábil utilizada nos lançamentos gerados.
Centro Custo Não Centro de custo padrão aplicado aos lançamentos, quando existir.
Verifica Filial Atual do Equipamento Não Se marcado, valida a filial atual do equipamento no momento da importação do lote.

CTA Plus

Tipo de utilização: Web Service.

Campo Obrigatório Como preencher
ID Posto Sim Identificador do posto na plataforma CTA Plus.
Token Sim Token de acesso fornecido pela CTA Plus para autenticação das requisições.
URL de Integração Sim Endereço da API da CTA Plus fornecido pelo suporte da integração.

Evoluma

Tipo de utilização: Web Service.

Campo Obrigatório Como preencher
ID Posto Sim Identificador do posto na plataforma Evoluma.
Token Sim Token de acesso fornecido pela Evoluma.
URL de Integração Sim Endereço da API da Evoluma.

GTFrota

Tipo de utilização: Web Service.

Campo Obrigatório Como preencher
ID Posto Sim Identificador do posto na plataforma GTFrota.
Token Sim Token de acesso fornecido pela GTFrota.
Login Sim Usuário de acesso à API.
Senha Sim Senha de acesso à API. Uma vez salva, o campo exibe apenas o indicador de senha salva; só é reenviada se for alterada.
URL de Integração Sim Endereço da API da GTFrota.

Polisoftware

Tipo de utilização: Web Service.

Campo Obrigatório Como preencher
Login Sim Usuário de acesso à API da Polisoftware.
Senha Sim Senha de acesso à API. Uma vez salva, o campo exibe apenas o indicador de senha salva.
URL de Integração Sim Endereço da API da Polisoftware. Um valor padrão é sugerido ao selecionar esta integração; ajuste conforme o ambiente do cliente.
Separar por Comboio Não Marque quando um único posto (comboio) abastece equipamentos de mais de uma filial. Ao marcar, a aba Comboio x Filial é exibida para configurar o rateio.

Atenção sobre comboio: se a filial desta configuração já recebe abastecimentos como destino do comboio de outra configuração Polisoftware, o sistema bloqueia a criação de um lote mestre próprio para ela, para evitar duplicidade. Nesse caso os abastecimentos dessa filial só chegam pelo comboio da configuração de origem.

Ionics (Web Service)

Tipo de utilização: Web Service.

Campo Obrigatório Como preencher
Login Sim Usuário de acesso à API da Ionics.
Senha Sim Senha de acesso à API. Uma vez salva, o campo exibe apenas o indicador de senha salva.
URL de Integração Sim Endereço da API da Ionics.
ID Posto Não Identificador do posto/planta na Ionics. Pode ficar em branco quando não aplicável ao contrato.

Importação via Excel

Ao selecionar o tipo de utilização Excel, os campos de Login, Senha, URL, ID Posto e Token são ocultados. Em seu lugar, escolha a integração do arquivo Excel:

Ticket Log

Importação manual do arquivo padrão exportado pela plataforma Ticket Log. Não possui campos adicionais.

Ionics (Excel)

Campo Obrigatório Como preencher
Processa Filiais Aplicação Condicional Exibido apenas para Ionics via Excel. Marque quando o arquivo deve processar também a aplicação por filial.

A importação por arquivo Excel deve ser executada manualmente pelo usuário; não há execução automática recorrente para esse fluxo.

Abas do cadastro

Aba Conteúdo
Informações Gerais Filial, Fornecedor, Conta Contábil, tipo de utilização e os campos específicos da integração selecionada.
Configurações Opções complementares: considerar filial atual do equipamento, considerar equipamento locado, centro de custo.
Aplicação Automática Contém a sub-aba Serviços, usada para vincular automaticamente serviços aos itens importados. Só aparece quando exigido pela configuração do usuário.
Comboio x Filial Visível somente para Polisoftware com “Separar por Comboio” marcado. Define como os tanques/bases do comboio se distribuem entre as filiais destino.

Grid de Serviços (aba Aplicação Automática)

Lista os serviços que serão vinculados automaticamente aos itens de abastecimento importados.

Coluna Descrição
Filial Serviço Código da filial à qual o serviço pertence.
Nome Filial Nome da filial correspondente.
Código do Serviço Código completo do serviço a ser aplicado.
Descrição do Serviço Descrição do serviço, para conferência visual.

Use o botão Adicionar Item na toolbar da grid para incluir uma nova linha.

Grid Comboio x Filial (aba Comboio x Filial)

Disponível apenas para Polisoftware com “Separar por Comboio” marcado. Define o relacionamento entre os tanques do posto (comboio) e as filiais que devem receber os abastecimentos.

Coluna Descrição
Base PDA Identificador da base/PDA de origem do comboio na Polisoftware.
Código Tanque Código do tanque de combustível do comboio.
Descrição Comboio Descrição do comboio, para identificação.
Filial Destino Filial que receberá os abastecimentos apontados por este tanque.
Nome Filial Nome da filial destino, para conferência visual.

Use o botão Adicionar Item na toolbar da grid para incluir uma nova linha.

Atenção: quando a filial da própria configuração aparece como destino de um dos seus próprios comboios (comum na filial “mestre”, que recebe vários tanques apontando para ela mesma), isso é permitido normalmente e não gera bloqueio.