Skip to main content
POST
/
entities
/
automatic
/
bulk
Import bulk entidades (JSON)
curl --request POST \
  --url http://api.gu1.ai/entities/automatic/bulk \
  --header 'Authorization: Bearer <token>'

Documentation Index

Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

POST https://api.gu1.ai/entities/automatic/bulk

​
Visão geral

Content-Type: application/json. Usado pelo hub Importações em lote → Entidades e integrações com linhas já em JSON. Mesmo job que Importar entidades (CSV). Exige entities:bulk_import, entities:create e importação em massa automática habilitada na org.

​
Modos (importMode)

ModoPadrãoComportamento
automatic_enrichedSimDados básicos AR, BR ou CL + enrichments + depth opcional
manual_no_enrichmentNãoEntidade mínima; suggestedName obrigatório; enrichments via autoExecuteIntegrations (sem Nosis/CPF)

​
vs multipart CSV

JSON (esta página)POST /batch-import/import/entities
PadrãoAutomáticoManual
Manual + enrichmentsSimSim (autoExecuteIntegrations / colunas CSV por linha)
Países: automático → AR, BR, CL; manual → qualquer ISO2 válido (lote e/ou por linha).

​
Limites

Valor
Máx. items por requestPadrão 300 (env BULK_AUTOMATIC_ENTITY_MAX_ITEMS)
Acima do limite400 TOO_MANY_ITEMS
Para CSV grande (até 100.000 linhas conforme plano), use Importar entidades (CSV).

​
Exemplo — automático

{
  "country": "AR",
  "items": [{ "taxId": "20123456789", "type": "company" }]
}

​
Exemplo — manual

{
  "country": "AR",
  "importMode": "manual_no_enrichment",
  "autoExecuteIntegrations": {
    "executeAllActiveEnrichments": false,
    "enrichments": ["some_enrichment_code"]
  },
  "items": [
    {
      "taxId": "20123456789",
      "type": "company",
      "suggestedName": "Empresa Demo SA"
    }
  ]
}

​
Acompanhamento

  • GET /entities/automatic/bulk/imports
  • GET /entities/automatic/bulk/imports/{jobId}/failures.csv
Ver também: Importações em lote.