@albertomarturelo/sii-core 0.3.0

package/dist/portal/bte-emit.js

@@ -0,0 +1,266 @@
+// BHE EMISSION (write) — the `TMBECN_*` form-POST flow on loa.sii.cl (ADR-017). Wire contract
+// captured live 2026-07-02 (own session, a real boleta issued end-to-end); see
+// docs/sii-contract/bte.md § Emisión. NOT a third-party library (ADR-004): every field/endpoint
+// below is first-hand-observed and cited.
+//
+// DISTINCT from the read facade (portal/bte.ts, which reads inline JS maps via goto/evaluate):
+// emission is a sequence of AUTHENTICATED FORM POSTS returning HTML, so it goes through the
+// `PortalSession.requestForm` seam and parses each response's inline `xml_values` from the HTML
+// text (single-quoted `xml_values['k'] = 'v';`, observed). SESSION-KEYED (ADR-005): the emisor is
+// the session principal (`rut_arrastre` = `rut_autentificado`); the task rejects a representing
+// pointer up front.
+//
+// Flow (state machine `presionaBoton()` in loa.sii.cl/IMT/js/TMBECN_Emision.js):
+//   1. GET  TMBECN_ValidaTimbrajeContrib.cgi?modo=1   — validate authorized to emit
+//   2. POST TMBECN_PresentaDatosBoleta.cgi            — the emisor form (source of emisor context)
+//   3. POST TMBECN_ConfirmaTimbrajeContrib.cgi (33)   — PREVIEW: server computes retención/líquido
+//   4. POST TMBECN_BoletaHonorariosElectronica.cgi(24)— ISSUE: assigns cód. de barras (folio)
+// `previewBteEmision` runs 1–3 (never issues); `emitBteEmision` runs 1–4.
+import { HOSTS } from '../config/index.js';
+import { BteError } from '../errors/index.js';
+import { comunaInRegion, comunaName, isRegion } from './bte-comunas.js';
+const CGI = HOSTS.bheCgi;
+const VALIDA_URL = `${CGI}/TMBECN_ValidaTimbrajeContrib.cgi?modo=1`;
+const PRESENTA_URL = `${CGI}/TMBECN_PresentaDatosBoleta.cgi`;
+const CONFIRMA_URL = `${CGI}/TMBECN_ConfirmaTimbrajeContrib.cgi`;
+const EMITE_URL = `${CGI}/TMBECN_BoletaHonorariosElectronica.cgi`;
+/** The PDF is fetched by código de barras (observed). */
+export const pdfUrl = (codBarras) => `${CGI}/TMBCOT_ConsultaBoletaPdf.cgi?txt_codigobarras=${codBarras}`;
+const OPT_RETENCION = {
+    RECEPTOR: 'RETRECEPTOR',
+    EMISOR: 'RETCONTRIBUYENTE',
+};
+// --- HTML parsing (in-house, no third-party lib — ADR-004) ------------------------
+// The TMBECN_* responses embed state as `xml_values['key'] = 'value';` (single quotes,
+// variable whitespace — observed 2026-07-02). Amounts on the confirm page are wrapped in
+// `formatMiles("<n>", ".")` — we read the raw integer argument.
+/** Read a single `xml_values['key'] = '...'` (or `"..."`) value from the response HTML, or null.
+ *  SII mixes single- and double-quoted values (e.g. `PorcentajeRetencion` / `iddir1` are double),
+ *  so accept either; the closing quote must match the opening one. */
+function xmlValue(html, key) {
+    const re = new RegExp(`xml_values\\['${key}'\\]\\s*=\\s*(?:'([^']*)'|"([^"]*)")`);
+    const m = re.exec(html);
+    return m ? (m[1] ?? m[2] ?? null) : null;
+}
+/** Read a `xml_values['key'] = formatMiles("<n>", ...)` integer amount from the confirm page. */
+function xmlMonto(html, key) {
+    const re = new RegExp(`xml_values\\['${key}'\\]\\s*=\\s*formatMiles\\("(-?\\d+)"`);
+    const m = re.exec(html)?.[1];
+    return m === undefined ? null : Number(m);
+}
+/** The emisor's registered domicilio id (`cbo_domicilio` value). The address `<select>` is
+ *  built client-side by JS from an `arr_direcciones` map, so it is NOT a static `<option>` in the
+ *  HTML — the ids live in `iddir<n>` entries (observed 2026-07-2: `['iddir1'] = "092726950"`,
+ *  double-quoted). `iddir1` is the first/default address (the selected one for a single-address
+ *  emisor; `CantidadDirecciones` counts them). Returns it, or null. */
+function firstDomicilioId(html) {
+    return /\['iddir1'\]\s*=\s*["']([^"']+)["']/.exec(html)?.[1] ?? null;
+}
+/** Assert the response is a real emisor/confirm page, not a SII rejection. NOTE: the valid form is
+ *  full of `alert('…')` VALIDATION calls in its JS, so a generic alert-scan would false-positive —
+ *  we only detect the explicit AUTHORIZATION-rejection text ("no está autorizado a emitir …") and
+ *  surface it VERBATIM (ADR-004; the login-wall case is already `SessionExpiredError` from the
+ *  seam). Otherwise, a page with no emisor form at all (no `xml_values` AND no `formulario`) is a
+ *  generic hard failure. */
+function assertEmisorForm(html, step) {
+    const rejection = /(no (?:est[aá]|se encuentra) autorizad[oa](?: a emitir)?[^<.]{0,120})/i.exec(html)?.[1];
+    if (rejection)
+        throw new BteError(rejection.replace(/\s+/g, ' ').trim());
+    if (!html.includes('xml_values[') && !html.includes('formulario')) {
+        throw new BteError(`El SII no entregó el formulario de emisión de BHE (paso: ${step}). ` +
+            'Verifica que estés autorizado a emitir boletas de honorarios y que la sesión esté viva.');
+    }
+}
+const two = (n) => String(n).padStart(2, '0');
+/** Steps 1–2: validate authorization, then POST for the emisor form and read the emisor context
+ *  (own domicilio / comuna / actividad / server date). `rut` is the session principal.
+ *  `optRetencion` is the who-withholds choice — the from-scratch flow (modo=1) POSTs it to get
+ *  the form (observed 2026-07-02: body `{rut_arrastre, dv_arrastre, sin_destinatario, OptTipoRetencion}`;
+ *  the `prellenar/ult_boleta/boleta` body is the modo=2 prefill path, NOT used here). */
+async function loadEmisorForm(session, rut, optRetencion) {
+    // 1. Validate the contribuyente is authorized to emit (liveness + auth). The seam turns a dead
+    //    session into SessionExpiredError; a non-form body here is a "not authorized" failure.
+    await session.requestForm(VALIDA_URL, { method: 'GET' });
+    // 2. Request the blank emisor form (from scratch) with the retención choice.
+    const res = await session.requestForm(PRESENTA_URL, {
+        form: {
+            rut_arrastre: String(rut.body),
+            dv_arrastre: rut.dv,
+            sin_destinatario: 'NO',
+            OptTipoRetencion: optRetencion,
+        },
+    });
+    const html = res.body;
+    assertEmisorForm(html, 'presentaDatos');
+    const now = new Date(); // fallback only; the form's server date wins when present
+    const ctx = {
+        diaActual: xmlValue(html, 'dia_actual') ?? two(now.getDate()),
+        mesActual: xmlValue(html, 'mes_actual') ?? two(now.getMonth() + 1),
+        anioActual: xmlValue(html, 'anio_actual') ?? String(now.getFullYear()),
+        cboDomicilio: firstDomicilioId(html) ?? '',
+        comuna: xmlValue(html, 'comuna_ctr') ?? '',
+        telefono: xmlValue(html, 'fono_ctr') ?? '',
+        glosaActividad: xmlValue(html, 'glosa_actividad') ?? '',
+    };
+    return { html, ctx };
+}
+/** Build the 33-field confirm payload (step 3) from the emisor context + the caller's boleta.
+ *  Field names + shape observed 2026-07-02. Only the used prestación lines carry values;
+ *  `cantidad_filas_ingreso` is the form capacity (4). */
+function buildConfirmForm(rut, ctx, input) {
+    const mostrar = input.mostrarDetalle !== false;
+    const form = {
+        dia_actual: ctx.diaActual,
+        mes_actual: ctx.mesActual,
+        anio_actual: ctx.anioActual,
+        rut_arrastre: String(rut.body),
+        dv_arrastre: rut.dv,
+        sin_destinatario: 'NO',
+        OptTipoRetencion: OPT_RETENCION[input.retiene],
+        hdn_muestra_glosa: mostrar ? 'si' : 'no',
+        hdn_glosa_actividad: ctx.glosaActividad,
+        cantidad_filas_ingreso: '4',
+        rdb_glosa: mostrar ? 'si' : 'no',
+        cbo_domicilio: ctx.cboDomicilio,
+        txt_comuna: ctx.comuna,
+        txt_telefono: ctx.telefono,
+        txt_fax: '',
+        cbo_dia_boleta: two(input.fecha.dia),
+        cbo_mes_boleta: two(input.fecha.mes),
+        cbo_anio_boleta: String(input.fecha.anio),
+        txt_rut_destinatario: String(input.receptor.body),
+        txt_dv_destinatario: input.receptor.dv,
+        txt_nombres_destinatario: input.receptorNombre,
+        txt_domicilio_destinatario: input.receptorDomicilio,
+        cod_region: String(input.region),
+        cbo_comuna: String(input.comuna),
+        txt_comuna_destinatario: comunaName(input.region, input.comuna) ?? '',
+    };
+    for (let i = 1; i <= 4; i++) {
+        const linea = input.lineas[i - 1];
+        form[`desc_prestacion_${i}`] = linea ? linea.glosa : '';
+        form[`valor_prestacion_${i}`] = linea ? String(linea.monto) : '';
+    }
+    return form;
+}
+/** Parse the preview (confirm page) computed amounts. */
+function parsePreview(html, retiene) {
+    return {
+        totalHonorarios: xmlMonto(html, 'Monto_Boleta'),
+        retencion: xmlMonto(html, 'Monto_Retencion'),
+        liquido: xmlMonto(html, 'Monto_Liquido'),
+        porcentajeRetencion: xmlValue(html, 'PorcentajeRetencion'),
+        retiene,
+    };
+}
+/** Steps 1–3: run to the PREVIEW and return the server-computed boleta WITHOUT issuing.
+ *  Returns the parsed preview + the confirm HTML + the confirm form (so `emitBteEmision` can build
+ *  the issue payload from the same server state). `session` must be a live PortalSession. */
+async function runToPreview(session, rut, input) {
+    const { ctx } = await loadEmisorForm(session, rut, OPT_RETENCION[input.retiene]);
+    const confirmForm = buildConfirmForm(rut, ctx, input);
+    const res = await session.requestForm(CONFIRMA_URL, { form: confirmForm });
+    assertEmisorForm(res.body, 'confirmaTimbraje');
+    return { preview: parsePreview(res.body, input.retiene), confirmHtml: res.body, confirmForm };
+}
+/** PREVIEW an emission: run steps 1–3, return the server-computed retención/líquido. NEVER issues.
+ *  Local validation of the input happens in the task BEFORE any session (fail fast). */
+export async function previewBteEmision(session, rut, input) {
+    const { preview } = await runToPreview(session, rut, input);
+    return preview;
+}
+/** Build the 24-field issue payload (step 4) from the confirm form + the confirm page's state.
+ *  Drops the emisor-only + empty-line fields the confirm carried and adds `origen`, the emisor
+ *  email, and the recomputed `CantidadFilas` (= number of used lines). (observed 2026-07-02) */
+function buildEmitForm(confirmForm, confirmHtml, input) {
+    const nLineas = String(input.lineas.length);
+    const emit = {
+        dia_actual: confirmForm['dia_actual'],
+        cantidad_filas_ingreso: nLineas,
+        mes_actual: confirmForm['mes_actual'],
+        anio_actual: confirmForm['anio_actual'],
+        rut_arrastre: confirmForm['rut_arrastre'],
+        dv_arrastre: confirmForm['dv_arrastre'],
+        OptTipoRetencion: confirmForm['OptTipoRetencion'],
+        cbo_domicilio: confirmForm['cbo_domicilio'],
+        cbo_dia_boleta: confirmForm['cbo_dia_boleta'],
+        cbo_mes_boleta: confirmForm['cbo_mes_boleta'],
+        cbo_anio_boleta: confirmForm['cbo_anio_boleta'],
+        txt_rut_destinatario: confirmForm['txt_rut_destinatario'],
+        txt_dv_destinatario: confirmForm['txt_dv_destinatario'],
+        txt_domicilio_destinatario: confirmForm['txt_domicilio_destinatario'],
+        txt_comuna_destinatario: confirmForm['txt_comuna_destinatario'],
+        hdn_muestra_glosa: confirmForm['hdn_muestra_glosa'],
+        hdn_glosa_actividad: confirmForm['hdn_glosa_actividad'],
+        sin_destinatario: confirmForm['sin_destinatario'],
+        // The emisor's email for the copy — the confirm page carries it; empty if absent.
+        txt_email_contribuyente: xmlValue(confirmHtml, 'email_contribuyente') ?? '',
+        // `origen=SEPTIMO` marks the "confirmar" (issue) step in SII's flow (observed).
+        origen: 'SEPTIMO',
+        txt_nombres_destinatario: confirmForm['txt_nombres_destinatario'],
+        CantidadFilas: nLineas,
+    };
+    for (let i = 1; i <= input.lineas.length; i++) {
+        emit[`desc_prestacion_${i}`] = confirmForm[`desc_prestacion_${i}`];
+        emit[`valor_prestacion_${i}`] = confirmForm[`valor_prestacion_${i}`];
+    }
+    return emit;
+}
+/** ISSUE the boleta: run steps 1–4. Returns the código de barras (the boleta id) + its PDF URL +
+ *  the computed amounts. ⚠️ This CREATES a legally-binding document; the task gates it behind an
+ *  explicit confirmation and NEVER retries. */
+export async function emitBteEmision(session, rut, input) {
+    const { preview, confirmHtml, confirmForm } = await runToPreview(session, rut, input);
+    const emitForm = buildEmitForm(confirmForm, confirmHtml, input);
+    const res = await session.requestForm(EMITE_URL, { form: emitForm });
+    const codBarras = xmlValue(res.body, 'cod_barras');
+    if (codBarras === null) {
+        // No código de barras on the result page → the issue did not complete. Surface it, no retry.
+        throw new BteError('El SII no confirmó la emisión de la boleta (no se recibió el código de barras). ' +
+            'Revisa en el portal si la boleta quedó emitida antes de reintentar.');
+    }
+    return { ...preview, codBarras, pdfUrl: pdfUrl(codBarras) };
+}
+// --- Envío por email (optional, post-issue) ---------------------------------------
+const PRESENTA_ENVIO_URL = `${CGI}/TMBECN_PresentaDatosEnvio.cgi`;
+const ENVIAR_URL = `${CGI}/TMBECN_EnviarBoleta.cgi`;
+/** Email the issued boleta's PDF to the receptor (optional, post-issue). Reuses the código de
+ *  barras. OBSERVATION STATUS (ADR-004): the two POST REQUEST shapes are observed 2026-07-02 —
+ *  `PresentaDatosEnvio` sends `{origen:'SEPTIMO', txt_codigo_barra}` (event 12), `EnviarBoleta`
+ *  sends the field NAMES below with `origen:'NOVENO'` (event 14). NOT yet verified: the
+ *  envío-prep RESPONSE's `xml_values` keys that source `txt_rut_destinatario`/`…dv`/`txt_cod_39`
+ *  /`txt_descr_comuna`/`txt_nombre_receptor` — that response body was not captured, so those
+ *  reads are INFERRED and live-validated with the issue path in #62. Until then the email send is
+ *  best-effort. */
+export async function enviarBteEmision(session, envio) {
+    const prep = await session.requestForm(PRESENTA_ENVIO_URL, {
+        // origen SEPTIMO observed 2026-07-02 (event 12) — NOT a guess.
+        form: { origen: 'SEPTIMO', txt_codigo_barra: envio.codBarras },
+    });
+    const html = prep.body;
+    // The request field names are observed (event 14); the xml_values sources are INFERRED (#62).
+    const form = {
+        txt_rut_destinatario: xmlValue(html, 'rut_destinatario') ?? '',
+        txt_dv_destinatario: xmlValue(html, 'dv_destinatario') ?? '',
+        txt_cod_39: xmlValue(html, 'codigo_inferior') ?? '',
+        txt_codigo_barra: envio.codBarras,
+        txt_descr_comuna: xmlValue(html, 'desc_comuna') ?? '',
+        origen: 'NOVENO', // observed 2026-07-02 (event 14)
+        txt_nombre_receptor: xmlValue(html, 'nombres_destinatario') ?? '',
+        txt_email: envio.email,
+        OptMandaEmailOrigen: envio.copiaEmisor === false ? 'NO' : 'SI',
+    };
+    const res = await session.requestForm(ENVIAR_URL, { form });
+    return { enviado: /enviado|exitosamente/i.test(res.body) };
+}
+// --- Local input validation (before any SII call) ---------------------------------
+/** Validate a region/comuna pair against the ported SII table. */
+export function assertRegionComuna(region, comuna) {
+    if (!isRegion(region)) {
+        throw new BteError(`Región inválida: ${region} (esperado 1–16, código interno del SII).`);
+    }
+    if (!comunaInRegion(region, comuna)) {
+        throw new BteError(`La comuna ${comuna} no pertenece a la región ${region} (usa el código de comuna del SII).`);
+    }
+}
+//# sourceMappingURL=bte-emit.js.map

