Ejemplos por país

➕ Crear documentos

Colección de Postman

Para ayudarle con su integración, descargue nuestra Colección de Postman aquí: https://github.com/koyweforest/api-billing-postman

Para facilitar las pruebas, puede utilizar la siguiente información al emitir documentos:

account_id	RUT	legal_name	activity	postalcode
423	76399932-7

Factura electrónica

Para crear una nueva factura chilena, debe utilizar el endpoint /documents con los parámetros correspondientes.

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

{
  "header": {
    "account_id": 423,
    "document_type_id": "2",
    "received_issued_flag": 1,
    "issue_date": "2025-01-07",
    "issuer_tax_id_code": "76399932-7",
    "issuer_tax_id_type": "CL-RUT",
    "issuer_legal_name": "<string>",
    "issuer_address": "<string>",
    "issuer_district": "<string>",
    "issuer_city": "<string>",
    "issuer_country_id": "253",
    "issuer_phone": "<string>",
    "issuer_activity": "<string>",
    "receiver_tax_id_code": "76399932-7",
    "receiver_tax_id_type": "CL-RUT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "<string>",
    "receiver_district": "<string>",
    "receiver_city": "<string>",
    "receiver_country_id": "253",
    "receiver_phone": "<string>",
    "receiver_activity": "<string>",
    "payment_conditions": "0",
    "currency_id": 39

  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba Koywe",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 266,
      "modifier_percentage": 0,
      "total_amount_line": 1624,
      "taxes": [
        {
          "tax_type_id": "387",
          "tax_percentage": 19,
          "tax_amount": 266
        }
      ]
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 266,
    "total_amount": 1666
  }
}

Factura electrónica con copia cedible

Para crear una factura electrónica chilena y recibir el PDF de la copia cedible en la respuesta, utilice el endpoint /documents con options.pdf_transfer_copy: 1. La respuesta incluirá en electronic_document el campo document_transfer_copy_pdf (base64).

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

{
  "options": {
    "pdf_transfer_copy": 1
  },
  "header": {
    "account_id": 423,
    "document_type_id": "2",
    "received_issued_flag": 1,
    "issue_date": "2025-01-07",
    "issuer_tax_id_code": "76399932-7",
    "issuer_tax_id_type": "CL-RUT",
    "issuer_legal_name": "Laura",
    "issuer_address": "Gregorio",
    "issuer_district": "Centro",
    "issuer_city": "Santiadfo",
    "issuer_country_id": "253",
    "issuer_phone": "442020550",
    "issuer_activity": "Venta",
    "receiver_tax_id_code": "76399932-7",
    "receiver_tax_id_type": "CL-RUT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "Camacho",
    "receiver_district": "Superior",
    "receiver_city": "Iquique",
    "receiver_country_id": "253",
    "receiver_phone": "442020551",
    "receiver_activity": "Venta Mayor",
    "payment_conditions": "0",
    "currency_id": 39
  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba Koywe",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 266,
      "modifier_percentage": 0,
      "total_amount_line": 1624,
      "taxes": [
        {
          "tax_type_id": "387",
          "tax_percentage": 19,
          "tax_amount": 266
        }
      ]
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 266,
    "total_amount": 1666
  }
}

Factura electrónica con referencia a documento no tributario

Para crear una nueva factura chilena con referencia, debe utilizar el endpoint /documents con los parámetros correspondientes.

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

{
  "header": {
    "account_id": 423,
    "document_type_id": "2",
    "received_issued_flag": 1,
    "issue_date": "2025-01-07",
    "issuer_tax_id_code": "76399932-7",
    "issuer_tax_id_type": "CL-RUT",
    "issuer_legal_name": "<string>",
    "issuer_address": "<string>",
    "issuer_district": "<string>",
    "issuer_city": "<string>",
    "issuer_country_id": "253",
    "issuer_phone": "<string>",
    "issuer_activity": "<string>",
    "receiver_tax_id_code": "76399932-7",
    "receiver_tax_id_type": "CL-RUT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "<string>",
    "receiver_district": "<string>",
    "receiver_city": "<string>",
    "receiver_country_id": "253",
    "receiver_phone": "<string>",
    "receiver_activity": "<string>",
    "payment_conditions": "0",
    "currency_id": 39

  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba Koywe",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 266,
      "modifier_percentage": 0,
      "total_amount_line": 1624,
      "taxes": [
        {
          "tax_type_id": "387",
          "tax_percentage": 19,
          "tax_amount": 266
        }
      ]
    }
  ],
  "references": [
    {
        "reference_code": 5,
        "reference_type": 801,
        "reference_number": 22548,
        "description": "Orden de compra",
        "reference_date": "2025-01-05"
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 266,
    "total_amount": 1666
  }
}

