Listings

Listings are transmitted by the Seller:Offer.New and Seller:Offer.Update event. Each time the listing data changes, JTL-Wawi will transmit the entire listing again.

Essentials Properties

It is generally not necessary to provide attributes for essential data, as each listing already implements a set of essential properties by default, including a title, description, GTIN, quantity and price.

Pictures / Images

Product or listing images are transmitted as a link along with the listing event. These links have a lifetime of 7 days after the listing event was triggered. The filename is generated based on the file content; i.e., each separate image will have a filename similar to its file content.

Listing State

We highly recommend informing the seller about the processing status of their listings. Most marketplaces use an asynchronous listing process during which the listing data is curated in a semi-automated process — a process which may take some time.

State: In-Progress

Send this state to inform the seller that the listing process is now in progress for their listing.

// POST /v1/channel/offer/in-progress
{
	"offerList": [
		{
      "offerId": 1,
			"sellerId": "1",
      "startedAt": "2022-11-28T01:00:13+00"
		}
	]
}

State: Successful

We recommend informing the seller once a listing is successfully listed on the connected marketplace. The optional listingUrl is useful in this case and allows the seller to visit and thereby directly check the listing on the connected marketplace.

// POST /v1/channel/offer/listed

{
	"offerList": [
		{
			"sellerId": "1",
			"offerId": 1,
			"listedAt": "2022-11-28T01:00:13+00",
			"listingUrl": "https://marketplace.de/offer1",
			"channelOfferId": "AFGHDHDFH"
		}
	]
}

State: Failed

You need to inform the seller if the listing process for a listing failed.

// POST v1/channel/offer/listing-failed

{
	"offerList": [
		{
			"sellerId": "1",
			"offerId": 1,
			"errorList": [
				{
					"code": "123",
					"message": "A listing error occur",
					"longMessage": "A serious listing error occure."
				}
			],
			"failedAt": "2019-02-09T05:33:12+00:00"
		}
	]
}