# Introdução

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).

Obtenha consentimento do usuário para debitar contas
Antes de qualquer fundo ser coletado, você deve:

1. Obter consentimento explícito de seus usuários, autorizando você a debitar fundos de suas contas.
2. 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.

## Instruções

1. No seu Portal de Débito Direto, vá para **Cobranças Gerenciadas** → **Importação de Empréstimos** (Sandbox | Produção).
2. Baixe o modelo de planilha `.xlsx` vinculado nessa tela.
A aba `Descripciones` descreve todas as 28 colunas, quais são obrigatórias, e a planilha restringe `Banco`, `Tipo de ID` e `Estado del Credito` aos seus valores aceitos, para que você não possa digitar um valor não suportado por engano.
Sempre 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.
3. Na planilha, preencha a aba `MXN`.
4. Salve a aba `MXN` como 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.
5. 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.
6. Faça o upload do CSV na tela de **Importação de Empréstimos**. Nota: A plataforma aceita apenas arquivos CSV.
7. 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.


## Nomeando seu arquivo

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:


```text Nomes de arquivos válidos
Daily_MyCompany_2026-09-15_managed_collection.csv
cartera 2026-09-15.csv
2026-09-15-loans.csv
```

Se 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:


```text Envios múltiplos de arquivos para a mesma data de coleta
Client1-2026-09-15_0.csv
Client1-2026-09-15_1.csv
Client2-2026-09-15_0.csv
Client2-2026-09-15_1.csv
```

Datas de Coleta Vazias
Se 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.

## O que acontece com as linhas que a Belvo não consegue processar

Certifique-se de fornecer identificadores únicos de cliente
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. |