# Offer management Offers from your sales channels: preview, changes to one or many offers, ending and resuming, linking to products and listing products from the warehouse. You work with a sales channel's offers in its integration details, on two tabs. The first shows the offers already on the channel, the second is for listing new offers from warehouse products. > **Required integration:** You need a connected integration of a sales channel that supports offer management. To list warehouse products - also an integration from the **Warehouses and wholesalers** category. Only a product with an EAN can be listed. For now offer management works for [Allegro](https://ritevo.com/en/docs/integrations/allegro#offers); more channels will follow. > **Good to know:** We describe the features on the example of Allegro. In other channels they work very similarly - the differences (filters, available changes, listing methods) are described on the channel's integration page. ## How it works - **Offer management** - offers already on the channel. The list is always live: we fetch it from the channel every time you open it and keep it up to date, we do not save anything on our side. Every change goes straight to the channel, and the list shows it once the channel has saved it. - **Offer listing** - creating new offers from warehouse products. Here we save your orders: each product goes through the statuses until the channel lists the offer. Then it leaves this tab and the offer shows up in **Offer management**, already linked to the product. ## Offer management Here you preview an offer, change one or many offers at once, end or resume them and link them to a warehouse product. - **Offer card** - image, title, status and offer number from the channel, below them the key numbers (for example stock, items sold and shipping rate) and the linked warehouse product. Text that is too long is cut - hover to see all of it. - **Selecting** - the checkbox on a card selects one offer, and the one next to **Results found** selects the whole page. Changing the page or the filters clears the selection. - **Operations** - the menu with changes for the selected offers: stock, price, delivery, content, ending and resuming. Each change opens a window where you set only what you want to change - an empty field stays unchanged. - **Filters** - the button opens the panel with the channel's filters. The number on the button tells how many filters are on. - **Preview** - click the title or the eye icon to see the whole offer: images, description, parameters and conditions. Warnings from the channel are here too, for example why the offer was refused. ![The Offer management tab on the example of Allegro: the results bar, the Operations and Filters buttons and offer cards](https://ritevo.com/docs/integrations/allegro/en-offers.webp) ## Offer listing Here you see the products ordered for listing and the stage each of them is at. 1. On the **Products** list, select products and click the channel's listing button, for example **List on Allegro**. 2. The products show up on the **Offer listing** tab, each with its status. You can close the browser - the listing goes on. 3. If the channel needs it (for example you have to choose a product from its catalogue), complete the offer and click **Approve and list**. 4. Once the channel lists the offer, the product leaves **Offer listing** and the offer shows up in **Offer management**. It is already linked to the warehouse product you listed it from. 5. If the channel does not accept the offer, the product gets the **Error** status and you see the reason the channel gave next to it. Fix it and click **Retry**, or remove the product from the list with **Delete**. - **Status filters** - above the list there are buttons with the statuses and the number of products in each. **All** shows the whole list. - **Product tile** - on top the future offer (title, image, price, number of items, shipping rate and the order date), below it the warehouse product you list it from. - **Bar above the list** - the checkbox next to **Results found** selects the whole page. **Approve and list**, **Retry** and **Delete** work on the selected products the action makes sense for. - **Corrections** - the title or the pencil on a tile opens a window with the whole offer. You fix the data there before approving or retrying. ![The Offer listing tab on the example of Allegro: status filters, the bar with the Approve and list, Retry and Delete buttons and product tiles](https://ritevo.com/docs/integrations/allegro/en-listings.webp) ## What the statuses mean - **Waiting for search** - we are looking the product up in the channel's catalogue by its EAN. - **To choose** - we found a matching product in the channel's catalogue (sometimes several). Choose the right one, check the offer and click **Approve and list**. - **Not in catalogue** - the channel's catalogue has no product with this EAN. For now we do not list offers of products missing from the channel's catalogue, so this product cannot be listed. You can remove it from the list. - **Waiting to be sent** - the offer is ready, we send it to the channel in a moment. - **Processing** (for example **Processed by Allegro**) - the channel got the offer and is checking it. It usually takes a few seconds. - **Error** - the channel did not accept the offer. You see the reason the channel gave next to the product. Fix what it is about and click **Retry**. Listing item statuses in the API (`status`): `WAITING_FOR_SEARCH` (Waiting for search), `WAITING_FOR_CHOICE` (To choose), `NOT_FOUND` (Not in catalogue), `SENDING` (Waiting to be sent), `PROCESSING` (Processing), `FAILED` (Error - the reason in `errorMessage`). A listed offer has no status: it leaves the listing list and is on the channel's offer list, linked to the product from `warehouseProductId`. ## How long an item stays on the list Products stay on the **Offer listing** list for at most 7 days from the order. Then we delete them, also those not listed yet. You can remove a product yourself earlier with **Delete**. ## Changes and listing run in the background Offer changes and listing are asynchronous: when you click, we send them to the channel in the background, and the channel usually carries them out within a few seconds. Where you check the result depends on what you ordered: - **Offer change** (stock, price, delivery, content, ending, resuming) - the new value shows up on the list in **Offer management**. If it does not, the channel did not accept the change - try again or check the offer in the channel's panel. - **Listing an offer** - the progress and any error with the channel's reason are in **Offer listing**. A listed offer moves to **Offer management**. - **Several changes in a row** - make the next change of the same offers only once the list shows the previous one. Otherwise the older change can overwrite the newer one. Offer changes (e.g. `POST .../offers/batch`, `POST .../offers/publication/batch`) return `202` with no body: the change is queued and goes to the channel in the background. We save neither the change nor its result - there is no endpoint with the change status and no error message. You check the result by fetching the offer again (`GET .../offers/{offerId}`): if the value has not changed after a few dozen seconds, the channel refused the change. Changes sent shortly after each other can run in any order - send the next change of the same offers only after the previous one is confirmed. Listing is different - we save it: the progress and error of each product (`status`, `errorMessage`) come from `GET .../offer-listings`, and a listed offer leaves it and is in `GET .../offers`. ## What depends on the channel The filters on the offer list, the available changes, the ways of listing and the statuses depend on the channel. They are described on that channel's integration page. ## Link to a product On the offer card you link it to a warehouse product (the chain icon) or remove the link. The link works the same as in orders - more in [Linking offers to products](https://ritevo.com/en/docs/products/offer-links). ## Not available yet - A stock or price change in the warehouse does not reach the channel on its own yet - you change it in **Offer management**. - It does not show the offer's change history. ## Offer management through the API The offer and listing endpoints are separate for each channel and are described in the API section of the channel's integration page - today [Allegro](https://ritevo.com/en/docs/integrations/allegro#offers). --- All help in one file: https://ritevo.com/llms-full.txt. Help map with links to every page: https://ritevo.com/llms.txt.