Registra terceros

Registra terceros

Antes de registrar consentimientos capturados por un tercero, créalo en Soyio. El registro identifica formalmente a la entidad y guarda el contrato que respalda la captura.

Hay dos caminos: desde el dashboard o vía API.

Desde el dashboard

En Configuración > Terceros del dashboard, crea el tercero con Agregar tercero: completa su nombre, razón social, RUT y tipo, y adjunta el contrato que lo obliga a capturar el consentimiento correctamente.

El tercero queda disponible en la tabla de la sección, con su contrato descargable:

Desde el menú de cada fila puedes editar los datos del tercero o deshabilitarlo cuando termine la relación.

Vía API

Todas las llamadas se autentican con tu API key. Revisa la guía de autenticación para generarla y usarla.

Crea un tercero

El endpoint recibe multipart/form-data, porque el contrato viaja como archivo adjunto:

POST /api/v1/third_parties (multipart/form-data)

{
  "name": "Corredora Andes",
  "legal_name": "Corredora de Seguros Andes SpA",
  "tin": "76.543.210-3",
  "kind": "insurance_broker",
  "external_reference": "corr-001",
  "terms_document": "<archivo: contrato-corredora.pdf>"
}

Campo	Requerido	Descripción
name	Sí	Nombre comercial del tercero
legal_name	Sí	Razón social
tin	Sí	RUT del tercero. Se guarda normalizado (sin puntos, con guión) y debe ser único en tu cuenta
kind	No	Tipo de tercero: insurance_broker, dealer, partner u other (default)
external_reference	No	Identificador del tercero en tus sistemas
terms_document	No	Contrato o términos que obligan al tercero a capturar el consentimiento correctamente. Archivo PDF, JPG o PNG de hasta 5 MB

La respuesta incluye el id del tercero (con prefijo tp_). Úsalo para declarar la procedencia al registrar consentimientos.

Respuesta

{
  "id": "tp_1B2M2Y8AsgTpgAmY7PhCfg",
  "name": "Corredora Andes",
  "legal_name": "Corredora de Seguros Andes SpA",
  "tin": "76543210-3",
  "kind": "insurance_broker",
  "external_reference": "corr-001",
  "status": "active",
  "terms_document_url": "https://files.soyio.id/contrato-corredora.pdf",
  "terms_document_file_name": "contrato-corredora.pdf",
  "created_at": "2026-07-10T15:30:00Z"
}

Adjunta el contrato con el tercero en terms_document. Ante una auditoría, ese contrato es el respaldo de que el tercero estaba obligado a capturar el consentimiento correctamente.

Consulta y actualiza terceros

• GET /api/v1/third_parties lista los terceros de tu cuenta.
• GET /api/v1/third_parties/{id} obtiene un tercero.
• PATCH /api/v1/third_parties/{id} actualiza sus campos, incluido status.

Deshabilita un tercero

Cuando termina la relación con un tercero, deshabilítalo en vez de eliminarlo:

PATCH /api/v1/third_parties/{id}

{
  "status": "disabled"
}

Un tercero deshabilitado no puede ser referenciado en nuevos consentimientos (la API responde 422), pero sus registros históricos y su evidencia se conservan intactos.

Permisos

Los endpoints usan los permisos third_parties.api.read, third_parties.api.write y third_parties.api.manage. Requieren además el módulo de consentimiento de terceros habilitado en tu cuenta; sin él responden 403.