Printed Document Layout
Every fiscally relevant document issued via SIGN PT must carry the same set of compliance elements on its printed (or PDF) rendering. SIGN PT returns the data via the content.compliance object; the POS or ERP is responsible for placing each element correctly on the final document.
This section specifies the document titles, field formats, placement rules, and per-document-type templates for all SIGN PT outputs. For the underlying compliance obligations, see Receipt and Invoice Compliance.
As defined by law, the software provider must approve the implemented layout. Without approval from fiskaly, the service may not be used in production. To request approval, please send the layout as a PDF for each document type to your account manager. Our team will review your submission and respond promptly.
Document types and titles
Section titled “Document types and titles”| API operation | SAF-T document type | Title on print |
|---|---|---|
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 | original SAF-T type, DocumentStatus = A | original title + “ANULADO” banner (no new document) |
PROOF_OF_PAYMENT | RG / RC | ”Recibo” / “Recibo IVA de Caixa” |
By default, SIGN PT issues a Fatura-Recibo (FR). To issue a Fatura Simplificada (FS) instead, set simplified_invoice: true.
Field formats
Section titled “Field formats”| API field | Prints as |
|---|---|
content.compliance.atcud | ATCUD: <validation_code>-<sequence>(e.g. CSDF7T5H-35) |
content.compliance.qr_code | A 2D QR code carrying the 22 fields keyed A–S in Portaria 195/2020 Annex I. Encoded at error-correction level M, QR version 9 or lower. |
content.compliance.hash | 4 selected characters of the digital signature (positions 1, 11, 21, 31) |
content.compliance.software_certificate | Processado por programa certificado n.º <NNNN>/AT |
Placement rules
Section titled “Placement rules”ATCUD — immediately above the QR code, on every page. Format: ATCUD: <validation_code>-<sequential_number>.
QR code — on the first or last page, clearly visible. ECC level M, version ≤ 9. Minimum size: ≥ 30 × 30 mm on A4; ≥ 25 × 25 mm on 58/80 mm POS rolls. Exactly one QR code per document.
Hash excerpt — in the document footer, on the same line as or immediately before the certificate notice. Print only the 4 characters at positions 1, 11, 21, and 31 of the Base64 signature, hyphen-separated from the certificate mention. Never print the full signature.
Software certificate — on every printed document, conventionally on the last footer line. Format: Processado por programa certificado n.º <NNNN>/AT.
Issuer identification (commercial companies). When the issuer is a sociedade comercial, the document masthead must include — in addition to the trading name, NIF, and address — the share capital (capital social) and the commercial registration number (matrícula no registo comercial). This applies to every fiscally relevant document, not only full invoices (Art. 171 Código das Sociedades Comerciais). The requirement does not apply to sole traders (natural persons).
Compliance footer
Section titled “Compliance footer”The same compliance footer applies to every fiscally relevant document issued by SIGN PT.
Per-document-type templates
Section titled “Per-document-type templates”Each template below is rendered as a visual mockup. The QR codes shown are real and scan to a valid Portaria 195/2020 payload. Annotation boxes on the right of each receipt identify which content.compliance field each printed element comes from.
Receipt — FS (Fatura Simplificada)
Section titled “Receipt — FS (Fatura Simplificada)”simplified_invoice flagReceipt — FR (Fatura-Recibo)
Section titled “Receipt — FR (Fatura-Recibo)”Issued by the RECEIPT operation when simplified_invoice: false. Used for Category B income (typical freelancer/service provider use case) where service and payment are settled at the same moment. Areas highlighted in amber are FR-specific; the rest is identical to an FS receipt.
NIF Cliente: 503456789 2
simplified_invoice: false on the RECEIPT operation.Withholding exemption case: when the freelancer qualifies for an IRS withholding exemption (e.g. annual gross income below the threshold in Art. 101.º-B CIRS), the withholding line at ③ is replaced by the applicable exemption mention — for example, “Sem retenção, nos termos do n.º 1, alínea a) do artigo 101.º-B do CIRS”. In that case, TOTAL A PAGAR equals the gross amount. The integrator’s application decides whether the exemption applies; SIGN PT does not validate eligibility.
Correction — NC / ND
Section titled “Correction — NC / ND”On NC and ND documents, all printed amounts (quantity, base, VAT, total) must be positive values, even though the document has a downward (NC) or upward (ND) corrective effect on the original. The corrective direction is implied by the document type, not by negative signs on the print (Despacho 8632/2014 §2.2.6).
Reason; mandatoryReferences block also stores the linkThe QR field D (document type) is NC or ND. The original FS reference is carried in QR field S (free text) and in the SAF-T References block.
Cancellation — Status → A
Section titled “Cancellation — Status → A”A cancellation does not issue a new fiscal document. The original FS / FR / FT is updated in place to DocumentStatus = A (Anulado). The customer-facing print is a reprint of the original with an ANULADO banner; the original’s compliance footer (signature, ATCUD, QR, certificate) is not regenerated.
DocumentStatus = A in SAF-TReason is mandatory on cancellationThe hash chain must remain unbroken (DL 28/2019 Art. 6). Status A is a SAF-T-side flag retransmitted to AT (DL 198/2012 Art. 3 n.º 1). The printed artefact only adds the ANULADO banner, the cancellation date, and the cancellation reason.
Proof of Payment — RG / RC
Section titled “Proof of Payment — RG / RC”
TaxType = “NS”)RG carries no VAT detail (TaxType = "NS"). RC must show VAT bases, rates, and amounts because the RC triggers the VAT obligation under IVA de Caixa.
Invoice — FT
Section titled “Invoice — FT”
INVOICE operationUnder VAT Cash regime (IVA de Caixa) the invoice must include the mention “IVA — regime de caixa” immediately below the document title (Art. 36 n.º 5(j) CIVA / DL 71/2013).
Was this page helpful?