Factura de compra electrónica

Para crear una nueva factura de compra chilena, debe utilizar el endpoint /documents con los parámetros correspondientes.

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

{
    "header": {
        "account_id": 423,
        "document_type_id": "31",
        "issue_date": "2025-01-07",
        "payment_conditions": "0",
        "currency_id": 39,
        "receiver_legal_name": "GOOGLE LLC",
        "receiver_tax_id_code": "59224080-7",
        "receiver_tax_id_type": "CL-RUT",
        "receiver_address": "1600 Amphitheatre Pkwy, Mountain View, CA, 94043-1351",
        "receiver_district": "Mountain View",
        "receiver_city": "California",
        "receiver_country_id": "253",
        "receiver_activity": "Servicios Digitales"
    },
    "details": [
        {
            "quantity": 1,
            "line_description": "servicio ads",
            "unit_price": 1500,
            "unit_measure": "UN",
            "modifier_amount": -100,
            "total_amount_line": 1666,
            "total_taxes": 266,
            "taxes": [
                {
                    "tax_type_id": 387,
                    "tax_percentage": 19,
                    "tax_amount": 266
                }
            ]
        }
    ],
    "totals": {
        "net_amount": 1400,
        "taxes_amount": 266,
        "total_amount": 1666
    }
}

Factura electrónica exenta

Para crear una nueva factura chilena exenta de IVA, debe utilizar el endpoint /documents con los parámetros correspondientes.

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

{
  "header": {
    "account_id": 141,
    "document_type_id": "32",

    "received_issued_flag": 1,
    "issue_date": "2025-01-07",
    "issuer_tax_id_code": "76399932-7",
    "issuer_tax_id_type": "CL-RUT",
    "issuer_legal_name": "<string>",
    "issuer_address": "<string>",
    "issuer_district": "<string>",
    "issuer_city": "<string>",
    "issuer_country_id": "253",
    "issuer_phone": "<string>",
    "issuer_activity": "<string>",
    "receiver_tax_id_code": "76399932-7",
    "receiver_tax_id_type": "CL-RUT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "<string>",
    "receiver_district": "<string>",
    "receiver_city": "<string>",
    "receiver_country_id": "253",
    "receiver_phone": "<string>",
    "receiver_activity": "<string>",
    "payment_conditions": "0",
    "currency_id": 39

  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba Koywe",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 0,
      "modifier_percentage": 0,
      "total_amount_line": 1400
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 0,
    "total_amount": 1400
  }
}

Boleta electrónica

Los parámetros del receptor son opcionales para la boleta electrónica. Puede incluirlos para crear una boleta nominativa o no incluirlos para generar una boleta regular (no nominativa).

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

{
  "header": {
    "account_id": 423,
    "document_type_id": "37",

    "received_issued_flag": 1,
    "issue_date": "2025-01-07",
    "issuer_tax_id_code": "76399932-7",
    "issuer_tax_id_type": "CL-RUT",
    "issuer_legal_name": "<string>",
    "issuer_address": "<string>",
    "issuer_district": "<string>",
    "issuer_city": "<string>",
    "issuer_country_id": "253",
    "issuer_phone": "<string>",
    "issuer_activity": "<string>",
    "receiver_tax_id_code": "76399932-7",
    "receiver_tax_id_type": "CL-RUT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "<string>",
    "receiver_district": "<string>",
    "receiver_city": "<string>",
    "receiver_country_id": "253",
    "receiver_phone": "<string>",
    "receiver_activity": "<string>",
    "payment_conditions": "0",
    "currency_id": 39

  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba Koywe",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 266,
      "modifier_percentage": 0,
      "total_amount_line": 1666,
      "taxes": [
        {
          "tax_type_id": "387",
          "tax_percentage": 19,
          "tax_amount": 266
        }
      ]
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 266,
    "total_amount": 1666
  }
}

