From 1d03316274c77444ec0e08c65ecb49eebb7de0fe Mon Sep 17 00:00:00 2001 From: Anton Titovets Date: Fri, 30 Aug 2024 10:23:13 +0300 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=BA=D0=B8=20Ozon?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../en/cli/Ozon/CheckProductsImagesUpload.txt | 1 + docs/en/cli/Ozon/GetProductsInformation.txt | 1 + docs/en/cli/Ozon/UpdateProductImages.txt | 1 + docs/en/cli/Ozon/UpdateProductsArticles.txt | 1 + .../Bitrix24/Deals-managment/Create-deal.md | 14 +- .../Bitrix24/Deals-managment/Delete-deal.md | 14 +- .../Deals-managment/Get-deal-structure.md | 433 +++++++++++++++++- .../md/Bitrix24/Deals-managment/Get-deal.md | 59 ++- .../Get-deals-filter-structure.md | 28 +- .../Deals-managment/Get-deals-list.md | 15 +- .../Bitrix24/Deals-managment/Update-deal.md | 14 +- .../Get-products-requests-limits.md | 17 +- .../Add-product-video-cover.md | 2 +- .../Add-product-video.md | 2 +- .../Check-products-images-upload.md | 76 +++ .../Complete-complex-attribute.md | 2 +- .../Get-attributes-update-structure.md | 7 +- .../Get-product-creation-status.md | 2 +- .../Get-product-description.md | 9 +- .../Get-product-information.md | 55 --- .../Get-product-list.md | 17 +- .../Get-product-structure.md | 2 +- .../Get-products-content-rating.md | 131 +++++- .../Get-products-filter-structure.md | 8 +- .../Get-products-information.md | 141 ++++++ .../Get-simplified-product-structure.md | 12 +- .../Update-product-images.md | 99 ++++ .../Update-products-articles.md | 51 +++ .../Update-products-attributes.md | 4 +- docs/ru/cli/Ozon/ИзменитьАртикулыТоваров.txt | 1 + .../ru/cli/Ozon/ОбновитьИзображенияТовара.txt | 1 + .../cli/Ozon/ПолучитьИнформациюОТоварах.txt | 1 + .../ПроверитьЗагрузкуИзображенийТоваров.txt | 1 + .../Add-product-video-cover.md | 2 +- .../Add-product-video.md | 2 +- .../Check-products-images-upload.md | 76 +++ .../Complete-complex-attribute.md | 2 +- .../Get-attributes-update-structure.md | 2 +- .../Get-product-creation-status.md | 2 +- .../Get-product-information.md | 137 ------ .../Get-product-structure.md | 2 +- .../Get-products-filter-structure.md | 2 +- .../Get-products-information.md | 141 ++++++ .../Get-simplified-product-structure.md | 2 +- .../Update-product-images.md | 99 ++++ .../Update-products-articles.md | 51 +++ 46 files changed, 1519 insertions(+), 223 deletions(-) create mode 100644 docs/en/cli/Ozon/CheckProductsImagesUpload.txt create mode 100644 docs/en/cli/Ozon/GetProductsInformation.txt create mode 100644 docs/en/cli/Ozon/UpdateProductImages.txt create mode 100644 docs/en/cli/Ozon/UpdateProductsArticles.txt create mode 100644 docs/en/md/Ozon/Uploading-and-updating-products/Check-products-images-upload.md delete mode 100644 docs/en/md/Ozon/Uploading-and-updating-products/Get-product-information.md create mode 100644 docs/en/md/Ozon/Uploading-and-updating-products/Get-products-information.md create mode 100644 docs/en/md/Ozon/Uploading-and-updating-products/Update-product-images.md create mode 100644 docs/en/md/Ozon/Uploading-and-updating-products/Update-products-articles.md create mode 100644 docs/ru/cli/Ozon/ИзменитьАртикулыТоваров.txt create mode 100644 docs/ru/cli/Ozon/ОбновитьИзображенияТовара.txt create mode 100644 docs/ru/cli/Ozon/ПолучитьИнформациюОТоварах.txt create mode 100644 docs/ru/cli/Ozon/ПроверитьЗагрузкуИзображенийТоваров.txt create mode 100644 docs/ru/md/Ozon/Uploading-and-updating-products/Check-products-images-upload.md delete mode 100644 docs/ru/md/Ozon/Uploading-and-updating-products/Get-product-information.md create mode 100644 docs/ru/md/Ozon/Uploading-and-updating-products/Get-products-information.md create mode 100644 docs/ru/md/Ozon/Uploading-and-updating-products/Update-product-images.md create mode 100644 docs/ru/md/Ozon/Uploading-and-updating-products/Update-products-articles.md diff --git a/docs/en/cli/Ozon/CheckProductsImagesUpload.txt b/docs/en/cli/Ozon/CheckProductsImagesUpload.txt new file mode 100644 index 0000000000..00596ba71d --- /dev/null +++ b/docs/en/cli/Ozon/CheckProductsImagesUpload.txt @@ -0,0 +1 @@ +oint ozon CheckProductsImagesUpload --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --products %products% diff --git a/docs/en/cli/Ozon/GetProductsInformation.txt b/docs/en/cli/Ozon/GetProductsInformation.txt new file mode 100644 index 0000000000..6e432478a8 --- /dev/null +++ b/docs/en/cli/Ozon/GetProductsInformation.txt @@ -0,0 +1 @@ +oint ozon GetProductsInformation --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid %productid% --sku %sku% --offerid %offerid% diff --git a/docs/en/cli/Ozon/UpdateProductImages.txt b/docs/en/cli/Ozon/UpdateProductImages.txt new file mode 100644 index 0000000000..d250711613 --- /dev/null +++ b/docs/en/cli/Ozon/UpdateProductImages.txt @@ -0,0 +1 @@ +oint ozon UpdateProductImages --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid "1111588191" --images %images% --images360 %images360% --color %color% diff --git a/docs/en/cli/Ozon/UpdateProductsArticles.txt b/docs/en/cli/Ozon/UpdateProductsArticles.txt new file mode 100644 index 0000000000..1f9f3427fb --- /dev/null +++ b/docs/en/cli/Ozon/UpdateProductsArticles.txt @@ -0,0 +1 @@ +oint ozon UpdateProductsArticles --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --offers %offers% diff --git a/docs/en/md/Bitrix24/Deals-managment/Create-deal.md b/docs/en/md/Bitrix24/Deals-managment/Create-deal.md index b195e644e4..98e3240896 100644 --- a/docs/en/md/Bitrix24/Deals-managment/Create-deal.md +++ b/docs/en/md/Bitrix24/Deals-managment/Create-deal.md @@ -64,5 +64,17 @@ Method at API documentation: [crm.deal.add](https://dev.1c-bitrix.ru/rest_help/c ``` ```json title="Result" - +{ + "result": 74, + "time": { + "start": 1724584043.72863, + "finish": 1724584043.94602, + "duration": 0.21738600730896, + "processing": 0.192203044891357, + "date_start": "2024-08-25T11:07:23+00:00", + "date_finish": "2024-08-25T11:07:23+00:00", + "operating_reset_at": 1724584643, + "operating": 0.192182064056396 + } +} ``` diff --git a/docs/en/md/Bitrix24/Deals-managment/Delete-deal.md b/docs/en/md/Bitrix24/Deals-managment/Delete-deal.md index 0c79c1ed36..3938fa1c01 100644 --- a/docs/en/md/Bitrix24/Deals-managment/Delete-deal.md +++ b/docs/en/md/Bitrix24/Deals-managment/Delete-deal.md @@ -48,5 +48,17 @@ Method at API documentation: [crm.deal.delete](https://dev.1c-bitrix.ru/rest_hel ``` ```json title="Result" - +{ + "result": true, + "time": { + "start": 1724584048.03319, + "finish": 1724584048.14273, + "duration": 0.109539985656738, + "processing": 0.0796740055084228, + "date_start": "2024-08-25T11:07:28+00:00", + "date_finish": "2024-08-25T11:07:28+00:00", + "operating_reset_at": 1724584648, + "operating": 0 + } +} ``` diff --git a/docs/en/md/Bitrix24/Deals-managment/Get-deal-structure.md b/docs/en/md/Bitrix24/Deals-managment/Get-deal-structure.md index bf0b0926fd..b96b1d02b8 100644 --- a/docs/en/md/Bitrix24/Deals-managment/Get-deal-structure.md +++ b/docs/en/md/Bitrix24/Deals-managment/Get-deal-structure.md @@ -45,5 +45,436 @@ Method at API documentation: [crm.deal.fields](https://dev.1c-bitrix.ru/rest_hel ``` ```json title="Result" - +{ + "result": { + "ID": { + "type": "integer", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "ID" + }, + "TITLE": { + "type": "string", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Название" + }, + "TYPE_ID": { + "type": "crm_status", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "statusType": "DEAL_TYPE", + "title": "Тип" + }, + "CATEGORY_ID": { + "type": "crm_category", + "isRequired": false, + "isReadOnly": false, + "isImmutable": true, + "isMultiple": false, + "isDynamic": false, + "title": "Воронка" + }, + "STAGE_ID": { + "type": "crm_status", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "statusType": "DEAL_STAGE", + "title": "Стадия сделки" + }, + "STAGE_SEMANTIC_ID": { + "type": "string", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Группа стадии" + }, + "IS_NEW": { + "type": "char", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Новая сделка" + }, + "IS_RECURRING": { + "type": "char", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Регулярная сделка" + }, + "IS_RETURN_CUSTOMER": { + "type": "char", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Повторная сделка" + }, + "IS_REPEATED_APPROACH": { + "type": "char", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Повторное обращение" + }, + "PROBABILITY": { + "type": "integer", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Вероятность" + }, + "CURRENCY_ID": { + "type": "crm_currency", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Валюта" + }, + "OPPORTUNITY": { + "type": "double", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Сумма" + }, + "IS_MANUAL_OPPORTUNITY": { + "type": "char", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "IS_MANUAL_OPPORTUNITY" + }, + "TAX_VALUE": { + "type": "double", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Ставка налога" + }, + "COMPANY_ID": { + "type": "crm_company", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Компания", + "settings": { + "parentEntityTypeId": 4 + } + }, + "CONTACT_ID": { + "type": "crm_contact", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "isDeprecated": true, + "title": "Контакт" + }, + "CONTACT_IDS": { + "type": "crm_contact", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": true, + "isDynamic": false, + "title": "Контакты" + }, + "QUOTE_ID": { + "type": "crm_quote", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Предложение", + "settings": { + "parentEntityTypeId": 7 + } + }, + "BEGINDATE": { + "type": "date", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Дата начала" + }, + "CLOSEDATE": { + "type": "date", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Дата завершения" + }, + "OPENED": { + "type": "char", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Доступна для всех" + }, + "CLOSED": { + "type": "char", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Закрыта" + }, + "COMMENTS": { + "type": "string", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Комментарий" + }, + "ASSIGNED_BY_ID": { + "type": "user", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Ответственный" + }, + "CREATED_BY_ID": { + "type": "user", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Кем создана" + }, + "MODIFY_BY_ID": { + "type": "user", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Кем изменена" + }, + "MOVED_BY_ID": { + "type": "user", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "MOVED_BY_ID" + }, + "DATE_CREATE": { + "type": "datetime", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Дата создания" + }, + "DATE_MODIFY": { + "type": "datetime", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Дата изменения" + }, + "MOVED_TIME": { + "type": "datetime", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "MOVED_TIME" + }, + "SOURCE_ID": { + "type": "crm_status", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "statusType": "SOURCE", + "title": "Источник" + }, + "SOURCE_DESCRIPTION": { + "type": "string", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Дополнительно об источнике" + }, + "LEAD_ID": { + "type": "crm_lead", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Лид", + "settings": { + "parentEntityTypeId": 1 + } + }, + "ADDITIONAL_INFO": { + "type": "string", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Дополнительная информация" + }, + "LOCATION_ID": { + "type": "location", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Местоположение" + }, + "ORIGINATOR_ID": { + "type": "string", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Внешний источник" + }, + "ORIGIN_ID": { + "type": "string", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Идентификатор элемента во внешнем источнике" + }, + "UTM_SOURCE": { + "type": "string", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Рекламная система" + }, + "UTM_MEDIUM": { + "type": "string", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Тип трафика" + }, + "UTM_CAMPAIGN": { + "type": "string", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Обозначение рекламной кампании" + }, + "UTM_CONTENT": { + "type": "string", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Содержание кампании" + }, + "UTM_TERM": { + "type": "string", + "isRequired": false, + "isReadOnly": false, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "Условие поиска кампании" + }, + "LAST_ACTIVITY_TIME": { + "type": "datetime", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "LAST_ACTIVITY_TIME" + }, + "LAST_ACTIVITY_BY": { + "type": "user", + "isRequired": false, + "isReadOnly": true, + "isImmutable": false, + "isMultiple": false, + "isDynamic": false, + "title": "LAST_ACTIVITY_BY" + } + }, + "time": { + "start": 1724584042.31272, + "finish": 1724584042.3535, + "duration": 0.0407781600952148, + "processing": 0.0108120441436768, + "date_start": "2024-08-25T11:07:22+00:00", + "date_finish": "2024-08-25T11:07:22+00:00", + "operating_reset_at": 1724584642, + "operating": 0 + } +} ``` diff --git a/docs/en/md/Bitrix24/Deals-managment/Get-deal.md b/docs/en/md/Bitrix24/Deals-managment/Get-deal.md index 716d8d0fda..c2dd7b90bb 100644 --- a/docs/en/md/Bitrix24/Deals-managment/Get-deal.md +++ b/docs/en/md/Bitrix24/Deals-managment/Get-deal.md @@ -48,5 +48,62 @@ Method at API documentation: [crm.deal.get](https://dev.1c-bitrix.ru/rest_help/c ``` ```json title="Result" - +{ + "result": { + "ID": "72", + "TITLE": "Planned sale", + "TYPE_ID": "GOODS", + "STAGE_ID": "NEW", + "PROBABILITY": "30", + "CURRENCY_ID": "USD", + "OPPORTUNITY": "5000.00", + "IS_MANUAL_OPPORTUNITY": "N", + "TAX_VALUE": null, + "LEAD_ID": null, + "COMPANY_ID": "1", + "CONTACT_ID": "3", + "QUOTE_ID": null, + "BEGINDATE": "2024-01-01T00:00:00+00:00", + "CLOSEDATE": "2030-01-01T00:00:00+00:00", + "ASSIGNED_BY_ID": "1", + "CREATED_BY_ID": "1", + "MODIFY_BY_ID": "1", + "DATE_CREATE": "2024-08-25T11:07:23+00:00", + "DATE_MODIFY": "2024-08-25T11:07:23+00:00", + "OPENED": "Y", + "CLOSED": "N", + "COMMENTS": null, + "ADDITIONAL_INFO": null, + "LOCATION_ID": null, + "CATEGORY_ID": "0", + "STAGE_SEMANTIC_ID": "P", + "IS_NEW": "Y", + "IS_RECURRING": "N", + "IS_RETURN_CUSTOMER": "N", + "IS_REPEATED_APPROACH": "N", + "SOURCE_ID": null, + "SOURCE_DESCRIPTION": null, + "ORIGINATOR_ID": null, + "ORIGIN_ID": null, + "MOVED_BY_ID": "1", + "MOVED_TIME": "2024-08-25T11:07:23+00:00", + "LAST_ACTIVITY_TIME": "2024-08-25T11:07:23+00:00", + "UTM_SOURCE": null, + "UTM_MEDIUM": null, + "UTM_CAMPAIGN": null, + "UTM_CONTENT": null, + "UTM_TERM": null, + "LAST_ACTIVITY_BY": "1" + }, + "time": { + "start": 1724584045.17096, + "finish": 1724584045.21572, + "duration": 0.04475998878479, + "processing": 0.0171570777893066, + "date_start": "2024-08-25T11:07:25+00:00", + "date_finish": "2024-08-25T11:07:25+00:00", + "operating_reset_at": 1724584645, + "operating": 0 + } +} ``` diff --git a/docs/en/md/Bitrix24/Deals-managment/Get-deals-filter-structure.md b/docs/en/md/Bitrix24/Deals-managment/Get-deals-filter-structure.md index ac66fb8861..1b84c896ed 100644 --- a/docs/en/md/Bitrix24/Deals-managment/Get-deals-filter-structure.md +++ b/docs/en/md/Bitrix24/Deals-managment/Get-deals-filter-structure.md @@ -34,5 +34,31 @@ sidebar_position: 7 ``` ```json title="Result" - +{ + "ID": "", + "ASSIGNED_BY_ID": "", + "BEGINDATE": "", + "CATEGORY_ID": "", + "CLOSEDATE": "", + "COMPANY_ID": "", + "CONTACT_ID": "", + "CREATED_BY_ID": "", + "CURRENCY_ID": "", + "DATE_CREATE": "", + "DATE_MODIFY": "", + "IS_NEW": "", + "IS_RECURRING": "", + "IS_RETURN_CUSTOMER": "", + "LEAD_ID": "", + "MODIFY_BY_ID": "", + "MOVED_BY_ID": "", + "MOVED_TIME": "", + "OPENED": "", + "OPPORTUNITY": "", + "PROBABILITY": "", + "REQUISITE_ID": "", + "STAGE_ID": "", + "TITLE": "", + "TYPE_ID": "" +} ``` diff --git a/docs/en/md/Bitrix24/Deals-managment/Get-deals-list.md b/docs/en/md/Bitrix24/Deals-managment/Get-deals-list.md index 1daf0008a8..46d2445570 100644 --- a/docs/en/md/Bitrix24/Deals-managment/Get-deals-list.md +++ b/docs/en/md/Bitrix24/Deals-managment/Get-deals-list.md @@ -51,5 +51,18 @@ Method at API documentation: [crm.deal.list](https://dev.1c-bitrix.ru/rest_help/ ``` ```json title="Result" - +{ + "result": [], + "total": 0, + "time": { + "start": 1724584049.38281, + "finish": 1724584049.4266, + "duration": 0.0437829494476318, + "processing": 0.0159609317779541, + "date_start": "2024-08-25T11:07:29+00:00", + "date_finish": "2024-08-25T11:07:29+00:00", + "operating_reset_at": 1724584649, + "operating": 0 + } +} ``` diff --git a/docs/en/md/Bitrix24/Deals-managment/Update-deal.md b/docs/en/md/Bitrix24/Deals-managment/Update-deal.md index 0414786d99..caec1d19d8 100644 --- a/docs/en/md/Bitrix24/Deals-managment/Update-deal.md +++ b/docs/en/md/Bitrix24/Deals-managment/Update-deal.md @@ -58,5 +58,17 @@ dev.1c-bitrix.ru/rest_help/crm/cdeals/crm_deal_update.php) ``` ```json title="Result" - +{ + "result": true, + "time": { + "start": 1724584046.54833, + "finish": 1724584046.70114, + "duration": 0.152806997299194, + "processing": 0.124013900756836, + "date_start": "2024-08-25T11:07:26+00:00", + "date_finish": "2024-08-25T11:07:26+00:00", + "operating_reset_at": 1724584646, + "operating": 0.123990058898926 + } +} ``` diff --git a/docs/en/md/Ozon/Attributes-and-features/Get-products-requests-limits.md b/docs/en/md/Ozon/Attributes-and-features/Get-products-requests-limits.md index 24238a1303..d2dad14afc 100644 --- a/docs/en/md/Ozon/Attributes-and-features/Get-products-requests-limits.md +++ b/docs/en/md/Ozon/Attributes-and-features/Get-products-requests-limits.md @@ -41,5 +41,20 @@ Method at API documentation: [post /v4/product/info/limit](https://docs.ozon.ru/ ``` ```json title="Result" - +{ + "daily_create": { + "usage": 0, + "limit": 1500, + "reset_at": "2024-08-26T00:00:00Z" + }, + "daily_update": { + "usage": 4, + "limit": 5000, + "reset_at": "2024-08-26T00:00:00Z" + }, + "total": { + "usage": 2, + "limit": 20000 + } +} ``` diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Add-product-video-cover.md b/docs/en/md/Ozon/Uploading-and-updating-products/Add-product-video-cover.md index db3da8333f..a4eadcfae9 100644 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Add-product-video-cover.md +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Add-product-video-cover.md @@ -1,5 +1,5 @@ --- -sidebar_position: 14 +sidebar_position: 17 --- # Add product video cover diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Add-product-video.md b/docs/en/md/Ozon/Uploading-and-updating-products/Add-product-video.md index 14cee62359..12e21eb183 100644 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Add-product-video.md +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Add-product-video.md @@ -1,5 +1,5 @@ --- -sidebar_position: 13 +sidebar_position: 16 --- # Add product video diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Check-products-images-upload.md b/docs/en/md/Ozon/Uploading-and-updating-products/Check-products-images-upload.md new file mode 100644 index 0000000000..ad8c54caec --- /dev/null +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Check-products-images-upload.md @@ -0,0 +1,76 @@ +--- +sidebar_position: 10 +--- + +# Check products images upload + Check images upload by products IDs + + + +`Function CheckProductsImagesUpload(Val ClientID, Val APIKey, Val ProductsID) Export` + + | Parameter | CLI option | Type | Description | + |-|-|-|-| + | ClientID | --clientid | String | Client identifier | + | APIKey | --apikey | String | API key | + | ProductsID | --products | String, Number, Array of String, Number | Product IDs to be inspected | + + + Returns: Map Of KeyAndValue - Serialized JSON response from Ozon Seller API + +
+ +:::tip +Method at API documentation: [post /v1/product/pictures/info](https://docs.ozon.ru/api/seller/#operation/ProductAPI_ProductInfoPictures) +::: +
+ + +```bsl title="Code example" + ClientID = "2128753"; + APIKey = "7cc90d26-33e4-499b..."; + ProductID = "1111588191"; + + Result = OPI_Ozon.CheckProductsImagesUpload(ClientID, APIKey, ProductID); +``` + + + +```sh title="CLI command example" + +oint ozon CheckProductsImagesUpload --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --products %products% + +``` + +```json title="Result" +{ + "result": { + "pictures": [ + { + "product_id": 1111588191, + "url": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture.jpg", + "state": "imported", + "is_primary": true, + "is_360": false, + "is_color": false + }, + { + "product_id": 1111588191, + "url": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture2.jpg", + "state": "imported", + "is_primary": false, + "is_360": false, + "is_color": false + }, + { + "product_id": 1111588191, + "url": "GREEN", + "state": "imported", + "is_primary": false, + "is_360": false, + "is_color": true + } + ] + } +} +``` diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Complete-complex-attribute.md b/docs/en/md/Ozon/Uploading-and-updating-products/Complete-complex-attribute.md index b3d66152c0..309f2a17f7 100644 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Complete-complex-attribute.md +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Complete-complex-attribute.md @@ -1,5 +1,5 @@ --- -sidebar_position: 15 +sidebar_position: 18 --- # Complete the complex attribute diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-attributes-update-structure.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-attributes-update-structure.md index f469b70266..e09d9b7cbf 100644 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Get-attributes-update-structure.md +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Get-attributes-update-structure.md @@ -1,5 +1,5 @@ --- -sidebar_position: 11 +sidebar_position: 14 --- # Get attributes update structure @@ -37,5 +37,8 @@ sidebar_position: 11 ``` ```json title="Result" - +{ + "offer_id": "
", + "attributes": "" +} ``` diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-creation-status.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-creation-status.md index 587a057a47..70fa9d78d2 100644 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-creation-status.md +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-creation-status.md @@ -1,5 +1,5 @@ --- -sidebar_position: 8 +sidebar_position: 9 --- # Get product creation status diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-description.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-description.md index 31f2f04982..88ad31a83b 100644 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-description.md +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-description.md @@ -44,5 +44,12 @@ Method at API documentation: [post /v1/product/info/description](https://docs.oz ``` ```json title="Result" - +{ + "result": { + "id": 1111588191, + "offer_id": "143210608", + "name": "Protective film set for X3 NFC. Dark cotton", + "description": "" + } +} ``` diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-information.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-information.md deleted file mode 100644 index b3ab89f39d..0000000000 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-information.md +++ /dev/null @@ -1,55 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Get product information - Gets product information by identifiers - - - -`Function GetProductInformation(Val ClientID, Val APIKey, Val ProductID = 0, Val SKU = 0, Val Article = "") Export` - - | Parameter | CLI option | Type | Description | - |-|-|-|-| - | ClientID | --clientid | String | Client identifier | - | APIKey | --apikey | String | API key | - | ProductID | --productid | String, Number | Product identifier | - | SKU | --sku | String, Number | Product identifier in the Ozon system (SKU) | - | Article | --offerid | String, Number | Item identifier in the vendor's system (Article) | - - - Returns: Map Of KeyAndValue - Serialized JSON response from Ozon Seller API - -
- -:::tip -Specify the minimum price of the product after all promotions have been applied in your personal cabinet. The min_price parameter from the method response is being reworked and returns 0 - - The active_product parameter is deprecated, use the values of the visible parameter - - The fbs_sku and fbo_sku parameters from the method response were disabled on August 15, 2023 - - Method at API documentation: [post /v2/product/info](https://docs.ozon.ru/api/seller/#operation/ProductAPI_GetProductInfoV2) -::: -
- - -```bsl title="Code example" - ClientID = "2128753"; - APIKey = "7cc90d26-33e4-499b..."; - Article = "143210608"; - - Result = OPI_Ozon.GetProductInformation(ClientID, APIKey, , , Article); -``` - - - -```sh title="CLI command example" - - oint ozon GetProductInformation --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid %productid% --sku %sku% --offerid %offerid% - -``` - -```json title="Result" - -``` diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-list.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-list.md index 44e0ccf319..061bb01c53 100644 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-list.md +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-list.md @@ -50,5 +50,20 @@ Method at API documentation: [post /v2/product/list](https://docs.ozon.ru/api/se ``` ```json title="Result" - +{ + "result": { + "items": [ + { + "product_id": 1111588191, + "offer_id": "143210608", + "is_fbo_visible": false, + "is_fbs_visible": false, + "archived": false, + "is_discounted": false + } + ], + "total": 1, + "last_id": "WzExMTE1ODgxOTEsMTExMTU4ODE5MV0=" + } +} ``` diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-structure.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-structure.md index 77144b615e..04f48a2995 100644 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-structure.md +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-structure.md @@ -1,5 +1,5 @@ --- -sidebar_position: 9 +sidebar_position: 12 --- # Get product structure diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-content-rating.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-content-rating.md index 26f1fce603..89bc9dbaf4 100644 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-content-rating.md +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-content-rating.md @@ -43,5 +43,134 @@ Method at API documentation: [post /v1/product/rating-by-sku](https://docs.ozon. ``` ```json title="Result" - +{ + "products": [ + { + "sku": 1626044001, + "rating": 70, + "groups": [ + { + "key": "important_attributes", + "name": "Важные атрибуты", + "rating": 100, + "weight": 30, + "conditions": [ + { + "key": "important_2", + "description": "Заполнено 2 атрибута и более", + "fulfilled": true, + "cost": 50 + }, + { + "key": "important_50_percent", + "description": "Заполнено более 50% атрибутов", + "fulfilled": true, + "cost": 25 + }, + { + "key": "important_70_percent", + "description": "Заполнено более 70% атрибутов", + "fulfilled": true, + "cost": 25 + } + ], + "improve_attributes": [], + "improve_at_least": 0 + }, + { + "key": "other_attributes", + "name": "Остальные атрибуты", + "rating": 100, + "weight": 25, + "conditions": [ + { + "key": "other_2", + "description": "Заполнено 2 атрибута и более", + "fulfilled": true, + "cost": 50 + }, + { + "key": "other_50_percent", + "description": "Заполнено более 50% атрибутов", + "fulfilled": true, + "cost": 50 + } + ], + "improve_attributes": [], + "improve_at_least": 0 + }, + { + "key": "text", + "name": "Текстовое описание", + "rating": 50, + "weight": 20, + "conditions": [ + { + "key": "text_annotation_100_chars", + "description": "Аннотация более 100 знаков", + "fulfilled": true, + "cost": 25 + }, + { + "key": "text_annotation_500_chars", + "description": "Аннотация более 500 знаков", + "fulfilled": true, + "cost": 25 + }, + { + "key": "text_rich", + "description": "Заполнен Rich-контент", + "fulfilled": false, + "cost": 100 + } + ], + "improve_attributes": [ + { + "id": 11254, + "name": "Rich-контент JSON" + } + ], + "improve_at_least": 1 + }, + { + "key": "media", + "name": "Медиа", + "rating": 20, + "weight": 25, + "conditions": [ + { + "key": "media_video_cover", + "description": "Добавлена видеообложка", + "fulfilled": false, + "cost": 50 + }, + { + "key": "media_video", + "description": "Добавлено видео", + "fulfilled": false, + "cost": 30 + }, + { + "key": "media_images_3", + "description": "Добавлено 3 изображения и более", + "fulfilled": true, + "cost": 20 + } + ], + "improve_attributes": [ + { + "id": 21841, + "name": "Озон.Видео: ссылка" + }, + { + "id": 21845, + "name": "Озон.Видеообложка: ссылка" + } + ], + "improve_at_least": 2 + } + ] + } + ] +} ``` diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-filter-structure.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-filter-structure.md index 147a6fe56e..69ff383626 100644 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-filter-structure.md +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-filter-structure.md @@ -1,5 +1,5 @@ --- -sidebar_position: 12 +sidebar_position: 15 --- # Get products filter structure @@ -37,5 +37,9 @@ The description of the filter fields can be found on the documentation page for ``` ```json title="Result" - +{ + "offer_id": "", + "product_id": "", + "visibility": "" +} ``` diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-information.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-information.md new file mode 100644 index 0000000000..54782da098 --- /dev/null +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-information.md @@ -0,0 +1,141 @@ +--- +sidebar_position: 2 +--- + +# Get products informations + Gets information about products by an array of identifiers + + + +`Function GetProductsInformation(Val ClientID, Val APIKey, Val ProductsID = 0, Val SKU = 0, Val Articles = "") Export` + + | Parameter | CLI option | Type | Description | + |-|-|-|-| + | ClientID | --clientid | String | Client identifier | + | APIKey | --apikey | String | API key | + | ProductsID | --productid | Number, Array Of Number | Products identifier | + | SKU | --sku | Number, Array Of Number | Products identifiers in the Ozon system (SKU) | + | Articles | --offerid | String, Array of String | Item identifiers in the vendor's system (Article) | + + + Returns: Map Of KeyAndValue - Serialized JSON response from Ozon Seller API + +
+ +:::tip +Specify the minimum price of the product after all promotions have been applied in your personal cabinet. The min_price parameter from the method response is being reworked and returns 0 + + The active_product parameter is deprecated, use the values of the visible parameter + + The fbs_sku and fbo_sku parameters from the method response were disabled on August 15, 2023 + + The body of the request must contain a single identifier or an array of identical identifiers, the response will be an array of items + + Method at API documentation: [post /v2/product/info/list](https://docs.ozon.ru/api/seller/#operation/ProductAPI_GetProductInfoListV2) +::: +
+ + +```bsl title="Code example" + ClientID = "2128753"; + APIKey = "7cc90d26-33e4-499b..."; + Article = "143210608"; + + Result = OPI_Ozon.GetProductsInformation(ClientID, APIKey, , , Article); +``` + + + +```sh title="CLI command example" + +oint ozon GetProductsInformation --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid %productid% --sku %sku% --offerid %offerid% + +``` + +```json title="Result" +{ + "result": { + "items": [ + { + "id": 1111588191, + "name": "Protective film set for X3 NFC. Dark cotton", + "offer_id": "143210608", + "barcode": "", + "buybox_price": "", + "category_id": 0, + "created_at": "2024-07-15T06:19:47.810185Z", + "images": [ + "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture2.jpg" + ], + "marketing_price": "", + "min_ozon_price": "", + "old_price": "1100.0000", + "premium_price": "", + "price": "1000.0000", + "recommended_price": "", + "min_price": "", + "sources": [], + "stocks": { + "coming": 0, + "present": 0, + "reserved": 0 + }, + "errors": [], + "vat": "0.100000", + "visible": false, + "visibility_details": { + "has_price": false, + "has_stock": false, + "active_product": false, + "reasons": {} + }, + "price_index": "0.00", + "images360": [], + "color_image": "", + "primary_image": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture.jpg", + "status": { + "state": "imported", + "state_failed": "", + "moderate_status": "", + "decline_reasons": [], + "validation_state": "pending", + "state_name": "Не продается", + "state_description": "Создается", + "is_failed": false, + "is_created": false, + "state_tooltip": "", + "item_errors": [], + "state_updated_at": "2024-08-27T19:20:08.365033Z" + }, + "state": "", + "service_type": "IS_CODE_SERVICE", + "fbo_sku": 0, + "fbs_sku": 0, + "currency_code": "RUB", + "is_kgt": false, + "rating": "", + "discounted_stocks": { + "coming": 0, + "present": 0, + "reserved": 0 + }, + "is_discounted": false, + "has_discounted_item": false, + "barcodes": [], + "updated_at": "2024-08-27T19:20:08.365033Z", + "price_indexes": { + "price_index": "WITHOUT_INDEX", + "external_index_data": null, + "ozon_index_data": null, + "self_marketplaces_index_data": null + }, + "sku": 0, + "description_category_id": 17028922, + "type_id": 95911, + "is_archived": false, + "is_autoarchived": false + } + ] + } +} +``` diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-simplified-product-structure.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-simplified-product-structure.md index 85dd1abca0..efbbf8a363 100644 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Get-simplified-product-structure.md +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Get-simplified-product-structure.md @@ -1,5 +1,5 @@ --- -sidebar_position: 10 +sidebar_position: 13 --- # Get simplified product structure @@ -34,5 +34,13 @@ sidebar_position: 10 ``` ```json title="Result" - +{ + "name": "", + "sku": "", + "offer_id": "
", + "price": "", + "old_price": "", + "vat": "", + "currency_code": "" +} ``` diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Update-product-images.md b/docs/en/md/Ozon/Uploading-and-updating-products/Update-product-images.md new file mode 100644 index 0000000000..851df30d58 --- /dev/null +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Update-product-images.md @@ -0,0 +1,99 @@ +--- +sidebar_position: 8 +--- + +# Update product images + Update images and marketing color + + + +`Function UpdateProductImages(Val ClientID, Val APIKey, Val ProductID, Val ImagesArray = "", Val Array360 = "", Val MarketingColor = "") Export` + + | Parameter | CLI option | Type | Description | + |-|-|-|-| + | ClientID | --clientid | String | Client identifier | + | APIKey | --apikey | String | API key | + | ProductID | --productid | String, Number | Product identifier | + | ImagesArray | --images | Array Of String | Array of images URLs | + | Array360 | --images360 | Array Of String | Array of 360 images | + | MarketingColor | --color | String | Marketing color | + + + Returns: Map Of KeyAndValue - Serialized JSON response from Ozon Seller API + +
+ +:::tip +On each method call, send all the images that should be on the product card + + To upload, pass the URL of the image to public cloud storage. The format of the image is JPG or PNG + + If you want to change the composition or order of the images, get the information using the GetProductInformation() method, copy the data of the images, images360, color_image fields, change and complete the composition or order as needed + + Method at API documentation: [post /v1/product/pictures/import](https://docs.ozon.ru/api/seller/#operation/ProductAPI_ProductImportPictures) +::: +
+ + +```bsl title="Code example" + ClientID = "2128753"; + APIKey = "7cc90d26-33e4-499b..."; + ProductID = "1111588191"; + + Image1 = "https://openintegrations.dev/test_data/picture.jpg"; + Image2 = "https://openintegrations.dev/test_data/picture2.jpg"; + + MarketingColor = "GREEN"; + + ImagesArray = New Array; + ImagesArray.Add(Image1); + ImagesArray.Add(Image2); + + Result = OPI_Ozon.UpdateProductImages(ClientID + , APIKey + , ProductID + , ImagesArray + , + , MarketingColor); +``` + + + +```sh title="CLI command example" + +oint ozon UpdateProductImages --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid "1111588191" --images %images% --images360 %images360% --color %color% + +``` + +```json title="Result" +{ + "result": { + "pictures": [ + { + "product_id": 1111588191, + "url": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture.jpg", + "state": "imported", + "is_primary": true, + "is_360": false, + "is_color": false + }, + { + "product_id": 1111588191, + "url": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture2.jpg", + "state": "imported", + "is_primary": false, + "is_360": false, + "is_color": false + }, + { + "product_id": 1111588191, + "url": "GREEN", + "state": "imported", + "is_primary": false, + "is_360": false, + "is_color": true + } + ] + } +} +``` diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Update-products-articles.md b/docs/en/md/Ozon/Uploading-and-updating-products/Update-products-articles.md new file mode 100644 index 0000000000..8c8231b9c6 --- /dev/null +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Update-products-articles.md @@ -0,0 +1,51 @@ +--- +sidebar_position: 11 +--- + +# Update products articles + Modifies articles of existing products + + + +`Function UpdateProductsArticles(Val ClientID, Val APIKey, Val ArticlesMap) Export` + + | Parameter | CLI option | Type | Description | + |-|-|-|-| + | ClientID | --clientid | String | Client identifier | + | APIKey | --apikey | String | API key | + | ArticlesMap | --offers | Map Of KeyAndValue | Articles: Key > current, Value > new | + + + Returns: Map Of KeyAndValue - Serialized JSON response from Ozon Seller API + +
+ +:::tip +Method at API documentation: [post /v1/product/update/offer-id](https://docs.ozon.ru/api/seller/#operation/ProductAPI_ProductUpdateOfferID) +::: +
+ + +```bsl title="Code example" + ClientID = "2128753"; + APIKey = "7cc90d26-33e4-499b..."; + + ArticlesMap = New Map; + ArticlesMap.Insert("143210608", "143210609"); + + Result = OPI_Ozon.UpdateProductsArticles(ClientID, APIKey, ArticlesMap); +``` + + + +```sh title="CLI command example" + +oint ozon UpdateProductsArticles --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --offers %offers% + +``` + +```json title="Result" +{ + "errors": [] +} +``` diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Update-products-attributes.md b/docs/en/md/Ozon/Uploading-and-updating-products/Update-products-attributes.md index 75c6236701..404c8949ad 100644 --- a/docs/en/md/Ozon/Uploading-and-updating-products/Update-products-attributes.md +++ b/docs/en/md/Ozon/Uploading-and-updating-products/Update-products-attributes.md @@ -54,5 +54,7 @@ You can get an empty structure using the GetAttributesUpdateStructure method() ``` ```json title="Result" - +{ + "task_id": 1286865441 +} ``` diff --git a/docs/ru/cli/Ozon/ИзменитьАртикулыТоваров.txt b/docs/ru/cli/Ozon/ИзменитьАртикулыТоваров.txt new file mode 100644 index 0000000000..9d605be4ac --- /dev/null +++ b/docs/ru/cli/Ozon/ИзменитьАртикулыТоваров.txt @@ -0,0 +1 @@ +oint ozon ИзменитьАртикулыТоваров --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --offers %offers% diff --git a/docs/ru/cli/Ozon/ОбновитьИзображенияТовара.txt b/docs/ru/cli/Ozon/ОбновитьИзображенияТовара.txt new file mode 100644 index 0000000000..c895945199 --- /dev/null +++ b/docs/ru/cli/Ozon/ОбновитьИзображенияТовара.txt @@ -0,0 +1 @@ +oint ozon ОбновитьИзображенияТовара --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid "1111588191" --images %images% --images360 %images360% --color %color% diff --git a/docs/ru/cli/Ozon/ПолучитьИнформациюОТоварах.txt b/docs/ru/cli/Ozon/ПолучитьИнформациюОТоварах.txt new file mode 100644 index 0000000000..4ef0434716 --- /dev/null +++ b/docs/ru/cli/Ozon/ПолучитьИнформациюОТоварах.txt @@ -0,0 +1 @@ +oint ozon ПолучитьИнформациюОТоварах --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid %productid% --sku %sku% --offerid %offerid% diff --git a/docs/ru/cli/Ozon/ПроверитьЗагрузкуИзображенийТоваров.txt b/docs/ru/cli/Ozon/ПроверитьЗагрузкуИзображенийТоваров.txt new file mode 100644 index 0000000000..e04b5e7d0e --- /dev/null +++ b/docs/ru/cli/Ozon/ПроверитьЗагрузкуИзображенийТоваров.txt @@ -0,0 +1 @@ +oint ozon ПроверитьЗагрузкуИзображенийТоваров --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --products %products% diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Add-product-video-cover.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Add-product-video-cover.md index 707a09d0ea..09fc7a5899 100644 --- a/docs/ru/md/Ozon/Uploading-and-updating-products/Add-product-video-cover.md +++ b/docs/ru/md/Ozon/Uploading-and-updating-products/Add-product-video-cover.md @@ -1,5 +1,5 @@ --- -sidebar_position: 14 +sidebar_position: 17 --- # Добавить видеообложку товара diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Add-product-video.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Add-product-video.md index 2a8d6ac3e4..d45008fb9b 100644 --- a/docs/ru/md/Ozon/Uploading-and-updating-products/Add-product-video.md +++ b/docs/ru/md/Ozon/Uploading-and-updating-products/Add-product-video.md @@ -1,5 +1,5 @@ --- -sidebar_position: 13 +sidebar_position: 16 --- # Добавить видео товара diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Check-products-images-upload.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Check-products-images-upload.md new file mode 100644 index 0000000000..71717e1234 --- /dev/null +++ b/docs/ru/md/Ozon/Uploading-and-updating-products/Check-products-images-upload.md @@ -0,0 +1,76 @@ +--- +sidebar_position: 10 +--- + +# Проверить загрузку изображений товаров + Проверяет загрузку изображений по массиву ID товаров + + + +`Функция ПроверитьЗагрузкуИзображенийТоваров(Знач IDКлиента, Знач КлючAPI, Знач IDТоваров) Экспорт` + + | Параметр | CLI опция | Тип | Назначение | + |-|-|-|-| + | IDКлиента | --clientid | Строка | Идентификатор клиента | + | КлючAPI | --apikey | Строка | API ключ | + | IDТоваров | --products | Строка, Число, Массив Из Строка, Число | ID товаров для проверки | + + + Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Ozon Seller API + +
+ +:::tip +Метод в документации API: [post /v1/product/pictures/info](https://docs.ozon.ru/api/seller/#operation/ProductAPI_ProductInfoPictures) +::: +
+ + +```bsl title="Пример кода" + IDКлиента = "2128753"; + КлючAPI = "7cc90d26-33e4-499b..."; + IDТовара = "1111588191"; + + Результат = OPI_Ozon.ПроверитьЗагрузкуИзображенийТоваров(IDКлиента, КлючAPI, IDТовара); +``` + + + +```sh title="Пример команды CLI" + +oint ozon ПроверитьЗагрузкуИзображенийТоваров --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --products %products% + +``` + +```json title="Результат" +{ + "result": { + "pictures": [ + { + "product_id": 1111588191, + "url": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture.jpg", + "state": "imported", + "is_primary": true, + "is_360": false, + "is_color": false + }, + { + "product_id": 1111588191, + "url": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture2.jpg", + "state": "imported", + "is_primary": false, + "is_360": false, + "is_color": false + }, + { + "product_id": 1111588191, + "url": "GREEN", + "state": "imported", + "is_primary": false, + "is_360": false, + "is_color": true + } + ] + } +} +``` diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Complete-complex-attribute.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Complete-complex-attribute.md index d2e324194b..65a2ac3d4d 100644 --- a/docs/ru/md/Ozon/Uploading-and-updating-products/Complete-complex-attribute.md +++ b/docs/ru/md/Ozon/Uploading-and-updating-products/Complete-complex-attribute.md @@ -1,5 +1,5 @@ --- -sidebar_position: 15 +sidebar_position: 18 --- # Дополнить комплексный атрибут diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-attributes-update-structure.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-attributes-update-structure.md index 9276d1805f..398b71fd48 100644 --- a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-attributes-update-structure.md +++ b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-attributes-update-structure.md @@ -1,5 +1,5 @@ --- -sidebar_position: 11 +sidebar_position: 14 --- # Получить структуру обновления характеристик diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-product-creation-status.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-product-creation-status.md index 039a30fbcf..cfd2c817b0 100644 --- a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-product-creation-status.md +++ b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-product-creation-status.md @@ -1,5 +1,5 @@ --- -sidebar_position: 8 +sidebar_position: 9 --- # Получить статус добавления товара diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-product-information.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-product-information.md deleted file mode 100644 index deab1b9cf4..0000000000 --- a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-product-information.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Получить информацию о товаре - Получает информацию о товаре по идентификаторам - - - -`Функция ПолучитьИнформациюОТоваре(Знач IDКлиента, Знач КлючAPI, Знач IDТовара = 0, Знач SKU = 0, Знач Артикул = "") Экспорт` - - | Параметр | CLI опция | Тип | Назначение | - |-|-|-|-| - | IDКлиента | --clientid | Строка | Идентификатор клиента | - | КлючAPI | --apikey | Строка | API ключ | - | IDТовара | --productid | Строка, Число | Идентификатор товара | - | SKU | --sku | Строка, Число | Идентификатор товара в системе Ozon (SKU) | - | Артикул | --offerid | Строка, Число | Идентификатор товара в системе продавца (Артикул) | - - - Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Ozon Seller API - -
- -:::tip -Уточняйте минимальную цену товара после применения всех акций в личном кабинете. Параметр min_price из ответа метода на доработке и возвращает 0 - - Параметр active_product устарел, используйте значения параметра visible - - Параметры fbs_sku и fbo_sku из ответа метода были отключены 15 августа 2023 года - - Метод в документации API: [post /v2/product/info](https://docs.ozon.ru/api/seller/#operation/ProductAPI_GetProductInfoV2) -::: -
- - -```bsl title="Пример кода" - IDКлиента = "2128753"; - КлючAPI = "7cc90d26-33e4-499b..."; - Артикул = "143210608"; - - Результат = OPI_Ozon.ПолучитьИнформациюОТоваре(IDКлиента, КлючAPI, , , Артикул); -``` - - - -```sh title="Пример команды CLI" - - oint ozon ПолучитьИнформациюОТоваре --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid %productid% --sku %sku% --offerid %offerid% - -``` - -```json title="Результат" -{ - "result": { - "id": 1111588191, - "name": "Комплект защитных плёнок для X3 NFC. Темный хлопок", - "offer_id": "143210608", - "barcode": "", - "buybox_price": "", - "category_id": 0, - "created_at": "2024-07-15T06:19:47.810185Z", - "images": [ - "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture2.jpg" - ], - "marketing_price": "", - "min_ozon_price": "", - "old_price": "1100.0000", - "premium_price": "", - "price": "1000.0000", - "recommended_price": "", - "min_price": "", - "sources": [], - "stocks": { - "coming": 0, - "present": 0, - "reserved": 0 - }, - "errors": [], - "vat": "0.100000", - "visible": false, - "visibility_details": { - "has_price": true, - "has_stock": false, - "active_product": false - }, - "price_index": "0.00", - "commissions": [], - "volume_weight": 0.1, - "is_prepayment": false, - "is_prepayment_allowed": true, - "images360": [], - "color_image": "", - "primary_image": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture.jpg", - "status": { - "state": "unmatched", - "state_failed": "", - "moderate_status": "", - "decline_reasons": [], - "validation_state": "pending", - "state_name": "Не продается", - "state_description": "Создается", - "is_failed": false, - "is_created": false, - "state_tooltip": "", - "item_errors": [], - "state_updated_at": "2024-08-25T10:00:47.361287Z" - }, - "state": "", - "service_type": "IS_CODE_SERVICE", - "fbo_sku": 0, - "fbs_sku": 0, - "currency_code": "RUB", - "is_kgt": false, - "discounted_stocks": { - "coming": 0, - "present": 0, - "reserved": 0 - }, - "is_discounted": false, - "has_discounted_item": false, - "barcodes": [], - "updated_at": "2024-08-25T10:00:19.746188Z", - "price_indexes": { - "price_index": "WITHOUT_INDEX", - "external_index_data": null, - "ozon_index_data": null, - "self_marketplaces_index_data": null - }, - "sku": 0, - "description_category_id": 17028922, - "type_id": 95911, - "is_archived": false, - "is_autoarchived": false - } -} -``` diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-product-structure.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-product-structure.md index 514cb091bd..95656df6a6 100644 --- a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-product-structure.md +++ b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-product-structure.md @@ -1,5 +1,5 @@ --- -sidebar_position: 9 +sidebar_position: 12 --- # Получить структуру товара diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-products-filter-structure.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-products-filter-structure.md index 319e03c180..c33ef5a226 100644 --- a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-products-filter-structure.md +++ b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-products-filter-structure.md @@ -1,5 +1,5 @@ --- -sidebar_position: 12 +sidebar_position: 15 --- # Получить структуру фильтра товаров diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-products-information.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-products-information.md new file mode 100644 index 0000000000..1a950a3db0 --- /dev/null +++ b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-products-information.md @@ -0,0 +1,141 @@ +--- +sidebar_position: 2 +--- + +# Получить информацию о товарах + Получает информацию о товарах по массиву идентификаторов + + + +`Функция ПолучитьИнформациюОТоварах(Знач IDКлиента, Знач КлючAPI, Знач IDТоваров = 0, Знач SKU = 0, Знач Артикулы = "") Экспорт` + + | Параметр | CLI опция | Тип | Назначение | + |-|-|-|-| + | IDКлиента | --clientid | Строка | Идентификатор клиента | + | КлючAPI | --apikey | Строка | API ключ | + | IDТоваров | --productid | Число, Массив Из Число | Идентификаторы товаров | + | SKU | --sku | Число, Массив Из Число | Идентификаторы товаров в системе Ozon (SKU) | + | Артикулы | --offerid | Строка, Массив Из Строка | Идентификаторы товаров в системе продавца (Артикул) | + + + Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Ozon Seller API + +
+ +:::tip +Уточняйте минимальную цену товара после применения всех акций в личном кабинете. Параметр min_price из ответа метода на доработке и возвращает 0 + + Параметр active_product устарел, используйте значения параметра visible + + Параметры fbs_sku и fbo_sku из ответа метода были отключены 15 августа 2023 года + + В теле запроса должен быть один идентификатор или массив однотипных идентификаторов, в ответе будет массив items + + Метод в документации API: [post /v2/product/info/list](https://docs.ozon.ru/api/seller/#operation/ProductAPI_GetProductInfoListV2) +::: +
+ + +```bsl title="Пример кода" + IDКлиента = "2128753"; + КлючAPI = "7cc90d26-33e4-499b..."; + Артикул = "143210608"; + + Результат = OPI_Ozon.ПолучитьИнформациюОТоварах(IDКлиента, КлючAPI, , , Артикул); +``` + + + +```sh title="Пример команды CLI" + +oint ozon ПолучитьИнформациюОТоварах --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid %productid% --sku %sku% --offerid %offerid% + +``` + +```json title="Результат" +{ + "result": { + "items": [ + { + "id": 1111588191, + "name": "Комплект защитных плёнок для X3 NFC. Темный хлопок", + "offer_id": "143210608", + "barcode": "", + "buybox_price": "", + "category_id": 0, + "created_at": "2024-07-15T06:19:47.810185Z", + "images": [ + "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture2.jpg" + ], + "marketing_price": "", + "min_ozon_price": "", + "old_price": "1100.0000", + "premium_price": "", + "price": "1000.0000", + "recommended_price": "", + "min_price": "", + "sources": [], + "stocks": { + "coming": 0, + "present": 0, + "reserved": 0 + }, + "errors": [], + "vat": "0.100000", + "visible": false, + "visibility_details": { + "has_price": false, + "has_stock": false, + "active_product": false, + "reasons": {} + }, + "price_index": "0.00", + "images360": [], + "color_image": "", + "primary_image": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture.jpg", + "status": { + "state": "unmatched", + "state_failed": "", + "moderate_status": "", + "decline_reasons": [], + "validation_state": "pending", + "state_name": "Не продается", + "state_description": "Создается", + "is_failed": false, + "is_created": false, + "state_tooltip": "", + "item_errors": [], + "state_updated_at": "2024-08-27T18:37:29.341354Z" + }, + "state": "", + "service_type": "IS_CODE_SERVICE", + "fbo_sku": 0, + "fbs_sku": 0, + "currency_code": "RUB", + "is_kgt": false, + "rating": "", + "discounted_stocks": { + "coming": 0, + "present": 0, + "reserved": 0 + }, + "is_discounted": false, + "has_discounted_item": false, + "barcodes": [], + "updated_at": "2024-08-27T18:37:19.432674Z", + "price_indexes": { + "price_index": "WITHOUT_INDEX", + "external_index_data": null, + "ozon_index_data": null, + "self_marketplaces_index_data": null + }, + "sku": 0, + "description_category_id": 17028922, + "type_id": 95911, + "is_archived": false, + "is_autoarchived": false + } + ] + } +} +``` diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-simplified-product-structure.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-simplified-product-structure.md index a9a6c72d3a..b95760b33e 100644 --- a/docs/ru/md/Ozon/Uploading-and-updating-products/Get-simplified-product-structure.md +++ b/docs/ru/md/Ozon/Uploading-and-updating-products/Get-simplified-product-structure.md @@ -1,5 +1,5 @@ --- -sidebar_position: 10 +sidebar_position: 13 --- # Получить сокращенную структуру товара diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Update-product-images.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Update-product-images.md new file mode 100644 index 0000000000..12295c49ba --- /dev/null +++ b/docs/ru/md/Ozon/Uploading-and-updating-products/Update-product-images.md @@ -0,0 +1,99 @@ +--- +sidebar_position: 8 +--- + +# Обновить изображения товара + Обновляет изображения и маркетинговый цвет товара + + + +`Функция ОбновитьИзображенияТовара(Знач IDКлиента, Знач КлючAPI, Знач IDТовара, Знач МассивИзображений = "", Знач Массив360 = "", Знач МаркетинговыйЦвет = "") Экспорт` + + | Параметр | CLI опция | Тип | Назначение | + |-|-|-|-| + | IDКлиента | --clientid | Строка | Идентификатор клиента | + | КлючAPI | --apikey | Строка | API ключ | + | IDТовара | --productid | Строка, Число | Идентификатор товара | + | МассивИзображений | --images | Массив Из Строка | Массив URL изображений | + | Массив360 | --images360 | Массив Из Строка | Массив изображений 360 | + | МаркетинговыйЦвет | --color | Строка | Маркетинговый цвет | + + + Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Ozon Seller API + +
+ +:::tip +При каждом вызове метода передавайте все изображения, которые должны быть на карточке товара + + Для загрузки передайте адрес ссылки на изображение в общедоступном облачном хранилище. Формат изображения по ссылке — JPG или PNG + + Если вы хотите изменить состав или порядок изображений, получите информацию с помощью метода ПолучитьИнформациюОТоваре(), скопируйте данные полей images, images360, color_image, измените и дополните состав или порядок в соответствии с необходимостью + + Метод в документации API: [post /v1/product/pictures/import](https://docs.ozon.ru/api/seller/#operation/ProductAPI_ProductImportPictures) +::: +
+ + +```bsl title="Пример кода" + IDКлиента = "2128753"; + КлючAPI = "7cc90d26-33e4-499b..."; + IDТовара = "1111588191"; + + Картинка1 = "https://openintegrations.dev/test_data/picture.jpg"; + Картинка2 = "https://openintegrations.dev/test_data/picture2.jpg"; + + МаркетинговыйЦвет = "GREEN"; + + МассивИзображений = Новый Массив; + МассивИзображений.Добавить(Картинка1); + МассивИзображений.Добавить(Картинка2); + + Результат = OPI_Ozon.ОбновитьИзображенияТовара(IDКлиента + , КлючAPI + , IDТовара + , МассивИзображений + , + , МаркетинговыйЦвет); +``` + + + +```sh title="Пример команды CLI" + +oint ozon ОбновитьИзображенияТовара --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid "1111588191" --images %images% --images360 %images360% --color %color% + +``` + +```json title="Результат" +{ + "result": { + "pictures": [ + { + "product_id": 1111588191, + "url": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture.jpg", + "state": "imported", + "is_primary": true, + "is_360": false, + "is_color": false + }, + { + "product_id": 1111588191, + "url": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture2.jpg", + "state": "imported", + "is_primary": false, + "is_360": false, + "is_color": false + }, + { + "product_id": 1111588191, + "url": "GREEN", + "state": "imported", + "is_primary": false, + "is_360": false, + "is_color": true + } + ] + } +} +``` diff --git a/docs/ru/md/Ozon/Uploading-and-updating-products/Update-products-articles.md b/docs/ru/md/Ozon/Uploading-and-updating-products/Update-products-articles.md new file mode 100644 index 0000000000..3a5f9934f3 --- /dev/null +++ b/docs/ru/md/Ozon/Uploading-and-updating-products/Update-products-articles.md @@ -0,0 +1,51 @@ +--- +sidebar_position: 11 +--- + +# Изменить артикулы товаров + Изменяет артикулы существующих товаров + + + +`Функция ИзменитьАртикулыТоваров(Знач IDКлиента, Знач КлючAPI, Знач СоответствиеАртикулов) Экспорт` + + | Параметр | CLI опция | Тип | Назначение | + |-|-|-|-| + | IDКлиента | --clientid | Строка | Идентификатор клиента | + | КлючAPI | --apikey | Строка | API ключ | + | СоответствиеАртикулов | --offers | Соответствие Из КлючИЗначение | Артикулы: Ключ > старый, Значение > новый | + + + Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Ozon Seller API + +
+ +:::tip +Метод в документации API: [post /v1/product/update/offer-id](https://docs.ozon.ru/api/seller/#operation/ProductAPI_ProductUpdateOfferID) +::: +
+ + +```bsl title="Пример кода" + IDКлиента = "2128753"; + КлючAPI = "7cc90d26-33e4-499b..."; + + СоответствиеАртикулов = Новый Соответствие; + СоответствиеАртикулов.Вставить("143210608", "143210609"); + + Результат = OPI_Ozon.ИзменитьАртикулыТоваров(IDКлиента, КлючAPI, СоответствиеАртикулов); +``` + + + +```sh title="Пример команды CLI" + +oint ozon ИзменитьАртикулыТоваров --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --offers %offers% + +``` + +```json title="Результат" +{ + "errors": [] +} +```