Skip to main content
POST
/
cessions
/
batch
Generar cesiones de facturas en lote
curl --request POST \
  --url https://api.tupana.ai/v1/cessions/batch \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "master_entity_id": 123,
  "document_ids": [
    858405,
    858406
  ],
  "assignee_rut": "76798398",
  "assignee_dv": "0",
  "assignee_business_name": "SUPLO SPA",
  "assignee_address": "Av. Tajamar 183",
  "assignee_email": "[email protected]",
  "assignor_email": "[email protected]"
}
'
{
  "success": true,
  "message": "2 assignment(s) generated successfully",
  "cessions": [
    {
      "cession_id": 133,
      "document_id": 858405,
      "folio": 12345,
      "file_name": "AEC_12345.xml",
      "presigned_url": "https://s3.amazonaws.com/bucket/AEC_12345.xml?signature=..."
    },
    {
      "cession_id": 134,
      "document_id": 858406,
      "folio": 12346,
      "file_name": "AEC_12346.xml",
      "presigned_url": "https://s3.amazonaws.com/bucket/AEC_12346.xml?signature=..."
    }
  ],
  "aec_results": [
    {
      "folio": 12345,
      "sii_identifier": "AEC-2024-001234",
      "sii_file_name": "AEC_12345.xml",
      "status": "sent_to_sii"
    },
    {
      "folio": 12346,
      "sii_identifier": "AEC-2024-001235",
      "sii_file_name": "AEC_12346.xml",
      "status": "sent_to_sii"
    }
  ],
  "errors": null,
  "total_processed": 2,
  "total_errors": 0,
  "aec_sent": 2
}

​
¿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. 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

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:
[858405, 858406]
​
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:

"[email protected]"

​
assignor_email
string<email>

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

Example:

"[email protected]"

Response

Cesiones generadas exitosamente

​
success
boolean
Example:

true

​
message
string
Example:

"2 assignment(s) generated successfully"

​
cessions
object[]
​
aec_results
object[]

Resultados del envío de AECs al SII

​
errors
object[]
​
total_processed
integer
Example:

2

​
total_errors
integer
Example:

0

​
aec_sent
integer

Número de AECs enviados exitosamente al SII

Example:

2