DIAN Colombia

Submit invoices to the Colombian DIAN system.

Description

Register suppliers

Supplier registration guide ›

Issue invoices

Issuing guide ›

Developer	Invopop
Category	Government
Scope	B2B, B2C
Country	Colombia

The DIAN in Colombia stands for Dirección de Impuestos y Aduanas Nacionales (National Directorate of Taxes and Customs). It is the government agency responsible for managing and overseeing tax collection, customs operations, and facilitating international trade.

Electronic invoicing in Colombia is mandatory and operates on a real-time clearance model whereby every invoice must receive a unique identifier called a CUFE (Código Único de Factura Electrónica) issued by the DIAN.

Invopop has partnered with Plemsi to issue invoices in Colombia (DIAN). You can either use Invopop’s Plemsi billing account or create your own and provide your own credentials.

Key features

• Workflow automation: This app provides automated workflows for issuing invoices and credit notes through the DIAN system.
• Real-time clearance: Every invoice receives a unique CUFE code from the DIAN in real-time, ensuring compliance with Colombian e-invoicing regulations.
• Legally compliant PDF invoices: Invoices are generated with all mandatory fields and CUFE codes, as required by Colombian invoicing legislation.
• Plemsi integration: Direct integration with Plemsi, an authorized technology provider for DIAN electronic invoicing.
• UBL 2.1 generation: Compliant XML generation is supported for the DIAN schema.
• QR code: Generates the DIAN QR code according to the DIAN specifications.

Make sure to check out our Supplier registration guide for onboarding suppliers, and the Issuing invoices guide for issuing invoices and setting up your workflows.

FAQ

Invoicing questions

My GOBL document for a Colombian invoice fails to build because of the postal code

The DIAN requires a Municipal Code rather than a postal code to specify the municipality of the supplier. Make sure you are setting a municipal code (5 digits) and not a postal code (6 digits) in the supplier’s co-dian-municipality extension.

How does Invopop issue invoices in Colombia?

Through Plemsi, an authorized technology provider for DIAN electronic invoicing. The DIAN Colombia workflow signs the GOBL envelope, sends the invoice to the DIAN via Plemsi, receives the CUFE, and generates a compliant PDF with the DIAN QR code.

What does a GOBL invoice need to be accepted by the DIAN?

Set $schema to https://gobl.org/draft-0/bill/invoice, the supplier’s tax_id.country to CO, and include the supplier’s and customer’s DIAN municipality codes via the co-dian-municipality extension in each party’s ext. See the GOBL Colombia tax regime for the full field reference and examples.

Which taxes can appear on a Colombian invoice?

VAT (IVA, 19% standard or 5% reduced), consumption taxes (IC, INC), the industry and commerce tax (ICA), and the retained taxes ReteIVA, ReteICA, and Retefuente. A single invoice may need to combine up to three value added and retained taxes — all are supported by the GOBL Colombia tax regime.

Can I issue credit notes through Invopop in Colombia?

Yes. The same DIAN Colombia workflow handles invoices and credit notes when configured with a dynamic sequential code, so each document type draws from its own authorized numbering range.

What are the sandbox limitations for Colombia?

Plemsi’s sandbox has a single enabled supplier (tax code 9015852843) and one series per document type: SETT for invoices and NCTT for credit notes. The series are shared across users, so we assign you a specific number range to avoid collisions. Contact us via Slack or [e-mail] to enable the sandbox in your workspace.

Registering supplier questions

What does a supplier need before issuing invoices in Colombia?

The supplier must be registered with the DIAN with an active RUT (Registro Único Tributario), authorize Plemsi as their technology provider in the DIAN, and hold a valid billing numbering range authorization. The supplier registration guide walks through each step.

How do I register a supplier for Colombia?

The supplier’s legal representative authorizes Plemsi in the DIAN, requests a billing numbering range authorization (the DIAN issues a form 1876), and associates that resolution with Plemsi. Then contact us via Slack or [e-mail] with the supplier’s company details so we can create and configure the Plemsi account. See the supplier registration guide for the full checklist.

Does the billing numbering range authorization expire?

