> ## Documentation Index > Fetch the complete documentation index at: https://invopop-auto-sync-workflow-templates.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # DIAN Colombia > Submit invoices to the Colombian DIAN system.
Supplier registration guide › Issuing guide ›
| | | | --------- | -------------------------------- | | Developer | [Invopop](https://invopop.com) | | Category | Government | | Scope | B2B, B2C | | Country | [Colombia](/compliance/colombia) | The [DIAN](https://www.dian.gov.co/) 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](https://plemsi.com) 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](/guides/co-dian-supplier) for onboarding suppliers, and the [Issuing invoices guide](/guides/co-dian) for issuing invoices and setting up your workflows. ## FAQ Invoicing questions The DIAN requires a [Municipal Code](https://www.dian.gov.co/atencionciudadano/formulariosinstructivos/Formularios/2007/Codigos_municipios_2007.pdf) 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`](https://docs.gobl.org/addons/co-dian-v2) extension. Through [Plemsi](https://plemsi.com), an authorized technology provider for DIAN electronic invoicing. The [DIAN Colombia workflow](/guides/co-dian) 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. 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`](https://docs.gobl.org/addons/co-dian-v2) extension in each party's `ext`. See the [GOBL Colombia tax regime](https://github.com/invopop/gobl/blob/main/regimes/co/README.md) for the full field reference and examples. 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](https://docs.gobl.org/regimes/co#tax-categories). 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. 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 [support@invopop.com](mailto:support@invopop.com) to enable the sandbox in your workspace. Registering supplier questions 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](/guides/co-dian-supplier) walks through each step. 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 [support@invopop.com](mailto:support@invopop.com) with the supplier's company details so we can create and configure the Plemsi account. See the [supplier registration guide](/guides/co-dian-supplier) for the full checklist. 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. 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. 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](/faq/colombia) section The following workflow actions will be available once you install and enable this app:
5
Process invoices using Plemsi in Colombia. The following workflows are available to make your integration easier. Use them as templates to build upon. This workflow automates FEV Colombian invoice processing and tax compliance. ```json Example DIAN issue invoice workflow theme={"system"} { "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 →](https://console.invopop.com/redirect/workflows/new?template=co-dian-invoice) A NIT (`tin` type) with the `co-dian-municipality` extension identifying where the supplier is registered. ```json Colombia supplier example theme={"system"} { "$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": "facturacion@examplesupplier.co" } ], "ext": { "co-dian-municipality": "11001" } } ``` A business customer with NIT, municipality extension, and the contact details DIAN expects on the invoice. ```json Colombia customer example theme={"system"} { "$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": "benito.ortiz@example.com" } ], "telephones": [ { "num": "3114131811" } ], "ext": { "co-dian-municipality": "11001" } } ``` 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`](https://docs.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. ```json DIAN Colombia B2B Invoice theme={"system"} { "$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": "benito.ortiz@example.com" } ], "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%" } ] } } } ``` ```json Built version theme={"system"} { "$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": "benito.ortiz@example.com" } ], "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" } } ``` 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. ```json DIAN Colombia B2C Invoice theme={"system"} { "$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%" } ] } } ``` ```json Built version theme={"system"} { "$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" } } ``` 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. ```json DIAN Colombia Credit Note theme={"system"} { "$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": "benito.ortiz@example.com" } ], "telephones": [ { "num": "3114131811" } ] }, "lines": [ { "quantity": "1", "item": { "name": "Servicios Mes de Julio 2022", "price": "200000.00" }, "taxes": [ { "cat": "VAT", "percent": "19%" } ] } ] } ``` ```json Built version theme={"system"} { "$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": "benito.ortiz@example.com" } ], "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" } } ``` *** | | | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Compliance | [Invoicing compliance in Colombia](/compliance/colombia)
[Compliance timeline](/timelines/colombia) | | Apps | [DIAN Colombia](/apps/dian-colombia) | | Guides | [Supplier registration](/guides/co-dian-supplier)
[Issuing invoices](/guides/co-dian) | | FAQ | [Colombia FAQ](/faq/colombia) | | GOBL | [Colombia Tax Regime](https://docs.gobl.org/regimes/co)
[Colombia DIAN Addon](https://docs.gobl.org/addons/co-dian-v2) | Ask and answer questions about DIAN Colombia App →