Tablas de referencia
General Constantes tipadas del SDK para facturación, notas, RADIAN y rangos de numeración.
Fuente oficial:
Tablas de referencia
import { BillDocumentCode, BillDocumentCodeInfo } from "factus-js" ;
const code = BillDocumentCode.ElectronicSalesInvoice;
console. log (code); // "01"
console. log (BillDocumentCodeInfo[code].description); // "Factura electronica de venta."
Clave Valor Descripción ElectronicSalesInvoice"01"Factura electrónica de venta. ElectronicTransmissionType03"03"Instrumento electrónico de transmisión - tipo 03.
import { OperationTypeCode, OperationTypeCodeInfo } from "factus-js" ;
const code = OperationTypeCode.Standard;
console. log (code); // "10"
console. log (OperationTypeCodeInfo[code].description); // "Estándar."
Clave Valor Descripción Standard"10"Estándar. Mandates"11"Mandatos. Transport"12"Transporte de carga. HealthCufe"SS-CUFE"Sector salud - CUFE. HealthReport"SS-Reporte"Sector salud - Reporte. HealthNoContribution"SS-SinAporte"Sector salud - Sin aporte. HealthCollection"SS-Recaudo"Sector salud - Recaudo de cuotas moderadoras o copagos.
import {
CreditNoteOperationCode,
CreditNoteOperationCodeInfo,
} from "factus-js" ;
const code = CreditNoteOperationCode.WithReference;
console. log (code); // "20"
console. log (CreditNoteOperationCodeInfo[code].description); // "Nota Crédito que referencia una factura electronica."
Clave Valor Descripción WithReference"20"Nota crédito que referencia una factura electrónica. WithoutReference"22"Nota crédito sin referencia a una factura electrónica.
import {
CreditNoteCorrectionCode,
CreditNoteCorrectionCodeInfo,
} from "factus-js" ;
const code = CreditNoteCorrectionCode.PriceAdjustment;
console. log (code); // "4"
console. log (CreditNoteCorrectionCodeInfo[code].description); // "Ajuste de precio."
Clave Valor Descripción PartialReturn"1"Devolución parcial de los bienes y/o no aceptación parcial del servicio. ElectronicInvoiceCancellation"2"Anulación de factura electrónica. PartialOrTotalDiscount"3"Rebaja o descuento parcial o total. PriceAdjustment"4"Ajuste de precio. EarlyPaymentDiscount"5"Descuento comercial por pronto pago. VolumeDiscount"6"Descuento comercial por volumen de ventas.
import { DebitNoteOperationCode, DebitNoteOperationCodeInfo } from "factus-js" ;
const code = DebitNoteOperationCode.WithReference;
console. log (code); // "30"
console. log (DebitNoteOperationCodeInfo[code].description); // "Nota Débito que referencia una factura electrónica."
Clave Valor Descripción WithReference"30"Nota débito que referencia una factura electrónica. WithoutReference"32"Nota débito sin referencia a una factura electrónica.
import {
DebitNoteCorrectionCode,
DebitNoteCorrectionCodeInfo,
} from "factus-js" ;
const code = DebitNoteCorrectionCode.ValueChange;
console. log (code); // "3"
console. log (DebitNoteCorrectionCodeInfo[code].description); // "Cambio del valor."
Clave Valor Descripción Interests"1"Intereses. CollectibleExpenses"2"Gastos por cobrar. ValueChange"3"Cambio del valor. Other"4"Otros.
import { ProductStandardCode, ProductStandardCodeInfo } from "factus-js" ;
const code = ProductStandardCode.TaxpayerAdoption;
console. log (code); // "999"
console. log (ProductStandardCodeInfo[code].description); // "Estándar de adopción del contribuyente"
Clave Valor Descripción TaxpayerAdoption"999"Estándar de adopción del contribuyente UNSPSC"001"UNSPSC TariffHeading"020"Partida arancelaria GTIN"010"GTIN
import { ClaimConceptCode, ClaimConceptCodeInfo } from "factus-js" ;
const code = ClaimConceptCode.DocumentInconsistencies;
console. log (code); // "01"
console. log (ClaimConceptCodeInfo[code].description); // "Documento con inconsistencias"
Clave Valor Descripción DocumentInconsistencies"01"Documento con inconsistencias GoodsNotDeliveredTotal"02"Mercancía no entregada totalmente GoodsNotDeliveredPartial"03"Mercancía no entregada parcialmente ServiceNotProvided"04"Servicio no prestado
import { EventCode, EventCodeInfo } from "factus-js" ;
const code = EventCode.ExpressAcceptance;
console. log (code); // "033"
console. log (EventCodeInfo[code].description); // "Aceptación expresa"
Clave Valor Descripción ReceiptAcknowledgement"030"Acuse de recibo de Factura Electronica de Venta BillClaim"031"Reclamo de la Factura Electronica de Venta GoodsOrServiceReceipt"032"Recibo del bien y/o prestación del servicio ExpressAcceptance"033"Aceptación expresa TacitAcceptance"034"Aceptación tacita
import { IdentityDocumentCode, IdentityDocumentCodeInfo } from "factus-js" ;
const code = IdentityDocumentCode.CitizenshipCard;
console. log (code); // "13"
console. log (IdentityDocumentCodeInfo[code].abbreviation); // "CC"
console. log (IdentityDocumentCodeInfo[code].description); // "Cédula de ciudadanía"
Clave Valor Abreviatura Descripción CivilRegistration"11"RC Registro civil IdentityCard"12"TI Tarjeta de identidad CitizenshipCard"13"CC Cédula de ciudadanía ForeignerIdentityCard"21"TE Tarjeta de extranjería ForeignerId"22"CE Cédula de extranjería NIT"31"NIT NIT Passport"41"PA Pasaporte ForeignIdentificationDocument"42"DE Documento de identificación extranjero PEP"47"PEP PEP PPT"48"PPT Permiso de Protección Temporal ForeignNIT"50"NE NIT otro país NUIP"91"NUIP NUIP
import {
SupportDocumentIdentityDocumentCode,
SupportDocumentIdentityDocumentCodeInfo,
} from "factus-js" ;
const code = SupportDocumentIdentityDocumentCode. NIT ;
console. log (code); // "31"
console. log (SupportDocumentIdentityDocumentCodeInfo[code].abbreviation); // "NIT"
console. log (SupportDocumentIdentityDocumentCodeInfo[code].description); // "NIT"
Clave Valor Abreviatura Descripción ForeignerIdentityCard"21"TE Tarjeta de extranjería ForeignerId"22"CE Cédula de extranjería NIT"31"NIT NIT Passport"41"PA Pasaporte ForeignIdentificationDocument"42"DE Documento de identificación extranjero PEP"47"PEP PEP ForeignNIT"50"NE NIT otro país
Usado en items[].period.generation_mode al crear un documento soporte.
Clave Valor Descripción ByOperation"1"Por operación (la compra se hizo el mismo día) WeeklyAccumulated"2"Acumulado semanal (compras de días anteriores)
import { CustomerTributeCode, CustomerTributeCodeInfo } from "factus-js" ;
const code = CustomerTributeCode. IVA ;
console. log (code); // "01"
console. log (CustomerTributeCodeInfo[code].description); // "IVA"
Clave Valor Descripción IVA"01"IVA NotApplicable"ZZ"No aplica
import { OrganizationTypeCode, OrganizationTypeCodeInfo } from "factus-js" ;
const code = OrganizationTypeCode.NaturalPerson;
console. log (code); // "2"
console. log (OrganizationTypeCodeInfo[code].description); // "Persona Natural"
Clave Valor Descripción LegalEntity"1"Persona Jurídica NaturalPerson"2"Persona Natural
import { PaymentMethodCode, PaymentMethodCodeInfo } from "factus-js" ;
const code = PaymentMethodCode.Transfer;
console. log (code); // "47"
console. log (PaymentMethodCodeInfo[code].description); // "Transferencia"
Clave Valor Descripción Cash"10"Efectivo BankDeposit"42"Consignación Check"20"Cheque Transfer"47"Transferencia Bonds"71"Bonos Vouchers"72"Vales Undefined"1"Medio de pago no definido DebitCard"49"Tarjeta Débito CreditCard"48"Tarjeta Crédito Cats"98"CATS (Nequi, Daviplata, etc.) Other"ZZZ"Otro
import { PaymentFormCode, PaymentFormCodeInfo } from "factus-js" ;
const code = PaymentFormCode.CreditPayment;
console. log (code); // "2"
console. log (PaymentFormCodeInfo[code].description); // "Pago a crédito"
Clave Valor Descripción CashPayment"1"Pago de contado CreditPayment"2"Pago a crédito
import {
NumberingRangeDocumentTypeCode,
NumberingRangeDocumentTypeCodeInfo,
} from "factus-js" ;
const code = NumberingRangeDocumentTypeCode.SalesInvoice;
console. log (code); // "21"
console. log (NumberingRangeDocumentTypeCodeInfo[code].description); // "Factura de Venta"
Clave Valor Descripción SalesInvoice"21"Factura de Venta CreditNote"22"Nota Crédito DebitNote"23"Nota Débito SupportDocument"24"Documento Soporte SupportDocumentAdjustmentNote"25"Nota de Ajuste Documento Soporte PaperOrStubInvoice"30"Factura de talonario y de papel
import {
PayrollNumberingRangeDocumentTypeCode,
PayrollNumberingRangeDocumentTypeCodeInfo,
} from "factus-js" ;
const code = PayrollNumberingRangeDocumentTypeCode.Payroll;
console. log (code); // "26"
console. log (PayrollNumberingRangeDocumentTypeCodeInfo[code].description); // "Nómina Electrónica"
Usado con factus.numberingRanges.payrolls.create(). No incluye el código 28.
Clave Valor Descripción Payroll"26"Nómina Electrónica PayrollAdjustmentNote"27"Nota de ajuste Nómina Electrónica
import {
AdjustmentNoteReasonCode,
AdjustmentNoteReasonCodeInfo,
} from "factus-js" ;
const code = AdjustmentNoteReasonCode.PriceAdjustment;
console. log (code); // "4"
console. log (AdjustmentNoteReasonCodeInfo[code].description); // "Ajuste de precio"
Clave Valor Descripción PartialReturn"1"Devolución parcial de los bienes y/o no aceptación parcial del servicio SupportDocumentCancellation"2"Anulación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente PartialOrTotalDiscount"3"Rebaja o descuento parcial o total PriceAdjustment"4"Ajuste de precio Other"5"Otros
import { ChargeDiscountCode, ChargeDiscountCodeInfo } from "factus-js" ;
const code = ChargeDiscountCode.ConditionalSurcharge;
console. log (code); // "03"
console. log (ChargeDiscountCodeInfo[code].description); // "Recargo condicionado"
Clave Valor Descripción UnconditionalDiscount"00"Descuento no condicionado ConditionalDiscount"01"Descuento condicionado UnconditionalSurcharge"02"Recargo no condicionado ConditionalSurcharge"03"Recargo condicionado
import {
FiscalResponsibilityCode,
FiscalResponsibilityCodeInfo,
} from "factus-js" ;
const code = FiscalResponsibilityCode.NotResponsible;
console. log (code); // "R-99-PN"
console. log (FiscalResponsibilityCodeInfo[code].description); // "No responsable"
Clave Valor Descripción LargeTaxpayer"O-13"Gran contribuyente SelfWithholdingAgent"O-15"Autorretenedor VATWithholdingAgent"O-23"Agente de retención de IVA SimpleTaxRegime"O-47"Regimen simple de tributación NotResponsible"R-99-PN"No responsable
Usado en health.coverage_code en facturas de sector salud.
Clave Valor Descripción UpcBenefitsPlan"01"Plan de beneficios en salud financiado con UPC MaximumBudget"02"Presupuesto máximo EpsEocPremiumUninsuredSoat"03"Prima EPS / EOC, no asegurados SOAT SoatPolicyCoverage"04"Cobertura Póliza SOAT ArlCoverage"05"Cobertura ARL AdresCoverage"06"Cobertura ADRES PublicHealthCoverage"07"Cobertura Salud Pública TerritorialEntityOfferResources"08"Cobertura entidad territorial, recursos de oferta MigrantPopulationEmergencies"09"Urgencias población migrante ComplementaryHealthPlan"10"Plan complementario en salud PrepaidMedicinePlan"11"Plan medicina prepagada OtherHealthPolicies"12"Otras pólizas en salud SpecialOrExceptionRegime"13"Cobertura Régimen Especial o Excepción PrivateLibertyNationalHealthFund"14"Cobertura Fondo Nacional de Salud de Personas Privadas de la Libertad Private"15"Particular UpcContributoryRegime"16"Plan UPC régimen contributivo UpcSubsidizedRegime"17"Plan UPC régimen subsidiado
Usado en health.payment_method_code. No reutiliza PaymentMethodCode de DIAN.
Clave Valor Descripción IndividualCaseOrPackage"01"Pago individual por caso / conjunto integral de atenciones / paquete / canasta ProspectiveGlobal"02"Pago global prospectivo Capitation"03"Pago por capitación Event"04"Pago por evento
Usado en health.without_contract_code cuando no se envía contract_number.
Clave Valor Descripción EmergencyCare"01"Atención de urgencias AdresSoatOrVoluntaryPlans"02"Atención a cargo de ADRES o de Aseguradora SOAT, planes voluntarios de salud TutelaOrCourtOrders"03"Atención en salud por fallos de tutela / órdenes judiciales PortabilityOrMassAssignment"04"Atención en salud por portabilidad o asignación masiva de afiliados ExceptionalContributions"05"Atención en salud en casos excepcionales por cotizaciones o autorizaciones sin contrato OrganRecoveryForTransplant"06"Gestión recuperación de órganos para trasplante PrivatePatients"07"Atención a pacientes particulares
Catálogo de beneficiario (beneficiary.identification_document_code). No reutiliza los códigos DIAN numéricos.
Clave Valor Descripción CitizenshipCard"CC"Cédula de ciudadanía ForeignerId"CE"Cédula de extranjería DiplomaticCard"CD"Carné diplomático Passport"PA"Pasaporte SafeConduct"SC"Salvoconducto SpecialPermanencePermit"PE"Permiso especial de permanencia CivilRegistration"RC"Registro civil de nacimiento IdentityCard"TI"Tarjeta de identidad LiveBirthCertificate"CN"Certificado de nacido vivo UnidentifiedAdult"AS"Adulto sin identificar UnidentifiedMinor"MS"Menor sin identificar ForeignDocument"DE"Documento extranjero WithoutIdentification"SI"Sin identificación TemporaryProtectionPermit"PT"Permiso por protección temporal