Configuração das Integrações ERP

O PopinaFlow pode enviar lançamentos contábeis para os principais sistemas ERP brasileiros. Esta seção explica o que preencher em cada integração e como testar a conexão.

Quem pode configurar: Administrador ou Superadmin. Contadores podem usar as integrações, mas não alterar as credenciais.

---

Acessar as configurações

1. Acesse Admin → Contabilidade → Integrações.
2. Você verá uma lista de provedores disponíveis: Omie, Conta Azul, SAP, SPED.
3. Cada provedor exibe:
   • Chave configurada: sim/não
   • Modo teste: ativado/desativado
   • Última sincronização: data e hora do último envio com sucesso
   • Último erro: mensagem do último erro, se houver

---

Omie

O Omie é um ERP online brasileiro muito utilizado por contadores.

O que você precisa

• App Key e App Secret da integração Omie. Para obter:
  1. Acesse o painel Omie e vá em Aplicativos.
  2. Crie uma nova aplicação ou use uma existente.
  3. Copie o app_key e o app_secret.

Como configurar

1. Clique em Editar ao lado de Omie.
2. Preencha:

Campo	Valor
Chave API	Cole o app_key do Omie
Segredo API	Cole o app_secret do Omie
Modo Teste	Ative se quiser testar sem gravar no Omie real
URL personalizada	Deixe em branco (usa a URL padrão do Omie)

3. Clique em Salvar.
4. Clique em Testar Conexão. O sistema faz uma chamada leve à API do Omie e retorna { ok: true } se as credenciais estiverem corretas.

---

Conta Azul

Conta Azul usa autenticação OAuth2.

O que você precisa

• Client ID e Client Secret da integração Conta Azul. Para obter:
  1. Acesse o portal de desenvolvedor do Conta Azul.
  2. Crie uma aplicação e copie as credenciais OAuth2.

Como configurar

1. Clique em Editar ao lado de Conta Azul.
2. Preencha:

Campo	Valor
Chave API	Client ID OAuth2
Segredo API	Client Secret OAuth2
Modo Teste	Ative para usar o ambiente sandbox do Conta Azul
URL personalizada	Deixe em branco

3. Clique em Salvar e depois em Testar Conexão.

---

SAP Business One

O SAP B1 usa a Service Layer — uma API REST no servidor local do cliente.

O que você precisa

• URL do Service Layer: geralmente https://servidor-sap:50000/b1s/v1 (dentro da rede interna)
• Usuário SAP e senha SAP
• O servidor SAP deve estar acessível pela internet ou via VPN

Como configurar

1. Clique em Editar ao lado de SAP.
2. Preencha:

Campo	Valor
Chave API	Usuário SAP (ex: manager)
Segredo API	Senha SAP
URL personalizada	Obrigatório — URL do Service Layer (ex: https://192.168.1.100:50000/b1s/v1)
Modo Teste	Ative para usar uma empresa de teste no SAP

3. Clique em Salvar e depois em Testar Conexão.

Dica de rede: Se o servidor SAP é local (sem IP externo), você precisará de um túnel VPN ou expô-lo via proxy reverso com HTTPS. Fale com o seu TI.

---

SPED Contábil

O SPED não usa credenciais de API — ele gera um arquivo TXT no formato da Receita Federal para transmissão manual via programa Validador da RFB.

Como configurar

1. Clique em Editar ao lado de SPED.
2. Preencha:

Campo	Valor
URL de destino	Caminho onde o arquivo será salvo. Use file:///var/sped/ para salvar no servidor, ou s3://meu-bucket/sped/ para AWS S3
Chave / Segredo	Deixe em branco (não se aplica ao SPED)

3. Clique em Salvar.

Como usar

1. Acesse Admin → Contabilidade → Exportar.
2. Selecione o período e o formato SPED.
3. Clique em Baixar Arquivo.
4. Abra o arquivo no PVA SPED Contábil (programa da RFB) para validar e transmitir.

---

Testar a conexão

Antes de usar em produção, sempre clique em Testar Conexão para confirmar que as credenciais estão corretas. O sistema retorna:

Resultado	Significado
ok: true, providerVersion: ...	Conexão bem-sucedida
ok: false, error: "..."	Credencial incorreta ou URL inacessível

Se o teste falhar com "Connection refused", verifique a URL (para SAP) ou se o servidor do ERP está online.

---

Segurança das credenciais

As chaves e segredos API são criptografados no banco de dados antes de serem salvos (AES-256-GCM). Eles nunca aparecem em texto claro na interface — o painel exibe apenas **** para confirmar que foram configurados.

---

Relacionado

• Exportar Relatórios Contábeis (Admin) — Como usar as integrações para exportar
• LGPD — Funcionários — Exportar e anonimizar dados de RH