datawebotWildberries product cards, prices and inventory data
Map Wildberries nmID, size prices and warehouse inventory without confusing seller records with buyer-facing availability.
Join Wildberries product cards to size records carefully
WB product-card, pricing and inventory methods use identifiers at different levels. Keep each raw key with its endpoint and the seller context; join size records only through a documented or returned mapping.
Scroll to compare →
| Field | Source meaning | Comparison rule |
|---|---|---|
| nmID | Wildberries article for a product card. | Use as the WB card key; preserve the source URL and authorized seller context. |
| imtID | Card or merged-card group context in product-card data. | Retain as grouping information rather than substituting it for nmID. |
| vendorCode | Seller's own article code. | Keep as seller-side identity; it is not the WB article number. |
| chrtID and sizeID | Product-card/inventory size key and pricing-method size key, respectively. | Do not treat them as interchangeable unless an endpoint response confirms their relationship. |
| techSize, wbSize and skus | Technical size, displayed size and size-level SKU/barcode values in product-card data. | Store each value as returned; do not use sku as a seller-inventory key in the current methods. |
Separate regular, discounted and WB Club price fields
The Prices and Discounts API returns seller product price states with currency and discount fields. A size-specific price is supported only for eligible product categories, and the page should preserve that distinction instead of flattening all amounts into one offer price.
Scroll to compare →
| Field | Meaning in the seller API | Record with it |
|---|---|---|
| price | Seller price value returned by the method. | Currency code, product/size key and response time. |
| discountedPrice | Price after the general discount reported in the response. | The corresponding discount field; do not assume every buyer receives it. |
| clubDiscountedPrice | Separate price after a WB Club discount. | clubDiscount and eligibility context; do not merge with discountedPrice. |
| currencyIsoCode4217 | Currency code for the returned price values. | Retain with all amounts; do not convert without a dated exchange-rate source. |
| editableSizePrice | Indicates whether a product category permits price setting by size. | When true, the separate size-price method uses nmID and sizeID; do not infer a size price from a card-level amount otherwise. |
Choose seller-warehouse or WB-warehouse inventory
Wildberries documents separate seller-warehouse inventory management and WB-warehouse inventory reporting. The endpoint determines the warehouse model, record grain, update cadence and required token category; neither report is a buyer's address-specific checkout promise.
Scroll to compare →
| Inventory path | Documented grain or rule | Keep with the observation |
|---|---|---|
| Seller warehouse inventory | Marketplace methods return seller stock by warehouse and product size, using chrtId and amount. | Seller warehouse ID, delivery/warehouse model, chrtId and observation time. |
| Current WB warehouse report | POST /api/analytics/v1/stocks-report/wb-warehouses returns one row for a product size at one WB warehouse; WB reports a 30-minute update interval. | nmID/chrtID, warehouse ID/name, region, method, Analytics token context and report time. |
| Seller inventory key change | WB's December 2025 release notes say chrtId was added to inventory methods and sku stopped being used for them from 9 February 2026. | Use the current method's chrtId; retain any barcode/SKU only as a separate card attribute. |
| Shopper-facing listing | A public product page presents the selected offer in its current shopping context. | Do not infer all-warehouse quantity, competitor stock or local pickup availability from seller API data. |
Match token scope to the seller data method
WB states that sellers create API tokens in the seller account, choose relevant categories and set read-only or read/write access. The API is a seller operations and reporting system; a token category determines which account methods can be called.
Scroll to compare →
| Token or category | WB documentation describes | Boundary for a data record |
|---|---|---|
| Content | Product-card, category, characteristic and media methods. | Card content belongs to the seller account that authorized the request. |
| Prices and Discounts | Seller price and discount methods, including category-dependent size prices. | Do not label these seller values as public competitor prices or universal checkout amounts. |
| Marketplace | Seller warehouses and seller-warehouse inventory methods. | Keep warehouse ownership and delivery model explicit. |
| Analytics | Seller reports, including the current WB-warehouse stock report. | Report rows are account-authorized data, not an anonymous marketplace-wide export. |
| Token type | Personal for the seller's own programs; Service for a selected cloud service in WB's business-solutions catalog; Base has limited data access; Test uses sandbox data. | Never request, publish or place a seller credential in a public product URL or record. |
Content reviewed 2026-10-07.