1WorldSync Kroger Item API

[CommunityJedi22]

Now that the 1WorldSync Kroger Item API is live, Kroger VIP is scheduled to sunset at the end of 2025.

To avoid syndication disruption, 1WorldSync is upgrading VIP users to its Item Management platform, allowing brands to continue to set up, update, and syndicate all their product content to Kroger.

1WorldSync has already begun to migrate content from VIP to Item Management. Users will be notified when their content will enter the migration queue and when the migration is complete.

Once completed, users will log into Item Management to resume item setup, updates, and syndication (VIP will no longer be accessible).

Resources

The following resources are available as users familiarize themselves with Item Management and the Kroger API

• Kroger API Quick Sheet
• 1WorldSync Kroger API Kickoff Documentation
• Kroger PDP Style Guide
• 1WorldSync Kroger API User Guide
• Register: 1WorldSync Kroger API Kickoff Live Session

[nancyVigo]

@CommunityJedi22, thanks for the info!  We have registered for the webinar tomorrow and are looking forward to learning what's new in Kroger's world!

Since VIP will sunset by the end of 2025, I was wondering how certain attributes will transfer from the portal to IM, such as Contact Information, Regions, Kroger Sales Event, etc.

Please, see attached screen shots.  Thanks!

[NPalazzolo]

@CommunityJedi22 Is a field mapping guide available showing which specific VIP fields map to which exact IM fields? I would assume fields such as Product Description, Marketing Message, Key Feature Bullets, etc from VIP would migrate into Kroger-specific fields in IM and not overwrite the current content in those IM fields, but want to confirm.

[Theo]

Hello @nancyVigo ,it’s good chatting with you again.

The specified attributes have already been added to Item Management and are visible once the Kroger Playlist has been linked to that item.

This applies to all attributes in Product Introduction Kroger, and you will be able to find all of them in Item Management, as long as the Kroger Playlist is added.

[Val_P]

Hello @NPalazzolo and thank you for continuing the use of our community. Welcome back!

The easiest option for you once you start using Kroger Item API is to add the "Kroger" Playlist in Item Management and the system will advise you which specific attributes need to be added. More details about adding and using playlists are here: 1WorldSync Playlists Video.

Most Kroger-specific attribute names will be identical in Product Introduction and Item Management. One attribute with a different name is Product is pre-priced from Product Introduction which is now Retail Price is Marked on the Product Indicator in Item Management.

Once you start using API only for your items, Product Introduction will no longer be needed (also access will be disabled) at all, so there is no risk of any PI information overwriting anything from Item Management. Please let us know if this helped or if there is anything else we may assist with for this request. Thanks!

[nancyVigo]

@Theo and @Val_P, thank you for all the helpful information!

@NPalazzolo, great questions!

[jacquelinehays]

Hi-

I started to publish an item in 1WS that is in the Kroger portal using the GLN in the training (0838016000123).  When I went to publish, I received an error asking for the primary contact name, number and email. That information is filled out in the VIP portal.  The second item I tried to publish had an error for the "scheme"-this was also in the VIP portal.

Do we need to correct all the errors to publish to the Kroger API Certification Queue ?

Thanks-

Jackie

[Val_P]

Hi @jacquelinehays and welcome to the customer community. Thanks for reaching out.

Item Management API is meant to be a replacement for Kroger Product Introduction, therefore the attributes already added in Product Introduction should not be taken into consideration when submitting the items from ITem Management.

If the API has been enabled for you, please make sure you add the Kroger playlist on all hierarchy levels, solve all warning messages and publish the highest hierarchy level to the Kroger API from IM with all attributes (including those already previously topped-off in PI such as Contact Name and Email).

More details about adding and using playlists are here: 1WorldSync Playlists Video. Thanks!

[jacquelinehays]

Hi again-

After rereading the email sent Monday again...it says that 1WS will be migrating our information from the VIP portal to 1WS during the month of July.  Will we be notified when you are complete?

Thanks-

Jackie

[Theo]

Hello @jacquelinehays and welcome to the customer community. Thanks for reaching out.

When the migration process begins for your company, you will receive a notification from 1WorldSync to keep you informed about the changes taking place.

[nancyVigo]

Good afternoon team!

Our team participated in the Kroger API Webinar and heard that companies are in a queue waiting for our products to be transferred from VIP.

Will we receive notification when this happens so that we begin utilizing this service?

Thanks!

[Maria]

Hello @nancyVigo yes, you will be notified by your account manager once the migration is done.

Thank you! 

[nancyVigo]

@Maria, thanks for the prompt response!

Have a great weekend! 🙂

[nancyVigo]

Good afternoon team!

