AlmondTill/G3N API

FiscalReceipt

object type

A FiscalReceipt: the gap-free sequential fiscal number + the regime's signature (model A) or clearance authorization code (model B) + the QR payload the printed receipt renders. IMMUTABLE once issued — no edit, no transitions, no doom (the ⚑none artifact class; status is the one literal 'issued' forever). Certified partners produce the artifact fields — the caller never supplies them.

Fields

FieldTypeNotes
idID ID!No further notes.
sysIdString String!The group-scoped human-facing system id (FR-…).
typeString String!No further notes.
captionString String!No further notes.
statusString String!Always 'issued' — the artifact class carries ONE state and no FSM.
parentIdID ID!The fiscalized document.
rootIdID ID!The org-group family root.
createdAtString String!No further notes.
updatedAtString String!No further notes.
revisionNumInt Int!No further notes.
revisionID ID!The OCC revision token — immutable artifact: it never rotates after birth.
refCaptionsRefCaption [RefCaption!]!The server-composed captions of this record's declared references (the referenced-caption rule, the face slice grew it, as the build promised) — one row per referenced id; see RefCaption.
parentKindString String!order | invoice — which book the parentId names.
regimeString String!The canned regime key (cannedFiscalRegimes lists the roster).
logicalFacilityIdID ID!The establishment the series journals — the parent Order's selling LF (an Invoice inherits its Order's).
seriesKeyString String!The series identity — always <regime>#<logicalFacilityId> (fiscal series are establishment-bound).
seqInt Int!The gap-free sequential fiscal number WITHIN the series (1-based — allocated in the issue transaction).
signatureStringModel A — the partner/device fiscal signature (opaque, partner-shaped); null on a clearance-model receipt.
authorizationCodeStringModel B — the authority's clearance authorization code (obtained BEFORE issuing); null on a signature-model receipt.
qrPayloadString String!What the printed receipt renders as QR/barcode.
partnerRefStringThe certified partner's own document reference (null when the partner supplies none).

Used by