Integração de Bombas Via API Chamado 477118

---
title: Integração de Bombas Via API Chamado 477118
slug: integracao-bombas-via-api
sistema:
  - Emissor MDF-e [25]
chamado: "0000477118"
categoria: user_manual
tipo: how-to
autor: Pellison Leutner Cesar
setor: Qualidade
modulo: Gestão de Transportes
versao_doc: 01
revisao: Paulo Bley
aprovado_em: 2025
versao_pipeline: 2.5.2
publico: ""
keywords:
  - integração de bombas
  - API
  - abastecimento
  - EPTA SGA
  - CTA Smart
  - srvbombasapi
  - combustível
  - Gestão de Transportes
ultima_revisao: "2026-06-11"
---

## 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
```

![Prompt de Comando (Administrador) exibindo o comando srvbombasapi -install executado no caminho C:\Teorema\Projects\Source\Exec; caixa de diálogo "Information" com a mensagem "Service installed successfully" e botão OK](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/integracao-bombas-via-api/integracao-bombas-via-api-06.png)

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
```

![Prompt de Comando com o comando srvbombasapi GUI executado; ao fundo, tela "Integração - Bombas de Combustível" da Teorema Sistemas com botão "Configurações" e campo "Gerar para a Data" com botão "Gerar"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/integracao-bombas-via-api/integracao-bombas-via-api-07.png)

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.

![Tela de configuração "Integração - Bombas de Combustível" — aba Geral, com campos numerados de 1 a 16: Usuário Recados, checkboxes Gerar Financeiro e Finaliza Abastecimento, seletor de API (EPTA SGA / CTA Smart), Token Empresa, Posto, campos de usuário e senha EPTA, dados padrão de abastecimento (itens 7 a 12), dados padrão de financeiro (itens 8 a 13), Tipo de Consulta de Veículo, Condição de Pagamento Padrão e horário de geração](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/integracao-bombas-via-api/integracao-bombas-via-api-08.png)

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.

![Tela "Integração - Bombas de Combustível" — aba Bombas, com lista exibindo colunas Empresa, Código, Posto, Origem, Bico, Bomba e Descrição; três botões de ação identificados como 1 (pesquisar por data), 2 (editar bomba) e 3 (excluir bomba); exemplos de registros com empresa 123456918/521583082/532694191, postos Comboio/Sede GT/Sede Cecchin, origem 534940113/534855939/532694909, bico 2, bomba 2, descrição S10](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/integracao-bombas-via-api/integracao-bombas-via-api-09.png)

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

![Tela "Integração - Bombas de Combustível" — aba Bombas com formulário de edição de bomba; campos numerados: (1) número do posto recebido pela integração (ex.: 534940113), (2) código da bomba e do bico integrados, (3) empresa destino (campo "Indefinida"), (4) bomba do sistema destino, (5 a 7) dados padrão da bomba, (8) tipo de bomba com opções Interna, Externa e Ignorar; lista inferior exibindo registros de mapeamento](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/integracao-bombas-via-api/integracao-bombas-via-api-10.png)

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**.

![Gerenciador de Tarefas — aba Serviços com pesquisa "bomba"; lista exibe ServicoBombasAPI (status: Parado) selecionado; menu de contexto aberto com opções Iniciar, Parar, Reiniciar, Abrir Serviços, Pesquisar online e Ir para detalhes — opção "Iniciar" destacada](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/integracao-bombas-via-api/integracao-bombas-via-api-11.png)

## 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)