Как настроить обмен с Ozon API из 1С и исправить ошибку HTTP 400 при обновлении остатков?

Интеграция учетной системы 1С с маркетплейсом Ozon — это стандартная задача для современной торговли. Синхронизация остатков в реальном времени позволяет избежать штрафов за отмену заказов и поддерживать актуальность данных на витрине. Однако при разработке механизма обмена программисты часто сталкиваются с ошибкой HTTP 400 (Bad Request). В этой статье мы подробно разберем правильный алгоритм синхронизации остатков, напишем работающий код на языке 1С и выясним основные причины возникновения ошибок валидации запросов. Чтобы не разрабатывать решение самостоятельно, можно применить готовое расширение для интеграции 1С с Ozon по схеме FBS.

Общий алгоритм синхронизации остатков

Прежде чем приступать к написанию кода, давайте проанализируем базовую схему взаимодействия систем. Процесс обновления остатков на стороне маркетплейса состоит из следующих последовательных шагов:

1. Получение списка товаров из Ozon: Нам необходимо получить перечень позиций, которые размещены в личном кабинете продавца. Для этого используется метод получения списка продуктов.
2. Сопоставление номенклатуры: Мы должны сопоставить позиции из Ozon с нашей внутренней номенклатурой в 1С. Обычно сопоставление выполняется по уникальному артикулу (в терминологии Ozon это поле offer_id).
3. Получение актуальных остатков в 1С: На основе сопоставленных данных мы рассчитываем реальные складские остатки в нашей базе данных.
4. Передача данных на маркетплейс: Мы формируем JSON-пакет с актуальными остатками и отправляем его на Ozon методом POST.

Почему возникает ошибка HTTP 400 при обновлении остатков?

Код состояния 400 означает, что сервер Ozon отклонил наш запрос из-за некорректного формата данных. Выделим ключевые технические нюансы, которые чаще всего приводят к этой ошибке при отправке запросов из 1С:

• Использование устаревшего метода API: Многие старые обработки используют метод /v1/product/import/stocks. Если у вас в кабинете Ozon настроено несколько складов (например, для схемы rFBS), этот метод вернет ошибку 400. Необходимо использовать актуальный метод /v2/products/stocks.
• Нарушение типов данных в JSON: Сервер Ozon жестко проверяет типы данных в пакете. Идентификатор склада warehouse_id должен передаваться строго как число (целое число int64), а не как строка. Если в 1С этот реквизит записан как строка (например, "1234567"), Ozon вернет ошибку валидации схемы. Аналогично, остаток stock должен быть числом, а артикул offer_id — строкой.
• Превышение лимита элементов в пакете: Метод обновления остатков v2 накладывает ограничение — в одном HTTP-запросе разрешено передавать не более 100 позиций. Если ваша обработка пытается выгрузить сразу 150 товаров одним пакетом, сервер вернет ошибку 400 и отклонит всю операцию. Нам нужно реализовать порционную отправку пакетов (пагинацию).
• Регистрозависимость параметров: Все имена ключей в JSON-структуре должны строго соответствовать документации. Ошибка в регистре (например, Warehouse_id вместо warehouse_id) гарантированно приведет к сбою.

Реализация отправки остатков на языке 1С

Рассмотрим детальный пример функции на языке 1С, которая формирует JSON-пакет по требованиям Ozon API v2 и отправляет его на сервер. Обратите внимание на правильную сериализацию типов данных и установку кодировки. В качестве готовой альтернативы программированию вручную можно использовать внешнюю обработку для обновления цен и остатков на Ozon.

