Skip to main content

registerCompanyGs1Prefix

Registers a GS1 company prefix, or revives one the company archived earlier.

Business Rules​

  • The prefix is 6-12 digits and unique among the company's active prefixes.
  • Reviving keeps the archived prefix's serial counter and owned-UPC history.
  • startingSerial is the last serial consumed elsewhere; minting starts above it.
  • gtinCapacity must be 10^(12-N) for a prefix of length N: a licence grants one item-reference space, and UPC-A versus EAN-13 is how a code prints, not how many exist.
  • priority decides which block auto-assignment draws from first.

Error Scenarios​

  • **NOT_FOUND**: when the company does not exist.
  • **BAD_REQUEST**: when the prefix is malformed or active, the starting serial is negative, or the capacity is not one the prefix length can grant.

Permissions Required​

  • company:register_gs1_prefix permission
registerCompanyGs1Prefix(
  input: RegisterCompanyGs1PrefixInput!
): CompanyGs1Prefix

Arguments​

registerCompanyGs1Prefix.input ● RegisterCompanyGs1PrefixInput! non-null input common​

Parameters for RegisterCompanyGs1Prefix

Type​

CompanyGs1Prefix object companies​

Company GS1 Prefix​

A GS1 prefix licensed to the company. Integrations assigned to it mint SSCC-18 codes from one shared serial counter, and its GTIN capacity defines the owned UPC block.