AlmondTill/G3N API

Category

object type

A category — ONE recursive construct for the whole navigation spectrum (3 flat categories or a 6-level hierarchy; no fixed Department/Subcategory types). inactive = hidden from navigation, still reportable.

Fields

FieldTypeNotes
idID ID!The record’s id — a UUID the platform assigned when the record was created; every reference to this record uses it.
sysIdString String!The group-scoped human-facing system id (CT-…).
typeString String!The kind of record — always Category here.
captionString String!The record’s display name — what people see it called.
statusString String!The FSM state: active | inactive | doomed.
parentIdID ID!The parent org group; for a Category parentId === rootId.
rootIdID ID!The org-group family root.
createdAtString String!When the record was created, as a UTC timestamp.
updatedAtString String!When the record last changed, as a UTC timestamp.
revisionNumInt Int!How many times this record has been edited; the first save is 0.
revisionID ID!The OCC revision token — supply it on every mutation of this record; rotates on every write.
refCaptionsRefCaption [RefCaption!]!The server-composed captions of this record's declared references (the referenced-caption rule) — one row per referenced id; see RefCaption.
treeParentIDThe chain always terminates at a root (cycles kit-rejected at write).
merchandiseDivisionIdIDNo further notes.
codeStringOptional mutable merchant reference code; uniqueness NOT enforced (the code stance).

Used by