Integração de Bombas Via API Chamado 477118
v2.12.0-r
Orienta a instalação e configuração do serviço de integração de bombas via API para automatizar operações de abastecimento e controle financeiro no sistema MDF-e.
user_manual
public
integracao-de-bombas-via-api-chamado-477118
|
Emissor MDF-e
108
12/06/2026 08:34
· Paulo
## Visão Geral Permite integrar bombas de combustível ao sistema Teorema via Interface de Programação de Aplicações (API), automatizando o registro de abastecimentos e lançamentos financeiros. A integração elimina a necessidade de entrada manual dos dados de cada abastecimento e reduz erros nos registros financeiros. Este documento descreve a instalação do serviço Windows, a configuração dos parâmetros e o mapeamento de bombas (de/para) para as integrações disponíveis: EPTA SGA e CTA Smart. ## Integrações Disponíveis As integrações suportadas são: - **EPTA SGA** - **CTA Smart** ## Instalar o Serviço de Integração No Prompt de Comando aberto como Administrador, navegue até a pasta onde estão salvos os executáveis da Teorema e execute: ``` srvbombasapi -install ```  Após a execução, uma caixa de diálogo exibe a mensagem "Service installed successfully" (Serviço instalado com sucesso). Em seguida, execute o comando abaixo para abrir a interface gráfica de configuração do serviço: ``` srvbombasapi GUI ```  A interface gráfica do serviço Integração Bombas de Combustível será exibida, permitindo iniciar a configuração. ## Configurar o Serviço > ⚠️ **Atenção:** Todos os campos de configuração são obrigatórios. Preencha-os corretamente antes de iniciar o serviço.  Descrição de cada campo numerado na aba **Geral**: **(1) Usuário Recados** — Usuário do sistema que receberá as mensagens (recados) quando ocorrerem erros na integração. **(2) Tipo de API e dados de abastecimento/financeiro** - **Gerar Financeiro:** gera uma cobrança vinculada ao abastecimento. - **Finaliza Abastecimento:** finaliza o lançamento de abastecimento e gera movimentação de estoque. - **API:** define a qual serviço a integração se conectará (EPTA SGA ou CTA Smart). **(3) Token Empresa** — Chave de acesso fornecida pela EPTA ou pela Smart. **(4) Posto** — Filtra os abastecimentos de uma unidade específica associada à chave. **(5 e 6)** — Disponíveis somente para a EPTA: além da chave, são solicitados usuário e senha de acesso à integração. ### Geração de Abastecimentos e Financeiro **(7 a 12)** — Dados padrão que receberão os movimentos para a geração dos abastecimentos quando os dados vindos da integração não forem encontrados. **(8 a 13)** — Dados padrão para geração de financeiros, baseados nos itens de 7 a 12; complementam a geração do abastecimento. **(14) Tipo de Consulta de Veículo** — Define como os veículos são identificados na integração: - **Placa:** a consulta usa a placa do veículo. O valor da placa deve estar cadastrado no sistema exatamente como informado na integração. - **Frota:** a busca usa o número da frota, conforme destacado no cadastro do veículo. **(15) Condição de Pagamento Padrão** — Condição de pagamento aplicada automaticamente às transações geradas pela integração (exemplo: código `0022` = "30 DIAS"). **(16) Horário de Geração** — Horário em que as leituras e integrações ocorrerão automaticamente (exemplo: `09:35`). ## Configurar Bombas Caso nenhuma bomba seja configurada, a integração utilizará os dados padrão definidos na aba **Geral**. Para um controle mais preciso, configure cada bomba individualmente. > **Nota:** Não é possível cadastrar bombas nesta tela — apenas apontar o mapeamento de/para entre os sistemas.  Descrição dos controles da aba **Bombas**: **(1)** — Pesquisa as bombas por uma data para integrar os movimentos realizados naquele período. **(2)** — Edita uma bomba associada, exibindo o mapeamento de/para. **(3)** — Exclui uma bomba associada. ## Editar o Mapeamento De/Para das Bombas  Descrição de cada campo do formulário de edição: **(1)** — Número do posto recebido pela integração. **(2)** — Código da bomba e do bico que serão integrados. **(3)** — Define para qual empresa o movimento do posto será realizado. **(4)** — Define para qual bomba do sistema o mapeamento será feito; as informações de produto devem estar cadastradas na bomba da Teorema. **(5 a 7)** — Informações padrão quando os dados de integração não encontrarem registros no sistema; os campos serão preenchidos pelo padrão definido na bomba e um recado será disparado para o usuário padrão definido na aba **Geral**. **(8) Tipo de Bomba** — Define o tipo de bomba integrada: - **Interna:** o abastecimento ocorre dentro da própria empresa. - **Externa:** o abastecimento foi realizado em um posto ou empresa credenciada. - **Ignorar:** esta bomba não gerará nenhum tipo de movimento no sistema. ## Iniciar o Serviço no Windows Após salvar todas as configurações, inicie o serviço pelo Gerenciador de Tarefas: 1. Abra o **Gerenciador de Tarefas** e acesse a aba **Serviços**. 2. Localize o serviço **ServicoBombasAPI**. 3. Clique com o botão direito sobre ele e selecione **Iniciar**.  **REGRAS DA INTEGRAÇAO** Na integração de abastecimentos por API da CTA Smart, quando importado os abastecimentos na primeira vez, caso sofra alguma alteração direto na ferramenta de controle da CTA Smart em uma abastecida já importada para o sistema, existe alguma rotina de atualização desse movimento ou após importado a primeira vez não sofre alterações vindas do outro sistema?** ** ** Resposta: Não. Observação: Depois que um abastecimento da CTA Smart entra no sistema, o integrador não atualiza mais esse registro. Se ele for alterado depois na CTA Smart, a mudança não chega ao Teorema. ** ** Como a importação funciona hoje: O serviço SrvBombasAPI. ** ** Qual data ele busca: roda uma vez por dia, no horário configurado, e pede à API os abastecimentos do dia anterior. Pela tela também dá para rodar manualmente informando uma data. Como sabe que um abastecimento já foi importado: procura em TRA_ABASTECIMENTO por empresa - data de emissão + abastec*numero*nf. Esse número é o ID que a CTA Smart dá ao abastecimento. O que faz se já existe: só pula para o próximo (Inc(I); Continue;). O que faz** **se não existe: grava um registro novo e, se estiver configurado, gera o financeiro. **Não** existe UPDATE em TRA_ABASTECIMENTO (tabela dos abastecimentos) com dados vindos da API. O único UPDATE só marca a situação 'F' (finalizado) logo depois de gravar. A API também não informa se o abastecimento foi alterado: a consulta é feita apenas por data (data*inicio/data*fim), sem nenhuma data de alteração.** ** ** O que acontece conforme a alteração feita na CTA Smart: Alteração na CTA Smart --- Efeito no Teorema Litros, valor, odômetro/horímetro, veículo, motorista - Ignorada. O registro já existe e é pulado, mesmo rodando de novo a mesma data. Exclusão do abastecimento ** - Ignorada. O registro continua no Teorema.** Data do abastecimento - Na rotina diária, ignorada. Mas se alguém rodar manualmente a nova data, a busca procura pela data nova, não acha o registro e importa de novo, gerando duplicidade (inclusive no financeiro). Origem/bomba, quando ela está configurada para uma empresa diferente da original e da empresa padrão - Mesmo risco de duplicidade ao rodar a data de novo. abastecimento lançado na CTA com data já importada (lançamento retroativo) - Entra apenas se aquela data for rodada de novo manualmente. Os que já existem são pulados e o novo é importado. Recomendaçãopara o Suporte: Responder ao cliente: a integração só importa, ela não sincroniza. Correções feitas na CTA Smart depois da importação precisam ser feitas também no Teorema, direto no movimento de abastecimento. Orientar o cliente a não rodar de novo pela tela uma data cujos abastecimentos tiveram a data alterada na CTA. ## Informações do documento > Autor: Pellison Leutner Cesar > Setor: Qualidade > Módulo: Gestão de Transportes > Chamado: 0000477118 > Versão do Sistema: > Versão do documento: 01 > Revisão: Paulo Bley > Aprovado em: 2025 --- > 📎 **Arquivos originais:** [manual Integração de Bombas via API.docx](https://drive.google.com/uc?export=download&id=1tZ57qomKvm1NZs9xSMcH2OMnHlFkbuaP) · [manual Integração de Bombas via API.pdf](https://drive.google.com/uc?export=download&id=1rZ9AopVSLvNXsrTImVhByNvdfPulPpsJ)
Tags IA:
477118
api
bombas
chamado
fev
integracao
integracao-bombas-via-api
via
Prioridade: 7