Boleta electrónica exenta

Los parámetros del receptor son opcionales para la boleta electrónica exenta de IVA. Puede incluirlos para crear una boleta nominativa o no incluirlos para generar una boleta regular (no nominativa).

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

{
  "header": {
    "account_id": 141,
    "document_type_id": "41",

    "received_issued_flag": 1,
    "issue_date": "2025-01-07",
    "issuer_tax_id_code": "76399932-7",
    "issuer_tax_id_type": "CL-RUT",
    "issuer_legal_name": "<string>",
    "issuer_address": "<string>",
    "issuer_district": "<string>",
    "issuer_city": "<string>",
    "issuer_country_id": "253",
    "issuer_phone": "<string>",
    "issuer_activity": "<string>",
    "receiver_tax_id_code": "76399932-7",
    "receiver_tax_id_type": "CL-RUT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "<string>",
    "receiver_district": "<string>",
    "receiver_city": "<string>",
    "receiver_country_id": "253",
    "receiver_phone": "<string>",
    "receiver_activity": "<string>",
    "payment_conditions": "0",
    "currency_id": 39

  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba Koywe",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 0,
      "modifier_percentage": 0,
      "total_amount_line": 1400
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 0,
    "total_amount": 1400
  }
}

Nota de crédito con referencia de reference_number

Los parámetros del receptor son obligatorios para la nota de crédito. Si está anulando una boleta electrónica y no tiene información nominativa, puede usar el RUT genérico 66666666-6.

Use reference_number (document_number) para referenciar el documento que está anulando.

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

{
  "header": {
    "account_id": 423,
    "document_type_id": "16",
    "received_issued_flag": 1,
    "issue_date": "2025-01-07",
    "issuer_tax_id_code": "76399932-7",
    "issuer_tax_id_type": "CL-RUT",
    "issuer_legal_name": "<string>",
    "issuer_address": "<string>",
    "issuer_district": "<string>",
    "issuer_city": "<string>",
    "issuer_country_id": "253",
    "issuer_phone": "<string>",
    "issuer_activity": "<string>",
    "receiver_tax_id_code": "76399932-7",
    "receiver_tax_id_type": "CL-RUT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "<string>",
    "receiver_district": "<string>",
    "receiver_city": "<string>",
    "receiver_country_id": "253",
    "receiver_phone": "<string>",
    "receiver_activity": "<string>",
    "payment_conditions": "0",
    "currency_id": 39
  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba ROW",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 266,
      "modifier_percentage": 0,
      "total_amount_line": 1624,
      "taxes": [
        {
          "tax_type_id": "387",
          "tax_percentage": 19,
          "tax_amount": 266
        }
      ]
    }
  ],
   "references": [
    {
        "document_type_id": 2,
        "reference_number": "1712",
        "reference_code": 1,
        "description": "Anulacion",
        "reference_date": "2025-01-07"
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 266,
    "total_amount": 1666
  }
}

Nota de crédito con referencia de reference_document_id

Los parámetros del receptor son obligatorios para la nota de crédito. Si está anulando una boleta electrónica y no tiene información nominativa, puede usar el RUT genérico 66666666-6.

Use reference_document_id (document_id) para referenciar el documento que está anulando.

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

