Orders

GET /api/v1/supplier/orders

Base URL: https://statistics-api.wildberries.ru · Module: reports · Section: Main Reports · Specification doc ↗

The method returns order information. The data updated every 30 minutes.

1 line means 1 order and means 1 item. The srid field should be used to identify the order.

Data storage is guaranteed for no more than 90 days from the date of order.

The responses do not include orders for which payment was not confirmed. For example, it could be orders with delayed payments or installment payments. However, if there are sales for such orders, you can get it using details for the sales reports. To receive all completed orders, use Order Feed.

The data in this report is preliminary and is used for operational monitoring

For a single response to a request with flag=0 or without flag, a conditional limit of 80,000 rows is set. Therefore, more than one request may be necessary to retrieve all orders. In the second and subsequent requests, use the full value of the lastChangeDate field of the last row from the response of the previous request in the dateFrom parameter. If the response returns an empty array [], all orders have already been retrieved.

Request limit per one seller account:

Type	Period	Limit	Interval	Burst
Personal	1 min	1 request	1 min	10 requests
Service	1 min	1 request	1 min	10 requests
Base with secret	1 min	1 request	1 min	10 requests
Base	3 h	1 request	3 h	1 request

Parameters

Name	In	Type	Req.	Description
dateFrom	query	string	yes	Date and time of last change on the order. Date format: RFC3339. You may send date or date with time. Time could be specified in seconds or milliseconds. The time stands in Moscow time zone (UTC+3). Examples: - 2019-06-20 - 2019-06-20T23:59:59 - 2019-06-20T00:00:00.12345 - 2017-03-25T00:00:00

Responses

Code	Description	Schema
200	Success	GetV1SupplierOrdersResponse200
400	Bad request	object
401	Unauthorized	object
402	Payment required	object
403	Access denied	object
429	Too many requests	object

Structure 200 — OrdersItem[]:

• date string — Date and time of order. This field equals to dateFrom in request if flag=1. If the time zone is not specified, then Moscow time UTC+3 is taken.
• lastChangeDate string — Date and time of refreshing info of service. This field corresponds to the dateFrom parameter in the request if the flag=0 parameter exist or not specified. If the time zone is not specified, then Moscow time UTC+3 is taken.
• warehouseName string — Shipping warehouse name
• warehouseType string = Склад WB | Склад продавца — Type of items storage warehouse: - Склад WB — WB warehouse - Склад продавца — seller warehouse
• countryName string — Country
• oblastOkrugName string — Area
• regionName string — Region
• supplierArticle string — Seller item number
• nmId integer<int64> — WB item number
• barcode string — SKU
• category string — Category
• subject string — Subcategory
• brand string — Brand
• techSize string — Item size
• incomeID integer<int64> — Supply number
• isSupply boolean — Supply contract
• isRealization boolean — Implementation contract
• totalPrice number — Price without discounts
• discountPercent integer<int64> — Seller discount, %
• spp number — WB discount, %
• finishedPrice number — Price with all discounts, except WB Wallet sum
• priceWithDisc number — Price with seller discount, including WB Club discount
• isCancel boolean — Order cancel: - true — the order is cancelled
• cancelDate string — Date and time for order canceling. If order wasn't canceled, then "0001-01-01T00:00:00". If the time zone is not specified, then Moscow time UTC+3 is taken.
• sticker string — sticker ID
• gNumber string — Buyer cart ID. Orders within a single transaction will have the same gNumber
• srid string — Unique order ID. Note for those working with Marketplace API: srid equals rid in response of orders methods

Structure 400:

• one of: responseErrorStatistics, responseErrorStatistics2

Structure 401:

• title string — Error title
• detail string — Error details
• code string — Internal error code
• requestId string — Unique request ID
• origin string — WB internal service ID
• status number — HTTP status code
• statusText string — Text of the HTTP status code
• timestamp string — Request date and time

Structure 402:

• title string — Error title
• detail string — Error details. The error is only returned to services from the Solutions for business Catalog

Structure 403:

• title string — Error title
• detail string — Error details
• code string — Internal error code
• requestId string — Request ID
• origin string — WB internal service ID
• status number — HTTP status code
• statusText string — Text of the HTTP status code
• timestamp string — Request date and time

Structure 429:

• title string — Error title
• detail string — Error details
• code string — Internal error code
• requestId string — Unique request ID
• origin string — WB internal service ID
• status number — HTTP status code
• statusText string — Text of the HTTP status code
• timestamp string — Request date and time

Call examples

Arguments are shown as parameter names — substitute your own values. Languages whose client does not expose this operation are omitted.

Python

from wb_api_client.reports import Configuration, ApiClient
from wb_api_client.reports.api import ReportsApi

cfg = Configuration(access_token="<your WB JWT>")
api = ReportsApi(ApiClient(cfg))

result = api.get_v1_supplier_orders(date_from=..., flag=...)
print(result)

TypeScript

import {
  Configuration,
  ReportsApi,
} from "@valeryverkhoturov/wb-api-client/reports";

const cfg = new Configuration({});
cfg.setAccessToken("<your WB JWT>");
const api = new ReportsApi(cfg);

const { data } = await api.getV1SupplierOrders(dateFrom, flag);
console.log(data);

Go

import (
	"context"
	"fmt"

	wbreports "github.com/ValeryVerkhoturov/wb-api-client-go/reports"
)

cfg := wbreports.NewConfiguration()
cfg.SetAccessToken("<your WB JWT>")
client := wbreports.NewAPIClient(cfg)

result, _, err := client.ReportsAPI.GetV1SupplierOrders(context.Background()).DateFrom(dateFrom).Execute()
if err != nil {
    panic(err)
}
fmt.Printf("%+v\n", result)

Java

import io.github.valeryverkhoturov.wbapi.reports.ApiClient;
import io.github.valeryverkhoturov.wbapi.reports.SecretString;
import io.github.valeryverkhoturov.wbapi.reports.api.ReportsApi;

ApiClient client = new ApiClient();
client.setAccessToken(new SecretString("<your WB JWT>"));
ReportsApi api = new ReportsApi(client);

System.out.println(api.getV1SupplierOrders(dateFrom, flag));

PHP

use ValeryVerkhoturov\WbApiClient\Reports\Configuration;
use ValeryVerkhoturov\WbApiClient\Reports\SecretString;
use ValeryVerkhoturov\WbApiClient\Reports\Api\ReportsApi;
use GuzzleHttp\Client;

$config = (new Configuration())
    ->setAccessTokenSecret(new SecretString('<your WB JWT>'));
$api = new ReportsApi(new Client(), $config);

print_r($api->getV1SupplierOrders($date_from));

OneScript

#Использовать "wb-api-client"

Настройки = Новый Конфигурация();
Настройки.УстановитьТокен("<your WB JWT>");
Клиент = Новый ReportsApi(Настройки);

Сообщить(Клиент.GetV1SupplierOrders(dateFrom).Тело);

C#

using ValeryVerkhoturov.WbApiClient.Reports.Api;
using ValeryVerkhoturov.WbApiClient.Reports.Client;

var config = new Configuration();
config.AccessTokenSecret = new SecretString("<your WB JWT>");
var api = new ReportsApi(config);

Console.WriteLine(api.GetV1SupplierOrders(dateFrom));

Rust

use wb_api_client::reports::apis::{configuration::Configuration, reports_api};

#[tokio::main]
async fn main() {
    let mut cfg = Configuration::new();
    cfg.set_access_token("<your WB JWT>");

    let result = reports_api::get_v1_supplier_orders(&cfg, date_from, flag).await;
    println!("{:#?}", result);
}