Introducción

Tablas de referencia de Factus, constantes tipadas del SDK y catálogos externos.

Las tablas de referencia de Factus definen los códigos que debes enviar en los campos de la API. En factus-js, los catálogos más usados están disponibles como constantes tipadas (*Code y *Info) para evitar valores errados y tener autocompletado en el editor.

Fuente oficial: Tablas de referencia

Modo de uso

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

*Code — mapa clave-valor para usar directamente en los campos de la API.
*Info — Siempre incluye description y en algunos casos, como para documentos de identidad, también incluye abbreviation.

Ejemplo

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

// Usar un código en un payload de la API
const docType = IdentityDocumentCode.CitizenshipCard; // "13"

// Descripción y abreviatura del código
const docInfo = IdentityDocumentCodeInfo[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.

Países, municipios, unidades de medida y monedas

Debido a su tamaño, estos datos no se incluyen como constantes dentro del SDK. Sin embargo, puedes consultarlos y descargarlos directamente desde la documentación oficial.

Catálogos en el SDK

General

Facturación, notas crédito y débito, RADIAN, pagos, identidad y rangos de numeración.

Nómina electrónica

Trabajador, contrato, devengados, deducciones y demás catálogos de nómina.