{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/pt-BR/products/payments_mexico/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Enviar Importações em Lote via SFTP","description":"Belvo provides open finance products for Latin America that allow you to securely access and aggregate financial data as well as accept and issue bank-to-bank payments","siteUrl":"https://developers.belvo.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"enviar-importações-em-lote-via-sftp","__idx":0},"children":["Enviar Importações em Lote via SFTP"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"visão-geral","__idx":1},"children":["Visão Geral"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A funcionalidade de Importação em Lote via SFTP permite que você faça upload de arquivos CSV contendo dados de pagamento para automatizar a criação de clientes, métodos de pagamento e solicitações de pagamento em larga escala. Esta é a mesma funcionalidade de importação em lote disponível através do Portal do Comerciante e da API, mas com a conveniência adicional da automação baseada em arquivos via SFTP."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Esta funcionalidade é ideal para:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fluxos de trabalho automatizados"]},": Configure transferências de arquivos agendadas a partir dos seus sistemas"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processamento de alto volume"]},": Processe milhares de solicitações de pagamento de forma eficiente"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integração de sistemas"]},": Conecte seus processos em lote existentes sem integração com API"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Simplicidade operacional"]},": Use clientes SFTP padrão em vez de código API personalizado"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Habilitação da Funcionalidade"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As Importações em Lote via SFTP devem ser habilitadas para sua conta de comerciante. Entre em contato com o suporte da Belvo para solicitar acesso a esta funcionalidade."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Obtenha Consentimento do Usuário para Debitar Contas"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Antes de fazer qualquer solicitação de pagamento, você deve:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obter consentimento explícito dos seus usuários, autorizando você a debitar fundos de suas contas."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Manter evidências documentadas desse consentimento."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para mais informações, consulte nosso guia ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-sftp-consents-guide","target":"_blank"},"children":["Upload em Massa de Consentimentos via SFTP"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"como-funciona","__idx":2},"children":["Como Funciona"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O processo de importação em lote via SFTP espelha a funcionalidade de ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-bulk-import-no-code","target":"_blank"},"children":["Importação em Lote de Pagamentos por Débito Direto"]}," disponível no Portal do Comerciante, com automação baseada em arquivos:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Carregar CSV"]},": Você carrega um arquivo CSV (usando o mesmo formato dos uploads do portal) no seu diretório de entrada SFTP."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Coleta Automática"]},": A Belvo monitora seu diretório de entrada e coleta novos arquivos a cada 15 minutos, de segunda a sexta-feira."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processamento"]},": O sistema valida e processa seu arquivo, criando clientes, registrando métodos de pagamento e enviando solicitações de pagamento."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Feedback"]},": Um arquivo de feedback ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".txt"]}," é gerado no seu diretório de saída com os resultados do processamento."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Webhooks e Acesso à API"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O processamento de importação em lote via SFTP aciona os mesmos webhooks e atualiza os mesmos recursos da API que as importações em lote baseadas no portal ou na API. O arquivo de feedback SFTP é um mecanismo de notificação adicional, não um substituto para webhooks."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pré-requisitos","__idx":3},"children":["Pré-requisitos"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Antes de enviar arquivos de importação em lote via SFTP, certifique-se de ter:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Importações em Lote via SFTP Habilitadas"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Entre em contato com o suporte da Belvo para habilitar importações em lote via SFTP para sua conta de comerciante."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Credenciais de SFTP"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Obtenha suas credenciais de acesso SFTP com a equipe de suporte da Belvo. Por favor, note que permitimos apenas uma conta SFTP por comerciante."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Documentação de Consentimento"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Certifique-se de ter obtido e documentado o consentimento de todos os clientes incluídos na sua importação em lote. Você pode enviar os consentimentos usando o recurso ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-sftp-consents-guide","target":"_blank"},"children":["Envio em Lote de Consentimentos via SFTP"]}," ou a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/apis/belvopaymentsmexico/payment-consents-(direct-debit-mexico)","target":"_blank"},"children":["Consent API"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Arquivo CSV Preparado"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Prepare seu arquivo CSV seguindo o mesmo formato usado para uploads no portal. Para especificações de campos, consulte a documentação de ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-bulk-import-no-code#bulk-import-file-templates","target":"_blank"},"children":["Modelos de arquivos de importação em lote"]},"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"estrutura-de-diretórios-sftp","__idx":4},"children":["Estrutura de Diretórios SFTP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sua conta SFTP possui dois diretórios dedicados para importações em lote:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"├── {merchantId}/\n│   ├── inbound/\n│   │   └── batch_imports/     ← Faça upload dos arquivos CSV aqui\n│   └── outbound/\n│       └── batch_imports/     ← Arquivos de feedback aparecem aqui\n"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Diretório de Entrada"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{merchantId}/inbound/batch_imports/"]},"): Faça upload dos seus arquivos CSV neste diretório. Os arquivos devem seguir o mesmo formato CSV usado no Portal do Comerciante."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Diretório de Saída"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{merchantId}/outbound/batch_imports/"]},"): A Belvo escreve arquivos de feedback ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".txt"]}," aqui. Você ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["não"]}," cria esta pasta por conta própria—a Belvo a provisiona. Você ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["lê"]}," ou baixa do diretório de saída quando os arquivos estiverem disponíveis."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Crie a pasta de importações em lote se necessário"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batch_imports/"]}," não existir em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{merchantId}/inbound/"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["crie essa pasta manualmente"]}," no seu cliente SFTP antes de fazer o upload."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"especificações-de-arquivo","__idx":5},"children":["Especificações de Arquivo"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"formato-csv","__idx":6},"children":["Formato CSV"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Os arquivos CSV de importação em lote devem seguir o mesmo formato dos uploads do portal. Para a especificação completa dos campos, consulte a documentação de ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-bulk-import-no-code#bulk-import-file-templates","target":"_blank"},"children":["Modelos de arquivo de importação em lote"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Criar Métodos de Pagamento em Lote Apenas"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Você também pode usar este recurso para criar clientes e métodos de pagamento em lote sem fazer solicitações de pagamento. Para isso, omita os campos ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Referencia Única cliente"]}," e ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Importe a cobrar"]}," no seu CSV."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"nomeação-de-arquivos","__idx":7},"children":["Nomeação de Arquivos"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Você pode usar qualquer nome de arquivo válido para seus arquivos CSV. Recomendamos usar nomes descritivos que incluam uma data ou identificador de lote para seus próprios propósitos de rastreamento."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Nomes de Arquivos Válidos:\n✅ payments_2026-04-08.csv\n✅ batch_001.csv\n✅ monthly_debits_april.csv\n"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Objetos ignorados"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Arquivos vazios, objetos de zero bytes e entradas de espaço reservado de diretório sob ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batch_imports"]}," são ignorados e não são processados."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"processo-de-upload","__idx":8},"children":["Processo de Upload"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Conecte-se ao SFTP usando seu software preferido (por exemplo, Cyberduck, FileZilla ou ferramentas de linha de comando). Use as credenciais fornecidas pela equipe de suporte da Belvo."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navegue até o diretório ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{merchantId}/inbound/batch_imports/"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Faça o upload do seu arquivo CSV para este diretório."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Aguarde o processamento do arquivo. A Belvo verifica seu diretório de entrada a cada 15 minutos, de segunda a sexta-feira."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verifique o diretório ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{merchantId}/outbound/batch_imports/"]}," para um arquivo de feedback ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".txt"]}," com os resultados do processamento."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Agenda de Processamento"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Os arquivos são coletados a cada 15 minutos, de segunda a sexta-feira. Arquivos enviados fora do horário comercial ou nos fins de semana serão processados no próximo dia útil."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Remoção de Arquivos"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Após um arquivo ser coletado para processamento, a Belvo tenta removê-lo do diretório de entrada para evitar processamento duplicado. Se a remoção for bem-sucedida, o mesmo arquivo não será coletado novamente. Se a remoção falhar (raro), o objeto ainda pode aparecer em listagens em uma execução posterior e pode ser processado novamente—entre em contato com o suporte da Belvo ou remova ou renomeie o arquivo manualmente se você vir arquivos obsoletos após já ter recebido feedback."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"arquivos-de-feedback","__idx":9},"children":["Arquivos de Feedback"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Após o processamento, um arquivo de feedback ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".txt"]}," é gravado em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{merchantId}/outbound/batch_imports/"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"nomeação-de-arquivos-de-feedback","__idx":10},"children":["Nomeação de arquivos de feedback"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O nome de saída é derivado do seu arquivo CSV: o nome base e a extensão são mantidos, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["pontos (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["."]},") no nome ou extensão são substituídos por underscores"]},", e um ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["timestamp Unix em milissegundos"]}," é adicionado. A extensão é sempre ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".txt"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Exemplos:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payments_2026-04-08.csv"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payments_2026-04-08_csv_1775590260741.txt"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batch.import.csv"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batch_import_csv_<timestamp>.txt"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use o timestamp (e seu log de upload) para associar arquivos de feedback aos uploads quando várias execuções ocorrem próximas umas das outras."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"quando-o-feedback-é-gerado","__idx":11},"children":["Quando o Feedback é Gerado"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Falhas de validação/preparação"]},": O feedback de falha é enviado nesse caminho assim que a importação em lote não pode prosseguir (incluindo quando a validação falha antes de existir um registro em lote)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Caminho bem-sucedido"]},": Após a validação ser aprovada e o lote ser ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["enviado para processamento"]},", o feedback de sucesso ou falha terminal é registrado apenas quando o lote atinge um estado ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["terminal"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processed"]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]},"). O sistema verifica novamente aproximadamente ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["a cada minuto"]},", portanto, pode haver um atraso entre o arquivo desaparecer da entrada e o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".txt"]}," aparecer na saída."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"visão-geral-do-formato","__idx":12},"children":["Visão Geral do Formato"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A primeira linha sempre faz referência ao ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["nome original do arquivo CSV"]}," e se foi ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["processado com sucesso"]}," ou ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["não pôde ser processado"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Quando um registro de importação em lote existe, a primeira linha inclui ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(batchImportId: <uuid>)"]},". Se o processamento falhar antes de um ID de lote ser criado, a primeira linha ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["não"]}," possui ID de importação em lote."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Linhas puladas"]}," (somente em caso de sucesso) são listadas como ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["linhas no formato CSV"]}," (mesma estrutura dos dados de linha de importação em massa), não como resumos “Linha N:”."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Erros"]}," usam a mesma estrutura que erros de validação de linha no Portal do Comerciante: blocos numerados, mensagens em lista e uma seção opcional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Linha:"]}," com chaves de campo e valores sensíveis ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["mascarados"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"feedback-de-sucesso","__idx":13},"children":["Feedback de Sucesso"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando o lote termina com status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processed"]},", o corpo se apresenta assim:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-title":"Exemplo — sucesso limpo","header":{"title":"Exemplo — sucesso limpo","controls":{"copy":{}}},"source":"Arquivo payments_january.csv processado com sucesso (batchImportId: 3f8e7d6c-5b4a-3210-fedc-ba9876543210).\n0 linha(s) foram puladas.\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Com linhas puladas:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-title":"Exemplo — sucesso com linhas puladas","header":{"title":"Exemplo — sucesso com linhas puladas","controls":{"copy":{}}},"source":"Arquivo payments_january.csv processado com sucesso (batchImportId: 3f8e7d6c-5b4a-3210-fedc-ba9876543210).\n2 linha(s) foram puladas.\n\nLinhas puladas (2):\n  RFC,ABCD123456ABC,john@example.com,John,Doe,+521234567890,****1234,poupança,500,REF001,,mxn\n  RFC,XYZW987654XYZ,jane@example.com,Jane,Smith,+529876543210,****5678,poupança,250,REF002,,mxn\n"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Valores mascarados"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Campos de conta e outros campos sensíveis aparecem ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["mascarados"]}," no feedback (por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["****1234"]},"), consistente com a experiência de importação em massa no Portal do Comerciante."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sucesso-com-erros-de-linha-tolerados","__idx":14},"children":["Sucesso com erros de linha tolerados"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Esta forma aparece apenas quando o lote ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ainda é concluído como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processed"]}]},", mas algumas linhas tiveram problemas de validação toleráveis. O título da seção no arquivo é ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Rows with errors (tolerated)"]}]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-title":"Exemplo — processado com erros de linha tolerados","header":{"title":"Exemplo — processado com erros de linha tolerados","controls":{"copy":{}}},"source":"Arquivo payments_january.csv processado com sucesso (batchImportId: 3f8e7d6c-5b4a-3210-fedc-ba9876543210).\n1 linha(s) foram ignoradas.\n\nLinhas ignoradas (1):\n  RFC,ABCD123456ABC,john@example.com,John,Doe,+521234567890,****1234,savings,500,REF001,,mxn\n\nLinhas com erros (tolerados) (1):\n--\nErro 1:\n  * o comprimento de accountNumber deve ser de 18 caracteres\n  Linha:\n    firstname: John\n    lastname: Doe\n    accountNumber: ****1234\n    amount: 500\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se as regras de validação causarem a falha de ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["todo o lote"]}," (por exemplo, tolerância desativada ou muitos erros), você receberá um feedback de ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["falha"]}," em vez deste modelo de sucesso."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"feedback-de-falha","__idx":15},"children":["Feedback de Falha"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando a preparação ou o processamento terminal falha com erros estruturados:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-title":"Exemplo — falha com erros de validação","header":{"title":"Exemplo — falha com erros de validação","controls":{"copy":{}}},"source":"O arquivo payments_january.csv não pôde ser processado (batchImportId: 3f8e7d6c-5b4a-3210-fedc-ba9876543210).\n\nErros (2):\n--\nErro 1:\n  * email deve ser um email\n  Linha:\n    email: not-a-valid-email\n    amount: 50\n    currency: mxn\n    firstname: Bad\n    lastname: Email\n--\nErro 2:\n  * documentType deve ser um dos seguintes valores: mx_rfc, mx_curp\n  Linha:\n    email: jane@example.com\n    documentType: mx_xyz\n    documentNumber: BADD141414NNN\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando ainda não existe um ID de importação em lote:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-title":"Exemplo — falha antes de existir ID de importação em lote","header":{"title":"Exemplo — falha antes de existir ID de importação em lote","controls":{"copy":{}}},"source":"O arquivo payments_january.csv não pôde ser processado.\n\nErros (1):\n--\nErro 1:\n  * email deve ser um email\n  Linha:\n    email: invalid\n    ...\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"feedback-de-erro-inesperado","__idx":16},"children":["Feedback de erro inesperado"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando não há uma lista de erros estruturada (por exemplo, um erro de processamento inesperado), o arquivo contém apenas o cabeçalho e uma segunda linha fixa:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-title":"Exemplo — erro inesperado","header":{"title":"Exemplo — erro inesperado","controls":{"copy":{}}},"source":"O arquivo payments_january.csv não pôde ser processado (batchImportId: 3f8e7d6c-5b4a-3210-fedc-ba9876543210).\n\nDevido a um erro inesperado.\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se nenhum lote foi criado, a primeira linha é ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["O arquivo <name>.csv não pôde ser processado."]}," sem ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(batchImportId: ...)"]},", seguida por uma linha em branco e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Devido a um erro inesperado."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ciclo-de-vida-de-importação-em-lote","__idx":17},"children":["Ciclo de Vida de Importação em Lote"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Importações em lote enviadas via SFTP seguem o mesmo ciclo de vida que os uploads pelo portal:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validating"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O arquivo está sendo validado para erros de formato e conteúdo."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O arquivo possui erros críticos e não pode ser processado. Verifique o arquivo de feedback para mais detalhes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ready_to_send"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A validação foi aprovada. Para uploads via SFTP, o processamento continua automaticamente."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clientes, métodos de pagamento e solicitações de pagamento estão sendo criados."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Processamento concluído. Verifique o arquivo de feedback para os resultados, incluindo quaisquer linhas ignoradas."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Processamento Automático"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ao contrário dos uploads pelo portal, onde você deve clicar manualmente em \"Enviar\" após a validação, os uploads via SFTP são automaticamente enviados para processamento assim que a validação é aprovada."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"solução-de-problemas","__idx":18},"children":["Solução de Problemas"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"arquivo-não-aparece-no-diretório-de-saída","__idx":19},"children":["Arquivo não aparece no diretório de saída"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Causa"},"children":["Causa"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solução"},"children":["Solução"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Arquivo ainda está sendo processado"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Aguarde pelo menos 30 minutos após o upload. O processamento pode demorar mais para arquivos grandes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Arquivo enviado fora do horário de processamento"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Os arquivos são processados apenas de segunda a sexta-feira. Aguarde até o próximo dia útil."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lote ainda está processando solicitações de pagamento"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Para lotes que passam na validação, o feedback é gerado apenas após o lote atingir o status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processed"]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Arquivo foi enviado para o diretório errado"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verifique se você enviou para ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{merchantId}/inbound/batch_imports/"]}," (não ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bulk-consents"]},")."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"arquivo-permanece-no-diretório-de-entrada","__idx":20},"children":["Arquivo permanece no diretório de entrada"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Em casos raros, um arquivo pode permanecer no diretório de entrada após o processamento porque a exclusão falhou. Esse objeto pode ser capturado novamente em uma execução posterior. Se você já recebeu feedback para esse upload, entre em contato com o suporte da Belvo ou remova ou renomeie o arquivo manualmente. Se estiver em dúvida, verifique o status do lote via API ou Portal do Comerciante antes de fazer o upload novamente."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"erros-comuns-de-validação","__idx":21},"children":["Erros comuns de validação"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para erros comuns de validação de CSV e suas soluções, consulte a seção ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-bulk-import-no-code#troubleshooting-and-faqs","target":"_blank"},"children":["Solução de Problemas e FAQs"]}," na documentação de Importação em Massa."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"melhores-práticas","__idx":22},"children":["Melhores Práticas"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"antes-de-fazer-o-upload","__idx":23},"children":["Antes de Fazer o Upload"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Valide seu CSV localmente"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Certifique-se de que todos os campos obrigatórios estão presentes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verifique se os números CLABE têm 18 dígitos"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cheque se os endereços de email são válidos"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirme se os tipos de ID são ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mx_curp"]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mx_rfc"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Teste com pequenos lotes primeiro"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Faça o upload de um arquivo com algumas linhas para verificar se o formato está correto"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verifique o arquivo de feedback antes de fazer upload de grandes lotes"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Garanta que os consentimentos estão em ordem"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Todos os clientes devem ter confirmado os consentimentos antes que as solicitações de pagamento sejam criadas"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use o recurso ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-sftp-consents-guide","target":"_blank"},"children":["SFTP Bulk Upload Consents"]}," para fazer upload dos documentos de consentimento"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"durante-o-upload","__idx":24},"children":["Durante o Upload"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use nomes de arquivos descritivos"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Inclua datas ou identificadores de lote para facilitar o rastreamento"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mantenha um registro local dos arquivos enviados"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Evite uploads duplicados"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Aguarde feedback antes de enviar os mesmos dados novamente"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use referências únicas para cada solicitação de pagamento"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"após-o-upload","__idx":25},"children":["Após o Upload"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Monitore arquivos de feedback"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verifique seu diretório de saída regularmente"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Revise linhas ignoradas e erros prontamente"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Acompanhe via webhooks"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure listeners de webhook para eventos de importação em lote"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use a API para verificar o status do lote para informações detalhadas"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mantenha trilhas de auditoria"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Arquive arquivos de feedback para conformidade"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Documente quaisquer erros e resoluções"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"próximos-passos","__idx":26},"children":["Próximos Passos"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Após configurar as importações em lote via SFTP:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Revise as ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-bulk-import-no-code#bulk-import-file-templates","target":"_blank"},"children":["especificações de campos CSV"]}," para garantir que seus arquivos estejam formatados corretamente."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/developer_resources/resources-webhooks-payments-mexico","target":"_blank"},"children":["ouvintes de webhook"]}," para receber notificações em tempo real sobre suas importações em lote."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Utilize o recurso ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-reporting-payment-exports","target":"_blank"},"children":["Exportações de Pagamentos"]}," para reconciliar os pagamentos processados."]}]}]},"headings":[{"value":"Enviar Importações em Lote via SFTP","id":"enviar-importações-em-lote-via-sftp","depth":1},{"value":"Visão Geral","id":"visão-geral","depth":2},{"value":"Como Funciona","id":"como-funciona","depth":2},{"value":"Pré-requisitos","id":"pré-requisitos","depth":2},{"value":"Estrutura de Diretórios SFTP","id":"estrutura-de-diretórios-sftp","depth":2},{"value":"Especificações de Arquivo","id":"especificações-de-arquivo","depth":2},{"value":"Formato CSV","id":"formato-csv","depth":3},{"value":"Nomeação de Arquivos","id":"nomeação-de-arquivos","depth":3},{"value":"Processo de Upload","id":"processo-de-upload","depth":2},{"value":"Arquivos de Feedback","id":"arquivos-de-feedback","depth":2},{"value":"Nomeação de arquivos de feedback","id":"nomeação-de-arquivos-de-feedback","depth":3},{"value":"Quando o Feedback é Gerado","id":"quando-o-feedback-é-gerado","depth":3},{"value":"Visão Geral do Formato","id":"visão-geral-do-formato","depth":3},{"value":"Feedback de Sucesso","id":"feedback-de-sucesso","depth":3},{"value":"Sucesso com erros de linha tolerados","id":"sucesso-com-erros-de-linha-tolerados","depth":3},{"value":"Feedback de Falha","id":"feedback-de-falha","depth":3},{"value":"Feedback de erro inesperado","id":"feedback-de-erro-inesperado","depth":3},{"value":"Ciclo de Vida de Importação em Lote","id":"ciclo-de-vida-de-importação-em-lote","depth":2},{"value":"Solução de Problemas","id":"solução-de-problemas","depth":2},{"value":"Arquivo não aparece no diretório de saída","id":"arquivo-não-aparece-no-diretório-de-saída","depth":3},{"value":"Arquivo permanece no diretório de entrada","id":"arquivo-permanece-no-diretório-de-entrada","depth":3},{"value":"Erros comuns de validação","id":"erros-comuns-de-validação","depth":3},{"value":"Melhores Práticas","id":"melhores-práticas","depth":2},{"value":"Antes de Fazer o Upload","id":"antes-de-fazer-o-upload","depth":3},{"value":"Durante o Upload","id":"durante-o-upload","depth":3},{"value":"Após o Upload","id":"após-o-upload","depth":3},{"value":"Próximos Passos","id":"próximos-passos","depth":2}],"frontmatter":{"seo":{"title":"Enviar Importações em Lote via SFTP"}},"lastModified":"2026-04-08T19:08:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/pt-br/products/payments_mexico/direct-debit-sftp-batch-imports-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}