Page tree
Skip to end of metadata
Go to start of metadata

В протоколе обмена используются следующие типы данных:

string(n) - текстовая строка, где n - максимальное количество символов.

integer - целочисленное значение из интервала от 0 до 1 000 000.

float - число с плавающей точкой, в качестве разделителя используется точка.

boolean - логическое значение (возможные значения: true или false).

dateTime - дата и время в формате ISO 8601: YYYY-MM-DDThh:mm:ss±hhmm.

date - дата в формате ISO 8601: YYYY-MM-DD.

time - время в формате ISO 8601: hh:mm.

UUID - уникальный идентификатор, представляет собой 16-байтный номер. Например: 8dea00e3-9aab-4d8e-887c-ef2aaa546456.

money - стоимость услуги/товара с учетом налогообложения

Название поляОписаниеТип поляОбязательность
valueСумма в валютеfloatда
vat_sumСумма НДСfloatнет
vat_rateСтавка НДС (значение - 0, 10, 18, 20 и т.п. , null - нет НДС)integerнет

threshold - дополнительный сбор за доставку в зависимости от стоимости товара

Название поляОписаниеТип поляОбязательность
thresholdПорог стоимости товара (действует по условию меньше или равно) в целых единицах валютыintegerда
sumДоп. сбор за доставку товаров, общая стоимость которых попадает в интервалfloatда
vat_sumСумма НДС, включённая в доп. сбор за доставкуfloatнет
vat_rateСтавка НДС (значение - 0, 10, 18, 20 и т.п. , null - нет НДС)integerнет

contact - данные контрагента (отправителя, получателя)

Название поляОписаниеТип поляОбязательность*
companyНаименование компанииstring(255)

нет

nameФ.И.О контактного лицаstring(255)да
emailЭл. адресstring(255)нет
phonesСписок телефоновphone[]да
passport_seriesСерия паспортаstring(255)нет
passport_numberНомер паспортаstring(255)нет
passport_date_of_issueДата выдачи паспортаdateнет
passport_organizationОрган выдачи паспортаstring(255)нет
passport_date_of_birthДата рожденияdateнет
tinИННstring(255)нет
passport_requirements_satisfied

Требования по паспортным данным удовлетворены (актуально для международных заказов):

true - паспортные данные собраны или не требуются
false - паспортные данные требуются и не собраны

booleanнет

*Зависит от типа заказа и контрагента 

phone - номер телефона (мобильный/городской)

Название поляОписаниеТип поляОбязательность
numberНомер телефона
Необходимо передавать в международном формате: код страны (для России +7) и сам номер (10 и более цифр)
string(255)да
additionalДополнительная информация (добавочный номер)string(255)нет

seller - данные истинного продавца

Название поляОписаниеТип поляОбязательность
nameНаименование истинного продавцаstring(255)нет
innИНН истинного продавцаstring(20)нет
phoneТелефон истинного продавцаstring(255)нет
ownership_formКод формы собственности integerнет
addressАдрес истинного продавца. Используется при печати инвойсов для отображения адреса настоящего продавца товара, либо торгового названияstring(255)нет

location - адрес местоположения контрагента (отправителя, получателя), включая геолокационные данные

Название поляОписаниеТип поляОбязательность
codeКод населенного пункта СДЭК (метод "Список населенных пунктов")integerнет
fias_guidУникальный идентификатор ФИАСUUIDнет
postal_codeПочтовый индексstring(255)нет
longitudeДолготаfloatнет
latitudeШиротаfloatнет
country_codeКод страны в формате  ISO_3166-1_alpha-2string(2)да
regionНазвание регионаstring(255)нет
sub_regionНазвание района регионаstring(255)нет
cityНазвание городаstring(255)нет
kladr_code

Код КЛАДР

Устаревшее поле

string(255)нет
addressСтрока адресаstring(255)да

service - данные о дополнительных услугах

Название поляОписаниеТип поляОбязательность
codeКод дополнительной услугиintegerда
parameterПараметр дополнительной услугиintegerнет

package - информация о местах заказа

Название поляОписаниеТип поляОбязательность
numberНомер упаковки (можно использовать порядковый номер упаковки заказа или номер заказа), уникален в пределах заказа. Идентификатор заказа в ИС Клиентаstring(255)да
weightОбщий вес (в граммах)integerда
lengthГабариты упаковки. Длина (в сантиметрах)integerнет
widthГабариты упаковки. Ширина (в сантиметрах)integerнет
heightГабариты упаковки. Высота (в сантиметрах)integerнет
commentКомментарий к упаковкеstring(255)нет
items

Позиции товаров в упаковке

item[]нет

item - информация о товарах места заказа (только для заказа типа "интернет-магазин")

Название поляОписаниеТип поляОбязательность
nameНаименование товара (может также содержать описание товара: размер, цвет)string(255)да
ware_keyИдентификатор/артикул товараstring(20)да
paymentОплата за товар при получении (за единицу товара в указанной валюте, значение >=0) — наложенный платеж, в случае предоплаты значение = 0moneyда
costОбъявленная стоимость товара (за единицу товара в указанной валюте, значение >=0). С данного значения рассчитывается страховкаfloatда
weightВес (за единицу товара, в граммах)integerда
weight_gross

Вес брутто

integerнет
amountКоличество единиц товара (в штуках)integerда
name_i18nНаименование на иностранном языкеstring(255)нет
brandБренд на иностранном языкеstring(255)нет
country_codeКод страны в формате  ISO_3166-1_alpha-2string(2)нет
materialКод материалаstring(255)нет
wifi_gsmСодержит wifi/gsmbooleanнет
urlСсылка на сайт интернет-магазина с описанием товараstring(255)нет

error - lанные об ошибке обработки запроса на стороне ИС СДЭК

Название поляОписаниеТип поляОбязательность
codeКод ошибкиstring(255)да
messageОписание ошибкиstring(255)да

status - статус заказа, заявки

Название поляОписаниеТип поляОбязательность
codeКод статусаstring(255)да
nameНазвание статусаstring(255)да
date_timeДата и время установки статуса (формат yyyy-MM-dd'T'HH:mm:ssZ)datetimeда
reason_codeДополнительный код статусаstring(2)нет
cityНаименование места возникновения статусаstring(255)нет


  • No labels