Цифра ↔ 1С

Заказ клиента в воронку

Передача заказа клиента из 1С в производственную воронку Цифры: по заказу ведётся заявка в CRM.

POST /api/customer_order/create

Отправляет расширение 1С при каждом изменении заказа со статусом «К выполнению» или «К отгрузке» и при переходе в «Закрыт».

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

Параметр Тип Обязательный Описание
SecretKeystringДаСекретный ключ
DataobjectДаЗаказ клиента
Логика работы
  • Одно сообщение — один заказ: Data передаётся объектом, массив даёт отказ, TaskId не передаётся
  • Сообщение всегда несёт весь заказ текущим состоянием, включая отменённые строки
  • Номер воронки (FunnelId) берётся из списка воронок: подходит воронка с AcceptsCustomerOrder: true

Структура Data

Поле Тип Обязательное Описание
GuidstringДаПостоянный идентификатор заказа
NumberstringДаНомер заказа
DatestringДаДата заказа
StatusstringДаСостояние заказа
FunnelIdintegerДаНомер воронки из списка
DeliveryTypestringНетСпособ получения
CommentstringНетКомментарий
VatInPricebooleanДаЦена включает НДС
Примечания
  • Guid заказа постоянный: по нему повторная передача находит заявку
  • Number и Date видны в уведомлениях; Date и ShipmentDate передаются в формате YYYY-MM-DD
  • Status: active — заказ в работе, closed — закрыт
  • Client.Guid — по нему Цифра находит контрагента; Client.Name нужен, если контрагента придётся завести
  • Contract: если блок передан, обязательны оба поля — Guid и Name
  • DeliveryType: delivery или take-away, по умолчанию delivery
  • Delivery.Address обязателен при доставке; при take-away не передаётся
  • Координаты (Latitude/Longitude) — разделитель точка; нулевые координаты не передаются
  • Contact: если блок передан, обязательны оба поля — Name и Phone; контакт без телефона не передаётся
  • Manager.Name ищется среди сотрудников точным совпадением ФИО
  • Products — хотя бы одна строка, в порядке табличной части
  • RowCode связывает строку между передачами и единственен внутри заказа
  • CharacteristicGuid: пустую ссылку не передавать. CharacteristicName (например, цвет) передаётся вместе с CharacteristicGuid
  • Name строки — наименование без характеристики
  • Unit используется, если изделие заводится по заказу
  • Quantity — в единице хранения, до 3 знаков после запятой
  • Price — со всеми скидками, до 2 знаков после запятой, включает НДС по правилу VatInPrice
  • VatRate — в процентах: 22, 10, 0. Без НДС — 0
  • Canceled по умолчанию false
  • CancelReason видна производственнику. Не передана — в Цифре будет «Причина не указана в 1С»

Откуда брать значения в 1С

Поле Значение в 1С
GuidXMLСтрока(Ссылка)
NumberНомер
DateФормат(Дата, "ДФ=yyyy-MM-dd")
StatusКОбеспечению («К выполнению») и КОтгрузке → active, Закрыт → closed. НеСогласован не отправляется
FunnelIdНастройка расширения
Client.GuidXMLСтрока(Контрагент), как в выгрузке контрагентов
Client.NameКак в выгрузке контрагентов
Client.InnКонтрагент.ИНН
Contract.Guid, Contract.NameXMLСтрока(Соглашение) и его наименование: то, что расширение уже выгружает как договор. Не реквизит Договор
DeliveryTypeПеревод из СпособДоставки расширением
Delivery.AddressАдресДоставки
Delivery.Nameманг_ОбъектСтроительства.Наименование, если заказ по объекту
Delivery.Latitude, Delivery.Longitudeманг_ОбъектСтроительства.КоординатыШирота, .КоординатыДолгота
Contact.Name, Contact.PhoneКонтактноеЛицо.Наименование; телефон из КонтактнаяИнформация, запросом как в выгрузке контрагентов
Manager.NameМенеджер.Наименование
CommentКомментарий
VatInPriceЦенаВключаетНДС
ProductsТовары
RowCodeФормат(КодСтроки, "ЧГ=0")
Products[].GuidXMLСтрока(Номенклатура), как в выгрузке номенклатуры
CharacteristicGuidXMLСтрока(Характеристика), если заполнена
CharacteristicNameХарактеристика.Наименование
Products[].NameНоменклатура.НаименованиеПолное
UnitСтрока(Номенклатура.ЕдиницаИзмерения)
QuantityКоличество, не КоличествоУпаковок
PriceОкр(Сумма / Количество, 2); при Количество = 0 — Цена. Поле Цена само по себе стоит до скидок
VatRateСтавкаНДС.Ставка
ShipmentDateТовары.ДатаОтгрузки; пусто — ДатаОтгрузки шапки. Формат(…, "ДФ=yyyy-MM-dd")
CanceledОтменено
CancelReasonСтрока(ПричинаОтмены)

