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.
Visão geral
As importações em lote permitem enviar arquivos CSV mapeados para campos Güeno usando mapeamentos salvos (mappingId). O hub do dashboard (Importações em lote) usa as mesmas rotas da API.
Prefixo base: todas as rotas abaixo ficam sob /batch-import (por exemplo GET https://api.gu1.ai/batch-import/mappings).
Autenticação
Use a mesma API key Bearer ou sessão do restante da API. As requisições são por organização; osmappingId pertencem apenas à organização atual.
Nome do campo: mappingId (não mapperId)
As importações multipart esperam o campo de formulário mappingId, o UUID retornado ao listar ou criar mapeamentos (GET / POST /batch-import/mappings). Não existe campo mapperId.
“Plataforma” vs CSV personalizado
Não há um único parâmetrotype: custom | platform. O comportamento depende da rota e se você envia mapeamento:
| Cenário | Como funciona |
|---|---|
| Transações — formato nativo | POST /transactions/batch/upload sem mappingId nem columnMapping: o servidor faz parse de CSV / Excel / JSON com o parser nativo. Ver Criar transações em lote. |
| Transações — mapeamento salvo | O mesmo endpoint de upload com mappingId, ou columnMapping como string JSON (apenas CSV). Também disponível como POST /batch-import/import/transactions. |
| Entidades — aba Entidades do hub | POST /entities/automatic/bulk com corpo JSON (items[]); o CSV é interpretado no cliente, não enviado como multipart bruto nessa rota. |
| Entidades — colunas CSV arbitrárias | POST /batch-import/import/entities com file + mappingId (o target deve ser entity_person, entity_company ou entity_mixed). Exige importação em massa automática habilitada na org. |
| Eventos de usuário | POST /batch-import/import/user-events com file + mappingId (target user_event). |
Documentação relacionada
- Índice de endpoints — tabela de rotas; cada operação tem página própria com badge GET/POST na barra lateral (mesmo padrão do restante da API).
- Criar transações em lote — multipart e limites para arquivos de transações.