Yes. DIAN numbering range authorizations have both a number limit and an expiration date. When one runs out, the supplier’s legal representative must file a renewal (“Solicitud de Habilitación de Numeración de Facturación”) with the DIAN and associate the new resolution with Plemsi.

Do I need my own Plemsi account?

No. You can use Invopop’s Plemsi billing account, or create your own and provide your credentials. In either case, contact us to configure the account — Plemsi account setup for Invopop suppliers is done by our team.

Do I need to register suppliers in the sandbox?

No. The Plemsi sandbox has a single pre-registered supplier with tax code 9015852843, which all test invoices must use. Supplier registration only applies to the live environment.

More answers in our Colombia FAQ section

Actions

The following workflow actions will be available once you install and enable this app:

Send to Plemsi (DIAN)

Workflows

The following workflows are available to make your integration easier. Use them as templates to build upon.

DIAN Colombia invoice workflow

This workflow automates FEV Colombian invoice processing and tax compliance.

Example DIAN issue invoice workflow

{
  "name": "DIAN issue invoice",
  "description": "Issue an invoice through DIAN and generate PDF",
  "schema": "bill/invoice",
  "steps": [
    {
      "id": "ece780f0-322c-11f0-bbb5-9da15d555d80",
      "name": "Set state",
      "provider": "silo.state",
      "summary": "Set state to `processing`{.state .processing}",
      "config": {
        "state": "processing"
      }
    },
    {
      "id": "7d803770-322c-11f0-bbb5-9da15d555d80",
      "name": "Add sequential code",
      "provider": "sequence.enumerate",
      "summary": "Dynamic · DIAN · 1",
      "config": {
        "name": "Colombia",
        "padding": 1,
        "prefix": "",
        "start": 1
      }
    },
    {
      "id": "fc75e4f0-8721-11ef-a962-73e3f2037a52",
      "name": "Sign envelope",
      "provider": "silo.close"
    },
    {
      "id": "bde49770-322c-11f0-bbb5-9da15d555d80",
      "name": "Send invoice to DIAN",
      "provider": "plemsi"
    },
    {
      "id": "cdf59920-322c-11f0-bbb5-9da15d555d80",
      "name": "Generate PDF",
      "provider": "pdf",
      "summary": "Spanish · Letter",
      "config": {
        "date_format": "%Y-%m-%d",
        "layout": "Letter",
        "locale": "es",
        "logo_height": 40
      }
    },
    {
      "id": "9cebc6a0-322d-11f0-bbb5-9da15d555d80",
      "name": "Set state",
      "provider": "silo.state",
      "summary": "Set state to `sent`{.state .sent}",
      "config": {
        "state": "sent"
      }
    }
  ],
  "rescue": [
    {
      "id": "e57671a0-322c-11f0-bbb5-9da15d555d80",
      "name": "Set state",
      "provider": "silo.state",
      "summary": "Set state to `error`{.state .error}",
      "config": {
        "state": "error"
      }
    }
  ]
}

Add to my workspace →

Documents

DIAN Colombia supplier

A NIT (tin type) with the co-dian-municipality extension identifying where the supplier is registered.

Colombia supplier example

{
    "$schema": "https://gobl.org/draft-0/org/party",
    "name": "EXAMPLE SUPPLIER S.A.S.",
    "tax_id": {
        "country": "CO",
        "type": "tin",
        "code": "9014514812"
    },
    "addresses": [
        {
            "street": "CRA 15 88 64 OF 502",
            "locality": "Bogotá, D.C.",
            "region": "Bogotá",
            "country": "CO"
        }
    ],
    "emails": [
        {
            "addr": "[e-mail]"
        }
    ],
    "ext": {
        "co-dian-municipality": "11001"
    }
}

DIAN Colombia customer

A business customer with NIT, municipality extension, and the contact details DIAN expects on the invoice.

Colombia customer example

