Examples by country🇨🇴 Colombia

➕ Create new documents

Invoice (Factura)

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

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

Credit note (Nota de crédito)

In order to create a new colombian credit note, you need to use the /documents endpoint with the proper parameters.

reference_number should be the document that you are cancelling

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

Debit note (Nota de débito)

In order to create a new colombian debit note, you need to use the /documents endpoint with the proper parameters.

reference_number should be the document that you are cancelling

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

POS equivalent document (Documento equivalente POS)

POS will only generate XML, no PDF will be generated on test or production environment. You can use the data to generate your own document format

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

POS equivalent credit note (Nota de crédito para documento equivalente POS)

POS will only generate XML, no PDF will be generated on test or production environment. You can use the data to generate your own document format

1{
2  "header": {
3    "account_id": 39,
4    "document_type_id": "88",
5    "received_issued_flag": 0,
6    "issue_date": "2025-01-31",
7    "issuer_tax_id_code": "EKU9003173C9",
8    "issuer_tax_id_type": "MX-RFC",
9    "issuer_legal_name": "<string>",
10    "issuer_address": "<string>",
11    "issuer_district": "<string>",
12    "issuer_city": "<string>",
13    "issuer_country_id": "66",
14    "issuer_phone": "<string>",
15    "issuer_activity": "<string>",
16    "receiver_tax_id_code": "860517022-2",
17    "receiver_tax_id_type": "CO-NIT",
18    "receiver_legal_name": "ESCUELA KEMPER URGATE",
19    "receiver_address": "<string>",
20    "receiver_district": "<string>",
21    "receiver_city": "Bogota, D.C.",
22    "receiver_country_id": "66",
23    "receiver_phone": "<string>",
24    "receiver_activity": "<string>",
25    "payment_conditions": "0",
26    "currency_id": 28,
27    "postal_code": "11001",
28    "receiver_email": "miemail@email.com"
29  },
30  "details": [
31    {
32      "quantity": 1,
33      "line_description": "Prueba Koywe",
34      "unit_measure": "70",
35      "unit_price": 1500,
36      "long_description": "Esta es una linea de prueba",
37      "modifier_amount": -100,
38      "total_taxes": 266,
39      "modifier_percentage": 0,
40      "total_amount_line": 1666,
41      "taxes": [
42        {
43          "tax_type_id": "388",
44          "tax_percentage": 19,
45          "tax_amount": 266
46        }
47      ]
48    }
49  ],
50  "references": [
51    {
52        "document_type_id": 87,
53        "reference_number": "EPOS217",
54        "reference_code": 1,
55        "description": "Anulacion solicitada por el emisor",
56        "reference_date": "2025-01-31"
57    }
58  ],
59  "totals": {
60    "net_amount": 1400,
61    "taxes_amount": 266,
62    "total_amount": 1666
63  }
64}

support document (Documento soporte)

DIAN doesn’t allow issuing support documents on its testing environment, so when issuing this using sandbox credentials no XML or PDF will be returned.

support document credit note (Nota de crédito a documento soporte)

DIAN doesn’t allow issuing support documents on its testing environment, so when issuing this using sandbox credentials no XML or PDF will be returned.

API Reference POST /documents

Detailed endpoint documentation