Examples by country🇨🇱 Chile

➕ Create new documents

Postman collection

To help you with your integration, download our Postman Collection here: https://github.com/koyweforest/api-billing-postman

Invoice (Factura electrónica)

In order to create a new chilean invoice, you need to use the /documents endpoint with the proper parameters.

1{
2  "header": {
3    "account_id": 423,
4    "document_type_id": "2",
5
6    "received_issued_flag": 1,
7    "issue_date": "2025-01-07",
8    "issuer_tax_id_code": "76399932-7",
9    "issuer_tax_id_type": "CL-RUT",
10    "issuer_legal_name": "<string>",
11    "issuer_address": "<string>",
12    "issuer_district": "<string>",
13    "issuer_city": "<string>",
14    "issuer_country_id": "253",
15    "issuer_phone": "<string>",
16    "issuer_activity": "<string>",
17    "receiver_tax_id_code": "76399932-7",
18    "receiver_tax_id_type": "CL-RUT",
19    "receiver_legal_name": "ESCUELA KEMPER URGATE",
20    "receiver_address": "<string>",
21    "receiver_district": "<string>",
22    "receiver_city": "<string>",
23    "receiver_country_id": "253",
24    "receiver_phone": "<string>",
25    "receiver_activity": "<string>",
26    "payment_conditions": "0",
27    "currency_id": 39
28
29  },
30  "details": [
31    {
32      "quantity": 1,
33      "sku": "aa111",
34      "line_description": "Prueba Koywe",
35      "unit_measure": "UN",
36      "unit_price": 1500,
37      "long_description": "Esta es una linea de prueba",
38      "modifier_amount": -100,
39      "total_taxes": 266,
40      "modifier_percentage": 0,
41      "total_amount_line": 1624,
42      "taxes": [
43        {
44          "tax_type_id": "387",
45          "tax_percentage": 19,
46          "tax_amount": 266
47        }
48      ]
49    }
50  ],
51  "totals": {
52    "net_amount": 1400,
53    "taxes_amount": 266,
54    "total_amount": 1666
55  }
56}

Invoice VAT exempt (Factura electrónica exenta)

In order to create a new chilean VAT exempt invoice, you need to use the /documents endpoint with the proper parameters.

1{
2  "header": {
3    "account_id": 141,
4    "document_type_id": "32",
5
6    "received_issued_flag": 1,
7    "issue_date": "2025-01-07",
8    "issuer_tax_id_code": "76399932-7",
9    "issuer_tax_id_type": "CL-RUT",
10    "issuer_legal_name": "<string>",
11    "issuer_address": "<string>",
12    "issuer_district": "<string>",
13    "issuer_city": "<string>",
14    "issuer_country_id": "253",
15    "issuer_phone": "<string>",
16    "issuer_activity": "<string>",
17    "receiver_tax_id_code": "76399932-7",
18    "receiver_tax_id_type": "CL-RUT",
19    "receiver_legal_name": "ESCUELA KEMPER URGATE",
20    "receiver_address": "<string>",
21    "receiver_district": "<string>",
22    "receiver_city": "<string>",
23    "receiver_country_id": "253",
24    "receiver_phone": "<string>",
25    "receiver_activity": "<string>",
26    "payment_conditions": "0",
27    "currency_id": 39
28
29  },
30  "details": [
31    {
32      "quantity": 1,
33      "sku": "aa111",
34      "line_description": "Prueba Koywe",
35      "unit_measure": "UN",
36      "unit_price": 1500,
37      "long_description": "Esta es una linea de prueba",
38      "modifier_amount": -100,
39      "total_taxes": 0,
40      "modifier_percentage": 0,
41      "total_amount_line": 1400
42    }
43  ],
44  "totals": {
45    "net_amount": 1400,
46    "taxes_amount": 0,
47    "total_amount": 1400
48  }
49}

Receipt (Boleta electrónica)

The receiver parameters are optional for electronic receipt. You can include them to create a nominative receipt or not include them to generate a regular (non-nominative) receipt.

