Conciliador Zap · Open Finance
O que a API da Pluggy entrega hoje para a conciliação bancária da Zap Contabilidade — quais bancos dá para conectar e quais dados cada um devolve.
Conectei uma conta de teste e baixei os lançamentos de verdade. Esta é a resposta para a pergunta que importa: de cada transação que cai no extrato, dá para saber quem é a contraparte? A resposta é sim em pouco mais da metade — e o CNPJ vem de dois lugares diferentes, não de um.
merchant.cnpjcompras no cartão · traz CNAE juntopaymentDataPIX, TED, DOC e boleto| Data | Descrição | Valor | Categoria Pluggy | Identificação | Contraparte |
|---|
Uma transação PIX crua, exatamente como a API devolve. Repare no paymentData: pagador e recebedor vêm separados, cada um com banco, agência, conta e documento.
Cada conector expõe um conjunto de “produtos”. Os quatro destacados são os que a conciliação consome — em especial o PAYMENT_DATA, que traz nome e CPF/CNPJ de quem recebeu ou enviou o PIX/TED. É ele que transforma o vínculo por CNPJ em dado estruturado, em vez de regex no histórico do extrato.
Esta parte já responde sem conectar banco nenhum: a Pluggy classifica cada transação numa árvore própria de 130 categorias, em português. Abaixo, cada raiz com o grupo de DRE e de DFC que eu proponho — é o rascunho do de-para que vai virar o plano_contas. Clique para abrir as subcategorias.
Os bancos dos clientes da Zap estão todos aqui. Repare que os grandes aparecem duas vezes: a versão Open Finance (consentimento oficial via Banco Central) e a versão de acesso direto. São conectores distintos, com id diferente — a escolha entre eles é decisão de produto, banco a banco.
| ID | Instituição | Saúde | Acesso | Produtos | Credenciais |
|---|
Confirmado na prática: conectei o Pluggy Bank Business CNPJ (id 14) com um CNPJ fictício e em cerca de 20 segundos vieram 2 contas e 30 lançamentos. Dá para construir o pipeline inteiro — ingestão, match por CNPJ, DRE e DFC — sem tocar em banco de cliente e sem consumir conexão paga.
GET /transactions está morto — devolve 410 ENDPOINT_DEPRECATED. O caminho é GET /v2/transactions, com paginação por cursor (next) e sem pageSize. Os exemplos de código da própria Pluggy que estão na pasta ainda usam a rota velha.GET /items devolve 401 mesmo com credencial boa: não existe "liste meus items". Quem guarda o itemId é a nossa base, no momento em que o widget do Connect devolve. Perdeu o id, perdeu a conta conectada.creditCardMetadata (installmentNumber de totalInstallments). Uma compra em 6x não pode bater inteira na DRE do mês.curl desta máquina usa Schannel e não fecha TLS com api.pluggy.ai; o Python (OpenSSL) conecta normal. O backend é Python, então não afeta — mas engana na hora de testar no terminal.smart-accounts responde 403: iniciação de pagamento não está no plano. Só leitura.