Catálogo
Tablas de referencia (Constantes) Códigos DIAN y tablas de negocio expuestos como constantes tipadas.
Esta página consolida las tablas oficiales de Factus y su equivalente en
constantes de factus-js.
Fuente oficial:
Tablas de referencia
Si instalaste factus-js, las constantes ya están disponibles. Cada constante es un mapa de claves a valores string, por lo que puedes usarlas directamente en los campos de la API:
import { PaymentFormCode, EventCode } from "factus-js" ;
// Usar directamente en un payload de API
const paymentForm = PaymentFormCode.CashPayment; // "1"
const event = EventCode.ExpressAcceptance; // "033"
Estas tablas no se consultan por HTTP: se exponen como constantes tipadas.
Para datos dinámicos (países, municipios, tributos, adquirientes), usa los
demás métodos de factus.catalog.
Para mostrar etiquetas legibles en una interfaz de usuario (selectores, tablas, etc.), importa los mapas *Info complementarios desde factus-js:
import {
PaymentFormCode,
PaymentFormCodeInfo,
IdentityDocumentTypeId,
IdentityDocumentTypeIdInfo,
} from "factus-js" ;
// Obtener descripción de un valor
const desc = PaymentFormCodeInfo[PaymentFormCode.CashPayment].description;
// "Pago de contado"
// Obtener abreviatura (disponible en documentos de identidad)
const abbr = IdentityDocumentTypeIdInfo[IdentityDocumentTypeId.CitizenshipId].abbreviation;
// "CC"
Cada *Info exportado tiene una entrada por cada clave del mapa de constantes correspondiente, con al menos description y, cuando aplica, abbreviation.
import { InvoiceDocumentType } from "factus-js" ;
Clave Valor Descripción ElectronicSalesInvoice"01"Factura electrónica de venta. ElectronicTransmissionType03"03"Instrumento electrónico de transmisión - tipo 03.
import { OperationTypeCode } from "factus-js" ;
Clave Valor Descripción Standard"10"Estándar. Mandates"11"Mandatos. Transport"12"Transporte.
import { CreditNoteOperationTypeCode } from "factus-js" ;
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 } from "factus-js" ;
Clave Valor Descripción PartialReturn"1"Devolución parcial de los bienes y/o no aceptación parcial del servicio. InvoiceCancellation"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 { ProductStandardId } from "factus-js" ;
Clave Valor Descripción TaxpayerAdoption"1"Estándar de adopción del contribuyente UNSPSC"2"UNSPSC TariffHeading"3"Partida Arancelaria GTIN"4"GTIN
import { ClaimConceptCode } from "factus-js" ;
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 } from "factus-js" ;
Clave Valor Descripción ReceiptAcknowledgement"030"Acuse de recibo de Factura Electronica de Venta InvoiceClaim"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 { IdentityDocumentTypeId } from "factus-js" ;
// Código para la API como string (p. ej. identification_document_id)
const docType = IdentityDocumentTypeId.CitizenshipId; // "3"
Clave Valor Abreviatura Descripción CivilRegistration"1"RC Registro civil IdentityCard"2"TI Tarjeta de identidad CitizenshipId"3"CC Cédula de ciudadanía ForeignerCard"4"TE Tarjeta de extranjería ForeignerId"5"CE Cédula de extranjería NIT"6"NIT NIT Passport"7"PA Pasaporte ForeignIdentificationDocument"8"DE Documento de identificación extranjero PEP"9"PEP PEP ForeignNIT"10"NE NIT otro país NUIP"11"NUIP NUIP
import { SupportDocumentIdentityTypeId } from "factus-js" ;
Clave Valor Abreviatura Descripción ForeignerCard"4"TE Tarjeta de extranjería ForeignerId"5"CE Cédula de extranjería NIT"6"NIT NIT Passport"7"PA Pasaporte ForeignIdentificationDocument"8"DE Documento de identificación extranjero PEP"9"PEP PEP ForeignNIT"10"NE NIT otro país
import { CustomerTributeId } from "factus-js" ;
Clave Valor Descripción IVA"18"IVA NotApplicable"21"No aplica
import { OrganizationTypeId } from "factus-js" ;
Clave Valor Descripción LegalEntity"1"Persona Jurídica NaturalPerson"2"Persona Natural
import { PaymentMethodCode } from "factus-js" ;
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 Other"ZZZ"Otro
import { PaymentFormCode } from "factus-js" ;
Clave Valor Descripción CashPayment"1"Pago de contado CreditPayment"2"Pago a crédito
import { NumberingRangeDocumentTypeCode } from "factus-js" ;
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 Payroll"26"Nomina PayrollAdjustmentNote"27"Nota de Ajuste Nomina PayrollDeletionNote"28"Nota de eliminación de nomina PaperOrStubInvoice"30"Factura de talonario y de papel
import { AdjustmentNoteReasonCode } from "factus-js" ;
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 } from "factus-js" ;
Clave Valor Descripción UnconditionalDiscount"00"Descuento no condicionado (disponible próximamente) ConditionalDiscount"01"Descuento condicionado (disponible próximamente) UnconditionalSurcharge"02"Recargo no condicionado (disponible próximamente) ConditionalSurcharge"03"Recargo condicionado
import { FiscalResponsibilityCode } from "factus-js" ;
Clave Valor Descripción LargeTaxpayer"O-13"Gran contribuyente SelfWithholdingAgent"0-15"Autorretenedor VATWithholdingAgent"0-23"Agente de retención de IVA SimpleTaxRegime"0-47"Regimen simple de tributación NotResponsible"R-99-PN"No responsable