{
    "$schema": "https://gobl.org/draft-0/org/party",
    "name": "EXAMPLE CUSTOMER S.A.S.",
    "tax_id": {
        "country": "CO",
        "type": "tin",
        "code": "9014514805"
    },
    "addresses": [
        {
            "street": "CRA 8 113 31 OF 703",
            "locality": "Bogotá, D.C.",
            "region": "Bogotá",
            "country": "CO"
        }
    ],
    "emails": [
        {
            "addr": "[e-mail]"
        }
    ],
    "telephones": [
        {
            "num": "3114131811"
        }
    ],
    "ext": {
        "co-dian-municipality": "11001"
    }
}

Example B2B invoice

In this example, we’re issuing a B2B invoice from a Colombian supplier to another Colombian business customer.

Notice:

• the $schema is set to https://gobl.org/draft-0/bill/invoice,
• the supplier’s tax_id country is set to CO, and the DIAN municipality code is set with the co-dian-municipality extension on the party,
• the customer details include full address, email, and telephone information,
• the invoice includes VAT at the standard Colombian rate of 19%,
• payment terms are specified with a due date and payment amount, and,
• there are no calculations in some fields; these will be made automatically when uploading.

DIAN Colombia B2B Invoice

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "type": "standard",
  "series": "SETT",
  "code": "1234",
  "issue_date": "2021-01-01",
  "currency": "COP",
  "supplier": {
    "name": "EXAMPLE SUPPLIER S.A.S.",
    "tax_id": {
      "country": "CO",
      "type": "tin",
      "code": "9014514812"
    },
    "ext": {
      "co-dian-municipality": "11001"
    }
  },
  "customer": {
    "name": "EXAMPLE CUSTOMER S.A.S.",
    "tax_id": {
      "country": "CO",
      "type": "tin",
      "code": "9014514805"
    },
    "ext": {
      "co-dian-municipality": "11001"
    },
    "addresses": [
      {
        "street": "CRA 8 113 31 OF 703",
        "locality": "Bogotá, D.C.",
        "region": "Bogotá",
        "country": "CO"
      }
    ],
    "emails": [
      {
        "addr": "[e-mail]"
      }
    ],
    "telephones": [
      {
        "num": "3114131811"
      }
    ]
  },
  "lines": [
    {
      "quantity": "1",
      "item": {
        "name": "Servicios Mes de Julio 2022",
        "price": "200000.00"
      },
      "taxes": [
        {
          "cat": "VAT",
          "percent": "19%"
        }
      ]
    }
  ],
  "payment": {
    "terms": {
      "due_dates": [
        {
          "date": "2021-01-01",
          "percent": "100%"
        }
      ]
    }
  }
}

{
	"$schema": "https://gobl.org/draft-0/bill/invoice",
	"$regime": "CO",
	"type": "standard",
	"series": "SETT",
	"code": "1234",
	"issue_date": "2021-01-01",
	"currency": "COP",
	"supplier": {
		"name": "EXAMPLE SUPPLIER S.A.S.",
		"tax_id": {
			"country": "CO",
			"code": "9014514812",
			"type": "tin"
		},
		"ext": {
			"co-dian-municipality": "11001"
		}
	},
	"customer": {
		"name": "EXAMPLE CUSTOMER S.A.S.",
		"tax_id": {
			"country": "CO",
			"code": "9014514805",
			"type": "tin"
		},
		"addresses": [
			{
				"street": "CRA 8 113 31 OF 703",
				"locality": "Bogotá, D.C.",
				"region": "Bogotá",
				"country": "CO"
			}
		],
		"emails": [
			{
				"addr": "[e-mail]"
			}
		],
		"telephones": [
			{
				"num": "3114131811"
			}
		],
		"ext": {
			"co-dian-municipality": "11001"
		}
	},
	"lines": [
		{
			"i": 1,
			"quantity": "1",
			"item": {
				"name": "Servicios Mes de Julio 2022",
				"price": "200000.00"
			},
			"sum": "200000.00",
			"taxes": [
				{
					"cat": "VAT",
					"key": "standard",
					"percent": "19%"
				}
			],
			"total": "200000.00"
		}
	],
	"payment": {
		"terms": {
			"due_dates": [
				{
					"date": "2021-01-01",
					"amount": "238000.00",
					"percent": "100%"
				}
			]
		}
	},
	"totals": {
		"sum": "200000.00",
		"total": "200000.00",
		"taxes": {
			"categories": [
				{
					"code": "VAT",
					"rates": [
						{
							"key": "standard",
							"base": "200000.00",
							"percent": "19%",
							"amount": "38000.00"
						}
					],
					"amount": "38000.00"
				}
			],
			"sum": "38000.00"
		},
		"tax": "38000.00",
		"total_with_tax": "238000.00",
		"payable": "238000.00"
	}
}

