Integração com ERP
Integração com ERP: o seu sistema lê do Afflux o que hoje alguém redigita
Fornecedores, contratos, notas fiscais, contas a pagar e pagamentos chegam ao ERP por uma API REST. Sem conector para cada sistema: qualquer ERP que chame uma API consegue ler, e cada conta a pagar já diz se pode ser paga agora.
- Os planos incluem a API
- TodosOs planos incluem a API
- O ERP lê, não altera nada
- LeituraO ERP lê, não altera nada
- Sem conector específico
- Qualquer ERPSem conector específico
- Por integração, para trocar sem parar
- 2 chavesPor integração, para trocar sem parar
O prestador já está no Afflux. Por que redigitar no ERP?
Quando o Afflux cuida dos prestadores e o ERP cuida do financeiro, alguém faz a ponte à mão. Cadastra o fornecedor de novo, copia o valor do contrato, lança a nota, cria a conta a pagar e, na hora de montar o arquivo de pagamento, procura agência, conta e PIX em outra tela. Cada passo é uma chance de errar um dígito.
A API de integração tira essa pessoa do meio. O ERP da sua empresa lê do Afflux o fornecedor, o contrato, a nota com o arquivo, a conta a pagar e o pagamento, e busca os dados bancários quando precisa montar a remessa.
Não existe um conector por ERP. A API segue o padrão REST, com especificação OpenAPI, e serve para Protheus, SAP Business One, Omie, Sankhya ou um sistema próprio: qualquer ERP que consiga chamar uma API. Quem faz a ligação é o time técnico da sua empresa ou o parceiro que mantém o seu ERP. A exportação em CSV continua existindo para quem prefere planilha.
Como funciona
Da chave à primeira sincronização
O administrador da sua empresa configura tudo dentro do Afflux. O resto é com quem cuida do ERP.
- 1
Crie a integração e escolha as permissões
Em Configurações › Integrações, dê um nome à integração e marque o que ela pode ler. Só aparecem as permissões que você mesmo tem.
- 2
Gere a chave
A chave aparece uma única vez, para ser copiada direto para o ERP. O Afflux guarda só um resumo criptográfico dela, nunca a chave.
- 3
O time técnico conecta o ERP
Com a chave e a documentação, quem mantém o ERP aponta as chamadas para https://app.afflux.com.br/api/v1. A especificação OpenAPI fica em https://app.afflux.com.br/api/v1/openapi.json.
- 4
O ERP sincroniza o que mudou
Depois da primeira carga, o ERP pergunta só o que foi atualizado desde a última consulta, página por página.
O que o ERP lê
Do cadastro do fornecedor ao pagamento feito
A API cobre o caminho inteiro do prestador PJ no Afflux. O ERP recebe o fornecedor pronto, o contrato com valor e vigência, o documento de faturamento com o arquivo, a conta a pagar e o pagamento registrado.
Dados bancários têm regra própria: só com uma permissão separada, consultados por fornecedor ou por conta, nunca em lote. Cada leitura fica registrada e o administrador vê quem consultou.
- Fornecedores: os seus prestadores PJ
- Dados bancários: agência, conta e PIX, com permissão separada
- Contratos
- Documentos de faturamento: NF, RPA e recibo, com o arquivo por um link que vale 5 minutos
- Contas a pagar, com a situação de pagamento
- Pagamentos
Recursos da API
Somente leitura
Fornecedores
/fornecedores · prestadores PJ
Dados bancários
/fornecedores/{id}/contas-bancarias · um por vez
Contratos
/contratos · valor, vigência e classificação do custo
Documentos de faturamento
/documentos-faturamento · NF, RPA e recibo
Contas a pagar
/contas-pagar · pode pagar agora?
Pagamentos
/pagamentos
Cada integração só enxerga o que você liberar.
Pode pagar agora?
O ERP sabe, antes de pagar, se a documentação libera o pagamento
Cada conta a pagar chega com a situação de pagamento calculada no momento da consulta, pelas mesmas regras de conformidade que você configurou no Afflux. Documento exigido que falta ou venceu pode ser um bloqueio, que impede o pagamento, ou só um alerta, que avisa e deixa pagar.
Com o filtro pagavel=true, a API devolve direto a fila do que pode ser pago agora. O ERP não paga o prestador com certidão vencida porque ninguém conferiu.
- Situação calculada na hora, não numa cópia de ontem
- Bloqueios e alertas separados, cada um com o documento que falta
- Filtro pagavel=true com a fila do que pode ser pago
- As regras continuam sendo as do Afflux, sem duplicar no ERP
Contas a pagar
Situação de pagamento na hora da consulta
Ana Ferreira · NF 1043
Consultoria fiscal · documentação em dia
Northwind Design · NF 287
Certidão vence em 6 dias
Bruno Matos · NF 512
Certidão negativa vencida
Exemplo ilustrativo. Com ?pagavel=true, só a primeira e a segunda voltam.
Sincronização
O ERP busca só o que mudou desde a última vez
Ninguém precisa baixar a base inteira a cada hora. O ERP informa a data da última sincronização em atualizadoDesde e recebe só o que foi alterado, em páginas, com um cursor para seguir de onde parou.
Para quem desenvolve, a API foi feita para não ter surpresa: códigos de erro estáveis no formato problem+json e um X-Request-Id em toda resposta, para achar a chamada exata quando algo dá errado.
- Sincronização incremental com atualizadoDesde e cursor
- Especificação OpenAPI 3.1 para gerar o cliente
- Erros com código estável no formato problem+json
- X-Request-Id em todas as respostas
Chaves e permissões
Você decide o que cada integração enxerga
Cada integração tem as próprias permissões, escolhidas pelo administrador, e só entre as que ele mesmo tem. A integração do ERP financeiro pode ler contas a pagar e dados bancários; a de um painel de indicadores, só contratos.
Trocar a chave não derruba nada: cada integração aceita até duas chaves válidas ao mesmo tempo. Você gera a nova, atualiza o ERP e revoga a antiga. A revogação vale na hora.
- Permissões por integração
- Até duas chaves válidas para trocar sem parar o ERP
- Revogação imediata
- E-mail para os administradores a cada chave gerada ou revogada
- Uso de cada integração nos últimos 30 dias, na tela
Integrações
Configurações › Integrações
ERP financeiro
Fornecedores, contratos, notas, contas a pagar e pagamentos
Dados bancários
Permissão concedida · cada leitura registrada
Chaves
2 válidas durante a troca
Uso nos últimos 30 dias
Consultas feitas por esta integração
Exemplo ilustrativo.
Segurança e LGPD
Dado de prestador sai do Afflux só para quem você autorizou
A API lê dados pessoais e bancários dos seus prestadores. Por isso cada acesso é limitado, identificado e registrado.
Chave mostrada uma vez
O Afflux guarda só um resumo criptográfico da chave. Não há como recuperá-la; se perder, gere outra.
Dados bancários sob permissão própria
Agência, conta e PIX só com uma permissão separada, um fornecedor ou uma conta por vez, nunca em lote. Cada leitura fica visível para o administrador.
Só os dados da sua empresa
A empresa é definida pela chave, e não por um parâmetro da chamada. Dado de outra empresa nunca aparece.
Arquivo com link de 5 minutos
O PDF da nota, do RPA ou do recibo sai por um link assinado que expira em 5 minutos. Link esquecido num log não abre nada depois.
Administrador avisado
Toda chave gerada ou revogada dispara um e-mail para os administradores. Ninguém cria uma integração escondido.
Só o necessário
Cada integração lê apenas o que foi liberado para ela, o que ajuda a sua empresa a seguir o princípio da necessidade da LGPD.
Perguntas frequentes
Funciona com o meu ERP?
Funciona com qualquer ERP ou sistema que consiga chamar uma API REST, como Protheus, SAP Business One, Omie, Sankhya ou um sistema próprio. Não existe conector específico por ERP: a mesma API serve para todos.
Quem faz a integração?
O time técnico da sua empresa ou o parceiro que mantém o seu ERP. O administrador cria a integração e a chave no Afflux, e quem desenvolve usa a documentação e a especificação OpenAPI para ligar o ERP.
O ERP consegue lançar pagamentos no Afflux?
Ainda não. A API é somente de leitura: o ERP lê do Afflux, mas não grava nada nele. Os pagamentos continuam sendo registrados no Afflux. Devolver os pagamentos do ERP para o Afflux está no nosso roadmap.
Quanto custa?
Nada à parte: a integração com o ERP está incluída em todos os planos. Os limites técnicos de uso estão na documentação da API, para quem vai desenvolver. Se a sua operação precisar de mais integrações, os limites maiores são sob consulta.
Como fica a segurança dos dados bancários?
Dados bancários só saem com uma permissão separada, que o administrador precisa conceder de propósito. A consulta é feita por fornecedor ou por conta, nunca em lote, e cada leitura fica registrada e visível para o administrador.
E se a chave vazar?
Revogue a chave em Configurações › Integrações: ela para de funcionar na hora. Como cada integração aceita duas chaves válidas, você gera a nova, atualiza o ERP e revoga a antiga sem deixar o ERP parado. Os administradores recebem um e-mail a cada chave gerada ou revogada.
A exportação em CSV continua existindo?
Sim. Quem prefere conciliar por planilha continua exportando contas a pagar e pagamentos em CSV. A API é mais uma opção, não uma troca.
Continue por aqui
Funcionalidades ligadas
Para a sua área
Antes de decidir
Pare de redigitar no ERP o que já está no Afflux
Mande a documentação para quem cuida do seu ERP ou converse com a nossa equipe para ver como a integração ficaria na sua empresa.