1{
2  "header": {
3    "account_id": 423,
4    "document_type_id": "37",
5
6    "received_issued_flag": 1,
7    "issue_date": "2025-01-07",
8    "issuer_tax_id_code": "76399932-7",
9    "issuer_tax_id_type": "CL-RUT",
10    "issuer_legal_name": "<string>",
11    "issuer_address": "<string>",
12    "issuer_district": "<string>",
13    "issuer_city": "<string>",
14    "issuer_country_id": "253",
15    "issuer_phone": "<string>",
16    "issuer_activity": "<string>",
17    "receiver_tax_id_code": "76399932-7",
18    "receiver_tax_id_type": "CL-RUT",
19    "receiver_legal_name": "ESCUELA KEMPER URGATE",
20    "receiver_address": "<string>",
21    "receiver_district": "<string>",
22    "receiver_city": "<string>",
23    "receiver_country_id": "253",
24    "receiver_phone": "<string>",
25    "receiver_activity": "<string>",
26    "payment_conditions": "0",
27    "currency_id": 39
28
29  },
30  "details": [
31    {
32      "quantity": 1,
33      "sku": "aa111",
34      "line_description": "Prueba Koywe",
35      "unit_measure": "UN",
36      "unit_price": 1500,
37      "long_description": "Esta es una linea de prueba",
38      "modifier_amount": -100,
39      "total_taxes": 266,
40      "modifier_percentage": 0,
41      "total_amount_line": 1666,
42      "taxes": [
43        {
44          "tax_type_id": "387",
45          "tax_percentage": 19,
46          "tax_amount": 266
47        }
48      ]
49    }
50  ],
51  "totals": {
52    "net_amount": 1400,
53    "taxes_amount": 266,
54    "total_amount": 1666
55  }
56}

Receipt VAT exempt (Boleta electrónica exenta)

The receiver parameters are optional for VAT exempt electronic receipt. You can include them to create a nominative receipt or not include them to generate a regular (non-nominative) receipt.

1{
2  "header": {
3    "account_id": 141,
4    "document_type_id": "41",
5
6    "received_issued_flag": 1,
7    "issue_date": "2025-01-07",
8    "issuer_tax_id_code": "76399932-7",
9    "issuer_tax_id_type": "CL-RUT",
10    "issuer_legal_name": "<string>",
11    "issuer_address": "<string>",
12    "issuer_district": "<string>",
13    "issuer_city": "<string>",
14    "issuer_country_id": "253",
15    "issuer_phone": "<string>",
16    "issuer_activity": "<string>",
17    "receiver_tax_id_code": "76399932-7",
18    "receiver_tax_id_type": "CL-RUT",
19    "receiver_legal_name": "ESCUELA KEMPER URGATE",
20    "receiver_address": "<string>",
21    "receiver_district": "<string>",
22    "receiver_city": "<string>",
23    "receiver_country_id": "253",
24    "receiver_phone": "<string>",
25    "receiver_activity": "<string>",
26    "payment_conditions": "0",
27    "currency_id": 39
28
29  },
30  "details": [
31    {
32      "quantity": 1,
33      "sku": "aa111",
34      "line_description": "Prueba Koywe",
35      "unit_measure": "UN",
36      "unit_price": 1500,
37      "long_description": "Esta es una linea de prueba",
38      "modifier_amount": -100,
39      "total_taxes": 0,
40      "modifier_percentage": 0,
41      "total_amount_line": 1400
42    }
43  ],
44  "totals": {
45    "net_amount": 1400,
46    "taxes_amount": 0,
47    "total_amount": 1400
48  }
49}

Credit note with reference to reference_number (Nota de crédito con referencia de reference_number)

The receiver parameters are mandatory for credit note. If you are cancelling an electronic receipt and you have no nominative information, you can use the generic tax id 66666666-6.

Use reference_number (document_number) to reference the document you are cancelling.

