Factuarea APIDevelopers
Millora

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 modelsPOST /v1/tax_reports/303, /347 i /130 retornen un llibre .xlsx amb dos fulls, Resumen i Detalle, 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 a 0 en 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 Resumen porten 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_347 i generate_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

EndpointDescripció
POST/v1/tax_reports/130Generar Model 130
POST/v1/tax_reports/303Generar Modelo 303
POST/v1/tax_reports/347Generar Modelo 347
GET/v1/tax_reports/{tax_report}/downloadDescarregar el fitxer de l'informe d'impostos