npm - @dojocoding/hacienda-mcp - Versions diffs - 0.2.0 → 0.3.0 - Mend

@dojocoding/hacienda-mcp 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md +4 -3
package/dist/{chunk-NJFDE5LL.js → chunk-B2GJ3MA4.js} +1628 -928
package/dist/cli.js +1 -1
package/dist/index.js +1 -1
package/package.json +3 -3

package/dist/{chunk-NJFDE5LL.js → chunk-B2GJ3MA4.js} RENAMED Viewed

@@ -27802,6 +27802,1174 @@ import { z as z10 } from "zod";
 import { z as z32 } from "zod";
 import { existsSync } from "fs";
 import { z as z9 } from "zod";
+// ../../shared/dist/index.js
+import { z } from "zod";
+import { z as z2 } from "zod";
+import { z as z3 } from "zod";
+import { z as z4 } from "zod";
+import { z as z5 } from "zod";
+import { z as z6 } from "zod";
+import { z as z7 } from "zod";
+import { z as z8 } from "zod";
+var Environment = {
+  SANDBOX: "sandbox",
+  PRODUCTION: "production"
+};
+var API_BASE_URLS = {
+  [Environment.SANDBOX]: "https://api.comprobanteselectronicos.go.cr/recepcion-sandbox/v1",
+  [Environment.PRODUCTION]: "https://api.comprobanteselectronicos.go.cr/recepcion/v1"
+};
+var IDP_TOKEN_URLS = {
+  [Environment.SANDBOX]: "https://idp.comprobanteselectronicos.go.cr/auth/realms/rut-stag/protocol/openid-connect/token",
+  [Environment.PRODUCTION]: "https://idp.comprobanteselectronicos.go.cr/auth/realms/rut/protocol/openid-connect/token"
+};
+var CLIENT_IDS = {
+  [Environment.SANDBOX]: "api-stag",
+  [Environment.PRODUCTION]: "api-prod"
+};
+var IDP_LOGOUT_URLS = {
+  [Environment.SANDBOX]: "https://idp.comprobanteselectronicos.go.cr/auth/realms/rut-stag/protocol/openid-connect/logout",
+  [Environment.PRODUCTION]: "https://idp.comprobanteselectronicos.go.cr/auth/realms/rut/protocol/openid-connect/logout"
+};
+var ECONOMIC_ACTIVITY_API_URL = "https://api.hacienda.go.cr/fe/ae";
+var DocumentTypeCode = {
+  /** Factura Electronica */
+  FACTURA_ELECTRONICA: "01",
+  /** Nota de Debito Electronica */
+  NOTA_DEBITO_ELECTRONICA: "02",
+  /** Nota de Credito Electronica */
+  NOTA_CREDITO_ELECTRONICA: "03",
+  /** Tiquete Electronico */
+  TIQUETE_ELECTRONICO: "04",
+  /** Factura Electronica de Compra */
+  FACTURA_ELECTRONICA_COMPRA: "05",
+  /** Factura Electronica de Exportacion */
+  FACTURA_ELECTRONICA_EXPORTACION: "06",
+  /** Recibo Electronico de Pago (new in v4.4) */
+  RECIBO_ELECTRONICO_PAGO: "07",
+  /** Compra de Pago */
+  COMPRA_PAGO: "08",
+  /** Gasto de Viaje */
+  GASTO_VIAJE: "09"
+};
+var DOCUMENT_TYPE_NAMES = {
+  [DocumentTypeCode.FACTURA_ELECTRONICA]: "Factura Electr\xF3nica",
+  [DocumentTypeCode.NOTA_DEBITO_ELECTRONICA]: "Nota de D\xE9bito Electr\xF3nica",
+  [DocumentTypeCode.NOTA_CREDITO_ELECTRONICA]: "Nota de Cr\xE9dito Electr\xF3nica",
+  [DocumentTypeCode.TIQUETE_ELECTRONICO]: "Tiquete Electr\xF3nico",
+  [DocumentTypeCode.FACTURA_ELECTRONICA_COMPRA]: "Factura Electr\xF3nica de Compra",
+  [DocumentTypeCode.FACTURA_ELECTRONICA_EXPORTACION]: "Factura Electr\xF3nica de Exportaci\xF3n",
+  [DocumentTypeCode.RECIBO_ELECTRONICO_PAGO]: "Recibo Electr\xF3nico de Pago",
+  [DocumentTypeCode.COMPRA_PAGO]: "Compra de Pago",
+  [DocumentTypeCode.GASTO_VIAJE]: "Gasto de Viaje"
+};
+var MensajeReceptorCode = {
+  /** Aceptado totalmente */
+  ACEPTADO: "1",
+  /** Aceptado parcialmente */
+  ACEPTADO_PARCIALMENTE: "2",
+  /** Rechazado */
+  RECHAZADO: "3"
+};
+var SituationCode = {
+  /** Normal */
+  NORMAL: "1",
+  /** Contingencia (contingency) */
+  CONTINGENCIA: "2",
+  /** Sin internet (no internet) */
+  SIN_INTERNET: "3"
+};
+var TaxCode = {
+  /** Impuesto al Valor Agregado (IVA) */
+  IVA: "01",
+  /** Impuesto Selectivo de Consumo */
+  IMPUESTO_SELECTIVO_CONSUMO: "02",
+  /** Impuesto Unico a los Combustibles */
+  IMPUESTO_UNICO_COMBUSTIBLES: "03",
+  /** Impuesto Especifico de Bebidas Alcoholicas */
+  IMPUESTO_BEBIDAS_ALCOHOLICAS: "04",
+  /** Impuesto Especifico sobre Bebidas Envasadas sin Alcohol y Jabones de Tocador */
+  IMPUESTO_BEBIDAS_SIN_ALCOHOL: "05",
+  /** Impuesto al Tabaco */
+  IMPUESTO_TABACO: "06",
+  /** IVA (calculo especial) */
+  IVA_CALCULO_ESPECIAL: "07",
+  /** IVA Regimen de Bienes Usados (Factor) */
+  IVA_BIENES_USADOS: "08",
+  /** Impuesto Especifico al Cemento */
+  IMPUESTO_CEMENTO: "12",
+  /** Otros */
+  OTROS: "99"
+};
+var IvaRateCode = {
+  /** Tarifa 0% (Exento) */
+  EXENTO: "01",
+  /** Tarifa reducida 1% */
+  REDUCIDA_1: "02",
+  /** Tarifa reducida 2% */
+  REDUCIDA_2: "03",
+  /** Tarifa reducida 4% */
+  REDUCIDA_4: "04",
+  /** Transitorio 0% */
+  TRANSITORIO_0: "05",
+  /** Transitorio 4% */
+  TRANSITORIO_4: "06",
+  /** Transitorio 8% */
+  TRANSITORIO_8: "07",
+  /** Tarifa general 13% */
+  GENERAL_13: "08",
+  /** Tarifa reducida 0.5% (new in v4.4) */
+  REDUCIDA_0_5: "09",
+  /** Tarifa exenta (new in v4.4) */
+  TARIFA_EXENTA: "10",
+  /** Tarifa 0% sin derecho a credito (new in v4.4) */
+  CERO_SIN_CREDITO: "11"
+};
+var IVA_RATE_PERCENTAGES = {
+  [IvaRateCode.EXENTO]: 0,
+  [IvaRateCode.REDUCIDA_1]: 1,
+  [IvaRateCode.REDUCIDA_2]: 2,
+  [IvaRateCode.REDUCIDA_4]: 4,
+  [IvaRateCode.TRANSITORIO_0]: 0,
+  [IvaRateCode.TRANSITORIO_4]: 4,
+  [IvaRateCode.TRANSITORIO_8]: 8,
+  [IvaRateCode.GENERAL_13]: 13,
+  [IvaRateCode.REDUCIDA_0_5]: 0.5,
+  [IvaRateCode.TARIFA_EXENTA]: 0,
+  [IvaRateCode.CERO_SIN_CREDITO]: 0
+};
+var IVA_RATE_NAMES = {
+  [IvaRateCode.EXENTO]: "Exento (0%)",
+  [IvaRateCode.REDUCIDA_1]: "Tarifa reducida 1%",
+  [IvaRateCode.REDUCIDA_2]: "Tarifa reducida 2%",
+  [IvaRateCode.REDUCIDA_4]: "Tarifa reducida 4%",
+  [IvaRateCode.TRANSITORIO_0]: "Transitorio 0%",
+  [IvaRateCode.TRANSITORIO_4]: "Transitorio 4%",
+  [IvaRateCode.TRANSITORIO_8]: "Transitorio 8%",
+  [IvaRateCode.GENERAL_13]: "Tarifa general 13%",
+  [IvaRateCode.REDUCIDA_0_5]: "Tarifa reducida 0.5%",
+  [IvaRateCode.TARIFA_EXENTA]: "Tarifa exenta",
+  [IvaRateCode.CERO_SIN_CREDITO]: "Tarifa 0% sin derecho a cr\xE9dito"
+};
+var ExonerationType = {
+  /** Compras autorizadas */
+  COMPRAS_AUTORIZADAS: "01",
+  /** Ventas exentas a diplomáticos */
+  VENTAS_EXENTAS_DIPLOMATICOS: "02",
+  /** Autorizado por ley especial */
+  AUTORIZADO_LEY_ESPECIAL: "03",
+  /** Exenciones de la Dirección General de Hacienda */
+  EXENCIONES_DGH: "04",
+  /** Transitorio V */
+  TRANSITORIO_V: "05",
+  /** Transitorio IX */
+  TRANSITORIO_IX: "06",
+  /** Transitorio XVII */
+  TRANSITORIO_XVII: "07",
+  /** Exoneracion Zona Franca (new in v4.4) */
+  ZONA_FRANCA: "08",
+  /** Exoneracion de servicios complementarios para la exportacion (new in v4.4) */
+  SERVICIOS_COMPLEMENTARIOS_EXPORTACION: "09",
+  /** Organo de las corporaciones municipales (new in v4.4) */
+  CORPORACIONES_MUNICIPALES: "10",
+  /** Exenciones DGH — autorizacion de impuesto local concreta (new in v4.4) */
+  DGH_IMPUESTO_LOCAL_CONCRETA: "11",
+  /** Codigo 12 — ver ANEXOS Y ESTRUCTURAS v4.4 para la descripcion oficial */
+  EXONERACION_12: "12",
+  /** Otros */
+  OTROS: "99"
+};
+var UNITS_OF_MEASURE = [
+  "1",
+  "\xB4",
+  "\xB4\xB4",
+  "\xB0C",
+  "1/m",
+  "A",
+  "A/m",
+  "A/m\xB2",
+  "Acv",
+  "Al",
+  "Alc",
+  "B",
+  "Bq",
+  "C",
+  "C/kg",
+  "C/m\xB2",
+  "C/m\xB3",
+  "Cc",
+  "Cd",
+  "cd/m\xB2",
+  "Cm",
+  "cm",
+  "Cu",
+  "D",
+  "eV",
+  "F",
+  "F/m",
+  "Fa",
+  "G",
+  "Gal",
+  "Gy",
+  "Gy/s",
+  "h",
+  "H",
+  "H/m",
+  "Hz",
+  "I",
+  "J",
+  "J/(kg\xB7K)",
+  "J/(mol\xB7K)",
+  "J/K",
+  "J/kg",
+  "J/m\xB3",
+  "J/mol",
+  "K",
+  "Kat",
+  "kat/m\xB3",
+  "Kg",
+  "kg/m\xB3",
+  "Km",
+  "Kw",
+  "kWh",
+  "L",
+  "Lm",
+  "Ln",
+  "Lx",
+  "M",
+  "m/s",
+  "m/s\xB2",
+  "m\xB2",
+  "m\xB3",
+  "Min",
+  "mL",
+  "Mm",
+  "Mol",
+  "mol/m\xB3",
+  "N",
+  "N/m",
+  "N\xB7m",
+  "Np",
+  "\xBA",
+  "Os",
+  "Otros",
+  "Oz",
+  "Pa",
+  "Pa\xB7s",
+  "Qq",
+  "Rad",
+  "rad/s",
+  "rad/s\xB2",
+  "S",
+  "s",
+  "Sp",
+  "Spe",
+  "Sr",
+  "St",
+  "Sv",
+  "t",
+  "T",
+  "U",
+  "Ua",
+  "Unid",
+  "V",
+  "V/m",
+  "W",
+  "W/(m\xB7K)",
+  "W/(m\xB2\xB7sr)",
+  "W/m\xB2",
+  "W/sr",
+  "Wb",
+  "\u03A9"
+];
+var UnitOfMeasure = {
+  /** Servicios profesionales */
+  SERVICIOS_PROFESIONALES: "Sp",
+  /** Otros servicios */
+  OTROS_SERVICIOS: "Os",
+  /** Servicios personales */
+  SERVICIOS_PERSONALES: "Spe",
+  /** Unidad */
+  UNIDAD: "Unid",
+  /** Metros */
+  METROS: "M",
+  /** Centimetros */
+  CENTIMETROS: "cm",
+  /** Kilometros */
+  KILOMETROS: "Km",
+  /** Kilogramos */
+  KILOGRAMOS: "Kg",
+  /** Gramos */
+  GRAMOS: "G",
+  /** Toneladas */
+  TONELADAS: "t",
+  /** Litros */
+  LITROS: "L",
+  /** Mililitros */
+  MILILITROS: "mL",
+  /** Metros cuadrados */
+  METROS_CUADRADOS: "m\xB2",
+  /** Metros cubicos */
+  METROS_CUBICOS: "m\xB3",
+  /** Galones */
+  GALONES: "Gal",
+  /** Onzas */
+  ONZAS: "Oz",
+  /** Horas */
+  HORAS: "h",
+  /** Minutos */
+  MINUTOS: "Min",
+  /** Segundos */
+  SEGUNDOS: "s",
+  /** Dias */
+  DIAS: "D",
+  /** Otros (especificar) */
+  OTROS: "Otros"
+};
+var REFERENCE_DOC_TYPES = [
+  "01",
+  // Factura electronica
+  "02",
+  // Nota de debito electronica
+  "03",
+  // Nota de credito electronica
+  "04",
+  // Tiquete electronico
+  "05",
+  // Nota de despacho
+  "06",
+  // Contrato
+  "07",
+  // Procedimiento
+  "08",
+  // Comprobante emitido en contingencia
+  "09",
+  // Devolucion de mercaderia
+  "10",
+  // Sustituye factura rechazada por Hacienda
+  "11",
+  // Sustituye factura rechazada por el receptor
+  "12",
+  // Sustituye factura de exportacion
+  "13",
+  // Facturacion mes vencido
+  "14",
+  // Comprobante aportado por contribuyente de regimen especial
+  "15",
+  // Sustituye una factura electronica de compra
+  "16",
+  // Comprobante de proveedor no domiciliado
+  "17",
+  // Nota de credito a factura electronica de compra
+  "18",
+  // Nota de debito a factura electronica de compra
+  "19",
+  // Factura electronica de exportacion (April 2026 revision)
+  "20",
+  // Recibo electronico de pago (April 2026 revision)
+  "99"
+  // Otros (requiere TipoDocRefOTRO)
+];
+var REFERENCE_CODES = [
+  "01",
+  // Anula documento de referencia
+  "02",
+  // Corrige texto de documento de referencia
+  "04",
+  // Referencia a otro documento
+  "05",
+  // Sustituye comprobante provisional por contingencia
+  "06",
+  "07",
+  "08",
+  "09",
+  "10",
+  "11",
+  "12",
+  // Nota de credito financiera por exoneracion posterior (redefined April 2026)
+  "13",
+  // Anula comprobante por error material (April 2026 revision)
+  "14",
+  // Corrige monto por error material (April 2026 revision)
+  "15",
+  // Sustituye comprobante por error material (April 2026 revision)
+  "16",
+  // Sustituye comprobante rechazado (April 2026 revision)
+  "99"
+  // Otros (requiere CodigoReferenciaOTRO)
+];
+var REP_REFERENCE_CODES = [
+  ...REFERENCE_CODES,
+  "17"
+  // Pago de comprobante (REP only, April 2026 revision)
+];
+var DISCOUNT_CODES = [
+  "01",
+  "02",
+  "03",
+  "04",
+  "05",
+  "06",
+  "07",
+  "08",
+  "09",
+  "99"
+  // Otros (requiere CodigoDescuentoOTRO)
+];
+var OTHER_CHARGE_TYPES = [
+  "01",
+  // Contribucion parafiscal
+  "02",
+  // Timbre de la Cruz Roja
+  "03",
+  // Timbre de Benemerito Cuerpo de Bomberos
+  "04",
+  // Cobro de un tercero
+  "05",
+  // Costos de exportacion
+  "06",
+  // Impuesto de servicio 10%
+  "07",
+  // Timbre de Colegios Profesionales
+  "08",
+  "09",
+  "10",
+  "99"
+  // Otros (requiere TipoDocumentoOTROS)
+];
+var EXONERATION_INSTITUTIONS = [
+  "01",
+  "02",
+  "03",
+  "04",
+  "05",
+  "06",
+  "07",
+  "08",
+  "09",
+  "10",
+  "11",
+  "12",
+  "99"
+  // Otros (requiere NombreInstitucionOtros)
+];
+var IdentificationType = {
+  /** Cedula Fisica (physical person ID) — 9 digits */
+  CEDULA_FISICA: "01",
+  /** Cedula Juridica (legal entity ID) — 10 digits */
+  CEDULA_JURIDICA: "02",
+  /** DIMEX (foreign resident ID) — 11-12 digits */
+  DIMEX: "03",
+  /** NITE (tax ID for foreigners without DIMEX) — 10 digits */
+  NITE: "04",
+  /** Extranjero No Domiciliado (non-domiciled foreigner) — free-form, max 20 chars */
+  EXTRANJERO_NO_DOMICILIADO: "05",
+  /** No Contribuyente (non-taxpayer) — free-form, max 20 chars */
+  NO_CONTRIBUYENTE: "06"
+};
+var IDENTIFICATION_TYPE_NAMES = {
+  [IdentificationType.CEDULA_FISICA]: "C\xE9dula F\xEDsica",
+  [IdentificationType.CEDULA_JURIDICA]: "C\xE9dula Jur\xEDdica",
+  [IdentificationType.DIMEX]: "DIMEX",
+  [IdentificationType.NITE]: "NITE",
+  [IdentificationType.EXTRANJERO_NO_DOMICILIADO]: "Extranjero No Domiciliado",
+  [IdentificationType.NO_CONTRIBUYENTE]: "No Contribuyente"
+};
+var IDENTIFICATION_LENGTHS = {
+  [IdentificationType.CEDULA_FISICA]: [9],
+  [IdentificationType.CEDULA_JURIDICA]: [10],
+  [IdentificationType.DIMEX]: [11, 12],
+  [IdentificationType.NITE]: [10]
+};
+var SaleCondition = {
+  /** Contado (cash / immediate payment) */
+  CONTADO: "01",
+  /** Credito (credit) */
+  CREDITO: "02",
+  /** Consignacion */
+  CONSIGNACION: "03",
+  /** Apartado */
+  APARTADO: "04",
+  /** Arrendamiento con opcion de compra */
+  ARRENDAMIENTO_OPCION_COMPRA: "05",
+  /** Arrendamiento en funcion financiera */
+  ARRENDAMIENTO_FUNCION_FINANCIERA: "06",
+  /** Cobro a favor de un tercero */
+  COBRO_FAVOR_TERCERO: "07",
+  /** Servicios prestados al Estado */
+  SERVICIOS_ESTADO: "08",
+  /** Pago del servicio prestado al Estado — Recibo Electronico de Pago only */
+  PAGO_SERVICIO_ESTADO: "09",
+  /** Venta a credito en IVA hasta 90 dias (Articulo 27, LIVA) */
+  VENTA_CREDITO_IVA_90_DIAS: "10",
+  /** Pago de venta a credito en IVA hasta 90 dias — Recibo Electronico de Pago only */
+  PAGO_VENTA_CREDITO_IVA_90_DIAS: "11",
+  /** Venta de mercancia no nacionalizada */
+  VENTA_MERCANCIA_NO_NACIONALIZADA: "12",
+  /** Venta de bienes usados no contribuyente */
+  VENTA_BIENES_USADOS_NO_CONTRIBUYENTE: "13",
+  /** Arrendamiento operativo */
+  ARRENDAMIENTO_OPERATIVO: "14",
+  /** Arrendamiento en funcion financiera (leasing financiero) */
+  ARRENDAMIENTO_FINANCIERO: "15",
+  /** Otros (requiere CondicionVentaOtros) */
+  OTROS: "99"
+};
+var REP_SALE_CONDITIONS = [
+  SaleCondition.PAGO_SERVICIO_ESTADO,
+  SaleCondition.PAGO_VENTA_CREDITO_IVA_90_DIAS
+];
+var SALE_CONDITION_NAMES = {
+  [SaleCondition.CONTADO]: "Contado",
+  [SaleCondition.CREDITO]: "Cr\xE9dito",
+  [SaleCondition.CONSIGNACION]: "Consignaci\xF3n",
+  [SaleCondition.APARTADO]: "Apartado",
+  [SaleCondition.ARRENDAMIENTO_OPCION_COMPRA]: "Arrendamiento con opci\xF3n de compra",
+  [SaleCondition.ARRENDAMIENTO_FUNCION_FINANCIERA]: "Arrendamiento en funci\xF3n financiera",
+  [SaleCondition.COBRO_FAVOR_TERCERO]: "Cobro a favor de un tercero",
+  [SaleCondition.SERVICIOS_ESTADO]: "Servicios prestados al Estado",
+  [SaleCondition.PAGO_SERVICIO_ESTADO]: "Pago del servicio prestado al Estado (REP)",
+  [SaleCondition.VENTA_CREDITO_IVA_90_DIAS]: "Venta a cr\xE9dito en IVA hasta 90 d\xEDas",
+  [SaleCondition.PAGO_VENTA_CREDITO_IVA_90_DIAS]: "Pago de venta a cr\xE9dito en IVA hasta 90 d\xEDas (REP)",
+  [SaleCondition.VENTA_MERCANCIA_NO_NACIONALIZADA]: "Venta de mercanc\xEDa no nacionalizada",
+  [SaleCondition.VENTA_BIENES_USADOS_NO_CONTRIBUYENTE]: "Venta de bienes usados no contribuyente",
+  [SaleCondition.ARRENDAMIENTO_OPERATIVO]: "Arrendamiento operativo",
+  [SaleCondition.ARRENDAMIENTO_FINANCIERO]: "Arrendamiento en funci\xF3n financiera (leasing)",
+  [SaleCondition.OTROS]: "Otros"
+};
+var PaymentMethod = {
+  /** Efectivo (cash) */
+  EFECTIVO: "01",
+  /** Tarjeta (card) */
+  TARJETA: "02",
+  /** Cheque */
+  CHEQUE: "03",
+  /** Transferencia - Deposito bancario */
+  TRANSFERENCIA: "04",
+  /** Recaudado por terceros */
+  RECAUDADO_TERCEROS: "05",
+  /** SINPE Movil */
+  SINPE_MOVIL: "06",
+  /** Plataforma Digital */
+  PLATAFORMA_DIGITAL: "07",
+  /** Otros (especificar en MedioPagoOtros) */
+  OTROS: "99"
+};
+var PAYMENT_METHOD_NAMES = {
+  [PaymentMethod.EFECTIVO]: "Efectivo",
+  [PaymentMethod.TARJETA]: "Tarjeta",
+  [PaymentMethod.CHEQUE]: "Cheque",
+  [PaymentMethod.TRANSFERENCIA]: "Transferencia - Dep\xF3sito bancario",
+  [PaymentMethod.RECAUDADO_TERCEROS]: "Recaudado por terceros",
+  [PaymentMethod.SINPE_MOVIL]: "SINPE M\xF3vil",
+  [PaymentMethod.PLATAFORMA_DIGITAL]: "Plataforma Digital",
+  [PaymentMethod.OTROS]: "Otros"
+};
+var ProvinceCode = {
+  /** San Jose */
+  SAN_JOSE: "1",
+  /** Alajuela */
+  ALAJUELA: "2",
+  /** Cartago */
+  CARTAGO: "3",
+  /** Heredia */
+  HEREDIA: "4",
+  /** Guanacaste */
+  GUANACASTE: "5",
+  /** Puntarenas */
+  PUNTARENAS: "6",
+  /** Limon */
+  LIMON: "7"
+};
+var PROVINCE_NAMES = {
+  [ProvinceCode.SAN_JOSE]: "San Jos\xE9",
+  [ProvinceCode.ALAJUELA]: "Alajuela",
+  [ProvinceCode.CARTAGO]: "Cartago",
+  [ProvinceCode.HEREDIA]: "Heredia",
+  [ProvinceCode.GUANACASTE]: "Guanacaste",
+  [ProvinceCode.PUNTARENAS]: "Puntarenas",
+  [ProvinceCode.LIMON]: "Lim\xF3n"
+};
+var CURRENCY_CODES = [
+  "AED",
+  "AFN",
+  "ALL",
+  "AMD",
+  "ANG",
+  "AOA",
+  "ARS",
+  "AUD",
+  "AWG",
+  "AZN",
+  "BAM",
+  "BBD",
+  "BDT",
+  "BGN",
+  "BHD",
+  "BIF",
+  "BMD",
+  "BND",
+  "BOB",
+  "BOV",
+  "BRL",
+  "BSD",
+  "BTN",
+  "BWP",
+  "BYR",
+  "BZD",
+  "CAD",
+  "CDF",
+  "CHE",
+  "CHF",
+  "CHW",
+  "CLF",
+  "CLP",
+  "CNY",
+  "COP",
+  "COU",
+  "CRC",
+  "CUC",
+  "CUP",
+  "CVE",
+  "CZK",
+  "DJF",
+  "DKK",
+  "DOP",
+  "DZD",
+  "EGP",
+  "ERN",
+  "ETB",
+  "EUR",
+  "FJD",
+  "FKP",
+  "GBP",
+  "GEL",
+  "GHS",
+  "GIP",
+  "GMD",
+  "GNF",
+  "GTQ",
+  "GYD",
+  "HKD",
+  "HNL",
+  "HRK",
+  "HTG",
+  "HUF",
+  "IDR",
+  "ILS",
+  "INR",
+  "IQD",
+  "IRR",
+  "ISK",
+  "JMD",
+  "JOD",
+  "JPY",
+  "KES",
+  "KGS",
+  "KHR",
+  "KMF",
+  "KPW",
+  "KRW",
+  "KWD",
+  "KYD",
+  "KZT",
+  "LAK",
+  "LBP",
+  "LKR",
+  "LRD",
+  "LSL",
+  "LYD",
+  "MAD",
+  "MDL",
+  "MGA",
+  "MKD",
+  "MMK",
+  "MNT",
+  "MOP",
+  "MRO",
+  "MUR",
+  "MVR",
+  "MWK",
+  "MXN",
+  "MXV",
+  "MYR",
+  "MZN",
+  "NAD",
+  "NGN",
+  "NIO",
+  "NOK",
+  "NPR",
+  "NZD",
+  "OMR",
+  "PAB",
+  "PEN",
+  "PGK",
+  "PHP",
+  "PKR",
+  "PLN",
+  "PYG",
+  "QAR",
+  "RON",
+  "RSD",
+  "RUB",
+  "RWF",
+  "SAR",
+  "SBD",
+  "SCR",
+  "SDG",
+  "SEK",
+  "SGD",
+  "SHP",
+  "SLL",
+  "SOS",
+  "SRD",
+  "SSP",
+  "STD",
+  "SVC",
+  "SYP",
+  "SZL",
+  "THB",
+  "TJS",
+  "TMT",
+  "TND",
+  "TOP",
+  "TRY",
+  "TTD",
+  "TWD",
+  "TZS",
+  "UAH",
+  "UGX",
+  "USD",
+  "USN",
+  "UYI",
+  "UYU",
+  "UZS",
+  "VEF",
+  "VND",
+  "VUV",
+  "WST",
+  "XAF",
+  "XCD",
+  "XDR",
+  "XOF",
+  "XPF",
+  "XSU",
+  "XUA",
+  "YER",
+  "ZAR",
+  "ZMW",
+  "ZWL"
+];
+var TaxCodeSchema = z.enum(TaxCode);
+var IvaRateCodeSchema = z.enum(IvaRateCode);
+var ExonerationTypeSchema = z.enum(ExonerationType);
+var PaymentMethodSchema = z.enum(PaymentMethod);
+var SaleConditionSchema = z.enum(SaleCondition).exclude(["PAGO_SERVICIO_ESTADO", "PAGO_VENTA_CREDITO_IVA_90_DIAS"]);
+var TelefonoSchema = z.object({
+  /** Country code (e.g., "506"). Max 3 digits. */
+  codigoPais: z.string().regex(/^\d{1,3}$/),
+  /** Phone number. Max 20 digits. */
+  numTelefono: z.string().regex(/^\d{1,20}$/)
+});
+var UbicacionSchema = z.object({
+  /** Province code (1-7). */
+  provincia: z.string().regex(/^[1-7]$/),
+  /** Canton code (2 digits, 01-99). */
+  canton: z.string().regex(/^\d{2}$/),
+  /** Distrito code (2 digits, 01-99). */
+  distrito: z.string().regex(/^\d{2}$/),
+  /** Barrio name (free text, 5-50 chars in v4.4 — no longer a code). Optional. */
+  barrio: z.string().min(5).max(50).optional(),
+  /** Additional address details. Required by the v4.4 XSD, 5-250 chars. */
+  otrasSenas: z.string().min(5).max(250)
+});
+var IdentificationTypeSchema = z2.enum([
+  IdentificationType.CEDULA_FISICA,
+  IdentificationType.CEDULA_JURIDICA,
+  IdentificationType.DIMEX,
+  IdentificationType.NITE,
+  IdentificationType.EXTRANJERO_NO_DOMICILIADO,
+  IdentificationType.NO_CONTRIBUYENTE
+]);
+var IdentificacionSchema = z2.object({
+  /** Identification type code. */
+  tipo: IdentificationTypeSchema,
+  /** Identification number. */
+  numero: z2.string().min(1).max(20)
+}).superRefine((data, ctx) => {
+  const expectedLengths = IDENTIFICATION_LENGTHS[data.tipo];
+  if (!expectedLengths) {
+    return;
+  }
+  if (!/^\d+$/.test(data.numero)) {
+    ctx.addIssue({
+      code: "custom",
+      message: "Must contain only digits",
+      path: ["numero"]
+    });
+    return;
+  }
+  if (!expectedLengths.includes(data.numero.length)) {
+    ctx.addIssue({
+      code: "custom",
+      message: "Identification number length does not match the expected length for the given type",
+      path: ["numero"]
+    });
+  }
+});
+var CorreoSchema = z3.string().email().max(160);
+var EmisorSchema = z3.object({
+  /** Issuer name (Nombre o Razon Social). Max 100 chars. */
+  nombre: z3.string().min(1).max(100),
+  /** Taxpayer identification. */
+  identificacion: IdentificacionSchema,
+  /** Ley 8707 fiscal registry number. Optional, max 12 chars. */
+  registrofiscal8707: z3.string().max(12).optional(),
+  /** Commercial name. Optional, max 80 chars. */
+  nombreComercial: z3.string().max(80).optional(),
+  /** Location. Required by the v4.4 XSD. */
+  ubicacion: UbicacionSchema,
+  /** Phone number. Optional. */
+  telefono: TelefonoSchema.optional(),
+  /** Email address(es) — the XSD allows up to 4. */
+  correoElectronico: z3.union([CorreoSchema, z3.array(CorreoSchema).min(1).max(4)])
+});
+var ReceptorSchema = z4.object({
+  /** Receiver name. Max 100 chars. */
+  nombre: z4.string().min(1).max(100),
+  /**
+   * Taxpayer identification. Optional for Tiquete/NC/ND/FEE; foreign
+   * receivers use tipo "05" (Extranjero No Domiciliado).
+   */
+  identificacion: IdentificacionSchema.optional(),
+  /** Commercial name. Optional, max 80 chars. */
+  nombreComercial: z4.string().max(80).optional(),
+  /** Location. Optional. */
+  ubicacion: UbicacionSchema.optional(),
+  /** Foreign receiver address. Optional, 5-300 chars (v4.4). */
+  otrasSenasExtranjero: z4.string().min(5).max(300).optional(),
+  /** Phone number. Optional. */
+  telefono: TelefonoSchema.optional(),
+  /** Email address. Optional, max 160 chars. */
+  correoElectronico: z4.string().email().max(160).optional()
+});
+var CodigoComercialSchema = z5.object({
+  /** Code type: 01=Seller, 02=Buyer, 03=Industry, 04=Internal, 99=Other. */
+  tipo: z5.enum(["01", "02", "03", "04", "99"]),
+  /** Product/service code value. Max 20 chars. */
+  codigo: z5.string().min(1).max(20)
+});
+var ExoneracionSchema = z5.object({
+  /** Exoneration document type (TipoDocumentoEX1). */
+  tipoDocumento: ExonerationTypeSchema,
+  /** Free-text document type. Required when tipoDocumento is "99". */
+  tipoDocumentoOtros: z5.string().min(5).max(100).optional(),
+  /** Exoneration document number. 3-40 chars. */
+  numeroDocumento: z5.string().min(3).max(40),
+  /** Law article number. Optional, up to 6 digits. */
+  articulo: z5.number().int().min(0).max(999999).optional(),
+  /** Law clause (inciso) number. Optional, up to 6 digits. */
+  inciso: z5.number().int().min(0).max(999999).optional(),
+  /** Issuing institution code (coded in v4.4). */
+  nombreInstitucion: z5.enum(EXONERATION_INSTITUTIONS),
+  /** Free-text institution name. Required when nombreInstitucion is "99". */
+  nombreInstitucionOtros: z5.string().min(5).max(160).optional(),
+  /** Issue date (ISO 8601) — emitted as FechaEmisionEX. */
+  fechaEmision: z5.string().min(1),
+  /** Exonerated rate percentage (0-100) — emitted as TarifaExonerada. */
+  tarifaExonerada: z5.number().min(0).max(100),
+  /** Exonerated tax amount. */
+  montoExoneracion: z5.number().min(0)
+});
+var ImpuestoSchema = z5.object({
+  /** Tax type code. */
+  codigo: TaxCodeSchema,
+  /** Free-text tax type. Required when codigo is "99" (5-100 chars). */
+  codigoImpuestoOtros: z5.string().min(5).max(100).optional(),
+  /** IVA rate code (CodigoTarifaIVA). Required when tax code is IVA-related. */
+  codigoTarifaIVA: IvaRateCodeSchema.optional(),
+  /** Tax rate percentage. Optional for non-rate taxes. */
+  tarifa: z5.number().min(0).max(99.99).optional(),
+  /** Calculation factor for the used-goods IVA regime (code 08). */
+  factorCalculoIVA: z5.number().min(0).max(9.9999).optional(),
+  /** Tax amount (Monto). */
+  monto: z5.number().min(0),
+  /** Exoneration information. Optional. */
+  exoneracion: ExoneracionSchema.optional()
+});
+var DescuentoSchema = z5.object({
+  /** Discount amount. Must be positive. */
+  montoDescuento: z5.number().positive(),
+  /** Discount code (CodigoDescuento). Required in v4.4. */
+  codigoDescuento: z5.enum(DISCOUNT_CODES),
+  /** Free-text discount type. Required when codigoDescuento is "99". */
+  codigoDescuentoOtros: z5.string().min(5).max(100).optional(),
+  /** Reason for discount. Optional in v4.4, 3-80 chars. */
+  naturalezaDescuento: z5.string().min(3).max(80).optional()
+});
+var LineaDetalleSchema = z5.object({
+  /** Line number (1-based, sequential). */
+  numeroLinea: z5.number().int().positive(),
+  /** Customs tariff heading. Optional (NC/ND/FEE only), max 15 chars. */
+  partidaArancelaria: z5.string().max(15).optional(),
+  /** CABYS code — 13 digits, emitted as CodigoCABYS. */
+  codigoCabys: z5.string().regex(/^\d{13}$/, "CABYS code must be exactly 13 digits"),
+  /** Commercial codes. Optional, max 5. */
+  codigoComercial: z5.array(CodigoComercialSchema).max(5).optional(),
+  /** Quantity. Must be positive. */
+  cantidad: z5.number().positive(),
+  /** Unit of measure (official v4.4 catalog value). */
+  unidadMedida: z5.enum(UNITS_OF_MEASURE),
+  /** Transaction type code (TipoTransaccion, 01-13). Optional, v4.4. */
+  tipoTransaccion: z5.enum(["01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13"]).optional(),
+  /** Commercial unit of measure. Optional, max 20 chars. */
+  unidadMedidaComercial: z5.string().max(20).optional(),
+  /** Item description. 3-200 chars per the XSD. */
+  detalle: z5.string().min(3).max(200),
+  /** VIN or serial numbers. Optional, max 17 chars each. */
+  numeroVINoSerie: z5.array(z5.string().min(1).max(17)).optional(),
+  /** Unit price (before taxes and discounts). */
+  precioUnitario: z5.number().min(0),
+  /** Total line amount (cantidad * precioUnitario). */
+  montoTotal: z5.number().min(0),
+  /** Discounts applied. Optional, max 5. */
+  descuento: z5.array(DescuentoSchema).max(5).optional(),
+  /** Subtotal after discounts. */
+  subTotal: z5.number().min(0),
+  /** Base taxable amount. Defaults to subTotal at emission when omitted. */
+  baseImponible: z5.number().min(0).optional(),
+  /** Taxes applied to this line item. v4.4 requires at least one. */
+  impuesto: z5.array(ImpuestoSchema).min(1),
+  /** Tax assumed by issuer/factory. Optional (emitted as 0 when required). */
+  impuestoAsumidoEmisorFabrica: z5.number().min(0).optional(),
+  /** Net tax amount. Optional (emitted as 0 when required). */
+  impuestoNeto: z5.number().min(0).optional(),
+  /** Total line amount including taxes. */
+  montoTotalLinea: z5.number().min(0)
+});
+var ClaveComponentsSchema = z6.object({
+  /** Country code — must be "506". */
+  countryCode: z6.literal("506"),
+  /** Date in DDMMYY format. */
+  date: z6.string().regex(/^\d{6}$/, "Date must be in DDMMYY format (6 digits)"),
+  /** Taxpayer ID, zero-padded to 12 characters (alphanumeric since the April 2026 revision). */
+  taxpayerId: z6.string().regex(/^[A-Za-z0-9]{12}$/, "Taxpayer ID must be exactly 12 alphanumeric characters"),
+  /** Branch number, zero-padded to 3 digits. */
+  branch: z6.string().regex(/^\d{3}$/, "Branch must be exactly 3 digits"),
+  /** Terminal / POS number, zero-padded to 5 digits. */
+  terminal: z6.string().regex(/^\d{5}$/, "Terminal must be exactly 5 digits"),
+  /** Document type code (2 digits). */
+  documentType: z6.enum([
+    DocumentTypeCode.FACTURA_ELECTRONICA,
+    DocumentTypeCode.NOTA_DEBITO_ELECTRONICA,
+    DocumentTypeCode.NOTA_CREDITO_ELECTRONICA,
+    DocumentTypeCode.TIQUETE_ELECTRONICO,
+    DocumentTypeCode.FACTURA_ELECTRONICA_COMPRA,
+    DocumentTypeCode.FACTURA_ELECTRONICA_EXPORTACION,
+    DocumentTypeCode.RECIBO_ELECTRONICO_PAGO,
+    DocumentTypeCode.COMPRA_PAGO,
+    DocumentTypeCode.GASTO_VIAJE
+  ]),
+  /** Sequence number, zero-padded to 10 digits. */
+  sequence: z6.string().regex(/^\d{10}$/, "Sequence must be exactly 10 digits"),
+  /** Situation code (1 digit). */
+  situation: z6.enum([SituationCode.NORMAL, SituationCode.CONTINGENCIA, SituationCode.SIN_INTERNET]),
+  /** 8-digit security code. */
+  securityCode: z6.string().regex(/^\d{8}$/, "Security code must be exactly 8 digits")
+});
+var ClaveInputSchema = z6.object({
+  /** Emission date. */
+  date: z6.date(),
+  /** Taxpayer identification number (raw, without padding). 9-12 alphanumeric chars. */
+  taxpayerId: z6.string().regex(/^[A-Za-z0-9]{9,12}$/, "Taxpayer ID must be 9-12 alphanumeric characters"),
+  /** Document type code. */
+  documentType: z6.enum([
+    DocumentTypeCode.FACTURA_ELECTRONICA,
+    DocumentTypeCode.NOTA_DEBITO_ELECTRONICA,
+    DocumentTypeCode.NOTA_CREDITO_ELECTRONICA,
+    DocumentTypeCode.TIQUETE_ELECTRONICO,
+    DocumentTypeCode.FACTURA_ELECTRONICA_COMPRA,
+    DocumentTypeCode.FACTURA_ELECTRONICA_EXPORTACION,
+    DocumentTypeCode.RECIBO_ELECTRONICO_PAGO,
+    DocumentTypeCode.COMPRA_PAGO,
+    DocumentTypeCode.GASTO_VIAJE
+  ]),
+  /** Sequential document number (1 to 9999999999). */
+  sequence: z6.number().int().positive().max(9999999999),
+  /** Branch number. Defaults to 1. */
+  branch: z6.number().int().positive().max(999).default(1),
+  /** Terminal / POS number. Defaults to 1. */
+  terminal: z6.number().int().positive().max(99999).default(1),
+  /** Situation code. Defaults to "1" (normal). */
+  situation: z6.enum([SituationCode.NORMAL, SituationCode.CONTINGENCIA, SituationCode.SIN_INTERNET]).default(SituationCode.NORMAL),
+  /** 8-digit security code. Generated randomly if not provided. */
+  securityCode: z6.string().regex(/^\d{8}$/, "Security code must be exactly 8 digits").optional()
+});
+var ClaveNumericaSchema = z6.string().length(50, "Clave numerica must be exactly 50 characters").regex(
+  /^\d{9}[A-Za-z0-9]{12}\d{29}$/,
+  "Clave must be numeric except the taxpayer-ID segment (positions 10-21), which may be alphanumeric"
+);
+var CodigoTipoMonedaSchema = z7.object({
+  /** ISO 4217 currency code (official v4.4 catalog). */
+  codigoMoneda: z7.enum(CURRENCY_CODES),
+  /** Exchange rate to CRC. Must be positive. */
+  tipoCambio: z7.number().positive()
+});
+var InformacionReferenciaSchema = z7.object({
+  /** Referenced document type code (TipoDocIR). */
+  tipoDoc: z7.enum(REFERENCE_DOC_TYPES),
+  /** Free-text document type. Required when tipoDoc is "99" (5-100 chars). */
+  tipoDocOtros: z7.string().min(5).max(100).optional(),
+  /** Referenced document clave or number. Optional, max 50 chars. */
+  numero: z7.string().min(1).max(50).optional(),
+  /** Date of the referenced document (ISO 8601) — emitted as FechaEmisionIR. */
+  fechaEmision: z7.string().min(1),
+  /** Reference reason code. Optional in v4.4. */
+  codigo: z7.enum(REFERENCE_CODES).optional(),
+  /** Free-text reason code. Required when codigo is "99" (5-100 chars). */
+  codigoOtros: z7.string().min(5).max(100).optional(),
+  /** Description of the reason. Optional, max 180 chars. */
+  razon: z7.string().min(1).max(180).optional()
+});
+var OtroCargoSchema = z7.object({
+  /** Charge document type (TipoDocumentoOC). */
+  tipoDocumento: z7.enum(OTHER_CHARGE_TYPES),
+  /** Free-text charge type. Required when tipoDocumento is "99" (5-100 chars). */
+  tipoDocumentoOtros: z7.string().min(5).max(100).optional(),
+  /** Third-party identification. Optional. */
+  identificacionTercero: IdentificacionSchema.optional(),
+  /** Third-party name. Optional, 5-100 chars. */
+  nombreTercero: z7.string().min(5).max(100).optional(),
+  /** Detail. Max 160 chars. */
+  detalle: z7.string().min(1).max(160),
+  /** Percentage (PorcentajeOC). Optional. */
+  porcentaje: z7.number().min(0).max(100).optional(),
+  /** Charge amount (MontoCargo). */
+  montoCargo: z7.number().min(0)
+});
+var MedioPagoSchema = z7.object({
+  /** Payment method code (TipoMedioPago). */
+  tipoMedioPago: PaymentMethodSchema,
+  /** Free-text payment method. Required when tipo is "99" (3-100 chars). */
+  medioPagoOtros: z7.string().min(3).max(100).optional(),
+  /** Amount paid with this method (TotalMedioPago). */
+  totalMedioPago: z7.number().min(0)
+});
+var TotalDesgloseImpuestoSchema = z7.object({
+  /** Tax type code. */
+  codigo: TaxCodeSchema,
+  /** IVA rate code. Optional. */
+  codigoTarifaIVA: IvaRateCodeSchema.optional(),
+  /** Total tax amount for this (code, rate) pair. */
+  totalMontoImpuesto: z7.number().min(0)
+});
+var ResumenFacturaSchema = z7.object({
+  /** Currency information. Optional in input (builders default to CRC / 1). */
+  codigoTipoMoneda: CodigoTipoMonedaSchema.optional(),
+  /** Total taxable services. */
+  totalServGravados: z7.number().min(0).optional(),
+  /** Total exempt services. */
+  totalServExentos: z7.number().min(0).optional(),
+  /** Total exonerated services. */
+  totalServExonerado: z7.number().min(0).optional(),
+  /** Total non-subject services (v4.4). */
+  totalServNoSujeto: z7.number().min(0).optional(),
+  /** Total taxable merchandise. */
+  totalMercanciasGravadas: z7.number().min(0).optional(),
+  /** Total exempt merchandise. */
+  totalMercanciasExentas: z7.number().min(0).optional(),
+  /** Total exonerated merchandise. */
+  totalMercExonerada: z7.number().min(0).optional(),
+  /** Total non-subject merchandise (v4.4). */
+  totalMercNoSujeta: z7.number().min(0).optional(),
+  /** Total taxable. */
+  totalGravado: z7.number().min(0).optional(),
+  /** Total exempt. */
+  totalExento: z7.number().min(0).optional(),
+  /** Total exonerated. */
+  totalExonerado: z7.number().min(0).optional(),
+  /** Total non-subject (v4.4). */
+  totalNoSujeto: z7.number().min(0).optional(),
+  /** Total sales (before tax). */
+  totalVenta: z7.number().min(0),
+  /** Total discounts. */
+  totalDescuentos: z7.number().min(0).optional(),
+  /** Net sales (totalVenta - totalDescuentos). */
+  totalVentaNeta: z7.number().min(0),
+  /** Per-tax-code totals breakdown (v4.4). Optional. */
+  totalDesgloseImpuesto: z7.array(TotalDesgloseImpuestoSchema).optional(),
+  /** Total tax. */
+  totalImpuesto: z7.number().min(0).optional(),
+  /** Total tax assumed by issuer/factory (v4.4). */
+  totalImpAsumEmisorFabrica: z7.number().min(0).optional(),
+  /** Total IVA returned. Optional. */
+  totalIVADevuelto: z7.number().min(0).optional(),
+  /** Total other charges. Optional. */
+  totalOtrosCargos: z7.number().min(0).optional(),
+  /** Payment methods with amounts (v4.4). Up to 4 entries. */
+  medioPago: z7.array(MedioPagoSchema).min(1).max(4).optional(),
+  /** Grand total. */
+  totalComprobante: z7.number().min(0)
+});
+var OtroContenidoSchema = z7.object({
+  contenido: z7.string().min(1)
+});
+var FacturaElectronicaSchema = z7.object({
+  /** 50-character clave (taxpayer segment alphanumeric since April 2026). */
+  clave: z7.string().length(50).regex(/^\d{9}[A-Za-z0-9]{12}\d{29}$/),
+  /** Invoicing-system provider identification (ProveedorSistemas). */
+  proveedorSistemas: z7.string().min(1).max(20),
+  /** Issuer economic activity code (6 digits). */
+  codigoActividadEmisor: z7.string().regex(/^\d{6}$/, "Activity code must be 6 digits"),
+  /** Receiver economic activity code (6 digits). Optional. */
+  codigoActividadReceptor: z7.string().regex(/^\d{6}$/, "Activity code must be 6 digits").optional(),
+  /** Sequential document number (20 chars). */
+  numeroConsecutivo: z7.string().length(20).regex(/^\d{20}$/),
+  /** Emission date (ISO 8601 with timezone). */
+  fechaEmision: z7.string().min(1),
+  /** Issuer information. */
+  emisor: EmisorSchema,
+  /** Receiver information. Required for Factura (with identification). */
+  receptor: ReceptorSchema.refine((r) => r.identificacion !== void 0, {
+    message: "Receptor identification is required for Factura Electronica",
+    path: ["identificacion"]
+  }),
+  /** Sale condition (v4.4 set — REP-only payment codes excluded). */
+  condicionVenta: SaleConditionSchema,
+  /** Free-text sale condition. Required when condicionVenta is "99" (5-100 chars). */
+  condicionVentaOtros: z7.string().min(5).max(100).optional(),
+  /** Credit term in days. Required when condicionVenta is "02". */
+  plazoCredito: z7.string().optional(),
+  /** Line items. At least one required, max 1000. */
+  detalleServicio: z7.array(LineaDetalleSchema).min(1).max(1e3),
+  /** Other charges. Optional, max 15. */
+  otrosCargos: z7.array(OtroCargoSchema).max(15).optional(),
+  /** Invoice summary / totals. */
+  resumenFactura: ResumenFacturaSchema,
+  /** References to other documents. Optional, max 10. */
+  informacionReferencia: z7.array(InformacionReferenciaSchema).max(10).optional(),
+  /** Additional content. Optional. */
+  otros: z7.array(OtroContenidoSchema).optional()
+});
+var EnvironmentSchema = z8.enum([Environment.SANDBOX, Environment.PRODUCTION]);
+var CredentialConfigSchema = z8.object({
+  /** Full username. */
+  username: z8.string().min(1).email().or(z8.string().min(1)),
+  /** Path to the .p12 certificate file. */
+  p12Path: z8.string().min(1)
+});
+var AppConfigSchema = z8.object({
+  /** Active environment. */
+  environment: EnvironmentSchema,
+  /** Per-environment credential configuration. */
+  credentials: z8.object({
+    [Environment.SANDBOX]: CredentialConfigSchema.optional(),
+    [Environment.PRODUCTION]: CredentialConfigSchema.optional()
+  }).optional()
+});
+// ../sdk/dist/index.js
 import { z as z22 } from "zod";
 import { z as z52 } from "zod";
 import { readFile, writeFile, mkdir, access, chmod } from "fs/promises";
