factus-js iconfactus-js
Tablas de referencia

General

Constantes tipadas del SDK para facturación, notas, RADIAN y rangos de numeración.

Fuente oficial: Tablas de referencia

Tipo de documento de factura (BillDocumentCode)

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

const code = BillDocumentCode.ElectronicSalesInvoice;

console.log(code); // "01"
console.log(BillDocumentCodeInfo[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 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.

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

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

Tipo de operación en nota débito (DebitNoteOperationCode)

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."
ClaveValorDescripción
WithReference"30"Nota débito que referencia una factura electrónica.
WithoutReference"32"Nota débito sin referencia a una factura electrónica.

Concepto de corrección de nota débito (DebitNoteCorrectionCode)

import {
  DebitNoteCorrectionCode,
  DebitNoteCorrectionCodeInfo,
} from "factus-js";

const code = DebitNoteCorrectionCode.ValueChange;

console.log(code); // "3"
console.log(DebitNoteCorrectionCodeInfo[code].description); // "Cambio del valor."
ClaveValorDescripción
Interests"1"Intereses.
CollectibleExpenses"2"Gastos por cobrar.
ValueChange"3"Cambio del valor.
Other"4"Otros.

Estándar de producto (ProductStandardCode)

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

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

const code = IdentityDocumentCode.CitizenshipCard;

console.log(code); // "13"
console.log(IdentityDocumentCodeInfo[code].abbreviation); // "CC"
console.log(IdentityDocumentCodeInfo[code].description); // "Cédula de ciudadanía"
ClaveValorAbreviaturaDescripción
CivilRegistration"11"RCRegistro civil
IdentityCard"12"TITarjeta de identidad
CitizenshipCard"13"CCCédula de ciudadanía
ForeignerIdentityCard"21"TETarjeta de extranjería
ForeignerId"22"CECédula de extranjería
NIT"31"NITNIT
Passport"41"PAPasaporte
ForeignIdentificationDocument"42"DEDocumento de identificación extranjero
PEP"47"PEPPEP
PPT"48"PPTPermiso de Protección Temporal
ForeignNIT"50"NENIT otro país
NUIP"91"NUIPNUIP

Tipo de identidad para documento soporte (SupportDocumentIdentityDocumentCode)

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"
ClaveValorAbreviaturaDescripción
ForeignerIdentityCard"21"TETarjeta de extranjería
ForeignerId"22"CECédula de extranjería
NIT"31"NITNIT
Passport"41"PAPasaporte
ForeignIdentificationDocument"42"DEDocumento de identificación extranjero
PEP"47"PEPPEP
ForeignNIT"50"NENIT otro país

Forma de generación documento soporte (SupportDocumentGenerationModeCode)

Usado en items[].period.generation_mode al crear un documento soporte.

ClaveValorDescripción
ByOperation"1"Por operación (la compra se hizo el mismo día)
WeeklyAccumulated"2"Acumulado semanal (compras de días anteriores)

Tributo del cliente (CustomerTributeCode)

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

const code = CustomerTributeCode.IVA;

console.log(code); // "01"
console.log(CustomerTributeCodeInfo[code].description); // "IVA"
ClaveValorDescripción
IVA"01"IVA
NotApplicable"ZZ"No aplica

Tipo de organización (OrganizationTypeCode)

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

const code = OrganizationTypeCode.NaturalPerson;

console.log(code); // "2"
console.log(OrganizationTypeCodeInfo[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
Cats"98"CATS (Nequi, Daviplata, etc.)
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
PaperOrStubInvoice"30"Factura de talonario y de papel

Tipo de documento en rangos de numeración nómina (PayrollNumberingRangeDocumentTypeCode)

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.

ClaveValorDescripción
Payroll"26"Nómina Electrónica
PayrollAdjustmentNote"27"Nota de ajuste Nómina Electrónica

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
ConditionalDiscount"01"Descuento condicionado
UnconditionalSurcharge"02"Recargo no condicionado
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"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

Plan de cobertura en salud (HealthCoverageCode)

Usado en health.coverage_code en facturas de sector salud.

ClaveValorDescripció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

Método de pago en salud (HealthPaymentMethodCode)

Usado en health.payment_method_code. No reutiliza PaymentMethodCode de DIAN.

ClaveValorDescripció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

Causal de factura sin contrato (HealthWithoutContractCode)

Usado en health.without_contract_code cuando no se envía contract_number.

ClaveValorDescripció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

Documento de identidad sector salud (HealthIdentityDocumentCode)

Catálogo de beneficiario (beneficiary.identification_document_code). No reutiliza los códigos DIAN numéricos.

ClaveValorDescripció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

En esta página