Создание транзакции на балансе водителя (курьера)

Request

POST

https://fleet-api.taxi.yandex.net/v2/parks/driver-profiles/transactions

Headers

Name	Description
X-API-Key	Type: string API-ключ Min length: `1` Example: `<API-ключ>`
X-Client-ID	Type: string Идентификатор клиента Min length: `1` Example: `<Идентификатор клиента>`
X-Idempotency-Token	Type: string Токен идемпотентности запроса. Должен состоять только из печатных ASCII символов Min length: `16` Max length: `64` Example: `c56fa6537e5a4adbbce6ef3593210fb9`

Body

application/json

{
  "park_id": "ee6f33c4562b4e1f8646d157bd70b2c4",
  "driver_profile_id": "33de650c6a1a40bfa78dd981817da866",
  "category_id": "partner_service_manual_3",
  "amount": "12345.1434",
  "description": "Списание №13"
}

Name	Description
amount	Type: Amount Сумма с фиксированной точностью Max length: `20` Example: `12345.1434`
category_id	Type: string Категория создаваемой транзакции. Разрешены категории с `is_creatable` равным `true` в списке категорий транзакций Example: `partner_service_manual_3`
description	Type: Description Example: `Списание №13`
driver_profile_id	Type: DriverProfileId Идентификатор водителя Min length: `1` Max length: `100` Example: `33de650c6a1a40bfa78dd981817da866`
park_id	Type: ParkId Идентификатор партнёра Min length: `1` Max length: `100` Example: `ee6f33c4562b4e1f8646d157bd70b2c4`

ParkId

Идентификатор партнёра

Type: string

Min length: 1

Max length: 100

Example: ee6f33c4562b4e1f8646d157bd70b2c4

DriverProfileId

Идентификатор водителя

Type: string

Min length: 1

Max length: 100

Example: 33de650c6a1a40bfa78dd981817da866

Amount

Сумма с фиксированной точностью

Type: string

Max length: 20

Example: 12345.1434

Description

Type: string

Example: Списание №13

Responses

200 OK

Транзакция создана успешно

Body

application/json

{
  "event_at": "2019-08-08T11:58:01+03:00",
  "park_id": "ee6f33c4562b4e1f8646d157bd70b2c4",
  "driver_profile_id": "33de650c6a1a40bfa78dd981817da866",
  "category_id": "partner_service_manual",
  "amount": "12345.1434",
  "currency_code": "RUB",
  "description": "Списание №13",
  "created_by": {
    "identity": "dispatcher",
    "passport_uid": "123456789",
    "dispatcher_id": "3621b3429ea04d989adf5ff4d5515d6a",
    "dispatcher_name": "Вася Пупкин"
  }
}

Name	Description
amount	Type: Amount Сумма с фиксированной точностью Max length: `20` Example: `12345.1434`
category_id	Type: TransactionCategoryId Категория транзакции. Допустимые значения можно получить через API /v2/parks/transactions/categories/list. Min length: `1` Max length: `100` Example: `partner_service_manual`
created_by	Type: TransactionCreatedBy Example `{ "identity": "dispatcher", "passport_uid": "123456789", "dispatcher_id": "3621b3429ea04d989adf5ff4d5515d6a", "dispatcher_name": "Вася Пупкин" }`
currency_code	Type: CurrencyCode Example: `RUB`
description	Type: Description Example: `Списание №13`
driver_profile_id	Type: DriverProfileId Идентификатор водителя Min length: `1` Max length: `100` Example: `33de650c6a1a40bfa78dd981817da866`
event_at	Type: DateTime ISO 8601 с временной зоной Example: `2019-08-08T11:58:01+03:00`
park_id	Type: ParkId Идентификатор партнёра Min length: `1` Max length: `100` Example: `ee6f33c4562b4e1f8646d157bd70b2c4`

DateTime

ISO 8601 с временной зоной

Type: string<date-time>

Example: 2019-08-08T11:58:01+03:00

TransactionCategoryId

Категория транзакции. Допустимые значения можно получить через API /v2/parks/transactions/categories/list.

Type: string

Min length: 1

Max length: 100

Example: partner_service_manual

CurrencyCode

Type: string

Example: RUB

PassportUID

Паспортный идентификатор пользователя

Type: string

Example: 123456789

DispatcherID

Идентификатор диспетчера

Type: string

Example: 3621b3429ea04d989adf5ff4d5515d6a

DispatcherName

Имя диспетчера

Type: string

Example: Вася Пупкин

TransactionCreatedByDispatcher

Name	Description
dispatcher_id	Type: DispatcherID Идентификатор диспетчера Example: `3621b3429ea04d989adf5ff4d5515d6a`
dispatcher_name	Type: DispatcherName Имя диспетчера Example: `Вася Пупкин`
identity	Type: string Const: `dispatcher` Example: `dispatcher`
passport_uid	Type: PassportUID Паспортный идентификатор пользователя Example: `123456789`

Example

{
  "identity": "dispatcher",
  "passport_uid": "123456789",
  "dispatcher_id": "3621b3429ea04d989adf5ff4d5515d6a",
  "dispatcher_name": "Вася Пупкин"
}

TransactionCreatedByTechSupport

Name

Description

identity

Type: string

Const: tech-support

Example: tech-support

Example

{
  "identity": "tech-support"
}

FleetAPIClientID

fleet-api client id

Type: string

Example: taxi/park/abc123

FleetAPIKeyID

fleet-api api key id

Type: string

Example: 521

TransactionCreatedByFleetAPI

Name	Description
client_id	Type: FleetAPIClientID fleet-api client id Example: `taxi/park/abc123`
identity	Type: string Const: `fleet-api` Example: `fleet-api`
key_id	Type: FleetAPIKeyID fleet-api api key id Example: `521`

Example

{
  "identity": "fleet-api",
  "client_id": "taxi/park/abc123",
  "key_id": "521"
}

TransactionCreatedByPlatform

Name

Description

identity

Type: string

Const: platform

Example: platform

Example

{
  "identity": "platform"
}

TransactionCreatedBy

One of 4 types

Type: TransactionCreatedByDispatcher

Example

{
  "identity": "dispatcher",
  "passport_uid": "123456789",
  "dispatcher_id": "3621b3429ea04d989adf5ff4d5515d6a",
  "dispatcher_name": "Вася Пупкин"
}

Type: TransactionCreatedByTechSupport
Example
```
{
  "identity": "tech-support"
}
```

Type: TransactionCreatedByFleetAPI

Example

{
  "identity": "fleet-api",
  "client_id": "taxi/park/abc123",
  "key_id": "521"
}

Type: TransactionCreatedByPlatform
Example
```
{
  "identity": "platform"
}
```

Example

{
  "identity": "dispatcher",
  "passport_uid": "123456789",
  "dispatcher_id": "3621b3429ea04d989adf5ff4d5515d6a",
  "dispatcher_name": "Вася Пупкин"
}

400 Bad Request

Некорректные параметры запроса

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

401 Unauthorized

Отсутствуют параметры авторизации запроса

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

403 Forbidden

Недостаточно прав для выполнения запроса

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

429 Too Many Requests

Превышено допустимое число запросов

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

500 Internal Server Error

Внутренняя ошибка сервера

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

Была ли статья полезна?

Получение трека по заказу

Получение списка транзакций по водителю (курьеру)