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.
Descripción general
Las importaciones masivas permiten subir archivos CSV mapeados a campos Güeno mediante mapeos guardados (mappingId). El hub del dashboard (Importaciones masivas) usa las mismas rutas que las integraciones por API.
Prefijo base: todas las rutas indicadas más abajo van bajo /batch-import (por ejemplo GET https://api.gu1.ai/batch-import/mappings).
Autenticación
Usá la misma API key Bearer o sesión que en el resto de la API. Las peticiones están acotadas a la organización; los valoresmappingId pertenecen solo a la organización actual.
Nombre del campo: mappingId (no mapperId)
Las importaciones multipart esperan el campo de formulario mappingId, el UUID que devuelve listar o crear mapeos (GET / POST /batch-import/mappings). No existe el campo mapperId.
“Plataforma” vs CSV personalizado
No hay un único parámetrotype: custom | platform. El comportamiento depende de la ruta y de si enviás mapeo:
| Escenario | Cómo funciona |
|---|---|
| Transacciones — formato nativo de archivo | POST /transactions/batch/upload sin mappingId ni columnMapping: el servidor parsea CSV / Excel / JSON con el parser integrado. Ver Crear transacciones batch. |
| Transacciones — mapeo guardado | El mismo endpoint de upload con mappingId, o columnMapping como string JSON (solo CSV). También disponible como POST /batch-import/import/transactions. |
| Entidades — pestaña Entidades del hub | POST /entities/automatic/bulk con cuerpo JSON (items[]); el CSV se parsea en el cliente, no se envía como multipart crudo a esa ruta. |
| Entidades — columnas CSV arbitrarias | POST /batch-import/import/entities con file + mappingId (el target del mapeo debe ser entity_person, entity_company o entity_mixed). Requiere que la org tenga habilitada la importación masiva automática de entidades. |
| Eventos de usuario | POST /batch-import/import/user-events con file + mappingId (target user_event). |
Documentación relacionada
- Índice de endpoints — tabla de rutas; cada operación tiene página propia con badge GET/POST en la barra lateral (igual que el resto de la referencia API).
- Crear transacciones batch — multipart y límites para archivos de transacciones.