Цифра ↔ 1С

Справочники — Продукция

Метод для создания или обновления продукции (номенклатуры) в Цифре из 1С.

POST /api/product/create

Для создания или обновления продукции (номенклатуры) в Цифре необходимо отправить запрос на метод API, передав массив продукции в поле Data.

Параметры запроса

Параметр Тип Обязательный Описание
SecretKey string Да Секретный ключ
Data array Да Массив продукции для создания/обновления
Логика работы
  • Данные передаются в массиве Data
  • Если продукция с переданным Guid уже существует в системе — она будет обновлена
  • Если продукции с таким Guid нет — будет создана новая

Структура Data[]

Поле Тип Обязательное Описание
Guid string Да Идентификатор в 1C
Name string Да Наименование продукции
Sku string Нет Артикул или код продукции
Unit string Нет Единица измерения (м³, шт, кг)
ShortName string Нет Короткое название
Specification boolean Нет Является ли продукция спецификацией
Price number Нет Цена
VatRate float Нет Процент налога (например, 20)
VatInPrice boolean Нет Включен ли НДС в стоимость
Service string Нет Тип услуги: mix (доставка), downtime (простой), pump (насос), other (остальное). Если товар — оставить пустым

Дополнительные поля для бетонной продукции

Эти поля могут передаваться как на верхнем уровне объекта Data[], так и внутри объекта Parent.

Поле Тип Обязательное Описание
ViewNamestringНетВид бетонной смеси и её условное обозначение
NumberCompositionstringНет№ номинального состава
BrandstringНетМарка бетона (М)
ClassstringНетКласс бетона (В)
MobilitystringНетПодвижность бетона (П)
ConeDraftstringНетОсадка конуса
WorkabilityTimestringНетСохр. удобоукл., (ч-мин)
AggregateSizestringНетНаибольшая крупность заполнителя (мм)
Class28dstringНетКласс бетона, 28 суток (В)
Strength28dstringНетПрочность, 28 суток (МПа)
Class7dstringНетКласс бетона, 7 суток (В)
Strength7dstringНетПрочность, 7 суток (МПа)
CompressiveStrengthstringНетПрочность на сжатие
AdditiveNamestringНетДобавка
AdditiveWeightstringНетМасса добавки
CementstringНетНаименование и класс прочности применяемого цемента
DeclarationstringНетРегистрационный номер декларации о соответствии
GoststringНетНомер стандарта или ТУ
AeffstringНетУдельная эффективная активность ЕРН Аэфф
QualityIndicatorsstringНетПоказатели качества
Примечания
  • Отправляйте только бетон, смеси и инертные материалы
  • Если продукция с указанным Guid существует, она будет обновлена
  • Parent: если указан родительский продукт, он будет создан как отдельный товар
  • Характеристики без поля Guid будут пропущены
  • Продукты с названиями, содержащими служебные значения ("ручной", "(не выбран)", "тест", "физ.лицо"), не будут созданы
  • Для услуг заполняйте поле Service
  • Для товаров оставляйте Service пустым или null
  • Спецификации: если Specification = true
  • Не отправляйте за раз более 2000 единиц или более 1 МБ данных
Пример запроса 1С → Цифра 
{
  "SecretKey": "2akgzOCYsAxLwpNl",
  "Data": [
    {
      "Guid": "22db4291-154f-11ec-973e-244bfecb4e0a",
      "Name": "БСТ М400БВ30W10П4F150",
      "Sku": "00-00230232",
      "Unit": "м³",
      "ShortName": "М400",
      "Specification": false,
      "Price": 5000,
      "VatRate": 20,
      "VatInPrice": true,
      "Service": null,
      "Brand": "М400",
      "Class": "В30",
      "Mobility": "П4",
      "Gost": "ГОСТ 7473-2010"
    },
    {
      "Guid": "33ab5192-265g-22fc-a84f-355cgfdc5f1b",
      "Name": "Доставка бетона",
      "Unit": "км",
      "Price": 50,
      "Service": "mix"
    }
  ]
}

Коды ответов

Код Описание
201 Успешное создание. Все данные обработаны без ошибок (success: true)
207 Частичный успех. Часть данных обработана, но есть ошибки (success: true)
401 Ошибка ключа. Секретный ключ не найден (success: false)
422 Ошибка валидации. Data должен быть массивом (success: false)
500 Ошибка сервера. Внутренняя ошибка обработки (success: false)

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

Поле Тип Описание
success boolean Успешность операции
message string Сообщение об успешных операциях
data_id integer ID записи в логе
errors array Массив ошибок (только при наличии ошибок)

Примеры ответов

{
  "success": true,
  "message": "Загружено товаров: 5. Обновлено товаров: 2. Загружено характеристик: 15. Обновлено характеристик: 3",
  "data_id": 123
}
{
  "success": true,
  "message": "Загружено товаров: 3. Обновлено товаров: 1",
  "data_id": 123,
  "errors": [
    "Товаров без GUID: 2",
    "Товаров без названия: 1"
  ]
}
{
  "success": false,
  "message": "Секретный ключ не найден",
  "data_id": null
}
{
  "success": false,
  "message": "Неверный тип данных",
  "data_id": 123
}
{
  "success": false,
  "message": "Произошла ошибка: подробное описание ошибки",
  "data_id": 123
}

См. также

Двусторонний обмен данных
Общая информация