Редактирование заявки после подтверждения

changes

Type: ChangeRequest[]

Набор изменений в заявке (применится весь набор или ничего).

Min items: 1

[
  {
    "kind": "change_items",
    "pickup_point_id": 1,
    "dropoff_point_id": 2,
    "items": [
      {
        "extra_id": "БП-208",
        "pickup_point": 1,
        "dropoff_point": 2,
        "droppof_point": 0,
        "title": "Плюмбус",
        "size": {},
        "weight": 2,
        "cost_value": "2.00",
        "cost_currency": "RUB",
        "quantity": 1,
        "fiscalization": {},
        "age_restricted": false
      }
    ]
  }
]

last_known_revision

Type: string

Последняя известная клиенту версия заявки (version, полученная из claims/info)

Example: example

height

Type: number

Высота в метрах

Min value: 0

Max value: 500

length

Type: number

Длина в метрах

Min value: 0

Max value: 500

width

Type: number

Ширина в метрах

Min value: 0

Max value: 500

code

Type: string

Код маркировки товара в соответствии с форматом kind

Example: 444D00000000003741

kind

Type: string

Тип маркировки.
Возможные значения:

1. compiled - уже разобранная марка с выделенным GTIN и Serial.
   Пример:
   - 444D00000000003741
2. gs1_data_matrix_base64 - код товара в формате GS1 Data Matrix,
   подлежащий маркировке средствами идентификации.
   Максимум 200 символов.
   Код товара необходимо передавать целиком,
   закодировав строку в формат base64.

Example: gs1_data_matrix_base64

article

Type: ItemArticle

Артикул товара.
Должен быть уникальным для товаров, передаваемых из одной точки.

Example: 20ML50OWKY4FC86

excise

Type: Money

Сумма акциза

Стоимость доставки в формате десятичной дроби Decimal(18, 4)

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

Example: 12.50

item_type

Type: ItemType

Тип наименования: товар или услуга.
Значение по умолчанию: product

Enum: product, service

mark

Type: ItemMark

Уникальный код товара (КИЗ). Актуален для РФ.
Если товары имеют уникальный код, то на каждый товар необходимо создать отдельный блок

{
  "kind": "gs1_data_matrix_base64",
  "code": "444D00000000003741"
}

supplier_inn

Type: SupplierInn

ИНН поставщика (10 или 12 цифр).

Pattern: ^[A-Z0-9\\-]+$

Example: 3664069397

vat_code_str

Type: VatCodeStrApi

Ставка НДС. Возможные значения:
vat_none - без НДС;
vat0 - нулевая ставка НДС (применяется в редких случаях);
vat10 - ставка НДС 10%;
vat20 - ставка НДС 20%.

Example: vat_none

cost_currency

Type: Currency

Трехзначный код валюты, в которой ведется расчет

Min length: 3

Max length: 3

Example: RUB

cost_value

Type: string

Цена за единицу товара в валюте cost_currency.
Для страхования стоимости передайте фактическую цену груза

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

Example: 2.00

dropoff_point

Type: integer

Идентификатор точки (int64), куда нужно доставить
товар. Отличается от идентификатора в заявке.

Может быть любым числом. Должен соответствовать значению route_points[].point_id
у точки назначения

pickup_point

Type: integer

Идентификатор точки (int64), откуда нужно забрать
товар. Отличается от идентификатора в заявке.

Может быть любым числом. Должен соответствовать значению route_points[].point_id
у точки отправки

quantity

Type: integer

Количество товара в единицах (int64)

Min value: 1

title

Type: string

Наименование единицы товара

Example: Плюмбус

age_restricted

Type: boolean

Нужно ли проверить возраст клиента при выдаче товара

Default: false

droppof_point

Type: integer

deprecated, use dropoff_point

extra_id

Type: string

Краткий уникальный идентификатор товара (номер заказа в рамках заявки, как правило идентичен external_order_id)

Example: БП-208

