Ceder facturas electrónicas (factoring) por API

​

Antes de empezar

• Las facturas a ceder deben ser DTE 33 o 34, emitidas por la empresa que cede.
• La empresa necesita una conexión del SII del representante legal (RUT y clave personal) en estado válido. Las empresas que emiten con el facturador de mercado de Tupana ceden con el certificado de la empresa.
• Los ids de los documentos (docu_…), que obtienes con Listar documentos.

​

1. Crea el lote de cesión

curl -X POST https://api.tupana.ai/v2/cessions/batch/ \
  -H "Authorization: Api-Key $TUPANA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "master_entity_id": "ment_4829301923847",
    "document_ids": ["docu_9f2a7c1b8e4d0", "docu_3b7e1a9c2f5d8"],
    "assignee_rut": "76798398",
    "assignee_dv": "0",
    "assignee_business_name": "FACTORING EJEMPLO SPA",
    "assignee_address": "Av. Apoquindo 1000",
    "assignee_email": "operaciones@factoring.cl",
    "assignor_email": "finanzas@miempresa.cl"
  }'

{
  "success": true,
  "status": "processing",
  "total": 2,
  "message": "Generando las cesiones y enviándolas al SII…",
  "cession_batch_id": "e7877303-1a03-424d-a024-48c1de218611"
}

​

2. Consulta el estado del lote

curl https://api.tupana.ai/v2/cessions/batch/e7877303-1a03-424d-a024-48c1de218611/ \
  -H "Authorization: Api-Key $TUPANA_API_KEY"

​

3. Descarga el certificado

​

Errores frecuentes

• Credencial no válida o de empresa: la cesión en el portal del SII requiere la clave personal del representante legal.
• La factura no cumple los requisitos de cesión del SII (por ejemplo, ya fue cedida o está fuera de plazo): el detalle viene en error_message.
• Errores transitorios del SII: vuelve a crear un lote solo con las facturas que fallaron.

​

Relacionado

• Introducción a Cesiones
• Recibir avisos de estado: document.trace_updated avisa cambios en la traza del SII