@devly-cl/sii-client 0.4.4 → 0.5.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.
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # SII Client
2
2
 
3
- `@devly-cl/sii-client` es una biblioteca TypeScript independiente de framework. Inicia sesión personal en SII, comprueba autorización sobre una empresa y consulta resúmenes del Registro de Compras y Ventas y facturas emitidas y recibidas 33/34 mediante HTTP/JSON. Credenciales por parámetros; sin variables de entorno para login.
3
+ `@devly-cl/sii-client` es una biblioteca TypeScript independiente de framework. Inicia sesión personal en SII, comprueba autorización sobre una empresa y consulta resúmenes del Registro de Compras y Ventas y facturas emitidas y recibidas 33/34 mediante HTTP/JSON. La ampliación de este repositorio incorpora preparación, firma y envío de facturas 33 y notas de crédito 61 de anulación total mediante el facturador gratuito. Credenciales por parámetros; sin variables de entorno para login o firma.
4
4
 
5
- Basado en los servicios internos observados del portal. No es una API pública oficial ni una integración certificada. Esta versión ofrece operaciones de lectura; la emisión de facturas y notas de crédito todavía no forma parte del SDK. La prueba real del prototipo se realizó el 30-09-2026; el análisis, contrato observado y evidencia HTTP están en `docs/sii/` del repositorio, fuera del paquete npm.
5
+ Basado en los servicios internos observados del portal. No es una API pública oficial ni una integración certificada. La versión 0.5.0 incorpora emisión y nombres canónicos en inglés; la publicación se verifica por separado de las pruebas fiscales reales. La prueba real del prototipo de lectura se realizó el 30-09-2026; el análisis, contrato observado y evidencia HTTP están en `docs/sii/` del repositorio, fuera del paquete npm.
6
6
 
7
7
  ## Desarrollo
8
8
 
@@ -27,25 +27,25 @@ npm install @devly-cl/sii-client
27
27
  Para probar cambios locales, crear el tarball con `npm pack` e instalarlo con `npm install <ruta-al-tarball>`. La licencia se mantiene como `UNLICENSED`.
28
28
 
29
29
  ```ts
30
- import { SiiClient, type ConsultaFacturasEmitidas, type CredencialesSii } from '@devly-cl/sii-client';
30
+ import { SiiClient, type IssuedInvoicesQuery, type SiiCredentials } from '@devly-cl/sii-client';
31
31
 
32
- async function consultarFacturasEmitidas(
33
- empresaRutAutorizada: string,
34
- credenciales: CredencialesSii,
35
- consulta: ConsultaFacturasEmitidas,
32
+ async function getAuthorizedIssuedInvoices(
33
+ authorizedCompanyRut: string,
34
+ credentials: SiiCredentials,
35
+ query: IssuedInvoicesQuery,
36
36
  ) {
37
37
  // El caso de uso ya autorizó actor, tenant, empresa, recurso y sucursal.
38
- const sii = new SiiClient({ empresaRut: empresaRutAutorizada });
38
+ const sii = new SiiClient({ empresaRut: authorizedCompanyRut });
39
39
  try {
40
- await sii.login(credenciales);
41
- return await sii.getFacturasEmitidas(consulta);
40
+ await sii.login(credentials);
41
+ return await sii.getIssuedInvoices(query);
42
42
  } finally {
43
43
  await sii.dispose();
44
44
  }
45
45
  }
46
46
  ```
47
47
 
48
- `credenciales` recibe `{ rut, clave }`; `consulta` de facturas recibe `{ periodo: 'YYYYMM', tokenRecaptcha? }`. Los resúmenes conservan `{ periodo: 'YYYYMM', operacion: 'COMPRA' | 'VENTA', estado? }`. El repositorio incluye el ejemplo compilable `examples/consulta-rcv.ts`. CommonJS también admite `const { SiiClient } = require('@devly-cl/sii-client')`; las declaraciones TypeScript se generan desde el mismo código.
48
+ `credentials` recibe `{ rut, clave }`; `query` de facturas recibe `{ periodo: 'YYYYMM', tokenRecaptcha? }`. Los resúmenes conservan `{ periodo: 'YYYYMM', operacion: 'COMPRA' | 'VENTA', estado? }`. El repositorio incluye el ejemplo compilable `examples/consulta-rcv.ts`. CommonJS también admite `const { SiiClient } = require('@devly-cl/sii-client')`; las declaraciones TypeScript se generan desde el mismo código.
49
49
 
50
50
  No registrar un cliente autenticado como singleton NestJS. Puede inyectarse un servicio sin estado que cree y descarte una instancia por operación autorizada. La empresa debe salir de un recurso autorizado del backend, no de un RUT libre enviado por el usuario.
51
51
 
@@ -54,14 +54,44 @@ No registrar un cliente autenticado como singleton NestJS. Puede inyectarse un s
54
54
  | Método | Resultado |
55
55
  | --- | --- |
56
56
  | `login({ rut, clave })` | Confirma identidad personal y autorización sobre la empresa fijada. Sin representación electrónica. |
57
- | `getEmpresasAutorizadas()` | Devuelve autorizaciones del usuario en SII; el backend controla quién puede consultarlas. |
58
- | `getResumen({ periodo, operacion, estado })` | Devuelve JSON del SII sin reinterpretar montos; elimina `metaData.conversationId` y normaliza el resumen vacío observado (`codRespuesta: 3`, `data: null`, sin errores) a `data: []`. |
59
- | `getFacturasEmitidas({ periodo, tokenRecaptcha? })` | Facturas 33/34 normalizadas y cobertura explícita del período RCV. Sin metadatos crudos ni secretos. |
60
- | `getFacturasRecibidas({ periodo, tokenRecaptcha? })` | Facturas 33/34 del registro de compras, con proveedor como emisor, empresa como receptor y cobertura explícita. |
61
- | `getXmlFacturaEmitida({ documentType, folio })` | Bytes originales y detalle normalizado de un DTE emitido en el facturador gratuito del SII. |
62
- | `getXmlFacturaRecibida({ issuerRut, documentType, folio })` | Original del DTE recibido; valida proveedor y receptor contra la empresa autorizada. |
57
+ | `getAuthorizedCompanies()` | Devuelve autorizaciones del usuario en SII; el backend controla quién puede consultarlas. |
58
+ | `getSummary({ periodo, operacion, estado })` | Devuelve JSON del SII sin reinterpretar montos; elimina `metaData.conversationId` y normaliza el resumen vacío observado (`codRespuesta: 3`, `data: null`, sin errores) a `data: []`. |
59
+ | `getIssuedInvoices({ periodo, tokenRecaptcha? })` | Facturas 33/34 normalizadas y cobertura explícita del período RCV. Sin metadatos crudos ni secretos. |
60
+ | `getReceivedInvoices({ periodo, tokenRecaptcha? })` | Facturas 33/34 del registro de compras, con proveedor como emisor, empresa como receptor y cobertura explícita. |
61
+ | `getIssuedInvoiceXml({ documentType, folio })` | Bytes originales y detalle normalizado de un DTE emitido en el facturador gratuito del SII. |
62
+ | `getReceivedInvoiceXml({ issuerRut, documentType, folio })` | Original del DTE recibido; valida proveedor y receptor contra la empresa autorizada. |
63
+ | `getIssuedDocumentXml({ documentType, folio })` | Respaldo y detalle de documentos emitidos 33/34/61; conserva los métodos de XML de facturas existentes. |
64
+ | `prepareInvoice(input)` | Contenido fiscal revisable, huella SHA256, identificador opaco y vencimiento; todavía no firma ni envía. |
65
+ | `prepareCancellationCreditNote({ factura, issuedDate })` | Prepara una NC 61 contra una factura 33 resuelta en el historial; mismos receptor y montos, referencia única `CodRef=1`. |
66
+ | `signAndSend({ preparacionId, approvedHash, claveFirma, beforeSend })` | Firma el contenido aprobado, exige guardar XML e identidad antes del envío y devuelve `status: 'ENVIADO'` cuando observa confirmación del portal. |
63
67
  | `dispose()` | Cierra la sesión remota propia con `autTermino.cgi`, descarta cookies y bloquea reutilización. Esperar siempre en `finally`. |
