Заказ клиента в воронку
Передача заказа клиента из 1С в производственную воронку Цифры: по заказу ведётся заявка в CRM.
Отправляет расширение 1С при каждом изменении заказа со статусом «К выполнению» или «К отгрузке» и при переходе в «Закрыт».
Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
SecretKey | string | Да | Секретный ключ |
Data | object | Да | Заказ клиента |
- Одно сообщение — один заказ:
Dataпередаётся объектом, массив даёт отказ,TaskIdне передаётся - Сообщение всегда несёт весь заказ текущим состоянием, включая отменённые строки
- Номер воронки (
FunnelId) берётся из списка воронок: подходит воронка сAcceptsCustomerOrder: true
Структура Data
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
Guid | string | Да | Постоянный идентификатор заказа |
Number | string | Да | Номер заказа |
Date | string | Да | Дата заказа |
Status | string | Да | Состояние заказа |
FunnelId | integer | Да | Номер воронки из списка |
Client |
Да | Контрагент | |
Contract |
Нет | Договор | |
DeliveryType | string | Нет | Способ получения |
Delivery |
Условно | Адрес доставки | |
Contact |
Нет | Контактное лицо | |
Manager |
Нет | Менеджер заказа | |
Comment | string | Нет | Комментарий |
VatInPrice | boolean | Да | Цена включает НДС |
Products |
Да | Строки заказа |
Guidзаказа постоянный: по нему повторная передача находит заявкуNumberиDateвидны в уведомлениях;DateиShipmentDateпередаются в форматеYYYY-MM-DDStatus:active— заказ в работе,closed— закрытClient.Guid— по нему Цифра находит контрагента;Client.Nameнужен, если контрагента придётся завестиContract: если блок передан, обязательны оба поля —GuidиNameDeliveryType:deliveryилиtake-away, по умолчаниюdeliveryDelivery.Addressобязателен при доставке; приtake-awayне передаётся- Координаты (
Latitude/Longitude) — разделитель точка; нулевые координаты не передаются Contact: если блок передан, обязательны оба поля —NameиPhone; контакт без телефона не передаётсяManager.Nameищется среди сотрудников точным совпадением ФИОProducts— хотя бы одна строка, в порядке табличной частиRowCodeсвязывает строку между передачами и единственен внутри заказаCharacteristicGuid: пустую ссылку не передавать.CharacteristicName(например, цвет) передаётся вместе сCharacteristicGuidNameстроки — наименование без характеристикиUnitиспользуется, если изделие заводится по заказуQuantity— в единице хранения, до 3 знаков после запятойPrice— со всеми скидками, до 2 знаков после запятой, включает НДС по правилуVatInPriceVatRate— в процентах: 22, 10, 0. Без НДС — 0Canceledпо умолчаниюfalseCancelReasonвидна производственнику. Не передана — в Цифре будет «Причина не указана в 1С»
Откуда брать значения в 1С
| Поле | Значение в 1С |
|---|---|
Guid | XMLСтрока(Ссылка) |
Number | Номер |
Date | Формат(Дата, "ДФ=yyyy-MM-dd") |
Status | КОбеспечению («К выполнению») и КОтгрузке → active, Закрыт → closed. НеСогласован не отправляется |
FunnelId | Настройка расширения |
Client.Guid | XMLСтрока(Контрагент), как в выгрузке контрагентов |
Client.Name | Как в выгрузке контрагентов |
Client.Inn | Контрагент.ИНН |
Contract.Guid, Contract.Name | XMLСтрока(Соглашение) и его наименование: то, что расширение уже выгружает как договор. Не реквизит Договор |
DeliveryType | Перевод из СпособДоставки расширением |
Delivery.Address | АдресДоставки |
Delivery.Name | манг_ОбъектСтроительства.Наименование, если заказ по объекту |
Delivery.Latitude, Delivery.Longitude | манг_ОбъектСтроительства.КоординатыШирота, .КоординатыДолгота |
Contact.Name, Contact.Phone | КонтактноеЛицо.Наименование; телефон из КонтактнаяИнформация, запросом как в выгрузке контрагентов |
Manager.Name | Менеджер.Наименование |
Comment | Комментарий |
VatInPrice | ЦенаВключаетНДС |
Products | Товары |
RowCode | Формат(КодСтроки, "ЧГ=0") |
Products[].Guid | XMLСтрока(Номенклатура), как в выгрузке номенклатуры |
CharacteristicGuid | XMLСтрока(Характеристика), если заполнена |
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. - Пометка на удаление не обрабатывается и не отправляется.
{
"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"
}
]
}
}
{
"success": true,
"message": "Заявка заведена",
"data_id": 123
}
Ответы по каждому коду — на вкладке Ответы и ошибки.
Коды ответов
Смотреть нужно КодСостояния: нынешняя процедура ПолучитьОтветAPI его отбрасывает.
| Код | Когда | Что делает 1С |
|---|---|---|
| 201 | Заявка заведена | Поставить признак «принят» |
| 200 | Обновлено, изменений нет, закрыто или ничего не заведено (закрытый либо полностью отменённый при первой передаче) | То же. Признак ставится и тут, повторы безвредны |
| 207 | Принято с замечанием | Поставить признак, записать замечание в журнал, не повторять |
| 422 | Не принято | Показать причины менеджеру на заказе. Отправить при следующей правке или кнопкой. errors — текст для человека, не разбирать |
| 403 | Ключ не найден, обмен отключён или остановлен | Записать в журнал, не повторять, проверить настройку |
| 500, сеть, таймаут | Внутренняя ошибка | Повторить автоматически; после 5 неудач показать менеджеру |
Структура ответа
| Поле | Тип | Описание |
|---|---|---|
success | boolean | Успешность операции |
message | string | Сообщение о результате |
data_id | integer | Номер записи в журнале обмена |
errors | array | Замечания или причины отказа |
Замечания при ответе 207
- Плохие координаты
- Не найден менеджер
- Незнакомая единица у заведённого по заказу изделия
- У изделия нет техкарты на площадках воронки и оно не отмечено в Цифре как «Не производится»: заказ на производство по строке не создан, производству уведомление
- Новая строка или прирост на повторе не заведены
- Количество ниже отгруженного
- Смена воронки не применена
- Заказ на производство отменён в Цифре, строки по нему не применены
- Позиция распределена в Цифре на несколько площадок, изменения по ней не применены
Причины ответа 422 при первой передаче
- Нет обязательного поля или неверный формат
- Адрес или его название длиннее 255 знаков
- Воронка не найдена или не принимает заказ клиента (в списке у неё
AcceptsCustomerOrder: false) - Заявка удалена в Цифре, а заказ на производство ещё действует
- Повторяющийся
RowCode - Нет адреса у доставки
- Имя из стоп-листа
- Изделие или контрагент не создаются
- Ни одна площадка не называет срок по изделию с техкартой
Причина называет номер строки по порядку и наименование, а не RowCode: код пользователю не виден. О каждом отказе в Цифре приходит уведомление в колокольчик администратору аккаунта и начальникам производства площадок, связанных с воронкой.
- Если не хватает
SecretKeyилиData, в ответе 422data_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
}