Цифра ↔ 1С

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

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

POST /api/car/create

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

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

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

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

Поле Тип Обязательное Описание
Guid string Да Идентификатор в 1C
Number string Да Государственный номер
Name string Нет Наименование ТС
Type string Нет Тип транспортного средства
Rent boolean Нет Арендное или нет
Pickup boolean Нет Используется для самовывоза
Volume float Нет Вместимость миксера (м³)
Length float Нет Длина насоса (м)

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

Значение Описание
mixМиксер (автобетоносмеситель). Также принимаются: "Автобетоносмеситель", "Миксер"
pumpНасос (автобетононасос). Также принимаются: "Автобетононасос", "Насос"
semiТягач
truckСамосвал
excavatorЭкскаватор
loaderПогрузчик
craneКран
carЛегковой автомобиль
Примечания
  • Name опционально: если не указано, используется значение Number
  • Number используется для валидации и как имя ТС по умолчанию (если Name не указано)
  • ТС с номерами, содержащими служебные значения ("ручной", "(не выбран)", "самовывоз"), не будут созданы
  • Для миксеров указывать 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)
403 Ошибка ключа. Секретный ключ не найден (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
}

Подробности внутренней ошибки в ответ не попадают: причина фиксируется на стороне Цифры, искать её в теле ответа не нужно. Если ошибка повторяется — обратитесь в поддержку Цифры, указав data_id.

См. также

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