64
68
 
69
+ ## Nombres canónicos y migración
70
+
71
+ Los métodos, funciones y tipos públicos nuevos usan inglés. Los nombres anteriores siguen disponibles como aliases de compatibilidad marcados `@deprecated`; reemplazarlos no cambia el protocolo, la identidad del documento ni las reglas de autorización o envío.
72
+
73
+ | Nombre anterior | Nombre canónico |
74
+ | --- | --- |
75
+ | `getEmpresasAutorizadas` | `getAuthorizedCompanies` |
76
+ | `getResumen` | `getSummary` |
77
+ | `getFacturasEmitidas` | `getIssuedInvoices` |
78
+ | `getFacturasRecibidas` | `getReceivedInvoices` |
79
+ | `getXmlFacturaEmitida` | `getIssuedInvoiceXml` |
80
+ | `getXmlFacturaRecibida` | `getReceivedInvoiceXml` |
81
+ | `getXmlDocumentoEmitido` | `getIssuedDocumentXml` |
82
+ | `prepararFactura` | `prepareInvoice` |
83
+ | `prepararNotaCreditoAnulacion` | `prepareCancellationCreditNote` |
84
+ | `firmarYEnviar` | `signAndSend` |
85
+ | `validarFactura` | `validateInvoice` |
86
+ | `calcularTotalesFactura` | `calculateInvoiceTotals` |
87
+ | `hashContenido` | `hashContent` |
88
+
89
+ Los tipos siguen la misma migración: `CredencialesSii` → `SiiCredentials`, `ConsultaResumen` → `SummaryQuery`, `ConsultaFacturasEmitidas` → `IssuedInvoicesQuery`, `EntradaFactura` → `InvoiceInput`, `DocumentoPreparado` → `PreparedDocument`, `DocumentoFirmado` → `SignedDocument`, `DocumentoEnviado` → `SentDocument` y `FirmaDocumento` → `SignDocumentInput`. Los aliases anteriores mantienen la misma estructura.
90
+
91
+ Esta migración normaliza nombres del SDK. Las propiedades existentes del contrato permanecen iguales: `empresaRut`, `clave`, `periodo`, `operacion`, `estado`, `preparacionId`, `claveFirma` y `factura`; también permanecen los valores `COMPRA`, `VENTA` y `ENVIADO`. No traducir campos HTTP/JSON del SII, parámetros CGI, valores fiscales ni XML. `SiiClient`, `login`, `dispose`, `parseRut`, `parseDteXml` y `parseDteDocumentXml` conservan sus nombres.
92
+
93
+ `examples/facturacion.ts` usa `IssuanceRecord` con métodos en inglés para mostrar persistencia, aprobación y recuperación del consumidor. La [guía de migración](docs/sii/QA-API-ENGLISH.md) detalla verificaciones locales; no ejecuta login, firma ni envío reales.
94
+
65
95
  Una instancia permite un único login. Cada instancia tiene su propio CookieJar. La clase no guarda la clave como propiedad ni escribe cookies en disco. JavaScript no garantiza borrado físico inmediato de strings en memoria.
66
96
 
67
97
  Desde 0.4.2, `dispose()` bloquea nuevas solicitudes, espera las que estén en curso y llama al cierre oficial del SII con las cookies de esa instancia antes de borrarlas. También limpia logins parcialmente autenticados que luego fallen; repetir o invocar simultáneamente `dispose()` produce un único cierre. No utiliza cookies del navegador ni cierra sesiones de otros clientes/tenants. Sin sesión creada, no solicita logout.
@@ -72,7 +102,7 @@ Estados de compra: `REGISTRO`, `PENDIENTE`, `NO_INCLUIR`, `RECLAMADO`. Venta adm
72
102
 
73
103
  ## Facturas emitidas
74
104
 
75
- `ResultadoFacturasEmitidas` contiene `data: FacturaEmitida[]`, `complete`, `expectedCount`, `observedAt` ISO e `incompleteDocumentTypes: (33 | 34)[]`. `expectedCount` suma sólo los tipos 33/34 presentes en el resumen de ventas del período. Consulta `getDatosInicio` para obtener `limiteDtes` y pide `getDetalleVenta` sólo para tipos presentes con cantidad positiva; cero comprobado no necesita pedir un detalle inexistente.
105
+ `IssuedInvoicesResult` contiene `data: IssuedInvoice[]`, `complete`, `expectedCount`, `observedAt` ISO e `incompleteDocumentTypes: (33 | 34)[]`. `expectedCount` suma sólo los tipos 33/34 presentes en el resumen de ventas del período. Consulta `getDatosInicio` para obtener `limiteDtes` y pide `getDetalleVenta` sólo para tipos presentes con cantidad positiva; cero comprobado no necesita pedir un detalle inexistente.
76
106
 
77
107
  Cada factura contiene `issuerRut`, `documentType`, `folio`, `issuedDate`, `receiverRut`, `receiverName`, `netAmount`, `exemptAmount`, `vatAmount`, `totalAmount`, `siiBranchCode` y `rcvPeriod`. Emisor fijado por instancia; `detRutDoc` es el receptor. RUT con DV validado y normalizado; folio numérico seguro convertido a string; fecha de calendario `YYYY-MM-DD`, aceptando `dd/mm/yyyy` o `YYYY-MM-DD` del proveedor, sin conversión de zona horaria. `rcvPeriod` es el período consultado y puede diferir del mes de emisión.
78
108
 
@@ -86,7 +116,7 @@ Por defecto envía el literal `t-o-k-e-n-web` usado por el servicio del portal o
86
116
 
87
117
  ## Facturas recibidas
88
118
 