Правила

  • Пустые значения. Необязательное поле не передано, null или пустая строка — значение очищается в заявке: 1С главная. Очищаются Comment, Contract, Contact, Manager. Название адреса и координаты только дополняют пустые значения найденного адреса: он общий с другими заказами контрагента.
  • Нулевое количество. Строка с Quantity = 0 считается отменённой.
  • Весь заказ каждый раз. Строка, которой не стало, считается удалённой и отменяется в Цифре с причиной.
  • Наборы. Набор отдельной строкой не передаётся: идут его части, каждая своей строкой со своим кодом, количеством и ценой. Строка, изображающая сам набор, если такая есть в заказе, в сообщение не включается.
  • Что производится, решает Цифра. 1С отправляет все строки одинаково. Строка с изделием, у которого есть техкарта на площадках воронки, идёт в заказ на производство. Позиции, отмеченные в Цифре как «Не производится» (доставка, поддоны), остаются в заявке без замечаний. Изделие без техкарты и без такой отметки остаётся в заявке: ответ 207, производству уведомление.
  • Сумма строки не передаётся: Цифра считает её из цены, количества и НДС.
  • Одно изделие несколькими строками на одну дату разрешено.
  • Отменённая строка, появившаяся впервые (при первой передаче или при повторе), не заводится и причиной отказа не бывает. Все строки отменены при первой передаче — заявка не заводится, ответ 200.
  • Замена изделия в той же строке — отмена старой строки и новая строка. Возврат отменённой строки — новый срок.
  • Первая передача — всё или ничего: хоть что-то не создаётся — ответ 422, не заведено ничего.
  • Повтор принятого заказа применяет, что можно. Отмены, уменьшения, адрес и даты применяются всегда. Новая строка или прирост количества, которые нельзя завести, не заводятся: ответ 207, производству уведомление. Отказ 422 только при нарушении формата сообщения или если заказ уже закрыт.
  • Количество ниже отгруженного приводится к отгруженному: ответ 207, производству уведомление.
  • Какие заказы отправлять впервые: Дата документа не раньше даты запуска (настройка расширения), есть изделия пресса, cf_Id не заполнен.
  • Принятый заказ. На ответ 200, 201 или 207 расширение ставит свой признак «принят в Цифре» (не в cf_Id: там номер заказа бетона) и дальше отправляет заказ, пока он «К выполнению» или «К отгрузке», и при переходе в «Закрыт», даже если изделий пресса в нём больше нет.
  • Статусы 1С. «К выполнению» и «К отгрузке» — active, «Закрыт» — closed. Принятый заказ, вернувшийся «На согласование», не отправляется: Цифра держит прежний план, при возврате в работу уходит весь заказ.
  • Закрытие. closed передаётся заказом целиком. Неотгруженные строки отменяются с причиной «Заказ закрыт в 1С», заказ на производство уходит из плана. Для принятого заказа отказывает только неверный формат или отсутствие Guid. Повтор closed — 200 без изменений.
  • Заявка после закрытия переходит на этап «Выполнено», а если все строки отменены и ничего не отгружено — на этап «Отменено».
  • Первая передача сразу с closed ничего не заводит, ответ 200.
  • Заказ снова active после closed: отказ 422, изменения не применяются.
  • Смена FunnelId у принятого заказа не применяется: заказ остаётся в своей воронке, ответ 207.
  • Пометка на удаление не обрабатывается и не отправляется.
Заказ с отменённой строкой и строкой доставки 1С → Цифра
{
  "SecretKey": "2akgzOCYsAxLwpNl",
  "Data": {
    "Guid": "6f1c2a10-3b7e-11ef-8d21-005056b6a111",
    "Number": "0МБЗ-001979",
    "Date": "2026-11-09",
    "Status": "active",
    "FunnelId": 12,
    "Client": {
      "Guid": "b7a8c9d0-0000-11ef-8d21-005056b6a111",
      "Name": "ООО Ромашка",
      "Inn": "7701234567"
    },
    "Contract": {
      "Guid": "c1d2e3f4-0000-11ef-8d21-005056b6a111",
      "Name": "Основное соглашение № 15"
    },
    "DeliveryType": "delivery",
    "Delivery": {
      "Address": "Пермь, ул. Полевая, 10",
      "Name": "Объект на Полевой",
      "Latitude": 58.0105,
      "Longitude": 56.2502
    },
    "Contact": {
      "Name": "Иванов Пётр",
      "Phone": "+79001234567"
    },
    "Manager": {
      "Name": "Сидорова Анна"
    },
    "Comment": "Разгрузка с 9 до 18",
    "VatInPrice": true,
    "Products": [
      {
        "RowCode": "1",
        "Guid": "aa11bb22-0000-11ef-8d21-005056b6a111",
        "CharacteristicGuid": "cc33dd44-0000-11ef-8d21-005056b6a111",
        "CharacteristicName": "Колормикс, Сиена",
        "Name": "Тротуарная плитка, Новый Город, 60",
        "Unit": "м2",
        "Quantity": 120.5,
        "Price": 1450.00,
        "VatRate": 22,
        "ShipmentDate": "2026-11-20"
      },
      {
        "RowCode": "2",
        "Guid": "ee55ff66-0000-11ef-8d21-005056b6a111",
        "Name": "Поддон 1200*800",
        "Unit": "шт",
        "Quantity": 4,
        "Price": 350.00,
        "VatRate": 22,
        "ShipmentDate": "2026-11-20",
        "Canceled": true,
        "CancelReason": "Клиент отказался"
      },
      {
        "RowCode": "3",
        "Guid": "1b2c3d4e-0000-11ef-8d21-005056b6a111",
        "Name": "Доставка, рейс",
        "Unit": "рейс",
        "Quantity": 3,
        "Price": 9000.00,
        "VatRate": 22,
        "ShipmentDate": "2026-11-20"
      }
    ]
  }
}
Ответ: заявка заведена Цифра → 1С
{
  "success": true,
  "message": "Заявка заведена",
  "data_id": 123
}

