# Инвойсбокс API — Справочники > Раздел документации целиком. Полное оглавление: https://docs.invoicebox.ru/llms.txt ## Справочники - [Коды ОКЕИ](https://docs.invoicebox.ru/raw/dictionary/okei.md) (раздел «Справочники») - [Поиск по ИНН](https://docs.invoicebox.ru/raw/dictionary/counterparty-detail.md) (раздел «Справочники») - [Коды валют](https://docs.invoicebox.ru/raw/dictionary/iso4217.md) (раздел «Справочники») - [Признак предмета расчёта (тег 1212)](https://docs.invoicebox.ru/raw/dictionary/tag1212.md) (раздел «Справочники») - [Мера количества предмета расчёта (тег 2108)](https://docs.invoicebox.ru/raw/dictionary/tag2108.md) (раздел «Справочники») - [Ставка НДС (тег 1199)](https://docs.invoicebox.ru/raw/dictionary/tag1199.md) (раздел «Справочники») - [Справочники](https://docs.invoicebox.ru/raw/dictionary/dictionary.md) - [Коды ошибок](https://docs.invoicebox.ru/raw/dictionary/error.md) (раздел «Справочники») --- # Коды ОКЕИ # Коды ОКЕИ Код единицы измерения передаётся в поле `measureCode` позиции корзины при [создании заказа](/docs/merchant/order/create/#basketitem), а рядом в `measure` — обозначение для человека: «шт.», «кг». Не путайте этот справочник с [мерой количества в чеке](/docs/dictionary/tag2108/): там перечень ФНС и другие значения. Ниже представлены наиболее популярные коды общероссийского классификатора единиц измерения (ОКЕИ). Полный справочник кодов доступен на сайте [Федеральной службы государственной статистики](https://rosstat.gov.ru/opendata/7708234640-okei). ## Экономические единицы | Код | Наименование | Обозначение | Международное | | --- | --- | --- | --- | | 796 | Штука | шт | pc ## Единицы длины | Код | Наименование | Обозначение | Международное | | --- | --- | --- | --- | | 003 | Миллиметр | мм | mm | 004 | Сантиметр | см | cm | 005 | Дециметр | дм | dm | 006 | Метр | м | m | 008 | Километр | км | km | 009 | Мегаметр | Мм | Mm | 018 | Погонный метр | пог. м | | 020 | Условный метр | усл. м | | 039 | Дюйм | дюйм | in | 041 | Фут | фут | ft | 043 | Ярд | ярд | yd | 047 | Морская миля | миля | mile ## Единицы площади | Код | Наименование | Обозначение | Международное | | --- | --- | --- | --- | | 050 | Квадратный миллиметр | мм2 | mm2 | 051 | Квадратный сантиметр | см2 | cm2 | 053 | Квадратный дециметр | дм2 | dm2 | 055 | Квадратный метр | м2 | m2 | 059 | Гектар | га | ha | 061 | Квадратный километр | км2 | km2 | 071 | Квадратный дюйм | дюйм2 | in2 | 073 | Квадратный фут | фут2 | ft2 | 075 | Квадратный ярд | ярд2 | yd2 | 109 | Ар | а | a ## Единицы объёма | Код | Наименование | Обозначение | Международное | | --- | --- | --- | --- | | 110 | Кубический миллиметр | мм3 | mm3 | 111 | Кубический сантиметр | см3 | cm3 | 112 | Литр | л | L | 113 | Кубический метр | м3 | m3 | 118 | Децилитр | дл | dl | 122 | Гектолитр | гл | hl | 126 | Мегалитр | Мл | Ml | 131 | Кубический дюйм | дюйм3 | in3 | 132 | Кубический фут | фут3 | ft3 | 133 | Кубический ярд | ярд3 | yd3 | 159 | Миллион кубических метров | м3 | m3 ## Единицы массы | Код | Наименование | Обозначение | Международное | | --- | --- | --- | --- | | 160 | Гектограмм | гг | hg | 161 | Миллиграмм | мг | mg | 162 | Метрический карат | кар | МС | 163 | Грамм | г | g | 166 | Килограмм | кг | kg | 168 | Тонна | т | t | 170 | Килотонна | кт | kt | 173 | Сантиграмм | сг | cg | 181 | Брутто-регистровая тонна | БРТ | | 185 | Грузоподъемность в метрических тоннах | т | | 206 | Центнер (метрический) | ц |q --- --- # Поиск по ИНН # Поиск и получение данных об организации по ИНН Реквизиты организации возвращает запрос по ИНН: - метод: `GET` - ресурс: `/v3/filter/api/counterparty-detail` - тело ответа — коллекция объектов [Counterparty](#counterparty) в свойстве `data` В запросе есть обязательный параметр `vatNumber` — ИНН. Метод нужен, чтобы подставить реквизиты плательщика в заказ, не заставляя покупателя вводить их руками: по ИНН возвращаются наименование, КПП и адреса, которые затем уходят в [создание заказа](/docs/merchant/order/create/#customer). > [!IMPORTANT] > Если организация не найдена или справочный сервис недоступен, метод отвечает `200` с пустым `data`. > Обрабатывайте это как «данных нет», а не как ошибку: пустой ответ не означает, что запрос не удался. Пример запроса: #### 🌐 HTTP ```http GET /v3/filter/api/counterparty-detail?vatNumber=2323232323 Accept: application/json User-Agent: MyApp 1.0 Authorization: Bearer b37c4c689295904ed21eee5d9a48d42e ``` #### 🧊 CURL ```bash curl -L -X GET '{baseUrl}/v3/filter/api/counterparty-detail?vatNumber=2323232323' \ -H 'Accept: application/json' \ -H 'User-Agent: MyApp 1.0' \ -H 'Authorization: Bearer b37c4c689295904ed21eee5d9a48d42e' ``` #### Пример запроса и ответа ``` json GET /v3/filter/api/counterparty-detail Authorization: Bearer b37c4c689295904ed21eee5d9a48d42e Content-Type: application/json User-Agent: MyApp 1.0 Accept: application/json ``` Ответ: ``` json { "data": [ { "id": "01771534-196a-1105-839a-82422289d6d9", "vatNumber": "7736207543", "taxRegistrationReasonCode": "773601001", "name": "ООО «Ромашка»", "nameFull": "Общество с ограниченной ответственностью «Ромашка»", "registrationNumber": "1027700123456", "registrationDate": "2015-04-12T00:00:00+03:00", "registrationAddress": "119021, г. Москва, ул. Тимура Фрунзе, д. 11", "postAddress": "119021, г. Москва, ул. Тимура Фрунзе, д. 11", "postAddressZip": "119021" } ], "metaData": { "totalCount": 1, "pageSize": 20, "page": 1 } } ``` ## Counterparty | Свойство | Обязательное | Тип | Описание | |---------------------------|--------------|-----------------|--------------------------------------------------| | id | да | string(36) | Идентификатор оригнизации в системе Инвойсбокс | | vatNumber | да | string(20) | ИНН | | taxRegistrationReasonCode | нет | string(9) | КПП | | name | нет | string(100) | Наименование организации | | nameFull | нет | string(300) | Полное наименование организации | | nameI18n | нет | string(300) | Полное наименование организации на языке региона | | registrationNumber | нет | string(20) | Регистрационный код организации | | registrationDate | нет | datetime | Дата регистрации организации | | registrationAddress | нет | string(200) | Адрес регистрации организации | | postAddress | нет | string(200) | Почтовый адрес организации | | postAddressZip | нет | string(6) | Почтовый индекс организации | --- --- # Коды валют # Коды валют (ISO 4217) Ниже представлены коды валют, используемые в системе. Полный классификатор валют доступен на сайте [Центрального банка России](https://www.cbr.ru/development/mcirabis/kv/). ## Экономические единицы | Код | Наименование | Знак | |------|------------------|------| | RUB | Российский рубль | ₽ | | CNY | Юань | ¥ | | UZS | Узбекский сум | сум | | EUR | Евро | € | | GBP | Фунт стерлингов | £ | | USD | Доллар США | $ | --- --- # Признак предмета расчёта (тег 1212) # Признак предмета расчёта (тег 1212) Тег 1212 говорит, что именно продаётся: товар, работа, услуга, аванс. Значение передаётся идентификатором в поле `type` позиции корзины при [создании заказа](/docs/merchant/order/create/#basketitem) и попадает в фискальный чек. ## Что передавать в API | Идентификатор | Что означает | |---|---| | `commodity` | товар, кроме подакцизного | | `excise` | подакцизный товар | | `job` | работа | | `service` | услуга | | `payment` | аванс, задаток, предоплата, кредит | | `property_right` | передача имущественных прав | | `another` | иной предмет расчёта | У остальных признаков таблицы ФНС идентификатора нет: они относятся к деятельности, которую Инвойсбокс не обслуживает (ставки, лотереи, вознаграждение платёжного агента), и в поле `type` не передаются. ## Таблица ФНС Таблица 101. Значения реквизита «признак предмета расчёта» (тег 1212), содержащихся в реквизите «наименование предмета расчёта» (тег 1030) реквизита ФД в печатной форме. | Код | Идентификатор | Реквизит «наименование предмета расчёта» (тег 1030) содержит сведения | Формат ПФ | --- | --- | --- | --- | | 1 | commodity | О реализуемом товаре, за исключением подакцизного товара и товара, подлежащего маркировке средствами идентификации (наименование и иные сведения, описывающие товар) | «ТОВАР» или «Т» или может не печататься | 2 | excise | О реализуемом подакцизном товаре, за исключением товара, подлежащего маркировке средствами идентификации (наименование и иные сведения, описывающие товар) | «ПОДАКЦИЗНЫЙ ТОВАР» или «АТ» или может не печататься | 3 | job | О выполняемой работе (наименование и иные сведения, описывающие работу) | «РАБОТА» или «Р» или может не печататься | 4 | service | Об оказываемой услуге (наименование и иные сведения, описывающие услугу) | «УСЛУГА» или «У» или может не печататься | 5 | --- | О приёме ставок при осуществлении деятельности по проведению азартных игр | «СТАВКА АЗАРТНОЙ ИГРЫ» или «СТАВКА ИГРЫ» или «СА» или может не печататься | 6 | --- | О выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр | «ВЫИГРЫШ АЗАРТНОЙ ИГРЫ» или «ВЫИГРЫШ АИ» или «ВА» или может не печататься | 7 | --- | О приёме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей | «ЛОТЕРЕЙНЫЙ БИЛЕТ» или «СТАВКА ЛОТЕРЕИ» или «СЛ» или может не печататься | 8 | --- | О выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей | «ВЫИГРЫШ ЛОТЕРЕИ» или «ВЛ» или может не печататься | 9 | --- | О предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации | «ПРЕДОСТАВЛЕНИЕ РИД» или «РИД» или может не печататься | 10 | payment | Об авансе, задатке, предоплате, кредите | «ПЛАТЁЖ» или «П»или может не печататься | 11 | --- | О вознаграждении пользователя, являющегося платёжным агентом (субагентом), банковским платёжным агентом (субагентом), комиссионером, поверенным или иным агентом | «АГЕНТСКОЕ ВОЗНАГРАЖДЕНИЕ» или «АВ» | 12 | --- | О взносе в счёт оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчёта | «ВЫПЛАТА» или «В» или может не печататься | 13 | another | О предмете расчёта, не относящемуся к предметам расчёта, которым может быть присвоено значение от «1» до «11» и от «14» до «26» | «ИНОЙ ПРЕДМЕТ РАСЧЁТА» или «ИПР» или может не печататься | 14 | property_right | О передаче имущественных прав | «ИМУЩЕСТВЕННОЕ ПРАВО» или может не печататься | 15 | --- | О внереализационном доходе | «ВНЕРЕАЛИЗАЦИОННЫЙ ДОХОД» или может не печататься | 16 | --- | О суммах расходов, платежей и взносов, указанных в подпунктах 2 и 3 пункта Налогового кодекса Российской Федерации, уменьшающих сумму налога | «ИНЫЕ ПЛАТЕЖИ И ВЗНОСЫ» или может не печататься | 17 | --- | О суммах уплаченного торгового сбора | «ТОРГОВЫЙ СБОР» или может не печататься | 18 | --- | О курортном сборе | «КУРОРТНЫЙ СБОР» или может не печататься | 19 | --- | О залоге | «ЗАЛОГ» или может не печататься | 20 | --- | О суммах произведенных расходов в соответствии со статьей 346.16 Налогового кодекса Российской Федерации, уменьшающих доход | «РАСХОД» или может не печататься | 21 | --- | О страховых взносах на обязательное пенсионное страхование, уплачиваемых ИП, не производящими выплаты и иные вознаграждения физическим лицам | «ВЗНОСЫ НА ОБЯЗАТЕЛЬНОЕ ПЕНСИОННОЕ СТРАХОВАНИЕ ИП» или «ВЗНОСЫ НА ОПС ИП» или может не печататься | 22 | --- | О страховых взносах на обязательное пенсионное страхование, уплачиваемых организациями и ИП, производящими выплаты и иные вознаграждения физическим лицам | «ВЗНОСЫ НА ОБЯЗАТЕЛЬНОЕ ПЕНСИОННОЕ СТРАХОВАНИЕ» или «ВЗНОСЫ НА ОПС» или может не печататься | 23 | --- | О страховых взносах на обязательное медицинское страхование, уплачиваемых ИП, не производящими выплаты и иные вознаграждения физическим лицам | «ВЗНОСЫ НА ОБЯЗАТЕЛЬНОЕ МЕДИЦИНСКОЕ СТРАХОВАНИЕ ИП» или «ВЗНОСЫ НА ОМС ИП» или может не печататься | 24 | --- | О страховых взносах на обязательное медицинское страхование, уплачиваемые организациями и ИП, производящими выплаты и иные вознаграждения физическим лицам | «ВЗНОСЫ НА ОБЯЗАТЕЛЬНОЕ МЕДИЦИНСКОЕ СТРАХОВАНИЕ» или «ВЗНОСЫ НА ОМС» или может не печататься | 25 | --- | О страховых взносах на обязательное социальное страхование на случай временной нетрудоспособности и в связи с материнством, на обязательное социальное страхование от несчастных случаев на производстве и профессиональных заболеваний | «ВЗНОСЫ НА ОБЯЗАТЕЛЬНОЕ СОЦИАЛЬНОЕ СТРАХОВАНИЕ» или «ВЗНОСЫ НА ОСС» или может не печататься | 26 | --- | О приёме и выплате денежных средств при осуществлении казино и залами игровых автоматов расчётов с использованием обменных знаков игорного заведения | «ПЛАТЕЖ КАЗИНО» или «ПК» или может не печататься | 27 | --- | О выдаче денежных средств банковским платёжным агентом | «ВЫДАЧА ДЕНЕЖНЫХ СРЕДСТВ» или «ВЫДАЧА ДС» или может не печататься | 30 | --- | О реализуемом подакцизном товаре, подлежащем маркировке средством идентификации, не имеющем кода маркировки | «АТНМ» или может не печататься | 31 | --- | О реализуемом подакцизном товаре, подлежащем маркировке средством идентификации, имеющем код маркировки | «АТМ» или может не печататься | 32 | --- | О реализуемом товаре, подлежащем маркировке средством идентификации, не имеющем кода маркировки, за исключением подакцизного товара | «ТНМ» или может не печататься | 33 | --- | О реализуемом товаре, подлежащем маркировке средством идентификации, имеющем код маркировки, за исключением подакцизного товара | «ТМ» или может не печататься Идентификатор используется в позиции корзины заказа в [методе создания заказа](/docs/merchant/order/create/#basketitem) --- --- # Мера количества предмета расчёта (тег 2108) # Мера количества предмета расчёта (тег 2108) Таблица 114. Значения реквизита «мера количества предмета расчёта» (тег 2108) Тег 2108 задаёт единицу измерения предмета расчёта в фискальном чеке. Перечень задан ФНС и **не совпадает** со [справочником ОКЕИ](/docs/dictionary/okei) — тот используется в поле `measureCode` позиции корзины, а сюда передают значение из первой колонки таблицы ниже. Единица измерения позиции указывается при [создании заказа](/docs/merchant/order/create/#basketitem). | Значение тега 2108 | Обозначение | Пояснение | № строки таблицы ФНС | | --- | --- | --- | --- | | 0 | шт. или ед. | Применяется для предметов расчёта, которые могут быть реализованы поштучно или единицами | 1 | | 10 | г | Грамм | 2 | | 11 | кг | Килограмм | 3 | | 12 | т | Тонна | 4 | | 20 | см | Сантиметр | 5 | | 21 | дм | Дециметр | 6 | | 22 | м | Метр | 7 | | 30 | кв. см | Квадратный сантиметр | 8 | | 31 | кв. дм | Квадратный дециметр | 9 | | 32 | кв. м | Квадратный метр | 10 | | 40 | мл | Миллилитр | 11 | | 41 | л | Литр | 12 | | 42 | куб. м | Кубический метр | 13 | | 50 | кВт∙ч | Киловатт час | 14 | | 51 | Гкал | Гигакалория | 15 | | 70 | сутки | Сутки (день) | 16 | | 71 | час | Час | 17 | | 72 | мин | Минута | 18 | | 73 | с | Секунда | 19 | | 80 | Кбайт | Килобайт | 20 | | 81 | Мбайт | Мегабайт | 21 | | 82 | Гбайт | Гигабайт | 22 | | 83 | Тбайт | Терабайт | 23 | | -- | - | 255 | Применяется при использовании иных единиц измерения, не поименованных в п.п. 1-23 Для значений этого реквизита никаких логических проверок не предусмотрено и в составе чека ОФД будут переданы те значения, которые поступили в карточках товаров. Если в карточке товара значение для этого тега отсутствует, то для всех товаров автоматически будет передано в ОФД значение 0 (в печатной форме - шт./ед.). --- --- # Ставка НДС (тег 1199) # Ставка НДС (тег 1199) > [!IMPORTANT] > С 2026 года основная ставка НДС — **22 %**. В примерах документации стоят коды `RUS_VAT22` > (налог в цене, расчётная 22/122) и `RUS_VAT22_ADDED` (налог сверх цены) — это не опечатка вместо 20 %. > Ставки прошлых лет остались в таблице: они нужны для возвратов и корректировок по старым заказам. Ставка передаётся кодом Инвойсбокса в поле `vatCode` позиции корзины при [создании заказа](/docs/merchant/order/create/#basketitem). Таблица 8. Значения реквизита «Ставка НДС» (тег 1199) | Наименование ставки НДС | Значение реквизита | Формат ПФ | Код Инвойсбокс | Комментарий | |-------------------------| ------------------ |------------|-----------------| --------------------------------------------------------- | | ставка НДС 20% | 1 | НДС 20% | RUS_VAT20_ADDED | | | ставка НДС 10% | 2 | НДС 10% | RUS_VAT10_ADDED | | | ставка НДС расч. 20/120 | 3 | НДС 20/120 | RUS_VAT20 | | | ставка НДС расч. 10/110 | 4 | НДС 10/110 | RUS_VAT10 | | | ставка НДС 0% | 5 | НДС 0% | RUS_VAT0 | | | НДС не облагается | 6 | - | VATNONE | | | ставка НДС 5% | 7 | НДС 5% | RUS_VAT5_ADDED | введена приказом ФНС России № ЕД-7-20/1038 от 15.11.2024 | | ставка НДС 7% | 8 | НДС 7% | RUS_VAT7_ADDED | введена приказом ФНС России № ЕД-7-20/1038 от 15.11.2024 | | ставка НДС расч. 5/105 | 9 | НДС 5/105 | RUS_VAT5 | введена приказом ФНС России № ЕД-7-20/1038 от 15.11.2024 | | ставка НДС расч. 7/107 | 10 | НДС 7/107 | RUS_VAT7 | введена приказом ФНС России № ЕД-7-20/1038 от 15.11.2024 | | ставка НДС 22% | 11 | НДС 22% | RUS_VAT22_ADDED | введена законопроектом № 1026190-8 от 28.11.2025 | | ставка НДС расч. 22/122 | 12 | НДС 22/122 | RUS_VAT22 | введена законопроектом № 1026190-8 от 28.11.2025 | ## В чём разница между ставками НДС 22% и 22/122, 10% и 10/110, 7% и 7/107, 5% и 5/105? ### Обычные ставки (22%, 10%, 0% и т.д.) Когда использовать: Когда вы знаете цену товара БЕЗ НДС и вам нужно начислить (добавить) налог сверху. Как считать: Цена без НДС × Ставка Пример: Стулья стоят 1000 рублей без НДС. Ставка — 22%. - НДС = 1000 × 22% = 220 рублей. - Цена для покупателя = 1000 + 220 = 1220 рублей. ### Расчётные ставки (22/122, 10/110 и т.д.) Когда использовать: Когда у вас на руках итоговая сумма, в которую НДС УЖЕ ВКЛЮЧЁН, и вам нужно "вытащить" (выделить) из неё сумму налога. Как считать: Сумма с НДС × (Расчётная ставка) Пример: Вы получили аванс от клиента 1200 рублей за будущую поставку стульев. В этой сумме уже сидит НДС. Нужно понять, сколько из этих 1200 рублей - это сам налог. - НДС = 1200 × (22/122) = 216.39 рублей. - Значит, аванс без НДС = 1200 - 216.39 = 983.61 рублей. ### Простая аналогия Представьте торт 🥧. - Обычная ставка - это когда у вас есть корж (цена без налога), и вы сверху намазываете крем (НДС). - Расчётная ставка - это когда перед вами целый торт (цена с налогом), и вам нужно аккуратно снять с него крем, чтобы понять, сколько крема было. 22% - чтобы добавить налог к чистой цене. 22/122 - чтобы найти налог внутри итоговой суммы. То же самое для ставок 10% и 10/110. ## В чём разница между ставками НДС 0% и «НДС не облагается? Ставка НДС 0% и статус «НДС не облагается» - это не одно и то же. Ставка 0% - это льгота для плательщиков налога (например, при экспорте), которая позволяет не только не начислять НДС клиенту, но и вернуть себе весь «входной» НДС, уплаченный поставщикам, при выполнении условий. А операции, которые «не облагаются» НДС (например, медицинские услуги), полностью выведены из-под этого налога: налог с клиента не берётся, но и вернуть «входной» НДС по таким операциям уже нельзя - он включается в расходы. См. также: [создание заказа](/docs/merchant/order/create/) --- --- # Справочники # Справочники В текущем разделе описаны базовые справочники. --- # Коды ошибок # Коды ошибок Ошибка приходит в свойстве `error` объекта ответа — см. [структуру ответа](/docs/api/#структура-ответа). Перечень пополняется: незнакомый `code` обрабатывайте по HTTP-коду, а не игнорируйте. ## Авторизация и доступ | Код ошибки | HTTP | Что произошло | Что делать | |---|---|---|---| | `unauthorized` | 401 | Токен не передан или не распознан | Проверить заголовок `Authorization: Bearer <токен>` — [авторизация](/docs/api/auth/) | | `forbidden` | 403 | Доступ к ресурсу или объекту запрещён | Проверить, принадлежит ли объект вашему магазину и есть ли у токена нужные права | ## Проверка заказа (422) Все эти ошибки означают, что запрос дошёл и разобран, но данные не сходятся. Правило подсчёта сумм — в разделе [как считаются суммы](/docs/merchant/order/create/#как-считаются-суммы). | Код ошибки | Что произошло | Что делать | |---|---|---| | `wrong_expiration_date` | Неверный срок действия заказа | Проверить `expirationDate`: время в будущем, формат с часовым поясом | | `wrong_currency` | Неверная валюта | Проверить `currencyId` | | `language_not_found` | Неверный язык заказа | Проверить `languageId`: `ru` или `en` | | `wrong_basket_item_total_amount` | Итог позиции не сходится | `totalAmount` позиции = `quantity × amount` | | `wrong_basket_item_total_vat_amount` | НДС позиции не сходится | Пересчитать `totalVatAmount` по ставке из `vatCode` | | `wrong_basket_item_amount_wo_vat` | Стоимость позиции без НДС не сходится | Проверить `amountWoVat` для одной единицы | | `wrong_total_amount` | Сумма заказа не равна сумме позиций | `amount` заказа = сумма `totalAmount` позиций | | `wrong_total_vat_amount` | Сумма НДС заказа не равна сумме НДС позиций | `vatAmount` заказа = сумма `totalVatAmount` позиций | | `wrong_order_status` | Операция недопустима в текущем статусе | Посмотреть статус заказа и разрешённые переходы — [работа с заказом](/docs/merchant/order/) | | `merchant_order_id_duplicate` | Такой `merchantOrderId` уже использовался. Приходит, только если у магазина включена проверка уникальности (настройка меняется через поддержку) | Заказ с этим номером уже создан — найдите его выборкой и работайте с ним. Новый номер генерировать не нужно: так появится второй заказ на ту же покупку. См. [повтор после сбоя](/docs/merchant/order/create/#повтор-после-сбоя-и-таймаута) | ## Технические | HTTP | Что произошло | Что делать | |---|---|---| | 429 | Слишком много запросов | Снизить частоту и повторить с задержкой — [ограничения](/docs/api/limits/). Тело может не содержать `code` | | 500 | Необработанная ошибка на стороне сервиса | Результат операции неизвестен: запрос мог дойти. Чтение можно повторить сразу; после создания заказа, возврата или отмены сначала проверьте выборкой, прошла ли операция, — [повтор после сбоя](/docs/merchant/order/create/#повтор-после-сбоя-и-таймаута). Сообщите нам `x-request-id` из заголовков ответа. Тело может не содержать `code` | ---