89
- `getFacturasRecibidas({ periodo: '202609' })` devuelve `ResultadoFacturasRecibidas` con los mismos campos de cobertura que emitidas. Usa `COMPRA`, estado `REGISTRO` y `getDetalleCompra`, sólo para tipos 33/34 presentes en el resumen. No acepta, reclama ni modifica documentos. Cada `FacturaRecibida` conserva `issuerRut` e `issuerName` del proveedor, y `receiverRut` de la empresa fijada; `receiverName` es `null` si el RCV no lo informa. Folios iguales de distintos proveedores son documentos distintos.
119
+ `getReceivedInvoices({ periodo: '202609' })` devuelve `ReceivedInvoicesResult` con los mismos campos de cobertura que emitidas. Usa `COMPRA`, estado `REGISTRO` y `getDetalleCompra`, sólo para tipos 33/34 presentes en el resumen. No acepta, reclama ni modifica documentos. Cada `ReceivedInvoice` conserva `issuerRut` e `issuerName` del proveedor, y `receiverRut` de la empresa fijada; `receiverName` es `null` si el RCV no lo informa. Folios iguales de distintos proveedores son documentos distintos.
90
120
 
91
121
  En compras, `detTipoDoc` puede ser `null`: se usa el tipo de la consulta que devolvió esa fila y se rechaza un tipo explícito contradictorio. `vatAmount` conserva el IVA recuperable informado por RCV, que puede diferir del IVA total del XML. No se recalcula ni se reemplaza por el impuesto del DTE. Sólo se consulta registro; pendientes, reclamados, excluidos y notas de crédito/débito quedan fuera de este listado.
92
122
 
@@ -94,18 +124,42 @@ Verificación real del SDK 0.4.0, 01-10-2026: septiembre devolvió tres facturas
94
124
 
95
125
  ## XML de facturas emitidas y recibidas
96
126
 
97
- Después de `login`, llamar `getXmlFacturaEmitida({ documentType: 33, folio: '20' })`. Devuelve `{ xml: Uint8Array, encoding, detail }`; no convierte el original a UTF-8 ni reescribe firmas. `parseDteXml(bytes, { issuerRut, documentType, folio })` permite interpretar un documento ya obtenido, validando su identidad.
127
+ Después de `login`, llamar `getIssuedInvoiceXml({ documentType: 33, folio: folioAutorizado })`. Devuelve `{ xml: Uint8Array, encoding, detail }`; no convierte el original a UTF-8 ni reescribe firmas. `parseDteXml(bytes, { issuerRut, documentType, folio })` permite interpretar un documento ya obtenido, validando su identidad.
98
128
 
