Skip to main content

Find the answer to your question

Advanced Search
Published: March 16 2017, 5:41:00 PMUpdated: November 28 2020, 12:53:30 PM

What are 2017 Input Quality Enforcement for GTINs?

Starting March 2017, Input Quality for UPIs will be enforced. For more details about the enforcement, please refer to this KB Article.

GTINs will be validated based on the following criteria:

  • GTINs should be NUMERIC ONLY.
  • GTIN’s should be of Right Length. When you specify any of the of the GTIN’s the corresponding Value field must comply with the following guidelines to avoid an error condition:
    • The EAN must comply with the GTIN-13 standard.
    • The ISBN must comply with the ISBN-10 or ISBN-13 standard.
    • The JAN must comply with the GTIN-13 standard.
    • The UPC must comply with the GTIN-12 or UPC-A standard.
  •  GTIN”s MUST PASS CHECKSUM (Checksum is validating the check digit - the last digit of a barcode number is a calculated check digit from all the other numbers in the barcode and ensures the integrity of your barcode number.
  • If a product does not have a value for the GTIN, you can still pass the ProductIdentifierUnavailableText (like- “Does not apply”) that is returned by GeteBayDetailsRequest for the site you are calling for.  However, in future, this might change and certain categories would have restriction to provide “Does Not Apply” for new item conditions.
Category

9355

Cell Phones & Accessories>Cell Phones & Smartphones

Mandatory GTIN
UPC
Use Cases

1.GTIN is non numeric

Corrective Action: Provide the GTIN in only Numeric format


2. GTIN is not of right length

Corrective Action: Provide the GTIN of expected length, which is defined above.


3. GTIN does not pass the Checksum

Corrective Action: The specified GTIN MUST be a valid GTIN.


The Error returned is same for all of the above use cases. Only difference would be that the Name and the Value shown in Error for UPC/EAN/ISBN/JAN would replace the value you passed in request.


In the below table we have used the Use Case: “GTIN is non-numeric” to help visualize the effect of Input Quality Mandate.


Request
Response
Corrective Action
Non-numeric UPC is specified

<AddItemRequest>        

  :  

<Item>

         :

     <ProductListingDetails>

          <UPC>40005580693a</UPC>

<IncludeeBayProductDetails>true

</IncludeeBayProductDetails>

     </ProductListingDetails>         :   

  </Item>

  </AddItemRequest>

<AddItemResponse>      <Timestamp>2017-02-25T00:03:03.111Z</Timestamp>      <Ack>Failure</Ack>

    <Errors>

            <ShortMessage>UPC has an invalid value of 40005580693a.</ShortMessage>

            <LongMessage>UPC has an invalid value of 40005580693a. Enter a valid value and try again.</LongMessage>

            <ErrorCode>21919302</ErrorCode>

            <SeverityCode>Error</SeverityCode>

            <ErrorParameters ParamID="0">

               <Value>UPC has an invalid value of 40005580693a.</Value>

            </ErrorParameters>

            <ErrorParameters ParamID="1">

               <Value>UPC has an invalid value of 40005580693a. Enter a valid value and try again.</Value>

            </ErrorParameters>

            <ErrorParameters ParamID="2">

               <Value>3</Value>

            </ErrorParameters>

            <ErrorParameters ParamID="3">

               <Value>UPC</Value>

            </ErrorParameters>

            <ErrorClassification>RequestError</ErrorClassification>

         </Errors>

              :

    </AddItemResponse>

<AddItemRequest>

         :

  <Item>

         :

     <ProductListingDetails>

          <UPC>400055806938</UPC>

<IncludeeBayProductDetails>true

</IncludeeBayProductDetails>

     </ProductListingDetails>                 :   

  </Item>

  </AddItemRequest>

Non-numeric UPC is specified

<ReviseItemRequest>

       :

      <Item>

        <ItemID>150009148960</ItemID>

       <Title>Apple iPhone 7 Plus - 256GB - Rose Gold Smartphone</Title>

      </Item>

</ReviseItemRequest>

<ReviseItemResponse>

      <Timestamp>2017-02-25T00:15:15.411Z</Timestamp>

      <Ack>Failure</Ack>

     <Errors>

            <ShortMessage>UPC has an invalid value of ABCDEFGHIJ.</ShortMessage>

            <LongMessage>UPC has an invalid value of ABCDEFGHIJ. Enter a valid value and try again.</LongMessage>

            <ErrorCode>21919302</ErrorCode>

            <SeverityCode>Error</SeverityCode>

            <ErrorParameters ParamID="0">

               <Value>UPC has an invalid value of ABCDEFGHIJ.</Value>

            </ErrorParameters>

            <ErrorParameters ParamID="1">

               <Value>UPC has an invalid value of ABCDEFGHIJ. Enter a valid value and try again.</Value>

            </ErrorParameters>

            <ErrorParameters ParamID="2">

               <Value>3</Value>

            </ErrorParameters>

            <ErrorParameters ParamID="3">

               <Value>UPC</Value>

            </ErrorParameters>

            <ErrorClassification>RequestError</ErrorClassification>

         </Errors>

         :

    </ReviseItemResponse>

<ReviseItemRequest>

       :

      <Item>

       <ItemID>150009113380</ItemID>

        <Title> Apple iPhone 7 Plus - 256GB - Rose Gold Smartphone </Title>

           <ProductListingDetails>

          <UPC>400055806938</UPC>

<IncludeeBayProductDetails>true

</IncludeeBayProductDetails>

     </ProductListingDetails>                     

</Item>

  </ReviseItemRequest>

Non-numeric UPC is specified

<RelistItemRequest>

         :

      <Item>

        <ItemID>150009148960</ItemID>

        <Title>Test Title</Title>

      </Item>

</RelistItemRequest>

<RelistItemResponse>

      <Timestamp>2017-02-25T00:27:23.148Z</Timestamp>

      <Ack>Failure</Ack>

     <Errors>

            <ShortMessage>UPC has an invalid value of ABCDEFGHIJ.</ShortMessage>

            <LongMessage>UPC has an invalid value of ABCDEFGHIJ. Enter a valid value and try again.</LongMessage>

            <ErrorCode>21919302</ErrorCode>

            <SeverityCode>Error</SeverityCode>

            <ErrorParameters ParamID="0">

               <Value>UPC has an invalid value of ABCDEFGHIJ.</Value>

            </ErrorParameters>

            <ErrorParameters ParamID="1">

               <Value>UPC has an invalid value of ABCDEFGHIJ. Enter a valid value and try again.</Value>

            </ErrorParameters>

            <ErrorParameters ParamID="2">

               <Value>3</Value>

            </ErrorParameters>

            <ErrorParameters ParamID="3">

               <Value>UPC</Value>

            </ErrorParameters>

            <ErrorClassification>RequestError</ErrorClassification>

         </Errors>

        :

</RelistItemResponse>

<RelistItemRequest>

      <DetailLevel>ReturnAll</DetailLevel>

      <ErrorLanguage>en_US</ErrorLanguage>

      <WarningLevel>High</WarningLevel>

      <Version>547</Version>

      <Item>

       <ItemID>150009113380</ItemID>

        <Title>Test Title</Title>

           <ProductListingDetails>

          <UPC>400055806938</UPC>

<IncludeeBayProductDetails>true

</IncludeeBayProductDetails>

     </ProductListingDetails >

    </Item>

  </RelistItemRequest>




How well did this answer your question?
Answers others found helpful

Print

Email this page