ℹ️ Estás viendo la documentación para factus-js v1 — Encuentra la última versión aquí.
factus-js iconfactus-js
Catálogo

Tablas de referencia (Constantes)

Constantes tipadas del SDK y enlaces oficiales para datos de referencia en Factus API v1.

Esta guía consolida las tablas oficiales de Factus y su equivalente en constantes de factus-js.

Fuente oficial: Tablas de referencia

Modo de uso

Cada tabla de referencia se expone desde la raíz del paquete y sigue el mismo patrón:

  • Mapa de constantes — clave-valor para usar directamente en los campos de la API.
  • Mapa *Info — metadatos legibles. Siempre incluye description y, en algunos casos (como documentos de identidad), también abbreviation.

Ejemplo

import { IdentityDocumentTypeId, IdentityDocumentTypeIdInfo } from "factus-js";

// Usar un código en un payload de la API
const docType = IdentityDocumentTypeId.CitizenshipId; // "3"

// Descripción y abreviatura del código
const docInfo = IdentityDocumentTypeIdInfo[docType];
console.log(docInfo.description); // "Cédula de ciudadanía"
console.log(docInfo.abbreviation); // "CC"

Estas constantes están declaradas explícitamente y no realizan llamadas HTTP.

Tipo de documento de factura (BillDocumentType)

import { BillDocumentType, BillDocumentTypeInfo } from "factus-js";

const code = BillDocumentType.ElectronicSalesInvoice;

console.log(code); // "01"
console.log(BillDocumentTypeInfo[code].description); // "Factura electronica de venta."
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, OperationTypeCodeInfo } from "factus-js";

const code = OperationTypeCode.Standard;

console.log(code); // "10"
console.log(OperationTypeCodeInfo[code].description); // "Estándar."
ClaveValorDescripción
Standard"10"Estándar.
Mandates"11"Mandatos.
Transport"12"Transporte.

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

import {
  CreditNoteOperationTypeCode,
  CreditNoteOperationTypeCodeInfo,
} from "factus-js";

const code = CreditNoteOperationTypeCode.WithReference;

console.log(code); // "20"
console.log(CreditNoteOperationTypeCodeInfo[code].description); // "Nota Crédito que referencia una factura electronica."
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,
  CreditNoteCorrectionCodeInfo,
} from "factus-js";

const code = CreditNoteCorrectionCode.PriceAdjustment;

console.log(code); // "4"
console.log(CreditNoteCorrectionCodeInfo[code].description); // "Ajuste de precio."
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, ProductStandardIdInfo } from "factus-js";

const code = ProductStandardId.TaxpayerAdoption;

console.log(code); // "1"
console.log(ProductStandardIdInfo[code].description); // "Estándar de adopción del contribuyente"
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, ClaimConceptCodeInfo } from "factus-js";

const code = ClaimConceptCode.DocumentInconsistencies;

console.log(code); // "01"
console.log(ClaimConceptCodeInfo[code].description); // "Documento con inconsistencias"
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, EventCodeInfo } from "factus-js";

const code = EventCode.ExpressAcceptance;

console.log(code); // "033"
console.log(EventCodeInfo[code].description); // "Aceptación expresa"
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, IdentityDocumentTypeIdInfo } from "factus-js";

const code = IdentityDocumentTypeId.CitizenshipId;

console.log(code); // "3"
console.log(IdentityDocumentTypeIdInfo[code].abbreviation); // "CC"
console.log(IdentityDocumentTypeIdInfo[code].description); // "Cédula de ciudadanía"
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,
  SupportDocumentIdentityTypeIdInfo,
} from "factus-js";

const code = SupportDocumentIdentityTypeId.NIT;

console.log(code); // "6"
console.log(SupportDocumentIdentityTypeIdInfo[code].abbreviation); // "NIT"
console.log(SupportDocumentIdentityTypeIdInfo[code].description); // "NIT"
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, CustomerTributeIdInfo } from "factus-js";

const code = CustomerTributeId.IVA;

console.log(code); // "18"
console.log(CustomerTributeIdInfo[code].description); // "IVA"
ClaveValorDescripción
IVA"18"IVA
NotApplicable"21"No aplica

Tipo de organización (OrganizationTypeId)

import { OrganizationTypeId, OrganizationTypeIdInfo } from "factus-js";

const code = OrganizationTypeId.NaturalPerson;

console.log(code); // "2"
console.log(OrganizationTypeIdInfo[code].description); // "Persona Natural"
ClaveValorDescripción
LegalEntity"1"Persona Jurídica
NaturalPerson"2"Persona Natural

Método de pago (PaymentMethodCode)

import { PaymentMethodCode, PaymentMethodCodeInfo } from "factus-js";

const code = PaymentMethodCode.Transfer;

console.log(code); // "47"
console.log(PaymentMethodCodeInfo[code].description); // "Transferencia"
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, PaymentFormCodeInfo } from "factus-js";

const code = PaymentFormCode.CreditPayment;

console.log(code); // "2"
console.log(PaymentFormCodeInfo[code].description); // "Pago a crédito"
ClaveValorDescripción
CashPayment"1"Pago de contado
CreditPayment"2"Pago a crédito

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

import {
  NumberingRangeDocumentTypeCode,
  NumberingRangeDocumentTypeCodeInfo,
} from "factus-js";

const code = NumberingRangeDocumentTypeCode.SalesInvoice;

console.log(code); // "21"
console.log(NumberingRangeDocumentTypeCodeInfo[code].description); // "Factura de Venta"
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,
  AdjustmentNoteReasonCodeInfo,
} from "factus-js";

const code = AdjustmentNoteReasonCode.PriceAdjustment;

console.log(code); // "4"
console.log(AdjustmentNoteReasonCodeInfo[code].description); // "Ajuste de precio"
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, ChargeDiscountCodeInfo } from "factus-js";

const code = ChargeDiscountCode.ConditionalSurcharge;

console.log(code); // "03"
console.log(ChargeDiscountCodeInfo[code].description); // "Recargo condicionado"
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,
  FiscalResponsibilityCodeInfo,
} from "factus-js";

const code = FiscalResponsibilityCode.NotResponsible;

console.log(code); // "R-99-PN"
console.log(FiscalResponsibilityCodeInfo[code].description); // "No responsable"
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