Ogni documento fiscalmente rilevante emesso tramite SIGN PT deve recare lo stesso insieme di elementi di conformità sulla sua rappresentazione stampata (o PDF). SIGN PT restituisce i dati tramite l’oggetto content.compliance; il POS o l’ERP è responsabile del corretto posizionamento di ogni elemento sul documento finale.
Questa sezione specifica i titoli dei documenti, i formati dei campi, le regole di posizionamento e i modelli per tipo di documento per tutti gli output di SIGN PT. Per gli obblighi di conformità sottostanti, vedere Conformità di ricevute e fatture.
Come definito dalla legge, il fornitore del software deve approvare il layout implementato. Senza l’approvazione di fiskaly, il servizio non può essere utilizzato in produzione. Per richiedere l’approvazione, inviare il layout in formato PDF per ogni tipo di documento al proprio account manager. Il nostro team esaminerà la vostra proposta e risponderà tempestivamente.
Tipi di documenti e titoli
Sezione intitolata “Tipi di documenti e titoli”| Operazione API | Tipo documento SAF-T | Titolo sul documento stampato |
|---|---|---|
RECEIPTsimplified_invoice: true | FS | ”Fatura Simplificada” |
RECEIPTsimplified_invoice: false | FR | ”Fatura-Recibo” |
INVOICE | FT | ”Fatura” |
CORRECTION | NC / ND | ”Nota de Crédito” / “Nota de Débito” |
CANCELLATION | tipo SAF-T originale, DocumentStatus = A | titolo originale + banner “ANULADO” (nessun nuovo documento) |
PROOF_OF_PAYMENT | RG / RC | ”Recibo” / “Recibo IVA de Caixa” |
Per impostazione predefinita, SIGN PT emette una Fatura-Recibo (FR). Per emettere invece una Fatura Simplificada (FS), impostare simplified_invoice: true.
Formati dei campi
Sezione intitolata “Formati dei campi”| Campo API | Viene stampato come |
|---|---|
content.compliance.data | ATCUD: <validation_code>-<sequence>(ad es. CSDF7T5H-35) |
content.compliance.qr_code | Un codice QR 2D contenente i 22 campi con chiave A–S dell’Allegato I della Portaria 195/2020. Codificato al livello di correzione errori M, versione QR 9 o inferiore. |
content.compliance.hash | 4 caratteri selezionati della firma digitale (posizioni 1, 11, 21, 31) |
content.compliance.software_certificate | Processado por programa certificado n.º <NNNN>/AT |
Regole di posizionamento
Sezione intitolata “Regole di posizionamento”ATCUD — immediatamente sopra il codice QR, su ogni pagina. Formato: ATCUD: <validation_code>-<sequential_number>.
Codice QR — sulla prima o sull’ultima pagina, chiaramente visibile. Livello ECC M, versione ≤ 9. Dimensione minima: ≥ 30 × 30 mm su A4; ≥ 25 × 25 mm su rotoli POS da 58/80 mm. Esattamente un codice QR per documento.
Estratto hash — nel piè di pagina del documento, sulla stessa riga o immediatamente prima della menzione del certificato. Stampare solo i 4 caratteri alle posizioni 1, 11, 21 e 31 della firma Base64, separati da un trattino dalla menzione del certificato. Non stampare mai la firma completa.
Certificato software — su ogni documento stampato, convenzionalmente sull’ultima riga del piè di pagina. Formato: Processado por programa certificado n.º <NNNN>/AT.
Identificazione dell’emittente (società commerciali). Quando l’emittente è una sociedade comercial, l’intestazione del documento deve includere — oltre alla ragione sociale, al NIF e all’indirizzo — il capitale sociale (capital social) e il numero di iscrizione al registro delle imprese (matrícula no registo comercial). Questo si applica a ogni documento fiscalmente rilevante, non solo alle fatture complete (Art. 171 Código das Sociedades Comerciais). Il requisito non si applica ai lavoratori autonomi (persone fisiche).
Piè di pagina di conformità
Sezione intitolata “Piè di pagina di conformità”Lo stesso piè di pagina di conformità si applica a ogni documento fiscalmente rilevante emesso da SIGN PT.
Modelli per tipo di documento
Sezione intitolata “Modelli per tipo di documento”Ogni modello sottostante è rappresentato come un mock-up visivo. I codici QR mostrati sono reali e si scansionano verso un payload Portaria 195/2020 valido. I riquadri di annotazione a destra di ogni ricevuta identificano da quale campo content.compliance proviene ogni elemento stampato.
Ricevuta — FS (Fatura Simplificada)
Sezione intitolata “Ricevuta — FS (Fatura Simplificada)”simplified_invoiceRicevuta — FR (Fatura-Recibo)
Sezione intitolata “Ricevuta — FR (Fatura-Recibo)”Emesso dall’operazione RECEIPT quando simplified_invoice: false. Utilizzato per i redditi di Categoria B (caso tipico del libero professionista/fornitore di servizi) in cui servizio e pagamento vengono regolati nello stesso momento. Le aree evidenziate in ambra sono specifiche del FR; il resto è identico a una ricevuta FS.
NIF Cliente: 503456789 2
simplified_invoice: false sull’operazione RECEIPT.Caso di esenzione dalla ritenuta: quando il libero professionista è qualificato per un’esenzione dalla ritenuta IRS (ad es. reddito lordo annuo al di sotto della soglia dell’Art. 101.º-B CIRS), la riga della ritenuta in ③ viene sostituita dalla menzione di esenzione applicabile — ad esempio, “Sem retenção, nos termos do n.º 1, alínea a) do artigo 101.º-B do CIRS”. In tal caso, TOTAL A PAGAR equivale all’importo lordo. L’applicazione dell’integratore decide se l’esenzione si applica; SIGN PT non verifica l’idoneità.
Correzione — NC / ND
Sezione intitolata “Correzione — NC / ND”Nei documenti NC e ND, tutti gli importi stampati (quantità, base, IVA, totale) devono essere valori positivi, anche se il documento ha un effetto correttivo verso il basso (NC) o verso l’alto (ND) sull’originale. La direzione correttiva è implicita nel tipo di documento, non nei segni negativi sul documento stampato (Despacho 8632/2014 §2.2.6).
Reason; obbligatorioReferences memorizza anch’esso il collegamentoIl campo QR D (tipo di documento) è NC o ND. Il riferimento all’FS originale è contenuto nel campo QR S (testo libero) e nel blocco SAF-T References.
Cancellazione — Stato → A
Sezione intitolata “Cancellazione — Stato → A”Una cancellazione non emette un nuovo documento fiscale. L’FS / FR / FT originale viene aggiornato in loco a DocumentStatus = A (Anulado). Il documento stampato orientato al cliente è una ristampa dell’originale con un banner ANULADO; il piè di pagina di conformità dell’originale (firma, ATCUD, QR, certificato) non viene rigenerato.
DocumentStatus = A in SAF-TReason è obbligatorio alla cancellazioneLa catena hash deve rimanere ininterrotta (DL 28/2019 Art. 6). Lo stato A è un flag lato SAF-T ritrasmesso all’AT (DL 198/2012 Art. 3 n.º 1). L’artefatto stampato aggiunge solo il banner ANULADO, la data di cancellazione e il motivo della cancellazione.
Prova di pagamento — RG / RC
Sezione intitolata “Prova di pagamento — RG / RC”
TaxType = “NS”)Il RG non contiene dettagli IVA (TaxType = "NS"). Il RC deve mostrare basi, aliquote e importi IVA perché il RC attiva l’obbligo IVA sotto IVA de Caixa.
Fattura — FT
Sezione intitolata “Fattura — FT”
INVOICENel regime IVA di cassa (IVA de Caixa), la fattura deve includere la menzione “IVA — regime de caixa” immediatamente sotto il titolo del documento (Art. 36 n.º 5(j) CIVA / DL 71/2013).