Com o recurso de Importação de Empréstimos da Belvo, você pode carregar suas carteiras de empréstimos diretamente no Portal de Débito Direto. Você faz o upload de um arquivo CSV descrevendo seus empréstimos e seus clientes, e a Belvo então cria os clientes, registra seus métodos de pagamento e aplica sua estratégia de cobrança para gerar as solicitações de pagamento.
Esta é a contraparte sem código de Registrar e Acompanhar Carteiras de Empréstimos (API).
Antes de qualquer fundo ser coletado, você deve:
- Obter consentimento explícito de seus usuários, autorizando você a debitar fundos de suas contas.
- Manter evidências documentadas desse consentimento.
Você pode fazer isso carregando consentimentos em massa com nosso recurso de Uploads de Consentimento em Massa, ou programaticamente com nossa Consent API.
No seu Portal de Débito Direto, vá para Cobranças Gerenciadas → Importação de Empréstimos (Sandbox | Produção).
Baixe o modelo de planilha
.xlsxvinculado nessa tela. A abaDescripcionesdescreve todas as 28 colunas, quais são obrigatórias, e a planilha restringeBanco,Tipo de IDeEstado del Creditoaos seus valores aceitos, para que você não possa digitar um valor não suportado por engano.Sempre comece a partir do modelo atualSempre baixe o modelo da tela de Importação de Empréstimos a cada vez, em vez de reutilizar uma cópia antiga, para evitar quaisquer problemas relacionados à cobertura bancária ou novos campos obrigatórios.
Na planilha, preencha a aba
MXN.Salve a aba
MXNcomo um CSV. Por favor, observe:- O separador deve ser uma vírgula. Se você usar ponto e vírgula (
;), o arquivo falhará no upload. Certifique-se de que seu CSV use vírgulas (,). - Salve apenas a aba
MXN. - Salve os arquivos como UTF-8 para garantir que sejam compatíveis com nosso sistema.
- O separador deve ser uma vírgula. Se você usar ponto e vírgula (
Nomeie seu arquivo CSV de forma que contenha a data da cobrança. Veja a seção Nomeando seu arquivo para mais detalhes, pois nomear seu arquivo incorretamente pode levar a cobranças em um dia incorreto para seus clientes.
Faça o upload do CSV na tela de Importação de Empréstimos. Nota: A plataforma aceita apenas arquivos CSV.
Revise o resultado. As linhas que não conseguimos processar são listadas com o motivo, e você pode corrigi-las e fazer o upload de um arquivo corrigido.
A Belvo lê a data de coleta a partir do nome do arquivo. Ela procura por uma data escrita como YYYY-MM-DD em qualquer parte do nome, e essa data se torna o dia em que os empréstimos nesse arquivo são coletados. Por exemplo, todos estes são coletados em 15 de setembro de 2026:
Daily_MyCompany_2026-09-15_managed_collection.csv
cartera 2026-09-15.csv
2026-09-15-loans.csvSe você enviar mais de um arquivo para a mesma data de coleta, certifique-se de dar a cada arquivo um nome único e (opcionalmente) também adicionar um _ + dígito ao final da data de coleta. Por exemplo:
Client1-2026-09-15_0.csv
Client1-2026-09-15_1.csv
Client2-2026-09-15_0.csv
Client2-2026-09-15_1.csvSe o nome do arquivo não contiver uma data no formato YYYY-MM-DD, a Belvo usará a data de upload do arquivo na Cidade do México (GMT-6) em vez disso, sem falhar no upload. Isso fará com que seu cliente seja cobrado em uma data que você não escolheu. Portanto, recomendamos fortemente que você sempre forneça uma data de coleta no nome do arquivo.
Se a mesma Referencia Unica cliente (UID) aparecer mais de uma vez em um arquivo, o arquivo inteiro é rejeitado e nada é coletado dele. Uma referência repetida é suficiente.
Quando a Belvo não consegue processar uma linha, a linha em questão é ignorada e nenhuma solicitação de pagamento é criada para ela. No entanto, o restante do arquivo ainda é processado normalmente. Você pode corrigir as linhas sinalizadas/ignoradas e reenviar o arquivo.
Abaixo estão os motivos mais comuns para uma linha ser ignorada:
| Motivo | O que fazer |
|---|---|
| A CLABE pertence a um banco que a Belvo não suporta para Débito Direto | Nada, do seu lado. Esta é uma cobertura que a Belvo não possui, então a linha não pode ser coletada independentemente de como o arquivo é escrito. Verifique os bancos aceitos na lista de bancos do modelo e veja Instituições. |
| A mesma referência de cliente aparece duas vezes | Envie uma linha por cliente por data de coleta. Nota: Este erro invalida o arquivo inteiro, não apenas a linha em questão. |
| Um nome ou sobrenome contém algo além de letras | Remova dígitos, pontuação e símbolos. Caracteres acentuados e ñ são aceitos. |
O número de telefone não é +52 seguido por exatamente 10 dígitos | Escreva o número como +52 mais o número nacional de 10 dígitos, sem espaços ou traços. |
Uma data não está escrita como YYYY-MM-DD | Use YYYY-MM-DD. Este é o único formato aceito, e planilhas frequentemente armazenam datas como números, então verifique o que foi realmente escrito no CSV. |
Tipo de ID não é mx_rfc ou mx_curp | Use um desses dois valores e certifique-se de que o número do documento corresponda ao tipo: 18 caracteres para um CURP, 12 ou 13 para um RFC. |
Estado del Credito não é um status aceito | Use past_due, restructured, canceled ou in_arrears. |
| O número da conta está com o comprimento errado | Uma CLABE tem 18 dígitos. Um número de cartão tem de 13 a 16. Para um cartão, Banco também deve ser preenchido com um identificador de banco. |