SIGN IT - Principali cambiamenti in SIGN IT 2026-06-01 – fiskaly-support (IT)

Di seguito una panoramica delle principali modifiche introdotte in SIGN IT 2026-06-01.

Nuovo header X-Api-Version obbligatorio
L'ultima versione disponibile è la 2026-06-01.
Introdotta la modalità DEGRADED per i Taxpayer (dal 19 giugno)
Quando viene rilevato un errore persistente nelle credenziali Fisconline durante la trasmissione di un record, il Taxpayer passa automaticamente da OPERATIVE a DEGRADED e le trasmissioni successive vengono bloccate fino alla risoluzione del problema.
Per saperne di più: Cos'è la modalità DEGRADED e come intervenire

Modifica strutturale per RECEIPT e CORRECTION

- Nuovo campo obbligatorio totals.vat (a livello di operation) in sostituzione del vecchio total_vat (a livello di document). La semantica rimane invariata: contiene l'importo IVA aggregato, il subtotale IVA esclusa e il totale IVA inclusa.

Versioni precedenti

"operation": {
  "type": "RECEIPT",
  "document": {
    "number": "REC-001",
    "total_vat": {
      "amount": "4.45454545",
      "exclusive": "20.54545455",
      "inclusive": "25.00"
    }
  },
  "entries": [...],
  "payments": [...]
}

Dalla versione 2026-06-01

"operation": {
  "type": "RECEIPT",
  "document": {
    "number": "REC-001"
  },
  "totals": {
    "vat": {
      "amount": "4.45454545",
      "exclusive": "20.54545455",
      "inclusive": "25.00"
    }
  },
  "entries": [...]
  "payments": [...]
}

- Nuovo campo obbligatorio breakdown.
Contiene gli stessi valori IVA di totals.vat, ma suddivisi per aliquota IVA. Particolarmente utile quando una transazione include articoli con aliquote IVA diverse.

"operation": {
  "type": "RECEIPT",
  "breakdown": [
  {
    "type": "VAT_RATE",
    "code": "STANDARD",
    "percentage": "22.00",
    "amount": "4.40",
    "exclusive": "20.00",
    "inclusive": "24.40"
  },
  {
    "type": "VAT_RATE",
    "code": "REDUCED_1",
    "percentage": "10.00",
    "amount": "0.05454545",
    "exclusive": "0.54545455",
    "inclusive": "0.60"
  }
]
}

unit.price è ora un oggetto con due campi — inclusive e exclusive — invece di un singolo valore stringa (solo IVA inclusa)

Versioni precedenti

"entries": [
  {
    "type": "SALE",
    "data": {
      "type": "ITEM",
      "text": "Margherita pizza",
      "unit": {
        "quantity": "2",
        "price": "12.20"
      }

Dalla versione 2026-06-01

"entries": [
  {
    "type": "SALE",
    "data": {
      "type": "ITEM",
      "text": "Margherita pizza",
      "unit": {
        "quantity": "2",
        "price": {
          "inclusive": "12.20",
          "exclusive": "10.00"
        }
      }

Nuovo valore INVOICE aggiunto al campo concept per i pagamenti non riscossi (OUTSTANDING).
Impostare questo valore nel caso di prestazione di servizi continuativi con emissione di fattura a fine periodo.
```
"payments": [
        {
          "type": "OUTSTANDING",
          "details": {
            "amount": "2.00"
          },
          "concept": "INVOICE"
        }
      ]
```