Example B2C invoice

In this example, we’re issuing a B2C simplified invoice from a Colombian supplier to a consumer.

Notice:

• we’ve set the simplified tag in the tax.tags field; this indicates the invoice is for a final consumer,
• the customer information is omitted, as it’s not required for B2C transactions,
• the invoice includes a prepayment advance of 100%, meaning the invoice has been fully paid,
• the totals section shows the advance and due amounts, with the latter being zero since the invoice is fully paid, and,
• there are no calculations in some fields; these will be made automatically when uploading.

DIAN Colombia B2C Invoice

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "type": "standard",
  "series": "SETT",
  "code": "1234",
  "issue_date": "2021-01-01",
  "currency": "COP",
  "tax": {
    "tags": [
      "simplified"
    ]
  },
  "supplier": {
    "name": "EXAMPLE SUPPLIER S.A.S.",
    "tax_id": {
      "country": "CO",
      "type": "tin",
      "code": "9014514812"
    },
    "ext": {
      "co-dian-municipality": "11001"
    }
  },
  "lines": [
    {
      "quantity": "1",
      "item": {
        "name": "Useful service",
        "price": "200000.00"
      },
      "taxes": [
        {
          "cat": "VAT",
          "percent": "19%"
        }
      ]
    }
  ],
  "payment": {
    "advances": [
      {
        "description": "Prepaid",
        "percent": "100%"
      }
    ]
  }
}

{
	"$schema": "https://gobl.org/draft-0/bill/invoice",
	"$regime": "CO",
	"$tags": [
		"simplified"
	],
	"type": "standard",
	"series": "SETT",
	"code": "1234",
	"issue_date": "2021-01-01",
	"currency": "COP",
	"tax": {},
	"supplier": {
		"name": "EXAMPLE SUPPLIER S.A.S.",
		"tax_id": {
			"country": "CO",
			"code": "9014514812",
			"type": "tin"
		},
		"ext": {
			"co-dian-municipality": "11001"
		}
	},
	"lines": [
		{
			"i": 1,
			"quantity": "1",
			"item": {
				"name": "Useful service",
				"price": "200000.00"
			},
			"sum": "200000.00",
			"taxes": [
				{
					"cat": "VAT",
					"key": "standard",
					"percent": "19%"
				}
			],
			"total": "200000.00"
		}
	],
	"payment": {
		"advances": [
			{
				"description": "Prepaid",
				"percent": "100%",
				"amount": "238000.00"
			}
		]
	},
	"totals": {
		"sum": "200000.00",
		"total": "200000.00",
		"taxes": {
			"categories": [
				{
					"code": "VAT",
					"rates": [
						{
							"key": "standard",
							"base": "200000.00",
							"percent": "19%",
							"amount": "38000.00"
						}
					],
					"amount": "38000.00"
				}
			],
			"sum": "38000.00"
		},
		"tax": "38000.00",
		"total_with_tax": "238000.00",
		"payable": "238000.00",
		"advance": "238000.00",
		"due": "0.00"
	}
}

Example credit note

In this example, we’re issuing a credit note (nota de crédito) that corrects a previously issued invoice.

Notice:

• the type is set to credit-note,
• the series is set to the credit note series (NCTT in the sandbox environment, which is separate from the SETT invoice series),
• the preceding array references the original invoice being corrected by its series, code, and issue_date, along with a reason for the correction,
• the lines describe the amounts being credited — a credit note can cover the full original invoice or just part of it, and,
• there are no calculations in some fields; these will be made automatically when uploading.

