Ejemplos por país

🔄 Transferir documento

Las cesiones de facturas son una forma en que las empresas obtienen liquidez de bancos o factorings al transferir la propiedad de sus cuentas por cobrar.

El proceso de la API utiliza el registro del S.I.I. y cumple con las leyes chilenas sobre cesiones.

Transferir una factura emitida en nuestra plataforma

Para transferir la propiedad de un documento, debe utilizar el endpoint /document_transfers con los parámetros correspondientes. Necesitará el document_id para completar la transferencia.

• Endpoint: https://api-billing.koywe.com/V1/document_transfers
• Método: POST
• Cabeceras requeridas:
  • Content-Type: application/json
  • Authorization: Bearer \<token>
  • Accept: /

{
  "account_id": 141,
  "document": {
    "document_id": 2563
  },
  "transfer_information": {
    "date": "2025-04-15T10:00:00Z",
    "transfered_amount": 5000.00,
    "additional_conditions": "Payment due in 30 days after acceptance",
    "digital_certificate_id": "5"
  },
  "transfer_origin": {
    "company_name": "Origin Company",
    "tax_id_code": "11111111-1",
    "tax_id_type": "CL-RUT",
    "country_id": 253,
    "contact_name": "Juan Perez",
    "contact_phone": "999888777",
    "contact_email": "[email protected]",
    "address": "Calle ejemplo 123",
    "city": "Santiago",
    "district": "Providencia",
    "authorized_agent": {
      "first_name": "John",
      "last_name": "Doe",
      "person_tax_id_code": "12345678-5",
      "person_tax_id_type": "CL-RUT",
      "certificate_id": "123"
    }
  },
  "transfer_destination": {
    "company_name": "MI FACTORING SPA",
    "tax_id_code": "22222222-2",
    "tax_id_type": "CL-RUT",
    "contact_name": "Pedro Gomez",
    "contact_phone": "999888777",
    "contact_email": "[email protected]",
    "address": "Calle ejemplo 123",
    "city": "Santiago",
    "district": "Providencia",
    "country_id": 253
  }
}

Respuesta:

{
  "document_transfer": 4562,
  "account_id": 141,
  "document": {
    "document_id": 2563
  },
  "transfer_information": {
    "date": "2025-04-15T10:00:00Z",
    "transfered_amount": 5000.00,
    "additional_conditions": "Payment due in 30 days after acceptance"
  },
  "transfer_origin": {
    "company_name": "Origin Company",
    "tax_id_code": "11111111-1",
    "tax_id_type": "CL-RUT",
    "country_id": 253,
    "contact_name": "Juan Perez",
    "contact_phone": "999888777",
    "contact_email": "[email protected]",
    "address": "Calle ejemplo 123",
    "city": "Santiago",
    "district": "Providencia",
    "authorized_agent": {
      "first_name": "John",
      "last_name": "Doe",
      "person_tax_id_code": "12345678-5",
      "person_tax_id_type": "CL-RUT",
      "certificate_id": "123"
    }
  },
  "transfer_destination": {
    "company_name": "MI FACTORING SPA",
    "tax_id_code": "22222222-2",
    "tax_id_type": "CL-RUT",
    "contact_name": "Pedro Gomez",
    "contact_phone": "999888777",
    "contact_email": "[email protected]",
    "address": "Calle ejemplo 123",
    "city": "Santiago",
    "district": "Providencia",
    "country_id": 253
  },
  "transfer_registry": [
    {
      "registry_entity": "SII",
      "sending_status": "1",
      "sending_datetime": "2025-04-15T10:05:00Z",
      "sending_number": "1234566",
      "validation_status": "1",
      "validation_datetime": "2025-04-15T10:10:00Z",
      "validation_details": "Transfer accepted"
    }
  ]
}

Transferir una factura emitida en otra plataforma

Para transferir la propiedad de un documento, debe utilizar el endpoint /document_transfers con los parámetros correspondientes. Si el documento fue emitido en otra plataforma, necesitará toda la información del documento, incluido el XML.

En la respuesta, obtendrá un document_id, por lo que el documento será creado en la plataforma para controlar las nuevas operaciones sobre este documento.

• Endpoint: https://api-billing.koywe.com/V1/document_transfers
• Método: POST
• Cabeceras requeridas:
• Content-Type: application/json
• Authorization: Bearer \<token>
• Accept: /