As our Item Maintenance Department waits our turn at using the Kroger API feature, I wanted to run something by you that just occurred to me.

Are we to assume that, once all our products are transferred from VIP to IM, we would need to update every item to accommodate Kroger's new requirements?

In the past, one image for the CASE and EACH facing the front seemed to suffice.  Now, they are requesting more with different facings.

Also, the new Marketing Messaging and Key Features are requiring from 5-7 bullet points (with a minimum of 25 characters).

I know that many of our items (if not most) will be out of compliance.

I'm just trying to stay ahead of the game. 😉

Thanks!

[Val_P]

Hello @nancyVigo and thank you for continuing to utilize our customer community. Welcome back. 

Regarding your first point, any items that were set up in VIP and have already been synced will be migrated to IM automatically and will not need to be re-synced. If any updates are required, the updates can be made directly in IM.

Regarding the image requirements, 1 image is still the minimum mandatory request, however the information availabile is slightly more detailed now and, if you do submit more than 1 image, each image needs to have a different facing.

Regarding the bullet points (features and benefits) information, while more are requested now, they can also contain product dimensions, weights, size, country of origin, warnings, instructions along with any specific item information that was not already added in the Marketing Message.

Thanks for staying ahead of the game and we will return with an update tomorrow after checking if it is mandatory to resubmit from IM the already synced items through VIP. Take care and have a wonderful afternoon/evening ahead!

[nancyVigo]

@Val_P, good morning!

Thanks so much for checking all this up for us...it's truly appreciated!

Looking forward to hearing from you again and to begin learning the new process! 🙂

[ana_neamtu]

Good morning @nancyVigo,

Thank you for continuing the use of our community!

We have confirmed with our team that you do not have to publish, from Item Management, the items that are already synced via Product Introduction for Kroger.

The publication of synchronised items is necessary only when changes need to be made to those items.

Please don't hesitate to reach out to us if you have any further questions.

Have a wonderful day!

[nancyVigo]

@ana_neamtu, thanks for the confirmation!

I will be ready to update any item that is out of compliance in 1WS after the transfer.

Have a great day!

[Kateryna]

Hi Team, 

Please advise on the CIC response from Kroger, after  I updated the GTIN 00773479364927 based on Kroger Playlist, published it to 0838016000123 Kroger Certif. Queue:

And one more question, as per Kroger requirements, only 1 image is bare minimum - what precise image is it recommended? Case/ Open case/ Raw product/ Styled? We sell them bakery products raw & bulk in cases. 

Thank you in advance!

[Val_P]

Hello @Kateryna and thank you for continuing the use of our customer community. Welcome back.

You are receiving the error in the screenshot because the regular Kroger Company GLN (0011110000019) will not accept items already topped-off from Item Management. Also, after publishing to the Kroger API Certification Queue GLN 0838016000123 and then to Certified Items for Kroger API GLN 0838016000116, you can ignore the CICs received from the previously used 0011110000019 GLN, as is the case here.

Regarding the image question, Kroger is quite flexible when it comes to what the main image should contain exactly. Here are some examples and options from their Style Guide:

You can choose whichever of these options best applies to the specifics of your product.

Please let us know if there is anything else we may assist with and we would be delighted to. Thank you and have a wonderful day!

[Kateryna]

Thank you @Val_P very much for your detailed explanation. 

Now everything seems clear. ...until something pops-up again 😊😉

Appreciate your Team's constant support. 

Have a great day ahead!

[Val_P]

It is our please, @Kateryna, thank you and we will be here for you when something else comes up. Have a great day and rest of the week as well!

[nancyVigo]

Good morning team! 

I know that we can add a marketing message according to certain customers' requests, then lock it for a particular customer.

Our team wanted to know if we could do the same thing with the Key Elements (bullet points).

Thanks in advance! 

[ana_neamtu]

Good morning @nancyVigo,

Welcome back to our customer community!

The Trade Item Feature Benefit fields also have an option to provide a Recipient GLN, in Item Management, same as with the Marketing Message section.

Please don't hesitate to contact us if you have any further questions.

Thank you

[nancyVigo]

@ana_neamtu, thanks for the confirmation...have an awesome day! 🙂

[Kestoesta]

During the training, it was mentioned that we could sign up to be on migration queue.  Where is this?

[CommunityJedi22]

Hello @Kestoesta and welcome to the customer community.  Thanks for reaching out.  Please take a look here to get started with teh queue: https://community.1worldsync.com/t5/Kroger-API/Get-Started-with-Kroger-API/ta-p/18804

You can learn more about the API throughout the process here:

https://community.1worldsync.com/t5/Kroger-API/ct-p/KrogerAPI