Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Создать заказ на доставку CREATE_DELIVERY_REQUEST_URL». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.
Создать заказ на доставку CREATE_DELIVERY_REQUEST_URL
Запрос отправляется на адрес указанный в CREATE_DELIVERY_REQUEST_URL при создании обработчика доставки в методе sale.delivery.handler.add.
Параметры запроса
Названиетип | Описание |
|---|---|
SHIPMENTSobject[] | Информация об отгрузках (подробное описание приведено ниже) |
Практические примеры использования в коде
Пример запроса JSON:
{
"SHIPMENTS":[
{
"ID":4063,
"DELIVERY_SERVICE":{
"ID":225,
"CONFIG":[
{
"CODE":"PROFILE_TYPE",
"VALUE":"CARGO"
}
],
"PARENT":{
"ID":223,
"CONFIG":[
{
"CODE":"SETTING_1",
"VALUE":"String Example Value"
}
]
}
},
"PRICE":179998,
"CURRENCY":"RUB",
"WEIGHT":600,
"PROPERTY_VALUES":[
{
"ID":100,
"TYPE":"ADDRESS",
"VALUE":{
"LATITUDE":55.726421,
"LONGITUDE":37.61187,
"FIELDS":{
"COUNTRY":"Россия",
"ADM_LEVEL_1":"Москва",
"ADM_LEVEL_2":"Москва",
"ADM_LEVEL_3":"Якиманка",
"LOCALITY":"Москва",
"SUB_LOCALITY_LEVEL_1":"Центральный административный округ",
"STREET":"улица Шаболовка",
"BUILDING":"9",
"ADDRESS_LINE_1":"улица Шаболовка, 9"
}
}
},
{
"ID":101,
"TYPE":"ADDRESS",
"VALUE":{
"LATITUDE":55.724779,
"LONGITUDE":37.614294,
"FIELDS":{
"POSTAL_CODE":"115162",
"COUNTRY":"Россия",
"ADM_LEVEL_1":"Москва",
"ADM_LEVEL_2":"район Якиманка",
"LOCALITY":"Москва",
"STREET":"улица Шаболовка",
"BUILDING":"13 с10",
"ADDRESS_LINE_1":"улица Шаболовка, 13 с10"
}
}
}
],
"ITEMS":[
{
"NAME":"iPhone 14",
"PRICE":89999,
"WEIGHT":300,
"CURRENCY":"RUB",
"QUANTITY":2,
"DIMENSIONS":{
"WIDTH":400,
"HEIGHT":80,
"LENGTH":500
}
}
],
"EXTRA_SERVICES_VALUES":[
{
"ID":138,
"CODE":"cargo_type",
"VALUE":"small_package"
},
{
"ID":137,
"CODE":"door_delivery",
"VALUE":"Y"
},
{
"ID":139,
"CODE":"some_quantity_service",
"VALUE":2
}
],
"RESPONSIBLE_CONTACT":{
"NAME":"Роман Горшков",
"PHONES":[
{
"TYPE":"MOBILE",
"VALUE":"+79097996161"
}
]
},
"RECIPIENT_CONTACT":{
"NAME":"Алексей Миронов",
"PHONES":[
{
"TYPE":"WORK",
"VALUE":"+79097996162"
}
]
}
}
]
}Параметры ответа
Названиетип | Описание |
|---|---|
SUCCESSstring | Индикатор успеха расчета стоимости доставки. Возможные значения: — |
REQUEST_IDstring | Идентификатор заказа на доставку, выдаваемый внешней системой |
REASONobject | Причина ошибки. Передается в случае неудачной попытки расчета стоимости (подробное описание приведено ниже) |
REASON
Названиетип | Описание |
|---|---|
TEXTstring | Описание ошибки |
Пример ответа с успешным созданием заказа на доставку
{
"SUCCESS": "Y",
"REQUEST_ID": "4757aca4931a4f029f49c0db4374d13d",
}Пример ответа с ошибкой при расчете стоимости
{
"SUCCESS": "N",
"REASON": {
"TEXT": "Delivery is not available for the specified address"
}
}- [](./index)
- [](./calculate)
- [](./cancel-delivery-request)
💡 Экспертное мнение и рекомендации
Практические рекомендации:
- При написании кастомных компонентов для «Создать заказ на доставку CREATE_DELIVERY_REQUEST_URL» всегда разделяйте бизнес-логику и представление (шаблон).
- Используйте отладку SQL-запросов через конструкцию
$wpdb->last_queryили стандартный трекер Битрикса, чтобы контролировать нагрузку.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru