Receipt of the acceptance certificate

The method is available for the FBS model.

If you are using an API Key token, one of the accesses in the list is required to call the method

Express delivery

If your store is connected to express delivery and you ship orders to Yandex Go couriers, you do not need to prepare an acceptance certificate.

The request generates an act of acceptance and transfer of orders included in the shipment, and returns the act in PDF format. The report contains orders that have been collected and are ready for shipment.

When forming an act, the Market automatically finds and inserts the following data into the template:

The data from which the Market generates the report

Data in the report

Description

Date

The date of the request.

Sender

The name of your legal entity indicated in the merchant's account on the Market.

Executor

The name of the legal entity of the sorting center or delivery service.

Shipment number in the customer's system

The field is no longer in use

Your order ID, which you provided in the response to the request POST order/accept from the Market.

Shipment number in the contractor's (subcontractor's) system

The ID of the order on the Market, as in the request output GET campaigns/{campaignId}/orders.

Declared value

The total amount of the order excluding the shipping cost, as shown in the request output GET campaigns/{campaignId}/orders or GET campaigns/{campaignId}/orders/{orderId}.

Weight

The gross weight of the cargo area (the total weight of the package and contents), as in the request output GET campaigns/{campaignId}/orders or GET campaigns/{campaignId}/orders/{orderId}.

Number of seats

The number of cargo spaces in the order, as shown in the request output GET campaigns/{campaignId}/orders or GET campaigns/{campaignId}/orders/{orderId}.

In the printed statement, specify the sender and the contractor. They must sign the act and indicate their last name and initials next to the signature. If necessary, also fill in the details of the power of attorney.

, Limit: 100 requests per hour

Request

GET

https://api.partner.market.yandex.ru/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/act

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:

  • Modules and APIs → block Sending data to Yandex.Market.
  • Query log → drop-down list in the block Show logs.

, 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: 1

shipmentId*

Type: integer<int64>

Shipment ID.

Min value: 1

Responses

200 OK

Acceptance and transfer certificate for shipment in PDF format.

Body

application/pdf

Type: string

Format: binary

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.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

ApiErrorDTO

The general error format.

Name

Description

code*

Type: string

The error code.

message

Type: string

Description of the error.

ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Type

Description

ApiResponseStatusType

Enum: OK, 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.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

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.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

404 Not Found

The requested resource was not found. More information about the error

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

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.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

500 Internal Server Error

Internal error of the 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.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

No longer supported, please use an alternative and newer version.