Informes fiscales: libro de trabajo y tools para agentes
Los informes fiscales usan un libro de trabajo Excel y exponen nueve tools MCP. Los endpoints existentes documentan con precisión los formatos de salida admitidos.
El formato excel del Modelo 303, el 347 y el 130 era un contrato publicado que
siempre fallaba: anunciado en el enum, en los esquemas de petición, en la ruta v1
y en el --format excel del CLI, y devolviendo 422 unsupported_format en todos
los casos. Ahora produce un libro de verdad. Consulta
Informes fiscales.
format: "excel"funciona para los tres modelos —POST /v1/tax_reports/303,/347y/130devuelven un libro.xlsxcon dos hojas,ResumenyDetalle, ambas encabezadas por modelo, periodo fiscal y empresa declarante. Los importes se escriben como números, así que una columna se suma en la propia hoja; los ceros se escriben como0en vez de dejarse en blanco.- 347 — resumen de clientes y proveedores declarados, importe total y cuántas contrapartes superan el umbral de 3.005,06 €; una fila de detalle por contraparte con su NIF, provincia, base anual y los cuatro trimestres, que suman la base. 303 — los agregados que determinan el resultado, con el IVA devengado y el recargo abiertos por tipo impositivo. 130 — casillas derivadas en el resumen, casillas de partida en el detalle.
- No se presenta ante la AEAT, y lo dice dentro del propio fichero — las
primeras filas de
Resumenllevan el aviso de que el libro es material de trabajo y de que la presentación se hace con el TXT oficial. Sus cifras siguen siendo fiables: salen del mismo cálculo de dominio que el fichero oficial, así que dos formatos de la misma declaración no pueden discrepar. - Un ejercicio sin ninguna contraparte por encima del umbral genera libro igualmente, con la hoja de detalle vacía y un resumen que lo dice. Es el caso normal de una empresa pequeña, no un error.
- Nueve MCP tools nuevas para un dominio que tenía nueve rutas publicadas y
cero tools:
generate_tax_report_303,generate_tax_report_347ygenerate_tax_report_130(tax_reports:write), más previsualización, búsqueda por periodo, histórico, estadísticas, actividad y descarga (tax_reports:read). Ninguna familia de scopes nueva: los dos scopes ya existían. Consulta el catálogo de tools.
Corrección de contrato (clientes generados). Nueve operaciones binarias
declaraban application/json con cuerpo de texto u objeto mientras devuelven
un fichero: la descarga de informes fiscales, los PDF de presupuesto y
proforma, la exportación a Excel y la previsualización en PDF de facturas, el
adjunto y el recibo de la factura de compra, y las dos exportaciones del cierre
mensual de jornada. Ahora declaran sus tipos de contenido reales
(application/pdf, text/plain, text/csv, image/jpeg, image/png, hoja
de cálculo) con un esquema binario. Nada cambia en el cable —ningún cliente
tipado podía funcionar contra el tipo anterior—, pero si usas un SDK generado o
el CLI, regenéralo: tu modelo de estas operaciones va a cambiar. La lista de
correcciones binarias que el CLI mantenía a mano ha desaparecido, porque el
spec ya no miente.
Endpoints actualizados4
| Endpoint | Descripción |
|---|---|
POST/v1/tax_reports/130 | Generar Modelo 130 |
POST/v1/tax_reports/303 | Generar Modelo 303 |
POST/v1/tax_reports/347 | Generar Modelo 347 |
GET/v1/tax_reports/{tax_report}/download | Descargar el archivo del informe de impuestos |