Page History

...

Параметр

Обязательно для запол.

Тип

Описание

Пример

ПВЗ

КД

(РФ)

КД

(ЕАЭС)

ПР

token

●

string

Токен для доступа к api-сервисам

d6f33e419c16131e5325cbd84d5d6000

method

●

string

Название метода

ParselCreate

sdata {1..1}

●

Блок с информацией о посылке

partner_token

string

Токен партнера интеграции (длина до 24 символов)

-

updateByTrack

string

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

-

order_id

●

string

Номер заказа в интернет-магазине

test-001

PalletNumber

string

Номер паллеты

-

barcode

string

Штрих-код посылки. Передается в случае собственной маркировки посылок.

RTES4545S

price

●

string

Объявленная стоимость посылки

2000.00

payment_sum

string

Сумма к оплате (сумма, которую необходимо взять с получателя).
Для полностью предоплаченного заказа указывать 0.

2000.00

delivery_sum

string

Стоимость доставки объявленная получателю

250.00

vid

●

string

Вид доставки:

1 - Доставка до пункта выдачи (ПВЗ, «Экспорт из РФ»)
2 - Курьерская доставка (КД)
3 - доставка Почтой России (ПР)

2

supplier_track

string

Номер заказа первичного ИМа для отправки в СМС и получения в ПВЗ.
Актуален для партнеров-агрегаторов.

PHP109482876

kurdost {1..1}

●

Блок с информацией о курьерской доставке (только для РФ) и доставке Почтой России

index

string

Почтовый индекс адреса получателя
Рекомендуем оставлять поле Индекс пустым,
для автоматического определения индекса.

603034

citi

●

string

Населенный пункт получателя.

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

Допустимы варианты:

Свердловская, Кушва, Баранчинский
Свердловская обл, г Кушва, поселок Баранчинский

Нижний Новгород

addressp

●

string

Адрес получателя (улица, дом, квартира/офис).
Разрешенные символы: ^-0-9а-яёА-ЯЁ.,:;()№/

Допустимые варианты:

ул Ереванская, д 3, кв (номер квартиры)
ул. Ереванская, д. 3, кв. (номер квартиры)
пр-кт Андропова, д 10 к 3, кв (номер квартиры)

ул. Дружбы, д 5

Следующие значения передаются только для Курьерской доставки по направлениям:

Москва - Москва
Москва - Санкт-Петербург
Санкт-Петербург - Москва
Санкт-Петербург - Санкт-Петербург

delivery_date

string

Дата курьерской доставки (формат ГГГГ-ММ-ДД). Может принимать значения +1 - +5 дней от текущей даты.

Значение по умолчанию - текущая дата + 1 день.

По другим направлениям игнорируется.

2019-07-08

timesfrom1

string

Время курьерской доставки ОТ (формат чч:мм).

Значение по умолчанию 09:00

11:00

timesto1

string

Время курьерской доставки ДО (формат чч:мм)

Значение по умолчанию 22:00

Expand

title	Информация по интервалам

Интервал доставки "ОТ-ДО" должен быть одним из перечисленных:
9:00-13:00
9:00-15:00
9:00-18:00
9:00-22:00
12:00-15:00
15:00-18:00
15:00-22:00
18:00-22:00

При проверке корректности временного интервала, он заменяется на наиболее подходящий интервал из списка, либо указывается по умолчанию.
Если интервал не передан или не соответствует диапазону, то сохраняется по умолчанию с 9:00 до 22:00.

16:00

timesfrom2

string

Альтернативное время, от

17:00

timesto2

string

Альтернативное время, до

20:00

timep

string

Время доставки текстовый формат (не используется)

-

comentk

string

Комментарий по доставке (не используется)

-

Следующие значения передаются только для доставки Почтой России

packing_strict=1, запрещает изменение упаковки при обработке груза на терминале Boxberry:

При выборе packing_type = "1" и packing_strict = "1" в случае несоответствия требованиям Почты России или повреждении упаковки при транспортировке, заказ будет возвращен в интернет-магазин
При выборе packing_type = "2" и packing_strict = "1" заказ будет переупакован на складе Boxberry по требованиям Почты России

type

string

Тип отправления, возможные значения:

0 - Посылка,
2 - Курьер Онлайн,
3 - Посылка Онлайн,
5 - Посылка 1й класс.

Если не передано, значение по умолчанию 0.

-

fragile

string

Хрупкая посылка, возможные значения 0 и 1.

Если не передано, значение по умолчанию 0.

-

strong

string

Строгий тип, возможные значения 0 и 1.

Если не передано, значение по умолчанию 0.

-

optimize

string

Оптимизация тарифа, возможные значения 0 и 1. Если не передано, значение по умолчанию 1.

Параметры strong и optimize являются взаимоисключающими и не могут одновременно принимать значение 1.

-

packing_type

●

int

Тип упаковки, возможные значения:

1 - упаковка ИМ
2 - упаковка Boxberry

-

packing_strict

●

int

Строгая упаковка, возможные значения:

1 - изменение упаковки в процессе транспортировки запрещено

0 - изменение упаковки разрешено

-

export {1..1}

●

Блок с информацией о курьерской доставке в страны ЕАЭС.

Данные заполняются, если тип доставки Курьерская доставка (vid = 2) и страна

доставки – не РФ

получения не Россия (643)

В случае доставки в отделение не заполняются.

index

●

string

Почтовый индекс получателя

090014

countryCode

●

string

Код страны

398

cityCode

●

string

Код города

Н00163821

area

●

string

Наименование области/штата

Западно-Казахстанская

street

●

string

Наименование улицы

Акбулакская

house

