> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar e exportar empresas: CSV em massa

> Carregue em massa entidades Didit Business (KYB) via CSV e exporte a tabela completa de empresas pelo Console Didit Business. Cobrança por chamada.



Prompt para importar/exportar empresas em massa
        Copiar o prompt para a área de transferência



      
      

\<pre>

\````# Goal — bulk-load (or extract) Didit Business entities programmatically

CSV import / export is console-only. For programmatic bulk operations, loop `POST /v3/businesses/create/` for imports and paginate `GET /v3/businesses/` for exports.

\## Bulk import — loop the create endpoint

\```bash
\# businesses.json — array of records
\# [{"vendor_data":"biz-acme","display_name":"Acme Corp","country_code":"GBR"}, ...]

jq -c '.[]' businesses.json | while read biz; do
curl -X POST https://verification.didit.me/v3/businesses/create/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d "$biz"
sleep 0.1   # respect rate limits — see /integration/rate-limiting
done
\```

Record shape (matches `POST /v3/businesses/create/`):

\```json
\{
"vendor_data": "biz-acme",         // required, unique per app
"display_name": "Acme Corp",       // optional
"country_code": "GBR",             // ISO 3166-1 alpha-3, optional
"metadata": {"partner": "Acme Holdings"},
"tags": ["b2b-tier-1"]
}
\```

\`create` is **not** idempotent. Upsert pattern:

\```bash
if curl -s -o /dev/null -w "%{http_code}" \
 https://verification.didit.me/v3/businesses/$VD/ \
 -H "x-api-key: $DIDIT_API_KEY" | grep -q 200; then
curl -X PATCH https://verification.didit.me/v3/businesses/$VD/ \
-H "x-api-key: $DIDIT_API_KEY" -H "Content-Type: application/json" \
-d "$BODY"
else
curl -X POST https://verification.didit.me/v3/businesses/create/ \
-H "x-api-key: $DIDIT_API_KEY" -H "Content-Type: application/json" \
-d "$BODY"
fi
\```

\## Bulk export — paginate the list endpoint

\```bash
PAGE=1
while :; do
RESP=$(curl -sG https://verification.didit.me/v3/businesses/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "page=$PAGE" \
\--data-urlencode "page_size=100")
echo "$RESP" | jq -c '.results[]' >> businesses.ndjson
HAS_NEXT=$(echo "$RESP" | jq -r '.next // empty')
\[ -z "$HAS_NEXT" ] && break
PAGE=$((PAGE+1))
done
\```

Filter with `status`, `country_code`, `search`, date ranges (see /management-api/businesses/list).

\## What survives on update vs what stays

\| Field | Behaviour |
\|---|---|
\| `display_name`, `metadata`, `tags` | Overwritten by PATCH |
\| `legal_name`, `registration_number`, `country_code` | Read-only after a verified KYB session (overrides logged in audit log) |
\| Aggregate counters, `features` map | Computed by Didit — never accept writes |

\## Failure modes

\- `409` on create — `vendor_data` exists; use PATCH.
\- `429` — rate limit; back off using `Retry-After`. Insert 100ms+ between calls for large batches.
\- `400` — bad country code or bad JSON. Log and continue.

\## Console fallback

The Business Console (Businesses → Import / Export) handles up to 100K rows for imports and 1M rows for exports with chunked async processing and an emailed signed download link.

\## Sources of truth

\- /management-api/businesses/create — POST /v3/businesses/create/ schema
\- /management-api/businesses/list — GET /v3/businesses/ pagination
\- /entities/businesses/data-model — mutable vs read-only fields
\- /integration/rate-limiting — rate limits
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

Colar em

O Business Console permite importar e exportar entidades Business em massa. É o mesmo fluxo disponível para usuários, adaptado aos campos de empresa.> [!NOTE]
>
> A importação/exportação em massa descrita aqui apenas cria ou atualiza perfis de empresa. Ela não recria sessões de KYB anteriores, relatórios de registro, diretores, beneficiários finais nem decisões de provedores. Para uma migração completa de KYB a partir de outro provedor ou de uma exportação de registro, consulte [Importar dados de outro provedor](https://docs.didit.me/pt-br/sessions-api/import-verifications.md).## Importar empresas de CSV### Quando usar- **Migração** a partir de outro fornecedor de KYB.
- **Onboarding de parceiros**: carregue a lista de clientes de um parceiro.
- **Preenchimento retroativo de metadados**: atualize tags, nível ou campos personalizados de muitas empresas de uma só vez.### Colunas do modeloBaixe o modelo em *Businesses → Import → Download template*:| Coluna | Obrigatória | Descrição |
| - | - | - |
| `vendor_data` | Sim | Seu identificador da empresa. Único por aplicação. |
| `display_name` | Não | Nome legível. |
| `legal_name` | Não | Razão social da empresa. Será sobrescrito pelos dados de registro verificados. |
| `registration_number` | Não | Número de registro da empresa. Será sobrescrito pelos dados de registro verificados. |
| `country_code` | Não | ISO 3166-1 alpha-3. Aciona a verificação de países de risco. |
| `status` | Não | `ACTIVE`, `FLAGGED` ou `BLOCKED`. O padrão é `ACTIVE`. |
| `tags` | Não | Tags separadas por vírgula. |
| `metadata_json` | Não | JSON em formato de string para metadados personalizados. |### Como executar a importação**1. Envie o CSV***Businesses → Import → Upload CSV*.**2. Revise a pré-visualização**As linhas inválidas ficam destacadas. Duplicatas (`vendor_data` já existente) são sinalizadas como atualizações.**3. Inicie a importação**A Didit processa as linhas de forma assíncrona; o progresso é acompanhado em *Businesses → Import history*.**4. Revise os resultados**Baixe um relatório de erros das linhas ignoradas.### Atualizar ou criar- Novo `vendor_data` → cria uma nova empresa.
- `vendor_data` existente → atualiza os campos editáveis e os metadados da empresa.
- Os campos derivados do registro (`legal_name`, `registration_number`, `country_code`) **não** são sobrescritos por importações depois que uma sessão de Verificação de empresas (KYB) os tiver preenchido.## Exportar empresas para CSV### Quando usar- **Auditorias de conformidade** e solicitações de reguladores.
- **Sincronização com data warehouse** para BI.
- **Relatórios para parceiros**: visões filtradas de empresas por país, nível ou tag.### Como executar uma exportação1) Acesse *Businesses → Export*.
2) Aplique filtros (status, país, intervalo de datas, busca, tags).
3) Escolha as colunas.
4) Envie: a Didit gera a exportação de forma assíncrona e envia por e-mail um link de download assinado.Há restrições por função; consulte [funções e permissões](https://docs.didit.me/pt-br/console/roles-permissions.md).## Trilha de auditoriaTodas as importações e exportações são registradas com o operador, a contagem de linhas e as datas e horas. Consulte [registros de auditoria](https://docs.didit.me/pt-br/console/audit-logs.md).## Próximos passos> [card] [API de criação de empresas](https://docs.didit.me/pt-br/management-api/businesses/create.md)
>
> Criação programática em massa.> [card] [Retenção de dados](https://docs.didit.me/pt-br/console/data-retention.md)
>
> Por quanto tempo os dados importados são mantidos.> [card] [Registros de auditoria](https://docs.didit.me/pt-br/console/audit-logs.md)
>
> Revise o histórico de importações/exportações.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.