co

README

🇨🇴 GOBL Colombia Tax Regime

Example CO GOBL files can be found in the examples (YAML uncalculated documents) and examples/out (JSON calculated envelopes) subdirectories.

Zones

Colombia requires zones to be defined in supplier and customer party's tax identity.

Invoice Series & Code

Invoices ("Facturas de Venta") as expected in many countries require a series and unique sequential code to be issued for each document. The DIAN in colombia however have gone a step further and require invoice series to be pre-registered with the government.

Details on how to do this are available here.

Documentation

Overview

Package co handles tax regime data for Colombia.

Index

• Constants
• func Calculate(doc interface{}) error
• func New() *tax.Regime
• func Validate(doc interface{}) error

Constants

const (
	StampProviderDIANCUDE cbc.Key = "dian-cude"
	StampProviderDIANQR   cbc.Key = "dian-qr"
)

DIAN official codes to include in stamps.

const (
	KeyDIAN                    cbc.Key = "dian"
	KeyDIANCompanyID           cbc.Key = "dian-company-id"
	KeyDIANAdditionalAccountID cbc.Key = "dian-additional-account-id"
)

Special keys to use in meta data.

const (
	ExtKeyDIANMunicipality cbc.Key = "co-dian-municipality"
	ExtKeyDIANCorrection   cbc.Key = "co-dian-correction"
)

Extension keys used in Colombia.

const (
	TaxCategoryIC        cbc.Code = "IC"  // Impuesto Consumo
	TaxCategoryICA       cbc.Code = "ICA" // Impuesto de Industria y Comercio
	TaxCategoryINC       cbc.Code = "INC"
	TaxCategoryReteIVA   cbc.Code = "RVAT" // ReteIVA
	TaxCategoryReteRenta cbc.Code = "RR"   // ReteRenta
	TaxCategoryReteICA   cbc.Code = "RICA" // ReteICA
)

Local tax categories.

const (
	TaxIdentityTypeTIN        cbc.Key = "tin"
	TaxIdentityTypeCard       cbc.Key = "card"
	TaxIdentityTypeCitizen    cbc.Key = "citizen"
	TaxIdentityTypePassport   cbc.Key = "passport"
	TaxIdentityTypeIndividual cbc.Key = "individual"
	TaxIdentityTypeCivil      cbc.Key = "civil"
	TaxIdentityTypeForeign    cbc.Key = "foreign"
	TaxIdentityTypeForeigner  cbc.Key = "foreigner"
	TaxIdentityTypePEP        cbc.Key = "pep"
	TaxIdentityTypeNUIP       cbc.Key = "nuip"

	TaxCodeFinalCustomer cbc.Code = "222222222222"
)

Known base tax identity types for Colombia

Functions

func Calculate

func Calculate(doc interface{}) error

Calculate will attempt to clean the object passed to it.

func New

func New() *tax.Regime

New provides the tax region definition

func Validate

func Validate(doc interface{}) error

Validate checks the document type and determines if it can be validated.