@reneturcios/fiscocheck 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +159 -2
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +79 -0
- package/dist/cli.js.map +1 -0
- package/dist/forward.d.ts +83 -0
- package/dist/forward.js +1940 -0
- package/dist/forward.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +3 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp.d.ts +33 -0
- package/dist/mcp.js +58 -0
- package/dist/mcp.js.map +1 -0
- package/dist/types.d.ts +52 -0
- package/dist/types.js +11 -0
- package/dist/types.js.map +1 -0
- package/package.json +1 -6
- package/server.json +1 -0
package/dist/forward.js
ADDED
|
@@ -0,0 +1,1940 @@
|
|
|
1
|
+
export const VERSION = "0.1.0";
|
|
2
|
+
export const DEFAULT_ENDPOINT_URL = "https://imperioutils.com/api/mcp";
|
|
3
|
+
export const DEFAULT_TIMEOUT_MS = 30000;
|
|
4
|
+
export const PROTOCOL_VERSION = "2025-03-26";
|
|
5
|
+
/* ------------------------------------------------------------------ */
|
|
6
|
+
/* Tool definitions (tools/list literals, verbatim from the live */
|
|
7
|
+
/* capture in harness/fixtures/imperioutils-fisco-it-tools-original.json; */
|
|
8
|
+
/* generated programmatically by parsing and re-serialising the */
|
|
9
|
+
/* fixture JSON, never retyped) */
|
|
10
|
+
/* ------------------------------------------------------------------ */
|
|
11
|
+
export const TOOL_DEFS = [
|
|
12
|
+
{
|
|
13
|
+
"name": "validate_codice_fiscale",
|
|
14
|
+
"title": "Valida Codice Fiscale",
|
|
15
|
+
"description": "Valida un Codice Fiscale italiano (formato + carattere di controllo, con gestione omocodia). Gratis (€0), deterministico, nessun login richiesto.",
|
|
16
|
+
"inputSchema": {
|
|
17
|
+
"type": "object",
|
|
18
|
+
"properties": {
|
|
19
|
+
"codice_fiscale": {
|
|
20
|
+
"type": "string",
|
|
21
|
+
"maxLength": 32,
|
|
22
|
+
"description": "Il Codice Fiscale da validare (es. RSSMRA85T10A562S)."
|
|
23
|
+
}
|
|
24
|
+
},
|
|
25
|
+
"required": [
|
|
26
|
+
"codice_fiscale"
|
|
27
|
+
],
|
|
28
|
+
"additionalProperties": false
|
|
29
|
+
}
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"name": "generate_codice_fiscale",
|
|
33
|
+
"title": "Genera Codice Fiscale",
|
|
34
|
+
"description": "Genera un Codice Fiscale italiano da dati anagrafici (cognome, nome, data di nascita, sesso, e comune/stato estero di nascita — oppure direttamente il codice Belfiore). Restituisce il CF \"base\" (la variante omocodica in caso di collisione è assegnata dall'Agenzia). Gratis (€0), deterministico, nessun login richiesto.",
|
|
35
|
+
"inputSchema": {
|
|
36
|
+
"type": "object",
|
|
37
|
+
"properties": {
|
|
38
|
+
"cognome": {
|
|
39
|
+
"type": "string",
|
|
40
|
+
"maxLength": 64,
|
|
41
|
+
"description": "Cognome."
|
|
42
|
+
},
|
|
43
|
+
"nome": {
|
|
44
|
+
"type": "string",
|
|
45
|
+
"maxLength": 64,
|
|
46
|
+
"description": "Nome."
|
|
47
|
+
},
|
|
48
|
+
"data_nascita": {
|
|
49
|
+
"type": "string",
|
|
50
|
+
"maxLength": 10,
|
|
51
|
+
"description": "Data di nascita in formato GG/MM/AAAA (es. 10/12/1985)."
|
|
52
|
+
},
|
|
53
|
+
"sesso": {
|
|
54
|
+
"type": "string",
|
|
55
|
+
"enum": [
|
|
56
|
+
"M",
|
|
57
|
+
"F"
|
|
58
|
+
],
|
|
59
|
+
"description": "Sesso: M o F."
|
|
60
|
+
},
|
|
61
|
+
"comune": {
|
|
62
|
+
"type": "string",
|
|
63
|
+
"maxLength": 64,
|
|
64
|
+
"description": "Comune (o stato estero) di nascita. In alternativa usa codice_belfiore."
|
|
65
|
+
},
|
|
66
|
+
"provincia": {
|
|
67
|
+
"type": "string",
|
|
68
|
+
"maxLength": 4,
|
|
69
|
+
"description": "Sigla provincia (es. PI) per disambiguare comuni omonimi."
|
|
70
|
+
},
|
|
71
|
+
"codice_belfiore": {
|
|
72
|
+
"type": "string",
|
|
73
|
+
"maxLength": 4,
|
|
74
|
+
"description": "Codice catastale/Belfiore del luogo di nascita (alternativa precisa al comune)."
|
|
75
|
+
}
|
|
76
|
+
},
|
|
77
|
+
"required": [
|
|
78
|
+
"cognome",
|
|
79
|
+
"nome",
|
|
80
|
+
"data_nascita",
|
|
81
|
+
"sesso"
|
|
82
|
+
],
|
|
83
|
+
"additionalProperties": false
|
|
84
|
+
}
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
"name": "validate_partita_iva",
|
|
88
|
+
"title": "Valida Partita IVA",
|
|
89
|
+
"description": "Valida una Partita IVA italiana (11 cifre + checksum Luhn). Gratis (€0), deterministico, nessun login richiesto.",
|
|
90
|
+
"inputSchema": {
|
|
91
|
+
"type": "object",
|
|
92
|
+
"properties": {
|
|
93
|
+
"partita_iva": {
|
|
94
|
+
"type": "string",
|
|
95
|
+
"maxLength": 32,
|
|
96
|
+
"description": "La Partita IVA da validare (11 cifre, es. 12345678903)."
|
|
97
|
+
}
|
|
98
|
+
},
|
|
99
|
+
"required": [
|
|
100
|
+
"partita_iva"
|
|
101
|
+
],
|
|
102
|
+
"additionalProperties": false
|
|
103
|
+
}
|
|
104
|
+
},
|
|
105
|
+
{
|
|
106
|
+
"name": "validate_iban",
|
|
107
|
+
"title": "Valida IBAN",
|
|
108
|
+
"description": "Valida un IBAN (checksum MOD-97) e, per gli IBAN italiani, identifica la banca dal codice ABI. Gratis (€0), deterministico, nessun login richiesto.",
|
|
109
|
+
"inputSchema": {
|
|
110
|
+
"type": "object",
|
|
111
|
+
"properties": {
|
|
112
|
+
"iban": {
|
|
113
|
+
"type": "string",
|
|
114
|
+
"maxLength": 64,
|
|
115
|
+
"description": "L'IBAN da validare (es. IT60X0542811101000000123456)."
|
|
116
|
+
}
|
|
117
|
+
},
|
|
118
|
+
"required": [
|
|
119
|
+
"iban"
|
|
120
|
+
],
|
|
121
|
+
"additionalProperties": false
|
|
122
|
+
}
|
|
123
|
+
},
|
|
124
|
+
{
|
|
125
|
+
"name": "lookup_cap",
|
|
126
|
+
"title": "Cerca CAP",
|
|
127
|
+
"description": "Restituisce la provincia del PREFISSO di 2 cifre di un CAP italiano. NON restituisce il comune (il campo `comune` è sempre null: non abbiamo un elenco CAP→comune) e per 14 province — elencate nella risposta in `province_non_rappresentate`, fra cui Lecco, Monza-Brianza, Rimini e Biella — la provincia resa è SBAGLIATA con certezza. Gratis (€0), deterministico, nessun login richiesto.",
|
|
128
|
+
"inputSchema": {
|
|
129
|
+
"type": "object",
|
|
130
|
+
"properties": {
|
|
131
|
+
"cap": {
|
|
132
|
+
"type": "string",
|
|
133
|
+
"maxLength": 8,
|
|
134
|
+
"description": "Il CAP a 5 cifre (es. 20121)."
|
|
135
|
+
}
|
|
136
|
+
},
|
|
137
|
+
"required": [
|
|
138
|
+
"cap"
|
|
139
|
+
],
|
|
140
|
+
"additionalProperties": false
|
|
141
|
+
}
|
|
142
|
+
},
|
|
143
|
+
{
|
|
144
|
+
"name": "validate_pec",
|
|
145
|
+
"title": "Valida PEC",
|
|
146
|
+
"description": "Valida un indirizzo PEC italiano: formato + dominio confrontato con l'elenco dei provider certificati AGID (Aruba, InfoCert, Namirial, Poste, ecc.). `is_pec_domain` ha TRE valori: true (nell'elenco AGID), false (non risulta PEC), null (il dominio contiene 'pec' ma NON è stato verificato — non è la stessa cosa di false). Gratis (€0), deterministico, nessun login richiesto.",
|
|
147
|
+
"inputSchema": {
|
|
148
|
+
"type": "object",
|
|
149
|
+
"properties": {
|
|
150
|
+
"email": {
|
|
151
|
+
"type": "string",
|
|
152
|
+
"maxLength": 254,
|
|
153
|
+
"description": "L'indirizzo PEC da validare (es. mario.rossi@pec.it)."
|
|
154
|
+
}
|
|
155
|
+
},
|
|
156
|
+
"required": [
|
|
157
|
+
"email"
|
|
158
|
+
],
|
|
159
|
+
"additionalProperties": false
|
|
160
|
+
}
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
"name": "lookup_ateco",
|
|
164
|
+
"title": "Cerca codice ATECO",
|
|
165
|
+
"description": "Cerca e valida un codice ATECO 2007 ISTAT e restituisce la descrizione dell'attività. Gratis (€0), deterministico, nessun login richiesto.",
|
|
166
|
+
"inputSchema": {
|
|
167
|
+
"type": "object",
|
|
168
|
+
"properties": {
|
|
169
|
+
"code": {
|
|
170
|
+
"type": "string",
|
|
171
|
+
"pattern": "^[0-9.]{1,12}$",
|
|
172
|
+
"maxLength": 12,
|
|
173
|
+
"description": "Il codice ATECO (solo cifre e punti, es. 62.01)."
|
|
174
|
+
}
|
|
175
|
+
},
|
|
176
|
+
"required": [
|
|
177
|
+
"code"
|
|
178
|
+
],
|
|
179
|
+
"additionalProperties": false
|
|
180
|
+
}
|
|
181
|
+
},
|
|
182
|
+
{
|
|
183
|
+
"name": "search_ateco",
|
|
184
|
+
"title": "Cerca ATECO per attività",
|
|
185
|
+
"description": "Ricerca full-text sui codici ATECO 2007/2022 ISTAT partendo dalla DESCRIZIONE dell'attività (\"fotografo\", \"sviluppo software\", \"commercio abbigliamento\") invece che dal codice. Case/accent-insensitive, con stemming e alias colloquiali per-mestiere; accetta anche un prefisso di codice. Usa questo quando il codice NON è noto — `lookup_ateco` serve al caso opposto (codice noto → descrizione). Risultati ordinati per pertinenza. Gratis (€0), deterministico, nessun login richiesto.",
|
|
186
|
+
"inputSchema": {
|
|
187
|
+
"type": "object",
|
|
188
|
+
"properties": {
|
|
189
|
+
"q": {
|
|
190
|
+
"type": "string",
|
|
191
|
+
"minLength": 2,
|
|
192
|
+
"maxLength": 80,
|
|
193
|
+
"description": "Attività da cercare, in italiano (es. 'fotografo', 'idraulico', 'consulenza informatica')."
|
|
194
|
+
},
|
|
195
|
+
"section": {
|
|
196
|
+
"type": "string",
|
|
197
|
+
"pattern": "^[A-Ua-u]$",
|
|
198
|
+
"description": "Filtra per sezione ATECO (lettera A–U, es. J = servizi di informazione e comunicazione, M = attività professionali). Opzionale."
|
|
199
|
+
},
|
|
200
|
+
"limit": {
|
|
201
|
+
"type": "integer",
|
|
202
|
+
"minimum": 1,
|
|
203
|
+
"maximum": 100,
|
|
204
|
+
"description": "Numero massimo di risultati (default 20)."
|
|
205
|
+
}
|
|
206
|
+
},
|
|
207
|
+
"required": [
|
|
208
|
+
"q"
|
|
209
|
+
],
|
|
210
|
+
"additionalProperties": false
|
|
211
|
+
}
|
|
212
|
+
},
|
|
213
|
+
{
|
|
214
|
+
"name": "calc_forfettario",
|
|
215
|
+
"title": "Calcolatore Regime Forfettario",
|
|
216
|
+
"description": "Calcola imposta sostitutiva e contributi INPS del regime forfettario italiano dal fatturato e (opzionale) codice ATECO. Gratis (€0), deterministico, nessun login richiesto.",
|
|
217
|
+
"inputSchema": {
|
|
218
|
+
"type": "object",
|
|
219
|
+
"properties": {
|
|
220
|
+
"ricavi": {
|
|
221
|
+
"type": "number",
|
|
222
|
+
"minimum": 0,
|
|
223
|
+
"maximum": 10000000,
|
|
224
|
+
"description": "Ricavi/compensi annui in euro."
|
|
225
|
+
},
|
|
226
|
+
"ateco": {
|
|
227
|
+
"type": "string",
|
|
228
|
+
"pattern": "^[0-9.]{1,12}$",
|
|
229
|
+
"maxLength": 12,
|
|
230
|
+
"description": "Codice ATECO da cui derivare il coefficiente di redditività. ALTERNATIVO a `coefficiente`: uno dei due è obbligatorio (senza, il calcolo non ha coefficiente e il tool risponde «Fornire 'ateco' oppure 'coefficiente'»)."
|
|
231
|
+
},
|
|
232
|
+
"coefficiente": {
|
|
233
|
+
"type": "integer",
|
|
234
|
+
"minimum": 1,
|
|
235
|
+
"maximum": 100,
|
|
236
|
+
"description": "Coefficiente di redditività in % (override manuale). ALTERNATIVO ad `ateco`: uno dei due è obbligatorio."
|
|
237
|
+
},
|
|
238
|
+
"startup": {
|
|
239
|
+
"type": "boolean",
|
|
240
|
+
"default": false,
|
|
241
|
+
"description": "Aliquota agevolata 5% per le nuove attività: vale per l'anno di inizio e per i quattro successivi (default false → 15%). Non cambia gli acconti: nel primo anno di attività non sono dovuti, e le note della risposta lo dicono."
|
|
242
|
+
},
|
|
243
|
+
"riduzione_35": {
|
|
244
|
+
"type": "boolean",
|
|
245
|
+
"default": false,
|
|
246
|
+
"description": "Riduzione contributiva INPS del 35% (artigiani/commercianti)."
|
|
247
|
+
},
|
|
248
|
+
"gestione_inps": {
|
|
249
|
+
"type": "string",
|
|
250
|
+
"enum": [
|
|
251
|
+
"gestione_separata",
|
|
252
|
+
"artigiani",
|
|
253
|
+
"commercianti",
|
|
254
|
+
"cassa_privata"
|
|
255
|
+
],
|
|
256
|
+
"description": "Gestione previdenziale INPS/cassa (opzionale)."
|
|
257
|
+
},
|
|
258
|
+
"contributi_cassa_privata": {
|
|
259
|
+
"type": "integer",
|
|
260
|
+
"minimum": 0,
|
|
261
|
+
"maximum": 1000000,
|
|
262
|
+
"description": "Contributi cassa privata già versati, in euro (opzionale)."
|
|
263
|
+
}
|
|
264
|
+
},
|
|
265
|
+
"required": [
|
|
266
|
+
"ricavi"
|
|
267
|
+
],
|
|
268
|
+
"anyOf": [
|
|
269
|
+
{
|
|
270
|
+
"required": [
|
|
271
|
+
"ateco"
|
|
272
|
+
]
|
|
273
|
+
},
|
|
274
|
+
{
|
|
275
|
+
"required": [
|
|
276
|
+
"coefficiente"
|
|
277
|
+
]
|
|
278
|
+
}
|
|
279
|
+
],
|
|
280
|
+
"additionalProperties": false
|
|
281
|
+
}
|
|
282
|
+
},
|
|
283
|
+
{
|
|
284
|
+
"name": "parse_fatturapa",
|
|
285
|
+
"title": "Parser FatturaPA / SDI",
|
|
286
|
+
"description": "Estrae dati strutturati (cedente, cessionario, righe, imposte) da un XML FatturaPA/SDI. Solo parsing deterministico — nessuna verifica VIES. Gratis (€0), deterministico, nessun login richiesto.",
|
|
287
|
+
"inputSchema": {
|
|
288
|
+
"type": "object",
|
|
289
|
+
"properties": {
|
|
290
|
+
"xml_content": {
|
|
291
|
+
"type": "string",
|
|
292
|
+
"maxLength": 64000,
|
|
293
|
+
"description": "Il contenuto XML della fattura elettronica (FatturaPA/SDI)."
|
|
294
|
+
}
|
|
295
|
+
},
|
|
296
|
+
"required": [
|
|
297
|
+
"xml_content"
|
|
298
|
+
],
|
|
299
|
+
"additionalProperties": false
|
|
300
|
+
}
|
|
301
|
+
},
|
|
302
|
+
{
|
|
303
|
+
"name": "parse_verify_fatturapa",
|
|
304
|
+
"title": "FatturaPA: parse + verifica anti-frode del fornitore",
|
|
305
|
+
"description": "Estrae i dati strutturati da un XML FatturaPA/SDI E, nella stessa chiamata, verifica anti-frode la parte indicata (default: il CEDENTE, cioè il fornitore che incassa il bonifico). I dati verificati NON sono inferiti da un LLM: P.IVA, Codice Fiscale, ragione sociale e IBAN di pagamento sono estratti deterministicamente dall'XML, poi passati ai controlli: IBAN (checksum MOD-97 + banca dal codice ABI), P.IVA e CF (checksum) e — quando il servizio UE è raggiungibile — la ragione sociale reale via VIES live, confrontata con quella dichiarata in fattura. Restituisce il parse completo più `supplier_verification` con verdetto (ok / non_verificabile / attenzione / alto_rischio) e red flag puntuali; se la fattura riporta più IBAN distinti lo segnala e abbassa il verdetto. È la difesa contro la truffa del cambio-IBAN sulle fatture passive. Come `verify_payee` fa I/O esterno (una sola interrogazione VIES per chiamata, non una per riga): se VIES è giù o il budget condiviso è esaurito il verdetto degrada ONESTAMENTE ad \"attenzione\", mai a un falso \"ok\". Gratis (€0), nessun login. NON sostituisce la verifica out-of-band (telefonata al fornitore su un numero già noto).",
|
|
306
|
+
"inputSchema": {
|
|
307
|
+
"type": "object",
|
|
308
|
+
"properties": {
|
|
309
|
+
"xml_content": {
|
|
310
|
+
"type": "string",
|
|
311
|
+
"maxLength": 64000,
|
|
312
|
+
"description": "Il contenuto XML della fattura elettronica (FatturaPA/SDI). Il .p7m va scompattato prima: qui si accetta XML testuale."
|
|
313
|
+
},
|
|
314
|
+
"party": {
|
|
315
|
+
"type": "string",
|
|
316
|
+
"enum": [
|
|
317
|
+
"cedente",
|
|
318
|
+
"cessionario"
|
|
319
|
+
],
|
|
320
|
+
"default": "cedente",
|
|
321
|
+
"description": "Parte da verificare: 'cedente' = fornitore/chi riceve il pagamento (default, il caso anti-frode); 'cessionario' = cliente. L'IBAN viene raccolto solo per il cedente, perché è lui che incassa."
|
|
322
|
+
},
|
|
323
|
+
"expected_country": {
|
|
324
|
+
"type": "string",
|
|
325
|
+
"maxLength": 2,
|
|
326
|
+
"description": "Paese atteso del fornitore in ISO2. Se omesso vale il paese dichiarato dalla fattura stessa (sede del cedente), e solo in sua mancanza 'IT'. Un IBAN estero su un fornitore atteso italiano è il campanello #1 della frode."
|
|
327
|
+
}
|
|
328
|
+
},
|
|
329
|
+
"required": [
|
|
330
|
+
"xml_content"
|
|
331
|
+
],
|
|
332
|
+
"additionalProperties": false
|
|
333
|
+
}
|
|
334
|
+
},
|
|
335
|
+
{
|
|
336
|
+
"name": "calc_iva",
|
|
337
|
+
"title": "Calcola IVA",
|
|
338
|
+
"description": "Calcola l'IVA italiana su un imponibile (aliquote 22/10/5/4/0/esente/fuori campo), con ritenuta d'acconto opzionale (autonomi 20%, agenti 11,5%), e decide la TERRITORIALITÀ delle operazioni con l'estero: beni o servizi, impresa o privato, UE o extra-UE → imponibile in Italia, non imponibile, non soggetta o IVA del paese di destinazione (aliquota ordinaria ufficiale TEDB dei 27 Stati), con Natura FatturaPA, annotazione in fattura e norma. Soglia UE di 10.000 € non dichiarata → due scenari calcolati, mai un numero scelto al posto tuo. Le norme citate seguono la data dell'operazione: DPR 633/72 fino al 31/12/2026, Testo unico IVA dal 1/1/2027. Gestisce le DUE basi imponibili della fattura di un professionista (contributo integrativo cassa solo nella base IVA, rivalsa INPS in entrambe). Gratis (€0), deterministico, nessun login richiesto.",
|
|
339
|
+
"inputSchema": {
|
|
340
|
+
"type": "object",
|
|
341
|
+
"properties": {
|
|
342
|
+
"imponibile": {
|
|
343
|
+
"type": "number",
|
|
344
|
+
"minimum": 0.01,
|
|
345
|
+
"maximum": 1000000000000,
|
|
346
|
+
"description": "Compenso/corrispettivo in EUR (es. 1000), AL NETTO del contributo integrativo cassa e della rivalsa INPS: quelli si aggiungono con i due campi dedicati."
|
|
347
|
+
},
|
|
348
|
+
"aliquota_iva": {
|
|
349
|
+
"type": "string",
|
|
350
|
+
"enum": [
|
|
351
|
+
"22",
|
|
352
|
+
"10",
|
|
353
|
+
"5",
|
|
354
|
+
"4",
|
|
355
|
+
"0",
|
|
356
|
+
"esente",
|
|
357
|
+
"fuori_campo"
|
|
358
|
+
],
|
|
359
|
+
"description": "Aliquota IVA (default 22)."
|
|
360
|
+
},
|
|
361
|
+
"tipo_operazione": {
|
|
362
|
+
"type": "string",
|
|
363
|
+
"enum": [
|
|
364
|
+
"b2b",
|
|
365
|
+
"b2c",
|
|
366
|
+
"intraUE",
|
|
367
|
+
"extraUE",
|
|
368
|
+
"PA"
|
|
369
|
+
],
|
|
370
|
+
"description": "Tipo operazione (default b2b). intraUE ESIGE `cessionario_soggetto_iva`; verso un privato UE esige anche `oggetto`. extraUE senza `oggetto` è trattata come esportazione di beni (lo dichiara nei `presupposti`); per i servizi dichiara `oggetto` e `cessionario_soggetto_iva`: verso un privato extra-UE l'IVA di regola è italiana."
|
|
371
|
+
},
|
|
372
|
+
"cessionario_soggetto_iva": {
|
|
373
|
+
"type": "boolean",
|
|
374
|
+
"description": "OBBLIGATORIO per tipo_operazione='intraUE' (e per extraUE con oggetto='servizi'). true = soggetto passivo con P.IVA valida al VIES: beni non imponibili (N3.2), servizi non soggetti (N2.1). false = consumatore privato: l'IVA è italiana o del paese di destinazione a seconda di `oggetto`, `vendita_a_distanza`, `soglia_ue_superata` e `tipo_servizio`."
|
|
375
|
+
},
|
|
376
|
+
"con_ritenuta": {
|
|
377
|
+
"type": "boolean",
|
|
378
|
+
"description": "Applica la ritenuta d'acconto (default false)."
|
|
379
|
+
},
|
|
380
|
+
"tipo_ritenuta": {
|
|
381
|
+
"type": "string",
|
|
382
|
+
"enum": [
|
|
383
|
+
"autonomo",
|
|
384
|
+
"agente"
|
|
385
|
+
],
|
|
386
|
+
"description": "Tipo ritenuta se con_ritenuta=true (autonomo 20% | agente 11,5%)."
|
|
387
|
+
},
|
|
388
|
+
"contributo_integrativo_pct": {
|
|
389
|
+
"type": "number",
|
|
390
|
+
"minimum": 0,
|
|
391
|
+
"maximum": 5,
|
|
392
|
+
"description": "Aliquota % del contributo integrativo della cassa professionale (default 0 = nessuna cassa). Tipicamente 4; 5 per i geometri; 2 per ENPAP/ENPAV — leggila dal regolamento della cassa: il tool non la deduce da ATECO. Entra nella base IVA ma NON in quella della ritenuta."
|
|
393
|
+
},
|
|
394
|
+
"rivalsa_inps_pct": {
|
|
395
|
+
"type": "number",
|
|
396
|
+
"minimum": 0,
|
|
397
|
+
"maximum": 5,
|
|
398
|
+
"description": "Aliquota % della rivalsa INPS gestione separata addebitata in fattura (default 0). Per legge 4 (art. 1 c. 212 L. 662/1996). Entra in ENTRAMBE le basi."
|
|
399
|
+
},
|
|
400
|
+
"oggetto": {
|
|
401
|
+
"type": "string",
|
|
402
|
+
"enum": [
|
|
403
|
+
"beni",
|
|
404
|
+
"servizi"
|
|
405
|
+
],
|
|
406
|
+
"description": "Per intraUE/extraUE. Cambia il regime: cessione di beni intraUE B2B = non imponibile (N3.2, «operazione non imponibile»); servizi B2B = non soggetti (N2.1, «inversione contabile»). Obbligatorio verso un privato UE."
|
|
407
|
+
},
|
|
408
|
+
"paese_destinazione": {
|
|
409
|
+
"type": "string",
|
|
410
|
+
"pattern": "^[A-Za-z]{2}$",
|
|
411
|
+
"description": "ISO2 del paese del cliente ('EL' Grecia; 'XI' Irlanda del Nord = UE per i soli beni). Serve all'aliquota di destinazione sopra soglia."
|
|
412
|
+
},
|
|
413
|
+
"vendita_a_distanza": {
|
|
414
|
+
"type": "boolean",
|
|
415
|
+
"description": "Beni a privato UE: true se il trasporto è a cura del cedente o per suo conto (default assunto true, e dichiarato). false = il cliente trasporta da sé → IVA italiana."
|
|
416
|
+
},
|
|
417
|
+
"soglia_ue_superata": {
|
|
418
|
+
"type": "boolean",
|
|
419
|
+
"description": "Beni a distanza e servizi elettronici a privati UE: true se vendite a distanza + servizi TTE a privati UE hanno superato 10.000 € (anno precedente o in corso) OPPURE se hai optato per l'IVA di destinazione. Se non la dichiari ricevi DUE scenari calcolati e `iva_importo: null`."
|
|
420
|
+
},
|
|
421
|
+
"tipo_servizio": {
|
|
422
|
+
"type": "string",
|
|
423
|
+
"enum": [
|
|
424
|
+
"generico",
|
|
425
|
+
"elettronico",
|
|
426
|
+
"speciale"
|
|
427
|
+
],
|
|
428
|
+
"description": "Per oggetto='servizi'. generico = regola generale (default assunto, e dichiarato); elettronico = telecomunicazione, teleradiodiffusione, servizi elettronici; speciale = immobili, trasporti, ristorazione, eventi, noleggio mezzi, intermediazione, lavorazioni su beni mobili — il tool NON calcola il luogo e lo dice, con le norme."
|
|
429
|
+
},
|
|
430
|
+
"servizio_7_septies": {
|
|
431
|
+
"type": "boolean",
|
|
432
|
+
"description": "Servizi a privato extra-UE: true se il servizio è fra quelli dell'art. 7-septies (consulenza, pubblicità, dati, finanziari, personale, noleggio beni mobili…): non soggetto."
|
|
433
|
+
},
|
|
434
|
+
"aliquota_destinazione_pct": {
|
|
435
|
+
"type": "number",
|
|
436
|
+
"minimum": 0,
|
|
437
|
+
"maximum": 30,
|
|
438
|
+
"description": "Aliquota del paese di destinazione, se il bene vi ha un'aliquota RIDOTTA. Senza, si usa l'ordinaria ufficiale (TEDB) e la risposta lo dichiara."
|
|
439
|
+
},
|
|
440
|
+
"data_operazione": {
|
|
441
|
+
"type": "string",
|
|
442
|
+
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
|
|
443
|
+
"description": "AAAA-MM-GG, default oggi. Decide la norma citata: DPR 633/72 e DL 331/93 fino al 31/12/2026, Testo unico IVA (D.Lgs. 10/2026) dal 1/1/2027."
|
|
444
|
+
}
|
|
445
|
+
},
|
|
446
|
+
"anyOf": [
|
|
447
|
+
{
|
|
448
|
+
"properties": {
|
|
449
|
+
"tipo_operazione": {
|
|
450
|
+
"enum": [
|
|
451
|
+
"b2b",
|
|
452
|
+
"b2c",
|
|
453
|
+
"PA"
|
|
454
|
+
]
|
|
455
|
+
}
|
|
456
|
+
}
|
|
457
|
+
},
|
|
458
|
+
{
|
|
459
|
+
"properties": {
|
|
460
|
+
"tipo_operazione": {
|
|
461
|
+
"const": "extraUE"
|
|
462
|
+
},
|
|
463
|
+
"oggetto": {
|
|
464
|
+
"const": "beni"
|
|
465
|
+
}
|
|
466
|
+
},
|
|
467
|
+
"required": [
|
|
468
|
+
"tipo_operazione"
|
|
469
|
+
]
|
|
470
|
+
},
|
|
471
|
+
{
|
|
472
|
+
"properties": {
|
|
473
|
+
"tipo_operazione": {
|
|
474
|
+
"const": "extraUE"
|
|
475
|
+
},
|
|
476
|
+
"oggetto": {
|
|
477
|
+
"const": "servizi"
|
|
478
|
+
},
|
|
479
|
+
"cessionario_soggetto_iva": {
|
|
480
|
+
"type": "boolean"
|
|
481
|
+
}
|
|
482
|
+
},
|
|
483
|
+
"required": [
|
|
484
|
+
"tipo_operazione",
|
|
485
|
+
"oggetto",
|
|
486
|
+
"cessionario_soggetto_iva"
|
|
487
|
+
]
|
|
488
|
+
},
|
|
489
|
+
{
|
|
490
|
+
"properties": {
|
|
491
|
+
"tipo_operazione": {
|
|
492
|
+
"const": "intraUE"
|
|
493
|
+
},
|
|
494
|
+
"cessionario_soggetto_iva": {
|
|
495
|
+
"const": true
|
|
496
|
+
}
|
|
497
|
+
},
|
|
498
|
+
"required": [
|
|
499
|
+
"tipo_operazione",
|
|
500
|
+
"cessionario_soggetto_iva"
|
|
501
|
+
]
|
|
502
|
+
},
|
|
503
|
+
{
|
|
504
|
+
"properties": {
|
|
505
|
+
"tipo_operazione": {
|
|
506
|
+
"const": "intraUE"
|
|
507
|
+
},
|
|
508
|
+
"cessionario_soggetto_iva": {
|
|
509
|
+
"const": false
|
|
510
|
+
},
|
|
511
|
+
"oggetto": {
|
|
512
|
+
"enum": [
|
|
513
|
+
"beni",
|
|
514
|
+
"servizi"
|
|
515
|
+
]
|
|
516
|
+
}
|
|
517
|
+
},
|
|
518
|
+
"required": [
|
|
519
|
+
"tipo_operazione",
|
|
520
|
+
"cessionario_soggetto_iva",
|
|
521
|
+
"oggetto"
|
|
522
|
+
]
|
|
523
|
+
}
|
|
524
|
+
],
|
|
525
|
+
"required": [
|
|
526
|
+
"imponibile"
|
|
527
|
+
],
|
|
528
|
+
"additionalProperties": false
|
|
529
|
+
}
|
|
530
|
+
},
|
|
531
|
+
{
|
|
532
|
+
"name": "calc_reverse_charge",
|
|
533
|
+
"title": "Reverse charge (inversione contabile)",
|
|
534
|
+
"description": "Calcola l'IVA che il CESSIONARIO deve autoliquidare in regime di inversione contabile e restituisce gli obblighi delle due parti con la norma applicabile. Distingue i tre casi che si confondono più spesso: reverse charge INTRACOMUNITARIO (cedente UE non-IT — art. 46 DL 331/93 per i beni, art. 17 c. 2 DPR 633/72 per i servizi), reverse charge INTERNO (cedente italiano — art. 17 c. 6, che NON è generalizzato: vale solo in settori tassativi come subappalti edili, rottami, pulizia edifici, elettronica) e paese non-UE (errore esplicito, non un ramo implicito). Gratis (€0), deterministico, nessun login richiesto.",
|
|
535
|
+
"inputSchema": {
|
|
536
|
+
"type": "object",
|
|
537
|
+
"properties": {
|
|
538
|
+
"imponibile": {
|
|
539
|
+
"type": "number",
|
|
540
|
+
"minimum": 0.01,
|
|
541
|
+
"maximum": 1000000000000,
|
|
542
|
+
"description": "Imponibile della fattura in EUR."
|
|
543
|
+
},
|
|
544
|
+
"aliquota_iva": {
|
|
545
|
+
"type": "string",
|
|
546
|
+
"enum": [
|
|
547
|
+
"22",
|
|
548
|
+
"10",
|
|
549
|
+
"5",
|
|
550
|
+
"4",
|
|
551
|
+
"0",
|
|
552
|
+
"esente",
|
|
553
|
+
"fuori_campo"
|
|
554
|
+
],
|
|
555
|
+
"description": "Aliquota IVA da autoliquidare (default 22)."
|
|
556
|
+
},
|
|
557
|
+
"paese_cedente": {
|
|
558
|
+
"type": "string",
|
|
559
|
+
"pattern": "^[A-Za-z]{2}$",
|
|
560
|
+
"maxLength": 2,
|
|
561
|
+
"description": "Codice ISO2 del paese del CEDENTE: uno Stato membro UE (es. DE, FR, ES; 'EL' o 'GR' per la Grecia; 'XI' per l'Irlanda del Nord) per il reverse charge intracomunitario, oppure 'IT' per quello interno."
|
|
562
|
+
}
|
|
563
|
+
},
|
|
564
|
+
"required": [
|
|
565
|
+
"imponibile",
|
|
566
|
+
"paese_cedente"
|
|
567
|
+
],
|
|
568
|
+
"additionalProperties": false
|
|
569
|
+
}
|
|
570
|
+
},
|
|
571
|
+
{
|
|
572
|
+
"name": "calc_split_payment",
|
|
573
|
+
"title": "Split payment (scissione dei pagamenti)",
|
|
574
|
+
"description": "Calcola la scissione dei pagamenti per le forniture alla Pubblica Amministrazione (art. 17-ter DPR 633/72): il fornitore fattura imponibile + IVA ma incassa dalla PA il SOLO imponibile, mentre l'IVA la versa la PA direttamente all'Erario. Restituisce i due importi separati, l'impatto di liquidità per il fornitore e le istruzioni FatturaPA (EsigibilitaIVA=S; NON si usano i codici Natura N6, che sono solo del reverse charge). Gratis (€0), deterministico, nessun login richiesto.",
|
|
575
|
+
"inputSchema": {
|
|
576
|
+
"type": "object",
|
|
577
|
+
"properties": {
|
|
578
|
+
"imponibile": {
|
|
579
|
+
"type": "number",
|
|
580
|
+
"minimum": 0.01,
|
|
581
|
+
"maximum": 1000000000000,
|
|
582
|
+
"description": "Imponibile della fornitura alla PA in EUR."
|
|
583
|
+
},
|
|
584
|
+
"aliquota_iva": {
|
|
585
|
+
"type": "string",
|
|
586
|
+
"enum": [
|
|
587
|
+
"22",
|
|
588
|
+
"10",
|
|
589
|
+
"5",
|
|
590
|
+
"4",
|
|
591
|
+
"0",
|
|
592
|
+
"esente",
|
|
593
|
+
"fuori_campo"
|
|
594
|
+
],
|
|
595
|
+
"description": "Aliquota IVA esposta in fattura (default 22)."
|
|
596
|
+
}
|
|
597
|
+
},
|
|
598
|
+
"required": [
|
|
599
|
+
"imponibile"
|
|
600
|
+
],
|
|
601
|
+
"additionalProperties": false
|
|
602
|
+
}
|
|
603
|
+
},
|
|
604
|
+
{
|
|
605
|
+
"name": "calc_imu",
|
|
606
|
+
"title": "Calcola IMU",
|
|
607
|
+
"description": "Calcola l'IMU italiana (L.160/2019) per fabbricati (da rendita catastale + categoria), terreni agricoli (da reddito dominicale) e aree edificabili (da valore venale), con acconto/saldo. L'aliquota (‰) è quella deliberata dal Comune: indicala (`aliquota_permille`) OPPURE indica il `comune` (codice catastale o nome) e il server usa l'aliquota del suo prospetto pubblicato dal MEF, con lo stato di legge (prospetto dell'anno · anno precedente, L.160/2019 c.767 · aliquote di base) e la fonte in `aliquota_comune`. Se il prospetto non è ancora stato letto, o il comune non ha l'IMU (Trento, Bolzano, Friuli Venezia Giulia), risponde `calcolato: false` con la spiegazione, senza importo. Gratis (€0), deterministico, nessun login richiesto.",
|
|
608
|
+
"inputSchema": {
|
|
609
|
+
"type": "object",
|
|
610
|
+
"properties": {
|
|
611
|
+
"aliquota_permille": {
|
|
612
|
+
"type": "number",
|
|
613
|
+
"minimum": 0,
|
|
614
|
+
"maximum": 15,
|
|
615
|
+
"description": "Aliquota deliberata dal Comune, in per mille (es. 8.6 per 8,6‰). OBBLIGATORIA se non indichi `comune`; con tutti e due vince questa, e la risposta dice se differisce dal prospetto."
|
|
616
|
+
},
|
|
617
|
+
"comune": {
|
|
618
|
+
"type": "string",
|
|
619
|
+
"minLength": 2,
|
|
620
|
+
"maxLength": 120,
|
|
621
|
+
"description": "Codice catastale (es. B519) o nome del comune. L'aliquota diventa quella del suo prospetto IMU pubblicato dal MEF per l'anno (o, per legge, quella dell'anno precedente o di base)."
|
|
622
|
+
},
|
|
623
|
+
"provincia": {
|
|
624
|
+
"type": "string",
|
|
625
|
+
"minLength": 2,
|
|
626
|
+
"maxLength": 2,
|
|
627
|
+
"description": "Sigla della provincia, per i comuni omonimi (es. TO). Solo con `comune`."
|
|
628
|
+
},
|
|
629
|
+
"ex_comune": {
|
|
630
|
+
"type": "string",
|
|
631
|
+
"minLength": 2,
|
|
632
|
+
"maxLength": 120,
|
|
633
|
+
"description": "Solo comuni fusi con aliquote differenziate: l'ex comune dove sta l'immobile. Se serve e manca, la risposta elenca quelli possibili."
|
|
634
|
+
},
|
|
635
|
+
"anno": {
|
|
636
|
+
"type": "integer",
|
|
637
|
+
"minimum": 2025,
|
|
638
|
+
"maximum": 2100,
|
|
639
|
+
"description": "Anno d'imposta del verdetto per comune (default l'anno in corso). Solo con `comune`."
|
|
640
|
+
},
|
|
641
|
+
"tipo_immobile": {
|
|
642
|
+
"type": "string",
|
|
643
|
+
"enum": [
|
|
644
|
+
"abitazione_principale_A1_A8_A9",
|
|
645
|
+
"abitazione_non_principale",
|
|
646
|
+
"immobile_produttivo",
|
|
647
|
+
"immobile_locato_canone_concordato",
|
|
648
|
+
"comodato_uso_parenti",
|
|
649
|
+
"terreno_agricolo",
|
|
650
|
+
"area_edificabile"
|
|
651
|
+
],
|
|
652
|
+
"description": "Tipo immobile → seleziona la formula (default abitazione_non_principale)."
|
|
653
|
+
},
|
|
654
|
+
"categoria_catastale": {
|
|
655
|
+
"type": "string",
|
|
656
|
+
"enum": [
|
|
657
|
+
"A",
|
|
658
|
+
"A10",
|
|
659
|
+
"B",
|
|
660
|
+
"C1",
|
|
661
|
+
"C2_C6_C7",
|
|
662
|
+
"C3_C4_C5",
|
|
663
|
+
"D",
|
|
664
|
+
"D5",
|
|
665
|
+
"E",
|
|
666
|
+
"F"
|
|
667
|
+
],
|
|
668
|
+
"description": "Categoria catastale per i fabbricati (default A). Determina il moltiplicatore."
|
|
669
|
+
},
|
|
670
|
+
"rendita_catastale": {
|
|
671
|
+
"type": "number",
|
|
672
|
+
"minimum": 0.01,
|
|
673
|
+
"description": "Fabbricati: rendita catastale annua in euro (da visura). OBBLIGATORIA per tutti i tipi diversi da `terreno_agricolo` e `area_edificabile` — cioè anche per il tipo di default `abitazione_non_principale`."
|
|
674
|
+
},
|
|
675
|
+
"reddito_dominicale": {
|
|
676
|
+
"type": "number",
|
|
677
|
+
"minimum": 0.01,
|
|
678
|
+
"description": "Terreni agricoli: reddito dominicale da visura (base = ×1,25×135). OBBLIGATORIO con `tipo_immobile: terreno_agricolo`, tranne quando il terreno è esente (vedi i due flag)."
|
|
679
|
+
},
|
|
680
|
+
"valore_venale": {
|
|
681
|
+
"type": "number",
|
|
682
|
+
"minimum": 0.01,
|
|
683
|
+
"description": "Aree edificabili: valore venale in comune commercio al 1° gennaio (€). OBBLIGATORIO con `tipo_immobile: area_edificabile`."
|
|
684
|
+
},
|
|
685
|
+
"mesi_possesso": {
|
|
686
|
+
"type": "integer",
|
|
687
|
+
"minimum": 1,
|
|
688
|
+
"maximum": 12,
|
|
689
|
+
"description": "Mesi di possesso nell'anno (default 12)."
|
|
690
|
+
},
|
|
691
|
+
"quota_possesso_pct": {
|
|
692
|
+
"type": "number",
|
|
693
|
+
"minimum": 1,
|
|
694
|
+
"maximum": 100,
|
|
695
|
+
"description": "Quota di possesso in % (default 100)."
|
|
696
|
+
},
|
|
697
|
+
"detrazione": {
|
|
698
|
+
"type": "number",
|
|
699
|
+
"minimum": 0,
|
|
700
|
+
"description": "Detrazione in euro (solo fabbricati; es. 200 per abitazione principale di lusso)."
|
|
701
|
+
},
|
|
702
|
+
"coltivatore_diretto_iap": {
|
|
703
|
+
"type": "boolean",
|
|
704
|
+
"description": "Terreni: coltivatore diretto/IAP iscritto alla previdenza agricola → esente."
|
|
705
|
+
},
|
|
706
|
+
"esente_montano_isola": {
|
|
707
|
+
"type": "boolean",
|
|
708
|
+
"description": "Terreni: in comune montano/collinare o isola minore → esente."
|
|
709
|
+
}
|
|
710
|
+
},
|
|
711
|
+
"required": [],
|
|
712
|
+
"allOf": [
|
|
713
|
+
{
|
|
714
|
+
"if": {
|
|
715
|
+
"not": {
|
|
716
|
+
"required": [
|
|
717
|
+
"comune"
|
|
718
|
+
]
|
|
719
|
+
}
|
|
720
|
+
},
|
|
721
|
+
"then": {
|
|
722
|
+
"required": [
|
|
723
|
+
"aliquota_permille"
|
|
724
|
+
]
|
|
725
|
+
}
|
|
726
|
+
}
|
|
727
|
+
],
|
|
728
|
+
"anyOf": [
|
|
729
|
+
{
|
|
730
|
+
"required": [
|
|
731
|
+
"rendita_catastale"
|
|
732
|
+
]
|
|
733
|
+
},
|
|
734
|
+
{
|
|
735
|
+
"properties": {
|
|
736
|
+
"tipo_immobile": {
|
|
737
|
+
"const": "terreno_agricolo"
|
|
738
|
+
}
|
|
739
|
+
},
|
|
740
|
+
"required": [
|
|
741
|
+
"reddito_dominicale",
|
|
742
|
+
"tipo_immobile"
|
|
743
|
+
]
|
|
744
|
+
},
|
|
745
|
+
{
|
|
746
|
+
"properties": {
|
|
747
|
+
"tipo_immobile": {
|
|
748
|
+
"const": "area_edificabile"
|
|
749
|
+
}
|
|
750
|
+
},
|
|
751
|
+
"required": [
|
|
752
|
+
"valore_venale",
|
|
753
|
+
"tipo_immobile"
|
|
754
|
+
]
|
|
755
|
+
},
|
|
756
|
+
{
|
|
757
|
+
"properties": {
|
|
758
|
+
"tipo_immobile": {
|
|
759
|
+
"const": "terreno_agricolo"
|
|
760
|
+
},
|
|
761
|
+
"coltivatore_diretto_iap": {
|
|
762
|
+
"const": true
|
|
763
|
+
}
|
|
764
|
+
},
|
|
765
|
+
"required": [
|
|
766
|
+
"coltivatore_diretto_iap",
|
|
767
|
+
"tipo_immobile"
|
|
768
|
+
]
|
|
769
|
+
},
|
|
770
|
+
{
|
|
771
|
+
"properties": {
|
|
772
|
+
"tipo_immobile": {
|
|
773
|
+
"const": "terreno_agricolo"
|
|
774
|
+
},
|
|
775
|
+
"esente_montano_isola": {
|
|
776
|
+
"const": true
|
|
777
|
+
}
|
|
778
|
+
},
|
|
779
|
+
"required": [
|
|
780
|
+
"esente_montano_isola",
|
|
781
|
+
"tipo_immobile"
|
|
782
|
+
]
|
|
783
|
+
}
|
|
784
|
+
],
|
|
785
|
+
"additionalProperties": false
|
|
786
|
+
}
|
|
787
|
+
},
|
|
788
|
+
{
|
|
789
|
+
"name": "compose_f24",
|
|
790
|
+
"title": "F24 Precompilato (righe Erario / INPS / IMU)",
|
|
791
|
+
"description": "Compone le RIGHE del modello F24 (sezione Erario, INPS, IMU) con i codici tributo e le causali ufficiali, a partire dagli importi già calcolati: imposta sostitutiva e contributi del regime forfettario (codici tributo 1790 = acconto prima rata, 1791 = acconto seconda rata o unica soluzione, 1792 = saldo; causali INPS PXX = Gestione Separata senza altra copertura, AF = artigiani sul minimale, AP = artigiani sull'eccedenza, CF = commercianti sul minimale, CP = commercianti sull'eccedenza) oppure IMU (3912 = abitazione principale e pertinenze (A/1, A/8, A/9), 3918 = altri fabbricati, 3914 = terreni, 3916 = aree fabbricabili; per il gruppo D 3925 = quota Stato (7,6‰) e 3930 = incremento Comune; con il codice ente catastale del Comune) oppure l'IMPOSTA DI BOLLO sulle fatture elettroniche di un trimestre (2521 = primo trimestre, 2522 = secondo trimestre, 2523 = terzo trimestre, 2524 = quarto trimestre; scadenze 31/05 · 30/09 · 30/11 · 28/02, con la regola di differimento sotto 5.000 €). Per il forfettario la risposta porta anche `regola_acconti`: le due rate al 50% valgono per chi ha un'attività con ISA approvati (anche in forfettario), altrimenti 40% e 60% — con la norma e la base di calcolo. Restituisce righe strutturate (sezione, codice, anno, importo, scadenza indicativa) + una resa testuale. COMPONIBILE: l'input tipico sono gli output di `calc_forfettario` (imposta_sostitutiva.importo, contributi_inps), `calc_imu` (imu_dovuta, acconto_giugno, saldo_dicembre) e `parse_fatturapa` (quante fatture hanno `bollo_analisi.dovuto = true`). NON genera il modello ministeriale F24 — né PDF né facsimile ufficiale: è una compilazione INDICATIVA che non sostituisce il commercialista né la verifica su Agenzia delle Entrate. Gratis (€0), deterministico, nessun login richiesto.",
|
|
792
|
+
"inputSchema": {
|
|
793
|
+
"type": "object",
|
|
794
|
+
"properties": {
|
|
795
|
+
"kind": {
|
|
796
|
+
"type": "string",
|
|
797
|
+
"enum": [
|
|
798
|
+
"forfettario",
|
|
799
|
+
"imu",
|
|
800
|
+
"bollo"
|
|
801
|
+
],
|
|
802
|
+
"description": "Dominio da comporre: 'forfettario' (Erario + INPS), 'imu' (sezione IMU e altri tributi locali) oppure 'bollo' (imposta di bollo sulle fatture elettroniche di un trimestre)."
|
|
803
|
+
},
|
|
804
|
+
"bollo": {
|
|
805
|
+
"type": "object",
|
|
806
|
+
"description": "Richiesto quando kind='bollo'. Chiude la catena parse → bollo → F24: conta quante fatture del trimestre risultano soggette a bollo secondo `parse_fatturapa` (campo `bollo_analisi.dovuto` di ciascuna fattura) e componi la riga di versamento.",
|
|
807
|
+
"properties": {
|
|
808
|
+
"trimestre": {
|
|
809
|
+
"type": "integer",
|
|
810
|
+
"minimum": 1,
|
|
811
|
+
"maximum": 4,
|
|
812
|
+
"description": "Trimestre solare di riferimento (1-4). Determina il codice tributo: 2521 = primo trimestre, 2522 = secondo trimestre, 2523 = terzo trimestre, 2524 = quarto trimestre."
|
|
813
|
+
},
|
|
814
|
+
"anno": {
|
|
815
|
+
"type": "integer",
|
|
816
|
+
"minimum": 2019,
|
|
817
|
+
"maximum": 2100,
|
|
818
|
+
"description": "Anno delle fatture (es. 2026). NB: il IV trimestre si versa entro il 28 febbraio dell'anno SUCCESSIVO."
|
|
819
|
+
},
|
|
820
|
+
"numero_fatture": {
|
|
821
|
+
"type": "integer",
|
|
822
|
+
"minimum": 0,
|
|
823
|
+
"maximum": 1000000,
|
|
824
|
+
"description": "Quante fatture del trimestre sono soggette a bollo (2,00 € ciascuna). Alternativo a `importo`: fornire almeno uno dei due."
|
|
825
|
+
},
|
|
826
|
+
"importo": {
|
|
827
|
+
"type": "number",
|
|
828
|
+
"minimum": 0,
|
|
829
|
+
"maximum": 10000000,
|
|
830
|
+
"description": "Importo del bollo già calcolato in euro. Alternativo a `numero_fatture`. Se passi entrambi e non tornano, vince questo e la discrepanza viene segnalata in nota."
|
|
831
|
+
},
|
|
832
|
+
"importo_trimestri_precedenti": {
|
|
833
|
+
"type": "number",
|
|
834
|
+
"minimum": 0,
|
|
835
|
+
"maximum": 10000000,
|
|
836
|
+
"description": "Bollo già dovuto per i trimestri precedenti dello stesso anno (default 0). Serve alla regola di differimento, che guarda il CUMULATO: sotto 5.000 € il versamento del I trimestre può slittare al 30/09 e quello di I+II al 30/11 (art. 3 DL 73/2022). III e IV trimestre non sono mai differibili."
|
|
837
|
+
}
|
|
838
|
+
},
|
|
839
|
+
"required": [
|
|
840
|
+
"trimestre",
|
|
841
|
+
"anno"
|
|
842
|
+
],
|
|
843
|
+
"anyOf": [
|
|
844
|
+
{
|
|
845
|
+
"required": [
|
|
846
|
+
"numero_fatture"
|
|
847
|
+
]
|
|
848
|
+
},
|
|
849
|
+
{
|
|
850
|
+
"required": [
|
|
851
|
+
"importo"
|
|
852
|
+
]
|
|
853
|
+
}
|
|
854
|
+
],
|
|
855
|
+
"additionalProperties": false
|
|
856
|
+
},
|
|
857
|
+
"forfettario": {
|
|
858
|
+
"type": "object",
|
|
859
|
+
"description": "Richiesto quando kind='forfettario'. Campi dall'output di calc_forfettario.",
|
|
860
|
+
"properties": {
|
|
861
|
+
"imposta": {
|
|
862
|
+
"type": "number",
|
|
863
|
+
"minimum": 0,
|
|
864
|
+
"maximum": 10000000,
|
|
865
|
+
"description": "Imposta sostitutiva dovuta in euro — calc_forfettario → imposta_sostitutiva.importo."
|
|
866
|
+
},
|
|
867
|
+
"gestione_inps": {
|
|
868
|
+
"type": "string",
|
|
869
|
+
"enum": [
|
|
870
|
+
"gestione_separata",
|
|
871
|
+
"artigiani",
|
|
872
|
+
"commercianti",
|
|
873
|
+
"cassa_privata"
|
|
874
|
+
],
|
|
875
|
+
"description": "Gestione previdenziale (default gestione_separata) — determina le causali INPS (PXX = Gestione Separata senza altra copertura; AF = artigiani sul minimale, AP = artigiani sull'eccedenza; CF = commercianti sul minimale, CP = commercianti sull'eccedenza). Con cassa_privata nessuna riga INPS: i contributi non si versano in F24."
|
|
876
|
+
},
|
|
877
|
+
"inps_fisso": {
|
|
878
|
+
"type": "number",
|
|
879
|
+
"minimum": 0,
|
|
880
|
+
"maximum": 1000000,
|
|
881
|
+
"description": "Contributi INPS sul minimale/fisso in euro — calc_forfettario → contributi_inps.fisso."
|
|
882
|
+
},
|
|
883
|
+
"inps_variabile": {
|
|
884
|
+
"type": "number",
|
|
885
|
+
"minimum": 0,
|
|
886
|
+
"maximum": 1000000,
|
|
887
|
+
"description": "Contributi INPS sull'eccedenza in euro — calc_forfettario → contributi_inps.variabile."
|
|
888
|
+
},
|
|
889
|
+
"inps_totale": {
|
|
890
|
+
"type": "number",
|
|
891
|
+
"minimum": 0,
|
|
892
|
+
"maximum": 1000000,
|
|
893
|
+
"description": "Totale contributi INPS in euro — calc_forfettario → contributi_inps.importo. Usato solo se fisso/variabile non sono forniti."
|
|
894
|
+
},
|
|
895
|
+
"startup": {
|
|
896
|
+
"type": "boolean",
|
|
897
|
+
"default": false,
|
|
898
|
+
"description": "Primo anno di attività: nessun acconto, si versa solo il saldo. Non è l'aliquota del 5% (che vale cinque anni): qui l'imposta arriva già calcolata."
|
|
899
|
+
},
|
|
900
|
+
"anno": {
|
|
901
|
+
"type": "integer",
|
|
902
|
+
"minimum": 2015,
|
|
903
|
+
"maximum": 2100,
|
|
904
|
+
"description": "Anno d'imposta di riferimento (es. 2026)."
|
|
905
|
+
}
|
|
906
|
+
},
|
|
907
|
+
"required": [
|
|
908
|
+
"imposta",
|
|
909
|
+
"anno"
|
|
910
|
+
],
|
|
911
|
+
"additionalProperties": false
|
|
912
|
+
},
|
|
913
|
+
"imu": {
|
|
914
|
+
"type": "object",
|
|
915
|
+
"description": "Richiesto quando kind='imu'. Campi dall'output di calc_imu.",
|
|
916
|
+
"properties": {
|
|
917
|
+
"imu_dovuta": {
|
|
918
|
+
"type": "number",
|
|
919
|
+
"minimum": 0,
|
|
920
|
+
"maximum": 10000000,
|
|
921
|
+
"description": "IMU annua dovuta in euro — calc_imu → imu_dovuta."
|
|
922
|
+
},
|
|
923
|
+
"acconto": {
|
|
924
|
+
"type": "number",
|
|
925
|
+
"minimum": 0,
|
|
926
|
+
"maximum": 10000000,
|
|
927
|
+
"description": "Acconto di giugno in euro — calc_imu → acconto_giugno."
|
|
928
|
+
},
|
|
929
|
+
"saldo": {
|
|
930
|
+
"type": "number",
|
|
931
|
+
"minimum": 0,
|
|
932
|
+
"maximum": 10000000,
|
|
933
|
+
"description": "Saldo di dicembre in euro — calc_imu → saldo_dicembre."
|
|
934
|
+
},
|
|
935
|
+
"base_imponibile": {
|
|
936
|
+
"type": "number",
|
|
937
|
+
"minimum": 0,
|
|
938
|
+
"description": "Base imponibile in euro — calc_imu → base_imponibile. Serve allo split del gruppo D."
|
|
939
|
+
},
|
|
940
|
+
"aliquota_permille": {
|
|
941
|
+
"type": "number",
|
|
942
|
+
"minimum": 0,
|
|
943
|
+
"maximum": 20,
|
|
944
|
+
"description": "Aliquota deliberata dal Comune in per mille — calc_imu → parametri.aliquota_permille. Serve allo split gruppo D (7,6‰ Stato + eccedenza Comune)."
|
|
945
|
+
},
|
|
946
|
+
"tipo_immobile": {
|
|
947
|
+
"type": "string",
|
|
948
|
+
"enum": [
|
|
949
|
+
"abitazione_principale_A1_A8_A9",
|
|
950
|
+
"abitazione_non_principale",
|
|
951
|
+
"immobile_produttivo",
|
|
952
|
+
"immobile_locato_canone_concordato",
|
|
953
|
+
"comodato_uso_parenti",
|
|
954
|
+
"terreno_agricolo",
|
|
955
|
+
"area_edificabile"
|
|
956
|
+
],
|
|
957
|
+
"description": "Tipo immobile — calc_imu → parametri.tipo_immobile. Determina il codice tributo IMU."
|
|
958
|
+
},
|
|
959
|
+
"categoria_catastale": {
|
|
960
|
+
"type": "string",
|
|
961
|
+
"enum": [
|
|
962
|
+
"A",
|
|
963
|
+
"A10",
|
|
964
|
+
"B",
|
|
965
|
+
"C1",
|
|
966
|
+
"C2_C6_C7",
|
|
967
|
+
"C3_C4_C5",
|
|
968
|
+
"D",
|
|
969
|
+
"D5",
|
|
970
|
+
"E",
|
|
971
|
+
"F"
|
|
972
|
+
],
|
|
973
|
+
"description": "Categoria catastale (default A) — calc_imu → parametri.categoria_catastale."
|
|
974
|
+
},
|
|
975
|
+
"codice_comune": {
|
|
976
|
+
"type": "string",
|
|
977
|
+
"pattern": "^[A-Za-z][0-9]{3}$",
|
|
978
|
+
"maxLength": 4,
|
|
979
|
+
"description": "Codice catastale/Belfiore del Comune = codice ente F24 (1 lettera + 3 cifre, es. H501 per Roma)."
|
|
980
|
+
},
|
|
981
|
+
"anno": {
|
|
982
|
+
"type": "integer",
|
|
983
|
+
"minimum": 2012,
|
|
984
|
+
"maximum": 2100,
|
|
985
|
+
"description": "Anno d'imposta di riferimento (es. 2026)."
|
|
986
|
+
}
|
|
987
|
+
},
|
|
988
|
+
"required": [
|
|
989
|
+
"imu_dovuta",
|
|
990
|
+
"acconto",
|
|
991
|
+
"saldo",
|
|
992
|
+
"tipo_immobile",
|
|
993
|
+
"codice_comune",
|
|
994
|
+
"anno"
|
|
995
|
+
],
|
|
996
|
+
"additionalProperties": false
|
|
997
|
+
}
|
|
998
|
+
},
|
|
999
|
+
"required": [
|
|
1000
|
+
"kind"
|
|
1001
|
+
],
|
|
1002
|
+
"allOf": [
|
|
1003
|
+
{
|
|
1004
|
+
"if": {
|
|
1005
|
+
"properties": {
|
|
1006
|
+
"kind": {
|
|
1007
|
+
"const": "forfettario"
|
|
1008
|
+
}
|
|
1009
|
+
},
|
|
1010
|
+
"required": [
|
|
1011
|
+
"kind"
|
|
1012
|
+
]
|
|
1013
|
+
},
|
|
1014
|
+
"then": {
|
|
1015
|
+
"required": [
|
|
1016
|
+
"forfettario"
|
|
1017
|
+
]
|
|
1018
|
+
}
|
|
1019
|
+
},
|
|
1020
|
+
{
|
|
1021
|
+
"if": {
|
|
1022
|
+
"properties": {
|
|
1023
|
+
"kind": {
|
|
1024
|
+
"const": "imu"
|
|
1025
|
+
}
|
|
1026
|
+
},
|
|
1027
|
+
"required": [
|
|
1028
|
+
"kind"
|
|
1029
|
+
]
|
|
1030
|
+
},
|
|
1031
|
+
"then": {
|
|
1032
|
+
"required": [
|
|
1033
|
+
"imu"
|
|
1034
|
+
]
|
|
1035
|
+
}
|
|
1036
|
+
},
|
|
1037
|
+
{
|
|
1038
|
+
"if": {
|
|
1039
|
+
"properties": {
|
|
1040
|
+
"kind": {
|
|
1041
|
+
"const": "bollo"
|
|
1042
|
+
}
|
|
1043
|
+
},
|
|
1044
|
+
"required": [
|
|
1045
|
+
"kind"
|
|
1046
|
+
]
|
|
1047
|
+
},
|
|
1048
|
+
"then": {
|
|
1049
|
+
"required": [
|
|
1050
|
+
"bollo"
|
|
1051
|
+
]
|
|
1052
|
+
}
|
|
1053
|
+
}
|
|
1054
|
+
],
|
|
1055
|
+
"additionalProperties": false
|
|
1056
|
+
}
|
|
1057
|
+
},
|
|
1058
|
+
{
|
|
1059
|
+
"name": "intrastat_periodicity",
|
|
1060
|
+
"title": "INTRASTAT: periodicità e scadenza di presentazione",
|
|
1061
|
+
"description": "Determina se un soggetto deve presentare l'elenco riepilogativo INTRASTAT e con quale periodicità (mensile / trimestrale / nessun obbligo), a partire dagli ammontari dei quattro trimestri precedenti, e calcola la SCADENZA del periodo (giorno 25 del mese successivo, con slittamento se cade di sabato, domenica o festività nazionale italiana). Ogni flusso ha soglia e criterio propri, e li restituisce insieme alla FONTE normativa: cessioni di beni e servizi resi € 50.000 con criterio di SUPERAMENTO (>) → mensile se superata, altrimenti trimestrale; acquisti di servizi € 100.000 e acquisti di beni € 2.000.000 (soglia innalzata da € 350.000 dal periodo di riferimento 01/2026, Det. ADM 84415 del 03/02/2026) con criterio UGUALE O SUPERIORE (>=) → mensile se raggiunta, altrimenti NESSUN obbligo (per gli acquisti la periodicità trimestrale è stata abrogata). L'asimmetria > / >= è voluta e rispecchia le fonti. Indicativo: non sostituisce il commercialista o il doganalista. Gratis (€0), deterministico, nessun login richiesto.",
|
|
1062
|
+
"inputSchema": {
|
|
1063
|
+
"type": "object",
|
|
1064
|
+
"properties": {
|
|
1065
|
+
"flusso": {
|
|
1066
|
+
"type": "string",
|
|
1067
|
+
"enum": [
|
|
1068
|
+
"cessioni",
|
|
1069
|
+
"acquisti"
|
|
1070
|
+
],
|
|
1071
|
+
"description": "'cessioni' = operazioni attive, modelli INTRA-1 (beni ceduti / servizi resi); 'acquisti' = operazioni passive, modelli INTRA-2 (beni acquistati / servizi ricevuti)."
|
|
1072
|
+
},
|
|
1073
|
+
"categoria": {
|
|
1074
|
+
"type": "string",
|
|
1075
|
+
"enum": [
|
|
1076
|
+
"beni",
|
|
1077
|
+
"servizi"
|
|
1078
|
+
],
|
|
1079
|
+
"description": "Categoria delle operazioni. Soglia e sezione del modello dipendono da questa."
|
|
1080
|
+
},
|
|
1081
|
+
"anno": {
|
|
1082
|
+
"type": "integer",
|
|
1083
|
+
"minimum": 2022,
|
|
1084
|
+
"maximum": 2100,
|
|
1085
|
+
"description": "Anno del periodo di RIFERIMENTO (non dell'invio). I modelli vigenti decorrono dal 2022. Determina quale soglia INTRA-2bis si applica (2.000.000 dal 2026)."
|
|
1086
|
+
},
|
|
1087
|
+
"mese": {
|
|
1088
|
+
"type": "integer",
|
|
1089
|
+
"minimum": 1,
|
|
1090
|
+
"maximum": 12,
|
|
1091
|
+
"description": "Mese del periodo di riferimento (1–12). Se la periodicità risulta trimestrale, il trimestre viene dedotto da questo mese."
|
|
1092
|
+
},
|
|
1093
|
+
"ammontari_trimestri_precedenti": {
|
|
1094
|
+
"type": "array",
|
|
1095
|
+
"items": {
|
|
1096
|
+
"type": "number",
|
|
1097
|
+
"minimum": 0
|
|
1098
|
+
},
|
|
1099
|
+
"minItems": 1,
|
|
1100
|
+
"maxItems": 4,
|
|
1101
|
+
"description": "Ammontari in EURO dei quattro trimestri PRECEDENTI per quel flusso+categoria, ordinati dal più recente al più remoto (es. [62000, 41000, 38000, 35000]). Ammessi da 1 a 4 valori: chi ha iniziato da poco ne ha meno, e la risposta lo segnala nelle note. La soglia si valuta sul MASSIMO, non sulla somma."
|
|
1102
|
+
}
|
|
1103
|
+
},
|
|
1104
|
+
"required": [
|
|
1105
|
+
"flusso",
|
|
1106
|
+
"categoria",
|
|
1107
|
+
"anno",
|
|
1108
|
+
"mese",
|
|
1109
|
+
"ammontari_trimestri_precedenti"
|
|
1110
|
+
],
|
|
1111
|
+
"additionalProperties": false
|
|
1112
|
+
}
|
|
1113
|
+
},
|
|
1114
|
+
{
|
|
1115
|
+
"name": "intrastat_compose",
|
|
1116
|
+
"title": "INTRASTAT: composizione e validazione delle sezioni",
|
|
1117
|
+
"description": "Compone le SEZIONI dell'elenco riepilogativo INTRASTAT a partire dalle righe di operazione, assegnando ciascuna riga alla sezione corretta (INTRA-1bis cessioni di beni, 1ter rettifiche, 1quater servizi resi, 1quinquies rettifiche, 1sexies call-off stock; INTRA-2bis acquisti di beni, 2ter, 2quater servizi ricevuti, 2quinquies) e VALIDANDOLE: Stato membro ammesso (l'Irlanda del Nord XI vale solo per i BENI; San Marino e Regno Unito sono fuori ambito), partita IVA della controparte (formato per Stato membro + checksum per quelle italiane), nomenclatura combinata a 8 cifre (o il codice semplificato 99500000), formato della natura della transazione e campi obbligatori per sezione. Restituisce le sezioni popolate, i totali, la scadenza e un prospetto testuale di controllo. ⚠️ NON genera il file TELEMATICO per il Servizio Telematico Doganale (Intr@Web / ADM): il tracciato record ufficiale non è riproducibile da fonte pubblica verificabile, quindi non è stato inventato. Quello che ottieni è struttura-dati + prospetto, da riportare sul canale ufficiale. Nessun default silenzioso: un dato obbligatorio mancante produce un errore esplicito, mai un riempimento arbitrario. Le partite IVA sono validate OFFLINE (formato e checksum): per la verifica VIES live della controparte usa `verify_payee`. Determina prima la periodicità con `intrastat_periodicity`. Indicativo, non sostituisce il commercialista o il doganalista. Gratis (€0), deterministico, nessun login richiesto.",
|
|
1118
|
+
"inputSchema": {
|
|
1119
|
+
"type": "object",
|
|
1120
|
+
"properties": {
|
|
1121
|
+
"anno": {
|
|
1122
|
+
"type": "integer",
|
|
1123
|
+
"minimum": 2022,
|
|
1124
|
+
"maximum": 2100,
|
|
1125
|
+
"description": "Anno del periodo di riferimento (i modelli vigenti decorrono dal 2022)."
|
|
1126
|
+
},
|
|
1127
|
+
"mese": {
|
|
1128
|
+
"type": "integer",
|
|
1129
|
+
"minimum": 1,
|
|
1130
|
+
"maximum": 12,
|
|
1131
|
+
"description": "Mese del periodo di riferimento (1–12). Con periodicità trimestrale individua il trimestre."
|
|
1132
|
+
},
|
|
1133
|
+
"periodicita": {
|
|
1134
|
+
"type": "string",
|
|
1135
|
+
"enum": [
|
|
1136
|
+
"mensile",
|
|
1137
|
+
"trimestrale",
|
|
1138
|
+
"nessun_obbligo"
|
|
1139
|
+
],
|
|
1140
|
+
"default": "mensile",
|
|
1141
|
+
"description": "Periodicità dell'elenco — determinala con `intrastat_periodicity`. Con 'nessun_obbligo' la chiamata viene RIFIUTATA con una spiegazione: sotto soglia l'elenco non va presentato."
|
|
1142
|
+
},
|
|
1143
|
+
"partita_iva_dichiarante": {
|
|
1144
|
+
"type": "string",
|
|
1145
|
+
"maxLength": 16,
|
|
1146
|
+
"description": "Partita IVA italiana del soggetto obbligato (11 cifre, opzionale). Se fornita viene validata col checksum."
|
|
1147
|
+
},
|
|
1148
|
+
"righe": {
|
|
1149
|
+
"type": "array",
|
|
1150
|
+
"minItems": 1,
|
|
1151
|
+
"maxItems": 25,
|
|
1152
|
+
"description": "Righe di operazione da riepilogare. Massimo 25 sulla superficie anonima (l'API autenticata non ha questo limite). Righe di flussi/categorie diversi possono coesistere: ognuna finisce nella sua sezione.",
|
|
1153
|
+
"items": {
|
|
1154
|
+
"type": "object",
|
|
1155
|
+
"properties": {
|
|
1156
|
+
"flusso": {
|
|
1157
|
+
"type": "string",
|
|
1158
|
+
"enum": [
|
|
1159
|
+
"cessioni",
|
|
1160
|
+
"acquisti"
|
|
1161
|
+
],
|
|
1162
|
+
"description": "cessioni = INTRA-1 (attive) · acquisti = INTRA-2 (passive)."
|
|
1163
|
+
},
|
|
1164
|
+
"categoria": {
|
|
1165
|
+
"type": "string",
|
|
1166
|
+
"enum": [
|
|
1167
|
+
"beni",
|
|
1168
|
+
"servizi"
|
|
1169
|
+
],
|
|
1170
|
+
"description": "Determina quali campi sono obbligatori: i campi BENI e i campi SERVIZI si escludono."
|
|
1171
|
+
},
|
|
1172
|
+
"rettifica": {
|
|
1173
|
+
"type": "boolean",
|
|
1174
|
+
"default": false,
|
|
1175
|
+
"description": "True se la riga rettifica un periodo PRECEDENTE → sezioni ter/quinquies. Richiede `anno_riferimento_rettifica`. Solo sulle rettifiche è ammesso un ammontare negativo."
|
|
1176
|
+
},
|
|
1177
|
+
"call_off_stock": {
|
|
1178
|
+
"type": "boolean",
|
|
1179
|
+
"default": false,
|
|
1180
|
+
"description": "Solo cessioni di BENI: regime call-off stock (art. 17-bis Dir. 2006/112/CE) → sezione INTRA-1sexies."
|
|
1181
|
+
},
|
|
1182
|
+
"paese_controparte": {
|
|
1183
|
+
"type": "string",
|
|
1184
|
+
"minLength": 2,
|
|
1185
|
+
"maxLength": 2,
|
|
1186
|
+
"description": "Codice ISO2 dello Stato membro della controparte (es. DE, FR, ES; EL per la Grecia, non GR). 'XI' (Irlanda del Nord) è ammesso SOLO per i beni. SM (San Marino) e GB sono fuori ambito e vengono rifiutati."
|
|
1187
|
+
},
|
|
1188
|
+
"partita_iva_controparte": {
|
|
1189
|
+
"type": "string",
|
|
1190
|
+
"maxLength": 24,
|
|
1191
|
+
"description": "Partita IVA della controparte, con o senza prefisso paese (es. DE123456789 o 123456789). Validata sul formato dello Stato membro; per le italiane anche col checksum. Nessuna interrogazione VIES."
|
|
1192
|
+
},
|
|
1193
|
+
"ammontare": {
|
|
1194
|
+
"type": "number",
|
|
1195
|
+
"description": "Ammontare delle operazioni in EURO. Negativo ammesso solo se rettifica=true."
|
|
1196
|
+
},
|
|
1197
|
+
"nomenclatura_combinata": {
|
|
1198
|
+
"type": "string",
|
|
1199
|
+
"pattern": "^\\d{8}$",
|
|
1200
|
+
"maxLength": 8,
|
|
1201
|
+
"description": "Solo BENI: codice NC a 8 cifre. Per spedizioni di valore inferiore a € 1.000 è ammesso il codice unico 99500000. Se ne valida il FORMATO, non l'esistenza nella NC dell'anno (la tabella NC è annuale e non è in repository)."
|
|
1202
|
+
},
|
|
1203
|
+
"massa_netta_kg": {
|
|
1204
|
+
"type": "number",
|
|
1205
|
+
"minimum": 0,
|
|
1206
|
+
"description": "Solo BENI: massa netta in kg."
|
|
1207
|
+
},
|
|
1208
|
+
"paese_origine": {
|
|
1209
|
+
"type": "string",
|
|
1210
|
+
"minLength": 2,
|
|
1211
|
+
"maxLength": 2,
|
|
1212
|
+
"description": "Solo BENI: paese di origine della merce (ISO2)."
|
|
1213
|
+
},
|
|
1214
|
+
"paese_destinazione": {
|
|
1215
|
+
"type": "string",
|
|
1216
|
+
"minLength": 2,
|
|
1217
|
+
"maxLength": 2,
|
|
1218
|
+
"description": "Solo BENI: paese di destinazione/provenienza della merce (ISO2)."
|
|
1219
|
+
},
|
|
1220
|
+
"natura_transazione": {
|
|
1221
|
+
"type": "string",
|
|
1222
|
+
"maxLength": 2,
|
|
1223
|
+
"description": "Solo BENI: codice natura della transazione — 1 cifra (colonna A) oppure 2 cifre (colonne A+B, obbligatorie oltre € 20.000.000 di scambi nell'anno precedente). Si valida SOLO il formato: le descrizioni dei codici sono l'Allegato XI alla Det. ADM 493869/RU/2021, non riproducibile da fonte testuale verificabile, e non vengono inventate."
|
|
1224
|
+
},
|
|
1225
|
+
"codice_servizio": {
|
|
1226
|
+
"type": "string",
|
|
1227
|
+
"pattern": "^\\d{6}$",
|
|
1228
|
+
"maxLength": 6,
|
|
1229
|
+
"description": "Solo SERVIZI: codice CPA a 6 cifre. Validato nel formato, non l'esistenza in tabella CPA."
|
|
1230
|
+
},
|
|
1231
|
+
"modalita_erogazione": {
|
|
1232
|
+
"type": "string",
|
|
1233
|
+
"enum": [
|
|
1234
|
+
"I",
|
|
1235
|
+
"R"
|
|
1236
|
+
],
|
|
1237
|
+
"description": "Solo SERVIZI: 'I' istantanea · 'R' a più riprese."
|
|
1238
|
+
},
|
|
1239
|
+
"modalita_incasso": {
|
|
1240
|
+
"type": "string",
|
|
1241
|
+
"enum": [
|
|
1242
|
+
"B",
|
|
1243
|
+
"A",
|
|
1244
|
+
"X"
|
|
1245
|
+
],
|
|
1246
|
+
"description": "Solo SERVIZI: 'B' bonifico · 'A' accredito · 'X' altro."
|
|
1247
|
+
},
|
|
1248
|
+
"anno_riferimento_rettifica": {
|
|
1249
|
+
"type": "integer",
|
|
1250
|
+
"minimum": 2022,
|
|
1251
|
+
"maximum": 2100,
|
|
1252
|
+
"description": "Obbligatorio se rettifica=true: anno del periodo rettificato."
|
|
1253
|
+
},
|
|
1254
|
+
"riferimento": {
|
|
1255
|
+
"type": "string",
|
|
1256
|
+
"maxLength": 64,
|
|
1257
|
+
"description": "Riferimento libero (es. numero fattura). Serve solo alla tua tracciabilità: non fa parte dell'elenco."
|
|
1258
|
+
}
|
|
1259
|
+
},
|
|
1260
|
+
"required": [
|
|
1261
|
+
"flusso",
|
|
1262
|
+
"categoria",
|
|
1263
|
+
"paese_controparte",
|
|
1264
|
+
"partita_iva_controparte",
|
|
1265
|
+
"ammontare"
|
|
1266
|
+
],
|
|
1267
|
+
"allOf": [
|
|
1268
|
+
{
|
|
1269
|
+
"if": {
|
|
1270
|
+
"properties": {
|
|
1271
|
+
"categoria": {
|
|
1272
|
+
"const": "beni"
|
|
1273
|
+
}
|
|
1274
|
+
},
|
|
1275
|
+
"required": [
|
|
1276
|
+
"categoria"
|
|
1277
|
+
]
|
|
1278
|
+
},
|
|
1279
|
+
"then": {
|
|
1280
|
+
"required": [
|
|
1281
|
+
"nomenclatura_combinata"
|
|
1282
|
+
]
|
|
1283
|
+
}
|
|
1284
|
+
},
|
|
1285
|
+
{
|
|
1286
|
+
"if": {
|
|
1287
|
+
"properties": {
|
|
1288
|
+
"categoria": {
|
|
1289
|
+
"const": "servizi"
|
|
1290
|
+
}
|
|
1291
|
+
},
|
|
1292
|
+
"required": [
|
|
1293
|
+
"categoria"
|
|
1294
|
+
]
|
|
1295
|
+
},
|
|
1296
|
+
"then": {
|
|
1297
|
+
"required": [
|
|
1298
|
+
"codice_servizio",
|
|
1299
|
+
"modalita_erogazione",
|
|
1300
|
+
"modalita_incasso"
|
|
1301
|
+
]
|
|
1302
|
+
}
|
|
1303
|
+
},
|
|
1304
|
+
{
|
|
1305
|
+
"if": {
|
|
1306
|
+
"properties": {
|
|
1307
|
+
"rettifica": {
|
|
1308
|
+
"const": true
|
|
1309
|
+
}
|
|
1310
|
+
},
|
|
1311
|
+
"required": [
|
|
1312
|
+
"rettifica"
|
|
1313
|
+
]
|
|
1314
|
+
},
|
|
1315
|
+
"then": {
|
|
1316
|
+
"required": [
|
|
1317
|
+
"anno_riferimento_rettifica"
|
|
1318
|
+
]
|
|
1319
|
+
}
|
|
1320
|
+
}
|
|
1321
|
+
],
|
|
1322
|
+
"additionalProperties": false
|
|
1323
|
+
}
|
|
1324
|
+
}
|
|
1325
|
+
},
|
|
1326
|
+
"required": [
|
|
1327
|
+
"anno",
|
|
1328
|
+
"mese",
|
|
1329
|
+
"righe"
|
|
1330
|
+
],
|
|
1331
|
+
"additionalProperties": false
|
|
1332
|
+
}
|
|
1333
|
+
},
|
|
1334
|
+
{
|
|
1335
|
+
"name": "intrastat_reference",
|
|
1336
|
+
"title": "INTRASTAT: tabelle di riferimento e soglie vigenti",
|
|
1337
|
+
"description": "Restituisce, senza alcun input, le tabelle di riferimento INTRASTAT: gli Stati membri ammessi con i loro codici, il caso dell'Irlanda del Nord (XI, solo beni) e i paesi fuori ambito (San Marino dal 01/10/2021, Regno Unito dal 01/01/2021), tutte le sezioni dei modelli con la loro descrizione, e OGNI soglia vigente con importo, criterio di confronto (> oppure >=), effetto e FONTE normativa puntuale — inclusa la soglia acquisti di beni innalzata a € 2.000.000 dal periodo 01/2026 (Det. ADM 84415 del 03/02/2026). Include anche il termine di presentazione e l'elenco ESPLICITO di ciò che questi strumenti NON producono (il file telematico ADM, le descrizioni dei codici natura della transazione, la verifica VIES live). Usalo per validare gli input prima di `intrastat_compose`, per popolare un form, o per citare la fonte di una soglia invece di ricordarla a memoria. Gratis (€0), deterministico, nessun login richiesto.",
|
|
1338
|
+
"inputSchema": {
|
|
1339
|
+
"type": "object",
|
|
1340
|
+
"properties": {},
|
|
1341
|
+
"required": [],
|
|
1342
|
+
"additionalProperties": false
|
|
1343
|
+
}
|
|
1344
|
+
},
|
|
1345
|
+
{
|
|
1346
|
+
"name": "nis2_tipologie",
|
|
1347
|
+
"title": "NIS2: elenco ufficiale delle tipologie di soggetto",
|
|
1348
|
+
"description": "Elenco ufficiale delle tipologie di soggetto degli allegati I–IV del D.Lgs. 4 settembre 2024 n. 138 (recepimento NIS2), verbatim dal testo di Gazzetta Ufficiale, con ricerca testuale. Serve a trovare il `tipologia_id` da passare a `nis2_ambito`. ⚠️ NON esiste alcuna mappa codice ATECO → tipologia, e questo strumento non ne usa una: la dichiarazione sulla piattaforma ACN (art. 11 c. 2 della determinazione ACN 127437/2026) tiene i codici ATECO e le tipologie di soggetto SEPARATI, e l'ambito si determina sulla TIPOLOGIA, definita per rinvio a una norma UE. Dedurre l'ambito NIS2 da un codice ATECO significa applicare una regola che la fonte non contiene. Gratis (€0), deterministico, nessun login richiesto.",
|
|
1349
|
+
"inputSchema": {
|
|
1350
|
+
"type": "object",
|
|
1351
|
+
"properties": {
|
|
1352
|
+
"q": {
|
|
1353
|
+
"type": "string",
|
|
1354
|
+
"maxLength": 120,
|
|
1355
|
+
"description": "Ricerca testuale su testo della tipologia, settore e sottosettore (accenti e maiuscole ignorati; tutti i termini devono comparire). Es. 'cloud', 'energia elettrica', 'rifiuti'. Vuoto = tutto il catalogo."
|
|
1356
|
+
},
|
|
1357
|
+
"allegato": {
|
|
1358
|
+
"type": "string",
|
|
1359
|
+
"enum": [
|
|
1360
|
+
"I",
|
|
1361
|
+
"II",
|
|
1362
|
+
"III",
|
|
1363
|
+
"IV"
|
|
1364
|
+
],
|
|
1365
|
+
"description": "Filtra per allegato. I = settori ad alta criticità (51 tipologie); II = altri settori critici (15); III = pubbliche amministrazioni (15); IV = ulteriori tipologie, che rientrano solo se individuate dall'ACN (4)."
|
|
1366
|
+
},
|
|
1367
|
+
"limit": {
|
|
1368
|
+
"type": "integer",
|
|
1369
|
+
"minimum": 1,
|
|
1370
|
+
"maximum": 200,
|
|
1371
|
+
"description": "Numero massimo di risultati (default 200)."
|
|
1372
|
+
}
|
|
1373
|
+
},
|
|
1374
|
+
"required": [],
|
|
1375
|
+
"additionalProperties": false
|
|
1376
|
+
}
|
|
1377
|
+
},
|
|
1378
|
+
{
|
|
1379
|
+
"name": "nis2_ambito",
|
|
1380
|
+
"title": "NIS2: ambito di applicazione e categoria del soggetto",
|
|
1381
|
+
"description": "Dice se un soggetto rientra nel campo di applicazione del D.Lgs. 138/2024 (NIS2) e se è soggetto ESSENZIALE o IMPORTANTE, citando ARTICOLO E COMMA per ogni passo del ragionamento. Quando manca un dato che cambierebbe la risposta restituisce `esito: \"indeterminato\"` e la DOMANDA da porre, invece di una risposta inventata. Le regole su cui si sbaglia più spesso, tutte applicate qui: (1) la soglia di INGRESSO è quella della PICCOLA impresa, non della media — si è dentro con occupati >= 50 OPPURE (fatturato > 10 M€ E bilancio > 10 M€) — quindi l'ambito è molto più largo di come viene raccontato; (2) per superare un massimale servono gli occupati sopra soglia OPPURE ENTRAMBI i valori finanziari sopra soglia: 30 dipendenti con 12 M€ di fatturato e 8 M€ di bilancio è ancora PICCOLA, quindi FUORI; (3) l'art. 3 §4 della raccomandazione 2003/361/CE è DISAPPLICATO (art. 3 c. 3): una partecipazione pubblica pari o superiore al 25% non fa perdere lo stato di PMI; (4) un soggetto dell'allegato II non è MAI essenziale per dimensione — l'art. 6 c. 1 lett. a) cita solo l'allegato I — nemmeno con migliaia di dipendenti. Non registra nulla presso l'ACN: è il pre-volo della dichiarazione, la cui valutazione preliminare è svolta automaticamente dalla piattaforma ACN (art. 11 c. 6 della determinazione ACN 127437/2026); l’inserimento o meno nell'elenco dei soggetti NIS lo comunica poi l'ACN (art. 15 c. 3 della determinazione). Indicativo, non è un parere legale. Gratis (€0), deterministico, nessun login richiesto.",
|
|
1382
|
+
"inputSchema": {
|
|
1383
|
+
"type": "object",
|
|
1384
|
+
"properties": {
|
|
1385
|
+
"tipologia_id": {
|
|
1386
|
+
"type": "string",
|
|
1387
|
+
"maxLength": 32,
|
|
1388
|
+
"description": "Id della tipologia dall'elenco ufficiale — ottienilo con `nis2_tipologie`. Es. 'I.1.a.1' (impresa elettrica), 'III.a.2' (Ministeri). NON è un codice ATECO."
|
|
1389
|
+
},
|
|
1390
|
+
"occupati": {
|
|
1391
|
+
"type": "integer",
|
|
1392
|
+
"minimum": 0,
|
|
1393
|
+
"description": "Numero di occupati (unità lavorative-anno)."
|
|
1394
|
+
},
|
|
1395
|
+
"fatturato_eur": {
|
|
1396
|
+
"type": "number",
|
|
1397
|
+
"minimum": 0,
|
|
1398
|
+
"description": "Fatturato annuo in euro."
|
|
1399
|
+
},
|
|
1400
|
+
"bilancio_eur": {
|
|
1401
|
+
"type": "number",
|
|
1402
|
+
"minimum": 0,
|
|
1403
|
+
"description": "Totale di bilancio annuo in euro."
|
|
1404
|
+
},
|
|
1405
|
+
"impresa_autonoma": {
|
|
1406
|
+
"type": "boolean",
|
|
1407
|
+
"description": "false se il soggetto ha imprese collegate o associate: l'art. 3 c. 4 impone allora il consolidamento ex art. 6 §2 della raccomandazione. Omettilo se non lo sai — lo strumento chiede. Un superamento già visibile sui dati individuali resta valido (il consolidamento può solo aumentare i valori); un NON superamento no."
|
|
1408
|
+
},
|
|
1409
|
+
"dati_consolidati": {
|
|
1410
|
+
"type": "boolean",
|
|
1411
|
+
"description": "true se i valori dimensionali forniti sono GIÀ consolidati di gruppo."
|
|
1412
|
+
},
|
|
1413
|
+
"soggetto_critico_cer": {
|
|
1414
|
+
"type": "boolean",
|
|
1415
|
+
"description": "true se il soggetto è identificato come soggetto critico ai sensi del decreto che recepisce la direttiva (UE) 2022/2557 (CER): rientra ed è ESSENZIALE a prescindere dalla dimensione (art. 3 c. 5 lett. a; art. 6 c. 1 lett. b)."
|
|
1416
|
+
},
|
|
1417
|
+
"prestatore_fiduciario_qualificato": {
|
|
1418
|
+
"type": "boolean",
|
|
1419
|
+
"description": "Solo per i prestatori di servizi fiduciari: i QUALIFICATI sono essenziali a prescindere dalla dimensione (art. 6 c. 1 lett. d), i non qualificati no."
|
|
1420
|
+
},
|
|
1421
|
+
"individuato_da_acn": {
|
|
1422
|
+
"type": "boolean",
|
|
1423
|
+
"description": "true se l'Autorità nazionale competente NIS ha notificato l'individuazione (art. 3 c. 13). Per l'allegato IV è LA condizione dell'ambito: senza, non è auto-valutabile e lo strumento lo dichiara invece di indovinare."
|
|
1424
|
+
},
|
|
1425
|
+
"criteri_impresa_collegata": {
|
|
1426
|
+
"type": "array",
|
|
1427
|
+
"items": {
|
|
1428
|
+
"type": "string",
|
|
1429
|
+
"enum": [
|
|
1430
|
+
"a",
|
|
1431
|
+
"b",
|
|
1432
|
+
"c",
|
|
1433
|
+
"d"
|
|
1434
|
+
]
|
|
1435
|
+
},
|
|
1436
|
+
"maxItems": 4,
|
|
1437
|
+
"description": "Lettere dell'art. 3 c. 10 soddisfatte quando il soggetto è impresa collegata a un soggetto essenziale o importante: a) influenza dominante sulle decisioni relative alle misure di gestione del rischio; b) detiene o gestisce i sistemi da cui dipende la fornitura del servizio; c) ne effettua le operazioni di sicurezza informatica; d) gli fornisce servizi TIC o di sicurezza. Anche una sola lettera lo fa rientrare a prescindere dalla dimensione."
|
|
1438
|
+
}
|
|
1439
|
+
},
|
|
1440
|
+
"required": [
|
|
1441
|
+
"tipologia_id"
|
|
1442
|
+
],
|
|
1443
|
+
"additionalProperties": false
|
|
1444
|
+
}
|
|
1445
|
+
},
|
|
1446
|
+
{
|
|
1447
|
+
"name": "nis2_reference",
|
|
1448
|
+
"title": "NIS2: soglie, regole e fonti",
|
|
1449
|
+
"description": "Restituisce, senza alcun input, le soglie dimensionali NIS2 con la formula esatta di superamento e la fonte (raccomandazione 2003/361/CE, allegato, art. 2 §1 e §2, riprodotto testualmente nelle note all'art. 6 in Gazzetta Ufficiale), la regola di ogni comma rilevante dell'art. 3 e dell'art. 6, i quattro criteri dell'impresa collegata, la finestra di registrazione sulla piattaforma ACN (dal 1° gennaio al 28 febbraio di OGNI anno: è ricorrente, non una scadenza singola) e l'elenco ESPLICITO di ciò che questo dominio NON copre. Include il caso dei settori 3 e 4 dell'allegato I (bancario e infrastrutture dei mercati finanziari), per i quali l'art. 3 c. 14 sostituisce l'art. 17 e i Capi IV e V con il regolamento (UE) 2022/2554 (DORA). Usalo per citare la fonte di una soglia invece di ricordarla a memoria. Gratis (€0), deterministico, nessun login richiesto.",
|
|
1450
|
+
"inputSchema": {
|
|
1451
|
+
"type": "object",
|
|
1452
|
+
"properties": {},
|
|
1453
|
+
"required": [],
|
|
1454
|
+
"additionalProperties": false
|
|
1455
|
+
}
|
|
1456
|
+
},
|
|
1457
|
+
{
|
|
1458
|
+
"name": "verify_payee",
|
|
1459
|
+
"title": "Verifica Fornitore (anti-frode pre-pagamento)",
|
|
1460
|
+
"description": "Verifica anti-frode di un beneficiario PRIMA di pagare una fattura (contro la truffa del cambio-IBAN / Business Email Compromise). Controlli: IBAN (checksum MOD-97 + banca dal codice ABI), Partita IVA e Codice Fiscale (checksum), e — quando il servizio UE è raggiungibile — la ragione sociale reale via VIES live con match sul nome atteso. Restituisce un verdetto (ok / non_verificabile / attenzione / alto_rischio) + i red flag puntuali. `non_verificabile` = nessun segnale di frode MA nessuna fonte autorevole ha confermato chi sia il fornitore (P.IVA italiana non iscritta al VIES, o nessuna P.IVA fornita): non è un allarme, è il rifiuto di dire «ok» su un soggetto non identificato. A differenza degli altri strumenti fa I/O esterno (VIES): se VIES è giù o il budget di verifica è temporaneamente esaurito, il verdetto degrada ONESTAMENTE ad \"attenzione\" (mai un falso \"ok\"). Gratis (€0), nessun login. NON sostituisce la verifica out-of-band (telefonata al fornitore su un numero già noto).",
|
|
1461
|
+
"inputSchema": {
|
|
1462
|
+
"type": "object",
|
|
1463
|
+
"properties": {
|
|
1464
|
+
"iban": {
|
|
1465
|
+
"type": "string",
|
|
1466
|
+
"maxLength": 64,
|
|
1467
|
+
"description": "IBAN del beneficiario (es. IT60X0542811101000000123456)."
|
|
1468
|
+
},
|
|
1469
|
+
"vat_number": {
|
|
1470
|
+
"type": "string",
|
|
1471
|
+
"maxLength": 32,
|
|
1472
|
+
"description": "Partita IVA con o senza prefisso paese (es. IT12345678901)."
|
|
1473
|
+
},
|
|
1474
|
+
"codice_fiscale": {
|
|
1475
|
+
"type": "string",
|
|
1476
|
+
"maxLength": 32,
|
|
1477
|
+
"description": "Codice Fiscale (persona fisica / ditta individuale)."
|
|
1478
|
+
},
|
|
1479
|
+
"expected_name": {
|
|
1480
|
+
"type": "string",
|
|
1481
|
+
"maxLength": 140,
|
|
1482
|
+
"description": "Ragione sociale attesa del fornitore, confrontata con quella ufficiale VIES."
|
|
1483
|
+
},
|
|
1484
|
+
"expected_country": {
|
|
1485
|
+
"type": "string",
|
|
1486
|
+
"maxLength": 2,
|
|
1487
|
+
"description": "Paese atteso del fornitore in ISO2 (default IT). Un IBAN estero è il campanello #1 della frode."
|
|
1488
|
+
},
|
|
1489
|
+
"ateco": {
|
|
1490
|
+
"type": "string",
|
|
1491
|
+
"pattern": "^[0-9.]{1,12}$",
|
|
1492
|
+
"maxLength": 12,
|
|
1493
|
+
"description": "Codice ATECO dichiarato del fornitore (solo cifre e punti, opzionale)."
|
|
1494
|
+
}
|
|
1495
|
+
},
|
|
1496
|
+
"required": [],
|
|
1497
|
+
"anyOf": [
|
|
1498
|
+
{
|
|
1499
|
+
"required": [
|
|
1500
|
+
"iban"
|
|
1501
|
+
]
|
|
1502
|
+
},
|
|
1503
|
+
{
|
|
1504
|
+
"required": [
|
|
1505
|
+
"vat_number"
|
|
1506
|
+
]
|
|
1507
|
+
},
|
|
1508
|
+
{
|
|
1509
|
+
"required": [
|
|
1510
|
+
"codice_fiscale"
|
|
1511
|
+
]
|
|
1512
|
+
}
|
|
1513
|
+
],
|
|
1514
|
+
"additionalProperties": false
|
|
1515
|
+
}
|
|
1516
|
+
},
|
|
1517
|
+
{
|
|
1518
|
+
"name": "guardian_list_suppliers",
|
|
1519
|
+
"title": "Fornitori sorvegliati",
|
|
1520
|
+
"description": "Elenca i fornitori che questo account sta sorvegliando, con lo stato della verifica VIES piu' recente e quanti IBAN risultano confermati o in attesa di conferma. Gli IBAN sono restituiti MASCHERATI. Richiede una API key (account gratuito su https://imperioutils.com/signup). Non consuma crediti.",
|
|
1521
|
+
"inputSchema": {
|
|
1522
|
+
"type": "object",
|
|
1523
|
+
"properties": {
|
|
1524
|
+
"only_alerting": {
|
|
1525
|
+
"type": "boolean",
|
|
1526
|
+
"description": "Se true, restituisce solo i fornitori che meritano attenzione: IBAN in attesa di conferma, oppure ultima verifica VIES non superata."
|
|
1527
|
+
}
|
|
1528
|
+
},
|
|
1529
|
+
"additionalProperties": false
|
|
1530
|
+
}
|
|
1531
|
+
},
|
|
1532
|
+
{
|
|
1533
|
+
"name": "guardian_supplier_ledger",
|
|
1534
|
+
"title": "Libretto IBAN di un fornitore",
|
|
1535
|
+
"description": "Lo storico degli IBAN visti per un fornitore: quali sono confermati, quali sono in attesa di conferma umana, quali sono stati rifiutati, e da quando. E' la memoria contro cui si giudica un IBAN nuovo. Gli IBAN sono MASCHERATI (paese, banca, ultime 4 cifre). Richiede una API key (account gratuito su https://imperioutils.com/signup). Non consuma crediti.",
|
|
1536
|
+
"inputSchema": {
|
|
1537
|
+
"type": "object",
|
|
1538
|
+
"properties": {
|
|
1539
|
+
"partita_iva": {
|
|
1540
|
+
"type": "string",
|
|
1541
|
+
"maxLength": 20,
|
|
1542
|
+
"description": "Partita IVA del fornitore (con o senza prefisso IT)."
|
|
1543
|
+
},
|
|
1544
|
+
"codice_fiscale": {
|
|
1545
|
+
"type": "string",
|
|
1546
|
+
"maxLength": 20,
|
|
1547
|
+
"description": "Codice Fiscale del fornitore."
|
|
1548
|
+
}
|
|
1549
|
+
},
|
|
1550
|
+
"anyOf": [
|
|
1551
|
+
{
|
|
1552
|
+
"required": [
|
|
1553
|
+
"partita_iva"
|
|
1554
|
+
]
|
|
1555
|
+
},
|
|
1556
|
+
{
|
|
1557
|
+
"required": [
|
|
1558
|
+
"codice_fiscale"
|
|
1559
|
+
]
|
|
1560
|
+
}
|
|
1561
|
+
],
|
|
1562
|
+
"additionalProperties": false
|
|
1563
|
+
}
|
|
1564
|
+
},
|
|
1565
|
+
{
|
|
1566
|
+
"name": "guardian_supplier_status",
|
|
1567
|
+
"title": "Stato di sorveglianza di un fornitore",
|
|
1568
|
+
"description": "Dice se un fornitore e' sorvegliato da questo account e come e' andata l'ultima verifica: esito VIES, se la risposta era autorevole, da quando non se ne ottiene una, e le eventuali anomalie rilevate. Richiede una API key (account gratuito su https://imperioutils.com/signup). Non consuma crediti.",
|
|
1569
|
+
"inputSchema": {
|
|
1570
|
+
"type": "object",
|
|
1571
|
+
"properties": {
|
|
1572
|
+
"partita_iva": {
|
|
1573
|
+
"type": "string",
|
|
1574
|
+
"maxLength": 20,
|
|
1575
|
+
"description": "Partita IVA del fornitore (con o senza prefisso IT)."
|
|
1576
|
+
},
|
|
1577
|
+
"codice_fiscale": {
|
|
1578
|
+
"type": "string",
|
|
1579
|
+
"maxLength": 20,
|
|
1580
|
+
"description": "Codice Fiscale del fornitore."
|
|
1581
|
+
}
|
|
1582
|
+
},
|
|
1583
|
+
"anyOf": [
|
|
1584
|
+
{
|
|
1585
|
+
"required": [
|
|
1586
|
+
"partita_iva"
|
|
1587
|
+
]
|
|
1588
|
+
},
|
|
1589
|
+
{
|
|
1590
|
+
"required": [
|
|
1591
|
+
"codice_fiscale"
|
|
1592
|
+
]
|
|
1593
|
+
}
|
|
1594
|
+
],
|
|
1595
|
+
"additionalProperties": false
|
|
1596
|
+
}
|
|
1597
|
+
},
|
|
1598
|
+
{
|
|
1599
|
+
"name": "guardian_check_iban",
|
|
1600
|
+
"title": "Confronta un IBAN col libretto del fornitore",
|
|
1601
|
+
"description": "Il gesto anti-BEC: confronta l'IBAN letto su una fattura con lo storico di quel fornitore e dice se e' gia' confermato, gia' visto ma mai confermato, o MAI VISTO. ATTENZIONE, questo strumento MODIFICA lo stato: un IBAN mai visto viene registrato come \"in attesa di conferma\" e all'intestatario dell'account parte un'email di avviso. La conferma di un IBAN NON e' esposta agli agenti: e' un atto che richiede una persona, e si compie su https://imperioutils.com/tools/supplier-monitors. Richiede una API key (account gratuito su https://imperioutils.com/signup). Non consuma crediti.",
|
|
1602
|
+
"inputSchema": {
|
|
1603
|
+
"type": "object",
|
|
1604
|
+
"properties": {
|
|
1605
|
+
"iban": {
|
|
1606
|
+
"type": "string",
|
|
1607
|
+
"maxLength": 40,
|
|
1608
|
+
"description": "IBAN riportato sul documento da pagare."
|
|
1609
|
+
},
|
|
1610
|
+
"partita_iva": {
|
|
1611
|
+
"type": "string",
|
|
1612
|
+
"maxLength": 20,
|
|
1613
|
+
"description": "Partita IVA del fornitore (con o senza prefisso IT)."
|
|
1614
|
+
},
|
|
1615
|
+
"codice_fiscale": {
|
|
1616
|
+
"type": "string",
|
|
1617
|
+
"maxLength": 20,
|
|
1618
|
+
"description": "Codice Fiscale del fornitore."
|
|
1619
|
+
}
|
|
1620
|
+
},
|
|
1621
|
+
"required": [
|
|
1622
|
+
"iban"
|
|
1623
|
+
],
|
|
1624
|
+
"anyOf": [
|
|
1625
|
+
{
|
|
1626
|
+
"required": [
|
|
1627
|
+
"partita_iva"
|
|
1628
|
+
]
|
|
1629
|
+
},
|
|
1630
|
+
{
|
|
1631
|
+
"required": [
|
|
1632
|
+
"codice_fiscale"
|
|
1633
|
+
]
|
|
1634
|
+
}
|
|
1635
|
+
],
|
|
1636
|
+
"additionalProperties": false
|
|
1637
|
+
}
|
|
1638
|
+
},
|
|
1639
|
+
{
|
|
1640
|
+
"name": "guardian_watch_supplier",
|
|
1641
|
+
"title": "Metti dei fornitori sotto sorveglianza",
|
|
1642
|
+
"description": "Registra uno o piu' fornitori nel guardiano, perche' i loro cambi di IBAN e le variazioni VIES vengano intercettati dalle verifiche notturne. Gli IBAN indicati entrano nel libretto come \"in attesa di conferma\", MAI come confermati: un IBAN letto su un documento non e' una baseline. Cio' che resta fuori (piano pieno, gia' sorvegliato, identita' assente) viene restituito contato e motivato. Richiede una API key (account gratuito su https://imperioutils.com/signup). Non consuma crediti.",
|
|
1643
|
+
"inputSchema": {
|
|
1644
|
+
"type": "object",
|
|
1645
|
+
"properties": {
|
|
1646
|
+
"suppliers": {
|
|
1647
|
+
"type": "array",
|
|
1648
|
+
"minItems": 1,
|
|
1649
|
+
"maxItems": 100,
|
|
1650
|
+
"description": "I fornitori da sorvegliare. Per ciascuno serve la Partita IVA oppure il Codice Fiscale.",
|
|
1651
|
+
"items": {
|
|
1652
|
+
"type": "object",
|
|
1653
|
+
"properties": {
|
|
1654
|
+
"partita_iva": {
|
|
1655
|
+
"type": "string",
|
|
1656
|
+
"maxLength": 20,
|
|
1657
|
+
"description": "Partita IVA del fornitore (con o senza prefisso IT)."
|
|
1658
|
+
},
|
|
1659
|
+
"codice_fiscale": {
|
|
1660
|
+
"type": "string",
|
|
1661
|
+
"maxLength": 20,
|
|
1662
|
+
"description": "Codice Fiscale del fornitore."
|
|
1663
|
+
},
|
|
1664
|
+
"expected_name": {
|
|
1665
|
+
"type": "string",
|
|
1666
|
+
"maxLength": 160,
|
|
1667
|
+
"description": "Ragione sociale attesa."
|
|
1668
|
+
},
|
|
1669
|
+
"expected_country": {
|
|
1670
|
+
"type": "string",
|
|
1671
|
+
"maxLength": 2,
|
|
1672
|
+
"description": "Paese ATTESO del fornitore (ISO-2). Se omesso vale IT. E' il paese contro cui si giudica un IBAN estero: dichiararlo evita avvisi fabbricati su fornitori legittimamente stranieri."
|
|
1673
|
+
},
|
|
1674
|
+
"label": {
|
|
1675
|
+
"type": "string",
|
|
1676
|
+
"maxLength": 160,
|
|
1677
|
+
"description": "Etichetta libera."
|
|
1678
|
+
},
|
|
1679
|
+
"iban": {
|
|
1680
|
+
"type": "string",
|
|
1681
|
+
"maxLength": 40,
|
|
1682
|
+
"description": "IBAN letto sul documento. Entra nel libretto come \"in attesa di conferma\"."
|
|
1683
|
+
}
|
|
1684
|
+
},
|
|
1685
|
+
"anyOf": [
|
|
1686
|
+
{
|
|
1687
|
+
"required": [
|
|
1688
|
+
"partita_iva"
|
|
1689
|
+
]
|
|
1690
|
+
},
|
|
1691
|
+
{
|
|
1692
|
+
"required": [
|
|
1693
|
+
"codice_fiscale"
|
|
1694
|
+
]
|
|
1695
|
+
}
|
|
1696
|
+
],
|
|
1697
|
+
"additionalProperties": false
|
|
1698
|
+
}
|
|
1699
|
+
}
|
|
1700
|
+
},
|
|
1701
|
+
"required": [
|
|
1702
|
+
"suppliers"
|
|
1703
|
+
],
|
|
1704
|
+
"additionalProperties": false
|
|
1705
|
+
}
|
|
1706
|
+
}
|
|
1707
|
+
];
|
|
1708
|
+
export const TOOL_NAMES = TOOL_DEFS.map((t) => t.name);
|
|
1709
|
+
/** Whether `name` belongs to the captured surface. */
|
|
1710
|
+
export function isKnownTool(name) {
|
|
1711
|
+
return TOOL_NAMES.includes(name);
|
|
1712
|
+
}
|
|
1713
|
+
/* ------------------------------------------------------------------ */
|
|
1714
|
+
/* Forwarding client */
|
|
1715
|
+
/* ------------------------------------------------------------------ */
|
|
1716
|
+
function errorResult(detail) {
|
|
1717
|
+
return {
|
|
1718
|
+
content: [{ type: "text", text: `fiscocheck error: ${detail}` }],
|
|
1719
|
+
isError: true,
|
|
1720
|
+
};
|
|
1721
|
+
}
|
|
1722
|
+
function rpcErrorMessage(error) {
|
|
1723
|
+
if (error !== null && typeof error === "object") {
|
|
1724
|
+
const message = error.message;
|
|
1725
|
+
if (typeof message === "string" && message !== "")
|
|
1726
|
+
return message;
|
|
1727
|
+
return JSON.stringify(error);
|
|
1728
|
+
}
|
|
1729
|
+
return String(error);
|
|
1730
|
+
}
|
|
1731
|
+
/**
|
|
1732
|
+
* Read a JSON-RPC response body, tolerating SSE framing.
|
|
1733
|
+
* Returns the message whose id matches `expectedId` when
|
|
1734
|
+
* present, otherwise the last parseable message, otherwise
|
|
1735
|
+
* null when nothing in the body parses.
|
|
1736
|
+
*/
|
|
1737
|
+
export function parseRpcBody(text, expectedId) {
|
|
1738
|
+
const trimmed = text.trim();
|
|
1739
|
+
if (trimmed === "")
|
|
1740
|
+
return null;
|
|
1741
|
+
const candidates = [];
|
|
1742
|
+
const tryPush = (payload) => {
|
|
1743
|
+
try {
|
|
1744
|
+
const parsed = JSON.parse(payload);
|
|
1745
|
+
if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
|
|
1746
|
+
candidates.push(parsed);
|
|
1747
|
+
}
|
|
1748
|
+
}
|
|
1749
|
+
catch {
|
|
1750
|
+
// Not a JSON payload; skip this candidate.
|
|
1751
|
+
}
|
|
1752
|
+
};
|
|
1753
|
+
if (trimmed.includes("data:")) {
|
|
1754
|
+
for (const line of trimmed.split("\n")) {
|
|
1755
|
+
const t = line.trim();
|
|
1756
|
+
if (!t.startsWith("data:"))
|
|
1757
|
+
continue;
|
|
1758
|
+
const payload = t.slice("data:".length).trim();
|
|
1759
|
+
if (payload !== "" && payload !== "[DONE]")
|
|
1760
|
+
tryPush(payload);
|
|
1761
|
+
}
|
|
1762
|
+
}
|
|
1763
|
+
else {
|
|
1764
|
+
tryPush(trimmed);
|
|
1765
|
+
}
|
|
1766
|
+
if (candidates.length === 0)
|
|
1767
|
+
return null;
|
|
1768
|
+
if (expectedId !== undefined) {
|
|
1769
|
+
const match = candidates.find((c) => c.id === expectedId);
|
|
1770
|
+
if (match !== undefined)
|
|
1771
|
+
return match;
|
|
1772
|
+
}
|
|
1773
|
+
return candidates[candidates.length - 1];
|
|
1774
|
+
}
|
|
1775
|
+
async function defaultFetch(url, init) {
|
|
1776
|
+
return fetch(url, init);
|
|
1777
|
+
}
|
|
1778
|
+
/**
|
|
1779
|
+
* A forwarding client that holds a single upstream
|
|
1780
|
+
* session, opened lazily on first use and reused from
|
|
1781
|
+
* then on (for the process lifetime in the MCP server,
|
|
1782
|
+
* or for a single invocation in the CLI).
|
|
1783
|
+
*/
|
|
1784
|
+
export class FiscocheckClient {
|
|
1785
|
+
deps;
|
|
1786
|
+
sessionId = null;
|
|
1787
|
+
ready = false;
|
|
1788
|
+
sessionPromise = null;
|
|
1789
|
+
idCounter = 0;
|
|
1790
|
+
constructor(deps = {}) {
|
|
1791
|
+
this.deps = deps;
|
|
1792
|
+
}
|
|
1793
|
+
fetchFn() {
|
|
1794
|
+
return this.deps.fetchFn ?? defaultFetch;
|
|
1795
|
+
}
|
|
1796
|
+
endpointUrl() {
|
|
1797
|
+
if (this.deps.url && this.deps.url.trim() !== "")
|
|
1798
|
+
return this.deps.url.trim();
|
|
1799
|
+
const raw = (this.deps.env ?? process.env).IMPERIOUTILS_MCP_URL;
|
|
1800
|
+
if (raw && raw.trim() !== "")
|
|
1801
|
+
return raw.trim();
|
|
1802
|
+
return DEFAULT_ENDPOINT_URL;
|
|
1803
|
+
}
|
|
1804
|
+
apiKey() {
|
|
1805
|
+
const raw = (this.deps.env ?? process.env).IMPERIOUTILS_API_KEY;
|
|
1806
|
+
if (raw && raw.trim() !== "")
|
|
1807
|
+
return raw.trim();
|
|
1808
|
+
return null;
|
|
1809
|
+
}
|
|
1810
|
+
timeoutMs() {
|
|
1811
|
+
if (typeof this.deps.timeoutMs === "number" && this.deps.timeoutMs > 0) {
|
|
1812
|
+
return this.deps.timeoutMs;
|
|
1813
|
+
}
|
|
1814
|
+
return DEFAULT_TIMEOUT_MS;
|
|
1815
|
+
}
|
|
1816
|
+
nextId() {
|
|
1817
|
+
this.idCounter += 1;
|
|
1818
|
+
return this.idCounter;
|
|
1819
|
+
}
|
|
1820
|
+
async post(body, withSession) {
|
|
1821
|
+
const headers = {
|
|
1822
|
+
"Content-Type": "application/json",
|
|
1823
|
+
Accept: "application/json, text/event-stream",
|
|
1824
|
+
};
|
|
1825
|
+
const key = this.apiKey();
|
|
1826
|
+
if (key !== null)
|
|
1827
|
+
headers["X-API-Key"] = key;
|
|
1828
|
+
if (withSession && this.sessionId !== null) {
|
|
1829
|
+
headers["Mcp-Session-Id"] = this.sessionId;
|
|
1830
|
+
}
|
|
1831
|
+
const controller = new AbortController();
|
|
1832
|
+
const timer = setTimeout(() => controller.abort(), this.timeoutMs());
|
|
1833
|
+
try {
|
|
1834
|
+
return await this.fetchFn()(this.endpointUrl(), {
|
|
1835
|
+
method: "POST",
|
|
1836
|
+
headers,
|
|
1837
|
+
body: JSON.stringify(body),
|
|
1838
|
+
signal: controller.signal,
|
|
1839
|
+
});
|
|
1840
|
+
}
|
|
1841
|
+
finally {
|
|
1842
|
+
clearTimeout(timer);
|
|
1843
|
+
}
|
|
1844
|
+
}
|
|
1845
|
+
async ensureSession() {
|
|
1846
|
+
if (this.ready)
|
|
1847
|
+
return;
|
|
1848
|
+
if (this.sessionPromise === null) {
|
|
1849
|
+
this.sessionPromise = (async () => {
|
|
1850
|
+
const initId = this.nextId();
|
|
1851
|
+
const initRes = await this.post({
|
|
1852
|
+
jsonrpc: "2.0",
|
|
1853
|
+
id: initId,
|
|
1854
|
+
method: "initialize",
|
|
1855
|
+
params: {
|
|
1856
|
+
protocolVersion: PROTOCOL_VERSION,
|
|
1857
|
+
capabilities: {},
|
|
1858
|
+
clientInfo: { name: "fiscocheck", version: VERSION },
|
|
1859
|
+
},
|
|
1860
|
+
}, false);
|
|
1861
|
+
const sessionId = initRes.headers.get("mcp-session-id");
|
|
1862
|
+
if (sessionId)
|
|
1863
|
+
this.sessionId = sessionId;
|
|
1864
|
+
const initText = await initRes.text();
|
|
1865
|
+
const initParsed = parseRpcBody(initText, initId);
|
|
1866
|
+
if (initParsed !== null && initParsed.error) {
|
|
1867
|
+
throw new Error(rpcErrorMessage(initParsed.error));
|
|
1868
|
+
}
|
|
1869
|
+
if (initRes.status < 200 || initRes.status >= 300) {
|
|
1870
|
+
throw new Error(`HTTP ${initRes.status}`);
|
|
1871
|
+
}
|
|
1872
|
+
if (initParsed === null && initText.trim() !== "") {
|
|
1873
|
+
throw new Error("malformed response");
|
|
1874
|
+
}
|
|
1875
|
+
const initializedRes = await this.post({ jsonrpc: "2.0", method: "notifications/initialized" }, true);
|
|
1876
|
+
try {
|
|
1877
|
+
await initializedRes.text();
|
|
1878
|
+
}
|
|
1879
|
+
catch {
|
|
1880
|
+
// Nothing needed from the notification response body.
|
|
1881
|
+
}
|
|
1882
|
+
this.ready = true;
|
|
1883
|
+
})();
|
|
1884
|
+
}
|
|
1885
|
+
try {
|
|
1886
|
+
await this.sessionPromise;
|
|
1887
|
+
}
|
|
1888
|
+
catch (err) {
|
|
1889
|
+
this.sessionPromise = null;
|
|
1890
|
+
this.sessionId = null;
|
|
1891
|
+
throw err;
|
|
1892
|
+
}
|
|
1893
|
+
}
|
|
1894
|
+
/** Forward one tool call; upstream failures come back as isError results. */
|
|
1895
|
+
async callTool(name, args) {
|
|
1896
|
+
try {
|
|
1897
|
+
await this.ensureSession();
|
|
1898
|
+
}
|
|
1899
|
+
catch (err) {
|
|
1900
|
+
return errorResult(err instanceof Error ? err.message : String(err));
|
|
1901
|
+
}
|
|
1902
|
+
const callId = this.nextId();
|
|
1903
|
+
let callRes;
|
|
1904
|
+
try {
|
|
1905
|
+
callRes = await this.post({
|
|
1906
|
+
jsonrpc: "2.0",
|
|
1907
|
+
id: callId,
|
|
1908
|
+
method: "tools/call",
|
|
1909
|
+
params: { name, arguments: args ?? {} },
|
|
1910
|
+
}, true);
|
|
1911
|
+
}
|
|
1912
|
+
catch (err) {
|
|
1913
|
+
return errorResult(`request failed: ${err instanceof Error ? err.message : String(err)}`);
|
|
1914
|
+
}
|
|
1915
|
+
const parsed = parseRpcBody(await callRes.text(), callId);
|
|
1916
|
+
if (parsed !== null && parsed.error) {
|
|
1917
|
+
return errorResult(rpcErrorMessage(parsed.error));
|
|
1918
|
+
}
|
|
1919
|
+
if (callRes.status < 200 || callRes.status >= 300) {
|
|
1920
|
+
return errorResult(`HTTP ${callRes.status}`);
|
|
1921
|
+
}
|
|
1922
|
+
if (parsed === null)
|
|
1923
|
+
return errorResult("malformed response");
|
|
1924
|
+
const result = parsed.result;
|
|
1925
|
+
if (result === undefined || result === null || typeof result !== "object") {
|
|
1926
|
+
return errorResult("malformed response");
|
|
1927
|
+
}
|
|
1928
|
+
// Hand the upstream result back exactly as received.
|
|
1929
|
+
return result;
|
|
1930
|
+
}
|
|
1931
|
+
}
|
|
1932
|
+
/** Build a forwarding client; tests inject a fake fetch and env through deps. */
|
|
1933
|
+
export function createClient(deps = {}) {
|
|
1934
|
+
return new FiscocheckClient(deps);
|
|
1935
|
+
}
|
|
1936
|
+
/** One-shot helper: a fresh client for a single call (the CLI path). */
|
|
1937
|
+
export async function callTool(name, args, deps = {}) {
|
|
1938
|
+
return new FiscocheckClient(deps).callTool(name, args);
|
|
1939
|
+
}
|
|
1940
|
+
//# sourceMappingURL=forward.js.map
|