1{
2  "header": {
3    "account_id": 423,
4    "document_type_id": "16",
5    "received_issued_flag": 1,
6    "issue_date": "2025-01-07",
7    "issuer_tax_id_code": "76399932-7",
8    "issuer_tax_id_type": "CL-RUT",
9    "issuer_legal_name": "<string>",
10    "issuer_address": "<string>",
11    "issuer_district": "<string>",
12    "issuer_city": "<string>",
13    "issuer_country_id": "253",
14    "issuer_phone": "<string>",
15    "issuer_activity": "<string>",
16    "receiver_tax_id_code": "76399932-7",
17    "receiver_tax_id_type": "CL-RUT",
18    "receiver_legal_name": "ESCUELA KEMPER URGATE",
19    "receiver_address": "<string>",
20    "receiver_district": "<string>",
21    "receiver_city": "<string>",
22    "receiver_country_id": "253",
23    "receiver_phone": "<string>",
24    "receiver_activity": "<string>",
25    "payment_conditions": "0",
26    "currency_id": 39
27  },
28  "details": [
29    {
30      "quantity": 1,
31      "sku": "aa111",
32      "line_description": "Prueba ROW",
33      "unit_measure": "UN",
34      "unit_price": 1500,
35      "long_description": "Esta es una linea de prueba",
36      "modifier_amount": -100,
37      "total_taxes": 266,
38      "modifier_percentage": 0,
39      "total_amount_line": 1624,
40      "taxes": [
41        {
42          "tax_type_id": "387",
43          "tax_percentage": 19,
44          "tax_amount": 266
45        }
46      ]
47    }
48  ],
49   "references": [
50    {
51        "document_type_id": 2,
52        "reference_number": "1712",
53        "reference_code": 1,
54        "description": "Anulacion",
55        "reference_date": "2025-01-07"
56    }
57  ],
58  "totals": {
59    "net_amount": 1400,
60    "taxes_amount": 266,
61    "total_amount": 1666
62  }
63}

Credit note with reference to reference_document_id (Nota de crédito con referencia de reference_document_id)

The receiver parameters are mandatory for credit note. If you are cancelling an electronic receipt and you have no nominative information, you can use the generic tax id 66666666-6.

Use reference_document_id (document_id) to reference the document you are cancelling.

