@devly-cl/sii-client 0.7.1 → 0.7.11

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 (70) hide show
  1. package/README.md +84 -1
  2. package/dist/application/document-status.d.ts +5 -5
  3. package/dist/application/document-status.js +14 -9
  4. package/dist/application/dte-import-mapper.d.ts +8 -0
  5. package/dist/application/dte-import-mapper.js +25 -0
  6. package/dist/application/dte-import-model.d.ts +28 -0
  7. package/dist/application/dte-import-model.js +2 -0
  8. package/dist/application/dte-import.d.ts +37 -0
  9. package/dist/application/dte-import.js +352 -0
  10. package/dist/application/invoice-queries.d.ts +12 -6
  11. package/dist/application/invoice-queries.js +9 -5
  12. package/dist/application/issuance.d.ts +2 -2
  13. package/dist/application/issuance.js +26 -10
  14. package/dist/contracts.d.ts +32 -0
  15. package/dist/contracts.js +17 -0
  16. package/dist/domain/civil-date.d.ts +2 -0
  17. package/dist/domain/civil-date.js +10 -0
  18. package/dist/domain/document-status.d.ts +0 -4
  19. package/dist/domain/document-status.js +18 -11
  20. package/dist/domain/document.js +49 -9
  21. package/dist/domain/dte-arithmetic.d.ts +35 -0
  22. package/dist/domain/dte-arithmetic.js +78 -0
  23. package/dist/domain/dte-components.d.ts +9 -0
  24. package/dist/domain/dte-components.js +37 -0
  25. package/dist/domain/dte-detail.d.ts +111 -0
  26. package/dist/domain/dte-detail.js +2 -0
  27. package/dist/domain/dte-identity.d.ts +19 -0
  28. package/dist/domain/dte-identity.js +52 -0
  29. package/dist/domain/dte-money.d.ts +41 -0
  30. package/dist/domain/dte-money.js +81 -0
  31. package/dist/domain/dte-reconciliation-model.d.ts +87 -0
  32. package/dist/domain/dte-reconciliation-model.js +2 -0
  33. package/dist/domain/dte-reconciliation.d.ts +15 -0
  34. package/dist/domain/dte-reconciliation.js +390 -0
  35. package/dist/domain/dte-validation.d.ts +7 -0
  36. package/dist/domain/dte-validation.js +84 -0
  37. package/dist/domain/invoice-xml.d.ts +17 -57
  38. package/dist/domain/invoice-xml.js +0 -10
  39. package/dist/domain/invoicing.d.ts +30 -4
  40. package/dist/domain/invoicing.js +75 -21
  41. package/dist/domain/issued-invoice.d.ts +0 -6
  42. package/dist/domain/rcv-document.d.ts +0 -4
  43. package/dist/domain/received-invoice.d.ts +1 -4
  44. package/dist/index.d.ts +19 -9
  45. package/dist/index.js +20 -4
  46. package/dist/infrastructure/document-status-gateway.d.ts +6 -4
  47. package/dist/infrastructure/document-status-gateway.js +34 -13
  48. package/dist/infrastructure/document-status-parser.js +38 -12
  49. package/dist/infrastructure/dte-xml-mapper.d.ts +16 -0
  50. package/dist/infrastructure/dte-xml-mapper.js +381 -0
  51. package/dist/infrastructure/dte-xml.d.ts +40 -4
  52. package/dist/infrastructure/dte-xml.js +117 -196
  53. package/dist/infrastructure/facturador-gateway.d.ts +10 -7
  54. package/dist/infrastructure/facturador-gateway.js +256 -56
  55. package/dist/infrastructure/facturador.d.ts +1 -1
  56. package/dist/infrastructure/facturador.js +18 -10
  57. package/dist/infrastructure/invoice-pdf.js +10 -3
  58. package/dist/infrastructure/rcv-gateway.d.ts +7 -4
  59. package/dist/infrastructure/rcv-gateway.js +53 -12
  60. package/dist/infrastructure/rcv-normalization.d.ts +8 -1
  61. package/dist/infrastructure/rcv-normalization.js +54 -12
  62. package/dist/infrastructure/read-options.d.ts +3 -0
  63. package/dist/infrastructure/read-options.js +25 -0
  64. package/dist/infrastructure/sii-client.d.ts +98 -13
  65. package/dist/infrastructure/sii-client.js +182 -31
  66. package/dist/infrastructure/sii-http-session.d.ts +2 -2
  67. package/dist/infrastructure/sii-http-session.js +134 -37
  68. package/dist/sii-error.d.ts +5 -0
  69. package/dist/sii-error.js +39 -13
  70. package/package.json +2 -2
