Tablas de referencia

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

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

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";

const paymentForm = PaymentFormCode.CashPayment; // "1"
const event = EventCode.ExpressAcceptance; // "033"

Las constantes se exportan desde la raíz del paquete y no requieren llamadas HTTP. El único lookup runtime relacionado en esta área es factus.acquirer.get().

Datos de referencia externos

Factus documenta países, municipios y unidades de medida como tablas de referencia externas. El SDK no expone endpoints runtime para esos datasets.

Descripciones y abreviaturas (`*Info`)

Para mostrar etiquetas legibles en UI, importa los mapas *Info complementarios desde factus-js:

import {
  PaymentFormCode,
  PaymentFormCodeInfo,
  IdentityDocumentCode,
  IdentityDocumentCodeInfo,
} from "factus-js";

const desc = PaymentFormCodeInfo[PaymentFormCode.CashPayment].description;
const abbr =
  IdentityDocumentCodeInfo[IdentityDocumentCode.CitizenshipCard].abbreviation;

Tipo de documento de factura (`BillDocumentCode`)

import { BillDocumentCode, BillDocumentCodeInfo } from "factus-js";

Clave	Valor	Descripció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";

Clave	Valor	Descripción
`Standard`	`"10"`	Estándar.
`Mandates`	`"11"`	Mandatos.
`Transport`	`"12"`	Transporte.
`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.

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

import {
  CreditNoteOperationCode,
  CreditNoteOperationCodeInfo,
} 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.

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

import {
  CreditNoteCorrectionCode,
  CreditNoteCorrectionCodeInfo,
} from "factus-js";

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.

Estándar de producto (`ProductStandardCode`)

import { ProductStandardCode, ProductStandardCodeInfo } from "factus-js";

Clave	Valor	Descripción
`TaxpayerAdoption`	`"999"`	Estándar de adopción del contribuyente
`UNSPSC`	`"001"`	UNSPSC
`TariffHeading`	`"020"`	Partida arancelaria
`GTIN`	`"010"`	GTIN

Concepto de reclamo (`ClaimConceptCode`)

import { ClaimConceptCode, ClaimConceptCodeInfo } 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

Código de evento (`EventCode`)

import { EventCode, EventCodeInfo } from "factus-js";

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

Tipo de documento de identidad (`IdentityDocumentCode`)

import { IdentityDocumentCode, IdentityDocumentCodeInfo } from "factus-js";

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

Tipo de identidad para documento soporte (`SupportDocumentIdentityDocumentCode`)

import {
  SupportDocumentIdentityDocumentCode,
  SupportDocumentIdentityDocumentCodeInfo,
} from "factus-js";

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

Tributo del cliente (`CustomerTributeCode`)

import { CustomerTributeCode, CustomerTributeCodeInfo } from "factus-js";

Clave	Valor	Descripción
`IVA`	`"01"`	IVA
`NotApplicable`	`"ZZ"`	No aplica

Tipo de organización (`OrganizationTypeCode`)

import { OrganizationTypeCode, OrganizationTypeCodeInfo } from "factus-js";

Clave	Valor	Descripción
`LegalEntity`	`"1"`	Persona Jurídica
`NaturalPerson`	`"2"`	Persona Natural

Método de pago (`PaymentMethodCode`)

import { PaymentMethodCode, PaymentMethodCodeInfo } 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

Forma de pago (`PaymentFormCode`)

import { PaymentFormCode, PaymentFormCodeInfo } from "factus-js";

Clave	Valor	Descripció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";

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

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

import {
  AdjustmentNoteReasonCode,
  AdjustmentNoteReasonCodeInfo,
} 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

Tipo de cargo o descuento (`ChargeDiscountCode`)

import { ChargeDiscountCode, ChargeDiscountCodeInfo } from "factus-js";

Clave	Valor	Descripción
`UnconditionalDiscount`	`"00"`	Descuento no condicionado
`ConditionalDiscount`	`"01"`	Descuento condicionado
`UnconditionalSurcharge`	`"02"`	Recargo no condicionado
`ConditionalSurcharge`	`"03"`	Recargo condicionado

Responsabilidad fiscal (`FiscalResponsibilityCode`)

import {
  FiscalResponsibilityCode,
  FiscalResponsibilityCodeInfo,
} 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

Tablas de referencia

En esta página