{
  "header": {
    "account_id": 423,
    "document_type_id": "16",
    "received_issued_flag": 1,
    "issue_date": "2025-01-07",
    "issuer_tax_id_code": "76399932-7",
    "issuer_tax_id_type": "CL-RUT",
    "issuer_legal_name": "<string>",
    "issuer_address": "<string>",
    "issuer_district": "<string>",
    "issuer_city": "<string>",
    "issuer_country_id": "253",
    "issuer_phone": "<string>",
    "issuer_activity": "<string>",
    "receiver_tax_id_code": "76399932-7",
    "receiver_tax_id_type": "CL-RUT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "<string>",
    "receiver_district": "<string>",
    "receiver_city": "<string>",
    "receiver_country_id": "253",
    "receiver_phone": "<string>",
    "receiver_activity": "<string>",
    "payment_conditions": "0",
    "currency_id": 39
  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba ROW",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 266,
      "modifier_percentage": 0,
      "total_amount_line": 1666,
      "taxes": [
        {
          "tax_type_id": "387",
          "tax_percentage": 19,
          "tax_amount": 266
        }
      ]
   "references": [
    {
        "document_type_id": 2,
        "reference_document_id": 1542,
        "reference_code": 1,
        "description": "Anulacion",
        "reference_date": "2025-01-07"
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 266,
    "total_amount": 1666
  }
}

Nota de débito con referencia de reference_number

Los parámetros del receptor son obligatorios para la nota de débito. Si está anulando una nota de crédito y no tiene información nominativa, puede usar el RUT genérico 66666666-6.

Use reference_number (document_number) para referenciar el documento que está anulando.

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

{
  "header": {
    "account_id": 423,
    "document_type_id": "17",
    "received_issued_flag": 1,
    "issue_date": "2025-01-07",
    "issuer_tax_id_code": "76399932-7",
    "issuer_tax_id_type": "CL-RUT",
    "issuer_legal_name": "<string>",
    "issuer_address": "<string>",
    "issuer_district": "<string>",
    "issuer_city": "<string>",
    "issuer_country_id": "253",
    "issuer_phone": "<string>",
    "issuer_activity": "<string>",
    "receiver_tax_id_code": "76399932-7",
    "receiver_tax_id_type": "CL-RUT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "<string>",
    "receiver_district": "<string>",
    "receiver_city": "<string>",
    "receiver_country_id": "253",
    "receiver_phone": "<string>",
    "receiver_activity": "<string>",
    "payment_conditions": "0",
    "currency_id": 39
  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba ROW",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 266,
      "modifier_percentage": 0,
      "total_amount_line": 1666,
      "taxes": [
        {
          "tax_type_id": "387",
          "tax_percentage": 19,
          "tax_amount": 266
        }
      ]
    }
  ],
   "references": [
    {
        "document_type_id": 16,
        "reference_number": "1815",
        "reference_code": 1,
        "description": "Anulacion",
        "reference_date": "2025-01-07"
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 266,
    "total_amount": 1666
  }
}

Nota de débito con referencia de reference_document_id

Los parámetros del receptor son obligatorios para la nota de débito. Si está anulando una nota de crédito y no tiene información nominativa, puede usar el RUT genérico 66666666-6.

Use reference_document_id (document_id) para referenciar el documento que está anulando.

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

{
  "header": {
    "account_id": 423,
    "document_type_id": "17",
    "received_issued_flag": 1,
    "issue_date": "2025-01-07",
    "issuer_tax_id_code": "76399932-7",
    "issuer_tax_id_type": "CL-RUT",
    "issuer_legal_name": "<string>",
    "issuer_address": "<string>",
    "issuer_district": "<string>",
    "issuer_city": "<string>",
    "issuer_country_id": "253",
    "issuer_phone": "<string>",
    "issuer_activity": "<string>",
    "receiver_tax_id_code": "76399932-7",
    "receiver_tax_id_type": "CL-RUT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "<string>",
    "receiver_district": "<string>",
    "receiver_city": "<string>",
    "receiver_country_id": "253",
    "receiver_phone": "<string>",
    "receiver_activity": "<string>",
    "payment_conditions": "0",
    "currency_id": 39
  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba ROW",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 266,
      "modifier_percentage": 0,
     "total_amount_line": 1666,
      "taxes": [
        {
          "tax_type_id": "387",
          "tax_percentage": 19,
          "tax_amount": 266
        }
      ]
    }
  ],
   "references": [
    {
        "document_type_id": 16,
        "reference_document_id": 1542,
        "reference_code": 1,
        "description": "Anulacion",
        "reference_date": "2025-01-07"
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 266,
    "total_amount": 1666
  }
}

Guía de despacho

Las guías de despacho se utilizan junto con las facturas al mover inventario dentro de las bodegas de la misma empresa, o hacia/desde una dirección de cliente.

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

{
  "header": {
    "account_id": 423,
    "document_type_id": "54",
    "received_issued_flag": 1,
    "issue_date": "2025-03-04",
    "receiver_tax_id_code": "76399932-7",
    "receiver_tax_id_type": "CL-RUT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "Av providencia 1456",
    "receiver_district": "Providencia",
    "receiver_city": "Santiago",
    "receiver_country_id": "253",
    "receiver_phone": "<string>",
    "receiver_activity": "Venta insumos",
    "payment_conditions": "0",
    "currency_id": 39,
    "guide_type": 1,
    "transfer_type": 1

  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba Koywe",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 266,
      "modifier_percentage": 0,
      "total_amount_line": 1624,
      "taxes": [
        {
          "tax_type_id": "387",
          "tax_percentage": 19,
          "tax_amount": 266
        }
      ]
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 266,
    "total_amount": 1666
  }
}

Factura de exportación

Cuando vende a otros países, en Chile está obligado a emitir una factura de exportación. El formato es similar pero también permite campos adicionales.

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

{
  "header": {
    "account_id": 423,
    "document_type_id": "46",
    "received_issued_flag": 1,
    "issue_date": "2025-03-04",
    "receiver_tax_id_code": "222333444",
    "receiver_tax_id_type": "MX-RFC",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "Av providencia 1456",
    "receiver_district": "Providencia",
    "receiver_city": "Santiago",
    "receiver_country_id": "80",
    "receiver_phone": "<string>",
    "receiver_activity": "Venta insumos",
    "payment_conditions": "0",
    "exchange_rate_value": 934.58,
    "currency_id": 5,
    "sale_modality": 1,
    "sale_clause": 1
  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba Koywe",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 0,
      "modifier_percentage": 0,
      "total_amount_line": 1400,
      "taxes": [
      ]
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 0,
    "total_amount": 1400
  }
}

Nota de crédito de exportación

Si desea anular una factura de exportación, debe utilizar este tipo especial de documento.

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

{
  "header": {
    "account_id": 423,
    "document_type_id": "48",
    "received_issued_flag": 1,
    "issue_date": "2025-03-04",
    "receiver_tax_id_code": "222333444",
    "receiver_tax_id_type": "MX-RFC",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "Av providencia 1456",
    "receiver_district": "Providencia",
    "receiver_city": "Santiago",
    "receiver_country_id": "80",
    "receiver_phone": "<string>",
    "receiver_activity": "Venta insumos",
    "payment_conditions": "0",
    "exchange_rate_value": 934.58,
    "currency_id": 5,
    "sale_modality": 1,
    "sale_clause": 1
  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba Koywe",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 0,
      "modifier_percentage": 0,
      "total_amount_line": 1400,
      "taxes": [
      ]
    }
  ],
  "references": [
    {
        "document_type_id": 46,
        "reference_number": "139",
        "reference_code": 1,
        "description": "Anulacion",
        "reference_date": "2025-03-04"
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 0,
    "total_amount": 1400
  }
}

Nota de débito de exportación

Si desea anular una factura de exportación, debe utilizar este tipo especial de documento.

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

{
  "header": {
    "account_id": 423,
    "document_type_id": "47",
    "received_issued_flag": 1,
    "issue_date": "2025-03-04",
    "receiver_tax_id_code": "222333444",
    "receiver_tax_id_type": "MX-RFC",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "Av providencia 1456",
    "receiver_district": "Providencia",
    "receiver_city": "Santiago",
    "receiver_country_id": "80",
    "receiver_phone": "<string>",
    "receiver_activity": "Venta insumos",
    "payment_conditions": "0",
    "exchange_rate_value": 934.58,
    "currency_id": 5,
    "sale_modality": 1,
    "sale_clause": 1
  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba Koywe",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 0,
      "modifier_percentage": 0,
      "total_amount_line": 1400,
      "taxes": [
      ]
    }
  ],
  "references": [
    {
        "document_type_id": 46,
        "reference_number": "139",
        "reference_code": 1,
        "description": "csmbio vslor",
        "reference_date": "2025-03-04"
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 0,
    "total_amount": 1400
  }
}

Factura electrónica con modo Borrador y Vista previa

Para crear una nueva factura chilena con modo Borrador y Vista previa, debe utilizar el endpoint /documents con los parámetros correspondientes y el modo draft_only/draft_preview.

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

{
  "options": {
    "draft_only":1,
    "draft_preview": 1
    },
  "header": {
    "account_id": 423,
    "document_type_id": "2",
    "received_issued_flag": 1,
    "issue_date": "2025-01-07",
    "issuer_tax_id_code": "76399932-7",
    "issuer_tax_id_type": "CL-RUT",
    "issuer_legal_name": "<string>",
    "issuer_address": "<string>",
    "issuer_district": "<string>",
    "issuer_city": "<string>",
    "issuer_country_id": "253",
    "issuer_phone": "<string>",
    "issuer_activity": "<string>",
    "receiver_tax_id_code": "76399932-7",
    "receiver_tax_id_type": "CL-RUT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "<string>",
    "receiver_district": "<string>",
    "receiver_city": "<string>",
    "receiver_country_id": "253",
    "receiver_phone": "<string>",
    "receiver_activity": "<string>",
    "payment_conditions": "0",
    "currency_id": 39

  },
  "details": [
    {
      "quantity": 1,
      "sku": "aa111",
      "line_description": "Prueba Koywe",
      "unit_measure": "UN",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 266,
      "modifier_percentage": 0,
      "total_amount_line": 1624,
      "taxes": [
        {
          "tax_type_id": "387",
          "tax_percentage": 19,
          "tax_amount": 266
        }
      ]
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 266,
    "total_amount": 1666
  }
}

Estado de respuesta en el resultado de la API Rest

status	descripción
0	El borrador fue creado exitosamente, firmado y enviado al SII correctamente.
1	Hay errores en la entrada, por lo que el borrador no fue generado ni enviado al SII. Los detalles del error estarán en error_message.
2	El borrador fue creado exitosamente; sin embargo, hay otros problemas (por ejemplo, falta de folios) que impidieron su envío al SII. Los detalles del error estarán en error_message.

{
   "document_id": 377,
   "header":    {
      "account_id": 14540,
      "document_type_id": 82,
      "document_type_taxbureau": "01",
      "document_number": 1040447,
      "received_issued_flag": 1,
      "taxbureau_validation_status": null,
      "issue_date": "2025-04-15",
      "issuer_tax_id_code": "860517022-2",
      "issuer_tax_id_type": "CO-NIT",
      "issuer_legal_name": "Demo Colombia",
      "issuer_address": "",
      "issuer_district": "",
      "issuer_city": "",
      "issuer_country_id": 253,
      "issuer_phone": "442020550",
      "issuer_activity": "",
      "receiver_tax_id_code": "1097491385-1",
      "receiver_tax_id_type": "CO-NIT",
      "receiver_legal_name": "ESCUELAa KEMPER URGATE",
      "receiver_address": "",
      "receiver_district": "",
      "receiver_city": "",
      "receiver_country_id": 66,
      "receiver_phone": "<string>",
      "receiver_activity": "<string>",
      "document_status": 1,
      "payment_conditions": "0",
      "currency_id": 28
   },
   "details": [   {
      "quantity": "1.000000",
      "line_description": "Prueba Koywe",
      "long_description": "Esta es una linea de prueba",
      "unit_measure": "70",
      "unit_price": "3660.000000",
      "vat_status": "0"
   }],
   "references": null,
   "global_modifiers": null,
   "totals":    {
      "net_amount": 3660,
      "taxes_amount": 695.4,
      "total_amount": "4355.40"
   },
   "electronic_document":    {
      "document_xml": "PD94bWwgdmVyc2lvbj0iMS4wIiB...",
      "document_pdf": "JVBERi0xLjMKMyAwIG9iago8PC9..."
   },
   "payment_link": null,
   "result":    {
      "status": 0,
      "error_message": ""
   },
   "_links": {"self": {"href": "https://api-billing.koywe.com/V1/documents"}}
}

Referencia de API POST /documents

Documentación detallada del endpoint: /english/billing/api-reference/billing-api/documents/create-a-new-document