fiscalization

Type: ItemFiscalization

Информация по фискализации (актуально для оплаты при получении)

{
  "excise": "12.50",
  "vat_code_str": "vat_none",
  "supplier_inn": "3664069397",
  "article": "20ML50OWKY4FC86",
  "mark": {
    "kind": "gs1_data_matrix_base64",
    "code": "444D00000000003741"
  },
  "item_type": "product"
}

size

Type: CargoItemSizes

Габариты товара в метрах. В полях следует передавать актуальные значения.

Если габариты не были переданы, заказ оформляется с учетом
максимально допустимых габаритов для выбранного тарифа.

Если фактические характеристики товара превысят допустимые,
курьер вправе отказаться от выполнения такого заказа на месте.
В этом случае будет удержана стоимость подачи.

Курьер (courier): до 0.80 м × 0.50 м × 0.50 м
Экспресс (express): до 1.00 м × 0.60 м × 0.50 м
Грузовой (cargo):

• Маленький кузов: до 1.70 м × 0.96 м × 0.90 м
• Средний кузов: до 2.60 м × 1.30 м × 1.50 м
• Большой кузов: до 3.80 м × 1.80 м × 1.80 м

{
  "length": 0.1,
  "width": 0.2,
  "height": 0.3
}

weight

Type: number

Вес единицы товара в кг. В поле следует передавать актуальные значения.

Если вес не был передан, заказ оформляется с учетом
максимально допустимых габаритов для выбранного тарифа.

Если фактические характеристики отправления превысят допустимые,
курьер вправе отказаться от выполнения такого заказа на месте.
В этом случае будет удержана стоимость подачи.

Курьер (courier): до 10 кг
Экспресс (express): до 20 кг
Грузовой (cargo):

• Маленький кузов: до 300 кг
• Средний кузов: до 700 кг
• Большой кузов: до 1400 кг

dropoff_point_id

Type: integer

ID точки назначения, в которой меняем список товаров (int64)

items

Type: V2CargoItem[]

Новый список товаров для данной комбинации точек

Min items: 1

[
  {
    "extra_id": "БП-208",
    "pickup_point": 1,
    "dropoff_point": 2,
    "droppof_point": 0,
    "title": "Плюмбус",
    "size": {
      "length": 0.1,
      "width": 0.2,
      "height": 0.3
    },
    "weight": 2,
    "cost_value": "2.00",
    "cost_currency": "RUB",
    "quantity": 1,
    "fiscalization": {
      "excise": "12.50",
      "vat_code_str": "vat_none",
      "supplier_inn": "3664069397",
      "article": "20ML50OWKY4FC86",
      "mark": {
        "kind": "gs1_data_matrix_base64",
        "code": "444D00000000003741"
      },
      "item_type": "product"
    },
    "age_restricted": false
  }
]

kind

Type: string

Тип изменения (change_items)

Const: change_items

Example: change_items

pickup_point_id

Type: integer

ID точки отправки, в которой меняем список товаров (int64)

comment

Type: string

Новый комментарий в точке

Example: example

kind

Type: string

Тип изменения (change_comment)

Const: change_comment

Example: change_comment

point_id

Type: integer

ID точки, для которой меняем комментарий (int64)

name

Type: string

Имя контактного лица

Example: Морти

phone

Type: string

Телефон контактного лица

Example: +79099999998

email

Type: string

Email — обязательный параметр для точек с типом source и return

Example: example@yandex.ru

phone_additional_code

Type: string

Добавочный номер для звонка курьера

Example: 602 17 500

contact

Type: ContactOnPoint

Информация о контактном лице

{
  "name": "Морти",
  "phone": "+79099999998",
  "phone_additional_code": "602 17 500",
  "email": "example@yandex.ru"
}

kind

Type: string

Тип изменения (change_contact)

Const: change_contact

Example: change_contact

point_id

Type: integer

ID точки, в которой меняем контакт (int64)