A Linkana coleta os dados bancários do fornecedor como parte do processo de homologação. As informações ficam disponíveis para o comprador consultar e exportar, e podem passar por validação automática para confirmar que a conta é real e pertence ao fornecedor.
Existem dois tipos de documento de dados bancários, de acordo com o tipo de fornecedor:
Dados bancários (nacional) — para fornecedores nacionais (PJ e PF). Pode incluir validação automática via PIX.
Dados bancários (internacional) — para fornecedores internacionais. Coleta dados no padrão bancário internacional, sem validação automática.
Dados bancários (nacional)
Ao preencher o documento, o fornecedor escolhe uma de três opções:
Usar conta da sua empresa (CNPJ) — para contas bancárias vinculadas ao CNPJ da empresa. O fornecedor seleciona qual CNPJ será vinculado (matriz ou filial).
Usar a conta de uma pessoa (CPF) — para casos de MEI ou Empresário Individual. O comprador pode desativar essa opção para fornecedores PJ — veja a seção Configurações abaixo.
Não quero informar agora — para fornecedores que recebem pagamento por cartão de crédito ou boleto. O documento é enviado sem dados bancários.
Após escolher o tipo de conta, o fornecedor preenche:
Razão Social ou Nome Completo — titular da conta, conforme a opção escolhida (CNPJ ou CPF)
CNPJ ou CPF vinculado à conta
Instituição bancária — selecionada de uma lista com código e nome do banco
Tipo de conta — Corrente, Poupança, Salário ou Transacional
Agência — 4 dígitos
Conta — número da conta com dígito
Configurações
O comprador pode configurar o documento de dados bancários em Configurações → Campos do fornecedor, clicando em Editar formulário:
Nome — nome do documento exibido para o fornecedor
Permitir conta de pessoa física (CPF) para fornecedores pessoa jurídica (CNPJ) — ligado por padrão. Quando desativado, o fornecedor PJ deixa de ver a opção de usar a conta de uma pessoa física (CPF) ao preencher o documento — só poderá usar conta de CNPJ ou escolher "não quero informar agora". Fornecedores PF não são afetados. Desativar a opção não invalida documentos com conta PF já enviados ou aprovados; a mudança vale para novos preenchimentos e renovações.
Grupo de revisão — em qual grupo o documento aparece para revisão
Tipo de revisão — define como o documento é revisado após o envio: Revisão manual, Aprovação automática ou Pix (validação automática — veja a seção abaixo)
Em Configurações avançadas:
Bloquear fornecedor se este documento vencer — o fornecedor é bloqueado quando o documento vence
Enviar evento de integração após revisão — para quem usa integrações via webhook; só tem efeito com o Código de integração preenchido
Código de integração (opcional) — identifica esse documento dentro da API
Validação automática via PIX
Quando a validação automática está habilitada, a Linkana realiza um PIX de R$0,01 para a conta informada após o envio. Essa validação confirma que a conta existe, está ativa e pertence ao CNPJ ou CPF indicado.
Três cenários possíveis:
PIX confirmado, titular confere — o documento é aprovado automaticamente. A Linkana gera um comprovante bancário da transação, que fica salvo junto aos dados.
PIX confirmado, titular diverge — o titular da conta não corresponde ao CNPJ/CPF do fornecedor. O documento volta para correção com o motivo da divergência.
PIX falha — a conta não existe, está inativa ou os dados estão incorretos. O documento volta para correção com o motivo da falha.
Se o PIX falhar, o fornecedor pode enviar um comprovante bancário como alternativa para comprovar os dados.
Atenção: A validação via PIX não é acionada quando o tipo de pessoa do documento (PJ/PF) diverge do tipo de pessoa do fornecedor — por exemplo, um documento CPF vinculado a um fornecedor PJ. Nesses casos, o documento segue para revisão manual.
Dica: O revisor pode preencher ou corrigir os dados bancários manualmente clicando em "Atualizar manualmente" na tela do documento.
Códigos de retorno do PIX
Quando o PIX de validação falha, o documento mostra o motivo no formato código - descrição. Esse código vem do banco do fornecedor ou do sistema do PIX, não é gerado pela Linkana.
Os códigos mais comuns na validação de dados bancários são
Código | O que significa |
AC03 | Agência e/ou conta inexistente ou inválida |
AC06 | Conta bloqueada |
AC07 | Conta encerrada |
AC14 | Tipo de conta incorreto (corrente, poupança etc.) |
AG03 | Conta não aceita esse tipo de recebimento (ex.: conta salário) |
BE01 | CPF/CNPJ não corresponde ao titular da conta |
CH11 | CPF/CNPJ do recebedor incorreto |
Dados bancários (internacional)
Para fornecedores internacionais, a Linkana coleta os dados bancários em formato internacional. Não há validação automática — os dados são coletados e ficam disponíveis para revisão manual.
Campos coletados:
Bank Code — código do banco
Branch Code — código da agência (opcional)
Bank Account Number — número da conta
Account Type — tipo da conta
Country — país do banco
Currency — moeda da conta
IBAN — número bancário internacional (opcional)
SWIFT/BIC — código de identificação do banco (opcional)
O fornecedor também pode adicionar um comentário explicando suas respostas.