package/README.md CHANGED
@@ -45,8 +45,10 @@ async function getInvoices(
45
45
  | `getSummary` | Resumen RCV por período, operación y estado. |
46
46
  | `getIssuedInvoices` / `getReceivedInvoices` | Facturas 33/34 normalizadas, con cobertura del período. |
47
47
  | `getIssuedDocuments` / `getReceivedDocuments` | Documentos RCV 33/34/61 normalizados, con cobertura por tipo. |
48
+ | `getIssuedDocumentsExact` / `getReceivedDocumentsExact` | La misma lectura RCV con importes enteros exactos como cadenas. |
48
49
  | `getIssuedInvoiceXml` / `getReceivedInvoiceXml` | XML original y detalle de facturas 33/34. |
49
50
  | `getIssuedDocumentXml` / `getReceivedDocumentXml` | XML original y detalle de documentos emitidos/recibidos 33/34/61. |
51
+ | `getIssuedDocumentXmlExact` / `getReceivedDocumentXmlExact` | XML original y detalle 33/34/61 con importes de hasta 18 dígitos sin pérdida de precisión. |
50
52
  | `getIssuedInvoicePdf` / `getReceivedInvoicePdf` | PDF original 33/34 como stream `Readable` de Node.js. |
51
53
  | `getDocumentStatus` | Recepción, coincidencia de contenido y anulación reportada. |
52
54
  | `getDocumentRecipientEvents` | Eventos de facturas 33/34 como emisor o receptor. |
@@ -57,11 +59,28 @@ async function getInvoices(
57
59
 
58
60
  Las consultas RCV reciben `{ periodo, tokenRecaptcha? }` y devuelven `{ data, complete, expectedCount, observedAt, incompleteDocumentTypes }`. El XML recibido requiere `{ issuerRut, documentType, folio }`; conserva las referencias del documento.
59
61
 
62
+ Si SII repite un DTE dentro de `SetDTE` o `EnvioDTE`, la lectura utiliza la primera ocurrencia sólo cuando todas las copias son idénticas en su XML completo, incluida la firma. No basta que coincidan folio y total. Se valida la identidad esperada y se conservan íntegros los bytes y la codificación de la respuesta original. Cualquier diferencia mantiene el rechazo por ambigüedad. La preparación, firma y envío siguen exigiendo un solo DTE físico.
63
+
64
+ El detalle XML conserva, cuando existen, `nonBillableAmount` (`MontoNF`), `periodAmount` (`MontoPeriodo`), `previousBalance` (`SaldoAnterior`) y `payableAmount` (`VlrPagar`). Los cuatro admiten signo. Son totalizadores originales: no modifican `totalAmount`, no implican redondeo en efectivo y no autorizan emitir cargos adicionales. La proyección separa el cobro nuevo del período del saldo anterior y no acredita pagos.
65
+
66
+ Por defecto, los parsers entregan además `detail.reconciliation`. `declared` conserva los totalizadores recibidos; `derived` contiene cantidades/precios decimales como strings, importes de línea conciliados, conversión bruto/neto, descuentos, impuestos adicionales o anticipados y montos no facturables. Los campos originales de `detail` y los bytes de `xml` no se reemplazan por cálculos. `normalizeDteFolio` normaliza identidades numéricas sin pasar por `Number`; `declaredFolio` conserva ceros iniciales cuando se normalizan el folio o sus referencias fiscales. Las referencias informativas de una NC se distinguen de sus referencias fiscales y los códigos de producto opcionales vacíos no eliminan el documento.
67
+
68
+ `reconcileDteDetail(detail)` permite conciliar también detalle declarado almacenado previamente. Su resultado es `RECONCILED` o `REVIEW_REQUIRED`; en revisión, `derived` es `null` y los diagnósticos explican el bloqueo. Reconoce métodos verificables de redondeo de descuentos/IVA, distribuye el neto declarado en líneas brutas y distingue redondeo por línea de redondeo del subtotal exacto. No aplica una tolerancia monetaria general, no inventa una línea para cerrar diferencias ni modifica IVA, impuestos o total declarado. Los códigos de impuesto desconocidos, alcances no soportados e inconsistencias sin explicación requieren revisión. Esta conciliación de lectura no certifica aceptación fiscal ni relaja las comprobaciones del contenido aprobado para emisión.
69
+
70
+ El diagnóstico `VAT_PRECISE_PRODUCTS` explica el IVA calculado sobre productos netos exactos antes de redondear la base. Requiere tasa, cantidades y precios originales, ausencia de ajustes globales efectivos, y que la base exacta redondeada coincida con el neto declarado. Excluye líneas no facturables y conserva todos los importes y bytes originales; una diferencia de un peso sin ese cálculo sigue requiriendo revisión.
71
+
72
+ La normalización de lectura puede entregar **observaciones no bloqueantes** en `derived.observations` (código, mensaje e importes declarado/calculado). `RECONCILED` indica que el modelo es representable y puede incluir esas observaciones; no acredita aceptación fiscal. Los valores del XML y sus diagnósticos se conservan, sin líneas artificiales ni cambios de IVA, impuestos o total.
73
+
74
+ Una diferencia de encabezado de **un peso por documento** conserva el total original con observación, siempre que líneas, subtotal, tasas y datos originales sean verificables y representables. Diferencias mayores y otros errores bloqueantes siguen en revisión. Sólo se añade `derived.totalRounding` cuando un cálculo exacto soportado reproduce ese total: conserva delta, método, base (`DECLARED_LINE_AMOUNTS` o `EXACT_PRODUCTS`) y suma de totalizadores. Requiere tasa de IVA declarada para líneas afectas y cantidades/precios originales para productos exactos; no utiliza conversiones brutas ni reparto supuesto de ajustes globales. La diferencia observada sin ese cálculo no se etiqueta como redondeo demostrado. Esta política de lectura no representa una tolerancia general del SII ni redondeo de pagos en efectivo.
75
+
76
+ Un ajuste global fijo con distintos códigos de impuesto genera la observación `GLOBAL_ADJUSTMENT_REQUIRES_PERCENT`, según la sección D del [formato DTE del SII](https://www.sii.cl/factura_electronica/factura_mercado/formato_dte_202602.pdf#page=44). Se conservan los impuestos originales sin inferir el reparto del ajuste entre sus bases. Las glosas comerciales no se transforman en descuentos estructurados. Tipos desconocidos, tasas/bases ausentes y defectos no representables siguen siendo bloqueantes.
77
+
60
78
  Los nombres anteriores en español siguen disponibles como aliases de compatibilidad. La tabla describe este repositorio; las nuevas consultas de documentos RCV, XML recibido 33/34/61, estado y eventos no están incluidas en npm `0.6.0`.
61
79
 
62
80
  ## Integración
63
81
 
64
82
  - Crear una instancia por empresa, identidad y operación. Usar acceso personal y esperar `dispose()` en `finally`; no compartir clientes autenticados entre tenants.
83
+ - `dispose()` confirma el logout remoto o rechaza con `SII_LOGOUT_FAILED`; libera cookies y recursos también si falla. Reintenta el cierre idempotente ante transporte o HTTP 429/502/503/504 hasta `retries + 1` veces, conservando las cookies durante esos intentos. Respeta `Retry-After` de hasta cinco segundos; esperas mayores quedan en `diagnostics.retryAfterMs` para que el consumidor programe una nueva lectura con otra instancia y sesión verificada. Un fallo de cierre detiene la operación actual. Si la operación ya falló, conservar ese error y registrar por separado el fallo de cierre. Un 302 de login sólo se acepta con destino HTTPS del SII, TOKEN y verificación posterior de identidad personal y empresa; no se sigue la redirección ni se reintenta el login.
65
84
  - Pasar credenciales sólo por parámetros y mantenerlas en memoria. No persistir secretos ni registrar cuerpos HTTP.
66
85
  - El backend gestiona RBAC, permisos por recurso/sucursal, auditoría, notificaciones e idempotencia. RCV contiene datos de toda la empresa: un permiso de sucursal no autoriza automáticamente su consulta completa.
67
86
  - `complete`, `expectedCount` e `incompleteDocumentTypes` sólo cubren los tipos consultados: 33/34 en facturas, 33/34/61 en documentos. Comparar con `getSummary` para detectar otros tipos pendientes; no acreditan cobertura fiscal total. La identidad es `issuerRut + documentType + folio`.
@@ -73,11 +92,13 @@ Preparar → revisar y aprobar `contentHash` → firmar y enviar. `beforeSend` e
73
92
 
74
93
  Ante `SII_ISSUANCE_OUTCOME_UNKNOWN`, bloquear una nueva emisión y reconciliar con el documento respaldado. `ENVIADO` confirma el envío observado; no acredita aceptación fiscal. Las consultas de estado mantienen `fiscalVerdict: 'NOT_OBSERVED'`.
75
94
 
95
+ `getCompanyInfo` conserva los domicilios y giros disponibles, también en empresas con muchas sucursales. Las tablas del portal admiten hasta 1000 domicilios y 100 giros, con un máximo de 256 KiB por tabla. Se mantienen los controles de identidad, estructura, tamaño de respuesta y rechazo de scripts ejecutables.
96
+
76
97
  ## Errores
77
98
 
78
99
  Entradas inválidas generan `TypeError`. Fallos de sesión, proveedor o protocolo generan `SiiError` con `code`, `description` y `diagnostics` opcionales saneados.
79
100
 
80
- Sólo lecturas conocidas admiten reintentos automáticos. Login, selección de empresa, preparación, firma y envío no se reintentan. CAPTCHA requiere intervención del consumidor.
101
+ Sólo lecturas conocidas y el cierre idempotente admiten reintentos automáticos. Login, selección de empresa, preparación, firma y envío no se reintentan. CAPTCHA requiere intervención del consumidor.
81
102
 
82
103
  ## Referencias
83
104
 
@@ -94,3 +115,65 @@ npm pack
94
115
  ```
95
116
 
96
117
  `check` valida tipos, build, integración HTTP simulada, autorización y ejemplos. Licencia: `UNLICENSED`.
118
+
119
+ ## Leer detalle sin conciliación
120
+
121
+ Los métodos XML y los tres parsers aceptan `{ reconcile: false }`. El valor predeterminado es `true`,
122
+ por lo que las llamadas existentes mantienen sus resultados y validaciones.
123
+
124
+ ```ts
125
+ import { buildDteImportProjection, reconcileDteDetail } from '@devly-cl/sii-client';
126
+
127
+ // client ya autenticado y consulta autorizada por actor, tenant, empresa, recurso y sucursal.
128
+ const result = await client.getReceivedDocumentXml(
129
+ { issuerRut: '33333333-3', documentType: 33, folio: '101' },
130
+ { reconcile: false },
131
+ );
132
+
133
+ const declared = result.detail; // Sin propiedad reconciliation; no se recalculan los importes.
134
+ const analysis = reconcileDteDetail(declared); // Opcional: explicar cálculos sobre el detalle numérico.
135
+ const projection = buildDteImportProjection(declared); // Opcional: preparar datos comerciales.
136
+ ```
137
+
138
+ Esta opción omite la conciliación y los requisitos para interpretar referencias fiscales de una NC.
139
+ Conserva RUT, emisor/receptor esperados, tipo, folio, estructura, límites de tamaño/profundidad y precisión.
140
+ No acepta DTD ni entidades externas, no omite autorización y no modifica los controles de emisión.
141
+ Las opciones inválidas se rechazan antes de iniciar nuevas solicitudes HTTP.
142
+
143
+ `getIssuedDocumentXmlExact` y `getReceivedDocumentXmlExact` aceptan la misma opción y conservan importes
144
+ monetarios como strings. Para preparar sus datos se usa `buildDteImportProjectionExact`; el conciliador
145
+ numérico no debe recibir strings monetarios sin una conversión segura explícita.
146
+
147
+ ## Responsabilidades y modelos
148
+
149
+ | Capacidad | Modelo | Responsable |
150
+ |---|---|---|
151
+ | Leer hechos declarados | `DteDeclaredDetail`, enriquecido por los DTOs XML compatibles | Parser y mapper de infraestructura |
152
+ | Explicar importes | `DteReconciliation` | Reglas puras de dominio |
153
+ | Preparar importación | `DteImportProjection` | Política de aplicación y mapper hacia datos comerciales |
154
+ | Aprobar y emitir | `InvoiceInput`, `PreparedDocument` | Caso de uso de emisión y política de contenido aprobado |
155
+
156
+ `domain/dte-detail.ts` describe hechos; `domain/dte-identity.ts`, identidad; `domain/dte-arithmetic.ts`,
157
+ aritmética exacta; y `domain/dte-reconciliation.ts`, su interpretación. `application/dte-import.ts`
158
+ decide cómo preparar una importación. Los formatos XML/RCV, CAPTCHA y cancelación se resuelven en
159
+ infraestructura. El consumidor decide la persistencia, revisión humana, RBAC, auditoría e idempotencia.
160
+
161
+ # Importación documental
162
+
163
+ `buildDteImportProjection(detail, { referenceTotalAmount })` prepara un XML cuya identidad ya fue verificada para registrarlo en un sistema consumidor. A diferencia de `reconcileDteDetail`, una discrepancia aritmética o un impuesto todavía no conciliable genera observaciones y conserva los importes declarados; no impide por sí sola el registro. El resultado distingue `RECONCILED` de `OBSERVED` y nunca autoriza emisión ni acredita pagos o crédito fiscal.
164
+
165
+ Los ítems informativos no se convierten en líneas cobrables. Impuestos específicos y códigos no clasificados conservan código, tasa e importe originales. El saldo anterior y el valor del estado de cuenta quedan separados del importe nuevo del período. Cuando no existe una conversión verificable del bruto al neto por línea, `lineBasis: 'SUMMARY'` entrega un resumen del subtotal declarado: el consumidor debe conservar y mostrar también el detalle XML original, sin inventar precios netos.
166
+
167
+ La proyección no modifica su entrada ni los bytes devueltos por los parsers. Identidad incorrecta, XML ilegible, cantidades/valores fuera de representación segura y conflictos de persistencia siguen sujetos a sus controles. Las APIs de aprobación y emisión conservan sus validaciones estrictas.
168
+
169
+ ## Lecturas exactas y componentes DTE 2.5
170
+
171
+ `getIssuedDocumentsExact`, `getReceivedDocumentsExact`, `getIssuedDocumentXmlExact` y `getReceivedDocumentXmlExact` son extensiones de lectura. Entregan importes monetarios enteros como cadenas canónicas, hasta los 18 dígitos del formato SII. Los números JSON se leen desde su texto original, antes de cualquier conversión que pierda precisión. Las llamadas existentes conservan sus contratos numéricos y rechazan importes fuera de su rango seguro.
172
+
173
+ `parseDteDocumentXmlExact(xml, identidad)` usa el mismo parser de XML; `buildDteImportProjectionExact(detail)` comparte las reglas fiscales de la proyección numérica. Para importes que superan la representación numérica, entrega un resumen documental exacto con observación, sin atribuir una conciliación por línea. `withNumberDteAmounts` es una frontera explícita para consumidores numéricos: lanza `DteMoneyRangeError` si algún importe perdería precisión. `withExactDteAmounts` convierte modelos numéricos seguros al contrato exacto. Los precios, cantidades y porcentajes decimales y los bytes/codificación del XML original se conservan.
174
+
175
+ Las referencias conservan `RUTOtr` como `issuerRut` e `IndGlobal` como `globalIndicator`. `resolveDteReferenceIdentity` devuelve la identidad concreta o `null` para una referencia global o no resoluble: un emisor explícito inválido nunca se sustituye por el emisor actual. Una NC de corrección global admite `IndGlobal=1`, `FolioRef=0`, `CodRef=3`; el folio del propio documento sigue siendo positivo.
176
+
177
+ `fiscalComponents` conserva garantías por envases, crédito de constructoras, IVA no retenido, bases especiales, IVA propio/de terceros y totalizadores de comisiones. `commissions` conserva su detalle y las líneas mantienen sus indicadores y datos de `Retenedor`. Los impuestos proyectados distinguen código/importe original de `effect` y `contribution`: las retenciones sólo se restan en su contexto fiscal conocido y un código o contexto desconocido conserva efecto `UNKNOWN`. Las bases y el IVA informativo no se suman otra vez al total. `fiscalConditions` propaga `IndNoRebaja`, forma de pago y tipos de compra/venta incluso con conciliación completa. Nada de esto determina aceptación fiscal ni derecho a crédito.
178
+
179
+ `projectDteForImport` y `projectDteForImportExact` conservan exactamente las mismas funciones como aliases de compatibilidad.
@@ -1,13 +1,13 @@
1
- import { type BoundDocumentStatusQuery, type BoundRecipientEventsQuery, type DocumentQueryOptions, type DocumentStatusQuery, type DocumentStatusResult, type DocumentVerification, type RecipientEventsQuery, type RecipientEventsResult, type RecipientEventsObservation } from '../domain/document-status';
1
+ import { type BoundDocumentStatusQuery, type BoundRecipientEventsQuery, type DocumentStatusQuery, type DocumentStatusResult, type DocumentVerification, type RecipientEventsObservation, type RecipientEventsQuery, type RecipientEventsResult } from '../domain/document-status';
2
2
  export interface DocumentReadPort {
3
3
  readonly companyRut: string;
4
4
  assertReady(): void;
5
- status(query: BoundDocumentStatusQuery, options?: DocumentQueryOptions): Promise<DocumentVerification>;
6
- recipientEvents(query: BoundRecipientEventsQuery, options?: DocumentQueryOptions): Promise<RecipientEventsObservation>;
5
+ status(query: BoundDocumentStatusQuery): Promise<DocumentVerification>;
6
+ recipientEvents(query: BoundRecipientEventsQuery): Promise<RecipientEventsObservation>;
7
7
  }
8
8
  export declare class DocumentQueries {
9
9
  private readonly port;
10
10
  constructor(port: DocumentReadPort);
11
- getDocumentStatus(query: DocumentStatusQuery, options?: DocumentQueryOptions): Promise<DocumentStatusResult>;
12
- getDocumentRecipientEvents(query: RecipientEventsQuery, options?: DocumentQueryOptions): Promise<RecipientEventsResult>;
11
+ getDocumentStatus(query: DocumentStatusQuery): Promise<DocumentStatusResult>;
12
+ getDocumentRecipientEvents(query: RecipientEventsQuery): Promise<RecipientEventsResult>;
13
13
  }
@@ -8,30 +8,35 @@ class DocumentQueries {
8
8
  constructor(port) {
9
9
  this.port = port;
10
10
  }
11
- async getDocumentStatus(query, options) {
11
+ async getDocumentStatus(query) {
12
12
  this.port.assertReady();
13
13
  const bound = (0, document_status_1.bindDocumentStatusQuery)(this.port.companyRut, query);
14
- (0, document_status_1.assertDocumentQueryOptions)(options);
15
- const result = await this.port.status(bound, options);
14
+ const result = await this.port.status(bound);
16
15
  const verification = result.verification === 'RECEIVED_MATCH'
17
16
  ? { verification: result.verification, cancellation: result.cancellation }
18
17
  : { verification: result.verification, cancellation: 'UNCONFIRMED' };
19
18
  return {
20
19
  ...verification,
21
- document: { issuerRut: bound.issuerRut, receiverRut: bound.receiverRut, documentType: bound.documentType, folio: bound.folio },
20
+ document: {
21
+ issuerRut: bound.issuerRut,
22
+ receiverRut: bound.receiverRut,
23
+ documentType: bound.documentType,
24
+ folio: bound.folio
25
+ },
22
26
  fiscalVerdict: 'NOT_OBSERVED', source: 'SII_CONTENT_QUERY', observedAt: new Date().toISOString(),
23
27
  };
24
28
  }
25
- async getDocumentRecipientEvents(query, options) {
29
+ async getDocumentRecipientEvents(query) {
26
30
  this.port.assertReady();
27
31
  const bound = (0, document_status_1.bindRecipientEventsQuery)(this.port.companyRut, query);
28
- (0, document_status_1.assertDocumentQueryOptions)(options);
29
- const result = await this.port.recipientEvents(bound, options);
32
+ const result = await this.port.recipientEvents(bound);
30
33
  (0, document_status_1.assertRecipientEventsAccess)(bound, result);
31
34
  return {
32
35
  document: {
33
- issuerRut: bound.issuerRut, receiverRut: bound.direction === 'RECEIVED' ? bound.companyRut : (0, rut_1.parseRut)(result.document.receiverRut).formatted,
34
- documentType: bound.documentType, folio: bound.folio,
36
+ issuerRut: bound.issuerRut,
37
+ receiverRut: bound.direction === 'RECEIVED' ? bound.companyRut : (0, rut_1.parseRut)(result.document.receiverRut).formatted,
38
+ documentType: bound.documentType,
39
+ folio: bound.folio,
35
40
  },
36
41
  siiReceivedAtLocal: result.siiReceivedAtLocal, timeZone: null,
37
42
  indicators: {
@@ -0,0 +1,8 @@
1
+ import type { DteFiscalDetail, ExactDteFiscalDetail } from '../domain/invoice-xml';
2
+ import type { ExactDte } from '../domain/dte-money';
3
+ import type { DteImportAmounts } from './dte-import-model';
4
+ type ImportFacts = Pick<DteImportAmounts, 'periodAmount' | 'previousBalance' | 'statementPayableAmount' | 'fiscalComponents' | 'fiscalConditions' | 'commissions'>;
5
+ /** Copies declared fiscal facts into the import DTO; no calculation, allocation or source mutation. */
6
+ export declare function mapDteImportFacts(detail: DteFiscalDetail): ImportFacts;
7
+ export declare function mapDteImportFacts(detail: ExactDteFiscalDetail): ExactDte<ImportFacts>;
8
+ export {};
@@ -0,0 +1,25 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.mapDteImportFacts = mapDteImportFacts;
4
+ /** Older stored document DTOs expose these facts only in fiscalHeader. */
5
+ function fiscalConditions(detail) {
6
+ if (detail.fiscalConditions)
7
+ return { ...detail.fiscalConditions };
8
+ const header = detail.fiscalHeader;
9
+ if (!header)
10
+ return undefined;
11
+ const facts = Object.fromEntries(['noDebitReduction', 'paymentForm', 'saleType', 'purchaseType']
12
+ .flatMap(key => header[key] == null ? [] : [[key, header[key]]]));
13
+ return Object.keys(facts).length ? facts : undefined;
14
+ }
15
+ function mapDteImportFacts(detail) {
16
+ const conditions = fiscalConditions(detail);
17
+ return {
18
+ ...(detail.periodAmount !== undefined ? { periodAmount: detail.periodAmount } : {}),
19
+ ...(detail.previousBalance !== undefined ? { previousBalance: detail.previousBalance } : {}),
20
+ ...(detail.payableAmount !== undefined ? { statementPayableAmount: detail.payableAmount } : {}),
21
+ ...(detail.fiscalComponents ? { fiscalComponents: { ...detail.fiscalComponents } } : {}),
22
+ ...(conditions ? { fiscalConditions: conditions } : {}),
23
+ ...(detail.commissions ? { commissions: detail.commissions.map(item => ({ ...item })) } : {}),
24
+ };
25
+ }
@@ -0,0 +1,28 @@
1
+ import type { DteCommission, DteFiscalComponents, DteFiscalConditions } from '../domain/dte-detail';
2
+ import type { DteProjectedTax, DteReconciledAmounts, DteReconciledLine, DteReconciliationDiagnostic } from '../domain/dte-reconciliation-model';
3
+ import type { ExactDte } from '../domain/dte-money';
4
+ /** Documentary import is separate from strict arithmetic reconciliation and never authorizes issuance. */
5
+ export interface DteImportAmounts extends Omit<DteReconciledAmounts, 'taxes' | 'lines'> {
6
+ subtotalAmount: number;
7
+ /** A summary has lineNumber=0 and no declared MontoItem; original source lines remain untouched. */
8
+ lines: (Omit<DteReconciledLine, 'declaredAmount'> & {
9
+ declaredAmount: number | null;
10
+ })[];
11
+ taxes: DteProjectedTax[];
12
+ fiscalComponents?: DteFiscalComponents;
13
+ fiscalConditions?: DteFiscalConditions;
14
+ commissions?: DteCommission[];
15
+ reconciliationStatus: 'RECONCILED' | 'OBSERVED';
16
+ lineBasis: 'RECONCILED' | 'DECLARED' | 'SUMMARY';
17
+ /** Original optional collection totalizers; payableAmount covers only the new period. */
18
+ periodAmount?: number;
19
+ previousBalance?: number;
20
+ statementPayableAmount?: number;
21
+ }
22
+ export interface DteImportProjection {
23
+ version: 1;
24
+ status: 'IMPORTABLE' | 'REVIEW_REQUIRED';
25
+ amounts: DteImportAmounts | null;
26
+ diagnostics: DteReconciliationDiagnostic[];
27
+ }
28
+ export type ExactDteImportProjection = ExactDte<DteImportProjection>;
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,37 @@
1
+ import type { DteFiscalDetail, ExactDteFiscalDetail } from '../domain/invoice-xml';
2
+ import type { DteImportProjection, ExactDteImportProjection } from './dte-import-model';
3
+ /**
4
+ * Construye los importes comerciales de un DTE 33, 34 o 61 cuya identidad ya fue verificada.
5
+ * Conserva los totales declarados; puede derivar precios netos, excluir ítems informativos o entregar
6
+ * un resumen con lineBasis='SUMMARY' y lineNumber=0. El detalle original no se modifica.
7
+ *
8
+ * @param detail Hechos declarados, obtenidos del parser o de una fuente previamente verificada.
9
+ * @param options referenceTotalAmount es el total RCV opcional; una diferencia genera una observación.
10
+ * @returns IMPORTABLE con importes y observaciones, o REVIEW_REQUIRED con amounts=null por datos no representables.
11
+ * Un ERROR de conciliación puede coexistir con IMPORTABLE: la política conserva los valores del XML.
12
+ * @throws Los errores inesperados no se ocultan. Los montos numéricos deben ser enteros seguros.
13
+ * @example
14
+ * const result = buildDteImportProjection(parsed.detail);
15
+ * if (result.status === 'IMPORTABLE') console.log(result.amounts.lineBasis);
16
+ * @remarks No persiste, no autoriza acceso, no certifica aceptación fiscal ni habilita emisión.
17
+ */
18
+ export declare function buildDteImportProjection(detail: DteFiscalDetail, options?: {
19
+ referenceTotalAmount?: number;
20
+ }): DteImportProjection;
21
+ /**
22
+ * Construye la misma proyección documental con importes monetarios enteros como strings.
23
+ * Comparte validaciones de fuente con la representación numérica. Por encima del rango seguro de Number,
24
+ * entrega un resumen exacto con lineBasis='SUMMARY', sin atribuir una conciliación por línea.
25
+ *
26
+ * @param detail Detalle exacto con identidad previamente verificada; precios y cantidades siguen siendo strings decimales.
27
+ * @param options referenceTotalAmount es un entero exacto opcional para observar diferencias con RCV.
28
+ * @returns IMPORTABLE o REVIEW_REQUIRED; los importes originales y la entrada se conservan.
29
+ * @see buildDteImportProjection
30
+ */
31
+ export declare function buildDteImportProjectionExact(detail: ExactDteFiscalDetail, options?: {
32
+ referenceTotalAmount?: string;
33
+ }): ExactDteImportProjection;
34
+ /** @deprecated Use buildDteImportProjection. Identical documentary import policy. */
35
+ export declare const projectDteForImport: typeof buildDteImportProjection;
36
+ /** @deprecated Use buildDteImportProjectionExact. Identical exact documentary import policy. */
37
+ export declare const projectDteForImportExact: typeof buildDteImportProjectionExact;