Статус 409
Запрос с этим ключом ещё исполняется
idempotency_key_in_use
Когда возникает
Запрос с тем же Idempotency-Key ещё исполняется.
Что делать
Подождите Retry-After секунд и повторите запрос с тем же ключом: придёт сохранённый ответ.
Не нашли ответа или отказ повторяется? Напишите нам и назовите X-Request-Id из ответа — по нему мы найдём запрос. Написать нам
Какие методы его возвращают
- post
/categoriesСоздать категорию каталога - patch
/categories/{category}Изменить категорию каталога - delete
/categories/{category}Архивировать категорию каталога - patch
/categories/by-external-id/{external_id}Создать или изменить категорию каталога по внешнему id - post
/productsСоздать товар вместе с вариантами - patch
/products/{product}Изменить карточку товара: поля, категории, внешний id - delete
/products/{product}Архивировать товар вместе с вариантами - patch
/products/by-external-id/{external_id}Создать или изменить товар вместе с вариантами по внешнему id - put
/products/{product}/optionsЗаменить опции товара целиком и разложить по ним его варианты - post
/variantsДобавить вариант в товар - patch
/variants/{variant}Изменить вариант товара - delete
/variants/{variant}Архивировать вариант товара - patch
/variants/by-external-id/{external_id}Создать или изменить вариант по внешнему id - put
/variants/{variant}/recipeЗаменить тех-карту варианта: состав и выход заготовки - patch
/products/{product}/media/{media}Переставить фото в галерее или сделать главным - delete
/products/{product}/media/{media}Убрать фото из галереи товара - post
/products/{product}/mediaДобавить фото в галерею товара по адресу картинки - post
/modifier-groupsСоздать группу модификаторов с опциями - patch
/modifier-groups/{group}Изменить группу модификаторов и её набор опций - delete
/modifier-groups/{group}Архивировать группу модификаторов - patch
/modifier-groups/by-external-id/{external_id}Создать или изменить группу модификаторов по внешнему id - put
/products/{product}/modifier-groupsЗаменить группы модификаторов товара и надбавки их опций по вариантам - post
/recommendation-rulesСоздать правило рекомендаций - patch
/recommendation-rules/{rule}Изменить правило рекомендаций - delete
/recommendation-rules/{rule}Удалить правило рекомендаций - post
/price-listsЗавести оптовый прайс-лист - patch
/price-lists/{price_list}Изменить прайс-лист: процент и округление, у оптового — и имя; правило листа точки меняет цены во всех его точках - delete
/price-lists/{price_list}Удалить оптовый прайс-лист; назначение покупателям снимается с согласия - post
/price-lists/{price_list}/itemsЗадать ручные цены вариантов в прайс-листе пачкой - post
/price-lists/{price_list}/items/removeСнять ручные цены вариантов в прайс-листе пачкой - post
/price-lists/{price_list}/modifier-itemsЗадать ручные надбавки опций в прайс-листе пачкой - post
/price-lists/{price_list}/modifier-items/removeСнять ручные надбавки опций в прайс-листе пачкой - post
/inventory-levels/setУстановить физический остаток варианта на точке - post
/inventory-levels/adjustОприходовать или списать остаток на точке - post
/orders/{order}/statusПеревести заказ в другой статус магазина - post
/orders/{order}/cancelОтменить заказ - post
/orders/{order}/shipmentВыпустить отправление у перевозчика заказа: запрос исполняется в фоне, итог — в заказе и событием order.updated - post
/orders/{order}/shipment/trackingЗаписать номер отслеживания у службы доставки без интеграции: номер, ссылку и название службы - post
/orders/{order}/shipment/tracking/clearСнять номер отслеживания, записанный вручную - patch
/draft-orders/{draft}Изменить черновик заказа: покупателя, доставку, способ оплаты и позиции - delete
/draft-orders/{draft}Удалить черновик заказа - post
/draft-ordersСоздать черновик заказа для покупателя - post
/draft-orders/{draft}/completeОформить заказ из черновика: выставить счёт покупателю или записать оплату полученной - post
/payments/{payment}/confirmПодтвердить, что деньги по ожидающему счёту получены - post
/orders/{order}/refunds/calculateРассчитать возврат по заказу и остаток к возврату — ничего не пишет - post
/orders/{order}/refundsВернуть позиции и доставку заказа: деньги — по способам оплаты, товар — на склад - post
/refunds/{refund}/confirmПодтвердить, что деньги возврата отданы вне системы - post
/customersСоздать покупателя: имя и хотя бы один контакт - patch
/customers/{customer}Изменить имя, язык и внешний id покупателя - patch
/customers/by-external-id/{external_id}Создать или изменить покупателя по внешнему id - post
/customers/{customer}/wholesale-price-listНазначить покупателю оптовый прайс-лист или снять его - patch
/customers/{customer}/addresses/{address}Изменить адрес покупателя - delete
/customers/{customer}/addresses/{address}Удалить адрес из книги покупателя - post
/customers/{customer}/addressesДобавить адрес в книгу покупателя - put
/customers/{customer}/fiscal-profileЗаменить фискальные реквизиты покупателя целиком; null — розничный покупатель - post
/customer-groupsСоздать группу покупателей - patch
/customer-groups/{customer_group}Изменить имя, описание или активность группы - delete
/customer-groups/{customer_group}Удалить группу: членство уходит с ней, правила скидок и рассылки от неё отвязываются - post
/customer-groups/{customer_group}/membersДобавить покупателей в группу - post
/customer-groups/{customer_group}/members/removeСнять покупателей с группы - post
/orders/{order}/invoiceВыпустить фактуру по закрытой продаже: выпуск идёт в фоне, итог — событием - post
/fiscal-documents/{document}/reissueПеревыпустить документ после сбоя или отказа налоговой - post
/fiscal-documents/{document}/dismissСнять отклонённый документ с контроля: выпускать его не будут - post
/fiscal-documents/{document}/annulАннулировать выпущенную фактуру кредит-нотой - post
/money-transactionsРучной доход или расход по денежному счёту - patch
/money-transactions/{transaction}Правка движения денег: у движения с документом-источником — только статья, контрагент и описание - delete
/money-transactions/{transaction}Удаление ручного движения денег с возвратом остатка счёта - patch
/money-transfers/{money_transfer}Правка перевода целиком на месте: счета, суммы, комиссия, дата и описание - delete
/money-transfers/{money_transfer}Удаление перевода со всеми его частями - post
/money-transfersПеревод между денежными счетами, с комиссией или без - post
/customer-accounts/{customer_account}/paymentsПогашение долга покупателя деньгами, которые уже пришли: запись в книгу долгов со справками об удержаниях - post
/suppliersСоздать поставщика: реквизиты и условия расчётов - patch
/suppliers/{supplier}Изменить реквизиты, условия расчётов и внешний id поставщика - patch
/suppliers/by-external-id/{external_id}Создать или изменить поставщика по внешнему id - post
/supplier-billsСоздать черновик счёта поставщика - patch
/supplier-bills/{supplier_bill}Изменить черновик счёта поставщика - delete
/supplier-bills/{supplier_bill}Удалить черновик счёта поставщика - post
/supplier-bills/{supplier_bill}/postПровести счёт поставщика: он войдёт в кредиторку и книгу покупок - post
/supplier-bills/{supplier_bill}/voidАннулировать счёт поставщика вместе с его оплатами и зачётами - post
/supplier-bills/{supplier_bill}/approveОдобрить проведённый счёт поставщика к оплате - post
/supplier-bills/{supplier_bill}/revoke-approvalОтозвать одобрение счёта поставщика к оплате - post
/supplier-bills/{supplier_bill}/payments/out-of-bandОтметить счёт поставщика оплаченным вне системы - delete
/supplier-bills/{supplier_bill}/payments/{supplier_bill_payment}Отменить оплату счёта поставщика - post
/purchase-ordersСоздать черновик заказа поставщику - patch
/purchase-orders/{purchase_order}Изменить заказ поставщику: черновик целиком, размещённый — строки, дату и примечание с ревизией - delete
/purchase-orders/{purchase_order}Удалить черновик заказа поставщику - post
/purchase-orders/{purchase_order}/placeОтметить черновик размещённым у поставщика - post
/purchase-orders/{purchase_order}/cancelОтменить размещённый заказ поставщику - post
/purchase-orders/{purchase_order}/closeЗакрыть принятый заказ поставщику - post
/uploadsНачать загрузку файла частями — вход массовой операции - post
/uploads/{upload}/chunksДописать часть файла сырым телом - post
/bulk-operationsНачать массовую операцию по загрузке или адресу входа, выгрузку ленты или сборку файла - post
/bulk-operations/{operation}/cancelОтменить массовую операцию на границе строки - post
/webhook-endpointsДобавить адрес вебхука и подписать его на типы событий - patch
/webhook-endpoints/{endpoint}Изменить адрес вебхука: URL, подпись, типы событий, включение - delete
/webhook-endpoints/{endpoint}Удалить адрес вебхука - post
/webhook-endpoints/{endpoint}/rotate-secretВыпустить новый секрет подписи: прежний ещё 24 часа подписывает доставки вместе с ним - post
/webhook-endpoints/{endpoint}/testОтправить на адрес тестовое событие ping — одна попытка, подписанная текущим секретом - post
/webhook-deliveries/{delivery}/retryПовторить доставку сейчас — тем же телом и с тем же webhook-id
Тело ответа
application/problem+json · ConflictProblem
typestringобязательноМашинный тип отказа: стабильный код для ветвления, например insufficient_scope. У каждого типа есть страница в каталоге ошибок.
titlestringобязательноКраткое описание отказа на языке запроса.
statusintegerобязательноHTTP-статус ответа.
detailstringОбъяснение этого случая на языке запроса.
currentobjectЗапись сейчас — поля, о которых конфликт: on_hand у stock_on_hand_changed, status у отказа в смене заказа, status и order_id у закрытого черновика.
external_idstringУ external_id_in_use и external_id_archived — занятый внешний id.
consent_kindstringУ consent_required — вид последствия, на который нужно согласие.
consequencesсловарь integerУ consent_required — что изменится: вид данных → число записей.
- Минимум:
- 0
consent_tokenstringУ consent_required — отпечаток показанных последствий. Повторите запрос с consent[<consent_kind>]=<consent_token>.
variant_idintegerУ consent_required для строки варианта в записи товара — вариант: согласие даётся правкой этого варианта (PATCH /v1/variants/{variant}).
limitintegerУ plan_limit_reached, address_book_full, bulk_operation_queue_full и webhook_endpoint_limit_reached — потолок.
- Минимум:
- 0
fieldstringУ customer_contact_in_use — контакт, который принадлежит другому покупателю: phone или email.
- Значения:
phoneemail
existing_customer_idintegerУ customer_contact_in_use — покупатель, которому принадлежит контакт.
receivedintegerУ upload_offset_mismatch — сколько байт загрузка уже приняла: смещение, с которого продолжить.
- Минимум:
- 0
operation_statusstringУ bulk_operation_finished — статус, с которым операция закончилась.