A POST
to the /products/queue
endpoint allows your application to create a Product by adding to the process queue.
What happens when a product is queued?
The main difference between this endpoint and Add Product
is queuing a product adds the product request to a batch processing queue.
The response time for this request is much faster than an Add Product, as the job is submitted instantly.
The payload required for this endpoint is identical to the Add Product endpoint.
In addition to the above, this endpoint includes the same functionality as Create or Update a Product, where an existing product is searched by external_id
which will update the product if found. If no existing product is found, the product is created instead. Product variants follow the same logic, but with their sku
instead
Queued products may not be created instantly
The processing time of products submitted to the queue is subject to the other jobs within the queue. The response will contain no data relating to the product. A
product.created
orproduct.updated
event will be triggered as each product is processed. Developers can use this to retrieve data relating to the submitted product.
When to use Queue Product
Queueing is primarily used for batch importing products.
The Queue endpoint allows developers to submit high volumes of products for processing on a batch queue. This is usually done by the developer by looping through products on the external system, and sending them to the Queue Product endpoint.
When not to use Queue Product
If response data is required after submitting the request to this endpoint. Queue Product will return a 200 response 'OK' with every successful submission. This will not contain any information about the submitted product. If response data is required for population on a website or internal system, use the Add Product endpoint instead
If products need to be created immediately, this endpoint is not suitable. All products submitted via this endpoint are subject to the other jobs on the queue. Because of this, Omneo cannot guarantee the time of creation.