Crear cesiones en lote
Genera cesiones (AECs) de múltiples facturas en una sola llamada. Obtiene automáticamente los códigos EHDR del SII y envía los AECs al SII.
¿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:
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. Consultacession_batch_idpara confirmar el resultado.
Authorizations
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
Datos para generar las cesiones
ID de la entidad maestra emisora de las facturas
123
Lista de IDs de los documentos (facturas) a ceder
RUT del cesionario (sin puntos ni guión)
"76798398"
Dígito verificador del RUT del cesionario
"0"
Razón social del cesionario
"SUPLO SPA"
Dirección del cesionario
"Av. Tajamar 183"
Email del cesionario
"factoring@suplo.cl"
Email del cedente (opcional, se usa el email de la entidad si no se proporciona)
"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}.
true
"processing"
Canal WebSocket donde se publica el avance en tiempo real (opcional de escuchar)
"cessions-70193"
Cantidad de documentos incluidos en el lote
2
"Generando las cesiones y enviándolas al SII…"
ID del lote creado. Consúltalo con GET /cessions/batches/{id} para conocer el resultado (éxito, fallo o parcial) de cada documento.
"e7877303-1a03-424d-a024-48c1de218611"