package/dist/portal/bte-emit.js.map

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

package/dist/portal/bte.d.ts

@@ -0,0 +1,55 @@
+import { Rut } from '../rut/index.js';
+import type { Periodo } from '../periodo/index.js';
+import type { PortalSession } from '../seams/index.js';
+export type BteSide = 'EMITIDAS' | 'RECIBIDAS';
+/** One boleta de honorarios — curated, **no `raw`** (live BUG-1, 2026-06-30). The per-boleta
+ *  ROW mixes counterparty data with the taxpayer's OWN identity on BOTH sides (EMITIDAS:
+ *  `usuemisor` = the emitter = self; RECIBIDAS: a self receptor-name field), plus a counterparty
+ *  email — and the full own-identity field set is not provably enumerable. So, like F22/F29, BTE
+ *  exposes NO `raw`: the curated fields below ARE the tax detail a contador reads; the dropped
+ *  fields are own-identity PII / counterparty email / low-value metadata (barcode, comuna). The
+ *  report META's `nombre_contribuyente`/`rut_arrastre` are likewise never read. Montos are parsed
+ *  from SII's es-CL dot-formatted strings. (CONVENTIONS: drop `raw` when non-curated data is PII.) */
+export interface BteBoleta {
+    readonly folio: number | null;
+    /** Emisión/boleta date, `DD/MM/YYYY` verbatim (ADR-004). */
+    readonly fecha: string | null;
+    /** Counterparty: receptor (emitidas) or emisor (recibidas), canonical RUT. */
+    readonly contraparteRut: string | null;
+    readonly contraparteNombre: string | null;
+    readonly totalHonorarios: number | null;
+    readonly honorariosLiquidos: number | null;
+    readonly retencionEmisor: number | null;
+    readonly retencionReceptor: number | null;
+    /** `N` → `VIG` (vigente) / `S` → `ANUL` (anulada). */
+    readonly estado: 'VIG' | 'ANUL' | null;
+    readonly fechaAnulacion: string | null;
+    readonly socProfesional: boolean | null;
+}
+/** Per-month aggregates from the report META (`xml_values`). */
+export interface BteTotales {
+    readonly honorarios: number | null;
+    readonly retencionEmisor: number | null;
+    readonly retencionReceptor: number | null;
+    readonly liquido: number | null;
+}
+export interface BteMensual {
+    /** Session-principal RUT these boletas belong to (canonical). */
+    readonly rut: string;
+    readonly periodo: string;
+    readonly side: BteSide;
+    readonly totalBoletas: number | null;
+    readonly totales: BteTotales;
+    readonly boletas: readonly BteBoleta[];
+}
+/** Monthly BHE detail for one (período, side), session-keyed. Walks `pagina_solicitada` from 0,
+ *  paced via `pace` (ADR-004), de-duping by folio+counterparty; stops at `total_boletas`, a
+ *  no-new-rows page, or `MAX_PAGINAS`. An empty month is a clean 0-boleta result, NOT an error;
+ *  a non-report / cross-RUT page (no `xml_values`) on page 0 is a `BteError`. `session` must be a
+ *  live PortalSession acquired via `withSession`. */
+export declare function fetchBteMensual(session: PortalSession, params: {
+    rut: Rut;
+    periodo: Periodo;
+    side: BteSide;
+}, pace: () => Promise<void>): Promise<BteMensual>;
+//# sourceMappingURL=bte.d.ts.map

