factus-js iconfactus-js
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

Modo de uso

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.

Descripciones y abreviaturas (*Info)

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.

Tipo de documento de factura (InvoiceDocumentType)

import { InvoiceDocumentType } from "factus-js";
ClaveValorDescripción
ElectronicSalesInvoice"01"Factura electrónica de venta.
ElectronicTransmissionType03"03"Instrumento electrónico de transmisión - tipo 03.

Tipo de operación (OperationTypeCode)

import { OperationTypeCode } from "factus-js";
ClaveValorDescripción
Standard"10"Estándar.
Mandates"11"Mandatos.
Transport"12"Transporte.

Tipo de operación en nota crédito (CreditNoteOperationTypeCode)

import { CreditNoteOperationTypeCode } from "factus-js";
ClaveValorDescripción
WithReference"20"Nota Crédito que referencia una factura electrónica.
WithoutReference"22"Nota Crédito sin referencia a una factura electrónica.

Concepto de corrección de nota crédito (CreditNoteCorrectionCode)

import { CreditNoteCorrectionCode } from "factus-js";
ClaveValorDescripció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.

Estándar de producto (ProductStandardId)

import { ProductStandardId } from "factus-js";
ClaveValorDescripción
TaxpayerAdoption"1"Estándar de adopción del contribuyente
UNSPSC"2"UNSPSC
TariffHeading"3"Partida Arancelaria
GTIN"4"GTIN

Concepto de reclamo (ClaimConceptCode)

import { ClaimConceptCode } from "factus-js";
ClaveValorDescripció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

Código de evento (EventCode)

import { EventCode } from "factus-js";
ClaveValorDescripció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

Tipo de documento de identificación (IdentityDocumentTypeId)

import { IdentityDocumentTypeId } from "factus-js";

// Código para la API como string (p. ej. identification_document_id)
const docType = IdentityDocumentTypeId.CitizenshipId; // "3"
ClaveValorAbreviaturaDescripción
CivilRegistration"1"RCRegistro civil
IdentityCard"2"TITarjeta de identidad
CitizenshipId"3"CCCédula de ciudadanía
ForeignerCard"4"TETarjeta de extranjería
ForeignerId"5"CECédula de extranjería
NIT"6"NITNIT
Passport"7"PAPasaporte
ForeignIdentificationDocument"8"DEDocumento de identificación extranjero
PEP"9"PEPPEP
ForeignNIT"10"NENIT otro país
NUIP"11"NUIPNUIP

Tipo de identificación para documento soporte (SupportDocumentIdentityTypeId)

import { SupportDocumentIdentityTypeId } from "factus-js";
ClaveValorAbreviaturaDescripción
ForeignerCard"4"TETarjeta de extranjería
ForeignerId"5"CECédula de extranjería
NIT"6"NITNIT
Passport"7"PAPasaporte
ForeignIdentificationDocument"8"DEDocumento de identificación extranjero
PEP"9"PEPPEP
ForeignNIT"10"NENIT otro país

Tributo del cliente (CustomerTributeId)

import { CustomerTributeId } from "factus-js";
ClaveValorDescripción
IVA"18"IVA
NotApplicable"21"No aplica

Tipo de organización (OrganizationTypeId)

import { OrganizationTypeId } from "factus-js";
ClaveValorDescripción
LegalEntity"1"Persona Jurídica
NaturalPerson"2"Persona Natural

Método de pago (PaymentMethodCode)

import { PaymentMethodCode } from "factus-js";
ClaveValorDescripció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

Forma de pago (PaymentFormCode)

import { PaymentFormCode } from "factus-js";
ClaveValorDescripción
CashPayment"1"Pago de contado
CreditPayment"2"Pago a crédito

Tipo de documento en rangos de numeración (NumberingRangeDocumentTypeCode)

import { NumberingRangeDocumentTypeCode } from "factus-js";
ClaveValorDescripció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

Concepto de corrección de nota de ajuste (AdjustmentNoteReasonCode)

import { AdjustmentNoteReasonCode } from "factus-js";
ClaveValorDescripció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

Tipo de cargo o descuento (ChargeDiscountCode)

import { ChargeDiscountCode } from "factus-js";
ClaveValorDescripció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

Responsabilidad fiscal (FiscalResponsibilityCode)

import { FiscalResponsibilityCode } from "factus-js";
ClaveValorDescripció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

En esta página