Блог Горошко Андрея 1C-Битрикс,Bitrix24 Создать заказ на доставку CREATE_DELIVERY_REQUEST_URL

Создать заказ на доставку CREATE_DELIVERY_REQUEST_URL

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Создать заказ на доставку CREATE_DELIVERY_REQUEST_URL». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

Создать заказ на доставку CREATE_DELIVERY_REQUEST_URL

Запрос отправляется на адрес указанный в CREATE_DELIVERY_REQUEST_URL при создании обработчика доставки в методе sale.delivery.handler.add.

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

Название
тип
Описание
SHIPMENTS
object[]
Информация об отгрузках (подробное описание приведено ниже)

Практические примеры использования в коде

Пример запроса 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"
                    }
                ]
            }
        }
    ]
}

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

Название
тип
Описание
SUCCESS
string
Индикатор успеха расчета стоимости доставки. Возможные значения:

— Y — стоимость успешно рассчитана
— N — произошла ошибка при попытке расчета стоимости

REQUEST_ID
string
Идентификатор заказа на доставку, выдаваемый внешней системой
REASON
object
Причина ошибки. Передается в случае неудачной попытки расчета стоимости (подробное описание приведено ниже)

REASON

Название
тип
Описание
TEXT
string
Описание ошибки

Пример ответа с успешным созданием заказа на доставку

{
    "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 и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Настройка автогенерации карты сайта sitemap.xml для каталогов с 500 000+ товаровНастройка автогенерации карты сайта sitemap.xml для каталогов с 500 000+ товаров

Профессиональная поддержка, модернизация и оптимизация производительности сайта на 1С-Битрикс — это гарантия высокой конверсии, стабильности продаж и защиты от киберугроз. Услуга «Настройка автогенерации карты сайта sitemap.xml для каталогов с 500

Добавить задачу task.item.addДобавить задачу task.item.add

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Добавить задачу task.item.add», проанализируем лучшие практики и покажем,

Получить список предложений по фильтру crm.quote.listПолучить список предложений по фильтру crm.quote.list

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Получить список предложений по фильтру crm.quote.list». Мы подготовили подробный разбор принципов работы и развернутые примеры