package/dist/portal/bte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bte.d.ts","sourceRoot":"","sources":["../../src/portal/bte.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;AAa/C;;;;;;;sGAOsG;AACtG,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;CACzC;AAED,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;CACxC;AAgJD;;;;qDAIqD;AACrD,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,EACrD,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACxB,OAAO,CAAC,UAAU,CAAC,CAmDrB"}

package/dist/portal/bte.js

@@ -0,0 +1,215 @@
+// BTE/BHE — Boletas de Honorarios Electrónicas. Typed facade over the inline JS maps the
+// legacy `loa.sii.cl/cgi_IMT/` CGIs fill client-side. Ported from the proven Python sii-cli
+// (portal/bte.py, live-captured #62) and TS-live-validated 2026-06-30 (#20); the wire
+// contract is first-hand-observed, NOT a third-party library (ADR-004). See
+// docs/sii-contract/bte.md.
+//
+// DISTINCT from the SDI-JSON facades (RCV/F22/F29): these CGIs serve an HTML skeleton and
+// fill their tables from global JS maps, so we read those maps through the browser
+// primitives — `PortalSession.goto` (the .sii.cl session cookie SSO-carries to loa.sii.cl —
+// observed 2026-06-30) + `PortalSession.evaluate` — NOT `requestJson`. Do NOT scrape the DOM:
+// after domcontentloaded the cells still hold the filling JS (CONVENTIONS: prefer inline data).
+//
+// SESSION-KEYED (ADR-005): `rut_arrastre` is keyed to the session PRINCIPAL — a represented
+// RUT does NOT reach the empresa's data (confirmed live #62). The task reads self only.
+import { HOSTS, LOGIN_HOST } from '../config/index.js';
+import { BteError, SessionExpiredError } from '../errors/index.js';
+import { Rut } from '../rut/index.js';
+// Monthly-detail CGIs (observed 2026-06-30). Emitidas (emisor) = `…Bhe`; recibidas
+// (receptor) = `…BheRec`. All reads are GET; the RUT travels split in the query string.
+const MENSUAL_CGI = {
+    EMITIDAS: 'TMBCOC_InformeMensualBhe.cgi',
+    RECIBIDAS: 'TMBCOC_InformeMensualBheRec.cgi',
+};
+// A non-advancing-loop backstop. The total_boletas target + the no-new-rows guard end
+// pagination first in practice; this only caps a pathological page sequence (ADR-004).
+const MAX_PAGINAS = 100;
+// --- Alias-tolerant row fields (observed name first; emitidas / recibidas differ) --------
+const ALIASES = {
+    folio: ['nroboleta'],
+    fecha: ['fechaemision', 'fecha_boleta'], // emitidas: fechaemision; recibidas: fecha_boleta
+    rutDigits: ['rutreceptor', 'rutemisor'],
+    dv: ['dvreceptor', 'dvemisor'],
+    nombre: ['nombrereceptor', 'nombre_emisor'],
+    totalHonorarios: ['totalhonorarios'],
+    honorariosLiquidos: ['honorariosliquidos'],
+    retencionEmisor: ['retencion_emisor'],
+    retencionReceptor: ['retencion_receptor'],
+    estado: ['estado'],
+    fechaAnulacion: ['fechaanulacion'],
+    socProfesional: ['es_soc_profesional'],
+};
+const aliasGet = (row, aliases) => {
+    for (const key of aliases) {
+        const v = row[key];
+        if (v !== undefined && v !== null)
+            return v;
+    }
+    return undefined;
+};
+const asStr = (v) => {
+    if (v === null || v === undefined)
+        return null;
+    const s = String(v).trim();
+    return s === '' ? null : s;
+};
+/** Parse a Chilean integer monto: row montos are dot-formatted (`"1.300.000"`), meta sums are
+ *  plain (`"1300000"`) — strip thousands separators either way; non-numeric → null. */
+const asMonto = (v) => {
+    const s = asStr(v);
+    if (s === null)
+        return null;
+    const digits = s.replace(/[.\s]/g, '').replace(/,/g, '');
+    if (!/^-?\d+$/.test(digits))
+        return null;
+    return Number(digits);
+};
+const estadoLabel = (v) => {
+    const s = asStr(v)?.toUpperCase();
+    if (s === 'N')
+        return 'VIG';
+    if (s === 'S')
+        return 'ANUL';
+    return null;
+};
+const boolSiNo = (v) => {
+    const s = asStr(v)?.toUpperCase();
+    if (s === 'SI' || s === 'S')
+        return true;
+    if (s === 'NO' || s === 'N')
+        return false;
+    return null;
+};
+const canonicalRut = (digits, dv) => {
+    if (digits === undefined || digits === null || dv === undefined || dv === null)
+        return null;
+    return Rut.tryParse(`${String(digits)}-${String(dv).trim()}`)?.canonical ?? null;
+};
+// Read an inline global JS map. The maps are JS Arrays with STRING keys, which a bare
+// `evaluate("xml_values")` / JSON.stringify would drop — `Object.fromEntries(Object.entries())`
+// preserves them (observed 2026-06-30). An undefined var (non-report page) → null.
+const evalExpr = (v) => `(function(){ return typeof ${v} !== 'undefined' && ${v} !== null ` +
+    `? Object.fromEntries(Object.entries(${v})) : null; })()`;
+function monthlyUrl(side, rut, periodo, pagina) {
+    const anio = String(periodo.year).padStart(4, '0');
+    const mes = String(periodo.month).padStart(2, '0');
+    return (`${HOSTS.bheCgi}/${MENSUAL_CGI[side]}?cbanoinformemensual=${anio}` +
+        `&cbmesinformemensual=${mes}&rut_arrastre=${String(rut.body)}&dv_arrastre=${rut.dv}` +
+        `&pagina_solicitada=${pagina}`);
+}
+/** Split a flat `arr_informe_mensual` map (`<campo>_<i>`) into per-row records keyed by the
+ *  1-based row index, ascending. Each record is `{ <campo>: value }` — the input to
+ *  `projectBoleta` (NOT surfaced; BTE exposes no `raw`). */
+function rowsByIndex(arr) {
+    const byIndex = new Map();
+    for (const [key, value] of Object.entries(arr)) {
+        const m = /^(.+)_(\d+)$/.exec(key);
+        if (!m)
+            continue;
+        const field = m[1];
+        const i = Number(m[2]);
+        let row = byIndex.get(i);
+        if (!row) {
+            row = {};
+            byIndex.set(i, row);
+        }
+        row[field] = value;
+    }
+    return [...byIndex.entries()].sort((a, b) => a[0] - b[0]).map(([, row]) => row);
+}
+// Curate ONLY the named tax fields — no `raw` (BUG-1): the row mixes own-identity PII
+// (EMITIDAS `usuemisor`, RECIBIDAS self receptor-name) with counterparty data, so we read the
+// known tax fields by alias and surface NOTHING else (cf. F22's no-raw posture).
+function projectBoleta(row) {
+    return {
+        folio: asMonto(aliasGet(row, ALIASES.folio)),
+        fecha: asStr(aliasGet(row, ALIASES.fecha)),
+        contraparteRut: canonicalRut(aliasGet(row, ALIASES.rutDigits), aliasGet(row, ALIASES.dv)),
+        contraparteNombre: asStr(aliasGet(row, ALIASES.nombre)),
+        totalHonorarios: asMonto(aliasGet(row, ALIASES.totalHonorarios)),
+        honorariosLiquidos: asMonto(aliasGet(row, ALIASES.honorariosLiquidos)),
+        retencionEmisor: asMonto(aliasGet(row, ALIASES.retencionEmisor)),
+        retencionReceptor: asMonto(aliasGet(row, ALIASES.retencionReceptor)),
+        estado: estadoLabel(aliasGet(row, ALIASES.estado)),
+        fechaAnulacion: asStr(aliasGet(row, ALIASES.fechaAnulacion)),
+        socProfesional: boolSiNo(aliasGet(row, ALIASES.socProfesional)),
+    };
+}
+function parseTotales(meta) {
+    return {
+        honorarios: asMonto(meta['suma_honorarios']),
+        retencionEmisor: asMonto(meta['suma_retencion_emisor']),
+        retencionReceptor: asMonto(meta['suma_retencion_receptor']),
+        liquido: asMonto(meta['suma_liquido']),
+    };
+}
+/** Navigate to a report CGI and read its inline maps. A GET that lands back on the login host
+ *  means the cookies-only session is dead → `SessionExpiredError` (actionable, like the SDI
+ *  seam); this first `goto` IS the liveness test (withSession does not pre-probe). */
+async function fetchPage(session, url) {
+    const landed = await session.goto(url);
+    if (new URL(landed).hostname === LOGIN_HOST) {
+        throw new SessionExpiredError('La sesión expiró. Ejecuta `sii auth login`.');
+    }
+    const meta = await session.evaluate(evalExpr('xml_values'));
+    const rows = await session.evaluate(evalExpr('arr_informe_mensual'));
+    return { meta, rows };
+}
+/** Monthly BHE detail for one (período, side), session-keyed. Walks `pagina_solicitada` from 0,
+ *  paced via `pace` (ADR-004), de-duping by folio+counterparty; stops at `total_boletas`, a
+ *  no-new-rows page, or `MAX_PAGINAS`. An empty month is a clean 0-boleta result, NOT an error;
+ *  a non-report / cross-RUT page (no `xml_values`) on page 0 is a `BteError`. `session` must be a
+ *  live PortalSession acquired via `withSession`. */
+export async function fetchBteMensual(session, params, pace) {
+    const { rut, periodo, side } = params;
+    const boletas = [];
+    const seen = new Set();
+    let totalBoletas = null;
+    let totales = {
+        honorarios: null,
+        retencionEmisor: null,
+        retencionReceptor: null,
+        liquido: null,
+    };
+    for (let pagina = 0; pagina < MAX_PAGINAS; pagina++) {
+        if (pagina > 0)
+            await pace(); // pace each extra page (ADR-004); the task binds the rps
+        const { meta, rows } = await fetchPage(session, monthlyUrl(side, rut, periodo, pagina));
+        if (meta === null) {
+            // No report on this page. On page 0 the (RUT, período) has no informe — a non-report /
+            // cross-RUT page (BteError, ADR-004). On a later page it just means we walked past the end.
+            if (pagina === 0) {
+                throw new BteError(`El SII no entregó el informe de boletas de honorarios para ${periodo.formatted} ` +
+                    `(${side.toLowerCase()}). Verifica la sesión y el período.`);
+            }
+            break;
+        }
+        if (pagina === 0) {
+            totalBoletas = asMonto(meta['total_boletas']);
+            totales = parseTotales(meta);
+        }
+        let added = 0;
+        for (const row of rows === null ? [] : rowsByIndex(rows)) {
+            const boleta = projectBoleta(row);
+            const key = `${boleta.folio ?? '?'}|${boleta.contraparteRut ?? '?'}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            boletas.push(boleta);
+            added++;
+        }
+        if (totalBoletas !== null && boletas.length >= totalBoletas)
+            break;
+        if (added === 0)
+            break; // no new rows → end (also the empty-month exit)
+    }
+    return {
+        rut: rut.canonical,
+        periodo: periodo.formatted,
+        side,
+        totalBoletas,
+        totales,
+        boletas,
+    };
+}
+//# sourceMappingURL=bte.js.map

package/dist/portal/bte.js.map

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

package/dist/portal/dte-public.d.ts

@@ -0,0 +1,36 @@
+import type { Rut } from '../rut/index.js';
+import type { PortalDriver } from '../seams/index.js';
+/** One authorized DTE type row. `fecha*` keep SII's `DD-MM-YYYY` string verbatim
+ *  (ADR-004 — pass SII's data through unchanged); `fechaDesautorizacion` is null while
+ *  the type is currently authorized (empty cell). */
+export interface DteAutorizado {
+    readonly codigo: number;
+    readonly descripcion: string | null;
+    readonly fechaAutorizacion: string | null;
+    readonly fechaDesautorizacion: string | null;
+}
+/** Authorized-DTE-emitter report for one subject RUT (public consulta). `autorizado` is
+ *  true when the RUT is a registered DTE emisor (header + docs grid present); false when
+ *  SII answered with the "no corresponde" message — then `mensaje` holds that verbatim
+ *  sentence and `documentos` is empty. No `raw`: the HTML carries exactly these fields
+ *  (ADR-004 curated+raw is for fat JSON rows, not this table). */
+export interface DteAutorizados {
+    /** Subject RUT queried (canonical, e.g. "20000042-0"). */
+    readonly rut: string;
+    readonly autorizado: boolean;
+    readonly razonSocial: string | null;
+    readonly nResolucion: string | null;
+    readonly fechaResolucion: string | null;
+    readonly direccionRegional: string | null;
+    readonly documentos: readonly DteAutorizado[];
+    /** SII's verbatim "no autorizado" sentence; null on the authorized path. */
+    readonly mensaje: string | null;
+}
+/** List the DTE types a contribuyente is authorized to emit (public, login-free).
+ *  Hits the palena consulta CGI with no session, for ANY RUT incl. counterparties
+ *  (ADR-014). Returns the resolution header + authorized-document grid, or a clean
+ *  negative (`autorizado: false` + SII's verbatim `mensaje`) when the RUT is not a
+ *  registered DTE emisor. Throws `DteError` on a network/CGI failure, a non-200, or an
+ *  unrecognizable body. `driver` is the seam — NO `PortalSession` (it is session-less). */
+export declare function fetchDteAutorizados(driver: PortalDriver, rut: Rut): Promise<DteAutorizados>;
+//# sourceMappingURL=dte-public.d.ts.map

package/dist/portal/dte-public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dte-public.d.ts","sourceRoot":"","sources":["../../src/portal/dte-public.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,mBAAmB,CAAC;AAmBtE;;qDAEqD;AACrD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED;;;;kEAIkE;AAClE,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAkJD;;;;;2FAK2F;AAC3F,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAmBjG"}