AlmondTill/G3N API

NewExemptionCertificateInput

input type

Create-input to CAPTURE an ExemptionCertificate. The tenant (org group) is derived SERVER-SIDE from the principal; every scoped jurisdiction is a SHARED-canonical ref — each must EXIST and be ACTIVE (CONFLICT/REF_STATE naming the first non-live one), deliberately NOT tenant-scoped; categories validate against the canned TaxCategory registry; the capture is immutable except caption/code/docRef — correct by revoke + re-capture.

Fields

FieldTypeRequiredNotes
captionStringnoOptional: when omitted the per-type default applies — the capture coordinate ('<certType> cert <certificateNumber> — <holderName>'); when supplied it must be non-blank.
certTypeExemptionCertType ExemptionCertType!yesNo further notes.
certificateNumberString String!yesThe issuer's certificate number (non-blank; STRICT).
holderNameString String!yesThe certificate holder, captured inline (customer-linked).
jurisdictionIdsID [ID!]!yesThe covered jurisdictions (1..25; shared-canonical refs — each exists + ACTIVE).
categoryIdsTaxCategory [TaxCategory!]noThe covered categories — ABSENT = all (the blanket-cert shape); supplied lists are non-empty.
expiresAtStringnoOptional expiry (UTC ISO-8601) — ABSENT = non-expiring.
docRefStringnoNo further notes.
orgCustomerIdIDnoThe holder OrgCustomer — in-tenant + NON-doomed at set.
codeStringnoNo further notes.

Used by