Ответы по каждому коду — на вкладке Ответы и ошибки.

Коды ответов

Смотреть нужно КодСостояния: нынешняя процедура ПолучитьОтветAPI его отбрасывает.

Код Когда Что делает 1С
201Заявка заведенаПоставить признак «принят»
200Обновлено, изменений нет, закрыто или ничего не заведено (закрытый либо полностью отменённый при первой передаче)То же. Признак ставится и тут, повторы безвредны
207Принято с замечаниемПоставить признак, записать замечание в журнал, не повторять
422Не принятоПоказать причины менеджеру на заказе. Отправить при следующей правке или кнопкой. errors — текст для человека, не разбирать
403Ключ не найден, обмен отключён или остановленЗаписать в журнал, не повторять, проверить настройку
500, сеть, таймаутВнутренняя ошибкаПовторить автоматически; после 5 неудач показать менеджеру

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

Поле Тип Описание
successbooleanУспешность операции
messagestringСообщение о результате
data_idintegerНомер записи в журнале обмена
errorsarrayЗамечания или причины отказа

Замечания при ответе 207

  • Плохие координаты
  • Не найден менеджер
  • Незнакомая единица у заведённого по заказу изделия
  • У изделия нет техкарты на площадках воронки и оно не отмечено в Цифре как «Не производится»: заказ на производство по строке не создан, производству уведомление
  • Новая строка или прирост на повторе не заведены
  • Количество ниже отгруженного
  • Смена воронки не применена
  • Заказ на производство отменён в Цифре, строки по нему не применены
  • Позиция распределена в Цифре на несколько площадок, изменения по ней не применены

Причины ответа 422 при первой передаче

  • Нет обязательного поля или неверный формат
  • Адрес или его название длиннее 255 знаков
  • Воронка не найдена или не принимает заказ клиента (в списке у неё AcceptsCustomerOrder: false)
  • Заявка удалена в Цифре, а заказ на производство ещё действует
  • Повторяющийся RowCode
  • Нет адреса у доставки
  • Имя из стоп-листа
  • Изделие или контрагент не создаются
  • Ни одна площадка не называет срок по изделию с техкартой

Причина называет номер строки по порядку и наименование, а не RowCode: код пользователю не виден. О каждом отказе в Цифре приходит уведомление в колокольчик администратору аккаунта и начальникам производства площадок, связанных с воронкой.

Примечания
  • Если не хватает SecretKey или Data, в ответе 422 data_id равен null, errors нет
  • Текст ошибок проверки начинается с «Ошибки валидации: »
Доставка сообщений
  • Сообщения одного заказа отправляются строго по очереди, не параллельно
  • Повтор собирается заново из текущего состояния документа, а не из сохранённого снимка: снимок откатил бы более новые правки
  • Таймаут на стороне 1С — не меньше 120 секунд: Цифра в одном запросе проверяет сроки по всем площадкам

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

{
  "success": true,
  "message": "Заявка заведена",
  "data_id": 123
}
{
  "success": true,
  "message": "Заявка обновлена",
  "data_id": 123
}
{
  "success": true,
  "message": "Заявка обновлена",
  "data_id": 123,
  "errors": [
    "Менеджер «Сидорова Анна» не найден",
    "Строка 1 «Тротуарная плитка, Новый Город, 60»: нет техкарты, заказ на производство не создан",
    "Смена воронки не применена"
  ]
}

Тексты показывают вид ответа. errors — текст для человека, разбирать его нельзя.

{
  "success": false,
  "message": "Ошибки валидации: FunnelId: воронка не найдена; Delivery.Address: нет адреса у доставки; Строка 2 «Поддон 1200*800»: код строки повторяется",
  "data_id": 123,
  "errors": [
    "FunnelId: воронка не найдена",
    "Delivery.Address: нет адреса у доставки",
    "Строка 2 «Поддон 1200*800»: код строки повторяется"
  ]
}

Причины идут через «; » в message и списком в errors. Тексты показывают вид ответа. errors — текст для человека, разбирать его нельзя.

{
  "success": false,
  "message": "Ошибки валидации: Data: обязательное поле",
  "data_id": null
}
{
  "success": false,
  "message": "Секретный ключ не найден",
  "data_id": null
}
{
  "success": false,
  "message": "Произошла внутренняя ошибка",
  "data_id": 123
}

См. также