Receiving information about orders for delivery, removal and disposal
The method is available for the FBY model.
If you are using an API Key token, one of the accesses in the list is required to call the method
- supplies-management:read-only — View FBY requests
- all-methods — Full account management
- all-methods:read-only — View all data
Returns requests for delivery, export, and disposal, as well as information on them, using the specified filters.
| ⚙️ Limit: 1,000 requests per hour |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/supply-requests
Path parameters
|
Name |
Description |
|
campaignId |
Type: integer The ID of the campaign (store) — The technical identifier that represents your store in the Yandex Market system when working through the API. It is uniquely linked to your store, but it is intended only for automated interaction. You can find it using a query GET v2/campaigns or find it in the seller's office on the Market. Click on your account icon → Settings and in the menu on the left, select APIs and modules:
⚠️ Do not confuse it with:
Min value: |
Query parameters
|
Name |
Description |
|
limit |
Type: integer The number of values per page. Min value: |
|
page_token |
Type: string ID of the results page. If the parameter is omitted, the first page is returned. We recommend transmitting the value of the output parameter If set Example: |
Body
application/json
{
"requestIds": [
1
],
"requestDateFrom": "2025-01-01T00:00:00Z",
"requestDateTo": "2025-01-01T00:00:00Z",
"requestTypes": [
"SUPPLY"
],
"requestSubtypes": [
"DEFAULT"
],
"requestStatuses": [
"CREATED"
],
"sorting": {
"direction": "ASC",
"attribute": "ID"
}
}
|
Name |
Description |
||||
|
requestDateFrom |
Type: string<date-time> | null The start date of the request filtering period. Example: |
||||
|
requestDateTo |
Type: string<date-time> | null The end date of the request filtering period. Example: |
||||
|
requestIds |
Type: integer[] | null Request IDs. Min items: Max items: Unique items: Example
|
||||
|
requestStatuses |
Type: string[] | null Request statuses for filtering. Min items: Unique items: Example
|
||||
|
requestSubtypes |
Type: string[] | null Subtypes of requests for filtering. Min items: Unique items: Example
|
||||
|
requestTypes |
Type: string[] | null Types of requests to filter. Min items: Unique items: Example
|
||||
|
sorting |
Type: object
Sorting parameters. Example
|
Responses
200 OK
A list of applications and information on them.
Body
application/json
{
"status": "OK",
"result": {
"requests": [
{
"id": {},
"type": "SUPPLY",
"subtype": "DEFAULT",
"status": "CREATED",
"updatedAt": "2025-01-01T00:00:00Z",
"counters": {},
"parentLink": {},
"childrenLinks": [
null
],
"targetLocation": {},
"transitLocation": {}
}
],
"paging": {
"nextPageToken": "example"
}
}
}
Type: object
All of 2 types
-
Type: object
status
Type: string
The type of response. Possible values:
OK— There are no errors.ERROR— an error occurred while processing the request.
Enum:
OK,ERRORThe standard wrapper for server responses.
Example
{ "status": "OK" } -
Type: object
result
Type: object
requests
Type: object[]
counters
Type: object
acceptableCount
Type: integer
The number of items that can be brought additionally.
Min value:
0actualBoxCount
Type: integer
The number of boxes that are accepted in the warehouse.
Min value:
0actualPalletsCount
Type: integer
The number of pallets that are accepted in the warehouse.
Min value:
0defectCount
Type: integer
The number of defective products.
Min value:
0factCount
Type: integer
The number of items that are accepted in the warehouse.
Min value:
0planCount
Type: integer
The number of items in the delivery request.
Min value:
0shortageCount
Type: integer
The number of defective products.
Min value:
0surplusCount
Type: integer
The number of extra items.
Min value:
0unacceptableCount
Type: integer
The number of items that cannot be delivered additionally.
Min value:
0undefinedCount
Type: integer
The number of rejected products.
Min value:
0The number of goods, boxes and pallets in the application.
Example
{ "planCount": 0, "factCount": 0, "undefinedCount": 0, "surplusCount": 0, "shortageCount": 0, "defectCount": 0, "acceptableCount": 0, "unacceptableCount": 0, "actualPalletsCount": 0, "actualBoxCount": 0 }id
Type: object
id
Type: integer
The application ID.
Used only in the API
It will not be possible to find applications in the seller's account on the Market. To do this, use
marketplaceRequestIdorwarehouseRequestId.Min value:
1marketplaceRequestId
Type: string
The application number on the marketplace.
It is also indicated in the seller's account on the Market.
Example:
examplewarehouseRequestId
Type: string
The order number in the warehouse.
It is also indicated in the seller's account on the Market.
Example:
exampleThe application ID and numbers.
Example
{ "id": 1, "marketplaceRequestId": "example", "warehouseRequestId": "example" }status
Type: string
Delivery request status:
CREATED— A draft application has been created.FINISHED— The application is completed, the goods are:- accepted at the warehouse;
- transferred to another warehouse during the transfer;
- transferred to the seller during export;
- disposed of.
CANCELLED— the application has been cancelled.INVALID— processing error.VALIDATED— the application is being processed.PUBLISHED— An application has been created.ARRIVED_TO_SERVICE— The delivery has arrived at the storage warehouse.ARRIVED_TO_XDOC_SERVICE— The delivery has arrived at the transit warehouse.SHIPPED_TO_SERVICE— The delivery was sent from the transit warehouse to the storage warehouse.CANCELLATION_REQUESTED— cancellation of the request has been requested.CANCELLATION_REJECTED— The application will not be cancelled.REGISTERED_IN_ELECTRONIC_QUEUE— the delivery is registered in the electronic queue.READY_FOR_UTILIZATION— the goods are ready for disposal.TRANSIT_MOVING— moving goods to the export warehouse.WAREHOUSE_HANDLING— secondary acceptance of goods or their assembly for export or disposal.ACCEPTED_BY_WAREHOUSE_SYSTEM— information about the application has been sent to the warehouse.READY_TO_WITHDRAW— the goods are ready for delivery.NEED_PREPARATION— information is expected from the seller.
Enum:
CREATED,FINISHED,CANCELLED,INVALID,VALIDATED,PUBLISHED,ARRIVED_TO_SERVICE,ARRIVED_TO_XDOC_SERVICE,SHIPPED_TO_SERVICE,CANCELLATION_REQUESTED,CANCELLATION_REJECTED,REGISTERED_IN_ELECTRONIC_QUEUE,READY_FOR_UTILIZATION,TRANSIT_MOVING,WAREHOUSE_HANDLING,ACCEPTED_BY_WAREHOUSE_SYSTEM,READY_TO_WITHDRAW,NEED_PREPARATIONsubtype
Type: string
Application subtype:
-
DEFAULT— delivery of goods to or from a storage warehouse. -
XDOC— delivery of goods through a transit warehouse or export from it. -
INVENTORYING_SUPPLY— inventory in the warehouse at the request of the store. -
INVENTORYING_SUPPLY_WAREHOUSE_BASED_PER_SUPPLIER— inventory in the warehouse at the request of the warehouse. -
MOVEMENT_SUPPLY— incoming movement between warehouses.When moving between warehouses, 2 orders are created —
MOVEMENT_SUPPLYandMOVEMENT_WITHDRAW. -
ADDITIONAL_SUPPLY— additional delivery of rejected goods. -
VIRTUAL_DISTRIBUTION_CENTER— parent request for delivery of goods to a storage warehouse or multi-delivery. -
VIRTUAL_DISTRIBUTION_CENTER_CHILD— a subsidiary request for the delivery of goods to a storage warehouse or multi-delivery.It doesn't come back for her
transitLocation. -
FORCE_PLAN— automatic disposal at the request of the warehouse. -
FORCE_PLAN_ANOMALY_PER_SUPPLY— disposal of rejected goods. -
PLAN_BY_SUPPLIER— disposal at the request of the store. -
ANOMALY_WITHDRAW— export of rejected goods. -
FIX_LOST_INVENTORYING— items that were not found after the second inventory. -
OPER_LOST_INVENTORYING— items that were not found after the first inventory. -
MOVEMENT_WITHDRAW— outbound movement between warehouses.When moving between warehouses, 2 orders are created —
MOVEMENT_SUPPLYandMOVEMENT_WITHDRAW. -
MISGRADING_SUPPLY— re-sorting for the better. -
MISGRADING_WITHDRAW— re-sorting in a smaller direction. -
MAN_UTIL— manual disposal at the request of the warehouse. -
WITHDRAW_AUTO_UTILIZATION— automatic disposal of goods in the export order when their storage period has expired.
Enum:
DEFAULT,XDOC,INVENTORYING_SUPPLY,INVENTORYING_SUPPLY_WAREHOUSE_BASED_PER_SUPPLIER,MOVEMENT_SUPPLY,ADDITIONAL_SUPPLY,VIRTUAL_DISTRIBUTION_CENTER,VIRTUAL_DISTRIBUTION_CENTER_CHILD,FORCE_PLAN,FORCE_PLAN_ANOMALY_PER_SUPPLY,PLAN_BY_SUPPLIER,ANOMALY_WITHDRAW,FIX_LOST_INVENTORYING,OPER_LOST_INVENTORYING,MOVEMENT_WITHDRAW,MISGRADING_SUPPLY,MISGRADING_WITHDRAW,MAN_UTIL,WITHDRAW_AUTO_UTILIZATIONtargetLocation
Type: object
address
Type: object
fullAddress
Type: string
The full address of the warehouse or PVZ.
Example:
examplegps
Type: object
latitude
Type: number
Width.
longitude
Type: number
Longitude.
GPS coordinates of latitude and longitude.
Example
{ "latitude": 0.5, "longitude": 0.5 }The address of the warehouse or PVZ.
Example
{ "fullAddress": "example", "gps": { "latitude": 0.5, "longitude": 0.5 } }name
Type: string
The name of the warehouse or PVZ.
Example:
exampleserviceId
Type: integer
ID of the warehouse or logistics partner of the PVZ.
type
Type: string
Type of warehouse or PVZ:
FULFILLMENT— storage warehouse.XDOC— transit warehouse.PICKUP_POINT— PVZ.
Enum:
FULFILLMENT,XDOC,PICKUP_POINTrequestedDate
Type: string<date-time>
Date and time of delivery to the warehouse or to the PVZ.
Example:
2025-01-01T00:00:00ZInformation about the warehouse or PVZ in the application.
Example
{ "requestedDate": "2025-01-01T00:00:00Z", "serviceId": 0, "name": "example", "address": { "fullAddress": "example", "gps": { "latitude": 0.5, "longitude": 0.5 } }, "type": "FULFILLMENT" }type
Type: string
Application type:
SUPPLY— delivery of goods.WITHDRAW— export of goods.UTILIZATION— disposal of goods.
Enum:
SUPPLY,WITHDRAW,UTILIZATIONupdatedAt
Type: string<date-time>
The date and time of the last application update.
Example:
2025-01-01T00:00:00ZchildrenLinks
Type: object[]
id
Type: object
id
Type: integer
The application ID.
Used only in the API
It will not be possible to find applications in the seller's account on the Market. To do this, use
marketplaceRequestIdorwarehouseRequestId.Min value:
1marketplaceRequestId
Type: string
The application number on the marketplace.
It is also indicated in the seller's account on the Market.
Example:
examplewarehouseRequestId
Type: string
The order number in the warehouse.
It is also indicated in the seller's account on the Market.
Example:
exampleThe application ID and numbers.
Example
{ "id": 1, "marketplaceRequestId": "example", "warehouseRequestId": "example" }type
Type: string
The type of connection between the two applications:
-
VIRTUAL_DISTRIBUTION— multi-delivery. -
WITHDRAW— export of rejected goods.Subtypes of the application:
DEFAULT,XDOC,VIRTUAL_DISTRIBUTION_CENTER_CHILDandANOMALY_WITHDRAW. -
UTILIZATION— disposal of rejected goods.Subtypes of the application:
DEFAULT,XDOC,VIRTUAL_DISTRIBUTION_CENTER_CHILDandFORCE_PLAN_ANOMALY_PER_SUPPLY. -
ADDITIONAL_SUPPLY— additional delivery.Subtypes of the application:
DEFAULT,XDOC,VIRTUAL_DISTRIBUTION_CENTER_CHILDandADDITIONAL_SUPPLY.
Enum:
VIRTUAL_DISTRIBUTION,WITHDRAW,UTILIZATION,ADDITIONAL_SUPPLYLinks to child applications.
Min items:
1Example
[ { "id": { "id": 1, "marketplaceRequestId": "example", "warehouseRequestId": "example" }, "type": "VIRTUAL_DISTRIBUTION" } ]parentLink
Type: object
id
Type: object
id
Type: integer
The application ID.
Used only in the API
It will not be possible to find applications in the seller's account on the Market. To do this, use
marketplaceRequestIdorwarehouseRequestId.Min value:
1marketplaceRequestId
Type: string
The application number on the marketplace.
It is also indicated in the seller's account on the Market.
Example:
examplewarehouseRequestId
Type: string
The order number in the warehouse.
It is also indicated in the seller's account on the Market.
Example:
exampleThe application ID and numbers.
Example
{ "id": 1, "marketplaceRequestId": "example", "warehouseRequestId": "example" }type
Type: string
The type of connection between the two applications:
-
VIRTUAL_DISTRIBUTION— multi-delivery. -
WITHDRAW— export of rejected goods.Subtypes of the application:
DEFAULT,XDOC,VIRTUAL_DISTRIBUTION_CENTER_CHILDandANOMALY_WITHDRAW. -
UTILIZATION— disposal of rejected goods.Subtypes of the application:
DEFAULT,XDOC,VIRTUAL_DISTRIBUTION_CENTER_CHILDandFORCE_PLAN_ANOMALY_PER_SUPPLY. -
ADDITIONAL_SUPPLY— additional delivery.Subtypes of the application:
DEFAULT,XDOC,VIRTUAL_DISTRIBUTION_CENTER_CHILDandADDITIONAL_SUPPLY.
Enum:
VIRTUAL_DISTRIBUTION,WITHDRAW,UTILIZATION,ADDITIONAL_SUPPLYInformation about related applications.
Example
{ "id": { "id": 1, "marketplaceRequestId": "example", "warehouseRequestId": "example" }, "type": "VIRTUAL_DISTRIBUTION" }transitLocation
Type: object
address
Type: object
fullAddress
Type: string
The full address of the warehouse or PVZ.
Example:
examplegps
Type: object
latitude
Type: number
Width.
longitude
Type: number
Longitude.
GPS coordinates of latitude and longitude.
Example
{ "latitude": 0.5, "longitude": 0.5 }The address of the warehouse or PVZ.
Example
{ "fullAddress": "example", "gps": { "latitude": 0.5, "longitude": 0.5 } }name
Type: string
The name of the warehouse or PVZ.
Example:
exampleserviceId
Type: integer
ID of the warehouse or logistics partner of the PVZ.
type
Type: string
Type of warehouse or PVZ:
FULFILLMENT— storage warehouse.XDOC— transit warehouse.PICKUP_POINT— PVZ.
Enum:
FULFILLMENT,XDOC,PICKUP_POINTrequestedDate
Type: string<date-time>
Date and time of delivery to the warehouse or to the PVZ.
Example:
2025-01-01T00:00:00ZInformation about the warehouse or PVZ in the application.
Example
{ "requestedDate": "2025-01-01T00:00:00Z", "serviceId": 0, "name": "example", "address": { "fullAddress": "example", "gps": { "latitude": 0.5, "longitude": 0.5 } }, "type": "FULFILLMENT" }The list of applications.
Min items:
0Max items:
100Example
[ { "id": { "id": 1, "marketplaceRequestId": "example", "warehouseRequestId": "example" }, "type": "SUPPLY", "subtype": "DEFAULT", "status": "CREATED", "updatedAt": "2025-01-01T00:00:00Z", "counters": { "planCount": 0, "factCount": 0, "undefinedCount": 0, "surplusCount": 0, "shortageCount": 0, "defectCount": 0, "acceptableCount": 0, "unacceptableCount": 0, "actualPalletsCount": 0, "actualBoxCount": 0 }, "parentLink": { "id": { "id": 1, "marketplaceRequestId": "example", "warehouseRequestId": "example" }, "type": "VIRTUAL_DISTRIBUTION" }, "childrenLinks": [ { "id": { "id": 1, "marketplaceRequestId": "example", "warehouseRequestId": "example" }, "type": "VIRTUAL_DISTRIBUTION" } ], "targetLocation": { "requestedDate": "2025-01-01T00:00:00Z", "serviceId": 0, "name": "example", "address": { "fullAddress": "example", "gps": { "latitude": 0.5, "longitude": 0.5 } }, "type": "FULFILLMENT" }, "transitLocation": { "requestedDate": "2025-01-01T00:00:00Z", "serviceId": 0, "name": "example", "address": { "fullAddress": "example", "gps": { "latitude": 0.5, "longitude": 0.5 } }, "type": "FULFILLMENT" } } ]paging
Type: object
nextPageToken
Type: string
ID of the next results page.
Example:
exampleThe ID of the next page.
Example
{ "nextPageToken": "example" }A list of applications and information on them.
Example
{ "requests": [ { "id": { "id": 1, "marketplaceRequestId": "example", "warehouseRequestId": "example" }, "type": "SUPPLY", "subtype": "DEFAULT", "status": "CREATED", "updatedAt": "2025-01-01T00:00:00Z", "counters": { "planCount": 0, "factCount": 0, "undefinedCount": 0, "surplusCount": 0, "shortageCount": 0, "defectCount": 0, "acceptableCount": 0, "unacceptableCount": 0, "actualPalletsCount": 0, "actualBoxCount": 0 }, "parentLink": { "id": { "id": 1, "marketplaceRequestId": "example", "warehouseRequestId": "example" }, "type": "VIRTUAL_DISTRIBUTION" }, "childrenLinks": [ { "id": {}, "type": "VIRTUAL_DISTRIBUTION" } ], "targetLocation": { "requestedDate": "2025-01-01T00:00:00Z", "serviceId": 0, "name": "example", "address": { "fullAddress": "example", "gps": {} }, "type": "FULFILLMENT" }, "transitLocation": { "requestedDate": "2025-01-01T00:00:00Z", "serviceId": 0, "name": "example", "address": { "fullAddress": "example", "gps": {} }, "type": "FULFILLMENT" } } ], "paging": { "nextPageToken": "example" } }Example
{ "result": { "requests": [ { "id": { "id": 1, "marketplaceRequestId": "example", "warehouseRequestId": "example" }, "type": "SUPPLY", "subtype": "DEFAULT", "status": "CREATED", "updatedAt": "2025-01-01T00:00:00Z", "counters": { "planCount": 0, "factCount": 0, "undefinedCount": 0, "surplusCount": 0, "shortageCount": 0, "defectCount": 0, "acceptableCount": 0, "unacceptableCount": 0, "actualPalletsCount": 0, "actualBoxCount": 0 }, "parentLink": { "id": {}, "type": "VIRTUAL_DISTRIBUTION" }, "childrenLinks": [ {} ], "targetLocation": { "requestedDate": "2025-01-01T00:00:00Z", "serviceId": 0, "name": "example", "address": {}, "type": "FULFILLMENT" }, "transitLocation": { "requestedDate": "2025-01-01T00:00:00Z", "serviceId": 0, "name": "example", "address": {}, "type": "FULFILLMENT" } } ], "paging": { "nextPageToken": "example" } } }
400 Bad Request
The request contains incorrect data. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
The type of response. Possible values:
OK— There are no errors.ERROR— an error occurred while processing the request.
Enum:
OK,ERRORThe standard wrapper for server responses.
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
The error code.
Example:
examplemessage
Type: string
Description of the error.
Example:
exampleA list of errors.
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
A standard wrapper for server errors.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
401 Unauthorized
The authorization data is not specified in the request. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
The type of response. Possible values:
OK— There are no errors.ERROR— an error occurred while processing the request.
Enum:
OK,ERRORThe standard wrapper for server responses.
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
The error code.
Example:
examplemessage
Type: string
Description of the error.
Example:
exampleA list of errors.
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
A standard wrapper for server errors.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
403 Forbidden
The authorization data is incorrect or access to the resource is prohibited. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
The type of response. Possible values:
OK— There are no errors.ERROR— an error occurred while processing the request.
Enum:
OK,ERRORThe standard wrapper for server responses.
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
The error code.
Example:
examplemessage
Type: string
Description of the error.
Example:
exampleA list of errors.
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
A standard wrapper for server errors.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
420 Method Failure
The resource access limit has been exceeded. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
The type of response. Possible values:
OK— There are no errors.ERROR— an error occurred while processing the request.
Enum:
OK,ERRORThe standard wrapper for server responses.
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
The error code.
Example:
examplemessage
Type: string
Description of the error.
Example:
exampleA list of errors.
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
A standard wrapper for server errors.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
500 Internal Server Error
Internal error of Yandex. Market. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
The type of response. Possible values:
OK— There are no errors.ERROR— an error occurred while processing the request.
Enum:
OK,ERRORThe standard wrapper for server responses.
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
The error code.
Example:
examplemessage
Type: string
Description of the error.
Example:
exampleA list of errors.
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
A standard wrapper for server errors.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
No longer supported, please use an alternative and newer version.
Read about what it is in Yandex.Market Help for sellers.