Цифра ↔ 1С

Справочники — Транспортные средства

Метод для создания или обновления транспортных средств в Цифре из 1С.

POST /api/car/create

Для создания или обновления транспортных средств в Цифре необходимо отправить запрос на метод API, передав массив ТС в поле Data.

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

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

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

Поле Тип Обязательное Описание
Guid string Да Идентификатор в 1C
Number string Да Государственный номер (используется для валидации и как имя по умолчанию)
Name string Нет Наименование ТС (если не указано, используется значение Number)
Type string Нет Тип: mix, pump, semi, truck, excavator, loader, crane, car (см. карточку ниже)
Rent boolean Нет Арендное или нет
Pickup boolean Нет Используется для самовывоза
Volume float Нет Вместимость миксера (м³)
Length float Нет Длина насоса (м)

Типы транспортных средств

Значение Описание
mixМиксер (автобетоносмеситель). Также принимаются: "Автобетоносмеситель", "Миксер"
pumpНасос (автобетононасос). Также принимаются: "Автобетононасос", "Насос"
semiТягач
truckСамосвал
excavatorЭкскаватор
loaderПогрузчик
craneКран
carЛегковой автомобиль
Примечания
  • Name опционально: если не указано, используется значение Number
  • ТС с номерами, содержащими служебные значения ("ручной", "(не выбран)", "тест", "самовывоз"), не будут созданы
  • Для миксеров указывать Volume (объём в м³)
  • Для насосов указывать Length (длина в метрах)
  • Если ТС арендное (Rent = true), заполните RentCompany. Обязательны: Guid и Name
  • Поддерживаются текстовые значения типов: "Автобетоносмеситель", "Миксер" → mix; "Автобетононасос", "Насос" → pump
  • Система автоматически создаёт связи между ТС с одинаковыми номерами или названиями
  • Не отправляйте за раз более 2000 ТС или более 1 МБ данных
Пример запроса 1С → Цифра 
{
  "SecretKey": "2akgzOCYsAxLwpNl",
  "Data": [
    {
      "Guid": "22db4291-154f-11ec-973e-244bfecb4e0a",
      "Name": "Камаз 700 ТК",
      "Number": "В700ТК797",
      "Type": "mix",
      "Rent": false,
      "Pickup": false,
      "Volume": 8
    },
    {
      "Guid": "33ab5192-265g-22fc-a84f-355cgfdc5f1b",
      "Name": "Насос 42м",
      "Number": "А123БВ456",
      "Type": "pump",
      "Rent": true,
      "Length": 42,
      "RentCompany": [
        {
          "Guid": "44cd6203-376h-33gd-b95g-466dghde6g2c",
          "Name": "ООО Аренда Техники",
          "Inn": "7604377806"
        }
      ]
    }
  ]
}

Коды ответов

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

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

Поле Тип Описание
successbooleanУспешность операции
messagestringСообщение об успешных операциях
data_idintegerID записи в логе
errorsarrayМассив ошибок (только при наличии ошибок)

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

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

См. также

Инструкция по заданию createCar
Создание ТС в 1С
Двусторонний обмен данных
Общая информация