Skip to main content

gtin

Required Field

This field is required and must not be omitted

Description​

Use the GTIN attribute to submit a Global Trade Item Number (GTIN) | GS1. A GTIN uniquely identifies your product. Including this will help indexing your products faster on Pricespy.

Validation Rules​

  • Use only one attribute of this type per product
  • Length should be one of 0, 8, 12, 13, or 14 digits (UPC, EAN, JAN, or ISBN)
  • Make sure that the check digit is present and correct using the GS1 Check digit calculator
  • Don't submit a GTIN in the restricted ranges. Restricted ranges have the following prefixes: 02, 04, or 2 (when gtin is 13-digit number)
  • Don't submit a GTIN in the coupon ranges. Coupons have the following GS1 prefixes ranges: 05, 98–99 (when gtin is 13-digit number)
  • GTINs with restricted prefixes from above are valid when gtin is 12 or 14-digit number
  • Must be an number

Example Values​

Here are examples of how a valid gtin value should look like in XML and CSV (with header) respectively.

Valid Value
<g:gtin>90311017</g:gtin>
Click to show more valid XML examples
<g:gtin>90311017</g:gtin>
<g:gtin>036282818705</g:gtin>
<g:gtin>8806088269696</g:gtin>
<g:gtin>10614141000415</g:gtin>
<g:gtin>9031-1017</g:gtin>
<g:gtin>0362 8281-8705</g:gtin>
<g:gtin>8806-08826 9696</g:gtin>
<g:gtin>10614141000415</g:gtin>
<g:gtin>10614141000415</g:gtin>
<g:gtin>90311017</g:gtin>

Error Codes​

Below you will find possible error codes generated when validating this field alongside with an example in XML and CSV that would trigger the code. Please refer to the validation rules to understand the cause.

validation_gtin_invalid_check_digit
<g:gtin>026282818705</g:gtin>
<g:gtin>046282818705</g:gtin>
<g:gtin>03628281</g:gtin>
<g:gtin>97795145</g:gtin>
<g:gtin>8801088269696</g:gtin>
<g:gtin>996282818705</g:gtin>
<g:gtin>03628281</g:gtin>
validation_gtin_prefix_not_allowed
<g:gtin>9900114145837</g:gtin>
validation_invalid_length
<g:gtin>881111088111169696</g:gtin>
validation_not_integer
<g:gtin>88aaa08869696</g:gtin>

Properties​

PropertyValueDescription
Data TypestringClosest data type in code
NestedFalseDefines if this field consists of one or more sub-fields
Case SensitiveFalseIf small or large letters matter for this field
RepeatableTrueIf you can supply multiple items of this field (it´s a list)
Repeatable limit10If a list, this specifices the max number of items

Changelog​

📅 2024-03-30

Added

Initial definition

References​