{
  "account_id": 141,
  "document": {
    "document_information": {
      "xml": "HffejCwogjaff....",
      "pdf": "AkroC05FGAffg....",
      "document_type_id": 2,
      "document_number": 23455,
      "issuer_tax_id_code": "11111111-1",
      "issuer_tax_id_type": "CL-RUT",
      "receiver_tax_id_code": "44444444-4",
      "receiver_tax_id_type": "CL-RUT",
      "issue_date": "2025-05-01",
      "due_date": "2025-06-01",
      "total_amount": 50000,
      "currency_id": 39
    }
  },
  "transfer_information": {
    "date": "2025-04-15T10:00:00Z",
    "transfered_amount": 5000.00,
    "additional_conditions": "Payment due in 30 days after acceptance",
    "digital_certificate": "5"
  },
  "transfer_origin": {
    "company_name": "Origin Company",
    "tax_id_code": "11111111-1",
    "tax_id_type": "CL-RUT",
    "country_id": 253,
    "contact_name": "Juan Perez",
    "contact_phone": "999888777",
    "contact_email": "[email protected]",
    "address": "Calle ejemplo 123",
    "city": "Santiago",
    "district": "Providencia",
    "authorized_agent": {
      "first_name": "John",
      "last_name": "Doe",
      "person_tax_id_code": "12345678-5",
      "person_tax_id_type": "CL-RUT",
      "certificate_id": "123"
    }
  },
  "transfer_destination": {
    "company_name": "MI FACTORING SPA",
    "tax_id_code": "22222222-2",
    "tax_id_type": "CL-RUT",
    "contact_name": "Pedro Gomez",
    "contact_phone": "999888777",
    "contact_email": "[email protected]",
    "address": "Calle ejemplo 123",
    "city": "Santiago",
    "district": "Providencia",
    "country_id": 253
  }
}

Respuesta:

{
  "document_transfer": 4562,
  "account_id": 141,
  "document": {
    "document_id": 2563
  },
  "transfer_information": {
    "date": "2025-04-15T10:00:00Z",
    "transfered_amount": 5000.00,
    "additional_conditions": "Payment due in 30 days after acceptance"
  },
  "transfer_origin": {
    "company_name": "Origin Company",
    "tax_id_code": "11111111-1",
    "tax_id_type": "CL-RUT",
    "country_id": 253,
    "contact_name": "Juan Perez",
    "contact_phone": "999888777",
    "contact_email": "[email protected]",
    "address": "Calle ejemplo 123",
    "city": "Santiago",
    "district": "Providencia",
    "authorized_agent": {
      "first_name": "John",
      "last_name": "Doe",
      "person_tax_id_code": "12345678-5",
      "person_tax_id_type": "CL-RUT",
      "certificate_id": "123"
    }
  },
  "transfer_destination": {
    "company_name": "MI FACTORING SPA",
    "tax_id_code": "22222222-2",
    "tax_id_type": "CL-RUT",
    "contact_name": "Pedro Gomez",
    "contact_phone": "999888777",
    "contact_email": "[email protected]",
    "address": "Calle ejemplo 123",
    "city": "Santiago",
    "district": "Providencia",
    "country_id": 253
  },
  "transfer_registry": [
    {
      "registry_entity": "SII",
      "sending_status": "1",
      "sending_datetime": "2025-04-15T10:05:00Z",
      "sending_number": "1234566",
      "validation_status": "1",
      "validation_datetime": "2025-04-15T10:10:00Z",
      "validation_details": "Transfer accepted"
    }
  ]
}

Contenido XML

Al enviar el xml, el contenido DEBE ser la parte DTE del documento, NO el SobreDTE. Además, el DTE debe tener una de las siguientes estructuras canónicas. Agregar otros parámetros, espacios o cambiar el orden de los parámetros resultará en el rechazo de la transferencia por esquema:

...

...

...

El contenido xml DEBE SER EXACTAMENTE el mismo que el documento enviado al SII cuando fue emitido. Cualquier espacio extra, cambio de codificación u otras modificaciones resultarán en el rechazo por parte del SII.

sending_status

El sending_status puede tener los siguientes valores:

Valor	Nombre del estado	Descripción
-3	Error externo	No fue posible completar el envío del AEC al SII debido a problemas de análisis u otras razones no relacionadas con el SII
-2	No procesado	El envío del AEC se completó, estamos esperando que el SII complete la validación
-1	Error SII	El SII respondió la solicitud de estado de validación con un error temporal como "Servidor ocupado" u otro; estamos reintentando
0	Rechazado	El SII rechazó la transferencia del documento. Verifique "validation_details" para más información
1	Aprobado	El SII aprobó la transferencia del documento. No se requiere ninguna acción adicional.

Referencia de API POST /document_transfers

Documentación detallada del endpoint: /english/billing/api-reference/billing-api/document-transfers/initiate-a-document-transfer-process