What is an asynchronous ingestion?
Asynchronous ingestion accepts product data first and processes it afterwards, so an accepted request is not yet a finished product.
In plain words: When a system ingests product data asynchronously, it answers 'received' straight away and does the work in the background. The sender then checks a status, or is told, when each product is finished, partly done or has failed. Acceptance and completion are 2 separate moments.
Published by Youzu · Editorial policy
- Published
Why it matters
Treating an accepted request as a finished product is a common integration mistake. Storefronts then show records that are still being processed, and failures go unnoticed because no one looked at the status.
How it works
Accept
The receiver validates the request, stores the data and replies that it has been accepted.
Process
Background steps run on each product, and each product carries a status while they do.
Read back
The sender reads the status and the result, retrying or correcting products that failed.
| State | What it means | What the sender does |
|---|---|---|
| Accepted | The data is stored and queued | Wait and keep the identifier |
| Processing | Steps are still running | Do not publish yet |
| Finished | All steps are complete | Read the result and use it |
| Partial or failed | A step stopped or was rejected | Correct the data and send it again |
Examples
A jacket file, accepted
A file with the 9 olive-jacket variants is accepted at once.
A matching step still running
2 sofa listings are stored but not yet compared.
A re-sent offer
A seller re-sends the armchair with a corrected width.
Common mistakes
Accepted means finished. A storefront publishes records the moment the request is accepted, before the steps behind it have run.
No plan for failure. Only the successful path is built, so a rejected product has no owner and no retry.
Related terms
- Catalog intelligence
- The use of AI to turn raw product and listing data into structured, reviewed product records.
- Product data enrichment
- Adding missing information or improving existing information on a product record so products can be found, filtered and compared.
- Product feed
- A product feed is a structured file of product and offer data that a sales or shopping channel reads on a schedule.
In Youzu
Youzu helps marketplaces, classifieds and retailers turn raw seller and supplier product data into structured, reviewable catalog records.
Sources
RFC 9110: HTTP Semantics, 15.3.3 202 Accepted, IETF. rfc-editor.org/rfc/rfc9110. Accessed .
RFC 7240: Prefer Header for HTTP, respond-async, IETF. rfc-editor.org/rfc/rfc7240. Accessed .
FAQ
Questions buyers ask
No. Ingestion is asynchronous: an accepted request does not mean enrichment, indexing or deduplication has finished, and each product shows its processing status. Publish a product only once its status shows the steps you rely on have finished. Until then, keep it away from shoppers.
Read its processing status. Processed products, variants, offers, moderation state and processing status can be read back through the API with filters. Ready means the status shows that the steps you depend on have finished, and until it does the product is not ready to publish.
Changed products can be re-sent at any time; the same SKU identifies a later version of an offer. Send the corrected version, then read the status again before you rely on the new version, so that you never publish a half-processed record.
Last reviewed
Related
Keep reading
Product
Catalog Intelligence for marketplaces and retailers
Catalog Intelligence maps products to your category tree, extracts category attributes, keeps variants and offers apart and flags issues for review.
Glossary
What is catalog intelligence?
Catalog intelligence defined in plain words, with a worked example, common mistakes and links to the guides and Youzu products that apply it.
Guide
Marketplace catalog management: a practical guide
How marketplaces keep one accurate product record while many sellers list the same items differently: onboarding, categorization, matching and review.