@albertomarturelo/sii-mcp 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -9,6 +9,32 @@ Versions move in **lockstep** with `@albertomarturelo/sii-core` and
 (ADR-003), so the domain detail behind each entry lives in the
 [core changelog](../core/CHANGELOG.md).
 
+## 0.8.0 — 2026-09-09
+
+### Added
+
+- **The Portal MIPYME DTE tools (#90, #91, ADR-023)** — `dte_empresas`,
+  `dte_borrador_list`, `dte_borrador_save`, `dte_borrador_delete`, `dte_preview_pdf`,
+  `dte_emitidos` and `dte_pdf`. They cover preparing a factura on SII's free facturación
+  portal and reading what an empresa has already emitted. **Empresa-keyed:** `empresa` is
+  validated against the portal's own authorized list, not the operate pointer.
+- **The emission step is not exposed, by design (ADR-023).** Signing on this portal is
+  server-side and needs no certificate, so a Clave alone would be enough to issue a legally
+  binding document. No tool reaches it — the model can prepare and preview a factura, and
+  the irreversible click stays with a human in SII's own UI.
+- **`dte_borrador_delete` carries `destructiveHint` and an explicit `confirmar`.** Saving a
+  borrador does not: it is reversible and legally inert, so it needs no confirm ceremony
+  (ADR-023). Deleting one is irreversible, so it gets the gate.
+- **`dte_preview_pdf` and `dte_pdf` return only a path and a size**, never the document
+  (ADR-022 / ADR-006) — the file holds counterparty identity and amounts, so its contents
+  stay out of the model's context. Both tool descriptions say so.
+
+### Changed
+
+- **The MIPYME tools are prefixed `dte_`, not `factura_` (ADR-024).** The prefix is the SII
+  artifact, and a factura is DTE 33. The `factura_` spelling was never published, so no
+  released tool was renamed.
+
 ## 0.7.0 — 2026-08-31
 
 ### Added

package/dist/tools/dte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dte.d.ts","sourceRoot":"","sources":["../../src/tools/dte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAGzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAgB1E"}
+{"version":3,"file":"dte.d.ts","sourceRoot":"","sources":["../../src/tools/dte.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAYL,KAAK,OAAO,EACb,MAAM,4BAA4B,CAAC;AA0FpC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA0M1E"}

package/dist/tools/dte.js

@@ -1,6 +1,63 @@
 import { z } from 'zod';
-import { dteAuthorized } from '@albertomarturelo/sii-core';
+import { MAX_ITEMS, dteAuthorized, dteBorradorDelete, dteBorradorList, dteBorradorSave, dteEmitidos, dteEmpresas, dtePdf, dtePreviewPdf, } from '@albertomarturelo/sii-core';
+import { DOCUMENTOS_DIR } from '@albertomarturelo/sii-core/node';
+import { join } from 'node:path';
 import { toolText } from '../tool-helpers.js';
+const documentoFields = {
+    empresa: z.string().describe('RUT de la empresa emisora (de `dte_empresas`).'),
+    tipoDte: z.number().int().optional().describe('33 factura afecta (por defecto), 34 exenta.'),
+    fechaEmision: z.string().optional().describe('YYYY-MM-DD; por defecto hoy.'),
+    ciudadEmisor: z
+        .string()
+        .describe('Ciudad del emisor. El SII la exige y NO la trae precargada en el formulario.'),
+    receptor: z.object({
+        rut: z.string(),
+        razonSocial: z.string(),
+        direccion: z.string(),
+        comuna: z.string(),
+        ciudad: z.string(),
+        giro: z.string(),
+        contacto: z.string().optional(),
+    }),
+    items: z
+        .array(z.object({
+        nombre: z.string(),
+        descripcion: z.string().optional(),
+        cantidad: z.number().positive(),
+        unidad: z.string().optional(),
+        precioUnitario: z.number().int().positive(),
+        descuentoPct: z.number().min(0).max(99).optional(),
+    }))
+        .min(1)
+        .max(MAX_ITEMS),
+    formaPago: z.enum(['contado', 'credito', 'sin_costo']).optional(),
+    borradorId: z.string().optional().describe('Actualiza/previsualiza ESTE borrador.'),
+};
+const toArgs = (i) => ({
+    empresa: i.empresa,
+    ciudadEmisor: i.ciudadEmisor,
+    receptor: {
+        rut: i.receptor.rut,
+        razonSocial: i.receptor.razonSocial,
+        direccion: i.receptor.direccion,
+        comuna: i.receptor.comuna,
+        ciudad: i.receptor.ciudad,
+        giro: i.receptor.giro,
+        ...(i.receptor.contacto !== undefined ? { contacto: i.receptor.contacto } : {}),
+    },
+    items: i.items.map((it) => ({
+        nombre: it.nombre,
+        cantidad: it.cantidad,
+        precioUnitario: it.precioUnitario,
+        ...(it.descripcion !== undefined ? { descripcion: it.descripcion } : {}),
+        ...(it.unidad !== undefined ? { unidad: it.unidad } : {}),
+        ...(it.descuentoPct !== undefined ? { descuentoPct: it.descuentoPct } : {}),
+    })),
+    ...(i.tipoDte !== undefined ? { tipoDte: i.tipoDte } : {}),
+    ...(i.fechaEmision !== undefined ? { fechaEmision: i.fechaEmision } : {}),
+    ...(i.formaPago !== undefined ? { formaPago: i.formaPago } : {}),
+    ...(i.borradorId !== undefined ? { borradorId: i.borradorId } : {}),
+});
 export function registerDteTools(server, runtime) {
     server.registerTool('dte_authorized', {
         title: 'DTE autorizados (consulta pública)',
@@ -11,5 +68,105 @@ export function registerDteTools(server, runtime) {
         inputSchema: { rut: z.string() },
         annotations: { readOnlyHint: true },
     }, ({ rut }) => toolText(async () => JSON.stringify(await dteAuthorized(runtime, { rut }), null, 2)));
+    server.registerTool('dte_emitidos', {
+        description: 'Empresa-keyed (--empresa validado contra el Portal MIPYME). Documentos tributarios ya EMITIDOS por una empresa en el Portal MIPYME (facturas,  ' +
+            'Sólo lo emitido vía el Portal MIPYME, con acceso a su PDF; para el REGISTRO del SII de ' +
+            'todo lo emitido por cualquier software, usa rcv_list.' +
+            'notas de crédito/débito, guías…). Sólo lectura: no emite ni firma nada. Expone datos ' +
+            'del RECEPTOR (RUT y razón social), folio y montos — PII de terceros.',
+        inputSchema: {
+            empresa: z.string(),
+            tipoDoc: z.number().int().optional().describe('33, 34, 61, 52, …'),
+            estado: z.enum(['emitido', 'preview']).optional(),
+            folio: z.number().int().positive().optional(),
+            receptor: z.string().optional(),
+            desde: z.string().optional().describe('YYYY-MM-DD'),
+            hasta: z.string().optional().describe('YYYY-MM-DD'),
+            pagina: z.number().int().positive().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, async (input) => toolText(async () => JSON.stringify(await dteEmitidos(runtime, input), null, 2)));
+    server.registerTool('dte_pdf', {
+        description: 'Empresa-keyed (--empresa validado contra el Portal MIPYME). Descarga el PDF de un documento ya EMITIDO, por folio. Devuelve la RUTA del archivo, ' +
+            'nunca su contenido: el documento es PII densa (identidad de ambas partes y montos) y ' +
+            'no debe entrar al contexto del modelo. Sólo lectura: no emite ni firma nada.',
+        inputSchema: {
+            empresa: z.string(),
+            folio: z.number().int().positive(),
+            directorio: z
+                .string()
+                .optional()
+                .describe('Carpeta destino; por defecto ~/.sii/documentos/factura.'),
+        },
+        annotations: { readOnlyHint: false },
+    }, async ({ empresa, folio, directorio }) => toolText(async () => JSON.stringify(await dtePdf(runtime, {
+        empresa,
+        folio,
+        directorio: directorio ?? join(DOCUMENTOS_DIR, 'dte'),
+    }), null, 2)));
+    server.registerTool('dte_empresas', {
+        description: 'Empresa-keyed. Empresas para las que el usuario está autorizado a facturar en el Portal MIPYME del ' +
+            'SII. Es la lista viva del portal — su propio dominio de valores, distinto del puntero ' +
+            '`operate`. Expone razón social (PII) de las empresas del usuario.',
+        inputSchema: { tipoDte: z.number().int().optional() },
+        annotations: { readOnlyHint: true },
+    }, async ({ tipoDte }) => toolText(async () => JSON.stringify(await dteEmpresas(runtime, { ...(tipoDte !== undefined ? { tipoDte } : {}) }), null, 2)));
+    server.registerTool('dte_borrador_list', {
+        description: 'Empresa-keyed (--empresa validado contra el Portal MIPYME). Borradores de factura guardados de una empresa en el Portal MIPYME. Devuelve los de ' +
+            'TODOS los tipos de DTE (`tipoDte` va en cada fila); `tipoDte` aquí sólo indica con qué ' +
+            'tipo se abre el portal, NO filtra. Expone datos del RECEPTOR (RUT y razón social) y ' +
+            'los montos de cada borrador — PII de terceros.',
+        inputSchema: { empresa: z.string(), tipoDte: z.number().int().optional() },
+        annotations: { readOnlyHint: true },
+    }, async ({ empresa, tipoDte }) => toolText(async () => JSON.stringify(await dteBorradorList(runtime, {
+        empresa,
+        ...(tipoDte !== undefined ? { tipoDte } : {}),
+    }), null, 2)));
+    server.registerTool('dte_borrador_save', {
+        description: 'Empresa-keyed (--empresa validado contra el Portal MIPYME). Guarda una factura como BORRADOR en el Portal MIPYME (crea uno nuevo, o actualiza el ' +
+            'indicado en `borradorId`). NO emite ni firma: el borrador no es un documento ' +
+            'tributario, no tiene folio y no tiene efecto legal. El SII valida el documento y sus ' +
+            'mensajes se devuelven textuales.',
+        inputSchema: documentoFields,
+        // A borrador is reversible (dte_borrador_delete) and never legally binding, so it is
+        // NOT destructive — unlike `bte_emit`. It is still a write, so not readOnly either.
+        annotations: { idempotentHint: false },
+    }, async (input) => toolText(async () => JSON.stringify(await dteBorradorSave(runtime, toArgs(input)), null, 2)));
+    server.registerTool('dte_borrador_delete', {
+        description: 'Empresa-keyed (--empresa validado contra el Portal MIPYME). Elimina un borrador de factura del Portal MIPYME. Irreversible: el borrador no se ' +
+            'puede recuperar. Requiere `confirmar: true`. `tipoDte` es opcional — se resuelve del ' +
+            'propio borrador.',
+        inputSchema: {
+            empresa: z.string(),
+            borradorId: z.string(),
+            tipoDte: z.number().int().optional(),
+            confirmar: z.literal(true).describe('Debe ser true: confirma el borrado irreversible.'),
+        },
+        annotations: { destructiveHint: true },
+    }, async ({ empresa, borradorId, tipoDte }) => toolText(async () => JSON.stringify(await dteBorradorDelete(runtime, {
+        empresa,
+        borradorId,
+        ...(tipoDte !== undefined ? { tipoDte } : {}),
+    }), null, 2)));
+    server.registerTool('dte_preview_pdf', {
+        description: 'Empresa-keyed (--empresa validado contra el Portal MIPYME). Descarga el PDF de vista previa de una factura NO emitida ("Validar y visualizar"). ' +
+            'El PDF va estampado "VISTA PREVIA / DOCUMENTO NO VALIDO" y sin folio. Devuelve la RUTA ' +
+            'del archivo, nunca su contenido: el documento es PII densa (identidad de ambas partes ' +
+            'y montos) y no debe entrar al contexto del modelo.',
+        inputSchema: {
+            ...documentoFields,
+            directorio: z
+                .string()
+                .optional()
+                .describe('Carpeta destino; por defecto ~/.sii/documentos/factura.'),
+        },
+        annotations: { readOnlyHint: false },
+    }, async (input) => {
+        const { directorio, ...doc } = input;
+        return toolText(async () => JSON.stringify(await dtePreviewPdf(runtime, {
+            ...toArgs(doc),
+            directorio: directorio ?? join(DOCUMENTOS_DIR, 'dte'),
+        }), null, 2));
+    });
 }
 //# sourceMappingURL=dte.js.map

package/dist/tools/dte.js.map

@@ -1 +1 @@
-{"version":3,"file":"dte.js","sourceRoot":"","sources":["../../src/tools/dte.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAgB,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,OAAgB;IAClE,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,oCAAoC;QAC3C,WAAW,EACT,wFAAwF;YACxF,wFAAwF;YACxF,uFAAuF;YACvF,2DAA2D;QAC7D,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;QAChC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CACV,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,aAAa,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CACvF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"dte.js","sourceRoot":"","sources":["../../src/tools/dte.ts"],"names":[],"mappings":"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"}

package/dist/tools/rcv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rcv.d.ts","sourceRoot":"","sources":["../../src/tools/rcv.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAKL,KAAK,OAAO,EACb,MAAM,4BAA4B,CAAC;AAOpC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA2E1E"}
+{"version":3,"file":"rcv.d.ts","sourceRoot":"","sources":["../../src/tools/rcv.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAKL,KAAK,OAAO,EACb,MAAM,4BAA4B,CAAC;AAOpC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA6E1E"}

package/dist/tools/rcv.js

@@ -19,6 +19,8 @@ export function registerRcvTools(server, runtime) {
     server.registerTool('rcv_list', {
         title: 'RCV detalle',
         description: 'Detalle de documentos de un tipo (codigoTipoDoc, ej. "33") del RCV para un período. ' +
+            'Es el REGISTRO del SII (todo lo emitido/recibido por cualquier software); para lo ' +
+            'emitido vía el Portal MIPYME con su PDF, usa dte_emitidos. ' +
             'COMPRAS por defecto; venta=true para VENTAS. Body-RUT: usa rut para una empresa representada.',
         inputSchema: {
             periodo: z.string(),

package/dist/tools/rcv.js.map

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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@albertomarturelo/sii-mcp",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "type": "module",
-  "description": "MCP (stdio) server for Chile's SII (tax authority): exposes authenticated reads — RCV, F29, F22, boletas de honorarios, DTE-authorized, peticiones administrativas — as tools/resources for Claude Desktop and Claude Code. Each tool is a thin call into @albertomarturelo/sii-core tasks (ADR-003).",
+  "description": "MCP (stdio) server for Chile's SII (tax authority): exposes authenticated reads — RCV, F29, F22, boletas de honorarios, DTE-authorized, peticiones administrativas — plus factura borradores on the Portal MIPYME (never emission) and document downloads, as tools/resources for Claude Desktop and Claude Code. Each tool is a thin call into @albertomarturelo/sii-core tasks (ADR-003).",
   "keywords": [
     "sii",
     "chile",
@@ -45,7 +45,7 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "playwright": "^1.49.0",
     "zod": "^4.4.3",
-    "@albertomarturelo/sii-core": "^0.7.0"
+    "@albertomarturelo/sii-core": "^0.8.0"
   },
   "scripts": {
     "build": "tsc -b"