// Функция отправляет актуальные остатки товаров на Ozon API v2
Функция ОбновитьОстаткиНаOzon(МассивТоваров, НастройкиПодключения) Экспорт
    
    // Параметры НастройкиПодключения должны содержать:
    // - ClientId (строка)
    // - ApiKey (строка)
    // - WarehouseId (число или строка, содержащая только цифры)
    
    // Проверим, что массив содержит элементы и не превышает лимит в 100 позиций
    Если МассивТоваров.Количество() = 0 Тогда
        ЗаписьЖурналаРегистрации("Ozon API", УровеньЖурналаРегистрации.Предупреждение,, "Массив товаров пуст.");
        Возврат Ложь;
    ИначеЕсли МассивТоваров.Количество() > 100 Тогда
        ЗаписьЖурналаРегистрации("Ozon API", УровеньЖурналаРегистрации.Ошибка,, "Превышен лимит позиций в одном запросе (макс. 100).");
        Возврат Ложь;
    КонецЕсли;
    
    // Шаг 1. Формируем структуру JSON-запроса
    ЗаписьJSON = Новый ЗаписьJSON;
    ЗаписьJSON.УстановитьСтроку();
    
    ЗаписьJSON.ЗаписатьНачалоОбъекта();
    ЗаписьJSON.ЗаписатьИмяСвойства("stocks");
    ЗаписьJSON.ЗаписатьНачалоМассива();
    
    Для Каждого СтрокаТовара Из МассивТоваров Цикл
        ЗаписьJSON.ЗаписатьНачалоОбъекта();
        
        // Артикул товара (обязательно строка)
        ЗаписьJSON.ЗаписатьИмяСвойства("offer_id");
        ЗаписьJSON.ЗаписатьЗначение(Строка(СтрокаТовара.Артикул));
        
        // Идентификатор склада (обязательно целое число)
        ЗаписьJSON.ЗаписатьИмяСвойства("warehouse_id");
        ЗаписьJSON.ЗаписатьЗначение(Число(НастройкиПодключения.WarehouseId));
        
        // Количество товара на складе (обязательно число)
        ЗаписьJSON.ЗаписатьИмяСвойства("stock");
        ЗаписьJSON.ЗаписатьЗначение(Число(СтрокаТовара.Количество));
        
        ЗаписьJSON.ЗаписатьКонецОбъекта();
    КонецЦикла;
    
    ЗаписьJSON.ЗаписатьКонецМассива();
    ЗаписьJSON.ЗаписатьКонецОбъекта();
    
    СтрокаJSON = ЗаписьJSON.Закрыть();
    
    // Шаг 2. Настраиваем HTTP-соединение с защитой SSL
    Сервер = "api-seller.ozon.ru";
    Защита = Новый ЗащищенноеСоединениеOpenSSL();
    HTTPСоединение = Новый HTTPСоединение(Сервер,,,,,, Защита);
    
    // Шаг 3. Подготавливаем POST-запрос
    Ресурс = "/v2/products/stocks";
    HTTPЗапрос = Новый HTTPЗапрос(Ресурс);
    
    // Устанавливаем обязательные заголовки авторизации и типа контента
    HTTPЗапрос.Заголовки.Вставить("Client-Id", НастройкиПодключения.ClientId);
    HTTPЗапрос.Заголовки.Вставить("Api-Key", НастройкиПодключения.ApiKey);
    HTTPЗапрос.Заголовки.Вставить("Content-Type", "application/json");
    
    // Преобразуем JSON в двоичные данные, явно указав кодировку UTF-8 без BOM
    HTTPЗапрос.УстановитьТелоИзСтроки(СтрокаJSON, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
    
    // Шаг 4. Отправляем запрос и анализируем ответ
    Попытка
        HTTPОтвет = HTTPСоединение.ОтправитьДляОбработки(HTTPЗапрос);
        КодCостояния = HTTPОтвет.КодСостояния;
        ТекстОтвета = HTTPОтвет.ПолучитьТелоКакСтроку(КодировкаТекста.UTF8);
        
        Если КодCостояния = 200 Тогда
            ЗаписьЖурналаРегистрации("Ozon API", УровеньЖурналаРегистрации.Информация,, "Остатки успешно обновлены: " + ТекстОтвета);
            Возврат Истина;
        Иначе
            ЗаписьЖурналаРегистрации("Ozon API", УровеньЖурналаРегистрации.Ошибка,, "Ошибка обновления остатков. Код ответа: " + КодCостояния + ". Ответ: " + ТекстОтвета);
            Возврат Ложь;
        КонецЕсли;
    Исключение
        ЗаписьЖурналаРегистрации("Ozon API", УровеньЖурналаРегистрации.Ошибка,, "Ошибка сетевого соединения: " + ОписаниеОшибки());
        Возврат Ложь;
    КонецПопытки;
    
КонецФункции

Как эффективно отлаживать запросы к Ozon API?

Если в процессе разработки вы продолжаете получать ошибку 400, воспользуйтесь следующими проверенными методами отладки:

1. Логирование отправляемых данных: Перед вызовом метода HTTPСоединение.ОтправитьДляОбработки() сохраняйте сформированную строку JSON во временный текстовый файл или записывайте ее в Журнал регистрации. Это позволит вам увидеть реальную структуру пакета, отправляемого из 1С.
2. Проверка через Postman: Скопируйте полученную из лога 1С строку JSON и вставьте ее в программу Postman. Настройте аналогичные заголовки (Client-Id, Api-Key, Content-Type) и выполните POST-запрос. Postman возвращает детализированный ответ от Ozon, где будет указано конкретное поле, не прошедшее валидацию.
3. Контроль кодировки: Убедитесь, что кириллические символы в артикулах передаются в кодировке UTF-8. Использование неправильной кодировки приведет к искажению JSON-структуры и ошибке разбора на стороне маркетплейса.

Рекомендации по оптимизации обмена данными

Для создания отказоустойчивой системы интеграции рекомендуем внедрить следующие архитектурные решения:

• Соблюдение лимитов запросов (Rate Limits): Серверы Ozon накладывают ограничения на частоту отправки запросов (обычно не более 80 обращений в минуту для изменения остатков). Не следует отправлять остатки поштучно при каждом изменении документа в 1С. Лучше накапливать изменения в специальном регистре сведений и отправлять их пакетно (порциями по 100 товаров) каждые 10–15 минут с помощью регламентного задания.
• Защита от оверселла (страховочный буфер): В моменты высокой нагрузки на серверы Ozon обновление остатков может происходить с задержкой в несколько минут. Чтобы избежать ситуации, когда товар купят одновременно на нескольких складах, настройте в 1С страховочный лимит. Например, если реальный остаток в 1С равен 1 или 2 штукам, отправляйте на Ozon значение 0.
• Контроль статуса модерации: Не пытайтесь выгружать остатки по позициям, которые еще не прошли модерацию на маркетплейсе или заблокированы. Перед обновлением остатков убедитесь, что товар имеет активный статус в личном кабинете.

Применяя данные подходы и контролируя типы передаваемых полей в JSON, вы сможете построить надежную и быструю интеграцию вашей системы 1С с Ozon API без досадных ошибок валидации. Чтобы не разрабатывать механизм с нуля в УТ 11, КА 2 или ERP 2, можно настроить интеграцию 1С с Ozon, Wildberries и Яндекс.Маркетом.