Skip to main content

Создать задание на доставку

POST

https://secured-openapi.business.tinkoff.ru/api/v1/delivery/tasks

Метод создаёт задание и возвращает его ID в ответе для дальнейшего взаимодействия.

Чтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/delivery/tasks/createСоздание задания на доставку.

Ограничение на использование метода — 10 запросов в секунду

Авторизация

Security

Bearer API Token

Запрос

Header parameters

Idempotency-Key

String<uuid>

Ключ идемпотентности. Подробнее.

Request body schema application/json

Required

template

String

Шаблон, определяющий бизнес-логику задания.

commentForAgent

String

Комментарий к заданию для представителя.

parentTaskId

String

Идентификатор родительского задания.

meta

Object

Дополнительные метаданные в формате JSON.

property name*

String

contacts

Array of objects ()

Группа объектов с информацией о данных каждого участника задания, подлежащего удостоверению на встрече.

Required

id

String

Уникальный идентификатор контакта.

role

String

Роль.

firstName

String

Имя.

lastName

String

Фамилия.

middleName

String

Отчество.

birthDate

String<date>

Дата рождения.

phones

Array of objects ()

Телефон.

Required

type

String (PhoneType2)

Requirements: [MOBILE, HOME, WORK, OTHER]

Тип телефона

Required

number

String

Requirements: Value must match regular expression ^((\+7)([0-9]){10})$

Номер телефона в формате +7xxxxxxxxxx

documents

Array of objects ()

Документы, удостоверяющие личность. Для роли REALTOR параметр можно не передавать.

oneOf

Required

type

String (IdentificationDocumentType)

Requirements: [PASSPORT]

Тип документа

Required

number

String

Номер документа

Required

series

String

Серия документа

divisionName

String

Подразделение

issueDate

String<date>

Дата выдачи документа

Ответ

200

OK

400

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

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Loading...

openapi@tinkoff.ru

АО «Тинькофф Банк» использует файлы «cookie», с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.