Skip to main content
POST
Generar cesiones de facturas en lote

¿Para qué se usa?

Permite generar cesiones (AECs) de múltiples facturas en una sola llamada y enviarlas al SII. Se usa cuando quieres ceder varias facturas a un mismo cesionario (por ejemplo una empresa de factoring) de forma automatizada.

Qué hace

  • Genera los archivos electrónicos de cesión (AEC) para cada factura indicada.
  • Obtiene automáticamente los códigos EHDR del SII para cada factura.
  • Permite ceder facturas electrónicas (DTE 33) o exentas (DTE 34) a un cesionario.
  • Envía los AECs al SII después de generarlos.
  • Devuelve URLs presignadas para descargar los archivos AEC desde S3.

Ejemplos de uso

  • Ceder múltiples facturas a una empresa de factoring desde tu integración.
  • Transferir derechos de crédito de un lote de facturas a un cesionario.
  • Automatizar el proceso de cesión con entidades financieras.
  • Generar cesiones masivas para procesos de financiamiento.

Requisitos importantes

Credenciales necesarias

Las cesiones se generan usando la contraseña del SII del representante legal, NO con el certificado digital (excepto para entidades enroladas en el facturador de mercado, que usan el AEC nativo con el certificado de la empresa). La entidad debe tener configurada una credencial SII personal (no credencial de empresa) con:
  • RUT del representante legal
  • Contraseña del SII del representante legal
  • La credencial debe estar en estado VALID

Respuesta asíncrona: 202 + cession_batch_id

Este endpoint no genera las cesiones en el momento de la llamada. Valida el request (400/403/404 si algo es inválido) y encola la generación real en segundo plano, respondiendo de inmediato con 202:
El campo cession_batch_id identifica el lote creado — úsalo para consultar el resultado más tarde con GET /cessions/batches/{id}, que muestra el estado final (completed, failed o partial) y el detalle por documento, incluyendo el mensaje de error real del SII si alguna cesión falló. Esto es importante porque:
  • El SII puede fallar, incluso de forma transitoria, durante la generación del AEC — en ese caso ninguna cesión se crea para ese documento.
  • No existe reintento automático: si un documento falla, hay que volver a intentarlo con una nueva llamada a este endpoint.
  • No asumas éxito por recibir 202 — es solo la confirmación de que la solicitud fue aceptada y encolada, no de que las cesiones se generaron correctamente. Consulta cession_batch_id para confirmar el resultado.

Authorizations

Authorization
string
header
required

API Key para autenticación. Debe proporcionarse en el header Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo 'Api-Key ' seguido de tu API key)

Body

application/json

Datos para generar las cesiones

master_entity_id
integer
required

ID de la entidad maestra emisora de las facturas

Example:

123

document_ids
integer[]
required

Lista de IDs de los documentos (facturas) a ceder

Example:
assignee_rut
string
required

RUT del cesionario (sin puntos ni guión)

Example:

"76798398"

assignee_dv
string
required

Dígito verificador del RUT del cesionario

Example:

"0"

assignee_business_name
string
required

Razón social del cesionario

Example:

"SUPLO SPA"

assignee_address
string
required

Dirección del cesionario

Example:

"Av. Tajamar 183"

assignee_email
string<email>
required

Email del cesionario

Example:

"factoring@suplo.cl"

assignor_email
string<email>

Email del cedente (opcional, se usa el email de la entidad si no se proporciona)

Example:

"antonio@tupana.ai"

Response

Solicitud aceptada y encolada. La generación real de las cesiones corre en segundo plano — este 202 NO confirma que las cesiones se hayan generado exitosamente, solo que la solicitud fue validada y aceptada. Usa cession_batch_id para consultar el resultado final en GET /cessions/batches/{id}.

success
boolean
Example:

true

status
string
Example:

"processing"

ws_channel
string

Canal WebSocket donde se publica el avance en tiempo real (opcional de escuchar)

Example:

"cessions-70193"

total
integer

Cantidad de documentos incluidos en el lote

Example:

2

message
string
Example:

"Generando las cesiones y enviándolas al SII…"

cession_batch_id
string<uuid>

ID del lote creado. Consúltalo con GET /cessions/batches/{id} para conocer el resultado (éxito, fallo o parcial) de cada documento.

Example:

"e7877303-1a03-424d-a024-48c1de218611"