Skip to main content

Команда PutItems (запись номенклатуры)

Метод осуществляет запись номенклатуры в систему 3PL.                                                             

Если запись с данным ID уже существует, она обновляется, иначе - создается новая карточка.

Если продукция имеет только один вариант упаковки (или нет необходимости хранить продукцию в различных вариантах упаковки), то передавать <Packings> не требуется.

В поле <Name> следует указывать наименование, которое уникально и однозначно характеризует позицию номенклатуры.

Визуально оператор склада по этому наименованию должен однозначно определить какая позиция у него в руках.

Пример некорректного наименования: <Name>Туфли</Name>
Пример корректного наименования: <Name>03894507|Замшевые туфли Albert|42|синий</Name>

В поле <Fullname> следует передавать наименование, которое понятно получателю, так как именно оно будет печататься во всех печатных формах (бланк заказа, ТОРГ-12 и т.д.).

Пример запроса

<Command id="PutItems" Login="test" Password="test">
      <Items>
            <Item>
                  <Id>700</Id>
                  <Article>DF-2122</Article>
                  <Name>Рубашка Cacharel DF-2212</Name>
                  <Fullname>Рубашка DF-2212</Fullname>
                  <ParentID/>
                  <BasePackingID/>
                  <ItemType/>
                  <Image>https://some-url-to-image.com/image.jpg</Image>
                  <ImagePreview>https://some-url-to-image.com/image_preview.jpg</ImagePreview>
                  <Packings>
                        <Packing>
                              <Id>EA</Id>
                              <ParentID/>
                              <Name>штука</Name>
                              <Quantity>1</Quantity>
                              <Height>0.5</Height>
                              <Width>1</Width>
                              <Length>2</Length>
                              <Volume>1</Volume>
                        </Packing>
                  </Packings>
                  <Barcodes>
                        <Barcode>
                              <Code>456465456475</Code>
                              <PackingID>EA</PackingID>
                        </Barcode>
                  </Barcodes>
                  <AccountingAttributes>
                        <AccountingAttribute>
                             <Code>chestnyznak</Code>
                             <Title>Честный знак</Title>
                             <Wildcard>44?????</Wildcard>
                       </AccountingAttribute>
                  </AccountingAttributes>
            </Item>
      </Items>
</Command>

Пример ответа (успешно создана номенклатура, код в системе 3PL - 30212)

<Reply>
    <IsError>false</IsError>
    <Comment/>
    <Result>
        <Items>
            <Item>
                <Id>700</Id>
                <Success>true</Success>
                <Comment/>
                <Code>30212</Code>
            </Item>
        </Items>
    </Result>
</Reply>

Структура содержимого запроса

Тег

Тип значения

Описание

Command

Корневой тег

Атрибуты: Id (имя команды), Login, Password

    Items

 

Список товаров

        Item

 

Элемент товара

           ID

Строка

Уникальный идентификатор позиции в системе Партнера

           Article

Строка (25)

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

           Name

Строка (100)

Краткое наименование товара.
Должно быть уникальным и однозначно характеризовать позицию номенклатуры

           Fullname

Строка (1024)

Полное наименование товара, как оно должно выводиться на печать

           InternationalDescription

Строка (60)

Международное описание товара на английском языке

           IsService

Булево

Для услуг true

           BasePackingID

Строка

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

           Description

Строка (1024)

Описание товара.
Может содержать знаки переноса строки

           VendorID

 

Идентификатор поставщика в системе партнера

           Height

Число 15,3

Высота (м)

           Width

Число 15,3

Ширина (м)

           Length

Число 15,3

Глубина (м)

           Volume      

Число 15,3

Объем (м^3).
Если не задан, рассчитывается из размеров

           VAT

Число

Ставка НДС по умолчанию

           TnvedCode

Строка(1 024)

Код ТН ВЭД.
Заполняется для международных отправлений и товаров с честным знаком.
Минимальная длина 4 символа

           MaskUniqueNumber

Строка

Маска для уникального номера.
Знак вопроса - любой символ, любой иной символ - обязательный.

Например, если ваши серийные номера всегда имеют префикс 44 и длину 7 символов:
4400001
4400002

4400003
Тогда маска будет:
44?????

 

Система будет требовать от оператора именно это значение

           Properties

 

Коллекция дополнительных свойств товара

              Property

 

 

              ID

Строка

ID свойства.
Доступные свойства согласовываются заранее

              Name

Строка

Наименование свойства

              Value

Строка

Значение свойства

           Packings

 

Список упаковок номенклатуры (единиц измерения номенклатуры).
Параметр необязательный, если у продукции один вариант упаковки (или требуется вести учет только в одном варианте).

              Packing

 

 

                 ID

Строка

Идентификатор упаковки

                 ParentID

Строка

Идентификатор родительской упаковки.
Для базовой единицы измерения можно не указывать

                 Name

Строка (20)

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

                 Quantity

Число 15,3

Коэффициент (количество родительских упаковок)

                 Height

Число 15,3

Высота (м)

                 Width

Число 15,3

Ширина (м)

                 Length

Число 15,3

Глубина (м)

                 Volume            

Число 15,3

Объем (м^3).
Если не задан, рассчитывается из размеров

                 Weight             

Число 15,3

Вес брутто (кг)

           Barcodes

 

Штрихкоды

              Barcode

 

 

                 Code

Строка

Значение штрихкода

                 PackingID

Строка

Идентификатор упаковки

                 NotUsed

Булево

Отменяет привязку штрихкода к номенклатуре

           AccountingAttributes

 

Штрихкоды

               AccountingAttribute

 

 

                   Code

Строка

Внешний ключ кода.
Все внешние ключи согласовываются отдельно

                   Title

Строка

Описание

                   Wildcard

Строка

Маска для уникального номера.
Знак вопроса - любой символ, любой иной символ - обязательный.

Например, если ваши серийные номера всегда имеют префикс 44 и длину 7 символов:
4400001
4400002

4400003
Тогда маска будет:
44?????

 Структура ответа

Тег

Тип значения

Описание

Reply

Корневой тег

 

    IsError

Булево

Флаг общей ошибки обработки (когда невозможно интерпретировать XML в целом, ошибка формата и прочие глобальные ошибки).
Значения: «true»/«false».

Стоит учитывать, что вполне нормальная ситуация, когда этот флаг «false» (нет общей ошибки), но при этом есть ошибки при записи номенклатуры.

    Comment

Строка (1024)

Комментарий к общей ошибке

    Result

 

 

        Items

 

 

            Item

 

 

                ID

Строка

Идентификатор номенклатуры

                Success

Булево

Признак успешной записи.
Значения: «true»/«false»

                Comment

Строка (1024)

Комментарий

                Code

Строка

Код номенклатуры в базе 3PL