Terms of cancellation

The method returns information about the possibility of cancellation.
Use this method to get information on the claim created via claims/create.

Request

POST

b2b.taxi.yandex.net/b2b/cargo/integration/v2/claims/cancel-info

Service URL

Query parameters

Name

Description

claim_id*

Type: string

Claim ID received at the claim creation stage

Min length: 32

Max length: 64

Headers

Name

Description

Accept-Language*

Type: string

Preferred response language. Examples: "en" — English

Example: en

Responses

200 OK

OK

Body

application/json
{
    "cancel_state": "free",
    "price": "12.50",
    "price_with_vat": "12.50",
    "currency": "string"
}

Name

Description

cancel_state*

Type: CancelInfoCancelState

Terms of cancellation

Example: free

Enum: free, paid, unavailable

currency

Type: string

Payment currency

price

Type: string

Delivery cost in Decimal(18, 4) format

Example: 12.50

Pattern: ^-?[0-9]{1,14}(\.[0-9]{0,4})?$

price_with_vat

Type: string

Delivery cost in Decimal(18, 4) format

Example: 12.50

Pattern: ^-?[0-9]{1,14}(\.[0-9]{0,4})?$

CancelInfoCancelState

Terms of cancellation

Type

Description

CancelInfoCancelState

Example: free

Enum: free, paid, unavailable

400 Bad Request

Bad request

Body

application/json
{
    "code": "bad_request",
    "message": "Incorrect request body"
}

Name

Description

code*

Type: string

Error code

Example: bad_request

Enum: bad_request

message*

Type: string

Error description

Example: Incorrect request body

404 Not Found

Claim not found

Body

application/json
{
    "code": "not_found",
    "message": "Claim not found"
}

Name

Description

code*

Type: string

Error code

Example: not_found

Enum: not_found

message*

Type: string

Error description

Example: Claim not found