### Get Licenses and Keys Request Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example GET request to retrieve a list of licenses and keys for digital products. ```http GET https://suppliers-api.wildberries.ru/api/v1/digital/licenses?productId=dp-12345&limit=10&offset=0 Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Get Integrations Request Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example GET request for the /digital/integrations endpoint. ```http GET https://suppliers-api.wildberries.ru/api/v1/digital/integrations Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Example request for checking import status Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example of a GET request to check the status of a digital license import process. ```http GET https://suppliers-api.wildberries.ru/api/v1/digital/licenses/import/imp-12345 Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Get Sales Analytics Request Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example GET request to retrieve sales statistics for digital products. ```http GET https://suppliers-api.wildberries.ru/api/v1/digital/analytics/sales?dateFrom=2023-01-01&dateTo=2023-01-31&groupBy=product Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Get Notifications Request Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example GET request to retrieve a list of notifications with query parameters. ```http GET https://suppliers-api.wildberries.ru/api/v1/digital/notifications?dateFrom=2023-01-01&dateTo=2023-01-31&limit=10&offset=0 Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Get Appeals Example Request Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Общение с покупателями.md Example GET request to retrieve new appeals with pagination. ```http GET https://feedbacks-api.wildberries.ru/api/v1/appeals?status=new&limit=10&offset=0 Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### GET request for API limits Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Общее.md Example of a GET request to retrieve API limits. ```http GET https://suppliers-api.wildberries.ru/api/v3/limits ``` -------------------------------- ### Analytics Usage Request Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example GET request for the /digital/analytics/usage endpoint, with query parameters for product ID and date range. ```http GET https://suppliers-api.wildberries.ru/api/v1/digital/analytics/usage?productId=dp-12346&dateFrom=2023-01-01&dateTo=2023-01-31 Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Response for getting licenses Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response when retrieving a list of digital licenses. ```json { "data": { "licenses": [ { "id": "dlic-12345", "productId": "dp-12345", "nmId": 87654321, "key": "*****-*****-*****-*****-AB123", "type": "activation_key", "status": "available", "createdAt": "2023-01-01T10:00:00Z", "updatedAt": "2023-01-01T10:00:00Z", "usedAt": null, "expiresAt": null, "order": null }, { "id": "dlic-12346", "productId": "dp-12345", "nmId": 87654321, "key": "*****-*****-*****-*****-CD456", "type": "activation_key", "status": "used", "createdAt": "2023-01-01T10:00:00Z", "updatedAt": "2023-01-15T12:30:00Z", "usedAt": "2023-01-15T12:30:00Z", "expiresAt": null, "order": { "orderId": 123456789, "orderDate": "2023-01-15T12:00:00Z", "userEmail": "u****r@example.com" } } ], "pagination": { "total": 50, "limit": 10, "offset": 0, "hasMore": true }, "summary": { "available": 25, "used": 25, "expired": 0, "revoked": 0 } }, "error": null } ``` -------------------------------- ### Response example for settings Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Общее.md Example JSON response showing user settings for email, SMS, and push notifications. ```json { "data": { "settings": { "email": { "orders": true, "feedback": true, "stockAlerts": true, "promotions": false }, "sms": { "orders": false, "feedback": false, "stockAlerts": true, "promotions": false }, "push": { "orders": true, "feedback": true, "stockAlerts": true, "promotions": true } }, "updatedAt": "2023-01-15T11:30:00Z" }, "error": null } ``` -------------------------------- ### Get Subscription Details Request Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example GET request to retrieve detailed information about a specific digital subscription. ```http GET https://suppliers-api.wildberries.ru/api/v1/digital/subscriptions/{id} Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Get Notifications Response Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response for a list of digital product notifications. ```json { "data": { "notifications": [ { "id": "dnotif-12345", "type": "new_order", "title": "Новый заказ цифрового товара", "message": "Поступил новый заказ на цифровой товар 'Электронная книга 'Программирование на Python''", "createdAt": "2023-01-15T12:00:00Z", "status": "read", "readAt": "2023-01-15T12:30:00Z", "priority": "medium", "relatedEntity": { "type": "order", "id": "dord-12345" } }, { "id": "dnotif-12346", "type": "product_approval", "title": "Цифровой товар одобрен", "message": "Ваш цифровой товар 'Видеокурс 'Дизайн интерьера: от основ к мастерству'' успешно прошел проверку и опубликован", "createdAt": "2023-01-30T14:30:00Z", "status": "unread", "readAt": null, "priority": "high", "relatedEntity": { "type": "product", "id": "dp-12347" } } ], "pagination": { "total": 25, "limit": 10, "offset": 0, "hasMore": true }, "summary": { "totalNotifications": 25, "unreadNotifications": 10, "highPriorityNotifications": 5 }, "dateFrom": "2023-01-01T00:00:00Z", "dateTo": "2023-01-31T23:59:59Z" }, "error": null } ``` -------------------------------- ### Example request for importing licenses from a file Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example of a multipart/form-data request to import digital licenses from a CSV file. ```http POST https://suppliers-api.wildberries.ru/api/v1/digital/licenses/import Content-Type: multipart/form-data Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... --boundary Content-Disposition: form-data; name="file"; filename="keys.csv" Content-Type: text/csv productId,key,type dp-12345,EFGHI-34567-JKLMN-89012-OPQRS,activation_key dp-12345,TUVWX-45678-YZABC-90123-DEFGH,activation_key dp-12345,IJKLM-56789-NOPQR-01234-STUVW,activation_key --boundary Content-Disposition: form-data; name="format" csv --boundary-- ``` -------------------------------- ### Example request for API limits Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Общее.md Example request including headers for retrieving API limits. ```http GET https://suppliers-api.wildberries.ru/api/v3/limits Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Get List of Digital Products Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md This code snippet shows an example GET request to retrieve a list of digital products, including query parameters for limit and offset, and headers for content type and authorization. ```http GET https://suppliers-api.wildberries.ru/api/v1/digital/products?limit=10&offset=0 Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Get question by ID example request Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Общение с покупателями.md Example HTTP request to fetch a question by its ID. ```http GET https://feedbacks-api.wildberries.ru/api/v1/questions/question-12345 Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### GET request for current API usage Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Общее.md Example of a GET request to retrieve current API usage statistics. ```http GET https://suppliers-api.wildberries.ru/api/v3/usage ``` -------------------------------- ### Response example for current API usage Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Общее.md Example JSON response detailing overall API usage, usage by endpoint, and usage by day. ```json { "data": { "overall": { "totalRequests": 12500, "successRequests": 12450, "failedRequests": 50, "averageResponseTime": 120 }, "byEndpoint": [ { "endpoint": "/api/v3/orders", "method": "GET", "requests": 5000, "successRate": 99.8, "averageResponseTime": 110 }, { "endpoint": "/api/v3/stocks", "method": "PUT", "requests": 3500, "successRate": 99.5, "averageResponseTime": 150 }, { "endpoint": "/api/v3/content", "method": "POST", "requests": 4000, "successRate": 99.0, "averageResponseTime": 180 } ], "byDay": [ { "date": "2023-01-01", "requests": 800, "successRate": 99.5 }, { "date": "2023-01-02", "requests": 950, "successRate": 99.7 }, { "date": "2023-01-03", "requests": 900, "successRate": 99.8 } ], "dateFrom": "2023-01-01T00:00:00Z", "dateTo": "2023-01-15T23:59:59Z" }, "error": null } ``` -------------------------------- ### Example request for current API usage Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Общее.md Example request with query parameters and headers for retrieving API usage. ```http GET https://suppliers-api.wildberries.ru/api/v3/usage?dateFrom=2023-01-01&dateTo=2023-01-15 Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Create Digital Product Response Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response after successfully creating a digital product, indicating it has been sent for review. ```json { "data": { "product": { "id": "dp-12347", "nmId": 87654323, "vendorCode": "DG-12347", "name": "Видеокурс 'Дизайн интерьера для начинающих'", "description": "Курс по основам дизайна интерьера с практическими заданиями и консультациями", "productType": "video_course", "price": 3900.00, "discountedPrice": 3500.00, "currency": "RUB", "status": "draft", "createdAt": "2023-01-30T10:00:00Z", "updatedAt": "2023-01-30T10:00:00Z", "publishedAt": null, "categories": ["Образование", "Дизайн"], "tags": ["дизайн", "интерьер", "курсы", "обучение", "для начинающих"], "metadata": { "author": "Петрова А.А.", "provider": "Design School", "duration": 15, "durationType": "hours", "lessons": 25, "accessDuration": 6, "accessDurationType": "months", "certificateProvided": true }, "files": [ { "id": "df-12348", "type": "preview", "url": "https://suppliers-api.wildberries.ru/api/v1/digital/files/df-12348.mp4", "size": 35000000, "contentType": "video/mp4" }, { "id": "df-12349", "type": "full", "url": "https://suppliers-api.wildberries.ru/api/v1/digital/files/df-12349.zip", "size": 750000000, "contentType": "application/zip" } ], "salesCount": 0, "rating": null, "reviewsCount": 0, "additionalInfo": { "approvalStatus": "pending_review", "approvalComment": null, "estimatedApprovalDate": "2023-02-02T00:00:00Z" } }, "message": "Цифровой продукт успешно создан и отправлен на проверку" }, "error": null } ``` -------------------------------- ### Create Digital Product Request Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON payload for creating a new digital product, such as a video course. ```json { "vendorCode": "DG-12347", "name": "Видеокурс 'Дизайн интерьера для начинающих'", "description": "Курс по основам дизайна интерьера с практическими заданиями и консультациями", "productType": "video_course", "price": 3900.00, "discountedPrice": 3500.00, "currency": "RUB", "categories": ["Образование", "Дизайн"], "tags": ["дизайн", "интерьер", "курсы", "обучение", "для начинающих"], "metadata": { "author": "Петрова А.А.", "provider": "Design School", "duration": 15, "durationType": "hours", "lessons": 25, "accessDuration": 6, "accessDurationType": "months", "certificateProvided": true }, "files": [ { "id": "df-temp-12348", "type": "preview", "tempUrl": "https://suppliers-api.wildberries.ru/api/v1/digital/temp-files/df-temp-12348.mp4" }, { "id": "df-temp-12349", "type": "full", "tempUrl": "https://suppliers-api.wildberries.ru/api/v1/digital/temp-files/df-temp-12349.zip" } ], "publishImmediately": false } ``` -------------------------------- ### Get Subscription Details Response Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response containing detailed information for a single digital subscription. ```json { "data": { "subscription": { "id": "dsub-12345", "orderId": 123456790, "productId": "dp-12346", "nmId": 87654322, "vendorCode": "DG-12346", "productName": "Годовая подписка на онлайн-курс 'Английский для начинающих'", "status": "active", "createdAt": "2023-01-20T15:30:00Z", "updatedAt": "2023-01-20T15:30:00Z", "startDate": "2023-01-20T15:30:00Z", "endDate": "2024-01-20T15:30:00Z", "autoRenewal": false, "renewalDate": null, "userInfo": { "email": "u****2@example.com", "phone": "+7*****23456", "name": "Пет****ров" }, "price": 4900.00, "period": { "value": 12, "unit": "months" }, "accessInfo": { "url": "https://example.com/course/english-beginners/", "credentials": { "login": "****", "password": "****" } }, "usageStatistics": { "lastAccessDate": "2023-01-29T18:30:00Z", "totalLogins": 15, "completedLessons": 10, "totalLessons": 25, "progressPercent": 40 }, "history": [ { "status": "created", "date": "2023-01-20T15:00:00Z", "comment": "Подписка создана" }, { "status": "active", "date": "2023-01-20T15:30:00Z", "comment": "Подписка активирована" } ] } }, "error": null } ``` -------------------------------- ### Get All Subscriptions Response Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response when retrieving a list of digital subscriptions. ```json { "data": { "subscriptions": [ { "id": "dsub-12345", "orderId": 123456790, "productId": "dp-12346", "nmId": 87654322, "vendorCode": "DG-12346", "productName": "Годовая подписка на онлайн-курс 'Английский для начинающих'", "status": "active", "createdAt": "2023-01-20T15:30:00Z", "updatedAt": "2023-01-20T15:30:00Z", "startDate": "2023-01-20T15:30:00Z", "endDate": "2024-01-20T15:30:00Z", "autoRenewal": false, "renewalDate": null, "userEmail": "u****2@example.com", "price": 4900.00, "period": { "value": 12, "unit": "months" }, "accessInfo": { "url": "https://example.com/course/english-beginners/", "credentials": { "login": "****", "password": "****" } } }, { "id": "dsub-12346", "orderId": 123456791, "productId": "dp-12346", "nmId": 87654322, "vendorCode": "DG-12346", "productName": "Годовая подписка на онлайн-курс 'Английский для начинающих'", "status": "active", "createdAt": "2023-01-25T10:30:00Z", "updatedAt": "2023-01-25T10:30:00Z", "startDate": "2023-01-25T10:30:00Z", "endDate": "2024-01-25T10:30:00Z", "autoRenewal": true, "renewalDate": "2024-01-20T10:30:00Z", "userEmail": "u****3@example.com", "price": 4900.00, "period": { "value": 12, "unit": "months" }, "accessInfo": { "url": "https://example.com/course/english-beginners/", "credentials": { "login": "****", "password": "****" } } } ], "pagination": { "total": 15, "limit": 10, "offset": 0, "hasMore": true }, "summary": { "totalSubscriptions": 15, "activeSubscriptions": 12, "expiredSubscriptions": 2, "canceledSubscriptions": 1, "autoRenewalEnabled": 8 } }, "error": null } ``` -------------------------------- ### Example DBS Report Status Check Request Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Заказы DBS.md An example of a GET request to check the status of a specific DBS report, including headers. ```http GET https://suppliers-api.wildberries.ru/api/v3/orders/dbs/report/dbs-rep-12345 Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Get list of questions response Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Общение с покупателями.md Example JSON response containing a list of customer questions. ```json { "data": { "countUnanswered": 3, "questions": [ { "id": "question-12345", "text": "Подскажите, пожалуйста, какой материал у футболки? Полностью хлопок или есть примеси?", "createDate": "2023-01-10T11:30:00Z", "state": "none", "answer": null, "productDetails": { "nmID": 87654321, "imt": 12345678, "vendorCode": "WB-12345", "productName": "Футболка хлопковая с принтом", "supplierArticle": "WB-12345", "brand": "BrandName", "brandId": 123 }, "user": { "fio": "Петр П." } }, { "id": "question-12346", "text": "Скажите, футболка подойдет на рост 185 см?", "createDate": "2023-01-09T15:45:00Z", "state": "none", "answer": null, "productDetails": { "nmID": 87654321, "imt": 12345678, "vendorCode": "WB-12345", "productName": "Футболка хлопковая с принтом", "supplierArticle": "WB-12345", "brand": "BrandName", "brandId": 123 }, "user": { "fio": "Алексей А." } } ] }, "error": null } ``` -------------------------------- ### Response example for API limits Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Общее.md Example JSON response detailing API limits per endpoint, method, period, and remaining requests. ```json { "data": { "limits": [ { "endpoint": "/api/v3/orders", "method": "GET", "limit": 60, "period": "minute", "remaining": 58, "reset": "2023-01-15T11:31:00Z" }, { "endpoint": "/api/v3/stocks", "method": "PUT", "limit": 100, "period": "minute", "remaining": 95, "reset": "2023-01-15T11:31:00Z" }, { "endpoint": "/api/v3/content", "method": "POST", "limit": 1000, "period": "day", "remaining": 950, "reset": "2023-01-16T00:00:00Z" } ], "quotaExceeded": false, "serverTime": "2023-01-15T11:30:30Z" }, "error": null } ``` -------------------------------- ### Create User Notification Response Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response after creating a user notification. ```json { "data": { "notification": { "id": "user-notif-12345", "orderId": "dord-12345", "subject": "Важное обновление к вашей книге по Python", "createdAt": "2023-01-31T10:00:00Z", "status": "sent", "deliveredVia": ["email", "app"], "message": "Уведомление успешно отправлено пользователю" } }, "error": null } ``` -------------------------------- ### Upload File for Digital Product Request Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example of a multipart/form-data request to upload a file for a digital product. ```http POST https://suppliers-api.wildberries.ru/api/v1/digital/files/upload Content-Type: multipart/form-data Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... --boundary Content-Disposition: form-data; name="file"; filename="preview.mp4" Content-Type: video/mp4 [бинарные данные файла] --boundary Content-Disposition: form-data; name="productId" dp-12347 --boundary Content-Disposition: form-data; name="fileType" preview --boundary-- ``` -------------------------------- ### Analytics Usage Response Example (Specific Product) Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response for the /digital/analytics/usage endpoint, detailing usage statistics for a specific digital product. ```json { "data": { "product": { "id": "dp-12346", "nmId": 87654322, "vendorCode": "DG-12346", "name": "Годовая подписка на онлайн-курс 'Английский для начинающих'" }, "usage": { "activeUsers": 10, "totalAccesses": 150, "averageAccessesPerUser": 15, "accessesByDay": [ { "date": "2023-01-20", "count": 10 }, { "date": "2023-01-21", "count": 15 }, { "date": "2023-01-22", "count": 20 } ], "accessesByHour": [ { "hour": 0, "count": 2 }, { "hour": 1, "count": 0 }, { "hour": 2, "count": 0 } ], "contentCompletion": { "users": { "notStarted": 1, "inProgress": 7, "completed": 2 }, "lessons": { "mostPopular": "Урок 1: Приветствие и знакомство", "leastPopular": "Урок 20: Грамматические исключения" }, "completionRate": 40.0 }, "retention": { "day1": 100.0, "day7": 90.0, "day30": 80.0 }, "engagement": { "averageSessionDuration": "00:45:30", "sessionsPerUser": 5.2, "mostActiveUserTime": "19:00-21:00" } }, "dateFrom": "2023-01-01T00:00:00Z", "dateTo": "2023-01-31T23:59:59Z" }, "error": null } ``` -------------------------------- ### Mark Notification as Read Response Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response after marking a notification as read. ```json { "data": { "notification": { "id": "dnotif-12346", "status": "read", "readAt": "2023-01-31T11:00:00Z", "message": "Уведомление отмечено как прочитанное" } }, "error": null } ``` -------------------------------- ### Analytics Usage Response Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response for the /digital/analytics/usage endpoint, showing detailed usage statistics for a digital product. ```json { "data": { "summary": { "totalSales": 25, "totalRevenue": 20000.00, "averageOrderValue": 800.00, "conversionRate": 2.5 }, "byProduct": [ { "productId": "dp-12345", "nmId": 87654321, "vendorCode": "DG-12345", "name": "Электронная книга 'Программирование на Python'", "sales": 15, "revenue": 7350.00, "averagePrice": 490.00, "returnsCount": 0, "returnsRate": 0.0, "viewsCount": 300, "conversionRate": 5.0 }, { "productId": "dp-12346", "nmId": 87654322, "vendorCode": "DG-12346", "name": "Годовая подписка на онлайн-курс 'Английский для начинающих'", "sales": 10, "revenue": 49000.00, "averagePrice": 4900.00, "returnsCount": 1, "returnsRate": 10.0, "viewsCount": 500, "conversionRate": 2.0 } ], "byDay": [ { "date": "2023-01-01", "sales": 0, "revenue": 0.00 }, { "date": "2023-01-02", "sales": 1, "revenue": 490.00 }, { "date": "2023-01-03", "sales": 2, "revenue": 980.00 } ], "byCategory": [ { "category": "Компьютерная литература", "sales": 15, "revenue": 7350.00 }, { "category": "Образование", "sales": 10, "revenue": 49000.00 } ], "dateFrom": "2023-01-01T00:00:00Z", "dateTo": "2023-01-31T23:59:59Z", "groupBy": "product" }, "error": null } ``` -------------------------------- ### Пример запроса получения обращения Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Общение с покупателями.md Example GET request to retrieve details of a specific customer appeal. ```http GET https://feedbacks-api.wildberries.ru/api/v1/appeals/appeal-12345 Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Mark Notification as Read Request Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example PUT request to mark a notification as read. ```http PUT https://suppliers-api.wildberries.ru/api/v1/digital/notifications/dnotif-12346/read Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Get Digital Orders List Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example request to retrieve a list of digital orders within a specified date range, with pagination. ```http GET https://suppliers-api.wildberries.ru/api/v1/digital/orders?dateFrom=2023-01-01&dateTo=2023-01-31&limit=10&offset=0 Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` -------------------------------- ### Create User Notification Request Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON payload for creating a user notification. ```json { "orderId": "dord-12345", "subject": "Важное обновление к вашей книге по Python", "message": "Мы выпустили обновление к книге с дополнительными главами и примерами кода. Вы можете скачать обновленную версию в личном кабинете.", "deliveryMethods": ["email", "app"], "priority": "high" } ``` -------------------------------- ### Update Digital Product Request Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON payload for updating an existing digital product, focusing on details like name, description, price, and metadata. ```json { "name": "Видеокурс 'Дизайн интерьера: от основ к мастерству'", "description": "Курс по дизайну интерьера с практическими заданиями, консультациями и индивидуальной обратной связью от преподавателя", "price": 4500.00, "discountedPrice": 3900.00, "tags": ["дизайн", "интерьер", "курсы", "обучение", "профессиональный уровень"], "metadata": { "lessons": 30, "accessDuration": 12, "accessDurationType": "months", "updateInfo": "Добавлены 5 дополнительных уроков и продлен срок доступа" } } ``` -------------------------------- ### Sales Reports Response Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response for the POST /digital/analytics/reports/sales endpoint, indicating the report is being processed. ```json { "data": { "reportId": "dg-rep-12345", "status": "processing", "downloadUrl": null, "createdAt": "2023-01-31T12:00:00Z", "message": "Отчет о продажах цифровых товаров поставлен в очередь на формирование" }, "error": null } ``` -------------------------------- ### Reply to Appeal Example Request Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Общение с покупателями.md Example JSON payload for replying to an appeal. ```json { "text": "Здравствуйте! Приносим извинения за доставленные неудобства. Мы готовы предоставить вам новую футболку или вернуть деньги за покупку. Что вы предпочитаете?", "attachments": [] } ``` -------------------------------- ### Response for revoking a license Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response after revoking a digital license. ```json { "data": { "license": { "id": "dlic-12346", "status": "revoked", "revokedAt": "2023-01-30T17:00:00Z", "revocationReason": "fraud_detected", "revocationComment": "Отзыв ключа из-за выявленного мошенничества", "message": "Лицензионный ключ успешно отозван" } }, "error": null } ``` -------------------------------- ### Sales Reports Request Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON request body for the POST /digital/analytics/reports/sales endpoint, specifying date range, grouping, and format. ```json { "dateFrom": "2023-01-01", "dateTo": "2023-01-31", "groupBy": ["product", "day", "category"], "format": "xlsx" } ``` -------------------------------- ### Publish Digital Product Response Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response after publishing a digital product. ```json { "data": { "product": { "id": "dp-12347", "nmId": 87654323, "status": "pending_approval", "message": "Цифровой продукт отправлен на публикацию. После проверки он будет опубликован на площадке." } }, "error": null } ``` -------------------------------- ### Financial Document Response Example Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Документы и бухгалтерия.md Example JSON response structure for financial documents, including file details, signing status, and related order information. ```json { "url": "https://suppliers-api.wildberries.ru/api/v1/supplier/finance/documents/files/file-12349.pdf", "size": 150000, "contentType": "application/pdf", "createdAt": "2023-01-20T15:00:00Z", "isSignRequired": true, "signStatus": "signed_by_both_parties", "signInfo": { "supplierSignDate": "2023-01-20T16:00:00Z", "wbSignDate": "2023-01-20T15:30:00Z" } } ], "details": { "penaltyReason": "Несоответствие предмета продажи описанию", "relatedOrderId": 222222222, "relatedItemId": 87654321, "itemName": "Футболка хлопковая с принтом", "paymentDate": "2023-01-20T17:00:00Z", "paymentMethod": "auto_deduction" }, "createdAt": "2023-01-20T15:00:00Z", "modifiedAt": "2023-01-20T17:00:00Z" } ], "pagination": { "total": 45, "limit": 100, "offset": 0, "hasMore": false }, "dateFrom": "2023-01-01T00:00:00Z", "dateTo": "2023-01-31T23:59:59Z" }, "error": null } ``` -------------------------------- ### Extend Subscription Response Source: https://github.com/artemkuzmin1992/wb-api-marketplace/blob/main/Wildberries Цифровой.md Example JSON response after successfully extending a digital subscription. ```json { "data": { "subscription": { "id": "dsub-12345", "status": "active", "oldEndDate": "2024-01-20T15:30:00Z", "newEndDate": "2024-07-20T15:30:00Z", "price": 2500.00, "extendedAt": "2023-01-30T22:00:00Z", "message": "Подписка успешно продлена на 6 месяцев" } }, "error": null } ```