Informes fiscals: llibre de treball i tools per a agents
Els informes fiscals fan servir un llibre de treball Excel i exposen nou tools MCP. Els endpoints existents documenten amb precisió els formats de sortida admesos.
El format excel del Modelo 303, el 347 i el 130 era un contracte publicat que
sempre fallava: anunciat a l'enum, als esquemes de petició, a la ruta v1 i al
--format excel del CLI, i retornant 422 unsupported_format en tots els casos.
Ara produeix un llibre de debò. Consulta
Informes fiscals.
format: "excel"funciona per als tres models —POST /v1/tax_reports/303,/347i/130retornen un llibre.xlsxamb dos fulls,ResumeniDetalle, tots dos encapçalats per model, període fiscal i empresa declarant. Els imports s'escriuen com a nombres, així que una columna se suma al full mateix; els zeros s'escriuen com a0en comptes de deixar-se en blanc.- 347 — resum de clients i proveïdors declarats, import total i quantes contraparts superen el llindar de 3.005,06 €; una fila de detall per contrapart amb el seu NIF, província, base anual i els quatre trimestres, que sumen la base. 303 — els agregats que determinen el resultat, amb l'IVA meritat i el recàrrec oberts per tipus impositiu. 130 — caselles derivades al resum, caselles de partida al detall.
- No es presenta davant l'AEAT, i ho diu dins del fitxer mateix — les primeres
files de
Resumenporten l'avís que el llibre és material de treball i que la presentació es fa amb el TXT oficial. Les seves xifres continuen sent fiables: surten del mateix càlcul de domini que el fitxer oficial, així que dos formats de la mateixa declaració no poden discrepar. - Un exercici sense cap contrapart per damunt del llindar genera llibre igualment, amb el full de detall buit i un resum que ho diu. És el cas normal d'una empresa petita, no un error.
- Nou MCP tools noves per a un domini que tenia nou rutes publicades i cap
tool:
generate_tax_report_303,generate_tax_report_347igenerate_tax_report_130(tax_reports:write), més previsualització, cerca per període, històric, estadístiques, activitat i descàrrega (tax_reports:read). Cap família de scopes nova: els dos scopes ja existien. Consulta el catàleg de tools.
Correcció de contracte (clients generats). Nou operacions binàries
declaraven application/json amb cos de text o objecte mentre retornen un
fitxer: la descàrrega d'informes fiscals, els PDF de pressupost i proforma,
l'exportació a Excel i la previsualització en PDF de factures, l'adjunt i el
rebut de la factura de compra, i les dues exportacions del tancament mensual de
jornada. Ara declaren els seus tipus de contingut reals (application/pdf,
text/plain, text/csv, image/jpeg, image/png, full de càlcul) amb un
esquema binari. No canvia res al cable —cap client tipat no podia funcionar
contra el tipus anterior—, però si uses un SDK generat o el CLI, regenera'l: el
teu model d'aquestes operacions canviarà. La llista de correccions binàries que
el CLI mantenia a mà ha desaparegut, perquè el spec ja no menteix.
Endpoints actualitzats4
| Endpoint | Descripció |
|---|---|
POST/v1/tax_reports/130 | Generar Model 130 |
POST/v1/tax_reports/303 | Generar Modelo 303 |
POST/v1/tax_reports/347 | Generar Modelo 347 |
GET/v1/tax_reports/{tax_report}/download | Descarregar el fitxer de l'informe d'impostos |