Integrações - EasyData-Solutions/Documentacao GitHub Wiki
🔗 Integrações
Visão geral das integrações suportadas pelo EasyData e guia de Homologação para Boletos (CNAB) e PIX (API).
Use as tabelas para conferir compatibilidades, carteiras e status; depois, siga os passos de homologação.
🧾 Boletos — CNAB
Banco
Carteiras
Banco do Brasil
11, 17
Banco do Nordeste
1, 4, 5
Santander
1, 101
Banrisul
1
Cecred
1
Caixa Econômica Federal
SIG14
Bradesco
05, 09
Itaú
109, 112, 138, 153, 157
Safra
1
Sicredi
1
Sicoob
1, 2
Banco Inter
112
🧾 Boletos — API
Banco
Status
Sicoob
Ativo
Asaas
Ativo
💳 PIX — Integração (API)
Banco
Status
Banco do Brasil
Ativo
Sicoob
Ativo
Sicredi
Ativo
Banco Inter
Ativo
Santander
Ativo
Itaú
Em testes
🤝 Plataformas de terceiros
Plataforma
Status
SuasVendas
Em andamento
Mercos
Ativo
🧩 Serviços utilizados internamente
Serviço
Finalidade
Banco Central (PTAX)
Cotação do dólar
CNPJ ws
Consulta de CNPJ
GitHub
Atualizações do sistema
ImgBB
Hospedagem de imagens
ViaCEP
Consulta de CEP
EasyData.Licenca
Licenciamento de dispositivo
EasyData.Files
Hospedagem de arquivos
EasyData.WS
Integração com app de vendas externas ForceSystem
🧾 Homologação de Boletos (CNAB)
Guia para reunir os dados necessários e homologar boletos via CNAB 240/400 com cada banco.
✅ Checklist geral (CNAB)
Dados do Beneficiário (razão social, CNPJ/CPF, endereço, e-mail de retorno).
Agência (com dígito) e Conta (com dígito).
Carteira (ex.: 101, 112, 109, 05, 09, SIG14…).
Convênio / Código do beneficiário / Código de transmissão (quando aplicável).
Variação (quando exigida).
Parâmetros financeiros: Juros, Multa, Protesto/Baixa (dias para baixa, quando aplicável).
Campos especiais (quando exigidos): Acessório escritural (Bradesco), Posto Beneficiário (Sicredi) etc.
Definição do layout (CNAB 240 ou 400) homologado com o banco.
Contato no banco para validação da remessa/retorno e canal de suporte.
🧪 Roteiro de testes (CNAB)
Gere remessa com 1–3 títulos (carteira correta; juros/multa conforme parâmetros).
Valide no banco (arquivo aceito sem rejeição de layout).
Retorno de entrada: importar no ERP, conferir nosso número e status.
Baixa: simule pagamento e valide o retorno de liquidação no ERP.
Protesto/Baixa por decurso (se aplicável) — valide prazos.
Reemissão/Alteração (se for rotina da empresa) e aceite do banco.
🏦 Templates de coleta por banco (CNAB)
Preencha os campos. Os marcados como (quando aplicável) variam conforme a contratação com o banco.
Banco do Brasil — CNAB 400
Carteiras comuns: 11, 17
Agência: ____ · Conta: ____
Convênio: ____ · Variação (se aplicável): ____
Carteira: ____
Juros: ____ · Multa: ____
Dias para baixa (se aplicável): ____
Banco do Nordeste — CNAB 400
Carteiras: 1, 4, 5
Agência: ____ · Conta: ____
Beneficiário/Código do cedente: ____
Código de transmissão (se aplicável): ____
Carteira: ____
Juros: ____ · Multa: ____
Santander — CNAB 240
Carteiras: 1, 101
Agência: ____ · Conta: ____
Beneficiário/Código do cedente: ____
Código de transmissão (se aplicável): ____
Dias para baixa (se aplicável): ____
Juros: ____ · Multa: ____
Banrisul — CNAB (conforme contratação)
Carteiras: 1
Agência: ____ · Conta: ____
Beneficiário/Código do cedente: ____
Carteira: ____
Juros: ____ · Multa: ____
Convênio (se aplicável): ____
Cecred — CNAB (conforme contratação)
Carteiras: 1
Agência: ____ · Conta: ____
Beneficiário/Código do cedente: ____
Carteira: ____
Juros: ____ · Multa: ____
Convênio (se aplicável): ____
Caixa — CNAB (SIG14)
Carteira: SIG14
Agência: ____ · Conta/Operação: ____
Convênio / Código do beneficiário (se aplicável): ____
Juros: ____ · Multa: ____
Dias para baixa (se aplicável): ____
Bradesco — CNAB 400
Carteiras: 05, 09
Agência: ____ · Conta: ____
Acessório escritural: ____
Carteira: ____
Juros: ____ · Multa: ____
Itaú — CNAB 400
Carteiras: 109, 112, 138, 153, 157
Agência: ____ · Conta: ____
Carteira: ____
Juros: ____ · Multa: ____
Convênio (se aplicável): ____
Safra — CNAB 400
Carteiras: 1
Agência: ____ · Conta: ____
Carteira: ____
Juros: ____ · Multa: ____
Convênio (se aplicável): ____
Sicredi — CNAB 400
Carteiras: 1
Agência: ____ · Conta: ____
Beneficiário/Código do cedente: ____
Variação (se aplicável): ____
Posto Beneficiário (se aplicável): ____
Juros: ____ · Multa: ____
Sicoob — CNAB 240
Carteiras: 1, 2
Agência: ____ · Conta: ____
Beneficiário/Código do cedente (ou convênio): ____
Variação (se aplicável): ____
Carteira: ____
Juros: ____ · Multa: ____
Banco Inter — CNAB (conforme contratação)
Carteiras: 112
Agência: ____ · Conta: ____
Beneficiário/Código do cedente: ____
Carteira: ____
Juros: ____ · Multa: ____
Convênio (se aplicável): ____
📎 Observações importantes
Layout (240 × 400): confirme com o banco qual layout e carteira a empresa está habilitada a operar.
Campos especiais (ex.: “Acessório escritural”, “Posto beneficiário”, “Código de transmissão”) são obrigatórios quando exigidos — sem eles a remessa tende a rejeitar.
Juros/Multa: alinhe com a política financeira da empresa e os limites aceitos pelo banco.
🧾 Homologação de PIX (API)
✅ Requisitos de dados por banco (obrigatórios)
Banco do Brasil (BB) — CNPJ e Certificado Digital do titular da conta.
Sicoob — criar a aplicação no portal developers com a empresa parceira “EasyData Solutions”; fornecer Client ID e Client Secret (e certificados, se exigidos no fluxo).
Sicredi — CNPJ, ID de Adesão (Integração Individuais), Agência e Conta.
Banco Inter — habilitar PIX via Internet Banking e retornar Client ID, Client Secret e Certificados (PFX/PEM + senha).
Santander — criar aplicação no portal developers e retornar Client ID, Client Secret e Certificados (PFX/PEM + senha).
Observação: alguns bancos exigem redirect URI (OAuth2) e webhook/callback cadastrados no portal. Confirme esses itens ao criar a aplicação.
🧰 Checklist universal de integração PIX
Conta habilitada para PIX Cobrança/API no banco.
Credenciais: Client ID/Secret (quando aplicável) e certificado(s) + senha (quando aplicável).
Ambientes: URLs de sandbox (se houver) e produção.
Redirect URI(s) (OAuth2) cadastradas no portal (quando aplicável).
Webhook/Callback (URL pública HTTPS) para eventos (pix.received, cob, cobv, etc.).
Escopos/perfis de acesso (leitura de PIX, criação de cobrança, baixa, etc.).
Servidor com hora sincronizada (NTP) e TLS atualizado.
Idempotência (Idempotency-Key) e logs de request/response (sem dados sensíveis).
Times de suporte e infra cientes do plano de rollback.
🚀 Onboarding (passo a passo)
Criar/habilitar a aplicação no portal do banco (ou Internet Banking no caso do Inter) e obter Client ID/Secret e/ou certificados.
Cadastrar Redirect URI (se OAuth2) e Webhook (URL pública HTTPS) para receber eventos.
Entregar credenciais e certificados ao time de implantação por canal seguro (ex.: KeyVault).
Configurar no ERP: endpoints (sandbox/produção), chaves, certificados e escopos/perfis.
Go-live: substituir credenciais/URLs por produção, habilitar monitoria e acompanhar as primeiras cobranças.
🧾 Templates de coleta por banco (preencha e anexe ao chamado)
Banco do Brasil
CNPJ: __________
Certificado Digital (PFX/PEM + senha): __________
Webhook (URL HTTPS): https://.../pix/webhook
Redirect URI (se aplicável): https://.../oauth/callback
Sicoob
Client ID: __________
Client Secret: __________
Empresa parceira (na criação da app): EasyData Solutions
Certificados (se exigidos): PFX/PEM (+ senha)
Webhook: https://.../pix/webhook
Redirect URI: https://.../oauth/callback
Sicredi
CNPJ: __________
ID de Adesão (Integração Individuais): __________
Agência: __________ · Conta: __________
Webhook: https://.../pix/webhook
Redirect URI (se aplicável): https://.../oauth/callback
Banco Inter
Client ID: __________
Client Secret: __________
Certificados (PFX/PEM + senha): __________
Habilitação no Internet Banking: ✅ concluída / ⬜ pendente