Skip to main content

updateCompanyGs1Prefix

Updates a GS1 company prefix. Omitted arguments are left unchanged.

Business Rules​

  • The prefix digits change only while nothing has minted under them.
  • startingSerial only rises once codes have minted, and raises the live counter.
  • gtinCapacity must be 10^(12-N) for a prefix of length N, and is fixed once a UPC has been assigned - including when the stored value was never a licensed one, because re-deriving the block would strand the owned-code rows that carry the old codes.

Error Scenarios​

  • **NOT_FOUND**: when the prefix does not exist within the current company.
  • **BAD_REQUEST**: when a change violates the rules above.

Permissions Required​

  • company:update_gs1_prefix permission
updateCompanyGs1Prefix(
  input: UpdateCompanyGs1PrefixInput!
): CompanyGs1Prefix

Arguments​

updateCompanyGs1Prefix.input ● UpdateCompanyGs1PrefixInput! non-null input common​

Parameters for UpdateCompanyGs1Prefix

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.