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

​
Descripción

Content-Type: application/json. Usado por el hub Importaciones masivas → Entidades (/bulk-imports?tab=entities) y por integraciones que ya parsearon filas en JSON. Encola el mismo job que Importar entidades CSV. Requiere entities:bulk_import, entities:create y flag org importación masiva automática.

​
Autenticación

Authorization: Bearer TU_API_KEY

​
Modos (importMode)

ModoDefaultComportamiento
automatic_enrichedSí (si omitís el campo)Datos básicos AR, BR o CL por tax ID + enrichments (autoExecuteIntegrations) + opcional depth
manual_no_enrichmentNo (explícito)Entidad mínima; suggestedName obligatorio en cada ítem; enrichments elegidos vía autoExecuteIntegrations (sin pipeline Nosis/CPF); depth = 0; cualquier ISO2 válido

​
Diferencia con multipart CSV

Este endpoint (JSON)POST /batch-import/import/entities
DefaultAutomáticoManual
Manual + enrichmentsSí (autoExecuteIntegrations)Sí (autoExecuteIntegrations / columnas CSV por fila)
InputJSON items[]CSV multipart

​
Cuerpo (resumen)

CampoObligatorioDescripción
itemsSíArray de filas (taxId, type, …)
importModeNoautomatic_enriched (default) o manual_no_enrichment
countryCondicionalISO2 lote si filas no traen country
riskMatrixPersonId / riskMatrixCompanyIdNoUUID
autoExecuteIntegrationsNo{ executeAllActiveEnrichments, enrichments, enrichmentGroupRefs, excludeEnrichments }
autoExecuteIntegrationsShareholdersNoCon depth > 0
depthNo0–5 (solo automático)
skipRulesExecutionNodefault false
stopOnFirstErrorNodefault false
monitoringNo{ main, relationships? }
reportRecipientEmailsNoHasta 10 emails
emailLocaleNoen / es / pt

​
Por ítem (items[])

CampoDescripción
taxId, typeObligatorios
countryISO2 opcional por fila
suggestedNameObligatorio en manual
gender, email, phone, externalId, attributes, status, riskMatrixId, …Opcionales
Países: automático → AR, BR, CL; manual → cualquier ISO2 válido de plataforma (lote y/o por fila).

​
Límites

Valor
Máx. items por requestDefault 300 (env BULK_AUTOMATIC_ENTITY_MAX_ITEMS; no usa la tabla por plan del CSV)
Supera límite400 TOO_MANY_ITEMS
Para imports CSV grandes (hasta 100.000 filas según plan), usá Importar entidades (CSV). Ver Importaciones masivas — Límites.

​
Ejemplo — automático

{
  "country": "AR",
  "importMode": "automatic_enriched",
  "autoExecuteIntegrations": {
    "executeAllActiveEnrichments": true,
    "enrichments": []
  },
  "items": [
    { "taxId": "20123456789", "type": "company" }
  ]
}

​
Ejemplo — manual con enrichments elegidos

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

​
Respuesta

{
  "success": true,
  "jobId": "bulk-entity-…",
  "totalItems": 1
}

​
Seguimiento

  • GET /entities/automatic/bulk/imports
  • GET /entities/automatic/bulk/imports/{jobId}/failures.csv
Ver también: Importaciones masivas.