●

string

Номер дома

14

flat

string

Номер квартиры

255

transporterGuid

●

string

Идентификатор службы перевозчика, 36 символов (GUID)

На данный момент, рекомендуем передавать значение по умолчанию: fd85a8b6-4688-404f-9993-30b9e55d2950

fd85a8b6-4688-404f-9993-30b9e55d2950

shop {1..1}

●

Блок с информацией о пункте приема и пункте выдачи отправления

name

●

string

Код пункта выдачи

-

name1

●

string

Код пункта поступления

010

customer {1..1}

●

Блок с информацией о получателе отправления

fio

●

string

ФИО получателя

Иванов Иван Иванович

phone

●

string

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

Номер мобильного телефона получателя в формате 10 цифр.
Если Cтрана = Казахстан (CountryCode - 398) или Беларусь (112) или Киргизия (417) или Армения (051), то максимальная длина номера телефона - 12 символов.

9001122333

phone2

string

Дополнительный номер телефона получателя (только цифры)

9004455666

email

string

E-mail получателя для оповещений

test@test.ru

Следующие значения передаются для получателя юр.лица

name

●

string

Наименование организации

ООО "Получатель"

address

string

Адрес организации

-

inn

●

string

ИНН

-

kpp

string

КПП

-

r_s

string

Расчетный счет

-

bank

string

Наименование банка

-

kor_s

string

Корр. счет

-

bik

string

БИК

-

items [0..∞]

Expand

title	Массив товарных вложений

Блок с информацией по товарным позициям, включённым в заказ. Проверяется корректность заполнения обязательных и необязательных полей.
Обязательно к ознакомлению: Условия загрузки заказов с товарными позициями:

Таблица 1. Проверки полей заказа
Таблица 2. Проверки полей заказа Почты России

id

string

Артикул товара

252112-dget

name

●

string

Наименование товара

Куртка детская

UnitName

string

Единица измерения

шт.

nds

string

Физически	API
НДС не указан	поле НЕ передано
Без НДС	-1
0% 10% 18% 20%	целое число (от 0 до 20)

18

price

●

string

Цена за единицу товара

1750

quantity

●

string

Количество единиц товара

1

marking_crpt

string

Маркировка товара

Код маркировки состоит из 28 знаков и включает данные: GTIN (14 символов) + "+" + ISN (13 символов) товара.

REST API: необходимо экранировать все специальные символы.
API в формате SOAP: все специальные символы необходимо передавать в теге <![CDATA[ ... ]]>, иначе маркировка товара не сохранится.
Пример, <marking_crpt><![CDATA[00000217553+lVfTHoca%>km&]]></marking_crpt>

04610043040058

supplier_name

string

Наименование юр. лица Поставщика.

Ограничение до 255 символов.

-

supplier_inn

string

ИНН Поставщика

Должен состоять только из цифр длиной 10 или 12 символов.

-

supplier_phone

string

Номер телефона Поставщика.

-

notice

string

Примечание к заказу.

Текст выводится в печатную форму этикетки.
Если у заказа несколько мест (несколько этикеток), то данные по примечанию выводятся на каждой этикетке.
Количество символов <= 100.

Позвонить в домофон

weights {1..}

●

Блок с информацией о тарных местах (SOAP - количество элементов 24, JSON - 100)

Expand

title	Информация о весе и ШК мест

Информация о весе ЗП:

weight - вес первого или единственного тарного места, в граммах. Минимальное значение 5 г, максимальное – 31000 г.
weight2, weight3, … weight24 - вес второго и последующих тарных мест, в граммах. Внимание, данные строки добавляются только в случае, если ЗП отправляется двумя и более тарными местами.

Информация о штрих-кодах мест, передается в случае собственной маркировки уникальными ШК каждого тарного места:

Каждый баркод должен заполняться в соответствующей строке веса
Если у заполненных мест указан хотя бы один баркод, то и остальные необходимо указать.
Если у мест указан баркод, то "Штрих-код ЗП" заполнять необязательно.

weight

●

string

Вес первого тарного места (гр)

400

barcode

string

Баркод первого тарного места

-

x

●

string

Габариты тарного места (см) (в сумме не должны превышать 250см!!!)

20

y

●

string

20

z

●

string

10

weight2

string

Вес, баркоды и габариты последующих тарных мест

-

barcode2

string

-

x2

string

-

y2

string

-

z2

string

-

.......

-

weight24

string

-

barcode24

string

-

x24

-

y24

-

z24

-

issue

integer

Вид выдачи заказа, возможные значения:

0 - выдача без вскрытия,
1 - выдача со вскрытием и проверкой комплектности,
2 - выдача части вложения.

Если не передается, используется значение по умолчанию, установленное в Профиле магазина - раздел "Услуги".

1

fitting

integer

Возможные значения:

0 - нет примерки
1 - подключена примерка

sender_name

string

Наименование магазина отправителя для sms/e-mail оповещений.

Expand

title	Обращаем внимание

Данное наименование будет использовано в информационных уведомлениях для получателя.
Параметр следует передавать, если наименование в уведомлениях должно отличаться от наименования вашего ИМ.
Если параметр не указан или указан не в соответствии с ограничениями, то будет использовано ваше основное наименование, приведенное к соответствию условиям проверки.
Пожалуйста, указывайте понятное клиенту наименование: название на сайте, название бренда и т.п.
Подробнее можете уточнить у вашего менеджера

-

gift

boolean

(не используется)

-

AgregatorPointCargoCode

string

Уникальный код склада.
Актуален для партнеров-агрегаторов.

...

Page tree

Versions Compared

Old Version 106

New Version 107

Key