@@ -28877,686 +30045,6 @@ function isAttribute(name2) {
   }
 }
-// ../../shared/dist/index.js
-import { z } from "zod";
-import { z as z2 } from "zod";
-import { z as z3 } from "zod";
-import { z as z4 } from "zod";
-import { z as z5 } from "zod";
-import { z as z6 } from "zod";
-import { z as z7 } from "zod";
-import { z as z8 } from "zod";
-var Environment = {
-  SANDBOX: "sandbox",
-  PRODUCTION: "production"
-};
-var API_BASE_URLS = {
-  [Environment.SANDBOX]: "https://api-sandbox.comprobanteselectronicos.go.cr/recepcion/v1",
-  [Environment.PRODUCTION]: "https://api.comprobanteselectronicos.go.cr/recepcion/v1"
-};
-var IDP_TOKEN_URLS = {
-  [Environment.SANDBOX]: "https://idp.comprobanteselectronicos.go.cr/auth/realms/rut-stag/protocol/openid-connect/token",
-  [Environment.PRODUCTION]: "https://idp.comprobanteselectronicos.go.cr/auth/realms/rut/protocol/openid-connect/token"
-};
-var CLIENT_IDS = {
-  [Environment.SANDBOX]: "api-stag",
-  [Environment.PRODUCTION]: "api-prod"
-};
-var IDP_LOGOUT_URLS = {
-  [Environment.SANDBOX]: "https://idp.comprobanteselectronicos.go.cr/auth/realms/rut-stag/protocol/openid-connect/logout",
-  [Environment.PRODUCTION]: "https://idp.comprobanteselectronicos.go.cr/auth/realms/rut/protocol/openid-connect/token/logout"
-};
-var ECONOMIC_ACTIVITY_API_URL = "https://api.hacienda.go.cr/fe/ae";
-var DocumentTypeCode = {
-  /** Factura Electronica */
-  FACTURA_ELECTRONICA: "01",
-  /** Nota de Debito Electronica */
-  NOTA_DEBITO_ELECTRONICA: "02",
-  /** Nota de Credito Electronica */
-  NOTA_CREDITO_ELECTRONICA: "03",
-  /** Tiquete Electronico */
-  TIQUETE_ELECTRONICO: "04",
-  /** Factura Electronica de Compra */
-  FACTURA_ELECTRONICA_COMPRA: "05",
-  /** Factura Electronica de Exportacion */
-  FACTURA_ELECTRONICA_EXPORTACION: "06",
-  /** Recibo Electronico de Pago (new in v4.4) */
-  RECIBO_ELECTRONICO_PAGO: "07",
-  /** Compra de Pago */
-  COMPRA_PAGO: "08",
-  /** Gasto de Viaje */
-  GASTO_VIAJE: "09"
-};
-var DOCUMENT_TYPE_NAMES = {
-  [DocumentTypeCode.FACTURA_ELECTRONICA]: "Factura Electr\xF3nica",
-  [DocumentTypeCode.NOTA_DEBITO_ELECTRONICA]: "Nota de D\xE9bito Electr\xF3nica",
-  [DocumentTypeCode.NOTA_CREDITO_ELECTRONICA]: "Nota de Cr\xE9dito Electr\xF3nica",
-  [DocumentTypeCode.TIQUETE_ELECTRONICO]: "Tiquete Electr\xF3nico",
-  [DocumentTypeCode.FACTURA_ELECTRONICA_COMPRA]: "Factura Electr\xF3nica de Compra",
-  [DocumentTypeCode.FACTURA_ELECTRONICA_EXPORTACION]: "Factura Electr\xF3nica de Exportaci\xF3n",
-  [DocumentTypeCode.RECIBO_ELECTRONICO_PAGO]: "Recibo Electr\xF3nico de Pago",
-  [DocumentTypeCode.COMPRA_PAGO]: "Compra de Pago",
-  [DocumentTypeCode.GASTO_VIAJE]: "Gasto de Viaje"
-};
-var MensajeReceptorCode = {
-  /** Aceptado totalmente */
-  ACEPTADO: "1",
-  /** Aceptado parcialmente */
-  ACEPTADO_PARCIALMENTE: "2",
-  /** Rechazado */
-  RECHAZADO: "3"
-};
-var SituationCode = {
-  /** Normal */
-  NORMAL: "1",
-  /** Contingencia (contingency) */
-  CONTINGENCIA: "2",
-  /** Sin internet (no internet) */
-  SIN_INTERNET: "3"
-};
-var TaxCode = {
-  /** Impuesto al Valor Agregado (IVA) */
-  IVA: "01",
-  /** Impuesto Selectivo de Consumo */
-  IMPUESTO_SELECTIVO_CONSUMO: "02",
-  /** Impuesto Unico a los Combustibles */
-  IMPUESTO_UNICO_COMBUSTIBLES: "03",
-  /** Impuesto Especifico de Bebidas Alcoholicas */
-  IMPUESTO_BEBIDAS_ALCOHOLICAS: "04",
-  /** Impuesto Especifico sobre Bebidas Envasadas sin Alcohol y Jabones de Tocador */
-  IMPUESTO_BEBIDAS_SIN_ALCOHOL: "05",
-  /** Impuesto al Tabaco */
-  IMPUESTO_TABACO: "06",
-  /** IVA (calculo especial) */
-  IVA_CALCULO_ESPECIAL: "07",
-  /** IVA Regimen de Bienes Usados (Factor) */
-  IVA_BIENES_USADOS: "08",
-  /** Impuesto Especifico al Cemento */
-  IMPUESTO_CEMENTO: "12",
-  /** Otros */
-  OTROS: "99"
-};
-var IvaRateCode = {
-  /** Tarifa 0% (Exento) */
-  EXENTO: "01",
-  /** Tarifa reducida 1% */
-  REDUCIDA_1: "02",
-  /** Tarifa reducida 2% */
-  REDUCIDA_2: "03",
-  /** Tarifa reducida 4% */
-  REDUCIDA_4: "04",
-  /** Transitorio 0% */
-  TRANSITORIO_0: "05",
-  /** Transitorio 4% */
-  TRANSITORIO_4: "06",
-  /** Transitorio 8% */
-  TRANSITORIO_8: "07",
-  /** Tarifa general 13% */
-  GENERAL_13: "08"
-};
-var IVA_RATE_PERCENTAGES = {
-  [IvaRateCode.EXENTO]: 0,
-  [IvaRateCode.REDUCIDA_1]: 1,
-  [IvaRateCode.REDUCIDA_2]: 2,
-  [IvaRateCode.REDUCIDA_4]: 4,
-  [IvaRateCode.TRANSITORIO_0]: 0,
-  [IvaRateCode.TRANSITORIO_4]: 4,
-  [IvaRateCode.TRANSITORIO_8]: 8,
-  [IvaRateCode.GENERAL_13]: 13
-};
-var ExonerationType = {
-  /** Compras autorizadas */
-  COMPRAS_AUTORIZADAS: "01",
-  /** Ventas exentas a diplomáticos */
-  VENTAS_EXENTAS_DIPLOMATICOS: "02",
-  /** Autorizado por ley especial */
-  AUTORIZADO_LEY_ESPECIAL: "03",
-  /** Exenciones de la Dirección General de Hacienda */
-  EXENCIONES_DGH: "04",
-  /** Transitorio V */
-  TRANSITORIO_V: "05",
-  /** Transitorio IX */
-  TRANSITORIO_IX: "06",
-  /** Transitorio XVII */
-  TRANSITORIO_XVII: "07",
-  /** Otros */
-  OTROS: "99"
-};
-var UnitOfMeasure = {
-  /** Servicios profesionales (sp) */
-  SERVICIOS_PROFESIONALES: "Sp",
-  /** Metros */
-  METROS: "m",
-  /** Kilogramos */
-  KILOGRAMOS: "kg",
-  /** Segundos */
-  SEGUNDOS: "s",
-  /** Amperes */
-  AMPERES: "A",
-  /** Kelvin */
-  KELVIN: "K",
-  /** Moles */
-  MOLES: "mol",
-  /** Candelas */
-  CANDELAS: "cd",
-  /** Metros cuadrados */
-  METROS_CUADRADOS: "m\xB2",
-  /** Metros cubicos */
-  METROS_CUBICOS: "m\xB3",
-  /** Litros */
-  LITROS: "l",
-  /** Watts */
-  WATTS: "W",
-  /** Voltios */
-  VOLTIOS: "V",
-  /** Julios (Joules) */
-  JULIOS: "J",
-  /** Gramos */
-  GRAMOS: "g",
-  /** Toneladas */
-  TONELADAS: "t",
-  /** Galones */
-  GALONES: "Gal",
-  /** Unidad */
-  UNIDAD: "Unid",
-  /** Otros (especificar) */
-  OTROS: "Os",
-  /** Pulgadas */
-  PULGADAS: "in",
-  /** Centimetros */
-  CENTIMETROS: "cm",
-  /** Mililitros */
-  MILILITROS: "ml",
-  /** Onzas */
-  ONZAS: "oz",
-  /** Libras */
-  LIBRAS: "lb",
-  /** Pies */
-  PIES: "ft",
-  /** Yardas */
-  YARDAS: "yd",
-  /** Horas */
-  HORAS: "h",
-  /** Minutos */
-  MINUTOS: "min",
-  /** Dias */
-  DIAS: "d",
-  /** Cajas */
-  CAJAS: "Cj",
-  /** Paquetes */
-  PAQUETES: "Pq"
-};
-var IdentificationType = {
-  /** Cedula Fisica (physical person ID) — 9 digits */
-  CEDULA_FISICA: "01",
-  /** Cedula Juridica (legal entity ID) — 10 digits */
-  CEDULA_JURIDICA: "02",
-  /** DIMEX (foreign resident ID) — 11-12 digits */
-  DIMEX: "03",
-  /** NITE (tax ID for foreigners without DIMEX) — 10 digits */
-  NITE: "04"
-};
-var IDENTIFICATION_TYPE_NAMES = {
-  [IdentificationType.CEDULA_FISICA]: "C\xE9dula F\xEDsica",
-  [IdentificationType.CEDULA_JURIDICA]: "C\xE9dula Jur\xEDdica",
-  [IdentificationType.DIMEX]: "DIMEX",
-  [IdentificationType.NITE]: "NITE"
-};
-var IDENTIFICATION_LENGTHS = {
-  [IdentificationType.CEDULA_FISICA]: [9],
-  [IdentificationType.CEDULA_JURIDICA]: [10],
-  [IdentificationType.DIMEX]: [11, 12],
-  [IdentificationType.NITE]: [10]
-};
-var SaleCondition = {
-  /** Contado (cash / immediate payment) */
-  CONTADO: "01",
-  /** Credito (credit) */
-  CREDITO: "02",
-  /** Consignacion */
-  CONSIGNACION: "03",
-  /** Apartado */
-  APARTADO: "04",
-  /** Arrendamiento con opcion de compra */
-  ARRENDAMIENTO_OPCION_COMPRA: "05",
-  /** Arrendamiento en funcion financiera */
-  ARRENDAMIENTO_FUNCION_FINANCIERA: "06",
-  /** Cobro a favor de un tercero */
-  COBRO_FAVOR_TERCERO: "07",
-  /** Servicios prestados al Estado a credito */
-  SERVICIOS_ESTADO_CREDITO: "08",
-  /** Pago del servicio prestado al Estado */
-  PAGO_SERVICIO_ESTADO: "09",
-  /** Otros (especificar) */
-  OTROS: "99"
-};
-var SALE_CONDITION_NAMES = {
-  [SaleCondition.CONTADO]: "Contado",
-  [SaleCondition.CREDITO]: "Cr\xE9dito",
-  [SaleCondition.CONSIGNACION]: "Consignaci\xF3n",
-  [SaleCondition.APARTADO]: "Apartado",
-  [SaleCondition.ARRENDAMIENTO_OPCION_COMPRA]: "Arrendamiento con opci\xF3n de compra",
-  [SaleCondition.ARRENDAMIENTO_FUNCION_FINANCIERA]: "Arrendamiento en funci\xF3n financiera",
-  [SaleCondition.COBRO_FAVOR_TERCERO]: "Cobro a favor de un tercero",
-  [SaleCondition.SERVICIOS_ESTADO_CREDITO]: "Servicios prestados al Estado a cr\xE9dito",
-  [SaleCondition.PAGO_SERVICIO_ESTADO]: "Pago del servicio prestado al Estado",
-  [SaleCondition.OTROS]: "Otros"
-};
-var PaymentMethod = {
-  /** Efectivo (cash) */
-  EFECTIVO: "01",
-  /** Tarjeta (card) */
-  TARJETA: "02",
-  /** Cheque */
-  CHEQUE: "03",
-  /** Transferencia - Deposito bancario */
-  TRANSFERENCIA: "04",
-  /** Recaudado por terceros */
-  RECAUDADO_TERCEROS: "05",
-  /** Otros (especificar) */
-  OTROS: "99"
-};
-var PAYMENT_METHOD_NAMES = {
-  [PaymentMethod.EFECTIVO]: "Efectivo",
-  [PaymentMethod.TARJETA]: "Tarjeta",
-  [PaymentMethod.CHEQUE]: "Cheque",
-  [PaymentMethod.TRANSFERENCIA]: "Transferencia - Dep\xF3sito bancario",
-  [PaymentMethod.RECAUDADO_TERCEROS]: "Recaudado por terceros",
-  [PaymentMethod.OTROS]: "Otros"
-};
-var ProvinceCode = {
-  /** San Jose */
-  SAN_JOSE: "1",
-  /** Alajuela */
-  ALAJUELA: "2",
-  /** Cartago */
-  CARTAGO: "3",
-  /** Heredia */
-  HEREDIA: "4",
-  /** Guanacaste */
-  GUANACASTE: "5",
-  /** Puntarenas */
-  PUNTARENAS: "6",
-  /** Limon */
-  LIMON: "7"
-};
-var PROVINCE_NAMES = {
-  [ProvinceCode.SAN_JOSE]: "San Jos\xE9",
-  [ProvinceCode.ALAJUELA]: "Alajuela",
-  [ProvinceCode.CARTAGO]: "Cartago",
-  [ProvinceCode.HEREDIA]: "Heredia",
-  [ProvinceCode.GUANACASTE]: "Guanacaste",
-  [ProvinceCode.PUNTARENAS]: "Puntarenas",
-  [ProvinceCode.LIMON]: "Lim\xF3n"
-};
-var TelefonoSchema = z.object({
-  /** Country code (e.g., "506"). Max 3 digits. */
-  codigoPais: z.string().regex(/^\d{1,3}$/),
-  /** Phone number. Max 20 digits. */
-  numTelefono: z.string().regex(/^\d{1,20}$/)
-});
-var UbicacionSchema = z.object({
-  /** Province code (1-7). */
-  provincia: z.string().regex(/^[1-7]$/),
-  /** Canton code (2 digits, 01-99). */
-  canton: z.string().regex(/^\d{2}$/),
-  /** Distrito code (2 digits, 01-99). */
-  distrito: z.string().regex(/^\d{2}$/),
-  /** Barrio code (2 digits). Optional. */
-  barrio: z.string().regex(/^\d{2}$/).optional(),
-  /** Additional address details. Optional, max 250 chars. */
-  otrasSenas: z.string().max(250).optional()
-});
-var IdentificationTypeSchema = z2.enum([
-  IdentificationType.CEDULA_FISICA,
-  IdentificationType.CEDULA_JURIDICA,
-  IdentificationType.DIMEX,
-  IdentificationType.NITE
-]);
-var IdentificacionSchema = z2.object({
-  /** Identification type code. */
-  tipo: IdentificationTypeSchema,
-  /** Identification number (digits only). */
-  numero: z2.string().regex(/^\d+$/, "Must contain only digits")
-}).refine(
-  (data) => {
-    const expectedLengths = IDENTIFICATION_LENGTHS[data.tipo];
-    if (!expectedLengths) return true;
-    return expectedLengths.includes(data.numero.length);
-  },
-  {
-    message: "Identification number length does not match the expected length for the given type",
-    path: ["numero"]
-  }
-);
-var EmisorSchema = z3.object({
-  /** Issuer name (Nombre o Razon Social). Max 100 chars. */
-  nombre: z3.string().min(1).max(100),
-  /** Taxpayer identification. */
-  identificacion: IdentificacionSchema,
-  /** Commercial name. Optional, max 80 chars. */
-  nombreComercial: z3.string().max(80).optional(),
-  /** Location. Optional. */
-  ubicacion: UbicacionSchema.optional(),
-  /** Phone number. Optional. */
-  telefono: TelefonoSchema.optional(),
-  /** Fax number. Optional. */
-  fax: TelefonoSchema.optional(),
-  /** Email address. */
-  correoElectronico: z3.string().email().max(160)
-});
-var ReceptorSchema = z4.object({
-  /** Receiver name. Max 100 chars. */
-  nombre: z4.string().min(1).max(100),
-  /** Taxpayer identification. Optional for some doc types (e.g., Tiquete). */
-  identificacion: IdentificacionSchema.optional(),
-  /** Foreign identification number. Optional, max 20 chars. */
-  identificacionExtranjero: z4.string().max(20).optional(),
-  /** Commercial name. Optional, max 80 chars. */
-  nombreComercial: z4.string().max(80).optional(),
-  /** Location. Optional. */
-  ubicacion: UbicacionSchema.optional(),
-  /** Phone number. Optional. */
-  telefono: TelefonoSchema.optional(),
-  /** Fax number. Optional. */
-  fax: TelefonoSchema.optional(),
-  /** Email address. Optional, max 160 chars. */
-  correoElectronico: z4.string().email().max(160).optional()
-});
-var CodigoComercialSchema = z5.object({
-  /** Code type: 01=Seller, 02=Buyer, 03=Industry, 04=Internal, 99=Other. */
-  tipo: z5.enum(["01", "02", "03", "04", "99"]),
-  /** Product/service code value. Max 20 chars. */
-  codigo: z5.string().min(1).max(20)
-});
-var ExoneracionSchema = z5.object({
-  /** Exoneration document type. */
-  tipoDocumento: z5.enum([
-    ExonerationType.COMPRAS_AUTORIZADAS,
-    ExonerationType.VENTAS_EXENTAS_DIPLOMATICOS,
-    ExonerationType.AUTORIZADO_LEY_ESPECIAL,
-    ExonerationType.EXENCIONES_DGH,
-    ExonerationType.TRANSITORIO_V,
-    ExonerationType.TRANSITORIO_IX,
-    ExonerationType.TRANSITORIO_XVII,
-    ExonerationType.OTROS
-  ]),
-  /** Exoneration document number. Max 40 chars. */
-  numeroDocumento: z5.string().min(1).max(40),
-  /** Issuing institution name. Max 160 chars. */
-  nombreInstitucion: z5.string().min(1).max(160),
-  /** Issue date (ISO 8601). */
-  fechaEmision: z5.string().min(1),
-  /** Exoneration percentage (0-100). */
-  porcentajeExoneracion: z5.number().min(0).max(100),
-  /** Exonerated tax amount. */
-  montoExoneracion: z5.number().min(0)
-});
-var ImpuestoSchema = z5.object({
-  /** Tax type code. */
-  codigo: z5.enum([
-    TaxCode.IVA,
-    TaxCode.IMPUESTO_SELECTIVO_CONSUMO,
-    TaxCode.IMPUESTO_UNICO_COMBUSTIBLES,
-    TaxCode.IMPUESTO_BEBIDAS_ALCOHOLICAS,
-    TaxCode.IMPUESTO_BEBIDAS_SIN_ALCOHOL,
-    TaxCode.IMPUESTO_TABACO,
-    TaxCode.IVA_CALCULO_ESPECIAL,
-    TaxCode.IVA_BIENES_USADOS,
-    TaxCode.IMPUESTO_CEMENTO,
-    TaxCode.OTROS
-  ]),
-  /** IVA rate code. Required when tax code is IVA-related. */
-  codigoTarifa: z5.enum([
-    IvaRateCode.EXENTO,
-    IvaRateCode.REDUCIDA_1,
-    IvaRateCode.REDUCIDA_2,
-    IvaRateCode.REDUCIDA_4,
-    IvaRateCode.TRANSITORIO_0,
-    IvaRateCode.TRANSITORIO_4,
-    IvaRateCode.TRANSITORIO_8,
-    IvaRateCode.GENERAL_13
-  ]).optional(),
-  /** Tax rate percentage. */
-  tarifa: z5.number().min(0),
-  /** Tax amount. */
-  monto: z5.number().min(0),
-  /** Exoneration information. Optional. */
-  exoneracion: ExoneracionSchema.optional()
-});
-var DescuentoSchema = z5.object({
-  /** Discount amount. Must be positive. */
-  montoDescuento: z5.number().positive(),
-  /** Reason for discount. Max 80 chars. */
-  naturalezaDescuento: z5.string().min(1).max(80)
-});
-var LineaDetalleSchema = z5.object({
-  /** Line number (1-based, sequential). */
-  numeroLinea: z5.number().int().positive(),
-  /** CABYS code — 13 digits, required in v4.4. */
-  codigoCabys: z5.string().regex(/^\d{13}$/, "CABYS code must be exactly 13 digits"),
-  /** Commercial codes. Optional. */
-  codigoComercial: z5.array(CodigoComercialSchema).optional(),
-  /** Quantity. Must be positive. */
-  cantidad: z5.number().positive(),
-  /** Unit of measure. */
-  unidadMedida: z5.string().min(1).max(20),
-  /** Item description. Max 200 chars. */
-  detalle: z5.string().min(1).max(200),
-  /** Unit price (before taxes and discounts). */
-  precioUnitario: z5.number().min(0),
-  /** Total line amount (cantidad * precioUnitario). */
-  montoTotal: z5.number().min(0),
-  /** Discounts applied. Optional. */
-  descuento: z5.array(DescuentoSchema).optional(),
-  /** Subtotal after discounts. */
-  subTotal: z5.number().min(0),
-  /** Base taxable amount. Optional. */
-  baseImponible: z5.number().min(0).optional(),
-  /** Taxes applied to this line item. Optional. */
-  impuesto: z5.array(ImpuestoSchema).optional(),
-  /** Net IVA tax amount. Optional. */
-  impuestoNeto: z5.number().min(0).optional(),
-  /** Total line amount including taxes. */
-  montoTotalLinea: z5.number().min(0)
-});
-var ClaveComponentsSchema = z6.object({
-  /** Country code — must be "506". */
-  countryCode: z6.literal("506"),
-  /** Date in DDMMYY format. */
-  date: z6.string().regex(/^\d{6}$/, "Date must be in DDMMYY format (6 digits)"),
-  /** Taxpayer ID, zero-padded to 12 digits. */
-  taxpayerId: z6.string().regex(/^\d{12}$/, "Taxpayer ID must be exactly 12 digits (zero-padded)"),
-  /** Branch number, zero-padded to 3 digits. */
-  branch: z6.string().regex(/^\d{3}$/, "Branch must be exactly 3 digits"),
-  /** Terminal / POS number, zero-padded to 5 digits. */
-  terminal: z6.string().regex(/^\d{5}$/, "Terminal must be exactly 5 digits"),
-  /** Document type code (2 digits). */
-  documentType: z6.enum([
-    DocumentTypeCode.FACTURA_ELECTRONICA,
-    DocumentTypeCode.NOTA_DEBITO_ELECTRONICA,
-    DocumentTypeCode.NOTA_CREDITO_ELECTRONICA,
-    DocumentTypeCode.TIQUETE_ELECTRONICO,
-    DocumentTypeCode.FACTURA_ELECTRONICA_COMPRA,
-    DocumentTypeCode.FACTURA_ELECTRONICA_EXPORTACION,
-    DocumentTypeCode.RECIBO_ELECTRONICO_PAGO,
-    DocumentTypeCode.COMPRA_PAGO,
-    DocumentTypeCode.GASTO_VIAJE
-  ]),
-  /** Sequence number, zero-padded to 10 digits. */
-  sequence: z6.string().regex(/^\d{10}$/, "Sequence must be exactly 10 digits"),
-  /** Situation code (1 digit). */
-  situation: z6.enum([SituationCode.NORMAL, SituationCode.CONTINGENCIA, SituationCode.SIN_INTERNET]),
-  /** 8-digit security code. */
-  securityCode: z6.string().regex(/^\d{8}$/, "Security code must be exactly 8 digits")
-});
-var ClaveInputSchema = z6.object({
-  /** Emission date. */
-  date: z6.date(),
-  /** Taxpayer identification number (raw, without padding). 9-12 digits. */
-  taxpayerId: z6.string().regex(/^\d{9,12}$/, "Taxpayer ID must be 9-12 digits"),
-  /** Document type code. */
-  documentType: z6.enum([
-    DocumentTypeCode.FACTURA_ELECTRONICA,
-    DocumentTypeCode.NOTA_DEBITO_ELECTRONICA,
-    DocumentTypeCode.NOTA_CREDITO_ELECTRONICA,
-    DocumentTypeCode.TIQUETE_ELECTRONICO,
-    DocumentTypeCode.FACTURA_ELECTRONICA_COMPRA,
-    DocumentTypeCode.FACTURA_ELECTRONICA_EXPORTACION,
-    DocumentTypeCode.RECIBO_ELECTRONICO_PAGO,
-    DocumentTypeCode.COMPRA_PAGO,
-    DocumentTypeCode.GASTO_VIAJE
-  ]),
-  /** Sequential document number (1 to 9999999999). */
-  sequence: z6.number().int().positive().max(9999999999),
-  /** Branch number. Defaults to 1. */
-  branch: z6.number().int().positive().max(999).default(1),
-  /** Terminal / POS number. Defaults to 1. */
-  terminal: z6.number().int().positive().max(99999).default(1),
-  /** Situation code. Defaults to "1" (normal). */
-  situation: z6.enum([SituationCode.NORMAL, SituationCode.CONTINGENCIA, SituationCode.SIN_INTERNET]).default(SituationCode.NORMAL),
-  /** 8-digit security code. Generated randomly if not provided. */
-  securityCode: z6.string().regex(/^\d{8}$/, "Security code must be exactly 8 digits").optional()
-});
-var ClaveNumericaSchema = z6.string().length(50, "Clave numerica must be exactly 50 characters").regex(/^\d{50}$/, "Clave numerica must contain only digits");
-var CodigoTipoMonedaSchema = z7.object({
-  /** ISO 4217 currency code (e.g., "USD", "CRC", "EUR"). */
-  codigoMoneda: z7.string().length(3),
-  /** Exchange rate to CRC. Must be positive. */
-  tipoCambio: z7.number().positive()
-});
-var InformacionReferenciaSchema = z7.object({
-  /** Referenced document type code. */
-  tipoDoc: z7.string().regex(/^\d{2}$/),
-  /** Referenced document clave or number. Max 50 chars. */
-  numero: z7.string().min(1).max(50),
-  /** Date of the referenced document (ISO 8601). */
-  fechaEmision: z7.string().min(1),
-  /** Reference reason code. */
-  codigo: z7.enum(["01", "02", "04", "05", "99"]),
-  /** Description of the reason. Max 180 chars. */
-  razon: z7.string().min(1).max(180)
-});
-var OtroCargoSchema = z7.object({
-  /** Charge document type. */
-  tipoDocumento: z7.string().min(1),
-  /** Third-party identification number. Optional. */
-  numeroIdentidadTercero: z7.string().optional(),
-  /** Third-party name. Optional, max 100 chars. */
-  nombreTercero: z7.string().max(100).optional(),
-  /** Detail. Max 160 chars. */
-  detalle: z7.string().min(1).max(160),
-  /** Percentage. Optional. */
-  porcentaje: z7.number().min(0).max(100).optional(),
-  /** Charge amount. */
-  montoOtroCargo: z7.number().min(0)
-});
-var ResumenFacturaSchema = z7.object({
-  /** Currency information. Optional (defaults to CRC). */
-  codigoTipoMoneda: CodigoTipoMonedaSchema.optional(),
-  /** Total taxable services. */
-  totalServGravados: z7.number().min(0),
-  /** Total exempt services. */
-  totalServExentos: z7.number().min(0),
-  /** Total exonerated services. Optional. */
-  totalServExonerado: z7.number().min(0).optional(),
-  /** Total taxable merchandise. */
-  totalMercanciasGravadas: z7.number().min(0),
-  /** Total exempt merchandise. */
-  totalMercanciasExentas: z7.number().min(0),
-  /** Total exonerated merchandise. Optional. */
-  totalMercExonerada: z7.number().min(0).optional(),
-  /** Total taxable. */
-  totalGravado: z7.number().min(0),
-  /** Total exempt. */
-  totalExento: z7.number().min(0),
-  /** Total exonerated. Optional. */
-  totalExonerado: z7.number().min(0).optional(),
-  /** Total sales (before tax). */
-  totalVenta: z7.number().min(0),
-  /** Total discounts. */
-  totalDescuentos: z7.number().min(0),
-  /** Net sales (totalVenta - totalDescuentos). */
-  totalVentaNeta: z7.number().min(0),
-  /** Total IVA tax. */
-  totalImpuesto: z7.number().min(0),
-  /** Total IVA returned. Optional. */
-  totalIVADevuelto: z7.number().min(0).optional(),
-  /** Total other charges. Optional. */
-  totalOtrosCargos: z7.number().min(0).optional(),
-  /** Grand total. */
-  totalComprobante: z7.number().min(0)
-});
-var OtroContenidoSchema = z7.object({
-  contenido: z7.string().min(1)
-});
-var SaleConditionValues = [
-  SaleCondition.CONTADO,
-  SaleCondition.CREDITO,
-  SaleCondition.CONSIGNACION,
-  SaleCondition.APARTADO,
-  SaleCondition.ARRENDAMIENTO_OPCION_COMPRA,
-  SaleCondition.ARRENDAMIENTO_FUNCION_FINANCIERA,
-  SaleCondition.COBRO_FAVOR_TERCERO,
-  SaleCondition.SERVICIOS_ESTADO_CREDITO,
-  SaleCondition.PAGO_SERVICIO_ESTADO,
-  SaleCondition.OTROS
-];
-var PaymentMethodValues = [
-  PaymentMethod.EFECTIVO,
-  PaymentMethod.TARJETA,
-  PaymentMethod.CHEQUE,
-  PaymentMethod.TRANSFERENCIA,
-  PaymentMethod.RECAUDADO_TERCEROS,
-  PaymentMethod.OTROS
-];
-var FacturaElectronicaSchema = z7.object({
-  /** 50-digit clave numerica. */
-  clave: z7.string().length(50).regex(/^\d{50}$/),
-  /** CABYS activity code. */
-  codigoActividad: z7.string().regex(/^\d{6}$/, "Activity code must be 6 digits"),
-  /** Sequential document number (20 chars). */
-  numeroConsecutivo: z7.string().length(20).regex(/^\d{20}$/),
-  /** Emission date (ISO 8601 with timezone). */
-  fechaEmision: z7.string().min(1),
-  /** Issuer information. */
-  emisor: EmisorSchema,
-  /** Receiver information. Required for Factura. */
-  receptor: ReceptorSchema,
-  /** Sale condition. */
-  condicionVenta: z7.enum(SaleConditionValues),
-  /** Credit term in days. Required when condicionVenta is "02". */
-  plazoCredito: z7.string().optional(),
-  /** Payment methods. At least one required. */
-  medioPago: z7.array(z7.enum(PaymentMethodValues)).min(1),
-  /** Line items. At least one required. */
-  detalleServicio: z7.array(LineaDetalleSchema).min(1),
-  /** Other charges. Optional. */
-  otrosCargos: z7.array(OtroCargoSchema).optional(),
-  /** Invoice summary / totals. */
-  resumenFactura: ResumenFacturaSchema,
-  /** References to other documents. Optional. */
-  informacionReferencia: z7.array(InformacionReferenciaSchema).optional(),
-  /** Additional content. Optional. */
-  otros: z7.array(OtroContenidoSchema).optional()
-});
-var EnvironmentSchema = z8.enum([Environment.SANDBOX, Environment.PRODUCTION]);
-var CredentialConfigSchema = z8.object({
-  /** Full username. */
-  username: z8.string().min(1).email().or(z8.string().min(1)),
-  /** Path to the .p12 certificate file. */
-  p12Path: z8.string().min(1)
-});
-var AppConfigSchema = z8.object({
-  /** Active environment. */
-  environment: EnvironmentSchema,
-  /** Per-environment credential configuration. */
-  credentials: z8.object({
-    [Environment.SANDBOX]: CredentialConfigSchema.optional(),
-    [Environment.PRODUCTION]: CredentialConfigSchema.optional()
-  }).optional()
-});
 // ../sdk/dist/index.js
 var import_node_forge = __toESM(require_lib(), 1);
 var import_xmldom = __toESM(require_lib2(), 1);