1{
2  "header": {
3    "account_id": 423,
4    "document_type_id": "16",
5    "received_issued_flag": 1,
6    "issue_date": "2025-01-07",
7    "issuer_tax_id_code": "76399932-7",
8    "issuer_tax_id_type": "CL-RUT",
9    "issuer_legal_name": "<string>",
10    "issuer_address": "<string>",
11    "issuer_district": "<string>",
12    "issuer_city": "<string>",
13    "issuer_country_id": "253",
14    "issuer_phone": "<string>",
15    "issuer_activity": "<string>",
16    "receiver_tax_id_code": "76399932-7",
17    "receiver_tax_id_type": "CL-RUT",
18    "receiver_legal_name": "ESCUELA KEMPER URGATE",
19    "receiver_address": "<string>",
20    "receiver_district": "<string>",
21    "receiver_city": "<string>",
22    "receiver_country_id": "253",
23    "receiver_phone": "<string>",
24    "receiver_activity": "<string>",
25    "payment_conditions": "0",
26    "currency_id": 39
27  },
28  "details": [
29    {
30      "quantity": 1,
31      "sku": "aa111",
32      "line_description": "Prueba ROW",
33      "unit_measure": "UN",
34      "unit_price": 1500,
35      "long_description": "Esta es una linea de prueba",
36      "modifier_amount": -100,
37      "total_taxes": 266,
38      "modifier_percentage": 0,
39      "total_amount_line": 1666,
40      "taxes": [
41        {
42          "tax_type_id": "387",
43          "tax_percentage": 19,
44          "tax_amount": 266
45        }
46      ]
47   "references": [
48    {
49        "document_type_id": 2,
50        "reference_document_id": 1542,
51        "reference_code": 1,
52        "description": "Anulacion",
53        "reference_date": "2025-01-07"
54    }
55  ],
56  "totals": {
57    "net_amount": 1400,
58    "taxes_amount": 266,
59    "total_amount": 1666
60  }
61}

Debit note with reference to reference_number (Nota de débito con referencia de reference_number)

The receiver parameters are mandatory for debit note. If you are cancelling an credit note and you have no nominative information, you can use the generic tax id 66666666-6.

Use reference_number (document_number) to reference the document you are cancelling.

1{
2  "header": {
3    "account_id": 423,
4    "document_type_id": "17",
5    "received_issued_flag": 1,
6    "issue_date": "2025-01-07",
7    "issuer_tax_id_code": "76399932-7",
8    "issuer_tax_id_type": "CL-RUT",
9    "issuer_legal_name": "<string>",
10    "issuer_address": "<string>",
11    "issuer_district": "<string>",
12    "issuer_city": "<string>",
13    "issuer_country_id": "253",
14    "issuer_phone": "<string>",
15    "issuer_activity": "<string>",
16    "receiver_tax_id_code": "76399932-7",
17    "receiver_tax_id_type": "CL-RUT",
18    "receiver_legal_name": "ESCUELA KEMPER URGATE",
19    "receiver_address": "<string>",
20    "receiver_district": "<string>",
21    "receiver_city": "<string>",
22    "receiver_country_id": "253",
23    "receiver_phone": "<string>",
24    "receiver_activity": "<string>",
25    "payment_conditions": "0",
26    "currency_id": 39
27  },
28  "details": [
29    {
30      "quantity": 1,
31      "sku": "aa111",
32      "line_description": "Prueba ROW",
33      "unit_measure": "UN",
34      "unit_price": 1500,
35      "long_description": "Esta es una linea de prueba",
36      "modifier_amount": -100,
37      "total_taxes": 266,
38      "modifier_percentage": 0,
39      "total_amount_line": 1666,
40      "taxes": [
41        {
42          "tax_type_id": "387",
43          "tax_percentage": 19,
44          "tax_amount": 266
45        }
46      ]
47    }
48  ],
49   "references": [
50    {
51        "document_type_id": 16,
52        "reference_number": "1815",
53        "reference_code": 1,
54        "description": "Anulacion",
55        "reference_date": "2025-01-07"
56    }
57  ],
58  "totals": {
59    "net_amount": 1400,
60    "taxes_amount": 266,
61    "total_amount": 1666
62  }
63}

Debit note with reference to reference_document_id (Nota de débito con referencia de reference_document_id)

The receiver parameters are mandatory for debit note. If you are cancelling an credit note and you have no nominative information, you can use the generic tax id 66666666-6.

Use reference_document_id (document_id) to reference the document you are cancelling.

1{
2  "header": {
3    "account_id": 423,
4    "document_type_id": "17",
5    "received_issued_flag": 1,
6    "issue_date": "2025-01-07",
7    "issuer_tax_id_code": "76399932-7",
8    "issuer_tax_id_type": "CL-RUT",
9    "issuer_legal_name": "<string>",
10    "issuer_address": "<string>",
11    "issuer_district": "<string>",
12    "issuer_city": "<string>",
13    "issuer_country_id": "253",
14    "issuer_phone": "<string>",
15    "issuer_activity": "<string>",
16    "receiver_tax_id_code": "76399932-7",
17    "receiver_tax_id_type": "CL-RUT",
18    "receiver_legal_name": "ESCUELA KEMPER URGATE",
19    "receiver_address": "<string>",
20    "receiver_district": "<string>",
21    "receiver_city": "<string>",
22    "receiver_country_id": "253",
23    "receiver_phone": "<string>",
24    "receiver_activity": "<string>",
25    "payment_conditions": "0",
26    "currency_id": 39
27  },
28  "details": [
29    {
30      "quantity": 1,
31      "sku": "aa111",
32      "line_description": "Prueba ROW",
33      "unit_measure": "UN",
34      "unit_price": 1500,
35      "long_description": "Esta es una linea de prueba",
36      "modifier_amount": -100,
37      "total_taxes": 266,
38      "modifier_percentage": 0,
39     "total_amount_line": 1666,
40      "taxes": [
41        {
42          "tax_type_id": "387",
43          "tax_percentage": 19,
44          "tax_amount": 266
45        }
46      ]
47    }
48  ],
49   "references": [
50    {
51        "document_type_id": 16,
52        "reference_document_id": 1542,
53        "reference_code": 1,
54        "description": "Anulacion",
55        "reference_date": "2025-01-07"
56    }
57  ],
58  "totals": {
59    "net_amount": 1400,
60    "taxes_amount": 266,
61    "total_amount": 1666
62  }
63}

Bill of Lading (Guía de despacho)

Bills of lading are used in addition to invoices when moving inventory within the same company warehouses, or to/from a customer address.

1{
2  "header": {
3    "account_id": 423,
4    "document_type_id": "54",
5    "received_issued_flag": 1,
6    "issue_date": "2025-03-04",
7    "receiver_tax_id_code": "76399932-7",
8    "receiver_tax_id_type": "CL-RUT",
9    "receiver_legal_name": "ESCUELA KEMPER URGATE",
10    "receiver_address": "Av providencia 1456",
11    "receiver_district": "Providencia",
12    "receiver_city": "Santiago",
13    "receiver_country_id": "253",
14    "receiver_phone": "<string>",
15    "receiver_activity": "Venta insumos",
16    "payment_conditions": "0",
17    "currency_id": 39,
18    "guide_type": 1,
19    "transfer_type": 1
20
21  },
22  "details": [
23    {
24      "quantity": 1,
25      "sku": "aa111",
26      "line_description": "Prueba Koywe",
27      "unit_measure": "UN",
28      "unit_price": 1500,
29      "long_description": "Esta es una linea de prueba",
30      "modifier_amount": -100,
31      "total_taxes": 266,
32      "modifier_percentage": 0,
33      "total_amount_line": 1624,
34      "taxes": [
35        {
36          "tax_type_id": "387",
37          "tax_percentage": 19,
38          "tax_amount": 266
39        }
40      ]
41    }
42  ],
43  "totals": {
44    "net_amount": 1400,
45    "taxes_amount": 266,
46    "total_amount": 1666
47  }
48}

Exports Invoice (Factura de exportación)

When you sell to other countries, you are required in Chile to issue a export invoice. The format is similar but it also allows

1{
2  "header": {
3    "account_id": 423,
4    "document_type_id": "46",
5    "received_issued_flag": 1,
6    "issue_date": "2025-03-04",
7    "receiver_tax_id_code": "222333444",
8    "receiver_tax_id_type": "MX-RFC",
9    "receiver_legal_name": "ESCUELA KEMPER URGATE",
10    "receiver_address": "Av providencia 1456",
11    "receiver_district": "Providencia",
12    "receiver_city": "Santiago",
13    "receiver_country_id": "80",
14    "receiver_phone": "<string>",
15    "receiver_activity": "Venta insumos",
16    "payment_conditions": "0",
17    "exchange_rate_value": 934.58,
18    "currency_id": 5,
19    "sale_modality": 1,
20    "sale_clause": 1
21  },
22  "details": [
23    {
24      "quantity": 1,
25      "sku": "aa111",
26      "line_description": "Prueba Koywe",
27      "unit_measure": "UN",
28      "unit_price": 1500,
29      "long_description": "Esta es una linea de prueba",
30      "modifier_amount": -100,
31      "total_taxes": 0,
32      "modifier_percentage": 0,
33      "total_amount_line": 1400,
34      "taxes": [
35      ]
36    }
37  ],
38  "totals": {
39    "net_amount": 1400,
40    "taxes_amount": 0,
41    "total_amount": 1400
42  }
43}

Exports Credit note (Nota de crédito de exportación)

If you want to cancel an export invoice, you need to use this special kind of document.

1{
2  "header": {
3    "account_id": 423,
4    "document_type_id": "48",
5    "received_issued_flag": 1,
6    "issue_date": "2025-03-04",
7    "receiver_tax_id_code": "222333444",
8    "receiver_tax_id_type": "MX-RFC",
9    "receiver_legal_name": "ESCUELA KEMPER URGATE",
10    "receiver_address": "Av providencia 1456",
11    "receiver_district": "Providencia",
12    "receiver_city": "Santiago",
13    "receiver_country_id": "80",
14    "receiver_phone": "<string>",
15    "receiver_activity": "Venta insumos",
16    "payment_conditions": "0",
17    "exchange_rate_value": 934.58,
18    "currency_id": 5,
19    "sale_modality": 1,
20    "sale_clause": 1
21  },
22  "details": [
23    {
24      "quantity": 1,
25      "sku": "aa111",
26      "line_description": "Prueba Koywe",
27      "unit_measure": "UN",
28      "unit_price": 1500,
29      "long_description": "Esta es una linea de prueba",
30      "modifier_amount": -100,
31      "total_taxes": 0,
32      "modifier_percentage": 0,
33      "total_amount_line": 1400,
34      "taxes": [
35      ]
36    }
37  ],
38  "references": [
39    {
40        "document_type_id": 46,
41        "reference_number": "139",
42        "reference_code": 1,
43        "description": "Anulacion",
44        "reference_date": "2025-03-04"
45    }
46  ],
47  "totals": {
48    "net_amount": 1400,
49    "taxes_amount": 0,
50    "total_amount": 1400
51  }
52}

Exports Debit note (Nota de débito de exportación)

If you want to cancel an export invoice, you need to use this special kind of document.

1{
2  "header": {
3    "account_id": 423,
4    "document_type_id": "47",
5    "received_issued_flag": 1,
6    "issue_date": "2025-03-04",
7    "receiver_tax_id_code": "222333444",
8    "receiver_tax_id_type": "MX-RFC",
9    "receiver_legal_name": "ESCUELA KEMPER URGATE",
10    "receiver_address": "Av providencia 1456",
11    "receiver_district": "Providencia",
12    "receiver_city": "Santiago",
13    "receiver_country_id": "80",
14    "receiver_phone": "<string>",
15    "receiver_activity": "Venta insumos",
16    "payment_conditions": "0",
17    "exchange_rate_value": 934.58,
18    "currency_id": 5,
19    "sale_modality": 1,
20    "sale_clause": 1
21  },
22  "details": [
23    {
24      "quantity": 1,
25      "sku": "aa111",
26      "line_description": "Prueba Koywe",
27      "unit_measure": "UN",
28      "unit_price": 1500,
29      "long_description": "Esta es una linea de prueba",
30      "modifier_amount": -100,
31      "total_taxes": 0,
32      "modifier_percentage": 0,
33      "total_amount_line": 1400,
34      "taxes": [
35      ]
36    }
37  ],
38  "references": [
39    {
40        "document_type_id": 46,
41        "reference_number": "139",
42        "reference_code": 1,
43        "description": "csmbio vslor",
44        "reference_date": "2025-03-04"
45    }
46  ],
47  "totals": {
48    "net_amount": 1400,
49    "taxes_amount": 0,
50    "total_amount": 1400
51  }
52}

Response status in result the API Rest

statusdescription
0The draft was created successfully, signed, and sent to the SII successfully.
1There are errors in the input, so the draft was not generated nor sent to the SII. The error details will be in error_message.
2The draft was created successfully; however, there are other issues (e.g., lack of folios) that prevented it from being sent to the SII. The error details will be in error_message.
1{
2   "document_id": 377,
3   "header":    {
4      "account_id": 14540,
5      "document_type_id": 82,
6      "document_type_taxbureau": "01",
7      "document_number": 1040447,
8      "received_issued_flag": 1,
9      "taxbureau_validation_status": null,
10      "issue_date": "2025-04-15",
11      "issuer_tax_id_code": "860517022-2",
12      "issuer_tax_id_type": "CO-NIT",
13      "issuer_legal_name": "Demo Colombia",
14      "issuer_address": "",
15      "issuer_district": "",
16      "issuer_city": "",
17      "issuer_country_id": 253,
18      "issuer_phone": "442020550",
19      "issuer_activity": "",
20      "receiver_tax_id_code": "1097491385-1",
21      "receiver_tax_id_type": "CO-NIT",
22      "receiver_legal_name": "ESCUELAa KEMPER URGATE",
23      "receiver_address": "",
24      "receiver_district": "",
25      "receiver_city": "",
26      "receiver_country_id": 66,
27      "receiver_phone": "<string>",
28      "receiver_activity": "<string>",
29      "document_status": 1,
30      "payment_conditions": "0",
31      "currency_id": 28
32   },
33   "details": [   {
34      "quantity": "1.000000",
35      "line_description": "Prueba Koywe",
36      "long_description": "Esta es una linea de prueba",
37      "unit_measure": "70",
38      "unit_price": "3660.000000",
39      "vat_status": "0"
40   }],
41   "references": null,
42   "global_modifiers": null,
43   "totals":    {
44      "net_amount": 3660,
45      "taxes_amount": 695.4,
46      "total_amount": "4355.40"
47   },
48   "electronic_document":    {
49      "document_xml": "PD94bWwgdmVyc2lvbj0iMS4wIiB...",
50      "document_pdf": "JVBERi0xLjMKMyAwIG9iago8PC9..."
51   },
52   "payment_link": null,
53   "result":    {
54      "status": 0,
55      "error_message": ""
56   },
57   "_links": {"self": {"href": "https://api-billing.koywe.com/V1/documents"}}
58}
API Reference POST /documents

Detailed endpoint documentation