804
правки
Изменения
API
,→Описание элементов для оформления заказа
*'''order''' - Контейнер для описания одного заказа, обязательный элемент. В одном контейнере '''neworder''' может быть много контейнеров '''order''' для создания нескольких заказов одним запросом.
:: - '''''orderno''''' - Номер заказа. Если присваивается клиентом - указывается здесь. Если не присваивается - можно оставить пустым, система сгенерирует свой номер, и вернет его в ответе.
*'''barcode''' - Штрих-код заказа. В случае, если клиент штрих-кодирует свои отправления, и штрих-код отличается от номера заказа, в этом поле указывается штрих-код. В случае наличия нескольких мест, и раздельной их маркировки, в этом поле допустимы маски в виде символов подчеркивания, говорящие о позициях штрих-кода, переменных для разных мест в рамках одного заказа.<br />
Поле '''Город''' контейнеров '''sender''' и '''receiver''' можно указать одним из следующих способов:
:: - код населенного пункта из справочника городов:: - 13-ти значный код адресного классификатора КЛАДР:: - 36-ти значный код адресной системы ФИАС:: - название города (не рекомендуется!)
*'''paytype''' - Тип оплаты заказа получателем. Принимает значения:
:: - CASH - Наличными при получении (по-умолчанию):: - CARD - Картой при получении:: - NO - Без оплаты. Поле Price будет проигнорировано. (Этот тип оплаты передается, если заказ уже оплачен и не требует инкассации, API добавит в систему товары по нулевой цене. Если необходимо передать общую сумму заказа - можно это сделать в поле <inshprice>, указав объявленную ценность):: - OTHER - Прочее (Предусмотрен для того, чтобы оплата поступала непосредственно в курьерскую службу посредством прочих типов оплаты - таких как: вебмани, яденьги, картой на сайте, прочие платежные системы и т.д.):: - OPTION - На выбор получателя. Этот тип оплаты нельзя передавать с заказом. Он выставляется автоматически в зависимости от настройки клиента.
*'''zipcode''' - Почтовый индекс.
*'''items''' - Контейнер для описания вложенных товаров. Не обязательный контейнер. Атрибуты:
::- '''''item''''' - Название товара.::- '''''quantity''''' - Количество единиц товара.::- '''''mass''''' - Масса единицы товара в килограммах.::- '''''retprice''''' - Цена единицы товара.::- '''''VATrate''''' - Ставка НДС - целое число процентов. Если значение не указано, подставляется значение "18".::- '''''barcode''''' - Штрих-код товара. [[Файл:Article.png|thumb|100px|right]]::- '''''article''''' - Артикул товара. ''Внимание!'' Указание артикула используется только тогда, когда товар хранится на ответственном хранении в службе доставки, и необходима комплектация. В этом случае система пытается привязать товар к [[API#Справочник номенклатуры|справочнику номенклатуры]]. Если товар в справочнике не найден - система выдаст соответствующую ошибку. Если по артикулу найдено несколько товаров - система выберет один из них случайным образом, что может привести к ошибочной комплектации! Если товар НЕ на ответственном хранении - артикул указывать НЕ нужно. Позиция попадет в систему просто текстом.::- '''''extcode''''' - Внешний код строки. Используется для идентификации строк заказов при получении статусов. Не обязательное поле. ПОКА НЕ ПОДДЕРЖИВАЕТСЯ.
В случае необходимости указания, помимо товаров, дополнительных услуг (например, ДОСТАВКА, комплектация, подъем на этаж и т.д.) - их нужно указать в том же контейнере items как товары, без артикула.
