В процессе интеграции информационных систем, таких как 1С, с внешними сервисами, например, с торговой площадкой Wildberries, часто возникают сложности, особенно при работе с различными версиями API. В этом руководстве мы подробно разберем типичные ошибки, которые могут возникнуть при выгрузке остатков товаров через Wildberries API версии 3, и покажем, как их эффективно устранить, используя примеры кода 1С. Мы рассмотрим проблемы, связанные с некорректным HTTP-методом, неверными кодами ответа, ошибками в идентификаторах складов и спецификой формирования URL-адресов запросов.
Наш пользователь столкнулся с проблемой при попытке перевести запросы на выгрузку остатков товаров на Wildberries на API версии 3. Изначально, код в 1С приводил к ошибке HTTP 400 Bad Request с сообщением "IncorrectRequest: Переданы некорректные данные". Давайте проанализируем исходный код, чтобы понять потенциальные причины этой ошибки.
Исходный фрагмент кода 1С, предназначенный для отправки данных об остатках, выглядел следующим образом:
Заголовки=новый Соответствие();
Заголовки.Вставить("Authorization",Токен);
Заголовки.Вставить("Content-Type","application/json");
Заголовки.Вставить("Accept","application/json");
SSL_Соединение=Новый ЗащищенноеСоединениеOpenSSL();
HttpСоединение=новый HttpСоединение("suppliers-api.wildberries.ru",443,,,,,SSL_Соединение);
Сервис="/api/v3/stocks/"+ИДскладаОЗОН_Строка+"";
МассивОстатков = Новый Массив;
Для Каждого Стр Из Остатки Цикл
СтруктураОстаткаТовара = Новый Структура("sku, amount", СокрЛП(Стр.ВБ_Штрихкод), Стр.КВыгрузке);
МассивОстатков.Добавить(СтруктураОстаткаТовара);
КонецЦикла;
ПараметрыЗапроса = Новый Структура;
ПараметрыЗапроса.Вставить("stocks", МассивОстатков);
ТелоЗапроса = Ozon_ОбщегоНазначенияВызовСервера.ПреобразоватьДанныеВJSON(ПараметрыЗапроса);
//Основной запрос
ИмяФайла = ПолучитьИмяВременногоФайла("json");
HTTPЗапрос=новый HttpЗапрос(сервис,заголовки);
HTTPЗапрос.УстановитьТелоИзСтроки(Ozon_ОбщегоНазначенияКлиентСервер.ПерекодироватьСтроку(ТелоЗапроса), КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
HttpОтвет=HTTPСоединение.ОтправитьДляОбработки(HTTPЗапрос,ИмяФайла);
На первый взгляд, код корректно формирует заголовки HTTP-запроса, создает JSON-структуру данных для остатков и использует защищенное соединение. Однако, при получении ошибки 400 Bad Request с описанием "Переданы некорректные данные" стоит обратить внимание на несколько ключевых аспектов:
GET, POST, PUT, DELETE) для различных операций. Метод HttpСоединение.ОтправитьДляОбработки() по умолчанию выполняет POST запрос. Wildberries API v3 для обновления остатков требует использования метода PUT. Это одно из наиболее частых заблуждений при переходе между версиями API или при работе с новыми конечными точками.ПреобразоватьДанныеВJSON работает правильно (она просто сериализует структуру 1С в JSON), всегда важно убедиться, что формируемая JSON-структура точно соответствует спецификации API. В данном случае ожидается массив объектов с полями sku (артикул продавца) и amount (количество).Сервис (`/api/v3/stocks/{warehouseId}`) указан без ошибок. В исходном коде использовалась переменная ИДскладаОЗОН_Строка, что было отмечено как потенциально вводящее в заблуждение, но на функциональность не влияло, если значение было правильным.В данном случае, критическим оказался первый пункт: неверный HTTP-метод. API Wildberries версии 3 для обновления остатков ожидает метод PUT, тогда как ОтправитьДляОбработки по умолчанию использует POST.
Для исправления проблемы 400 Bad Request, связанной с неверным HTTP-методом, нам необходимо явно указать метод PUT при отправке запроса. В 1С для этого используется метод ВызватьHTTPМетод() объекта HTTPСоединение.
Рассмотрим, как изменился код после внесения этих корректировок:
// ... (начало кода с заголовками и соединением аналогично) ...
Заголовки=новый Соответствие();
Заголовки.Вставить("Authorization",Токен);
Заголовки.Вставить("Content-Type","application/json");
Заголовки.Вставить("Accept","application/json");
SSL_Соединение=Новый ЗащищенноеСоединениеOpenSSL();
HttpСоединение=новый HttpСоединение("suppliers-api.wildberries.ru",443,,,,,SSL_Соединение);
// ... (формирование ТелаЗапроса аналогично) ...
// В этом примере Сервис хардкодится для теста, но должен быть динамическим
Сервис="/api/v3/stocks/99916662816000"; // Пример ID склада
ТекстЗапроса = "{""stocks"":[{""sku"":""9991365149650"",""amount"":50}]}"; // Пример JSON-строки
ИмяФайла = ПолучитьИмяВременногоФайла("json");
HTTPЗапрос=новый HttpЗапрос(Сервис, Заголовки);
HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
HTTPОтвет = HTTPСоединение.ВызватьHTTPМетод("PUT", HTTPЗапрос, ИмяФайла);
Мы видим, что вместо HttpОтвет=HTTPСоединение.ОтправитьДляОбработки(HTTPЗапрос,ИмяФайла); теперь используется HTTPОтвет = HTTPСоединение.ВызватьHTTPМетод("PUT", HTTPЗапрос, ИмяФайла);. Это является ключевым изменением для соответствия спецификации API Wildberries.
Одновременно с изменением метода, важно помнить об еще одном нюансе, характерном для операций PUT, особенно когда речь идет об обновлении ресурса без возврата содержимого. В случае успешного выполнения операции Wildberries API v3 для обновления остатков возвращает HTTP-статус 204 No Content, а не привычный 200 OK. Это означает, что сервер успешно обработал запрос, но не отправил в ответ никакого тела. Поэтому проверка успешности выполнения должна выглядеть так:
Если HTTPОтвет.КодСостояния = 204 Тогда
Сообщить ("Все удалось "+ HTTPОтвет.КодСостояния );
Иначе
Сообщить ("Ошибка выполнения запроса, код ошибки "+ HTTPОтвет.КодСостояния );
ЧтениеДжейсон = Новый ЧтениеJSON;
ЧтениеДжейсон.ОткрытьФайл(ИмяФайла); // Если сервер вернул тело ошибки
ДанныеОтвета = ПрочитатьJSON(ЧтениеДжейсон);
Сообщить(" Код ошибки: "+ ДанныеОтвета.code);
Сообщить(" Описание ошибки: "+ ДанныеОтвета.message);
КонецЕсли;
Таким образом, мы исправили HTTP-метод и корректно настроили проверку ответа сервера. Однако, как показали дальнейшие события, это не было единственной проблемой.
После успешного перехода на HTTP-метод PUT и обработки кода состояния 204, пользователь столкнулся с новой ошибкой: HTTP 404 Not Found с описанием "Не найдено". Эта ошибка указывает на то, что ресурс, к которому мы пытаемся обратиться, по указанному URL-адресу не существует или недоступен. В контексте запроса /api/v3/stocks/{warehouseId}, это почти всегда означает, что переданный warehouseId (идентификатор склада) является некорректным.
Давайте еще раз взглянем на фрагмент кода с ошибкой 404:
Сервер = "suppliers-api.wildberries.ru";
ИтоговыйЗапрос = "{""stocks"":[{""sku"":""9991365149650"",""amount"":50}]}";
URLЗапроса = "/api/v3/stocks/99916662816000"; // Здесь проблема
Соединение = Новый HTTPСоединение(Сервер,,,,,,Новый ЗащищенноеСоединениеOpenSSL);
HTTPЗапрос = Новый HTTPЗапрос("PUT");
HTTPЗапрос.АдресРесурса = URLЗапроса;
HTTPЗапрос.Заголовки.Вставить("accept", "application/json");
HTTPЗапрос.Заголовки.Вставить("Content-Type", "application/json");
HTTPЗапрос.Заголовки.Вставить("Authorization", Токен);
HTTPЗапрос.УстановитьТелоИзСтроки(ИтоговыйЗапрос, КодировкаТекста.UTF8,
ИспользованиеByteOrderMark.НеИспользовать);
HTTPОтвет = Соединение.ВызватьHTTPМетод("PUT", HTTPЗапрос);
В этом коде, часть URLЗапроса = "/api/v3/stocks/99916662816000"; содержит идентификатор склада 99916662816000. Как верно подсказали на форуме, идентификаторы складов Wildberries обычно имеют пятизначный формат. Представленный ID выглядит слишком длинным и нетипичным для идентификатора склада в системе Wildberries. Таким образом, наиболее вероятная причина ошибки 404 — это использование несуществующего или неправильного warehouseId. Чтобы успешно взаимодействовать с API, нам необходимо получить актуальный и правильный идентификатор склада.
Есть два основных способа получить корректный идентификатор склада Wildberries:
Поскольку наша задача — автоматизация через 1С, мы сосредоточимся на получении списка складов через API.
Для того чтобы получить актуальный список складов продавца и их идентификаторы, Wildberries предоставляет API-метод. На момент решения проблемы использовался метод /api/v2/warehouses. Обратимся к нему с помощью 1С.
Наш пользователь попытался получить список складов, но столкнулся с новой проблемой — ошибкой HTTP 301 Moved Permanently:
ЗаголовокHTTP = Новый Соответствие();
ЗаголовокHTTP.Вставить("accept", "application/json");
ЗаголовокHTTP.Вставить("Authorization", Токен);
URLЗапроса = "/api/v2/warehouses/"; // Проблема здесь
Соединение = Новый HTTPСоединение(Сервер,,,,,,Новый ЗащищенноеСоединениеOpenSSL);
HTTPЗапрос = Новый HTTPЗапрос(URLЗапроса, ЗаголовокHTTP);
HTTPОтвет = Соединение.Получить(HTTPЗапрос); // Для GET запросов
Если HTTPОтвет.КодСостояния = 200 Тогда ///Успешно получен ответ
ДанныеОбработки = HTTPОтвет.ПолучитьТелоКакСтроку();
КонецЕсли;
Ошибка 301 Moved Permanently означает, что запрашиваемый ресурс был перемещен на новый URL-адрес. В большинстве случаев, когда API возвращает 301, это связано с некорректным оформлением URL-адреса, чаще всего — с наличием лишнего слэша в конце. Именно это и произошло в данном случае. URL /api/v2/warehouses/ (со слэшем в конце) воспринимался сервером как отличающийся от ожидаемого /api/v2/warehouses (без слэша).
Для исправления этой проблемы нам достаточно убрать лишний слэш из URL-адреса запроса:
ЗаголовокHTTP = Новый Соответствие();
ЗаголовокHTTP.Вставить("accept", "application/json");
ЗаголовокHTTP.Вставить("Authorization", Токен);
URLЗапроса = "/api/v2/warehouses"; // Исправлено: убран лишний слэш
Сервер = "suppliers-api.wildberries.ru"; // Убедитесь, что сервер определен
Соединение = Новый HTTPСоединение(Сервер,,,,,,Новый ЗащищенноеСоединениеOpenSSL);
HTTPЗапрос = Новый HTTPЗапрос(URLЗапроса, ЗаголовокHTTP);
HTTPОтвет = Соединение.Получить(HTTPЗапрос); // Используем Получить для GET запроса
Если HTTPОтвет.КодСостояния = 200 Тогда ///Успешно получен ответ
ДанныеОбработки = HTTPОтвет.ПолучитьТелоКакСтроку();
// Далее необходимо распарсить JSON-ответ и извлечь warehouseId
ЧтениеДжейсон = Новый ЧтениеJSON;
ЧтениеДжейсон.УстановитьСтроку(ДанныеОбработки);
СписокСкладов = ПрочитатьJSON(ЧтениеДжейсон); // Получим массив структур или соответствий
// Например, если СписокСкладов - это массив, и первый элемент содержит id:
Если СписокСкладов.Количество() > 0 Тогда
ПравильныйИДСклада = СписокСкладов[0].id; // Предполагая, что поле с ID называется 'id'
Сообщить("Получен ID склада: " + ПравильныйИДСклада);
КонецЕсли;
Иначе
Сообщить("Ошибка при получении списка складов, код: " + HTTPОтвет.КодСостояния);
// Дополнительная обработка ошибок, если есть тело ответа
Если HTTPОтвет.ПолучитьТелоКакСтроку() <> "" Тогда
Сообщить("Текст ошибки: " + HTTPОтвет.ПолучитьТелоКакСтроку());
КонецЕсли;
КонецЕсли;
После этого исправления пользователь успешно получил список складов и, соответственно, корректные идентификаторы. Важно извлечь из полученного JSON-ответа необходимый warehouseId и использовать его для дальнейших запросов на обновление остатков.
Последовательно устранив все возникшие проблемы, мы можем сформировать окончательный, рабочий вариант кода для выгрузки остатков на Wildberries API v3 из 1С. Мы объединим все знания, полученные в ходе анализа и исправления ошибок.
Разберем по шагам итоговое решение:
Authorization, Content-Type и Accept.warehouseId): Это критически важный шаг. Мы должны программно запросить список складов или убедиться, что используем правильный ID, полученный из личного кабинета.sku (артикул продавца) и amount (количество).PUT: Используем HTTPСоединение.ВызватьHTTPМетод("PUT", HTTPЗапрос);.204 No Content для успешного выполнения.Представим полный пример рабочего кода, который включает все необходимые шаги и исправления:
// --- 1. Инициализация и получение токена ---
// Допустим, переменная Токен уже содержит ваш Wildberries API токен
// Токен = "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9....";
// --- 2. Установка параметров HTTP-соединения и заголовков ---
Сервер = "suppliers-api.wildberries.ru";
Заголовки = Новый Соответствие();
Заголовки.Вставить("Authorization", Токен);
Заголовки.Вставить("Content-Type", "application/json");
Заголовки.Вставить("Accept", "application/json");
SSL_Соединение = Новый ЗащищенноеСоединениеOpenSSL();
HttpСоединение = Новый HttpСоединение(Сервер, 443,,,,, SSL_Соединение);
// --- 3. Получение корректного идентификатора склада (warehouseId) ---
// Этот блок кода можно выполнить один раз и сохранить ID склада,
// если он не меняется часто, или кэшировать его.
Перем ИДСкладаВБ;
URLЗапросаДляСкладов = "/api/v2/warehouses";
HTTPЗапросСкладов = Новый HTTPЗапрос(URLЗапросаДляСкладов, Заголовки); // Заголовки те же, но Content-Type для GET не обязателен
HTTPОтветСкладов = HttpСоединение.Получить(HTTPЗапросСкладов);
Если HTTPОтветСкладов.КодСостояния = 200 Тогда
СтрокаОтветаСкладов = HTTPОтветСкладов.ПолучитьТелоКакСтроку();
ЧтениеДжейсонСкладов = Новый ЧтениеJSON;
ЧтениеДжейсонСкладов.УстановитьСтроку(СтрокаОтветаСкладов);
СписокСкладов = ПрочитатьJSON(ЧтениеДжейсонСкладов); // Ожидаем массив складов
ЧтениеДжейсонСкладов.Закрыть();
Если ТипЗнч(СписокСкладов) = Тип("Массив") И СписокСкладов.Количество() > 0 Тогда
// Выбираем первый склад или находим нужный по имени/другим критериям
ИДСамогоПервогоСклада = СписокСкладов[0].id; // Предполагаем, что поле id существует
ИДСамогоПервогоСклада_Строка = Строка(ИДСамогоПервогоСклада);
Сообщить("Успешно получен ID склада Wildberries: " + ИДСамогоПервогоСклада_Строка);
ИДСкладаВБ = ИДСамогоПервогоСклада_Строка;
Иначе
Сообщить("Ошибка: Список складов пуст или имеет некорректный формат.");
Возврат;
КонецЕсли;
Иначе
Сообщить("Ошибка при получении списка складов. Код: " + HTTPОтветСкладов.КодСостояния);
Сообщить("Ответ сервера: " + HTTPОтветСкладов.ПолучитьТелоКакСтроку());
Возврат;
КонецЕсли;
// --- 4. Формирование тела запроса для обновления остатков ---
МассивОстатковДляВыгрузки = Новый Массив;
// Заполнение МассивОстатковДляВыгрузки данными из вашей 1С базы
// Например:
// Для Каждого Стр Из ТаблицаОстатков Цикл
// СтруктураОстаткаТовара = Новый Структура("sku, amount", Стр.АртикулWildberries, Стр.КоличествоОстатка);
// МассивОстатковДляВыгрузки.Добавить(СтруктураОстаткаТовара);
// КонецЦикла;
// Для примера используем тестовые данные:
СтруктураОстаткаТовара1 = Новый Структура("sku, amount", "9991365149650", 50);
МассивОстатковДляВыгрузки.Добавить(СтруктураОстаткаТовара1);
СтруктураОстаткаТовара2 = Новый Структура("sku, amount", "9991365149651", 100);
МассивОстатковДляВыгрузки.Добавить(СтруктураОстаткаТовара2);
ПараметрыЗапросаОстатков = Новый Структура;
ПараметрыЗапросаОстатков.Вставить("stocks", МассивОстатковДляВыгрузки);
// Используем функцию для преобразования в JSON (из сообщения 2)
// Если функция Ozon_ОбщегоНазначенияВызовСервера.ПреобразоватьДанныеВJSON находится в другом месте,
// убедитесь, что она доступна.
Функция ПреобразоватьДанныеВJSON(Данные) Экспорт
Результат = "";
Попытка
ЗаписьJSON = Новый ЗаписьJSON;
ПараметрыЗаписиJSON = Новый ПараметрыЗаписиJSON(ПереносСтрокJSON.Нет, " ", Истина);
НастройкиСериализации = Новый НастройкиСериализацииJSON;
НастройкиСериализации.ФорматСериализацииДаты = ФорматДатыJSON.ISO;
НастройкиСериализации.ВариантЗаписиДаты = ВариантЗаписиДатыJSON.УниверсальнаяДата;
ЗаписьJSON.УстановитьСтроку(ПараметрыЗаписиJSON);
ЗаписатьJSON(ЗаписьJSON, Данные, НастройкиСериализации);
Результат = ЗаписьJSON.Закрыть();
Исключение
Сообщить("Не удалось записать JSON: " + ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()));
КонецПопытки;
Возврат Результат;
КонецФункции
ТелоЗапросаОстатков = ПреобразоватьДанныеВJSON(ПараметрыЗапросаОстатков);
// --- 5. Выполнение HTTP-запроса методом PUT для обновления остатков ---
URLДляОбновленияОстатков = "/api/v3/stocks/" + ИДСкладаВБ;
HTTPЗапросОстатков = Новый HTTPЗапрос(URLДляОбновленияОстатков, Заголовки);
HTTPЗапросОстатков.УстановитьТелоИзСтроки(ТелоЗапросаОстатков, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
// --- 6. Отправка запроса и проверка кода состояния ---
HTTPОтвет = HttpСоединение.ВызватьHTTPМетод("PUT", HTTPЗапросОстатков);
Если HTTPОтвет.КодСостояния = 204 Тогда
Сообщить("Остатки успешно обновлены на Wildberries. Код состояния: " + HTTPОтвет.КодСостояния);
Иначе
Сообщить("Ошибка при обновлении остатков на Wildberries. Код: " + HTTPОтвет.КодСостояния);
СтрокаОтветаОшибки = HTTPОтвет.ПолучитьТелоКакСтроку();
Если СтрокаОтветаОшибки <> "" Тогда
Попытка
ЧтениеДжейсонОшибки = Новый ЧтениеJSON;
ЧтениеДжейсонОшибки.УстановитьСтроку(СтрокаОтветаОшибки);
ДанныеОтветаОшибки = ПрочитатьJSON(ЧтениеДжейсонОшибки);
Сообщить(" Код ошибки: " + ДанныеОтветаОшибки.code);
Сообщить(" Описание ошибки: " + ДанныеОтветаОшибки.message);
ЧтениеДжейсонОшибки.Закрыть();
Исключение
Сообщить(" Не удалось распарсить ответ об ошибке: " + СтрокаОтветаОшибки);
КонецПопытки;
КонецЕсли;
КонецЕсли;
В этом коде мы сначала получаем действительный ID склада, затем формируем JSON-тело запроса с остатками и отправляем его методом PUT, ожидая в ответ код 204.
Для успешной и стабильной работы с Wildberries API из 1С, помимо решения конкретных проблем, связанных с HTTP-методами и URL-адресами, мы рекомендуем придерживаться следующих лучших практик:
Новый ЗащищенноеСоединениеOpenSSL() при работе с HTTPS, чтобы обеспечить безопасную передачу данных. Это является стандартом для взаимодействия с большинством современных API.400 Bad Request. Используйте функции 1С ЗаписьJSON и ЗаписатьJSON для корректной сериализации данных.400, 404 и 301, вы можете столкнуться с другими кодами, такими как 401 Unauthorized (неверный токен), 403 Forbidden (недостаточно прав), 429 Too Many Requests (превышен лимит запросов) или 5xx Server Error (проблемы на стороне сервера Wildberries). Всегда обрабатывайте эти коды и логируйте ответы сервера для быстрого выявления проблем.Следуя этим рекомендациям и подробно разбирая каждую ошибку, вы сможете построить надежную и эффективную интеграцию 1С с Wildberries API, обеспечивая актуальность ваших данных на торговой площадке.