DIAN Colombia Credit Note

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "type": "credit-note",
  "series": "NCTT",
  "code": "5678",
  "issue_date": "2021-01-15",
  "currency": "COP",
  "preceding": [
    {
      "type": "standard",
      "series": "SETT",
      "code": "1234",
      "issue_date": "2021-01-01",
      "reason": "Servicios no prestados"
    }
  ],
  "supplier": {
    "name": "EXAMPLE SUPPLIER S.A.S.",
    "tax_id": {
      "country": "CO",
      "type": "tin",
      "code": "9014514812"
    },
    "ext": {
      "co-dian-municipality": "11001"
    }
  },
  "customer": {
    "name": "EXAMPLE CUSTOMER S.A.S.",
    "tax_id": {
      "country": "CO",
      "type": "tin",
      "code": "9014514805"
    },
    "ext": {
      "co-dian-municipality": "11001"
    },
    "addresses": [
      {
        "street": "CRA 8 113 31 OF 703",
        "locality": "Bogotá, D.C.",
        "region": "Bogotá",
        "country": "CO"
      }
    ],
    "emails": [
      {
        "addr": "[e-mail]"
      }
    ],
    "telephones": [
      {
        "num": "3114131811"
      }
    ]
  },
  "lines": [
    {
      "quantity": "1",
      "item": {
        "name": "Servicios Mes de Julio 2022",
        "price": "200000.00"
      },
      "taxes": [
        {
          "cat": "VAT",
          "percent": "19%"
        }
      ]
    }
  ]
}

{
	"$schema": "https://gobl.org/draft-0/bill/invoice",
	"$regime": "CO",
	"type": "credit-note",
	"series": "NCTT",
	"code": "5678",
	"issue_date": "2021-01-15",
	"currency": "COP",
	"preceding": [
		{
			"type": "standard",
			"issue_date": "2021-01-01",
			"series": "SETT",
			"code": "1234",
			"reason": "Servicios no prestados"
		}
	],
	"supplier": {
		"name": "EXAMPLE SUPPLIER S.A.S.",
		"tax_id": {
			"country": "CO",
			"code": "9014514812",
			"type": "tin"
		},
		"ext": {
			"co-dian-municipality": "11001"
		}
	},
	"customer": {
		"name": "EXAMPLE CUSTOMER S.A.S.",
		"tax_id": {
			"country": "CO",
			"code": "9014514805",
			"type": "tin"
		},
		"addresses": [
			{
				"street": "CRA 8 113 31 OF 703",
				"locality": "Bogotá, D.C.",
				"region": "Bogotá",
				"country": "CO"
			}
		],
		"emails": [
			{
				"addr": "[e-mail]"
			}
		],
		"telephones": [
			{
				"num": "3114131811"
			}
		],
		"ext": {
			"co-dian-municipality": "11001"
		}
	},
	"lines": [
		{
			"i": 1,
			"quantity": "1",
			"item": {
				"name": "Servicios Mes de Julio 2022",
				"price": "200000.00"
			},
			"sum": "200000.00",
			"taxes": [
				{
					"cat": "VAT",
					"key": "standard",
					"percent": "19%"
				}
			],
			"total": "200000.00"
		}
	],
	"totals": {
		"sum": "200000.00",
		"total": "200000.00",
		"taxes": {
			"categories": [
				{
					"code": "VAT",
					"rates": [
						{
							"key": "standard",
							"base": "200000.00",
							"percent": "19%",
							"amount": "38000.00"
						}
					],
					"amount": "38000.00"
				}
			],
			"sum": "38000.00"
		},
		"tax": "38000.00",
		"total_with_tax": "238000.00",
		"payable": "238000.00"
	}
}

---

🇨🇴 Invopop resources for Colombia

Compliance	Invoicing compliance in Colombia Compliance timeline
Apps	DIAN Colombia
Guides	Supplier registration Issuing invoices
FAQ	Colombia FAQ
GOBL	Colombia Tax Regime Colombia DIAN Addon

Participate in our community

Ask and answer questions about DIAN Colombia App →