@@ -59136,15 +59624,15 @@ function loadCredentials(input) {
 }
 var SANDBOX_CONFIG = Object.freeze({
   name: "Sandbox",
-  apiBaseUrl: "https://api.comprobanteselectronicos.go.cr/recepcion-sandbox/v1",
-  idpTokenUrl: "https://idp.comprobanteselectronicos.go.cr/auth/realms/rut-stag/protocol/openid-connect/token",
-  clientId: "api-stag"
+  apiBaseUrl: API_BASE_URLS.sandbox,
+  idpTokenUrl: IDP_TOKEN_URLS.sandbox,
+  clientId: CLIENT_IDS.sandbox
 });
 var PRODUCTION_CONFIG = Object.freeze({
   name: "Production",
-  apiBaseUrl: "https://api.comprobanteselectronicos.go.cr/recepcion/v1",
-  idpTokenUrl: "https://idp.comprobanteselectronicos.go.cr/auth/realms/rut/protocol/openid-connect/token",
-  clientId: "api-prod"
+  apiBaseUrl: API_BASE_URLS.production,
+  idpTokenUrl: IDP_TOKEN_URLS.production,
+  clientId: CLIENT_IDS.production
 });
 var ENVIRONMENT_CONFIGS = Object.freeze({
   [
@@ -59354,31 +59842,15 @@ var TokenManager = class {
   }
 };
 var COUNTRY_CODE = "506";
-var DocumentType = /* @__PURE__ */ ((DocumentType2) => {
-  DocumentType2["FACTURA_ELECTRONICA"] = "01";
-  DocumentType2["NOTA_DEBITO"] = "02";
-  DocumentType2["NOTA_CREDITO"] = "03";
-  DocumentType2["TIQUETE_ELECTRONICO"] = "04";
-  DocumentType2["CONFIRMACION_ACEPTACION"] = "05";
-  DocumentType2["CONFIRMACION_ACEPTACION_PARCIAL"] = "06";
-  DocumentType2["CONFIRMACION_RECHAZO"] = "07";
-  DocumentType2["FACTURA_COMPRA"] = "08";
-  DocumentType2["FACTURA_EXPORTACION"] = "09";
-  return DocumentType2;
-})(DocumentType || {});
-var Situation = /* @__PURE__ */ ((Situation2) => {
-  Situation2["NORMAL"] = "1";
-  Situation2["CONTINGENCIA"] = "2";
-  Situation2["SIN_INTERNET"] = "3";
-  return Situation2;
-})(Situation || {});
+var DocumentType = DocumentTypeCode;
+var Situation = SituationCode;
 var CLAVE_LENGTH = 50;
 var VALID_DOCUMENT_TYPES = new Set(Object.values(DocumentType));
 var VALID_SITUATIONS = new Set(Object.values(Situation));
 var ClaveInputSchema2 = z22.object({
   date: z22.date({ message: "date must be a valid Date object" }),
-  taxpayerId: z22.string({ message: "taxpayerId must be a string" }).regex(/^\d{1,12}$/, {
-    message: "taxpayerId must be a numeric string between 1 and 12 digits long"
+  taxpayerId: z22.string({ message: "taxpayerId must be a string" }).regex(/^[A-Za-z0-9]{1,12}$/, {
+    message: "taxpayerId must be an alphanumeric string between 1 and 12 characters long"
   }),
   branch: z22.string().regex(/^\d{1,3}$/, {
     message: "branch must be a numeric string between 1 and 3 digits long"
@@ -59460,8 +59932,10 @@ function parseClave(clave) {
   if (clave.length !== 50) {
     throw new Error(`Clave must be exactly 50 characters, got ${clave.length}`);
   }
-  if (!/^\d{50}$/.test(clave)) {
-    throw new Error("Clave must contain only digits (0-9)");
+  if (!/^\d{9}[A-Za-z0-9]{12}\d{29}$/.test(clave)) {
+    throw new Error(
+      "Clave must be numeric except for the taxpayer-ID segment (positions 10-21), which may be alphanumeric"
+    );
   }
   const countryCode = clave.slice(0, 3);
   const dateRaw = clave.slice(3, 9);
@@ -60018,14 +60492,14 @@ async function getNextSequence(docType, branch = DEFAULT_BRANCH, pos = DEFAULT_P
 var HACIENDA_NAMESPACE_BASE = "https://cdn.comprobanteselectronicos.go.cr/xml-schemas/v4.4";
 var XSI_NAMESPACE = "http://www.w3.org/2001/XMLSchema-instance";
 var SCHEMA_FRAGMENTS = {
-  FacturaElectronica: "FacturaElectronica",
-  NotaCreditoElectronica: "NotaCreditoElectronica",
-  NotaDebitoElectronica: "NotaDebitoElectronica",
-  TiqueteElectronico: "TiqueteElectronico",
-  FacturaElectronicaCompra: "FacturaElectronicaCompra",
-  FacturaElectronicaExportacion: "FacturaElectronicaExportacion",
-  ReciboElectronicoPago: "ReciboElectronicoPago",
-  MensajeReceptor: "MensajeReceptor"
+  FacturaElectronica: "facturaElectronica",
+  NotaCreditoElectronica: "notaCreditoElectronica",
+  NotaDebitoElectronica: "notaDebitoElectronica",
+  TiqueteElectronico: "tiqueteElectronico",
+  FacturaElectronicaCompra: "facturaElectronicaCompra",
+  FacturaElectronicaExportacion: "facturaElectronicaExportacion",
+  ReciboElectronicoPago: "reciboElectronicoPago",
+  MensajeReceptor: "mensajeReceptor"
 };
 function getNamespaceUri(schemaName) {
   return `${HACIENDA_NAMESPACE_BASE}/${schemaName}`;
@@ -60053,7 +60527,7 @@ function buildXml(rootName, data, options) {
     "@_xmlns:xsi": XSI_NAMESPACE
   };
   if (includeSchemaLocation) {
-    rootAttributes["@_xsi:schemaLocation"] = `${namespace} ${schemaFragment}_V.4.4.xsd`;
+    rootAttributes["@_xsi:schemaLocation"] = `${namespace} ${rootName}_V4.4.xsd`;
   }
   const xmlObject = {
     "?xml": {
@@ -60085,36 +60559,38 @@ function calculateLineItemTotals(item) {
   const baseImponible = subTotal;
   const calculatedTaxes = [];
   let impuestoNeto = 0;
-  if (item.impuesto && item.impuesto.length > 0) {
-    for (const tax of item.impuesto) {
-      const fullTaxAmount = round5(subTotal * tax.tarifa / 100);
-      let taxAmount = fullTaxAmount;
-      let exoneracion;
-      if (tax.exoneracion) {
-        const exonerationPortion = round5(
-          fullTaxAmount * tax.exoneracion.porcentajeExoneracion / 100
+  const taxInputs = item.impuesto && item.impuesto.length > 0 ? item.impuesto : [{ codigo: TaxCode.IVA, codigoTarifaIVA: "01", tarifa: 0 }];
+  for (const tax of taxInputs) {
+    const fullTaxAmount = round5(subTotal * tax.tarifa / 100);
+    let taxAmount = fullTaxAmount;
+    let exoneracion;
+    if (tax.exoneracion) {
+      if (typeof tax.exoneracion.tarifaExonerada !== "number") {
+        throw new TypeError(
+          "exoneracion.tarifaExonerada must be a number (v4.4). The v4.3 field porcentajeExoneracion was replaced by tarifaExonerada (exonerated tariff percentage points, 0..tarifa)."
         );
-        taxAmount = round5(fullTaxAmount - exonerationPortion);
-        exoneracion = {
-          tipoDocumento: tax.exoneracion.tipoDocumento,
-          numeroDocumento: tax.exoneracion.numeroDocumento,
-          nombreInstitucion: tax.exoneracion.nombreInstitucion,
-          fechaEmision: tax.exoneracion.fechaEmision,
-          porcentajeExoneracion: tax.exoneracion.porcentajeExoneracion,
-          montoExoneracion: exonerationPortion
-        };
       }
-      const calculatedTax = {
-        codigo: tax.codigo,
-        tarifa: tax.tarifa,
-        monto: fullTaxAmount,
-        ...tax.codigoTarifa ? { codigoTarifa: tax.codigoTarifa } : {},
-        ...exoneracion ? { exoneracion } : {}
+      const exonerationPortion = round5(subTotal * tax.exoneracion.tarifaExonerada / 100);
+      taxAmount = round5(Math.max(0, fullTaxAmount - exonerationPortion));
+      exoneracion = {
+        tipoDocumento: tax.exoneracion.tipoDocumento,
+        numeroDocumento: tax.exoneracion.numeroDocumento,
+        nombreInstitucion: tax.exoneracion.nombreInstitucion,
+        fechaEmision: tax.exoneracion.fechaEmision,
+        tarifaExonerada: tax.exoneracion.tarifaExonerada,
+        montoExoneracion: exonerationPortion
       };
-      calculatedTaxes.push(calculatedTax);
-      if (IVA_TAX_CODES.includes(tax.codigo)) {
-        impuestoNeto = round5(impuestoNeto + taxAmount);
-      }
+    }
+    const calculatedTax = {
+      codigo: tax.codigo,
+      tarifa: tax.tarifa,
+      monto: fullTaxAmount,
+      ...tax.codigoTarifaIVA ? { codigoTarifaIVA: tax.codigoTarifaIVA } : {},
+      ...exoneracion ? { exoneracion } : {}
+    };
+    calculatedTaxes.push(calculatedTax);
+    if (IVA_TAX_CODES.includes(tax.codigo)) {
+      impuestoNeto = round5(impuestoNeto + taxAmount);
     }
   }
   impuestoNeto = round5(impuestoNeto);
@@ -60128,6 +60604,7 @@ function calculateLineItemTotals(item) {
     precioUnitario: item.precioUnitario,
     montoTotal,
     subTotal,
+    impuesto: calculatedTaxes,
     montoTotalLinea,
     esServicio: item.esServicio ?? false
   };
@@ -60137,11 +60614,9 @@ function calculateLineItemTotals(item) {
   if (item.descuento && item.descuento.length > 0) {
     result.descuento = item.descuento;
   }
-  if (calculatedTaxes.length > 0) {
-    result.impuesto = calculatedTaxes;
-    result.baseImponible = baseImponible;
-    result.impuestoNeto = impuestoNeto;
-  }
+  result.impuesto = calculatedTaxes;
+  result.baseImponible = baseImponible;
+  result.impuestoNeto = impuestoNeto;
   return result;
 }
 function classifyLineItem(item) {
@@ -60157,9 +60632,9 @@ function classifyLineItem(item) {
   if (hasExoneration) {
     let totalExonerado = 0;
     for (const tax of item.impuesto) {
-      if (tax.exoneracion) {
+      if (tax.exoneracion && tax.tarifa !== void 0 && tax.tarifa > 0) {
         totalExonerado = round5(
-          totalExonerado + subTotal * tax.exoneracion.porcentajeExoneracion / 100
+          totalExonerado + subTotal * tax.exoneracion.tarifaExonerada / tax.tarifa
         );
       }
     }
@@ -60204,6 +60679,23 @@ function calculateInvoiceSummary(items, otrosCargos) {
       totalImpuesto = round5(totalImpuesto + item.impuestoNeto);
     }
   }
+  const desglose = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    for (const tax of item.impuesto) {
+      const netAmount = round5(Math.max(0, tax.monto - (tax.exoneracion?.montoExoneracion ?? 0)));
+      const key = `${tax.codigo}|${tax.codigoTarifaIVA ?? ""}`;
+      const existing = desglose.get(key);
+      if (existing) {
+        existing.totalMontoImpuesto = round5(existing.totalMontoImpuesto + netAmount);
+      } else {
+        desglose.set(key, {
+          codigo: tax.codigo,
+          ...tax.codigoTarifaIVA ? { codigoTarifaIVA: tax.codigoTarifaIVA } : {},
+          totalMontoImpuesto: netAmount
+        });
+      }
+    }
+  }
   const totalGravado = round5(totalServGravados + totalMercanciasGravadas);
   const totalExento = round5(totalServExentos + totalMercanciasExentas);
   const totalExonerado = round5(totalServExonerado + totalMercExonerada);
@@ -60224,6 +60716,7 @@ function calculateInvoiceSummary(items, otrosCargos) {
     totalVenta,
     totalDescuentos,
     totalVentaNeta,
+    totalDesgloseImpuesto: [...desglose.values()],
     totalImpuesto,
     totalComprobante
   };
@@ -60233,77 +60726,154 @@ var IVA_TAX_CODES2 = [
   TaxCode.IVA_CALCULO_ESPECIAL,
   TaxCode.IVA_BIENES_USADOS
 ];
-function buildEmisorXml(emisor) {
+var DOCUMENT_VARIANTS = {
+  FacturaElectronica: {
+    codigoActividadEmisor: "required",
+    codigoActividadReceptor: true,
+    lineaConCabys: true,
+    lineaConBaseImponible: true,
+    lineaConImpuestoNeto: true,
+    lineaConImpuestoAsumido: "required",
+    lineaConPartidaArancelaria: false,
+    lineaCompleta: true,
+    cuerpoCompleto: true
+  },
+  TiqueteElectronico: {
+    codigoActividadEmisor: "required",
+    codigoActividadReceptor: false,
+    lineaConCabys: true,
+    lineaConBaseImponible: true,
+    lineaConImpuestoNeto: true,
+    lineaConImpuestoAsumido: "required",
+    lineaConPartidaArancelaria: false,
+    lineaCompleta: true,
+    cuerpoCompleto: true
+  },
+  NotaCreditoElectronica: {
+    codigoActividadEmisor: "optional",
+    codigoActividadReceptor: true,
+    lineaConCabys: true,
+    lineaConBaseImponible: true,
+    lineaConImpuestoNeto: true,
+    lineaConImpuestoAsumido: "optional",
+    lineaConPartidaArancelaria: true,
+    lineaCompleta: true,
+    cuerpoCompleto: true
+  },
+  NotaDebitoElectronica: {
+    codigoActividadEmisor: "optional",
+    codigoActividadReceptor: true,
+    lineaConCabys: true,
+    lineaConBaseImponible: true,
+    lineaConImpuestoNeto: true,
+    lineaConImpuestoAsumido: "optional",
+    lineaConPartidaArancelaria: true,
+    lineaCompleta: true,
+    cuerpoCompleto: true
+  },
+  FacturaElectronicaCompra: {
+    codigoActividadEmisor: "optional",
+    codigoActividadReceptor: true,
+    lineaConCabys: true,
+    lineaConBaseImponible: true,
+    lineaConImpuestoNeto: true,
+    lineaConImpuestoAsumido: "optional",
+    lineaConPartidaArancelaria: false,
+    lineaCompleta: true,
+    cuerpoCompleto: true
+  },
+  FacturaElectronicaExportacion: {
+    codigoActividadEmisor: "required",
+    codigoActividadReceptor: false,
+    lineaConCabys: true,
+    lineaConBaseImponible: false,
+    lineaConImpuestoNeto: false,
+    lineaConImpuestoAsumido: "none",
+    lineaConPartidaArancelaria: true,
+    lineaCompleta: true,
+    cuerpoCompleto: true
+  },
+  ReciboElectronicoPago: {
+    codigoActividadEmisor: "none",
+    codigoActividadReceptor: false,
+    lineaConCabys: false,
+    lineaConBaseImponible: false,
+    lineaConImpuestoNeto: true,
+    lineaConImpuestoAsumido: "none",
+    lineaConPartidaArancelaria: false,
+    lineaCompleta: false,
+    cuerpoCompleto: false
+  }
+};
+function buildIdentificacionXml(identificacion) {
+  return {
+    Tipo: identificacion.tipo,
+    Numero: identificacion.numero
+  };
+}
+function buildEmisorXml(emisor, minimal = false) {
   const result = {
     Nombre: emisor.nombre,
-    Identificacion: {
-      Tipo: emisor.identificacion.tipo,
-      Numero: emisor.identificacion.numero
-    }
+    Identificacion: buildIdentificacionXml(emisor.identificacion)
   };
-  if (emisor.nombreComercial) {
-    result.NombreComercial = emisor.nombreComercial;
-  }
-  if (emisor.ubicacion) {
+  if (!minimal) {
+    if (emisor.registrofiscal8707) {
+      result.Registrofiscal8707 = emisor.registrofiscal8707;
+    }
+    if (emisor.nombreComercial) {
+      result.NombreComercial = emisor.nombreComercial;
+    }
+    if (!emisor.ubicacion) {
+      throw new Error(
+        "emisor.ubicacion is required by the v4.4 schemas (provincia, canton, distrito, otrasSenas)"
+      );
+    }
     result.Ubicacion = {
       Provincia: emisor.ubicacion.provincia,
       Canton: emisor.ubicacion.canton,
       Distrito: emisor.ubicacion.distrito,
       ...emisor.ubicacion.barrio ? { Barrio: emisor.ubicacion.barrio } : {},
-      ...emisor.ubicacion.otrasSenas ? { OtrasSenas: emisor.ubicacion.otrasSenas } : {}
-    };
-  }
-  if (emisor.telefono) {
-    result.Telefono = {
-      CodigoPais: emisor.telefono.codigoPais,
-      NumTelefono: emisor.telefono.numTelefono
-    };
-  }
-  if (emisor.fax) {
-    result.Fax = {
-      CodigoPais: emisor.fax.codigoPais,
-      NumTelefono: emisor.fax.numTelefono
+      OtrasSenas: emisor.ubicacion.otrasSenas
     };
+    if (emisor.telefono) {
+      result.Telefono = {
+        CodigoPais: emisor.telefono.codigoPais,
+        NumTelefono: emisor.telefono.numTelefono
+      };
+    }
   }
   result.CorreoElectronico = emisor.correoElectronico;
   return result;
 }
-function buildReceptorXml(receptor) {
+function buildReceptorXml(receptor, minimal = false) {
   const result = {
     Nombre: receptor.nombre
   };
   if (receptor.identificacion) {
-    result.Identificacion = {
-      Tipo: receptor.identificacion.tipo,
-      Numero: receptor.identificacion.numero
-    };
-  }
-  if (receptor.identificacionExtranjero) {
-    result.IdentificacionExtranjero = receptor.identificacionExtranjero;
-  }
-  if (receptor.nombreComercial) {
-    result.NombreComercial = receptor.nombreComercial;
+    result.Identificacion = buildIdentificacionXml(receptor.identificacion);
   }
-  if (receptor.ubicacion) {
-    result.Ubicacion = {
-      Provincia: receptor.ubicacion.provincia,
-      Canton: receptor.ubicacion.canton,
-      Distrito: receptor.ubicacion.distrito,
-      ...receptor.ubicacion.barrio ? { Barrio: receptor.ubicacion.barrio } : {},
-      ...receptor.ubicacion.otrasSenas ? { OtrasSenas: receptor.ubicacion.otrasSenas } : {}
-    };
-  }
-  if (receptor.telefono) {
-    result.Telefono = {
-      CodigoPais: receptor.telefono.codigoPais,
-      NumTelefono: receptor.telefono.numTelefono
-    };
-  }
-  if (receptor.fax) {
-    result.Fax = {
-      CodigoPais: receptor.fax.codigoPais,
-      NumTelefono: receptor.fax.numTelefono
-    };
+  if (!minimal) {
+    if (receptor.nombreComercial) {
+      result.NombreComercial = receptor.nombreComercial;
+    }
+    if (receptor.ubicacion) {
+      result.Ubicacion = {
+        Provincia: receptor.ubicacion.provincia,
+        Canton: receptor.ubicacion.canton,
+        Distrito: receptor.ubicacion.distrito,
+        ...receptor.ubicacion.barrio ? { Barrio: receptor.ubicacion.barrio } : {},
+        OtrasSenas: receptor.ubicacion.otrasSenas
+      };
+    }
+    if (receptor.otrasSenasExtranjero) {
+      result.OtrasSenasExtranjero = receptor.otrasSenasExtranjero;
+    }
+    if (receptor.telefono) {
+      result.Telefono = {
+        CodigoPais: receptor.telefono.codigoPais,
+        NumTelefono: receptor.telefono.numTelefono
+      };
+    }
   }
   if (receptor.correoElectronico) {
     result.CorreoElectronico = receptor.correoElectronico;
@@ -60314,19 +60884,32 @@ function buildImpuestoXml(impuesto) {
   const result = {
     Codigo: impuesto.codigo
   };
-  if (impuesto.codigoTarifa) {
-    result.CodigoTarifa = impuesto.codigoTarifa;
+  if (impuesto.codigoImpuestoOtros) {
+    result.CodigoImpuestoOTRO = impuesto.codigoImpuestoOtros;
+  }
+  if (impuesto.codigoTarifaIVA) {
+    result.CodigoTarifaIVA = impuesto.codigoTarifaIVA;
+  }
+  if (impuesto.tarifa !== void 0) {
+    result.Tarifa = impuesto.tarifa;
+  }
+  if (impuesto.factorCalculoIVA !== void 0) {
+    result.FactorCalculoIVA = impuesto.factorCalculoIVA;
   }
-  result.Tarifa = impuesto.tarifa;
   result.Monto = impuesto.monto;
   if (impuesto.exoneracion) {
+    const exo = impuesto.exoneracion;
     result.Exoneracion = {
-      TipoDocumento: impuesto.exoneracion.tipoDocumento,
-      NumeroDocumento: impuesto.exoneracion.numeroDocumento,
-      NombreInstitucion: impuesto.exoneracion.nombreInstitucion,
-      FechaEmision: impuesto.exoneracion.fechaEmision,
-      PorcentajeExoneracion: impuesto.exoneracion.porcentajeExoneracion,
-      MontoExoneracion: impuesto.exoneracion.montoExoneracion
+      TipoDocumentoEX1: exo.tipoDocumento,
+      ...exo.tipoDocumentoOtros ? { TipoDocumentoOTRO: exo.tipoDocumentoOtros } : {},
+      NumeroDocumento: exo.numeroDocumento,
+      ...exo.articulo !== void 0 ? { Articulo: exo.articulo } : {},
+      ...exo.inciso !== void 0 ? { Inciso: exo.inciso } : {},
+      NombreInstitucion: exo.nombreInstitucion,
+      ...exo.nombreInstitucionOtros ? { NombreInstitucionOtros: exo.nombreInstitucionOtros } : {},
+      FechaEmisionEX: exo.fechaEmision,
+      TarifaExonerada: exo.tarifaExonerada,
+      MontoExoneracion: exo.montoExoneracion
     };
   }
   return result;
@@ -60334,96 +60917,134 @@ function buildImpuestoXml(impuesto) {
 function buildDescuentoXml(descuento) {
   return {
     MontoDescuento: descuento.montoDescuento,
-    NaturalezaDescuento: descuento.naturalezaDescuento
+    CodigoDescuento: descuento.codigoDescuento,
+    ...descuento.codigoDescuentoOtros ? { CodigoDescuentoOTRO: descuento.codigoDescuentoOtros } : {},
+    ...descuento.naturalezaDescuento ? { NaturalezaDescuento: descuento.naturalezaDescuento } : {}
   };
 }
-function buildLineaDetalleXml(linea) {
+function buildLineaDetalleXml(linea, variant = DOCUMENT_VARIANTS.FacturaElectronica) {
   const result = {
-    NumeroLinea: linea.numeroLinea,
-    Codigo: linea.codigoCabys
+    NumeroLinea: linea.numeroLinea
   };
-  if (linea.codigoComercial && linea.codigoComercial.length > 0) {
-    result.CodigoComercial = linea.codigoComercial.map((c) => ({
-      Tipo: c.tipo,
-      Codigo: c.codigo
-    }));
+  if (variant.lineaConPartidaArancelaria && linea.partidaArancelaria) {
+    result.PartidaArancelaria = linea.partidaArancelaria;
+  }
+  if (variant.lineaConCabys) {
+    result.CodigoCABYS = linea.codigoCabys;
+  }
+  if (variant.lineaCompleta) {
+    if (linea.codigoComercial && linea.codigoComercial.length > 0) {
+      result.CodigoComercial = linea.codigoComercial.map((c) => ({
+        Tipo: c.tipo,
+        Codigo: c.codigo
+      }));
+    }
+    result.Cantidad = linea.cantidad;
+    result.UnidadMedida = linea.unidadMedida;
+    if (linea.tipoTransaccion) {
+      result.TipoTransaccion = linea.tipoTransaccion;
+    }
+    if (linea.unidadMedidaComercial) {
+      result.UnidadMedidaComercial = linea.unidadMedidaComercial;
+    }
   }
-  result.Cantidad = linea.cantidad;
-  result.UnidadMedida = linea.unidadMedida;
   result.Detalle = linea.detalle;
-  result.PrecioUnitario = linea.precioUnitario;
+  if (variant.lineaCompleta) {
+    if (linea.numeroVINoSerie && linea.numeroVINoSerie.length > 0) {
+      result.NumeroVINoSerie = linea.numeroVINoSerie;
+    }
+    result.PrecioUnitario = linea.precioUnitario;
+  }
   result.MontoTotal = linea.montoTotal;
-  if (linea.descuento && linea.descuento.length > 0) {
+  if (variant.lineaCompleta && linea.descuento && linea.descuento.length > 0) {
     result.Descuento = linea.descuento.map((d) => buildDescuentoXml(d));
   }
   result.SubTotal = linea.subTotal;
-  if (linea.baseImponible !== void 0) {
-    result.BaseImponible = linea.baseImponible;
+  if (variant.lineaConBaseImponible) {
+    result.BaseImponible = linea.baseImponible ?? linea.subTotal;
   }
   if (linea.impuesto && linea.impuesto.length > 0) {
     result.Impuesto = linea.impuesto.map((t) => buildImpuestoXml(t));
   }
-  if (linea.impuestoNeto !== void 0) {
-    result.ImpuestoNeto = linea.impuestoNeto;
+  if (variant.lineaConImpuestoAsumido === "required") {
+    result.ImpuestoAsumidoEmisorFabrica = linea.impuestoAsumidoEmisorFabrica ?? 0;
+  } else if (variant.lineaConImpuestoAsumido === "optional" && linea.impuestoAsumidoEmisorFabrica !== void 0) {
+    result.ImpuestoAsumidoEmisorFabrica = linea.impuestoAsumidoEmisorFabrica;
+  }
+  if (variant.lineaConImpuestoNeto) {
+    result.ImpuestoNeto = linea.impuestoNeto ?? 0;
   }
   result.MontoTotalLinea = linea.montoTotalLinea;
   return result;
 }
 function buildResumenFacturaXml(resumen) {
-  const result = {};
-  if (resumen.codigoTipoMoneda) {
-    result.CodigoTipoMoneda = {
-      CodigoMoneda: resumen.codigoTipoMoneda.codigoMoneda,
-      TipoCambio: resumen.codigoTipoMoneda.tipoCambio
-    };
-  }
-  result.TotalServGravados = resumen.totalServGravados;
-  result.TotalServExentos = resumen.totalServExentos;
-  if (resumen.totalServExonerado !== void 0 && resumen.totalServExonerado > 0) {
-    result.TotalServExonerado = resumen.totalServExonerado;
-  }
-  result.TotalMercanciasGravadas = resumen.totalMercanciasGravadas;
-  result.TotalMercanciasExentas = resumen.totalMercanciasExentas;
-  if (resumen.totalMercExonerada !== void 0 && resumen.totalMercExonerada > 0) {
-    result.TotalMercExonerada = resumen.totalMercExonerada;
-  }
-  result.TotalGravado = resumen.totalGravado;
-  result.TotalExento = resumen.totalExento;
-  if (resumen.totalExonerado !== void 0 && resumen.totalExonerado > 0) {
-    result.TotalExonerado = resumen.totalExonerado;
-  }
+  const result = {
+    CodigoTipoMoneda: {
+      CodigoMoneda: resumen.codigoTipoMoneda?.codigoMoneda ?? "CRC",
+      TipoCambio: resumen.codigoTipoMoneda?.tipoCambio ?? 1
+    }
+  };
+  const optionalTotal = (key, value) => {
+    if (value !== void 0) {
+      result[key] = value;
+    }
+  };
+  optionalTotal("TotalServGravados", resumen.totalServGravados);
+  optionalTotal("TotalServExentos", resumen.totalServExentos);
+  optionalTotal("TotalServExonerado", resumen.totalServExonerado);
+  optionalTotal("TotalServNoSujeto", resumen.totalServNoSujeto);
+  optionalTotal("TotalMercanciasGravadas", resumen.totalMercanciasGravadas);
+  optionalTotal("TotalMercanciasExentas", resumen.totalMercanciasExentas);
+  optionalTotal("TotalMercExonerada", resumen.totalMercExonerada);
+  optionalTotal("TotalMercNoSujeta", resumen.totalMercNoSujeta);
+  optionalTotal("TotalGravado", resumen.totalGravado);
+  optionalTotal("TotalExento", resumen.totalExento);
+  optionalTotal("TotalExonerado", resumen.totalExonerado);
+  optionalTotal("TotalNoSujeto", resumen.totalNoSujeto);
   result.TotalVenta = resumen.totalVenta;
-  result.TotalDescuentos = resumen.totalDescuentos;
+  optionalTotal("TotalDescuentos", resumen.totalDescuentos);
   result.TotalVentaNeta = resumen.totalVentaNeta;
-  result.TotalImpuesto = resumen.totalImpuesto;
-  if (resumen.totalIVADevuelto !== void 0 && resumen.totalIVADevuelto > 0) {
-    result.TotalIVADevuelto = resumen.totalIVADevuelto;
+  if (resumen.totalDesgloseImpuesto && resumen.totalDesgloseImpuesto.length > 0) {
+    result.TotalDesgloseImpuesto = resumen.totalDesgloseImpuesto.map((d) => ({
+      Codigo: d.codigo,
+      ...d.codigoTarifaIVA ? { CodigoTarifaIVA: d.codigoTarifaIVA } : {},
+      TotalMontoImpuesto: d.totalMontoImpuesto
+    }));
   }
-  if (resumen.totalOtrosCargos !== void 0 && resumen.totalOtrosCargos > 0) {
-    result.TotalOtrosCargos = resumen.totalOtrosCargos;
+  optionalTotal("TotalImpuesto", resumen.totalImpuesto);
+  optionalTotal("TotalImpAsumEmisorFabrica", resumen.totalImpAsumEmisorFabrica);
+  optionalTotal("TotalIVADevuelto", resumen.totalIVADevuelto);
+  optionalTotal("TotalOtrosCargos", resumen.totalOtrosCargos);
+  if (resumen.medioPago && resumen.medioPago.length > 0) {
+    result.MedioPago = resumen.medioPago.map((m) => ({
+      TipoMedioPago: m.tipoMedioPago,
+      ...m.medioPagoOtros ? { MedioPagoOtros: m.medioPagoOtros } : {},
+      TotalMedioPago: m.totalMedioPago
+    }));
   }
   result.TotalComprobante = resumen.totalComprobante;
   return result;
 }
 function buildOtrosCargosXml(otrosCargos) {
-  return {
-    OtroCargo: otrosCargos.map((c) => ({
-      TipoDocumento: c.tipoDocumento,
-      ...c.numeroIdentidadTercero ? { NumeroIdentidadTercero: c.numeroIdentidadTercero } : {},
-      ...c.nombreTercero ? { NombreTercero: c.nombreTercero } : {},
-      Detalle: c.detalle,
-      ...c.porcentaje !== void 0 ? { Porcentaje: c.porcentaje } : {},
-      MontoOtroCargo: c.montoOtroCargo
-    }))
-  };
+  return otrosCargos.map((c) => ({
+    TipoDocumentoOC: c.tipoDocumento,
+    ...c.tipoDocumentoOtros ? { TipoDocumentoOTROS: c.tipoDocumentoOtros } : {},
+    ...c.identificacionTercero ? { IdentificacionTercero: buildIdentificacionXml(c.identificacionTercero) } : {},
+    ...c.nombreTercero ? { NombreTercero: c.nombreTercero } : {},
+    Detalle: c.detalle,
+    ...c.porcentaje !== void 0 ? { PorcentajeOC: c.porcentaje } : {},
+    MontoCargo: c.montoCargo
+  }));
 }
 function buildInformacionReferenciaXml(refs) {
   return refs.map((ref) => ({
-    TipoDoc: ref.tipoDoc,
-    Numero: ref.numero,
-    FechaEmision: ref.fechaEmision,
-    Codigo: ref.codigo,
-    Razon: ref.razon
+    TipoDocIR: ref.tipoDoc,
+    ...ref.tipoDocOtros ? { TipoDocRefOTRO: ref.tipoDocOtros } : {},
+    ...ref.numero ? { Numero: ref.numero } : {},
+    FechaEmisionIR: ref.fechaEmision,
+    ...ref.codigo ? { Codigo: ref.codigo } : {},
+    ...ref.codigoOtros ? { CodigoReferenciaOTRO: ref.codigoOtros } : {},
+    ...ref.razon ? { Razon: ref.razon } : {}
   }));
 }
 function buildOtrosXml(otros) {
@@ -60433,39 +61054,66 @@ function buildOtrosXml(otros) {
     }))
   };
 }
-function buildStandardDocumentBody(input) {
+function buildStandardDocumentBody(input, variant = DOCUMENT_VARIANTS.FacturaElectronica) {
+  const minimalParties = !variant.cuerpoCompleto;
+  const legacy = input;
+  if (legacy.codigoActividad !== void 0) {
+    throw new Error(
+      "codigoActividad was renamed to codigoActividadEmisor in v4.4 (with optional codigoActividadReceptor)"
+    );
+  }
+  if (legacy.medioPago !== void 0) {
+    throw new Error(
+      "medioPago moved into resumenFactura.medioPago in v4.4 (entries of { tipoMedioPago, totalMedioPago })"
+    );
+  }
   const data = {
     Clave: input.clave,
-    CodigoActividad: input.codigoActividad,
-    NumeroConsecutivo: input.numeroConsecutivo,
-    FechaEmision: input.fechaEmision,
-    Emisor: buildEmisorXml(input.emisor)
+    ProveedorSistemas: input.proveedorSistemas
   };
+  if (variant.codigoActividadEmisor === "required" && !input.codigoActividadEmisor) {
+    throw new Error("codigoActividadEmisor is required for this document type (v4.4)");
+  }
+  if (variant.codigoActividadEmisor !== "none" && input.codigoActividadEmisor) {
+    data.CodigoActividadEmisor = input.codigoActividadEmisor;
+  }
+  if (variant.codigoActividadReceptor && input.codigoActividadReceptor) {
+    data.CodigoActividadReceptor = input.codigoActividadReceptor;
+  }
+  data.NumeroConsecutivo = input.numeroConsecutivo;
+  data.FechaEmision = input.fechaEmision;
+  data.Emisor = buildEmisorXml(input.emisor, minimalParties);
   if (input.receptor) {
-    data.Receptor = buildReceptorXml(input.receptor);
+    data.Receptor = buildReceptorXml(input.receptor, minimalParties);
   }
   data.CondicionVenta = input.condicionVenta;
-  if (input.plazoCredito) {
-    data.PlazoCredito = input.plazoCredito;
+  if (variant.cuerpoCompleto) {
+    if (input.condicionVentaOtros) {
+      data.CondicionVentaOtros = input.condicionVentaOtros;
+    }
+    if (input.plazoCredito) {
+      data.PlazoCredito = input.plazoCredito;
+    }
   }
-  data.MedioPago = input.medioPago;
   data.DetalleServicio = {
-    LineaDetalle: input.detalleServicio.map((line) => buildLineaDetalleXml(line))
+    LineaDetalle: input.detalleServicio.map(
+      (line) => buildLineaDetalleXml(line, variant)
+    )
   };
-  if (input.otrosCargos && input.otrosCargos.length > 0) {
+  if (variant.cuerpoCompleto && input.otrosCargos && input.otrosCargos.length > 0) {
     data.OtrosCargos = buildOtrosCargosXml(input.otrosCargos);
   }
   data.ResumenFactura = buildResumenFacturaXml(input.resumenFactura);
   if (input.informacionReferencia && input.informacionReferencia.length > 0) {
     data.InformacionReferencia = buildInformacionReferenciaXml(input.informacionReferencia);
   }
-  if (input.otros && input.otros.length > 0) {
+  if (variant.cuerpoCompleto && input.otros && input.otros.length > 0) {
     data.Otros = buildOtrosXml(input.otros);
   }
   return data;
 }
 function buildFacturaXml(input) {
-  const data = buildStandardDocumentBody(input);
+  const data = buildStandardDocumentBody(input, DOCUMENT_VARIANTS.FacturaElectronica);
   return buildXml("FacturaElectronica", data);
 }
 var LEVEL_NAMES = {
@@ -60682,17 +61330,18 @@ async function lookupTaxpayer(id, options) {
 // src/tools/create-invoice.ts
 var ImpuestoInputSchema = z10.object({
   codigo: z10.string().describe('Tax type code (e.g. "01" for IVA)'),
-  codigoTarifa: z10.string().optional().describe('IVA rate code (e.g. "08" for 13%)'),
+  codigoTarifaIVA: z10.string().optional().describe('IVA rate code (e.g. "08" for 13%)'),
   tarifa: z10.number().describe("Tax rate percentage (e.g. 13 for 13%)")
 });
 var DescuentoInputSchema = z10.object({
   montoDescuento: z10.number().positive().describe("Discount amount"),
+  codigoDescuento: z10.string().default("01").describe('Discount code (v4.4 CodigoDescuento). Defaults to "01"'),
   naturalezaDescuento: z10.string().describe("Reason for discount")
 });
 var LineItemInputSchema = z10.object({
   codigoCabys: z10.string().describe("CABYS code (13 digits)"),
   cantidad: z10.number().positive().describe("Quantity"),
-  unidadMedida: z10.string().describe('Unit of measure (e.g. "Unid", "Sp", "kg")'),
+  unidadMedida: z10.enum(UNITS_OF_MEASURE).describe('Unit of measure from the official v4.4 catalog (e.g. "Unid", "Sp", "Kg", "h")'),
   detalle: z10.string().describe("Item description (max 200 chars)"),
   precioUnitario: z10.number().min(0).describe("Unit price before taxes"),
   esServicio: z10.boolean().optional().describe("Whether this is a service (true) or merchandise (false). Defaults to false"),
@@ -60703,10 +61352,18 @@ var IdentificacionInputSchema = z10.object({
   tipo: z10.string().describe('ID type: "01"=Fisica, "02"=Juridica, "03"=DIMEX, "04"=NITE'),
   numero: z10.string().describe("ID number (digits only)")
 });
+var UbicacionInputSchema = z10.object({
+  provincia: z10.string().regex(/^[1-7]$/).describe("Province code (1-7)"),
+  canton: z10.string().regex(/^\d{2}$/).describe("Canton code (2 digits)"),
+  distrito: z10.string().regex(/^\d{2}$/).describe("District code (2 digits)"),
+  barrio: z10.string().min(5).max(50).optional().describe("Barrio name (free text 5-50 chars in v4.4; no longer a 2-digit code)"),
+  otrasSenas: z10.string().min(5).max(250).describe("Address details (5-250 chars, required in v4.4)")
+});
 var EmisorInputSchema = z10.object({
   nombre: z10.string().describe("Issuer name (max 100 chars)"),
   identificacion: IdentificacionInputSchema.describe("Taxpayer identification"),
   nombreComercial: z10.string().optional().describe("Commercial name"),
+  ubicacion: UbicacionInputSchema.describe("Issuer location (required in v4.4)"),
   correoElectronico: z10.string().describe("Email address")
 });
 var ReceptorInputSchema = z10.object({
@@ -60717,9 +61374,14 @@ var ReceptorInputSchema = z10.object({
 var CreateInvoiceInputSchema = z10.object({
   emisor: EmisorInputSchema.describe("Invoice issuer (emisor)"),
   receptor: ReceptorInputSchema.describe("Invoice receiver (receptor)"),
-  codigoActividad: z10.string().describe("CABYS activity code (6 digits)"),
+  proveedorSistemas: z10.string().optional().describe(
+    "Invoicing-system provider ID (ProveedorSistemas, v4.4). Defaults to the emisor's ID number"
+  ),
+  codigoActividadEmisor: z10.string().describe("Issuer economic activity code (6 digits)"),
   condicionVenta: z10.string().default("01").describe('Sale condition code: "01"=Cash, "02"=Credit, etc. Defaults to "01"'),
-  medioPago: z10.array(z10.string()).default(["01"]).describe('Payment methods: ["01"]=Cash, ["02"]=Card, etc. Defaults to ["01"]'),
+  medioPago: z10.string().default("01").describe(
+    'Payment method: "01"=Cash, "02"=Card, "04"=Transfer, "06"=SINPE Movil. Defaults to "01"'
+  ),
   lineItems: z10.array(LineItemInputSchema).min(1).describe("Invoice line items (at least one required)"),
   plazoCredito: z10.string().optional().describe("Credit term in days (required when condicionVenta is 02)")
 });
@@ -60730,7 +61392,8 @@ function registerCreateInvoiceTool(server) {
     {
       emisor: EmisorInputSchema,
       receptor: ReceptorInputSchema,
-      codigoActividad: CreateInvoiceInputSchema.shape.codigoActividad,
+      proveedorSistemas: CreateInvoiceInputSchema.shape.proveedorSistemas,
+      codigoActividadEmisor: CreateInvoiceInputSchema.shape.codigoActividadEmisor,
       condicionVenta: CreateInvoiceInputSchema.shape.condicionVenta,
       medioPago: CreateInvoiceInputSchema.shape.medioPago,
       lineItems: CreateInvoiceInputSchema.shape.lineItems,
@@ -60773,7 +61436,8 @@ function registerCreateInvoiceTool(server) {
         }));
         const factura = {
           clave,
-          codigoActividad: args.codigoActividad,
+          proveedorSistemas: args.proveedorSistemas ?? args.emisor.identificacion.numero,
+          codigoActividadEmisor: args.codigoActividadEmisor,
           numeroConsecutivo,
           fechaEmision,
           emisor: {
@@ -60783,6 +61447,7 @@ function registerCreateInvoiceTool(server) {
               numero: args.emisor.identificacion.numero
             },
             ...args.emisor.nombreComercial ? { nombreComercial: args.emisor.nombreComercial } : {},
+            ubicacion: args.emisor.ubicacion,
             correoElectronico: args.emisor.correoElectronico
           },
           receptor: {
@@ -60797,7 +61462,6 @@ function registerCreateInvoiceTool(server) {
           },
           condicionVenta: args.condicionVenta,
           ...args.plazoCredito ? { plazoCredito: args.plazoCredito } : {},
-          medioPago: args.medioPago,
           detalleServicio,
           resumenFactura: {
             totalServGravados: summary.totalServGravados,
@@ -60812,7 +61476,14 @@ function registerCreateInvoiceTool(server) {
             totalVenta: summary.totalVenta,
             totalDescuentos: summary.totalDescuentos,
             totalVentaNeta: summary.totalVentaNeta,
+            totalDesgloseImpuesto: summary.totalDesgloseImpuesto,
             totalImpuesto: summary.totalImpuesto,
+            medioPago: [
+              {
+                tipoMedioPago: args.medioPago,
+                totalMedioPago: summary.totalComprobante
+              }
+            ],
             totalComprobante: summary.totalComprobante
           }
         };
@@ -61114,7 +61785,7 @@ function registerDraftInvoiceTool(server) {
       receptorIdTipo: z12.string().optional().describe('Receiver ID type (optional): "01"=Fisica, "02"=Juridica, "03"=DIMEX, "04"=NITE'),
       receptorIdNumero: z12.string().optional().describe("Receiver identification number (optional)"),
       receptorEmail: z12.string().optional().describe("Receiver email address (optional)"),
-      codigoActividad: z12.string().default("620100").describe("CABYS activity code (6 digits). Defaults to 620100 (IT services)"),
+      codigoActividadEmisor: z12.string().default("620100").describe("Issuer economic activity code (6 digits). Defaults to 620100 (IT services)"),
       description: z12.string().default("Servicio profesional").describe("Default line item description"),
       amount: z12.number().default(0).describe("Default line item amount (price). Set to 0 to leave as placeholder"),
       includeIva: z12.boolean().default(true).describe("Whether to include 13% IVA tax. Defaults to true")
@@ -61128,15 +61799,7 @@ function registerDraftInvoiceTool(server) {
         precioUnitario: args.amount,
         esServicio: true
       };
-      if (args.includeIva) {
-        lineItem.impuesto = [
-          {
-            codigo: "01",
-            codigoTarifa: "08",
-            tarifa: 13
-          }
-        ];
-      }
+      lineItem.impuesto = args.includeIva ? [{ codigo: "01", codigoTarifaIVA: "08", tarifa: 13 }] : [{ codigo: "01", codigoTarifaIVA: "01", tarifa: 0 }];
       const draft = {
         emisor: {
           nombre: args.emisorNombre,
@@ -61144,6 +61807,12 @@ function registerDraftInvoiceTool(server) {
             tipo: args.emisorIdTipo,
             numero: args.emisorIdNumero
           },
+          ubicacion: {
+            provincia: "1",
+            canton: "01",
+            distrito: "01",
+            otrasSenas: "<<COMPLETE_ISSUER_ADDRESS>>"
+          },
           correoElectronico: args.emisorEmail
         },
         receptor: {
@@ -61156,9 +61825,10 @@ function registerDraftInvoiceTool(server) {
           } : {},
           ...args.receptorEmail ? { correoElectronico: args.receptorEmail } : {}
         },
-        codigoActividad: args.codigoActividad,
+        proveedorSistemas: args.emisorIdNumero,
+        codigoActividadEmisor: args.codigoActividadEmisor,
         condicionVenta: "01",
-        medioPago: ["01"],
+        medioPago: "01",
         lineItems: [lineItem]
       };
       const idTypeName = IDENTIFICATION_TYPE_NAMES[args.emisorIdTipo] ?? args.emisorIdTipo;
@@ -61171,7 +61841,7 @@ function registerDraftInvoiceTool(server) {
               ``,
               `Emisor: ${args.emisorNombre} (${idTypeName}: ${args.emisorIdNumero})`,
               `Receptor: ${args.receptorNombre}`,
-              `Activity: ${args.codigoActividad}`,
+              `Activity: ${args.codigoActividadEmisor}`,
               `Sale Condition: Contado (cash)`,
               `Payment: Efectivo (cash)`,
               args.includeIva ? `IVA: 13% included` : `IVA: not included`,
@@ -61208,12 +61878,12 @@ var FACTURA_SCHEMA = {
   title: "Factura Electronica (Costa Rica)",
   description: "Schema for creating a Factura Electronica via the create_invoice tool. This describes the input format accepted by the tool.",
   type: "object",
-  required: ["emisor", "receptor", "codigoActividad", "lineItems"],
+  required: ["emisor", "receptor", "codigoActividadEmisor", "lineItems"],
   properties: {
     emisor: {
       type: "object",
       description: "Invoice issuer (emisor) information",
-      required: ["nombre", "identificacion", "correoElectronico"],
+      required: ["nombre", "identificacion", "ubicacion", "correoElectronico"],
       properties: {
         nombre: {
           type: "string",
@@ -61226,8 +61896,8 @@ var FACTURA_SCHEMA = {
           properties: {
             tipo: {
               type: "string",
-              enum: ["01", "02", "03", "04"],
-              description: "01=Cedula Fisica, 02=Cedula Juridica, 03=DIMEX, 04=NITE"
+              enum: ["01", "02", "03", "04", "05", "06"],
+              description: "01=Cedula Fisica, 02=Cedula Juridica, 03=DIMEX, 04=NITE, 05=Extranjero No Domiciliado, 06=No Contribuyente (05/06 new in v4.4)"
             },
             numero: {
               type: "string",
@@ -61241,6 +61911,32 @@ var FACTURA_SCHEMA = {
           maxLength: 80,
           description: "Commercial name (optional)"
         },
+        ubicacion: {
+          type: "object",
+          required: ["provincia", "canton", "distrito", "otrasSenas"],
+          description: "Issuer location (required by the v4.4 schemas)",
+          properties: {
+            provincia: { type: "string", pattern: "^[1-7]$", description: "Province code (1-7)" },
+            canton: { type: "string", pattern: "^\\d{2}$", description: "Canton code (2 digits)" },
+            distrito: {
+              type: "string",
+              pattern: "^\\d{2}$",
+              description: "District code (2 digits)"
+            },
+            barrio: {
+              type: "string",
+              minLength: 5,
+              maxLength: 50,
+              description: "Barrio name (free text 5-50 chars in v4.4; no longer a 2-digit code)"
+            },
+            otrasSenas: {
+              type: "string",
+              minLength: 5,
+              maxLength: 250,
+              description: "Address details (5-250 chars, required)"
+            }
+          }
+        },
         correoElectronico: {
           type: "string",
           format: "email",
@@ -61279,25 +61975,27 @@ var FACTURA_SCHEMA = {
         }
       }
     },
-    codigoActividad: {
+    proveedorSistemas: {
+      type: "string",
+      maxLength: 20,
+      description: "Invoicing-system provider ID (v4.4 ProveedorSistemas). Defaults to the emisor's ID number"
+    },
+    codigoActividadEmisor: {
       type: "string",
       pattern: "^\\d{6}$",
-      description: "CABYS economic activity code (6 digits)"
+      description: "Issuer economic activity code (6 digits, v4.4 CodigoActividadEmisor)"
     },
     condicionVenta: {
       type: "string",
-      enum: ["01", "02", "03", "04", "05", "06", "07", "08", "09", "99"],
+      enum: ["01", "02", "03", "04", "05", "06", "07", "08", "10", "12", "13", "14", "15", "99"],
       default: "01",
-      description: "Sale condition: 01=Cash, 02=Credit, 03=Consignment, 04=Layaway, 99=Other"
+      description: "Sale condition (v4.4): 01=Cash, 02=Credit, 03=Consignment, 04=Layaway, 99=Other"
     },
     medioPago: {
-      type: "array",
-      items: {
-        type: "string",
-        enum: ["01", "02", "03", "04", "05", "99"]
-      },
-      default: ["01"],
-      description: "Payment methods: 01=Cash, 02=Card, 03=Check, 04=Transfer, 05=Third-party, 99=Other"
+      type: "string",
+      enum: ["01", "02", "03", "04", "05", "06", "07", "99"],
+      default: "01",
+      description: "Payment method (v4.4, emitted inside ResumenFactura with the total): 01=Cash, 02=Card, 03=Check, 04=Transfer, 05=Third-party, 06=SINPE Movil, 07=Digital platform, 99=Other"
     },
     plazoCredito: {
       type: "string",
@@ -61324,7 +62022,7 @@ var FACTURA_SCHEMA = {
           },
           unidadMedida: {
             type: "string",
-            description: 'Unit of measure: "Sp"=Service, "Unid"=Unit, "kg"=Kilogram, "m"=Meter, etc.'
+            description: 'Unit of measure (official v4.4 catalog casing): "Sp"=Service, "Unid"=Unit, "Kg"=Kilogram, "M"=Meter, "L"=Liter, "h"=Hour, etc.'
           },
           detalle: {
             type: "string",
@@ -61352,9 +62050,9 @@ var FACTURA_SCHEMA = {
                   type: "string",
                   description: "Tax code: 01=IVA, 02=Selective, etc."
                 },
-                codigoTarifa: {
+                codigoTarifaIVA: {
                   type: "string",
-                  description: "IVA rate code: 01=0%, 02=1%, 03=2%, 04=4%, 08=13%"
+                  description: "IVA rate code (v4.4 CodigoTarifaIVA): 01=0%, 02=1%, 03=2%, 04=4%, 08=13%, 09=0.5%, 10=exempt, 11=0% without credit"
                 },
                 tarifa: {
                   type: "number",
@@ -61368,15 +62066,19 @@ var FACTURA_SCHEMA = {
             description: "Discounts",
             items: {
               type: "object",
-              required: ["montoDescuento", "naturalezaDescuento"],
+              required: ["montoDescuento", "codigoDescuento"],
               properties: {
                 montoDescuento: {
                   type: "number",
                   description: "Discount amount"
                 },
+                codigoDescuento: {
+                  type: "string",
+                  description: 'Discount code (v4.4 CodigoDescuento, "01".."09" or "99")'
+                },
                 naturalezaDescuento: {
                   type: "string",
-                  description: "Reason for discount"
+                  description: "Reason for discount (optional in v4.4)"
                 }
               }
             }
@@ -61571,8 +62273,6 @@ var TAX_REFERENCE = {
       description: "Square meters"
     },
     { code: UnitOfMeasure.METROS_CUBICOS, name: "Metros cubicos", description: "Cubic meters" },
-    { code: UnitOfMeasure.CAJAS, name: "Cajas", description: "Boxes" },
-    { code: UnitOfMeasure.PAQUETES, name: "Paquetes", description: "Packages" },
     { code: UnitOfMeasure.GALONES, name: "Galones", description: "Gallons" },
     { code: UnitOfMeasure.OTROS, name: "Otros", description: "Other (specify)" }
   ],