@albertomarturelo/sii-core 0.3.0

package/dist/portal/dte-public.js

@@ -0,0 +1,192 @@
+// DTE — public consulta de empresas autorizadas a emitir DTE. Typed facade over the
+// UNAUTHENTICATED `PortalDriver.requestPublic` seam (ADR-014).
+//
+// The FIRST public/session-less portal surface. Unlike rcv/f22/f29, it does NOT ride
+// `withSession`: it issues a cold form-POST to the public palena CGI
+// (`/cvc_cgi/dte/ee_empresa_rut`), which returns a server-rendered HTML report for ANY
+// RUT — no login, no cookie, no session. Ported from the proven Python sii-cli
+// (portal/dte.py); the wire contract is first-hand-observed there, NOT a third-party
+// library (ADR-004). Full contract: docs/sii-contract/dte-authorized.md.
+//
+// Observed 2026-06-13, prod (palena.sii.cl): the response is `text/html;
+// charset=ISO-8859-1` (the seam decodes it), carrying a header block + a `<table>` of
+// authorized docs. No JSON envelope, no captcha. We parse the table rows in-house with
+// a small tag stripper — stdlib only, no third-party HTML library (ADR-004).
+import { HOSTS } from '../config/index.js';
+import { DteError } from '../errors/index.js';
+// `/cvc/dte/ee_empresas_dte.html` is the public HTML form; its validation JS rewrites
+// the submit target to this `/cvc_cgi/` CGI path (observed 2026-06-13). We POST the CGI
+// path directly — the static `ee_empresa_rut` path returns "NO SE ENCONTRÓ LA PÁGINA".
+const AUTORIZADOS_URL = `${HOSTS.dteWs}/cvc_cgi/dte/ee_empresa_rut`;
+// Origin/Referer mirror the public form page; neither is required (all headers confirmed
+// optional 2026-06-13), but sending them keeps the request indistinguishable from the form.
+const HEADERS = {
+    Origin: HOSTS.dteWs,
+    Referer: `${HOSTS.dteWs}/cvc/dte/ee_empresas_dte.html`,
+};
+// SII's verbatim "not an authorized emisor" sentence (observed 2026-06-13). Its presence
+// (with no docs table) is a CLEAN NEGATIVE — the RUT exists-or-not but is not a DTE emisor
+// — never an error (ADR-014). Matched as a lowercased substring on the decoded body.
+const NOT_AUTHORIZED_MARKER = 'no corresponde a una empresa autorizada';
+const messageOf = (e) => (e instanceof Error ? e.message : String(e));
+// Decode the handful of HTML entities SII's report can carry. The body is already
+// Latin-1-decoded by the seam, so most accents are real chars; numeric/named refs
+// (e.g. N&deg;, &oacute;) still appear and are normalised here. NAMED accent entities are
+// CASE-SENSITIVE (`&Eacute;` = É, `&eacute;` = é) — keep the cases distinct.
+const NAMED_ENTITIES = {
+    aacute: 'á',
+    eacute: 'é',
+    iacute: 'í',
+    oacute: 'ó',
+    uacute: 'ú',
+    ntilde: 'ñ',
+    Aacute: 'Á',
+    Eacute: 'É',
+    Iacute: 'Í',
+    Oacute: 'Ó',
+    Uacute: 'Ú',
+    Ntilde: 'Ñ',
+    deg: '°',
+    ordm: 'º',
+};
+function decodeEntities(s) {
+    return s
+        .replace(/&nbsp;/gi, ' ')
+        .replace(/&amp;/gi, '&')
+        .replace(/&lt;/gi, '<')
+        .replace(/&gt;/gi, '>')
+        .replace(/&quot;/gi, '"')
+        .replace(/&([A-Za-z]+);/g, (m, name) => NAMED_ENTITIES[name] ?? m)
+        .replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(Number(d)))
+        .replace(/&#x([0-9a-f]+);/gi, (_, h) => String.fromCodePoint(parseInt(h, 16)));
+}
+/** Collect every `<tr>` as a list of `<td>`/`<th>` cell texts (tags stripped, entities
+ *  decoded, whitespace collapsed, empty cells preserved). The tables are siblings (not
+ *  nested), so a flat row collector suffices — rows are classified by content downstream,
+ *  not by which table they came from (mirrors the Python `_TableRowParser`). */
+function tableRows(html) {
+    const rows = [];
+    const trRe = /<tr\b[^>]*>([\s\S]*?)<\/tr>/gi;
+    for (let tr = trRe.exec(html); tr !== null; tr = trRe.exec(html)) {
+        const cells = [];
+        const tdRe = /<t[dh]\b[^>]*>([\s\S]*?)<\/t[dh]>/gi;
+        const inner = tr[1] ?? '';
+        for (let td = tdRe.exec(inner); td !== null; td = tdRe.exec(inner)) {
+            const text = (td[1] ?? '').replace(/<[^>]*>/g, ' ');
+            cells.push(decodeEntities(text).replace(/\s+/g, ' ').trim());
+        }
+        if (cells.length > 0)
+            rows.push(cells);
+    }
+    return rows;
+}
+/** Map a header-table label cell to a logical field. Order matters: "Fecha Resolución"
+ *  also contains "resoluc", so test it before "N° Resolución" (mirrors Python). */
+function classifyHeaderLabel(label) {
+    const low = label.toLowerCase();
+    if (low.includes('fecha') && low.includes('resoluc'))
+        return 'fechaResolucion';
+    if (low.includes('resoluc'))
+        return 'nResolucion';
+    if (low === 'rut')
+        return 'rut';
+    if (low.includes('raz') && low.includes('social'))
+        return 'razonSocial';
+    if (low.includes('regional'))
+        return 'direccionRegional';
+    return null;
+}
+const cell = (cells, i) => {
+    const v = cells[i];
+    return v === undefined || v === '' ? null : v;
+};
+/** Pull SII's verbatim "no autorizado" sentence out of the HTML (ADR-004); falls back to
+ *  a fixed phrasing if the surrounding markup defeats cell extraction. */
+function notAuthorizedMessage(html) {
+    for (const row of tableRows(html)) {
+        for (const c of row) {
+            if (c.toLowerCase().includes(NOT_AUTHORIZED_MARKER))
+                return c;
+        }
+    }
+    return 'El rut que ha ingresado, no corresponde a una empresa autorizada a emitir Facturas Electronicas.';
+}
+/** Parse the decoded HTML report into a `DteAutorizados`. Throws `DteError` when the body
+ *  is neither a recognizable authorized report nor the known not-authorized message (the
+ *  portal HTML changed shape — "scraper roto", ADR-004). */
+function parseReport(html, subjectCanonical) {
+    if (html.toLowerCase().includes(NOT_AUTHORIZED_MARKER)) {
+        return {
+            rut: subjectCanonical,
+            autorizado: false,
+            razonSocial: null,
+            nResolucion: null,
+            fechaResolucion: null,
+            direccionRegional: null,
+            documentos: [],
+            mensaje: notAuthorizedMessage(html),
+        };
+    }
+    const header = {};
+    const documentos = [];
+    for (const cells of tableRows(html)) {
+        if (cells.length < 2)
+            continue;
+        const first = (cells[0] ?? '').trim();
+        if (/^\d+$/.test(first)) {
+            // A docs-grid row: [codigo, descripcion, autorizado, desautorizado].
+            documentos.push({
+                codigo: Number(first),
+                descripcion: cell(cells, 1),
+                fechaAutorizacion: cell(cells, 2),
+                fechaDesautorizacion: cell(cells, 3),
+            });
+            continue;
+        }
+        const logical = classifyHeaderLabel(first);
+        const value = cells[1];
+        if (logical && value !== undefined && header[logical] === undefined)
+            header[logical] = value;
+    }
+    if (header.rut === undefined && documentos.length === 0) {
+        throw new DteError('scraper roto: la respuesta del SII no trae ni la tabla de documentos autorizados ' +
+            'ni el mensaje de "no autorizado" esperado (la página pudo cambiar). ' +
+            `RUT consultado: ${subjectCanonical}.`);
+    }
+    return {
+        rut: subjectCanonical,
+        autorizado: true,
+        razonSocial: header.razonSocial ?? null,
+        nResolucion: header.nResolucion ?? null,
+        fechaResolucion: header.fechaResolucion ?? null,
+        direccionRegional: header.direccionRegional ?? null,
+        documentos,
+        mensaje: 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 async function fetchDteAutorizados(driver, rut) {
+    let response;
+    try {
+        response = await driver.requestPublic(AUTORIZADOS_URL, {
+            method: 'POST',
+            headers: HEADERS,
+            form: { RUT_EMP: String(rut.body), DV_EMP: rut.dv },
+        });
+    }
+    catch (e) {
+        throw new DteError(`No se pudo consultar el SII (${AUTORIZADOS_URL}): ${messageOf(e)}`);
+    }
+    // palena answers HTTP 200 for BOTH authorized and not-authorized; a non-200 is an
+    // infrastructure failure, not a user condition — fail loud, never retry (ADR-004).
+    if (response.status !== 200) {
+        throw new DteError(`El SII respondió HTTP ${response.status} a la consulta de DTE autorizados.`);
+    }
+    return parseReport(response.body, rut.canonical);
+}
+//# sourceMappingURL=dte-public.js.map

package/dist/portal/dte-public.js.map

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

package/dist/portal/f22/declaraciones.d.ts

@@ -0,0 +1,37 @@
+import type { Rut } from '../../rut/index.js';
+import type { Anio } from '../../periodo/index.js';
+import type { PortalSession } from '../../seams/index.js';
+import type { CodigoF22, F22Grupos } from '../f22-codigos.js';
+export interface DeclaracionF22 {
+    readonly folio: string | null;
+    readonly vigente: boolean | null;
+    readonly estado: string | null;
+    readonly fecha: string | null;
+    readonly tipoImpugnado: string | null;
+}
+/** Step 1 — the año's declaraciones + estado (no código grid). The overview surface. */
+export interface F22Declaraciones {
+    readonly rut: string;
+    readonly anio: string;
+    readonly tieneDeclaracion: boolean;
+    readonly declaraciones: readonly DeclaracionF22[];
+}
+/** Full readback for one (RUT, año): the selected declaración + its código grid (always
+ *  `f22Compacto`, identity/bank PII dropped). On a `--full` read `grupos` adds the contador
+ *  split over the SAME `codigos`; otherwise `grupos` is absent and the output is the flat grid. */
+export interface F22Estado extends F22Declaraciones {
+    readonly folio: string | null;
+    readonly estado: string | null;
+    readonly codigos: readonly CodigoF22[];
+    readonly grupos?: F22Grupos;
+}
+/** The folio to read when none is pinned: the first vigente declaración, else the
+ *  first with a folio, else null. */
+export declare function pickVigenteFolio(declaraciones: readonly DeclaracionF22[]): string | null;
+/** Step 1: `buscaDeclVgte` — the año's declaraciones + estado. Empty `decls` is a
+ *  legitimate "no declaración" (tieneDeclaracion=false), NOT an error. */
+export declare function fetchF22Declaraciones(session: PortalSession, params: {
+    rut: Rut;
+    anio: Anio;
+}): Promise<F22Declaraciones>;
+//# sourceMappingURL=declaraciones.d.ts.map

package/dist/portal/f22/declaraciones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaraciones.d.ts","sourceRoot":"","sources":["../../../src/portal/f22/declaraciones.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAa9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,SAAS,cAAc,EAAE,CAAC;CACnD;AAED;;mGAEmG;AACnG,MAAM,WAAW,SAAU,SAAQ,gBAAgB;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;CAC7B;AAuDD;qCACqC;AACrC,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,GAAG,IAAI,CAMxF;AAED;0EAC0E;AAC1E,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAa3B"}

package/dist/portal/f22/declaraciones.js

@@ -0,0 +1,86 @@
+import { F22_BASE, aliasGet, asStr, isObj, postSdi, rutDigits } from './shared.js';
+const BUSCA_DECL_URL = `${F22_BASE}/buscaDeclVgte`;
+// Namespace was best-guess from the SDI pattern (área renta / app consultaestadof22);
+// SII ACCEPTED it live 2026-06-27 (returned the real código grid). The URL path routes.
+const BUSCA_DECL_NAMESPACE = 'cl.sii.sdi.lob.renta.consultaestadof22.data.api.interfaces.FacadeService/buscaDeclVgte';
+const DECL_ALIASES = {
+    folio: ['folio', 'folioDeclaracion'],
+    vgte: ['vgte', 'vigente'],
+    codConc: ['codConc', 'codConclusion'],
+    fecha: ['fecIng', 'fechaIngreso', 'fecha'],
+    tipoImpugnado: ['tipoImpugnado'],
+};
+const GLOSA_ALIASES = {
+    codConc: ['codConclusion', 'codConc'],
+    descripcion: ['descripcion', 'glosa'],
+};
+/** `vgte` arrives as "S"/"N", a bool, or 1/0 (exact form unconfirmed). Tolerant. */
+function coerceVigente(v) {
+    if (v === null || v === undefined)
+        return null;
+    if (typeof v === 'boolean')
+        return v;
+    const s = String(v).trim().toUpperCase();
+    if (['S', 'SI', 'TRUE', '1', 'VIGENTE'].includes(s))
+        return true;
+    if (['N', 'NO', 'FALSE', '0'].includes(s))
+        return false;
+    return null;
+}
+/** Map `glosas[]` (codConclusion → descripción) so a decl's codConc resolves to its
+ *  human estado label. */
+function glosaMap(data) {
+    const out = new Map();
+    const glosas = isObj(data) ? data['glosas'] : undefined;
+    if (!Array.isArray(glosas))
+        return out;
+    for (const g of glosas) {
+        if (!isObj(g))
+            continue;
+        const cod = asStr(aliasGet(g, GLOSA_ALIASES.codConc));
+        const desc = asStr(aliasGet(g, GLOSA_ALIASES.descripcion));
+        if (cod !== null && desc !== null)
+            out.set(cod, desc);
+    }
+    return out;
+}
+function buildDeclaraciones(data) {
+    const decls = isObj(data) ? data['decls'] : undefined;
+    if (!Array.isArray(decls))
+        return [];
+    const glosas = glosaMap(data);
+    return decls.filter(isObj).map((d) => {
+        const codConc = asStr(aliasGet(d, DECL_ALIASES.codConc));
+        return {
+            folio: asStr(aliasGet(d, DECL_ALIASES.folio)),
+            vigente: coerceVigente(aliasGet(d, DECL_ALIASES.vgte)),
+            estado: codConc !== null ? (glosas.get(codConc) ?? null) : null,
+            fecha: asStr(aliasGet(d, DECL_ALIASES.fecha)),
+            tipoImpugnado: asStr(aliasGet(d, DECL_ALIASES.tipoImpugnado)),
+        };
+    });
+}
+/** The folio to read when none is pinned: the first vigente declaración, else the
+ *  first with a folio, else null. */
+export function pickVigenteFolio(declaraciones) {
+    return (declaraciones.find((d) => d.vigente && d.folio !== null)?.folio ??
+        declaraciones.find((d) => d.folio !== null)?.folio ??
+        null);
+}
+/** Step 1: `buscaDeclVgte` — the año's declaraciones + estado. Empty `decls` is a
+ *  legitimate "no declaración" (tieneDeclaracion=false), NOT an error. */
+export async function fetchF22Declaraciones(session, params) {
+    const { rut, anio } = params;
+    const env = await postSdi(session, BUSCA_DECL_URL, BUSCA_DECL_NAMESPACE, {
+        periodo: anio.canonical,
+        ...rutDigits(rut),
+    });
+    const declaraciones = buildDeclaraciones(env.data);
+    return {
+        rut: rut.canonical,
+        anio: anio.canonical,
+        tieneDeclaracion: declaraciones.length > 0,
+        declaraciones,
+    };
+}
+//# sourceMappingURL=declaraciones.js.map

package/dist/portal/f22/declaraciones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaraciones.js","sourceRoot":"","sources":["../../../src/portal/f22/declaraciones.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnF,MAAM,cAAc,GAAG,GAAG,QAAQ,gBAAgB,CAAC;AACnD,sFAAsF;AACtF,wFAAwF;AACxF,MAAM,oBAAoB,GACxB,wFAAwF,CAAC;AAgC3F,MAAM,YAAY,GAAG;IACnB,KAAK,EAAE,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACpC,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;IACzB,OAAO,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC;IACrC,KAAK,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC;IAC1C,aAAa,EAAE,CAAC,eAAe,CAAC;CACxB,CAAC;AACX,MAAM,aAAa,GAAG;IACpB,OAAO,EAAE,CAAC,eAAe,EAAE,SAAS,CAAC;IACrC,WAAW,EAAE,CAAC,aAAa,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEX,oFAAoF;AACpF,SAAS,aAAa,CAAC,CAAU;IAC/B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;0BAC0B;AAC1B,SAAS,QAAQ,CAAC,IAAa;IAC7B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,GAAG,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,SAAS;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;QAC3D,IAAI,GAAG,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAa;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACzD,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC7C,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;YAC/D,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC7C,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;SAC9D,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;qCACqC;AACrC,MAAM,UAAU,gBAAgB,CAAC,aAAwC;IACvE,OAAO,CACL,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,KAAK;QAC/D,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,KAAK;QAClD,IAAI,CACL,CAAC;AACJ,CAAC;AAED;0EAC0E;AAC1E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAsB,EACtB,MAAgC;IAEhC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAC7B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE;QACvE,OAAO,EAAE,IAAI,CAAC,SAAS;QACvB,GAAG,SAAS,CAAC,GAAG,CAAC;KAClB,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,SAAS;QAClB,IAAI,EAAE,IAAI,CAAC,SAAS;QACpB,gBAAgB,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC;QAC1C,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/portal/f22/grid.d.ts

@@ -0,0 +1,14 @@
+import type { Rut } from '../../rut/index.js';
+import type { Anio } from '../../periodo/index.js';
+import type { PortalSession } from '../../seams/index.js';
+import type { CodigoF22 } from '../f22-codigos.js';
+/** `f22Compacto` — the código grid for a folio, MINUS identity/bank PII. This IS the form the
+ *  SII renders (and its PDF); `--full` just adds the contador grouping over the same data via
+ *  `groupCodigos` (the sibling `f22Completo` only adds internal control códigos — noisier, not
+ *  richer — so it is not used). */
+export declare function fetchF22Grid(session: PortalSession, params: {
+    rut: Rut;
+    anio: Anio;
+    folio: string;
+}): Promise<CodigoF22[]>;
+//# sourceMappingURL=grid.d.ts.map

package/dist/portal/f22/grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../src/portal/f22/grid.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAqCnD;;;mCAGmC;AACnC,wBAAsB,YAAY,CAChC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,SAAS,EAAE,CAAC,CAQtB"}

package/dist/portal/f22/grid.js

@@ -0,0 +1,51 @@
+// The código taxonomy (PII denylist + contador grouping) lives in its own domain module —
+// it changes when we observe a new código, not when the wire changes.
+import { isHeaderCodigo } from '../f22-codigos.js';
+import { F22_BASE, aliasGet, asNumber, asStr, isObj, postSdi, rutDigits } from './shared.js';
+const F22_COMPACTO_URL = `${F22_BASE}/f22Compacto`;
+const F22_COMPACTO_NAMESPACE = 'cl.sii.sdi.lob.renta.consultaestadof22.data.api.interfaces.FacadeService/f22Compacto';
+// NOTE on `f22Completo`: a sibling endpoint exists, but live capture (spike #27, 2026-06-29)
+// showed it returns f22Compacto's códigos PLUS internal control códigos (3056/8891/8865…) and
+// extra PII (9306/9920) — i.e. NOISIER, not richer in tax content. The real "formulario
+// completo" the SII renders (and its PDF) is built from `f22Compacto` + `codigosFormato` (the
+// form skeleton). So `--full` reads `f22Compacto` (same source as the compact view) and adds
+// the contador grouping — it does NOT use f22Completo. (ADR-004: first-hand obs over the port.)
+const CODIGO_ALIASES = {
+    codigo: ['codigo', 'cod'],
+    valor: ['valor', 'monto'],
+    glosa: ['glosa', 'descripcion'],
+};
+/** Project a código grid (`data:[{codigo,valor,glosa}]`) into rows, DROPPING the
+ *  identity/bank PII códigos (HEADER_CODIGOS). Sign preserved. */
+function parseCodigoGrid(data) {
+    if (!Array.isArray(data))
+        return [];
+    const out = [];
+    for (const r of data) {
+        if (!isObj(r))
+            continue;
+        const codigo = asStr(aliasGet(r, CODIGO_ALIASES.codigo));
+        if (codigo === null || isHeaderCodigo(codigo))
+            continue; // drop identity/bank PII
+        out.push({
+            codigo,
+            valor: asNumber(aliasGet(r, CODIGO_ALIASES.valor)),
+            glosa: asStr(aliasGet(r, CODIGO_ALIASES.glosa)),
+        });
+    }
+    return out;
+}
+/** `f22Compacto` — the código grid for a folio, MINUS identity/bank PII. This IS the form the
+ *  SII renders (and its PDF); `--full` just adds the contador grouping over the same data via
+ *  `groupCodigos` (the sibling `f22Completo` only adds internal control códigos — noisier, not
+ *  richer — so it is not used). */
+export async function fetchF22Grid(session, params) {
+    const { rut, anio, folio } = params;
+    const env = await postSdi(session, F22_COMPACTO_URL, F22_COMPACTO_NAMESPACE, {
+        ...rutDigits(rut),
+        periodo: anio.canonical,
+        folio,
+    });
+    return parseCodigoGrid(env.data);
+}
+//# sourceMappingURL=grid.js.map

package/dist/portal/f22/grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.js","sourceRoot":"","sources":["../../../src/portal/f22/grid.ts"],"names":[],"mappings":"AAMA,0FAA0F;AAC1F,sEAAsE;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7F,MAAM,gBAAgB,GAAG,GAAG,QAAQ,cAAc,CAAC;AACnD,MAAM,sBAAsB,GAC1B,sFAAsF,CAAC;AACzF,6FAA6F;AAC7F,8FAA8F;AAC9F,wFAAwF;AACxF,8FAA8F;AAC9F,6FAA6F;AAC7F,gGAAgG;AAEhG,MAAM,cAAc,GAAG;IACrB,MAAM,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;CACvB,CAAC;AAEX;kEACkE;AAClE,SAAS,eAAe,CAAC,IAAa;IACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,SAAS;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD,IAAI,MAAM,KAAK,IAAI,IAAI,cAAc,CAAC,MAAM,CAAC;YAAE,SAAS,CAAC,yBAAyB;QAClF,GAAG,CAAC,IAAI,CAAC;YACP,MAAM;YACN,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;YAClD,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;SAChD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;mCAGmC;AACnC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAsB,EACtB,MAA+C;IAE/C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE;QAC3E,GAAG,SAAS,CAAC,GAAG,CAAC;QACjB,OAAO,EAAE,IAAI,CAAC,SAAS;QACvB,KAAK;KACN,CAAC,CAAC;IACH,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/portal/f22/historial.d.ts

@@ -0,0 +1,34 @@
+import type { Rut } from '../../rut/index.js';
+import type { Anio } from '../../periodo/index.js';
+import type { PortalSession } from '../../seams/index.js';
+/** One event in a declaración's historial (`buscaEventos`). NOT PII — every field is a
+ *  tax-process datum: the event code/glosa, dates, and carta/notification references. The
+ *  monto rides inside `glosa` as verbatim SII text (tax content, not identity/bank), so the
+ *  row is fully curated — no header exclusion, no `raw`. */
+export interface EventoF22 {
+    readonly folio: string | null;
+    readonly codigo: string;
+    readonly glosa: string | null;
+    readonly fecha: string | null;
+    readonly tipo: string | null;
+    readonly codCarta: string | null;
+    readonly idCarta: string | null;
+    readonly referencia: string | null;
+    readonly fechaCitacion: string | null;
+    readonly unidadSii: string | null;
+}
+/** Sort key for an event's `fecha` (DD/MM/YYYY) → numeric YYYYMMDD for most-recent-first
+ *  ordering. Undated / unparseable events sink to the bottom (−∞). Exported for the task,
+ *  which sorts the aggregate across folios. */
+export declare function eventoDateKey(fecha: string | null): number;
+/** `buscaEventos` — the historial/eventos timeline for ONE folio (the folio is REQUIRED;
+ *  omitting it returns a RESTEASY 500). Rows carry NO identity/bank PII (event code + glosa
+ *  + dates + carta refs), so all are curated, nothing excluded, no `raw`. Wire order is
+ *  oldest-first; the task aggregates across folios and sorts most-recent-first. Empty/non-array
+ *  data = sin eventos (NOT an error). All params sent as strings (like buscaDeclVgte). */
+export declare function fetchF22Historial(session: PortalSession, params: {
+    rut: Rut;
+    anio: Anio;
+    folio: string;
+}): Promise<EventoF22[]>;
+//# sourceMappingURL=historial.d.ts.map

package/dist/portal/f22/historial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historial.d.ts","sourceRoot":"","sources":["../../../src/portal/f22/historial.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAO1D;;;4DAG4D;AAC5D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAiBD;;+CAE+C;AAC/C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAK1D;AAED;;;;0FAI0F;AAC1F,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,SAAS,EAAE,CAAC,CA4BtB"}

package/dist/portal/f22/historial.js

@@ -0,0 +1,66 @@
+import { F22_BASE, aliasGet, asStr, postSdi, rutDigits, trimToNull, isObj } from './shared.js';
+const BUSCA_EVENTOS_URL = `${F22_BASE}/buscaEventos`;
+const BUSCA_EVENTOS_NAMESPACE = 'cl.sii.sdi.lob.renta.consultaestadof22.data.api.interfaces.FacadeService/buscaEventos';
+const EVENTO_ALIASES = {
+    folio: ['folio'],
+    // The event-type code is `codEvento`; the row ALSO carries an unrelated `codigo` (a long
+    // internal id), so `codEvento` MUST come first.
+    codigo: ['codEvento', 'codigo'],
+    glosa: ['nombre', 'glosa', 'descripcion'],
+    fecha: ['fechaEvento', 'fecha'],
+    tipo: ['tipoEvento', 'tipo'],
+    codCarta: ['codCarta'],
+    idCarta: ['idCarta'],
+    referencia: ['referencia'],
+    fechaCitacion: ['fechaCitacion'],
+    unidadSii: ['unidadSii'],
+};
+/** Sort key for an event's `fecha` (DD/MM/YYYY) → numeric YYYYMMDD for most-recent-first
+ *  ordering. Undated / unparseable events sink to the bottom (−∞). Exported for the task,
+ *  which sorts the aggregate across folios. */
+export function eventoDateKey(fecha) {
+    if (fecha === null)
+        return Number.NEGATIVE_INFINITY;
+    const m = /^(\d{2})\/(\d{2})\/(\d{4})$/.exec(fecha.trim());
+    if (!m)
+        return Number.NEGATIVE_INFINITY;
+    return Number(`${m[3]}${m[2]}${m[1]}`);
+}
+/** `buscaEventos` — the historial/eventos timeline for ONE folio (the folio is REQUIRED;
+ *  omitting it returns a RESTEASY 500). Rows carry NO identity/bank PII (event code + glosa
+ *  + dates + carta refs), so all are curated, nothing excluded, no `raw`. Wire order is
+ *  oldest-first; the task aggregates across folios and sorts most-recent-first. Empty/non-array
+ *  data = sin eventos (NOT an error). All params sent as strings (like buscaDeclVgte). */
+export async function fetchF22Historial(session, params) {
+    const { rut, anio, folio } = params;
+    const env = await postSdi(session, BUSCA_EVENTOS_URL, BUSCA_EVENTOS_NAMESPACE, {
+        periodo: anio.canonical,
+        ...rutDigits(rut),
+        folio,
+    });
+    const rows = env.data;
+    if (!Array.isArray(rows))
+        return [];
+    const out = [];
+    for (const r of rows) {
+        if (!isObj(r))
+            continue;
+        const codigo = asStr(aliasGet(r, EVENTO_ALIASES.codigo));
+        if (codigo === null)
+            continue;
+        out.push({
+            folio: asStr(aliasGet(r, EVENTO_ALIASES.folio)),
+            codigo,
+            glosa: asStr(aliasGet(r, EVENTO_ALIASES.glosa)), // verbatim (ADR-004) — may embed the monto
+            fecha: asStr(aliasGet(r, EVENTO_ALIASES.fecha)),
+            tipo: asStr(aliasGet(r, EVENTO_ALIASES.tipo)),
+            codCarta: asStr(aliasGet(r, EVENTO_ALIASES.codCarta)),
+            idCarta: asStr(aliasGet(r, EVENTO_ALIASES.idCarta)),
+            referencia: trimToNull(aliasGet(r, EVENTO_ALIASES.referencia)),
+            fechaCitacion: trimToNull(aliasGet(r, EVENTO_ALIASES.fechaCitacion)),
+            unidadSii: trimToNull(aliasGet(r, EVENTO_ALIASES.unidadSii)),
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=historial.js.map

package/dist/portal/f22/historial.js.map

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

package/dist/portal/f22/index.d.ts

@@ -0,0 +1,7 @@
+export { fetchF22Declaraciones, pickVigenteFolio, type DeclaracionF22, type F22Declaraciones, type F22Estado, } from './declaraciones.js';
+export { fetchF22Grid } from './grid.js';
+export { fetchF22Observaciones, type ObservacionF22 } from './observaciones.js';
+export { eventoDateKey, fetchF22Historial, type EventoF22 } from './historial.js';
+export { groupCodigos, isHeaderCodigo } from '../f22-codigos.js';
+export type { CodigoF22, F22Grupos } from '../f22-codigos.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/portal/f22/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/portal/f22/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,SAAS,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGlF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/portal/f22/index.js

@@ -0,0 +1,11 @@
+// The F22 facade, split per view (shared wire plumbing in shared.ts). This barrel
+// preserves the public surface the tasks import — same names as the pre-split
+// single-file facade.
+export { fetchF22Declaraciones, pickVigenteFolio, } from './declaraciones.js';
+export { fetchF22Grid } from './grid.js';
+export { fetchF22Observaciones } from './observaciones.js';
+export { eventoDateKey, fetchF22Historial } from './historial.js';
+// The código taxonomy (PII denylist + contador grouping) — re-exported so the public
+// surface is unchanged.
+export { groupCodigos, isHeaderCodigo } from '../f22-codigos.js';
+//# sourceMappingURL=index.js.map

package/dist/portal/f22/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/portal/f22/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,8EAA8E;AAC9E,sBAAsB;AACtB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GAIjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAuB,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAkB,MAAM,gBAAgB,CAAC;AAClF,qFAAqF;AACrF,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/portal/f22/observaciones.d.ts

@@ -0,0 +1,20 @@
+import type { Rut } from '../../rut/index.js';
+import type { Anio } from '../../periodo/index.js';
+import type { PortalSession } from '../../seams/index.js';
+/** One observación (inconsistencia) on a declaración. NOT PII — observación code + glosa
+ *  + the SII ayuda URL — so every field is curated (no header-código exclusion, no `raw`). */
+export interface ObservacionF22 {
+    readonly codigo: string;
+    readonly descripcion: string | null;
+    readonly url: string | null;
+}
+/** `situacionObservacion` — the observaciones (inconsistencias) for a folio. Rows carry
+ *  NO PII (observación code + glosa + ayuda URL), so all are curated and nothing is
+ *  excluded; empty `data` = sin observaciones (NOT an error). Observed 2026-06-29 (#26):
+ *  the request sends NUMERIC `periodo`/`folio`. */
+export declare function fetchF22Observaciones(session: PortalSession, params: {
+    rut: Rut;
+    anio: Anio;
+    folio: string;
+}): Promise<ObservacionF22[]>;
+//# sourceMappingURL=observaciones.d.ts.map

package/dist/portal/f22/observaciones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observaciones.d.ts","sourceRoot":"","sources":["../../../src/portal/f22/observaciones.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAO1D;8FAC8F;AAC9F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAQD;;;mDAGmD;AACnD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,cAAc,EAAE,CAAC,CAqB3B"}

package/dist/portal/f22/observaciones.js

@@ -0,0 +1,38 @@
+import { F22_BASE, aliasGet, asStr, isObj, postSdi, rutDigits } from './shared.js';
+const SITUACION_OBS_URL = `${F22_BASE}/situacionObservacion`;
+const SITUACION_OBS_NAMESPACE = 'cl.sii.sdi.lob.renta.consultaestadof22.data.api.interfaces.FacadeService/situacionObservacion';
+const OBSERVACION_ALIASES = {
+    codigo: ['codigo', 'cod'],
+    descripcion: ['descripcion', 'glosa'],
+    url: ['url', 'link'],
+};
+/** `situacionObservacion` — the observaciones (inconsistencias) for a folio. Rows carry
+ *  NO PII (observación code + glosa + ayuda URL), so all are curated and nothing is
+ *  excluded; empty `data` = sin observaciones (NOT an error). Observed 2026-06-29 (#26):
+ *  the request sends NUMERIC `periodo`/`folio`. */
+export async function fetchF22Observaciones(session, params) {
+    const { rut, anio, folio } = params;
+    const env = await postSdi(session, SITUACION_OBS_URL, SITUACION_OBS_NAMESPACE, {
+        periodo: Number(anio.canonical),
+        ...rutDigits(rut),
+        folio: Number(folio),
+    });
+    const rows = env.data;
+    if (!Array.isArray(rows))
+        return [];
+    const out = [];
+    for (const r of rows) {
+        if (!isObj(r))
+            continue;
+        const codigo = asStr(aliasGet(r, OBSERVACION_ALIASES.codigo));
+        if (codigo === null)
+            continue;
+        out.push({
+            codigo,
+            descripcion: asStr(aliasGet(r, OBSERVACION_ALIASES.descripcion)),
+            url: asStr(aliasGet(r, OBSERVACION_ALIASES.url)),
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=observaciones.js.map

package/dist/portal/f22/observaciones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observaciones.js","sourceRoot":"","sources":["../../../src/portal/f22/observaciones.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnF,MAAM,iBAAiB,GAAG,GAAG,QAAQ,uBAAuB,CAAC;AAC7D,MAAM,uBAAuB,GAC3B,+FAA+F,CAAC;AAUlG,MAAM,mBAAmB,GAAG;IAC1B,MAAM,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,WAAW,EAAE,CAAC,aAAa,EAAE,OAAO,CAAC;IACrC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;CACZ,CAAC;AAEX;;;mDAGmD;AACnD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAsB,EACtB,MAA+C;IAE/C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE;QAC7E,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QAC/B,GAAG,SAAS,CAAC,GAAG,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;KACrB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,SAAS;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9D,IAAI,MAAM,KAAK,IAAI;YAAE,SAAS;QAC9B,GAAG,CAAC,IAAI,CAAC;YACP,MAAM;YACN,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;YAChE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC;SACjD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}