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/campaigns/{campaignId}/supply-requests
Path parameters
Name |
Description |
campaignId* |
Type: integer<int64> The campaign ID. You can find it using a query GET campaigns or find it in the seller's office on the Market — click on the name of your business and go to the page:
Do not send the store ID instead, which is indicated in the seller's account on the Market next to the store name and in some reports.
Min value: |
Query parameters
Name |
Description |
limit |
Type: integer<int32> The number of values per page.
|
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 |
Body
application/json
{
"requestIds": [
0
],
"requestDateFrom": "2022-12-29T18:02:01Z",
"requestDateTo": "2022-12-29T18:02:01Z",
"requestTypes": [
"SUPPLY"
],
"requestSubtypes": [
"DEFAULT"
],
"requestStatuses": [
"CREATED"
],
"sorting": {
"direction": "ASC",
"attribute": "ID"
}
}
Name |
Description |
requestDateFrom |
Type: string<date-time> The start date of the request filtering period. |
requestDateTo |
Type: string<date-time> The end date of the request filtering period. |
requestIds |
Type: integer<int64>[] Request IDs. 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 Min value: Min items: Max items: Unique items |
requestStatuses |
Type: SupplyRequestStatusType[] Request statuses for filtering.
Enum: Min items: Unique items |
requestSubtypes |
Type: SupplyRequestSubType[] Subtypes of requests for filtering.
Enum: Min items: Unique items |
requestTypes |
Type: SupplyRequestType[] Types of requests to filter.
Enum: Min items: Unique items |
sorting |
Type: SupplyRequestSortingDTO Sorting parameters. |
SupplyRequestStatusType
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 application 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.
Type |
Description |
Enum: |
SupplyRequestSubType
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_SUPPLY
andMOVEMENT_WITHDRAW
. -
ADDITIONAL_SUPPLY
— additional delivery of rejected goods. -
VIRTUAL_DISTRIBUTION_CENTER
— the parent application for the delivery of goods to the storage warehouse or multi-delivery. -
VIRTUAL_DISTRIBUTION_CENTER_CHILD
— a subsidiary application 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_SUPPLY
andMOVEMENT_WITHDRAW
. -
MISGRADING_SUPPLY
— re-grading for the better. -
MISGRADING_WITHDRAW
— re-grading in a smaller direction. -
MAN_UTIL
— manual disposal at the request of the warehouse.
Type |
Description |
Enum: |
SupplyRequestType
Application type:
SUPPLY
— delivery of goods.WITHDRAW
— export of goods.UTILIZATION
— disposal of goods.
Type |
Description |
Enum: |
SupplyRequestSortingDTO
Sorting parameters.
Name |
Description |
attribute* |
Type: SupplyRequestSortAttributeType Which parameter to sort applications by:
Enum: |
direction* |
Type: SortOrderType Sorting direction:
Enum: |
SupplyRequestSortAttributeType
Which parameter to sort applications by:
-
ID
— application ID. -
REQUESTED_DATE
— date of delivery to the storage warehouse.If the goods passed through a transit warehouse, it sorts them by delivery dates to both warehouses.
-
UPDATED_AT
— application update time. -
STATUS
— application status.
Type |
Description |
Enum: |
SortOrderType
Sorting direction:
ASC
— sort in ascending order.DESC
— sort in descending order.
Type |
Description |
Enum: |
Responses
200 OK
A list of applications and information on them.
Body
application/json
{
"status": "OK",
"result": {
"requests": [
{
"id": {
"id": 0,
"marketplaceRequestId": "string",
"warehouseRequestId": "string"
},
"type": "SUPPLY",
"subtype": "DEFAULT",
"status": "CREATED",
"updatedAt": "2022-12-29T18:02:01Z",
"counters": {
"planCount": 0,
"factCount": 0,
"undefinedCount": 0,
"surplusCount": 0,
"shortageCount": 0,
"defectCount": 0,
"acceptableCount": 0,
"unacceptableCount": 0,
"actualPalletsCount": 0,
"actualBoxCount": 0
},
"parentLink": {
"id": {
"id": 0,
"marketplaceRequestId": "string",
"warehouseRequestId": "string"
},
"type": "VIRTUAL_DISTRIBUTION"
},
"childrenLinks": [
{
"id": {
"id": 0,
"marketplaceRequestId": "string",
"warehouseRequestId": "string"
},
"type": "VIRTUAL_DISTRIBUTION"
}
],
"targetLocation": {
"requestedDate": "2022-12-29T18:02:01Z",
"serviceId": 0,
"name": "string",
"address": {
"fullAddress": "string",
"gps": {
"latitude": 0,
"longitude": 0
}
},
"type": "FULFILLMENT"
},
"transitLocation": {
"requestedDate": "2022-12-29T18:02:01Z",
"serviceId": 0,
"name": "string",
"address": {
"fullAddress": "string",
"gps": {
"latitude": 0,
"longitude": 0
}
},
"type": "FULFILLMENT"
}
}
],
"paging": {
"nextPageToken": "string"
}
}
}
Name |
Description |
result |
Type: GetSupplyRequestsDTO A list of applications and information on them. |
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
GetSupplyRequestsDTO
A list of applications and information on them.
Name |
Description |
requests* |
Type: SupplyRequestDTO[] The list of applications. Min items: Max items: |
paging |
Type: ForwardScrollingPagerDTO The ID of the next page. |
ApiResponseStatusType
The type of response. Possible values:
OK
— there are no mistakes.ERROR
— an error occurred while processing the request.
Type |
Description |
Enum: |
SupplyRequestDTO
Information about the request for delivery, removal or disposal.
Name |
Description |
counters* |
Type: SupplyRequestCountersDTO The number of goods, boxes and pallets in the application. |
id* |
Type: SupplyRequestIdDTO The application ID and numbers. |
status* |
Type: SupplyRequestStatusType Delivery request status:
Enum: |
subtype* |
Type: SupplyRequestSubType Application subtype:
Enum: |
targetLocation* |
Type: SupplyRequestLocationDTO Information about the storage warehouse or PVZ. |
type* |
Type: SupplyRequestType Application type:
Enum: |
updatedAt* |
Type: string<date-time> The date and time of the last application update. |
childrenLinks |
Type: SupplyRequestReferenceDTO[] Links to child applications. Min items: |
parentLink |
Type: SupplyRequestReferenceDTO Link to the parent application. |
transitLocation |
Type: SupplyRequestLocationDTO Information about the transit warehouse or PVZ. |
ForwardScrollingPagerDTO
The ID of the next page.
Name |
Description |
nextPageToken |
Type: string ID of the next results page. |
SupplyRequestCountersDTO
The number of goods, boxes and pallets in the application.
Name |
Description |
acceptableCount |
Type: integer<int32> The number of items that can be brought additionally. Min value: |
actualBoxCount |
Type: integer<int32> The number of boxes that are accepted in the warehouse. Min value: |
actualPalletsCount |
Type: integer<int32> The number of pallets that are accepted in the warehouse. Min value: |
defectCount |
Type: integer<int32> The number of defective products. Min value: |
factCount |
Type: integer<int32> The number of items that are accepted in the warehouse. Min value: |
planCount |
Type: integer<int32> The number of items in the delivery request. Min value: |
shortageCount |
Type: integer<int32> The number of defective products. Min value: |
surplusCount |
Type: integer<int32> The number of extra items. Min value: |
unacceptableCount |
Type: integer<int32> The number of items that cannot be delivered additionally. Min value: |
undefinedCount |
Type: integer<int32> The number of rejected products. Min value: |
SupplyRequestIdDTO
The application ID and numbers.
Name |
Description |
id* |
Type: integer<int64> 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 Min value: |
marketplaceRequestId |
Type: string The application number on the marketplace. It is also indicated in the seller's account on the Market. |
warehouseRequestId |
Type: string The order number in the warehouse. It is also indicated in the seller's account on the Market. |
SupplyRequestLocationDTO
Information about the warehouse or PVZ in the application.
Name |
Description |
address* |
Type: SupplyRequestLocationAddressDTO The address of the warehouse or PVZ. |
name* |
Type: string The name of the warehouse or PVZ. |
serviceId* |
Type: integer<int64> ID of the warehouse or logistics partner of the PVZ. |
type* |
Type: SupplyRequestLocationType Type of warehouse or PVZ:
Enum: |
requestedDate |
Type: string<date-time> Date and time of delivery to the warehouse or to the PVZ. |
SupplyRequestReferenceDTO
Information about related applications.
Name |
Description |
id* |
Type: SupplyRequestIdDTO IDs of the related application. |
type* |
Type: SupplyRequestReferenceType The type of connection. Enum: |
SupplyRequestLocationAddressDTO
The address of the warehouse or PVZ.
Name |
Description |
fullAddress* |
Type: string The full address of the warehouse or PVZ. |
gps* |
Type: GpsDTO GPS coordinates of latitude and longitude. |
SupplyRequestLocationType
Type of warehouse or PVZ:
FULFILLMENT
— storage warehouse.XDOC
— transit warehouse.PICKUP_POINT
— PVZ.
Type |
Description |
Enum: |
SupplyRequestReferenceType
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_CHILD
andANOMALY_WITHDRAW
. -
UTILIZATION
— disposal of rejected goods.Subtypes of the application:
DEFAULT
,XDOC
,VIRTUAL_DISTRIBUTION_CENTER_CHILD
andFORCE_PLAN_ANOMALY_PER_SUPPLY
. -
ADDITIONAL_SUPPLY
— additional delivery.Subtypes of the application:
DEFAULT
,XDOC
,VIRTUAL_DISTRIBUTION_CENTER_CHILD
andADDITIONAL_SUPPLY
.
Type |
Description |
Enum: |
GpsDTO
GPS coordinates of latitude and longitude.
Name |
Description |
latitude* |
Type: number<decimal> Width. |
longitude* |
Type: number<decimal> Longitude. |
400 Bad Request
The request contains incorrect data. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
ApiErrorDTO
The general error format.
Name |
Description |
code* |
Type: string The error code. |
message |
Type: string Description of the error. |
401 Unauthorized
The authorization data is not specified in the request. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
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": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
420 Method Failure
The resource access limit has been exceeded. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
500 Internal Server Error
Internal error of Yandex. Market. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
No longer supported, please use an alternative and newer version.
Read about what it is in Yandex.Market Help for sellers.