Skip to main content
POST
/
entities
/
{id}
/
report-export
/
email
Informe PDF de entidad por correo
curl --request POST \
  --url http://api.gu1.ai/entities/{id}/report-export/email \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'X-Organization-ID: <x-organization-id>' \
  --data '
{
  "recipientEmails": [
    "<string>"
  ],
  "emailLocale": "<string>",
  "sections": {}
}
'

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.

​
Resumen

Encola de forma asíncrona la generación del PDF de entidad en el servidor y su envío por correo. El PDF usa el mismo flujo jsPDF que la descarga “exportar informe” en la app. Tu integración llama al endpoint con API key; los destinatarios reciben el adjunto (asunto y cuerpo según emailLocale).
La respuesta HTTP es 202 Accepted en cuanto el trabajo queda encolado. La generación y el envío ocurren en segundo plano; si no llega el correo, revisá logs del servidor o contactá a soporte.

​
Endpoint

POST http://api.gu1.ai/entities/{id}/report-export/email

​
Autenticación y tenant

​
Authorization
string
required
Bearer TU_API_KEY — ver Autenticación.
​
X-Organization-ID
string
required
UUID de organización (producción o sandbox) — ver Entornos.

​
Permisos

Requiere el permiso granular entities:export en la API key (igual que POST /entities/{id}/export y GET /entities/{id}/export-data).

​
Parámetros de ruta

​
id
string
required
UUID de la entidad (id devuelto por crear/listar/obtener).

​
Cuerpo JSON

​
recipientEmails
string[]
required
Una o más direcciones de correo (máx. 26 tras deduplicar). El email de la cuenta autenticada se fusiona automáticamente si existe (deduplicado), para que quien solicita pueda recibir copia sin incluirse explícitamente.
​
emailLocale
string
Idioma del correo: en, es o pt. Por defecto en si falta o no es válido.
​
sections
object
required
Boole por sección del informe (misma semántica que el modal de exportación en el panel). Claves opcionales; los valores por defecto coinciden con el validador de la API (generalInfo por defecto true, el resto false si se omiten).Claves: generalInfo, kyc, documents, checks, enrichments, alerts, aiAnalysis, relationships, timeline, riskAnalysis.

​
Ejemplo de cuerpo

{
  "recipientEmails": ["cumplimiento@ejemplo.com"],
  "emailLocale": "es",
  "sections": {
    "generalInfo": true,
    "riskAnalysis": true,
    "enrichments": true,
    "checks": true,
    "alerts": true
  }
}

​
Ejemplo con curl

curl -X POST "http://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000/report-export/email" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "X-Organization-ID: UUID_DE_TU_ORG" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientEmails": ["cumplimiento@ejemplo.com"],
    "emailLocale": "es",
    "sections": {
      "generalInfo": true,
      "riskAnalysis": true,
      "enrichments": true
    }
  }'

​
Respuestas

​
202 Accepted — encolado

{
  "success": true,
  "status": "queued",
  "message": "…"
}
El message se localiza según emailLocale.

​
400 — validación / sin destinatarios

Por ejemplo: recipientEmails vacío (y sin email de usuario), demasiados destinatarios (TOO_MANY_RECIPIENTS), JSON inválido.

​
404 — entidad inexistente u oculta

Mismo criterio que otros endpoints de entidad cuando el ID no pertenece a la org o la visibilidad lo impide.

​
500 — error de servidor

Poco frecuente; payload de error genérico.

​
Endpoints relacionados

  • POST /entities/{id}/export — descarga síncrona del PDF (cuerpo de la respuesta = archivo PDF).
  • GET /entities/{id}/export-data — JSON usado por la exportación en el panel; el PDF por correo arma los mismos datos en servidor.
  • Obtener entidad — GET /entities/{id}.