99
- Para recibidas, llamar `getXmlFacturaRecibida({ issuerRut: proveedorRut, documentType: 33, folio })`. La empresa de la instancia sigue siendo la empresa receptora autorizada. La descarga utiliza `ORIGEN=RCP` y `RUT_EMI` del proveedor, y valida ambos participantes en el XML. `parseDteXml` también acepta `receiverRut` como validación adicional. El respaldo de recibidos está descrito en la [guía del SII](https://www.sii.cl/portales/mipyme/administracion/Guia_Respaldo_DTEs_recibidos.html); su disponibilidad depende del documento y del servicio del facturador gratuito.
129
+ Para recibidas, llamar `getReceivedInvoiceXml({ issuerRut: proveedorRut, documentType: 33, folio })`. La empresa de la instancia sigue siendo la empresa receptora autorizada. La descarga utiliza `ORIGEN=RCP` y `RUT_EMI` del proveedor, y valida ambos participantes en el XML. `parseDteXml` también acepta `receiverRut` como validación adicional. El respaldo de recibidos está descrito en la [guía del SII](https://www.sii.cl/portales/mipyme/administracion/Guia_Respaldo_DTEs_recibidos.html); su disponibilidad depende del documento y del servicio del facturador gratuito.
100
130
 
101
131
  `detail` incluye emisor, tipo, folio, fecha civil, receptor, neto/exento/IVA/tasa/total, líneas, impuestos adicionales, descuentos/recargos globales y referencias. Cada línea contiene nombre, descripción, códigos, cantidad, unidad, precio unitario, descuentos/recargos, indicador de exención y monto. Cantidad, precio, porcentajes y valores globales permanecen como strings decimales; los montos CLP son enteros seguros. No recalcula impuestos ni verifica criptográficamente firmas: conserva la evidencia original para ese procesamiento posterior.
102
132
 
103
133
  Admite `DTE`, `SetDTE` y `EnvioDTE`, con exactamente un documento 33/34, namespaces SII y codificación UTF-8 o ISO-8859-1. Límite 1 MiB, 10.000 nodos y 32 niveles. Rechaza DTD, entidades externas, documentos múltiples, identidad distinta, valores inválidos y XML mal formado. No consulta URLs incluidas en el documento.
104
134
 
135
+ `getIssuedInvoiceXml`, `getReceivedInvoiceXml` y `parseDteXml` conservan el detalle histórico de facturas 33/34, sin exigir cabecera ampliada ni agregar metadatos de emisión. `getIssuedDocumentXml` y `parseDteDocumentXml` admiten 33/34/61 y agregan `hasSignature`, `hasTransport` y `fiscalHeader`; éste incluye `noDebitReduction` y `unapprovedFiscalFields`. Las lecturas genéricas preservan esos indicadores y nombres de campos para revisión; no aplican por sí solas las restricciones de escritura del comando de emisión. `hasSignature` es presencia estructural, no verificación criptográfica; un bloque `Transporte` vacío no cuenta como contenido de transporte.
136
+
105
137
  La descarga usa HTTP del facturador gratuito; no scrapea filas ni usa un navegador. Desde 0.4.4, si SII presenta el formulario de selección de empresas, envía un único POST a `mipeSelEmpresa.cgi` con `RUT_EMP` igual a `empresaRut` y el destino observado `DESDE_DONDE_URL=OPCION=2&TIPO=4`. No toma la primera empresa ni ejecuta JavaScript; valida el formulario HTML con un parser inerte, acotado a 1 MiB, y rechaza destinos distintos, empresas ausentes/deshabilitadas y selecciones ambiguas. El POST no se reintenta. Comprueba las cookies de empresa antes de descargar y los participantes dentro del XML. CAPTCHA o una selección no confirmada siguen produciendo un error explícito. El RCV también contiene facturas emitidas por otros sistemas; no garantiza que sus XML estén disponibles en este servicio. Prueba real del SDK 0.3.0: 01-10-2026, login personal nuevo y descarga de 5.938 bytes ISO-8859-1, raíz `SetDTE`, una línea con cantidad/precio. La evidencia está en `docs/QA.md` del repositorio.
106
138
 
107
139
  El consumidor debe cotejar además receptor, fecha y total con su referencia autorizada antes de guardar; almacenar el original, hash y fecha de obtención; y reutilizar lo guardado ante reintentos. No iniciar descargas desde SSR ni desde usuarios con permiso sólo de lectura.
108
140
 
141
+ ## Emisión y anulación total
142
+
143
+ Esta ampliación usa HTTP contra el facturador gratuito, con certificado digital centralizado del usuario. No utiliza navegador, CAF propios ni un certificado local. `credenciales: { rut, clave }` y `claveFirma` llegan por argumentos y permanecen en memoria; no escribirlas en configuración, historial de comandos, variables de entorno, registros de operación ni logs.
144
+
145
+ `InvoiceInput` exige `issuedDate` como fecha civil `YYYY-MM-DD`, `issuer: { address, commune, city, activityCode }`, `receiver: { rut, legalName, address, commune, city, businessActivity, contact? }`, `paymentForm: 1 | 2`, `saleType: 1 | 2`, `purchaseType: 1 | 2 | 3 | 4 | 5 | 6 | 7` e `items: { name, description?, quantity, unitNetPriceClp, unit? }[]`. Direcciones, actividad y datos del receptor deben coincidir con las opciones autorizadas devueltas por el portal; la empresa continúa fijada por instancia. Contacto no confirma entrega de correo.
146
+
147
+ Alcance: factura afecta 33, IVA 19%, una a diez líneas, sin descuentos, exenciones, otros impuestos ni transporte. Cantidad y precio son strings decimales positivos con punto, hasta dos decimales, diez dígitos enteros y doce caracteres. Se redondea cada línea a CLP y luego el IVA con aritmética entera exacta; cada línea debe resultar en al menos $1 CLP y el total no puede exceder $9.999.999.999. Campos desconocidos y opciones fuera del alcance se rechazan. Fechas reales desde 2017; el SII determina si acepta la fecha solicitada.
148
+
149
+ Antes del envío, el XML de factura debe conservar exactamente las opciones aprobadas: se rechazan códigos adicionales de ítems (`CdgItem`) y contenido o atributos efectivos de transporte, aunque un contenedor `Transporte` vacío puede estar presente. Tanto factura como NC rechazan `IndNoRebaja` presente, incluso con valor cero, y cualquier campo de `IdDoc` fuera de `TipoDTE`, `Folio`, `FchEmis`, `FmaPago`, `TpoTranVenta` y `TpoTranCompra`. Esos controles se aplican al XML generado y firmado; la lectura genérica mantiene los indicadores para inspección sin tratarlos como opciones aprobadas.
150
+
151
+ Límites de texto: nombre de línea 25, descripción 999, unidad 4, razón social del receptor 100, dirección 70, comuna 20, ciudad 15, giro del receptor 40 y contacto 80 caracteres. La descripción se acota conservadoramente en el SDK. Código de actividad: seis dígitos. Se recortan espacios externos y se rechazan caracteres de control y texto que no pueda serializarse en la codificación del portal. El comando validado se copia y congela; no conserva referencias mutables del llamador ni admite líneas dispersas o campos fiscales desconocidos.
152
+
153
+ `PreparedDocument` incluye `preparacionId`, `contentHash`, `expiresAt`, identidad de los participantes, tipo, fecha y montos; también el comando normalizado o la factura original y su referencia. Para facturas incluye razón social, giro y `issuerBranchCode` de la dirección emisora seleccionada. Ese código SII se contrasta con el XML y no es un identificador de sucursal interna del backend. Los formularios y tokens quedan dentro de la instancia. Preparaciones vencen a los cinco minutos, pertenecen a esa instancia y se consumen al iniciar la firma. La aprobación debe conservar la huella del contenido efectivamente revisado, no copiar automáticamente la huella para simular aprobación. El SDK rechaza una huella distinta y escrituras simultáneas.
154
+
155
+ El consumidor crea una operación persistente con clave única y aplica autorización antes de preparar. Guarda preparación y aprobación; `beforeSend` es obligatorio y debe confirmar almacenamiento duradero del XML firmado, tipo, folio candidato, participantes, montos y huella, junto con un estado de envío pendiente. Si falla ese respaldo, el SDK no inicia el envío. Después guarda el resultado y audita/notifica desde el backend. El ejemplo compilable `examples/facturacion.ts` muestra estos puntos de integración sin una persistencia simulada.
156
+
157
+ `signAndSend` no reintenta pasos fiscales y cierra su sesión después del intento; mantener igualmente `await dispose()` en `finally`. `ENVIADO` acredita la confirmación de envío observada, no aceptación fiscal ni entrega del documento al receptor. La presencia de una firma en el XML se comprueba estructuralmente; no se verifica criptográficamente su cadena de confianza.
158
+
159
+ Si aparece `SII_ISSUANCE_OUTCOME_UNKNOWN`, el envío comenzó y su resultado no se confirmó. El error saneado no lleva el XML ni el folio: recuperarlos del registro duradero creado en `beforeSend`. También hay que reconciliar si el proceso termina después de ese respaldo o falla al guardar el resultado final. Bloquear cualquier nueva emisión para la misma operación y consultar `getIssuedDocumentXml` en una instancia nueva; cotejar identidad y contenido fiscal contra el candidato guardado. XML ausente, respuesta vacía o falla temporal no demuestran que el envío fracasó ni autorizan repetirlo.
160
+
161
+ La NC del alcance es una anulación total de una factura 33, preparada con `{ factura: { documentType: 33, folio }, issuedDate }`. Usar el folio confirmado de la factura que se desea anular, una operación independiente y una aprobación nueva. La preparación conserva receptor, montos y referencia única al documento original con `CodRef=1`; no admite correcciones parciales ni de texto. El XML 61 puede omitir forma de pago y tipos de transacción de `IdDoc`; si están presentes, deben coincidir con la factura original. Cantidades y precios se comparan como decimales equivalentes, manteniendo el XML original intacto. Conservar ambos XML y su relación. Preparar o enviar una NC no demuestra por sí solo su aceptación fiscal ni la anulación aceptada por el SII.
162
+
109
163
  ## Errores y recuperación
110
164
 
111
165
  Errores de parámetros generan `TypeError`. Proveedor/protocolo/sesión generan `SiiError` con `code` y, cuando corresponde, `httpStatus`. Mensajes no incluyen cuerpos HTTP ni secretos.
@@ -118,7 +172,7 @@ La descarga distingue rechazo por demasiados documentos (`DOCUMENT_LIMIT_EXCEEDE
118
172
  import { SiiError } from '@devly-cl/sii-client';
119
173
 
120
174
  try {
121
- await sii.getXmlFacturaRecibida(consulta);
175
+ await sii.getReceivedInvoiceXml(consulta);
122
176
  } catch (error) {
123
177
  if (error instanceof SiiError) {
124
178
  // Campos saneados; jamás registrar credenciales ni el cuerpo del proveedor.
@@ -143,10 +197,16 @@ try {
143
197
  - `SII_XML_UNAVAILABLE`: el servicio no entregó un XML para esa factura.
144
198
  - `SII_XML_COMPANY_SELECTION_REQUIRED`: selección del facturador no confirmada. `diagnostics.reason` distingue empresa ausente/no autorizada (`COMPANY_NOT_AUTHORIZED`), formulario inválido (`INVALID_RESPONSE`) o falta de confirmación/cookies incorrectas (`COMPANY_SELECTION_REQUIRED`).
145
199
  - `SII_XML_INVALID` / `SII_XML_IDENTITY_MISMATCH`: XML inseguro/incorrecto o identidad distinta; no guardar.
200
+ - `SII_OPERATION_IN_PROGRESS` / `SII_PREPARATION_UNAVAILABLE`: otra escritura en curso o preparación ausente, consumida o vencida; no reutilizar ni duplicar una operación ya enviada.
201
+ - `SII_APPROVAL_MISMATCH` / `SII_DOCUMENT_CONTENT_MISMATCH`: huella no aprobada o contenido fiscal distinto del esperado; detener el envío y revisar.
202
+ - `SII_DOCUMENT_VALIDATION_REJECTED`: el portal rechazó la vista previa, incluso con HTTP 200 y una redirección por script; no continuar a firma. El diagnóstico conserva etapa y motivo sin revelar el texto privado del proveedor.
203
+ - `SII_CERTIFICATE_UNAVAILABLE` / `SII_SIGNATURE_INVALID`: certificado no resoluble o firma inválida; el diagnóstico distingue motivos observados como clave incorrecta, expiración o revocación.
204
+ - `SII_DOCUMENT_RECOVERY_FAILED`: no fue posible resolver inequívocamente el documento original para la anulación; no sustituirlo por otro folio.
205
+ - `SII_ISSUANCE_OUTCOME_UNKNOWN`: envío iniciado sin confirmación; reconciliar con el candidato respaldado antes de cualquier decisión posterior.
146
206
 
147
207
  Timeout por solicitud: 15 segundos por defecto, rango 1 a 30 segundos. Login nunca se reintenta automáticamente. Lecturas conocidas admiten 0 a 2 reintentos por transporte o HTTP 429/502/503/504; por defecto, uno. TLS conserva validación normal. Sólo la selección del facturador sigue redirecciones HTTPS entre sus dos rutas conocidas en `www1.sii.cl`, hasta cinco solicitudes; otras redirecciones se rechazan.
148
208
 
149
- El contrato observado exige `conversationId` igual a la cookie secreta `TOKEN` y `Accept: application/json, text/plain, */*`. Ambos tienen checks de regresión. No se implementa resolución de CAPTCHA ni operaciones tributarias de escritura.
209
+ El contrato observado del RCV exige `conversationId` igual a la cookie secreta `TOKEN` y `Accept: application/json, text/plain, */*`. Ambos tienen checks de regresión. No se implementa resolución de CAPTCHA. Login, selección de empresa, preparación, firma y envío no se reintentan automáticamente.
150
210
 
151
211
  ## Límites y responsabilidades del consumidor
152
212
 
@@ -154,6 +214,6 @@ El SDK valida RUT, sesión personal y autorización SII por empresa. Cada backen
154
214
 
155
215
  Auditar actor interno, tenant, empresa autorizada, operación, periodo, resultado y correlación del backend. Nunca registrar clave, cookies, TOKEN, conversationId, tokens CAPTCHA, cuerpo del login ni respuesta financiera completa. Para importar facturas emitidas, usar clave única por emisor/tipo/folio; período y receptor no son parte de la identidad. El consumidor mantiene consultas indexadas, listados paginados e idempotencia para tolerar reintentos.
156
216
 
157
- Otros documentos, documentos observados, descargas diferidas, grandes volúmenes, CAPTCHA activo y expiración real siguen pendientes. El SDK actual tiene pruebas reales de login personal, resúmenes, listado 33 y XML del facturador gratuito. Los casos 34, documentos incompletos y errores se validan con proveedor simulado; los checks no certifican disponibilidad productiva del SII.
217
+ Otros documentos, documentos observados, descargas diferidas, grandes volúmenes, CAPTCHA activo y expiración real siguen pendientes. El SDK tiene pruebas históricas reales de lectura: login personal, resúmenes, listado 33 y XML del facturador gratuito. El 08-10-2026 se confirmó por HTTP el envío de una factura nueva 33 y de una NC 61 de anulación total, con recuperación de ambos XML y referencia/montos cotejados; los identificadores y respaldos permanecen privados. Preparaciones anteriores detenidas antes del POST de envío no se presentan como documentos enviados. Esto no acredita aceptación fiscal, anulación aceptada, entrega de correo ni validez criptográfica. Casos de borde, alteraciones, documentos incompletos y errores se validan con proveedor sintético; los checks no certifican disponibilidad general productiva del SII.
158
218
 
159
219
  `scripts/live-check.mjs` permite verificar SII real recibiendo una línea JSON por stdin con `empresaRut`, `rut`, `clave`, `periodo` y opcional `tokenRecaptcha`. Usar un programa que escriba stdin; nunca guardar credenciales o tokens en comandos, archivos, argumentos o variables de entorno. Su salida contiene sólo confirmación, cantidades por tipo documental y cobertura; no imprime facturas individuales. La ampliación del script no constituye una prueba real ejecutada.
@@ -1,10 +1,15 @@
1
- import type { TipoFacturaEmitida } from './issued-invoice';
1
+ import type { InvoiceDocumentType } from './issued-invoice';
2
2
  export declare const MAX_DTE_XML_BYTES = 1048576;
3
- export interface ConsultaXmlFacturaEmitida {
4
- documentType: TipoFacturaEmitida;
3
+ export type IssuedDocumentType = InvoiceDocumentType | 61;
4
+ export interface IssuedDocumentXmlQuery {
5
+ documentType: IssuedDocumentType;
5
6
  folio: string;
6
7
  }
7
- export interface ConsultaXmlFacturaRecibida extends ConsultaXmlFacturaEmitida {
8
+ export interface IssuedInvoiceXmlQuery {
9
+ documentType: InvoiceDocumentType;
10
+ folio: string;
11
+ }
12
+ export interface ReceivedInvoiceXmlQuery extends IssuedInvoiceXmlQuery {
8
13
  issuerRut: string;
9
14
  }
10
15
  export interface DteInvoiceLine {
@@ -27,7 +32,7 @@ export interface DteInvoiceLine {
27
32
  }
28
33
  export interface DteInvoiceDetail {
29
34
  issuerRut: string;
30
- documentType: TipoFacturaEmitida;
35
+ documentType: InvoiceDocumentType;
31
36
  folio: string;
32
37
  issuedDate: string;
33
38
  receiverRut: string;
@@ -59,18 +64,70 @@ export interface DteInvoiceDetail {
59
64
  reason: string | null;
60
65
  }[];
61
66
  }
62
- export interface ResultadoXmlFacturaEmitida {
67
+ export interface InvoiceXmlResult {
63
68
  /** Original bytes, including the original encoding and signatures. */
64
69
  xml: Uint8Array;
65
70
  encoding: 'UTF-8' | 'ISO-8859-1';
66
71
  detail: DteInvoiceDetail;
67
72
  }
73
+ export interface DteDocumentDetail extends Omit<DteInvoiceDetail, 'documentType'> {
74
+ documentType: IssuedDocumentType;
75
+ /** Presence of one XMLDSig child of DTE; does not verify cryptographic validity. */
76
+ hasSignature: boolean;
77
+ /** Transport data is present; an observed empty Transporte container does not count. */
78
+ hasTransport: boolean;
79
+ fiscalHeader?: {
80
+ issuer: {
81
+ legalName: string | null;
82
+ businessActivity: string | null;
83
+ activityCode: string | null;
84
+ branchCode: string | null;
85
+ address: string | null;
86
+ commune: string | null;
87
+ city: string | null;
88
+ };
89
+ receiver: {
90
+ legalName: string | null;
91
+ address: string | null;
92
+ commune: string | null;
93
+ city: string | null;
94
+ businessActivity: string | null;
95
+ contact: string | null;
96
+ };
97
+ paymentForm: number | null;
98
+ saleType: number | null;
99
+ purchaseType: number | null;
100
+ noDebitReduction: number | null;
101
+ /** IdDoc fields outside the supported invoice/annulment issuance command. Reads preserve them. */
102
+ unapprovedFiscalFields: string[];
103
+ };
104
+ }
105
+ export interface IssuedDocumentXmlResult extends Omit<InvoiceXmlResult, 'detail'> {
106
+ detail: DteDocumentDetail;
107
+ }
108
+ /** @deprecated Use IssuedDocumentType. */
109
+ export type TipoDocumentoEmitido = IssuedDocumentType;
110
+ /** @deprecated Use IssuedDocumentXmlQuery. */
111
+ export type ConsultaXmlDocumentoEmitido = IssuedDocumentXmlQuery;
112
+ /** @deprecated Use IssuedInvoiceXmlQuery. */
113
+ export type ConsultaXmlFacturaEmitida = IssuedInvoiceXmlQuery;
114
+ /** @deprecated Use ReceivedInvoiceXmlQuery. */
115
+ export type ConsultaXmlFacturaRecibida = ReceivedInvoiceXmlQuery;
116
+ /** @deprecated Use InvoiceXmlResult. */
117
+ export type ResultadoXmlFacturaEmitida = InvoiceXmlResult;
118
+ /** @deprecated Use IssuedDocumentXmlResult. */
119
+ export type ResultadoXmlDocumentoEmitido = IssuedDocumentXmlResult;
68
120
  export declare class DteXmlError extends Error {
69
121
  readonly code: 'SII_XML_INVALID' | 'SII_XML_IDENTITY_MISMATCH';
70
122
  constructor(code: 'SII_XML_INVALID' | 'SII_XML_IDENTITY_MISMATCH');
71
123
  }
72
124
  /** Bounded, namespace-aware parsing; no DTD, external entities or network I/O. */
73
- export declare function parseDteXml(xml: Uint8Array, expected: ConsultaXmlFacturaEmitida & {
125
+ export declare function parseDteXml(xml: Uint8Array, expected: IssuedInvoiceXmlQuery & {
126
+ issuerRut: string;
127
+ receiverRut?: string;
128
+ }): InvoiceXmlResult;
129
+ /** Issued invoices and credit notes; preserves original bytes and validates fiscal references. */
130
+ export declare function parseDteDocumentXml(xml: Uint8Array, expected: IssuedDocumentXmlQuery & {
74
131
  issuerRut: string;
75
132
  receiverRut?: string;
76
- }): ResultadoXmlFacturaEmitida;
133
+ }): IssuedDocumentXmlResult;
@@ -2,6 +2,7 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.DteXmlError = exports.MAX_DTE_XML_BYTES = void 0;
4
4
  exports.parseDteXml = parseDteXml;
5
+ exports.parseDteDocumentXml = parseDteDocumentXml;
5
6
  const saxes_1 = require("saxes");
6
7
  const rut_1 = require("./rut");
7
8
  exports.MAX_DTE_XML_BYTES = 1_048_576;
@@ -62,6 +63,20 @@ function uniqueLines(items) {
62
63
  }
63
64
  /** Bounded, namespace-aware parsing; no DTD, external entities or network I/O. */
64
65
  function parseDteXml(xml, expected) {
66
+ const parsed = parseDocumentXml(xml, expected, false);
67
+ const documentType = parsed.detail.documentType;
68
+ if (documentType !== 33 && documentType !== 34)
69
+ invalid();
70
+ const { fiscalHeader: _header, hasSignature: _signature, hasTransport: _transport, ...detail } = parsed.detail;
71
+ return { ...parsed, detail: { ...detail, documentType } };
72
+ }
73
+ /** Issued invoices and credit notes; preserves original bytes and validates fiscal references. */
74
+ function parseDteDocumentXml(xml, expected) {
75
+ if (!expected || ![33, 34, 61].includes(expected.documentType))
76
+ invalid();
77
+ return parseDocumentXml(xml, expected, true);
78
+ }
79
+ function parseDocumentXml(xml, expected, allowCreditNotes) {
65
80
  if (!(xml instanceof Uint8Array) || !xml.byteLength || xml.byteLength > exports.MAX_DTE_XML_BYTES)
66
81
  invalid();
67
82
  let root;
@@ -79,7 +94,7 @@ function parseDteXml(xml, expected) {
79
94
  parser.on('opentag', tag => {
80
95
  if (++nodes > 10000 || stack.length >= 32)
81
96
  invalid();
82
- const node = { name: tag.local, uri: tag.uri, text: '', children: [] };
97
+ const node = { name: tag.local, uri: tag.uri, text: '', attributeCount: Object.values(tag.attributes).filter(attribute => attribute.uri !== 'http://www.w3.org/2000/xmlns/').length, children: [] };
83
98
  if (stack.length)
84
99
  stack[stack.length - 1].children.push(node);
85
100
  else if (root)
@@ -107,17 +122,18 @@ function parseDteXml(xml, expected) {
107
122
  const headerNode = one(document, 'Encabezado');
108
123
  const identity = one(headerNode, 'IdDoc');
109
124
  const totals = one(headerNode, 'Totales');
125
+ const issuer = one(headerNode, 'Emisor'), receiver = one(headerNode, 'Receptor');
110
126
  const documentType = integer(identity, 'TipoDTE', true);
111
127
  const folio = text(identity, 'Folio', true, 20);
112
128
  let issuerRut, receiverRut;
113
129
  try {
114
- issuerRut = (0, rut_1.parseRut)(text(one(headerNode, 'Emisor'), 'RUTEmisor', true, 12)).formatted;
115
- receiverRut = (0, rut_1.parseRut)(text(one(headerNode, 'Receptor'), 'RUTRecep', true, 12)).formatted;
130
+ issuerRut = (0, rut_1.parseRut)(text(issuer, 'RUTEmisor', true, 12)).formatted;
131
+ receiverRut = (0, rut_1.parseRut)(text(receiver, 'RUTRecep', true, 12)).formatted;
116
132
  }
117
133
  catch {
118
134
  return invalid();
119
135
  }
120
- if ((documentType !== 33 && documentType !== 34) || !/^[1-9]\d{0,19}$/.test(folio))
136
+ if ((documentType !== 33 && documentType !== 34 && (!allowCreditNotes || documentType !== 61)) || !/^[1-9]\d{0,19}$/.test(folio))
121
137
  invalid();
122
138
  if (issuerRut !== (0, rut_1.parseRut)(expected.issuerRut).formatted || documentType !== expected.documentType || folio !== expected.folio || (expected.receiverRut !== undefined && receiverRut !== (0, rut_1.parseRut)(expected.receiverRut).formatted))
123
139
  throw new DteXmlError('SII_XML_IDENTITY_MISMATCH');
@@ -142,8 +158,24 @@ function parseDteXml(xml, expected) {
142
158
  uniqueLines(lines);
143
159
  uniqueLines(adjustments);
144
160
  uniqueLines(references);
161
+ if (documentType === 61 && (!references.length
162
+ || references.some(reference => reference.code === null || ![1, 2, 3].includes(reference.code))
163
+ || (references.some(reference => reference.code === 1 || reference.code === 2) && references.length !== 1)))
164
+ invalid();
165
+ const signatures = dtes[0].children.filter(node => node.name === 'Signature' && node.uri === 'http://www.w3.org/2000/09/xmldsig#');
166
+ if (allowCreditNotes && signatures.length > 1)
167
+ invalid();
145
168
  return { xml: new Uint8Array(xml), encoding, detail: {
146
- issuerRut, documentType: documentType, folio, issuedDate: date(identity, 'FchEmis'), receiverRut,
169
+ issuerRut, documentType: expected.documentType, folio, issuedDate: date(identity, 'FchEmis'), receiverRut,
170
+ hasSignature: signatures.length === 1,
171
+ hasTransport: children(headerNode, 'Transporte').some(node => node.children.length > 0 || node.text.trim().length > 0 || node.attributeCount > 0),
172
+ ...(allowCreditNotes ? { fiscalHeader: {
173
+ issuer: { legalName: text(issuer, 'RznSoc'), businessActivity: text(issuer, 'GiroEmis'), activityCode: text(issuer, 'Acteco'), branchCode: text(issuer, 'CdgSIISucur', false, 9), address: text(issuer, 'DirOrigen'), commune: text(issuer, 'CmnaOrigen'), city: text(issuer, 'CiudadOrigen') },
174
+ receiver: { legalName: text(receiver, 'RznSocRecep'), address: text(receiver, 'DirRecep'), commune: text(receiver, 'CmnaRecep'), city: text(receiver, 'CiudadRecep'), businessActivity: text(receiver, 'GiroRecep'), contact: text(receiver, 'Contacto') },
175
+ paymentForm: integer(identity, 'FmaPago'), saleType: integer(identity, 'TpoTranVenta'), purchaseType: integer(identity, 'TpoTranCompra'),
176
+ noDebitReduction: integer(identity, 'IndNoRebaja', children(identity, 'IndNoRebaja').length > 0),
177
+ unapprovedFiscalFields: identity.children.filter(node => node.uri === identity.uri && !['TipoDTE', 'Folio', 'FchEmis', 'FmaPago', 'TpoTranVenta', 'TpoTranCompra', 'IndNoRebaja'].includes(node.name)).map(node => node.name),
178
+ } } : {}),
147
179
  netAmount: integer(totals, 'MntNeto'), exemptAmount: integer(totals, 'MntExe'), vatRate: decimal(totals, 'TasaIVA'), vatAmount: integer(totals, 'IVA'), totalAmount: integer(totals, 'MntTotal', true), lines,
148
180
  taxes: children(totals, 'ImptoReten').map(node => ({ type: integer(node, 'TipoImp', true), rate: decimal(node, 'TasaImp'), amount: integer(node, 'MontoImp', true) })), adjustments, references,
149
181
  } };
@@ -0,0 +1,52 @@
1
+ export interface InvoiceLineInput {
2
+ name: string;
3
+ description?: string;
4
+ quantity: string;
5
+ unitNetPriceClp: string;
6
+ unit?: string;
7
+ }
8
+ export interface InvoiceInput {
9
+ issuedDate: string;
10
+ issuer: {
11
+ address: string;
12
+ commune: string;
13
+ city: string;
14
+ activityCode: string;
15
+ };
16
+ receiver: {
17
+ rut: string;
18
+ legalName: string;
19
+ address: string;
20
+ commune: string;
21
+ city: string;
22
+ businessActivity: string;
23
+ contact?: string;
24
+ };
25
+ paymentForm: 1 | 2;
26
+ saleType: 1 | 2;
27
+ purchaseType: 1 | 2 | 3 | 4 | 5 | 6 | 7;
28
+ items: InvoiceLineInput[];
29
+ }
30
+ export interface InvoiceTotals {
31
+ netAmount: number;
32
+ vatAmount: number;
33
+ totalAmount: number;
34
+ }
35
+ /** @deprecated Use InvoiceLineInput. */
36
+ export type LineaFactura = InvoiceLineInput;
37
+ /** @deprecated Use InvoiceInput. */
38
+ export type EntradaFactura = InvoiceInput;
39
+ /** @deprecated Use InvoiceTotals. */
40
+ export type TotalesFactura = InvoiceTotals;
41
+ /** Tipo 33, IVA 19%, sin descuentos ni opciones fiscales implícitas. */
42
+ export declare function validateInvoice(input: unknown): InvoiceInput;
43
+ /** Redondea cada línea a CLP y después el IVA; sin aritmética decimal binaria. */
44
+ export declare function calculateInvoiceTotals(input: unknown): InvoiceTotals;
45
+ /** Huella determinista del contenido fiscal; el llamador excluye claves y tokens. */
46
+ export declare function hashContent(value: unknown): string;
47
+ /** @deprecated Use validateInvoice. */
48
+ export declare const validarFactura: typeof validateInvoice;
49
+ /** @deprecated Use calculateInvoiceTotals. */
50
+ export declare const calcularTotalesFactura: typeof calculateInvoiceTotals;
51
+ /** @deprecated Use hashContent. */
52
+ export declare const hashContenido: typeof hashContent;
@@ -0,0 +1,157 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.hashContenido = exports.calcularTotalesFactura = exports.validarFactura = void 0;
4
+ exports.validateInvoice = validateInvoice;
5
+ exports.calculateInvoiceTotals = calculateInvoiceTotals;
6
+ exports.hashContent = hashContent;
7
+ const node_crypto_1 = require("node:crypto");
8
+ const rut_1 = require("./rut");
9
+ const controls = /[\u0000-\u001f\u007f-\u009f]/u;
10
+ function invalid(field) { throw new TypeError(`Factura inválida: ${field}`); }
11
+ function isRecord(value) {
12
+ return typeof value === 'object' && value !== null && !Array.isArray(value)
13
+ && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
14
+ }
15
+ function record(value, allowed, field) {
16
+ if (!isRecord(value) || Reflect.ownKeys(value).some(key => typeof key !== 'string' || !allowed.includes(key)))
17
+ invalid(field);
18
+ return value;
19
+ }
20
+ function text(value, limit, field, optional = false) {
21
+ if (optional && value === undefined)
22
+ return undefined;
23
+ if (typeof value !== 'string' || controls.test(value))
24
+ invalid(field);
25
+ const result = value.trim();
26
+ if (result.length > limit || (!optional && !result))
27
+ invalid(field);
28
+ return result || undefined;
29
+ }
30
+ function requiredText(value, limit, field) {
31
+ return text(value, limit, field) ?? invalid(field);
32
+ }
33
+ function decimal(value, field) {
34
+ const result = requiredText(value, 12, field);
35
+ const match = /^(\d{1,10})(?:\.(\d{1,2}))?$/.exec(result);
36
+ if (!match)
37
+ invalid(field);
38
+ const integer = match[1].replace(/^0+(?=\d)/u, '');
39
+ const fraction = (match[2] ?? '').replace(/0+$/u, '');
40
+ if (integer === '0' && !fraction)
41
+ invalid(field);
42
+ return fraction ? `${integer}.${fraction}` : integer;
43
+ }
44
+ function hundredths(value) {
45
+ const [integer, fraction = ''] = value.split('.');
46
+ return BigInt(integer) * 100n + BigInt(fraction.padEnd(2, '0'));
47
+ }
48
+ function items(value) {
49
+ if (!Array.isArray(value) || !value.length || value.length > 10)
50
+ invalid('items');
51
+ return Array.from(value, entry => {
52
+ const source = record(entry, ['name', 'description', 'quantity', 'unitNetPriceClp', 'unit'], 'items');
53
+ const description = text(source.description, 999, 'description', true);
54
+ const unit = text(source.unit, 4, 'unit', true);
55
+ return Object.freeze({
56
+ name: requiredText(source.name, 25, 'name'),
57
+ ...(description === undefined ? {} : { description }),
58
+ quantity: decimal(source.quantity, 'quantity'),
59
+ unitNetPriceClp: decimal(source.unitNetPriceClp, 'unitNetPriceClp'),
60
+ ...(unit === undefined ? {} : { unit }),
61
+ });
62
+ });
63
+ }
64
+ function totals(lines) {
65
+ const net = lines.reduce((sum, line) => {
66
+ const amount = (hundredths(line.quantity) * hundredths(line.unitNetPriceClp) + 5000n) / 10000n;
67
+ if (amount < 1n)
68
+ invalid('lineAmount');
69
+ return sum + amount;
70
+ }, 0n);
71
+ const vat = (net * 19n + 50n) / 100n;
72
+ const total = net + vat;
73
+ if (net < 1n || total > 9999999999n)
74
+ invalid('totalAmount');
75
+ return Object.freeze({ netAmount: Number(net), vatAmount: Number(vat), totalAmount: Number(total) });
76
+ }
77
+ function issuedDate(value) {
78
+ if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}$/u.test(value))
79
+ invalid('issuedDate');
80
+ const year = Number(value.slice(0, 4)), month = Number(value.slice(5, 7)), day = Number(value.slice(8, 10));
81
+ const leap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
82
+ const days = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
83
+ if (year < 2017 || month < 1 || month > 12 || day < 1 || day > days[month - 1])
84
+ invalid('issuedDate');
85
+ return value;
86
+ }
87
+ /** Tipo 33, IVA 19%, sin descuentos ni opciones fiscales implícitas. */
88
+ function validateInvoice(input) {
89
+ const source = record(input, ['issuedDate', 'issuer', 'receiver', 'paymentForm', 'saleType', 'purchaseType', 'items'], 'input');
90
+ const issuer = record(source.issuer, ['address', 'commune', 'city', 'activityCode'], 'issuer');
91
+ const receiver = record(source.receiver, ['rut', 'legalName', 'address', 'commune', 'city', 'businessActivity', 'contact'], 'receiver');
92
+ const activityCode = requiredText(issuer.activityCode, 6, 'activityCode');
93
+ if (!/^\d{6}$/u.test(activityCode))
94
+ invalid('activityCode');
95
+ const paymentForm = source.paymentForm, saleType = source.saleType, purchaseType = source.purchaseType;
96
+ if (paymentForm !== 1 && paymentForm !== 2)
97
+ invalid('paymentForm');
98
+ if (saleType !== 1 && saleType !== 2)
99
+ invalid('saleType');
100
+ if (purchaseType !== 1 && purchaseType !== 2 && purchaseType !== 3 && purchaseType !== 4 && purchaseType !== 5 && purchaseType !== 6 && purchaseType !== 7)
101
+ invalid('purchaseType');
102
+ const lines = items(source.items);
103
+ totals(lines);
104
+ const contact = text(receiver.contact, 80, 'contact', true);
105
+ const result = {
106
+ issuedDate: issuedDate(source.issuedDate),
107
+ issuer: Object.freeze({
108
+ address: requiredText(issuer.address, 70, 'issuer.address'),
109
+ commune: requiredText(issuer.commune, 20, 'issuer.commune'),
110
+ city: requiredText(issuer.city, 15, 'issuer.city'), activityCode,
111
+ }),
112
+ receiver: Object.freeze({
113
+ rut: (0, rut_1.parseRut)(requiredText(receiver.rut, 15, 'receiver.rut')).formatted,
114
+ legalName: requiredText(receiver.legalName, 100, 'receiver.legalName'),
115
+ address: requiredText(receiver.address, 70, 'receiver.address'),
116
+ commune: requiredText(receiver.commune, 20, 'receiver.commune'),
117
+ city: requiredText(receiver.city, 15, 'receiver.city'),
118
+ businessActivity: requiredText(receiver.businessActivity, 40, 'receiver.businessActivity'),
119
+ ...(contact === undefined ? {} : { contact }),
120
+ }),
121
+ paymentForm, saleType, purchaseType, items: lines,
122
+ };
123
+ Object.freeze(result.items);
124
+ return Object.freeze(result);
125
+ }
126
+ /** Redondea cada línea a CLP y después el IVA; sin aritmética decimal binaria. */
127
+ function calculateInvoiceTotals(input) { return totals(items(input)); }
128
+ /** Huella determinista del contenido fiscal; el llamador excluye claves y tokens. */
129
+ function hashContent(value) {
130
+ const ancestors = new Set();
131
+ function canonical(input) {
132
+ if (input === null || typeof input === 'string' || typeof input === 'boolean')
133
+ return input;
134
+ if (typeof input === 'number' && Number.isFinite(input))
135
+ return input;
136
+ if (typeof input !== 'object' || ancestors.has(input))
137
+ invalid('contenido');
138
+ ancestors.add(input);
139
+ let result;
140
+ if (Array.isArray(input))
141
+ result = Array.from(input, canonical);
142
+ else if (isRecord(input) && Reflect.ownKeys(input).every(key => typeof key === 'string')) {
143
+ result = Object.fromEntries(Object.keys(input).sort().map(key => [key, canonical(input[key])]));
144
+ }
145
+ else
146
+ invalid('contenido');
147
+ ancestors.delete(input);
148
+ return result;
149
+ }
150
+ return (0, node_crypto_1.createHash)('sha256').update(JSON.stringify(canonical(value))).digest('hex');
151
+ }
152
+ /** @deprecated Use validateInvoice. */
153
+ exports.validarFactura = validateInvoice;
154
+ /** @deprecated Use calculateInvoiceTotals. */
155
+ exports.calcularTotalesFactura = calculateInvoiceTotals;
156
+ /** @deprecated Use hashContent. */
157
+ exports.hashContenido = hashContent;