@timbra-ec/sri 0.1.0

package/dist/xml/shared.js

@@ -0,0 +1,93 @@
+/** Format a number to exactly 2 decimal places */
+export function money(value) {
+    return value.toFixed(2);
+}
+/** Convert ISO date (YYYY-MM-DD) to SRI format (dd/MM/yyyy) */
+export function toSriDate(isoDate) {
+    const [year, month, day] = isoDate.split('-');
+    return `${day}/${month}/${year}`;
+}
+/** Aggregate tax totals by codigoPorcentaje across all items */
+export function aggregateTaxTotals(items) {
+    const totals = new Map();
+    for (const item of items) {
+        for (const imp of item.impuestos) {
+            const key = `${imp.codigo}-${imp.codigoPorcentaje}`;
+            const existing = totals.get(key);
+            if (existing) {
+                existing.baseImponible += imp.baseImponible;
+                existing.valor += imp.valor;
+            }
+            else {
+                totals.set(key, {
+                    codigo: imp.codigo,
+                    codigoPorcentaje: imp.codigoPorcentaje,
+                    baseImponible: imp.baseImponible,
+                    valor: imp.valor,
+                });
+            }
+        }
+    }
+    return Array.from(totals.values());
+}
+/** Build the infoTributaria section (common to all SRI documents) */
+export function buildInfoTributaria(parent, input) {
+    const infoTrib = parent.ele('infoTributaria');
+    infoTrib.ele('ambiente').txt(input.ambiente);
+    infoTrib.ele('tipoEmision').txt(input.tipoEmision);
+    infoTrib.ele('razonSocial').txt(input.razonSocial);
+    if (input.nombreComercial) {
+        infoTrib.ele('nombreComercial').txt(input.nombreComercial);
+    }
+    infoTrib.ele('ruc').txt(input.ruc);
+    infoTrib.ele('claveAcceso').txt(input.claveAcceso);
+    infoTrib.ele('codDoc').txt(input.codDoc);
+    infoTrib.ele('estab').txt(input.estab);
+    infoTrib.ele('ptoEmi').txt(input.ptoEmi);
+    infoTrib.ele('secuencial').txt(input.secuencial);
+    infoTrib.ele('dirMatriz').txt(input.direccionMatriz);
+    if (input.regimenRimpe === 'emprendedor') {
+        infoTrib.ele('contribuyenteRimpe').txt('CONTRIBUYENTE RÉGIMEN RIMPE');
+    }
+    else if (input.regimenRimpe === 'negocio_popular') {
+        infoTrib.ele('contribuyenteRimpe').txt('CONTRIBUYENTE NEGOCIO POPULAR - RÉGIMEN RIMPE');
+    }
+}
+/** Build infoAdicional section */
+export function buildInfoAdicional(parent, infoAdicional) {
+    if (infoAdicional && Object.keys(infoAdicional).length > 0) {
+        const section = parent.ele('infoAdicional');
+        for (const [nombre, valor] of Object.entries(infoAdicional)) {
+            section.ele('campoAdicional', { nombre }).txt(valor);
+        }
+    }
+}
+/** Build detalles section from InvoiceItems */
+export function buildDetalles(parent, items) {
+    const detalles = parent.ele('detalles');
+    for (const item of items) {
+        const detalle = detalles.ele('detalle');
+        detalle.ele('codigoPrincipal').txt(item.codigoPrincipal);
+        detalle.ele('descripcion').txt(item.descripcion);
+        detalle.ele('cantidad').txt(money(item.cantidad));
+        detalle.ele('precioUnitario').txt(money(item.precioUnitario));
+        detalle.ele('descuento').txt(money(item.descuento));
+        detalle.ele('precioTotalSinImpuesto').txt(money(item.precioTotalSinImpuesto));
+        const impuestos = detalle.ele('impuestos');
+        for (const imp of item.impuestos) {
+            const impuesto = impuestos.ele('impuesto');
+            impuesto.ele('codigo').txt(imp.codigo);
+            impuesto.ele('codigoPorcentaje').txt(imp.codigoPorcentaje);
+            impuesto.ele('tarifa').txt(money(imp.tarifa));
+            impuesto.ele('baseImponible').txt(money(imp.baseImponible));
+            impuesto.ele('valor').txt(money(imp.valor));
+        }
+        if (item.detallesAdicionales && item.detallesAdicionales.length > 0) {
+            const detAdicionales = detalle.ele('detallesAdicionales');
+            for (const da of item.detallesAdicionales) {
+                detAdicionales.ele('detAdicional', { nombre: da.nombre }).txt(da.valor);
+            }
+        }
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/xml/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/xml/shared.ts"],"names":[],"mappings":"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"}

package/dist/xml/types.d.ts

@@ -0,0 +1,179 @@
+import type { DocumentTypeCode, EmissionType, InvoiceItem, PaymentDetail, SriEnvironment } from '@timbra-ec/types';
+/** Common fields for all SRI documents (used in infoTributaria) */
+export interface InfoTributariaInput {
+    ambiente: SriEnvironment;
+    tipoEmision: EmissionType;
+    ruc: string;
+    claveAcceso: string;
+    codDoc: DocumentTypeCode;
+    estab: string;
+    ptoEmi: string;
+    secuencial: string;
+    razonSocial: string;
+    nombreComercial?: string;
+    direccionMatriz: string;
+    regimenRimpe?: 'emprendedor' | 'negocio_popular' | null;
+}
+/** Input for building a Nota de Credito XML (codDoc=04) */
+export interface NotaCreditoInput {
+    infoTributaria: InfoTributariaInput;
+    /** Date in YYYY-MM-DD format */
+    fechaEmision: string;
+    obligadoContabilidad: boolean;
+    tipoIdentificacionComprador: string;
+    identificacionComprador: string;
+    razonSocialComprador: string;
+    /** codDoc of the modified document (e.g. '01' for factura) */
+    codDocModificado: DocumentTypeCode;
+    /** Document number being modified: estab-ptoEmi-secuencial (e.g. '001-001-000000001') */
+    numDocModificado: string;
+    /** Emission date of the modified document in YYYY-MM-DD */
+    fechaEmisionDocSustento: string;
+    /** Reason for the credit note */
+    motivo: string;
+    totalSinImpuestos: number;
+    importeTotal: number;
+    items: InvoiceItem[];
+    pagos: PaymentDetail[];
+    infoAdicional?: Record<string, string>;
+}
+/** Motivo entry for a Nota de Debito */
+export interface MotivoDebito {
+    razon: string;
+    valor: number;
+}
+/** Input for building a Nota de Debito XML (codDoc=05) */
+export interface NotaDebitoInput {
+    infoTributaria: InfoTributariaInput;
+    fechaEmision: string;
+    obligadoContabilidad: boolean;
+    tipoIdentificacionComprador: string;
+    identificacionComprador: string;
+    razonSocialComprador: string;
+    codDocModificado: DocumentTypeCode;
+    numDocModificado: string;
+    fechaEmisionDocSustento: string;
+    totalSinImpuestos: number;
+    importeTotal: number;
+    impuestos: {
+        codigo: string;
+        codigoPorcentaje: string;
+        tarifa: number;
+        baseImponible: number;
+        valor: number;
+    }[];
+    motivos: MotivoDebito[];
+    pagos: PaymentDetail[];
+    infoAdicional?: Record<string, string>;
+}
+/** Destinatario for a Guia de Remision */
+export interface Destinatario {
+    identificacionDestinatario: string;
+    razonSocialDestinatario: string;
+    dirDestinatario: string;
+    motivoTraslado: string;
+    /** Optional: referencing a factura or liquidacion */
+    codDocSustento?: DocumentTypeCode;
+    numDocSustento?: string;
+    numAutDocSustento?: string;
+    fechaEmisionDocSustento?: string;
+    detalles: {
+        codigoInterno: string;
+        descripcion: string;
+        cantidad: number;
+    }[];
+}
+/** Input for building a Guia de Remision XML (codDoc=06) */
+export interface GuiaRemisionInput {
+    infoTributaria: InfoTributariaInput;
+    fechaEmision: string;
+    obligadoContabilidad: boolean;
+    dirPartida: string;
+    razonSocialTransportista: string;
+    tipoIdentificacionTransportista: string;
+    rucTransportista: string;
+    placa: string;
+    fechaIniTransporte: string;
+    fechaFinTransporte: string;
+    destinatarios: Destinatario[];
+    infoAdicional?: Record<string, string>;
+}
+/** Retention line item */
+export interface RetencionDetalle {
+    /** '1' = renta, '2' = IVA, '6' = ISD */
+    codigo: string;
+    codigoRetencion: string;
+    baseImponible: number;
+    porcentajeRetener: number;
+    valorRetenido: number;
+    /** codDoc of the sustaining document */
+    codDocSustento: DocumentTypeCode;
+    numDocSustento: string;
+    fechaEmisionDocSustento: string;
+}
+/** Input for building a Comprobante de Retencion XML (codDoc=07, Version ATS) */
+export interface RetencionInput {
+    infoTributaria: InfoTributariaInput;
+    fechaEmision: string;
+    obligadoContabilidad: boolean;
+    tipoIdentificacionSujetoRetenido: string;
+    identificacionSujetoRetenido: string;
+    razonSocialSujetoRetenido: string;
+    periodoFiscal: string;
+    impuestos: RetencionDetalle[];
+    infoAdicional?: Record<string, string>;
+}
+/** Purchase detail for ATS */
+export interface AtsCompra {
+    codSustento: string;
+    tpIdProv: string;
+    idProv: string;
+    tipoComprobante: string;
+    parteRel: 'SI' | 'NO';
+    fechaRegistro: string;
+    establecimiento: string;
+    puntoEmision: string;
+    secuencial: string;
+    fechaEmision: string;
+    autorizacion: string;
+    baseNoGraIva: number;
+    baseImponible: number;
+    baseImpGrav: number;
+    montoIva: number;
+    valRetBien10: number;
+    valRetServ20: number;
+    valorRetBienes: number;
+    valRetServ50: number;
+    valorRetServicios: number;
+    valRetServ100: number;
+    totbasesImpReemb: number;
+}
+/** Sales detail for ATS */
+export interface AtsVenta {
+    tpIdCliente: string;
+    idCliente: string;
+    tipoComprobante: string;
+    tipoEmision: 'E' | 'F';
+    numeroComprobantes: number;
+    baseNoGraIva: number;
+    baseImponible: number;
+    baseImpGrav: number;
+    montoIva: number;
+    montoIce: number;
+    valorRetIva: number;
+    valorRetRenta: number;
+}
+/** Input for building ATS XML */
+export interface AtsInput {
+    tipoIDInformante: 'R' | 'C';
+    idInformante: string;
+    razonSocial: string;
+    anio: string;
+    mes: string;
+    numEstabRuc: string;
+    totalVentas: number;
+    codigoOperativo: string;
+    compras: AtsCompra[];
+    ventas: AtsVenta[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/xml/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/xml/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,cAAc,EACf,MAAM,kBAAkB,CAAA;AAEzB,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,CAAA;IACxB,WAAW,EAAE,YAAY,CAAA;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,gBAAgB,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,aAAa,GAAG,iBAAiB,GAAG,IAAI,CAAA;CACxD;AAED,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,mBAAmB,CAAA;IACnC,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,2BAA2B,EAAE,MAAM,CAAA;IACnC,uBAAuB,EAAE,MAAM,CAAA;IAC/B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,8DAA8D;IAC9D,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,yFAAyF;IACzF,gBAAgB,EAAE,MAAM,CAAA;IACxB,2DAA2D;IAC3D,uBAAuB,EAAE,MAAM,CAAA;IAC/B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,mBAAmB,CAAA;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,2BAA2B,EAAE,MAAM,CAAA;IACnC,uBAAuB,EAAE,MAAM,CAAA;IAC/B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,gBAAgB,EAAE,MAAM,CAAA;IACxB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,CAAA;QACd,gBAAgB,EAAE,MAAM,CAAA;QACxB,MAAM,EAAE,MAAM,CAAA;QACd,aAAa,EAAE,MAAM,CAAA;QACrB,KAAK,EAAE,MAAM,CAAA;KACd,EAAE,CAAA;IACH,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC;AAED,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,0BAA0B,EAAE,MAAM,CAAA;IAClC,uBAAuB,EAAE,MAAM,CAAA;IAC/B,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,qDAAqD;IACrD,cAAc,CAAC,EAAE,gBAAgB,CAAA;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,EAAE;QACR,aAAa,EAAE,MAAM,CAAA;QACrB,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,MAAM,CAAA;KACjB,EAAE,CAAA;CACJ;AAED,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,mBAAmB,CAAA;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,wBAAwB,EAAE,MAAM,CAAA;IAChC,+BAA+B,EAAE,MAAM,CAAA;IACvC,gBAAgB,EAAE,MAAM,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,kBAAkB,EAAE,MAAM,CAAA;IAC1B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,aAAa,EAAE,YAAY,EAAE,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC;AAED,0BAA0B;AAC1B,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,wCAAwC;IACxC,cAAc,EAAE,gBAAgB,CAAA;IAChC,cAAc,EAAE,MAAM,CAAA;IACtB,uBAAuB,EAAE,MAAM,CAAA;CAChC;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,mBAAmB,CAAA;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,gCAAgC,EAAE,MAAM,CAAA;IACxC,4BAA4B,EAAE,MAAM,CAAA;IACpC,yBAAyB,EAAE,MAAM,CAAA;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,gBAAgB,EAAE,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC;AAED,8BAA8B;AAC9B,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,2BAA2B;AAC3B,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,GAAG,GAAG,GAAG,CAAA;IACtB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,iCAAiC;AACjC,MAAM,WAAW,QAAQ;IACvB,gBAAgB,EAAE,GAAG,GAAG,GAAG,CAAA;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,MAAM,EAAE,QAAQ,EAAE,CAAA;CACnB"}

package/dist/xml/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/xml/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/xml/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@timbra-ec/sri",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/timbra-ec/timbra-app.git",
+    "directory": "packages/sri"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo 'no lint configured yet'"
+  },
+  "dependencies": {
+    "@timbra-ec/types": "workspace:*",
+    "@xmldom/xmldom": "^0.8.11",
+    "node-forge": "^1.4.0",
+    "xml-crypto": "^6.1.2",
+    "xmlbuilder2": "^4.0.3"
+  },
+  "devDependencies": {
+    "@types/node-forge": "^1.3.14",
+    "typescript": "^5.8.2"
+  }
+}

package/src/clave-acceso.ts

@@ -0,0 +1,106 @@
+import type { DocumentTypeCode, EmissionType, SriEnvironment } from '@timbra-ec/types'
+import { SriValidationError } from './errors'
+
+export interface ClaveAccesoInput {
+  /** Date in dd/MM/yyyy format */
+  fechaEmision: string
+  codDoc: DocumentTypeCode
+  ruc: string
+  ambiente: SriEnvironment
+  estab: string
+  ptoEmi: string
+  /** 9 digits, zero-padded */
+  secuencial: string
+  /** 8-digit random numeric code */
+  codigoNumerico: string
+  tipoEmision: EmissionType
+}
+
+/**
+ * Compute Modulo 11 check digit for SRI clave de acceso.
+ * Weights cycle 2,3,4,5,6,7 from right to left.
+ * Result: 11 - (sum % 11). If 11 → 0, if 10 → 1.
+ */
+export function computeModulo11(digits: string): number {
+  const weights = [2, 3, 4, 5, 6, 7]
+  let sum = 0
+
+  for (let i = digits.length - 1, w = 0; i >= 0; i--, w++) {
+    sum += parseInt(digits[i]!, 10) * weights[w % weights.length]!
+  }
+
+  const remainder = sum % 11
+  const check = 11 - remainder
+
+  if (check === 11) return 0
+  if (check === 10) return 1
+  return check
+}
+
+/**
+ * Generate the 49-digit clave de acceso for SRI electronic documents.
+ *
+ * Format (49 digits total):
+ * DDMMAAAA (8) + codDoc (2) + RUC (13) + ambiente (1) +
+ * estab (3) + ptoEmi (3) + secuencial (9) + codigoNumerico (8) +
+ * tipoEmision (1) + checkDigit (1)
+ */
+export function generateClaveAcceso(input: ClaveAccesoInput): string {
+  const {
+    fechaEmision,
+    codDoc,
+    ruc,
+    ambiente,
+    estab,
+    ptoEmi,
+    secuencial,
+    codigoNumerico,
+    tipoEmision,
+  } = input
+
+  // Validate date format dd/MM/yyyy and convert to DDMMAAAA
+  const dateParts = fechaEmision.split('/')
+  if (
+    dateParts.length !== 3 ||
+    dateParts[0]!.length !== 2 ||
+    dateParts[1]!.length !== 2 ||
+    dateParts[2]!.length !== 4
+  ) {
+    throw new SriValidationError('fechaEmision must be in dd/MM/yyyy format')
+  }
+  const dateDigits = dateParts[0]! + dateParts[1]! + dateParts[2]!
+
+  if (ruc.length !== 13) {
+    throw new SriValidationError(`RUC must be 13 digits, got ${ruc.length}`)
+  }
+  if (estab.length !== 3) {
+    throw new SriValidationError(`estab must be 3 digits, got ${estab.length}`)
+  }
+  if (ptoEmi.length !== 3) {
+    throw new SriValidationError(`ptoEmi must be 3 digits, got ${ptoEmi.length}`)
+  }
+  if (secuencial.length !== 9) {
+    throw new SriValidationError(`secuencial must be 9 digits, got ${secuencial.length}`)
+  }
+  if (codigoNumerico.length !== 8) {
+    throw new SriValidationError(`codigoNumerico must be 8 digits, got ${codigoNumerico.length}`)
+  }
+
+  const base =
+    dateDigits +
+    codDoc +
+    ruc +
+    ambiente +
+    estab +
+    ptoEmi +
+    secuencial +
+    codigoNumerico +
+    tipoEmision
+
+  if (base.length !== 48) {
+    throw new SriValidationError(`Clave base must be 48 digits, got ${base.length}`)
+  }
+
+  const checkDigit = computeModulo11(base)
+  return base + checkDigit.toString()
+}

package/src/errors.ts

@@ -0,0 +1,32 @@
+import type { SriMensaje } from '@timbra-ec/types'
+
+export class SriError extends Error {
+  constructor(
+    message: string,
+    public readonly code?: string,
+    public readonly mensajes?: SriMensaje[],
+  ) {
+    super(message)
+    this.name = 'SriError'
+  }
+}
+
+export class SriValidationError extends SriError {
+  override name = 'SriValidationError'
+}
+
+export class SriCertificateError extends SriError {
+  override name = 'SriCertificateError'
+}
+
+export class SriSigningError extends SriError {
+  override name = 'SriSigningError'
+}
+
+export class SriSoapError extends SriError {
+  override name = 'SriSoapError'
+}
+
+export class SriTimeoutError extends SriError {
+  override name = 'SriTimeoutError'
+}

package/src/index.ts

@@ -0,0 +1,49 @@
+// @timbra-ec/sri — SRI SOAP integration
+// XML generation, XAdES-BES signing, SOAP client, clave de acceso
+
+export { SRI_URLS } from '@timbra-ec/types'
+
+export { generateClaveAcceso } from './clave-acceso'
+export type { ClaveAccesoInput } from './clave-acceso'
+
+export {
+  buildFacturaXml,
+  buildNotaCreditoXml,
+  buildNotaDebitoXml,
+  buildGuiaRemisionXml,
+  buildRetencionXml,
+  buildAtsXml,
+} from './xml/builder'
+
+export type {
+  InfoTributariaInput,
+  NotaCreditoInput,
+  NotaDebitoInput,
+  MotivoDebito,
+  GuiaRemisionInput,
+  Destinatario,
+  RetencionInput,
+  RetencionDetalle,
+  AtsInput,
+  AtsCompra,
+  AtsVenta,
+} from './xml/types'
+
+export { parseCertificate, validateCertificate } from './signing/certificate'
+export type { ParsedCertificate, CertificateMetadata } from './signing/certificate'
+
+export { signXml } from './signing/xades-bes'
+
+export { submitComprobante } from './soap/recepcion'
+
+export { queryAutorizacion } from './soap/autorizacion'
+export type { PollOptions } from './soap/autorizacion'
+
+export {
+  SriError,
+  SriValidationError,
+  SriCertificateError,
+  SriSigningError,
+  SriSoapError,
+  SriTimeoutError,
+} from './errors'

package/src/signing/certificate.ts

@@ -0,0 +1,103 @@
+import forge from 'node-forge'
+import { SriCertificateError } from '../errors'
+
+export interface CertificateMetadata {
+  commonName: string
+  issuer: string
+  serialNumber: string
+  validFrom: Date
+  validTo: Date
+  /** RUC extracted from subject fields, if present */
+  ruc: string | null
+}
+
+export interface ParsedCertificate {
+  privateKey: forge.pki.rsa.PrivateKey
+  certificate: forge.pki.Certificate
+  chain: forge.pki.Certificate[]
+  metadata: CertificateMetadata
+}
+
+/** Try to extract a 13-digit RUC from certificate subject fields */
+function extractRuc(cert: forge.pki.Certificate): string | null {
+  const fields = cert.subject.attributes
+  for (const field of fields) {
+    const value = String(field.value ?? '')
+    const match = value.match(/\d{13}/)
+    if (match) return match[0]
+  }
+  return null
+}
+
+function formatDN(attrs: forge.pki.CertificateField[]): string {
+  return attrs.map((a) => `${a.shortName ?? a.name}=${a.value}`).join(', ')
+}
+
+/**
+ * Parse a PKCS#12 (.p12) certificate file.
+ * Extracts private key, certificate, chain, and metadata.
+ */
+export function parseCertificate(p12Buffer: Buffer, password: string): ParsedCertificate {
+  let p12Asn1: forge.asn1.Asn1
+  try {
+    const p12Der = forge.util.decode64(p12Buffer.toString('base64'))
+    p12Asn1 = forge.asn1.fromDer(p12Der)
+  } catch {
+    throw new SriCertificateError('Invalid PKCS#12 file format')
+  }
+
+  let p12: forge.pkcs12.Pkcs12Pfx
+  try {
+    p12 = forge.pkcs12.pkcs12FromAsn1(p12Asn1, password)
+  } catch {
+    throw new SriCertificateError('Wrong certificate password or corrupted PKCS#12 file')
+  }
+
+  // Extract private key
+  const keyBags = p12.getBags({ bagType: forge.pki.oids.pkcs8ShroudedKeyBag })
+  const keyBag = keyBags[forge.pki.oids.pkcs8ShroudedKeyBag]
+  if (!keyBag || keyBag.length === 0 || !keyBag[0]?.key) {
+    throw new SriCertificateError('No private key found in PKCS#12 file')
+  }
+  const privateKey = keyBag[0].key as forge.pki.rsa.PrivateKey
+
+  // Extract certificates
+  const certBags = p12.getBags({ bagType: forge.pki.oids.certBag })
+  const certs = certBags[forge.pki.oids.certBag]
+  if (!certs || certs.length === 0 || !certs[0]?.cert) {
+    throw new SriCertificateError('No certificate found in PKCS#12 file')
+  }
+
+  const certificate = certs[0].cert
+  const chain = certs
+    .slice(1)
+    .filter((b) => b.cert != null)
+    .map((b) => b.cert!)
+
+  const metadata: CertificateMetadata = {
+    commonName: (certificate.subject.getField('CN')?.value as string) ?? '',
+    issuer: formatDN(certificate.issuer.attributes),
+    serialNumber: certificate.serialNumber,
+    validFrom: certificate.validity.notBefore,
+    validTo: certificate.validity.notAfter,
+    ruc: extractRuc(certificate),
+  }
+
+  return { privateKey, certificate, chain, metadata }
+}
+
+/**
+ * Validate that a parsed certificate is not expired.
+ * Throws SriCertificateError if the certificate has expired.
+ */
+export function validateCertificate(cert: ParsedCertificate): void {
+  const now = new Date()
+  if (now > cert.metadata.validTo) {
+    throw new SriCertificateError(`Certificate expired on ${cert.metadata.validTo.toISOString()}`)
+  }
+  if (now < cert.metadata.validFrom) {
+    throw new SriCertificateError(
+      `Certificate not yet valid, starts ${cert.metadata.validFrom.toISOString()}`,
+    )
+  }
+}