# Инвойсбокс 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) (раздел «Справочники»)


---
<!-- https://docs.invoicebox.ru/docs/dictionary/okei/ · markdown: https://docs.invoicebox.ru/raw/dictionary/okei.md -->

# Коды ОКЕИ

Код единицы измерения передаётся в поле `measureCode` позиции корзины при
[создании заказа](/docs/merchant/order/create/#basketitem), а рядом в `measure` — обозначение для
человека: «шт.», «кг». Не путайте этот справочник с
[мерой количества в чеке](/docs/dictionary/tag2108/): там перечень ФНС и другие значения.

Ниже — весь классификатор: 543 кода по разделам и подразделам. Поиск по странице фильтрует
таблицы на месте, поэтому искать можно и по коду, и по названию.

## Что берут чаще всего

| Код | Наименование | Обозначение | Международное |
| --- | --- | --- | --- |
| 796 | Штука | шт | pc |
| 006 | Метр | м | m |
| 166 | Килограмм | кг | kg |
| 112 | Литр | л | l |
| 113 | Кубический метр | м3 | m3 |
| 055 | Квадратный метр | м2 | m2 |
| 356 | Час | ч | h |
| 359 | Сутки | сут | day |
| 366 | Год | год | year |
| 383 | Рубль | руб | RUB |
| 744 | Процент | % | % |

> [!IMPORTANT]
> Обозначения и международные коды в открытых данных Росстата не публикуются, поэтому в полном
> справочнике ниже их нет — только код и наименование. Для `measure` берите обозначение из этой
> таблицы или из официального текста классификатора; выдумывать его нельзя, оно попадает в чек.

## Международные единицы измерения, включенные в ОКЕИ

### Единицы длины

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 003 | Миллиметр | мм |
| 004 | Сантиметр | см |
| 005 | Дециметр | — |
| 006 | Метр | м |
| 008 | Километр | км |
| 009 | Мегаметр | — |
| 039 | Дюйм (25,4 мм) | — |
| 041 | Фут (0,3048 м) | — |
| 043 | Ярд (0,9144 м) | — |
| 047 | Морская миля (1852 м) | — |

### Единицы площади

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 050 | Квадратный миллиметр | — |
| 051 | Квадратный сантиметр | — |
| 053 | Квадратный дециметр | — |
| 055 | Квадратный метр | м2 |
| 058 | Тысяча квадратных метров | — |
| 059 | Гектар | — |
| 061 | Квадратный километр | — |
| 071 | Квадратный дюйм (645,16 мм2) | — |
| 073 | Квадратный фут (0,092903 м2) | — |
| 075 | Квадратный ярд (0,8361274 м2) | — |
| 109 | Ар (100 м2) | — |

### Единицы объема

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 110 | Кубический миллиметр | — |
| 111 | Кубический сантиметр | — |
| 112 | Литр | л |
| 113 | Кубический метр | м3 |
| 118 | Децилитр | — |
| 122 | Гектолитр | — |
| 126 | Мегалитр | — |
| 131 | Кубический дюйм (16387,1 мм3) | — |
| 132 | Кубический фут (0,02831685 м3) | — |
| 133 | Кубический ярд (0,764555 м3) | — |
| 159 | Миллион кубических метров | — |

### Единицы массы

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 160 | Гектограмм | — |
| 161 | Миллиграмм | — |
| 162 | Метрический карат^(1 карат=200 мг=2.10[-4*] кг) | — |
| 163 | Грамм | г |
| 164 | Микрограмм | — |
| 166 | Килограмм | кг |
| 168 | Тонна | т |
| 170 | Килотонна | — |
| 173 | Сантиграмм | — |
| 181 | Брутто-регистровая тонна (2,8316 м[3*]) | — |
| 185 | Грузоподъемность в метрических тоннах | — |
| 206 | Центнер (метрический)^(100 кг) | — |

### Технические единицы

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 212 | Ватт | — |
| 214 | Киловатт | — |
| 215 | Мегаватт | — |
| 222 | Вольт | — |
| 223 | Киловольт | — |
| 227 | Киловольт-ампер | — |
| 228 | Мегавольт-ампер (тысяча киловольт-ампер) | — |
| 230 | Киловар | — |
| 243 | Ватт-час | — |
| 245 | Киловатт-час | кВт·ч |
| 246 | Мегаватт-час | МВт·ч |
| 247 | Гигаватт-час (миллион киловатт-часов) | — |
| 260 | Ампер | — |
| 263 | Ампер-час (3,6 кКл) | — |
| 264 | Тысяча ампер-часов | — |
| 270 | Кулон | — |
| 271 | Джоуль | — |
| 273 | Килоджоуль | — |
| 274 | Ом | — |
| 280 | Градус Цельсия | — |
| 281 | Градус Фаренгейта | — |
| 282 | Кандела | — |
| 283 | Люкс | — |
| 284 | Люмен | — |
| 288 | Кельвин | — |
| 289 | Ньютон | — |
| 290 | Герц | — |
| 291 | Килогерц | — |
| 292 | Мегагерц | — |
| 294 | Паскаль | — |
| 296 | Сименс | — |
| 297 | Килопаскаль | — |
| 298 | Мегапаскаль | — |
| 300 | Физическая атмосфера (101325 Па) | — |
| 301 | Техническая атмосфера (98066,5 Па) | — |
| 302 | Гигабеккерель | — |
| 303 | Килобеккерель | — |
| 304 | Милликюри | — |
| 305 | Кюри | — |
| 306 | Грамм делящихся изотопов | — |
| 307 | Мегабеккерель | — |
| 308 | Миллибар | — |
| 309 | Бар | — |
| 310 | Гектобар | — |
| 312 | Килобар | — |
| 314 | Фарад | — |
| 316 | Киллограмм на кубический метр | — |
| 318 | Зиверт | — |
| 319 | Микрозиверт | — |
| 320 | Моль | — |
| 321 | Миллизиверт | — |
| 323 | Беккерель | — |
| 324 | Вебер | — |
| 327 | Узел (миля/ч) | — |
| 328 | Метр в секунду | — |
| 330 | Оборот в секунду | — |
| 331 | Оборот в минуту | — |
| 333 | Километр в час | — |
| 335 | Метр на секунду в квадрате | — |
| 349 | Кулон на килограмм | — |

### Единицы времени

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 354 | Секунда | — |
| 355 | Минута | мин |
| 356 | Час | ч |
| 359 | Сутки | сут |
| 360 | Неделя | — |
| 361 | Декада | — |
| 362 | Месяц | мес |
| 364 | Квартал | — |
| 365 | Полугодие | — |
| 366 | Год | год |
| 368 | Десятилетие | — |

### Экономические единицы

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 499 | Килограмм в секунду | — |
| 533 | Тонна пара в час | — |
| 596 | Кубический метр в секунду | — |
| 598 | Кубический метр в час | — |
| 599 | Тысяча кубических метров в сутки | — |
| 616 | Бобина | — |
| 625 | Лист | лист |
| 626 | Сто листов | — |
| 630 | Тысяча стандартных условных кирпичей | — |
| 641 | Дюжина (12 шт.) | — |
| 657 | Изделие | — |
| 683 | Сто ящиков | — |
| 704 | Набор | — |
| 715 | Пара (2 шт.) | — |
| 730 | Два десятка | — |
| 732 | Десять пар | — |
| 733 | Дюжина пар | — |
| 734 | Посылка | — |
| 735 | Часть | — |
| 736 | Рулон | рул |
| 737 | Дюжина рулонов | — |
| 740 | Дюжина штук | — |
| 745 | Элемент | — |
| 778 | Упаковка | упак |
| 780 | Дюжина упаковок | — |
| 781 | Сто упаковок | — |
| 796 | Штука | шт |
| 797 | Сто штук | — |
| 798 | Тысяча штук | тыс шт |
| 799 | Миллион штук | — |
| 800 | Миллиард штук | — |
| 801 | Биллион штук (Европа) | — |
| 802 | Квинтильон штук (Европа) | — |
| 820 | Крепость спирта по массе | — |
| 821 | Крепость спирта по объему | — |
| 831 | Литр чистого (100 %) спирта | — |
| 833 | Гектолитр чистого (100 %) спирта | — |
| 841 | Килограмм пероксида водорода | — |
| 845 | Килограмм 90 %-го сухого вещества | — |
| 847 | Тонна 90 %-го сухого вещества | — |
| 852 | Килограмм оксида калия | — |
| 859 | Килограмм гидроксида калия | — |
| 861 | Килограмм азота | — |
| 863 | Килограмм гидроксида натрия | — |
| 865 | Килограмм пятиокиси фосфора | — |
| 867 | Килограмм урана | — |

## Национальные единицы измерения, включенные в ОКЕИ

### Единицы длины

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 015 | Нанометр | — |
| 018 | Погонный метр | — |
| 019 | Тысяча погонных метров | — |
| 020 | Условный метр | — |
| 048 | Тысяча условных метров | — |
| 049 | Километр условных труб | — |

### Единицы площади

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 054 | Тысяча квадратных дециметров | — |
| 056 | Миллион квадратных дециметров | — |
| 057 | Миллион квадратных метров | — |
| 060 | Тысяча гектаров | — |
| 062 | Условный квадратный метр | — |
| 063 | Тысяча условных квадратных метров | — |
| 064 | Миллион условных квадратных метров | — |
| 081 | Квадратный метр общей площади | — |
| 082 | Тысяча квадратных метров общей площади | — |
| 083 | Миллион квадратных метров общей площади | — |
| 084 | Квадратный метр жилой площади | — |
| 085 | Тысяча квадратных метров жилой площади | — |
| 086 | Миллион квадратных метров жилой площади | — |
| 087 | Квадратный метр учебно-лабораторных зданий | — |
| 088 | Тысяча квадратных метров учебно-лабораторных зданий | — |
| 089 | Миллион квадратных метров в двухмиллиметровом исчислении | — |

### Единицы объема

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 114 | Тысяча кубических метров | — |
| 115 | Миллиард кубических метров | — |
| 116 | Декалитр | — |
| 119 | Тысяча декалитров | — |
| 120 | Миллион декалитров | — |
| 121 | Плотный кубический метр | — |
| 123 | Условный кубический метр | — |
| 124 | Тысяча условных кубических метров | — |
| 125 | Миллион кубических метров переработки газа | — |
| 127 | Тысяча плотных кубических метров | — |
| 128 | Тысяча полулитров | — |
| 129 | Миллион полулитров | — |
| 130 | Тысяча литров | — |

### Единицы массы

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 165 | Тысяча каратов метрических | — |
| 167 | Миллион каратов метрических | — |
| 169 | Тысяча тонн | — |
| 171 | Миллион тонн | — |
| 172 | Тонна условного топлива | — |
| 175 | Тысяча тонн условного топлива | — |
| 176 | Миллион тонн условного топлива | — |
| 177 | Тысяча тонн единовременного хранения | — |
| 178 | Тысяча тонн переработки | — |
| 179 | Условная тонна | — |
| 207 | Тысяча центнеров | — |

### Технические единицы

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 226 | Вольт-ампер | — |
| 231 | Метр в час | — |
| 232 | Килокалория | — |
| 233 | Гигакалория | Гкал |
| 234 | Тысяча гигакалорий | — |
| 235 | Миллион гигакалорий | — |
| 236 | Калория в час | — |
| 237 | Килокалория в час | — |
| 238 | Гигакалория в час | — |
| 239 | Тысяча гигакалорий в час | — |
| 241 | Миллион ампер-часов | — |
| 242 | Миллион киловольт-ампер | — |
| 248 | Киловольт-ампер реактивный | — |
| 249 | Миллиард киловатт-часов | — |
| 250 | Тысяча киловольт-ампер реактивных | — |
| 251 | Лошадиная сила | — |
| 252 | Тысяча лошадиных сил | — |
| 253 | Миллион лошадиных сил | — |
| 254 | Бит | — |
| 255 | Байт | — |
| 256 | Килобайт | — |
| 257 | Мегабайт | — |
| 258 | Бод | — |
| 287 | Генри | — |
| 313 | Тесла | — |
| 317 | Килограмм на квадратный сантиметр | — |
| 337 | Миллиметр водяного столба | — |
| 338 | Миллиметр ртутного столба | — |
| 339 | Сантиметр водяного столба | — |
| 340 | Грамм условного топлива на 1 киловатт-час | — |
| 341 | Килограмм условного топлива на гигакалорию | — |
| 348 | Фемтосекунда | — |

### Единицы времени

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 350 | Пикосекунда | — |
| 351 | Наносекунда | — |
| 352 | Микросекунда | — |
| 353 | Миллисекунда | — |

### Экономические единицы

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 383 | Рубль | руб |
| 384 | Тысяча рублей | тыс руб |
| 385 | Миллион рублей | — |
| 386 | Миллиард рублей | — |
| 387 | Триллион рублей | — |
| 388 | Квадрильон рублей | — |
| 414 | Пассажиро-километр | — |
| 421 | Пассажирское место (пассажирских мест) | — |
| 423 | Тысяча пассажиро-километров | — |
| 424 | Миллион пассажиро-километров | — |
| 426 | Пар грузовых поездов в сутки | — |
| 427 | Пассажиропоток | — |
| 428 | Кубический метр-километр | — |
| 430 | Миллион кубических метров-километров | — |
| 431 | Взлетов-посадок в час | — |
| 435 | Миллион километров | — |
| 449 | Тонно-километр | — |
| 450 | Тысяча тонно-километров | — |
| 451 | Миллион тонно-километров | — |
| 452 | Миллиард тонно-километров | — |
| 479 | Тысяча наборов | — |
| 508 | Тысяча метров кубических в час | — |
| 509 | Километр в сутки | — |
| 510 | Грамм на киловатт-час | — |
| 511 | Килограмм на гигакалорию | — |
| 512 | Тонно-номер | — |
| 513 | Автотонна | — |
| 514 | Тонна тяги | — |
| 515 | Дедвейт-тонна | — |
| 516 | Тонна-танид | — |
| 518 | Квадратных метров на человека | — |
| 521 | Человек на квадратный метр | — |
| 522 | Человек на квадратный километр | — |
| 534 | Тонна в час | — |
| 535 | Тонна в сутки | — |
| 536 | Тонна в смену | — |
| 537 | Тысяча тонн в сезон | — |
| 538 | Тысяча тонн в год | — |
| 539 | Человеко-час | — |
| 540 | Человеко-день | — |
| 541 | Тысяча человеко-дней | — |
| 542 | Тысяча человеко-часов | — |
| 543 | Тысяча условных банок в смену | — |
| 544 | Миллион единиц в год | — |
| 545 | Посещение в смену | — |
| 546 | Тысяча посещений в смену | — |
| 547 | Пара в смену | — |
| 548 | Тысяча пар в смену | — |
| 550 | Миллион тонн в год | — |
| 552 | Тонна переработки в сутки | — |
| 553 | Тысяча тонн переработки в сутки | — |
| 554 | Центнер переработки в сутки | — |
| 555 | Тысяча центнеров переработки в сутки | — |
| 556 | Тысяча голов в год | — |
| 557 | Миллион голов в год | — |
| 558 | Тысяча птицемест | — |
| 559 | Тысяча кур-несушек | — |
| 561 | Тысяча тонн пара в час | — |
| 562 | Тысяча прядильных веретен | — |
| 563 | Тысяча прядильных мест | — |
| 639 | Доза | — |
| 640 | Тысяча доз | — |
| 642 | Единица | — |
| 643 | Тысяча единиц | — |
| 644 | Миллион единиц | — |
| 661 | Канал | — |
| 673 | Тысяча комплектов | — |
| 698 | Место | — |
| 699 | Тысяча мест | — |
| 709 | Тысяча номеров | — |
| 724 | Тысяча гектаров порций | — |
| 728 | Пачка | — |
| 729 | Тысяча пачек | — |
| 744 | Процент | % |
| 746 | Промилле (0,1 процента) | — |
| 747 | Базисный пункт | — |
| 751 | Тысяча рулонов | — |
| 761 | Тысяча станов | — |
| 762 | Станция | — |
| 775 | Тысяча тюбиков | — |
| 776 | Тысяча условных тубов | — |
| 779 | Миллион упаковок | — |
| 782 | Тысяча упаковок | — |
| 792 | Человек | — |
| 793 | Тысяча человек | — |
| 794 | Миллион человек | — |
| 808 | Миллион экземпляров | — |
| 810 | Ячейка | — |
| 812 | Ящик | — |
| 836 | Голова | — |
| 837 | Тысяча пар | — |
| 838 | Миллион пар | — |
| 839 | Комплект | компл |
| 840 | Секция | — |
| 868 | Бутылка | бут |
| 869 | Тысяча бутылок | — |
| 870 | Ампула | — |
| 871 | Тысяча ампул | — |
| 872 | Флакон | — |
| 873 | Тысяча флаконов | — |
| 874 | Тысяча тубов | — |
| 875 | Тысяча коробок | — |
| 876 | Условная единица | — |
| 877 | Тысяча условных единиц | — |
| 878 | Миллион условных единиц | — |
| 879 | Условная штука | — |
| 880 | Тысяча условных штук | — |
| 881 | Условная банка | — |
| 882 | Тысяча условных банок | — |
| 883 | Миллион условных банок | — |
| 884 | Условный кусок | — |
| 885 | Тысяча условных кусков | — |
| 886 | Миллион условных кусков | — |
| 887 | Условный ящик | — |
| 888 | Тысяча условных ящиков | — |
| 889 | Условная катушка | — |
| 890 | Тысяча условных катушек | — |
| 891 | Условная плитка | — |
| 892 | Тысяча условных плиток | — |
| 893 | Условный кирпич | — |
| 894 | Тысяча условных кирпичей | — |
| 895 | Миллион условных кирпичей | — |
| 896 | Семья | — |
| 897 | Тысяча семей | — |
| 898 | Миллион семей | — |
| 899 | Домохозяйство | — |
| 900 | Тысяча домохозяйств | — |
| 901 | Миллион домохозяйств | — |
| 902 | Ученическое место | — |
| 903 | Тысяча ученических мест | — |
| 904 | Рабочее место | — |
| 905 | Тысяча рабочих мест | — |
| 906 | Посадочное место | — |
| 907 | Тысяча посадочных мест | — |
| 908 | Номер | — |
| 909 | Квартира | — |
| 910 | Тысяча квартир | — |
| 911 | Койка | — |
| 912 | Тысяча коек | — |
| 913 | Том книжного фонда | — |
| 914 | Тысяча томов книжного фонда | — |
| 915 | Условный ремонт | — |
| 916 | Условный ремонт в год | — |
| 917 | Смена | — |
| 918 | Лист авторский | — |
| 920 | Лист печатный | — |
| 921 | Лист учетно-издательский | — |
| 922 | Знак | — |
| 923 | Слово | — |
| 924 | Символ | — |
| 925 | Условная труба | — |
| 930 | Тысяча пластин | — |
| 937 | Миллион доз | — |
| 949 | Миллион листов-оттисков | — |
| 950 | Вагоно (машино)-день | — |
| 951 | Тысяча вагоно (машино)-часов | — |
| 952 | Тысяча вагоно (машино)-километров | — |
| 953 | Тысяча место-километров | — |
| 954 | Вагоно-сутки | — |
| 955 | Тысяча поездо-часов | — |
| 956 | Тысяча поездо-километров | — |
| 957 | Тысяча тонно-миль | — |
| 958 | Тысяча пассажиро-миль | — |
| 959 | Автомобиле-день | — |
| 960 | Тысяча автомобиле-тонно-дней | — |
| 961 | Тысяча автомобиле-часов | — |
| 962 | Тысяча автомобиле-место-дней | — |
| 963 | Приведенный час | — |
| 964 | Самолето-километр | — |
| 965 | Тысяча километров | — |
| 966 | Тысяча тоннаже-рейсов | — |
| 967 | Миллион тонно-миль | — |
| 968 | Миллион пассажиро-миль | — |
| 969 | Миллион тоннаже-миль | — |
| 970 | Миллион пассажиро-место-миль | — |
| 971 | Кормо-день | — |
| 972 | Центнер кормовых единиц | — |
| 973 | Тысяча автомобиле-километров | — |
| 974 | Тысяча тоннаже-суток | — |
| 975 | Суго-сутки | — |
| 976 | Штук в 20-футовом эквиваленте (ДФЭ) | — |
| 977 | Канало-километр | — |
| 978 | Канало-концы | — |
| 979 | Тысяча экземпляров | — |
| 980 | Тысяча долларов | — |
| 981 | Тысяча тонн кормовых единиц | — |
| 982 | Миллион тонн кормовых единиц | — |
| 983 | Судо-сутки | — |
| 984 | Центнеров с гектара | — |
| 985 | Тысяча голов | — |
| 986 | Тысяча краско-оттисков | — |
| 987 | Миллион краско-оттисков | — |
| 988 | Миллион условных плиток | — |
| 989 | Человек в час | — |
| 990 | Пассажиров в час | — |
| 991 | Пассажиро-миля | — |

## Четырехзначные национальные единицы измерения, включенные в ОКЕИ

### Технические единицы

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 2541 | Бит в секунду | — |
| 2311 | Грей в секунду | — |
| 2312 | Грей в минуту | — |
| 2313 | Грей в час | — |
| 2314 | Микрогрей в секунду | — |
| 2315 | Микрогрей в час | — |
| 2316 | Миллигрей в час | — |
| 2351 | Зиверт в час | — |
| 2352 | Микрозиверт в секунду | — |
| 2353 | Микрозиверт в час | — |
| 2354 | Миллизиверт в час | — |
| 2355 | Градус (плоского угла) | — |
| 2356 | Минута (плоского угла) | — |
| 2357 | Секунда (плоского угла) | — |
| 2543 | Килобит в секунду | — |
| 2545 | Мегабит в секунду | — |
| 2547 | Гигабит в секунду | — |
| 2551 | Байт в секунду | — |
| 2552 | Гигабайт в секунду | — |
| 2553 | Гигабайт | — |
| 2554 | Терабайт | — |
| 2555 | Петабайт | — |
| 2556 | Эксабайт | — |
| 2557 | Зеттабайт | — |
| 2558 | Йоттабайт | — |
| 2561 | Килобайт в секунду | — |
| 2571 | Мегабайт в секунду | — |
| 2581 | Эрланг | — |
| 3135 | Децибел | — |
| 3181 | Человеко-зиверт | — |
| 3231 | Беккерель на метр кубический | — |

### Экономические единицы

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 3831 | Рубль тонна | — |
| 3841 | Тысяча рублей на человека | — |
| 5401 | Дето-день | — |
| 5423 | Человек в год | — |
| 5451 | Посещение | — |
| 5562 | Тысяча гнезд | — |
| 6421 | Единиц в год | — |
| 6422 | Вызов | — |
| 6423 | Посевная единица | — |
| 6424 | Штамм | — |
| 7923 | Абонент | — |
| 8361 | Особь | — |
| 8751 | Коробка | — |
| 9061 | Миллион гектаров | — |
| 9062 | Миллиард гектаров | — |
| 9111 | Койко-день | — |
| 9113 | Пациенто-день | — |
| 9245 | Запись | — |
| 9246 | Документ | — |
| 9491 | Лист-оттиск | — |
| 9501 | Вагоно (машино)-час | — |
| 9557 | Миллион голов | — |
| 9641 | Летный час | — |
| 9642 | Балл | — |
| 9802 | Миллион долларов | — |
| 9803 | Миллиард долларов | — |
| 9805 | Доллар за тонну | — |
| 9822 | Миллион евро | — |
| 9823 | Миллиард евро | — |

### Дозировка лекарственных препаратов

| Код | Наименование | Обозначение |
| --- | --- | --- |
| 9910 | Международная единица биологической активности | — |
| 9911 | Тысяча международных единиц биологической активности | — |
| 9912 | Миллион международных единиц биологической активности | — |
| 9913 | Международная единица биологической активности на грамм | — |
| 9914 | Тысяча международных единиц биологической активности на грамм | — |
| 9915 | Миллион международных единиц биологической активности на грамм | — |
| 9916 | Международная единица биологической активности на миллилитр | — |
| 9917 | Тысяча международных единиц биологической активности на миллилитр | — |
| 9918 | Миллион международных единиц биологической активности на миллилитр | — |
| 9920 | Единица действия биологической активности | — |
| 9921 | Единица действия биологической активности на грамм | — |
| 9922 | Тысяча единиц действия биологической активности на грамм | — |
| 9923 | Единица действия биологической активности на микролитр | — |
| 9924 | Единица действия биологической активности на миллилитр | — |
| 9925 | Тысяча единиц действия биологической активности на миллилитр | — |
| 9926 | Миллион единиц действия биологической активности на миллилитр | — |
| 9927 | Единица действия биологической активности в сутки | — |
| 9930 | Антитоксическая единица | — |
| 9931 | Тысяча антитоксических единиц | — |
| 9940 | Антитрипсиновая единица | — |
| 9941 | Тысяча антитрипсиновых единиц | — |
| 9950 | Индекс Реактивности | — |
| 9951 | Индекс Реактивности на миллилитр | — |
| 9960 | Килобеккерель на миллилитр | — |
| 9961 | Мегабеккерель на миллилитр | — |
| 9962 | Мегабеккерель на метр квадратный | — |
| 9970 | Калликреиновая ингибирующая единица на миллилитр | — |
| 9971 | Тысяча калликреиновых ингибирующих единиц на миллилитр | — |
| 9980 | Миллион колониеобразующих единиц | — |
| 9981 | Миллион колониеобразующих единиц на пакет | — |
| 9982 | Миллиард колониеобразующих единиц | — |
| 9983 | Протеолитическая единица | — |
| 9985 | Микрограмм на миллилитр | — |
| 9986 | Микрограмм в сутки | — |
| 9987 | Микрограмм в час | — |
| 9988 | Микрограмм на дозу | — |
| 9990 | Миллимоль на миллилитр | — |
| 9991 | Миллимоль на литр | — |
| 276 | Грей | — |
| 277 | Микрогрей | — |
| 278 | Миллигрей | — |
| 279 | Килогрей | — |
| 293 | Гигагерц | — |
| 295 | Терагерц | — |

## Откуда справочник

Источник — набор открытых данных «Общероссийский классификатор единиц измерения» на сайте
[Федеральной службы государственной статистики](https://rosstat.gov.ru/opendata/7708234640-okei),
выпуск от 03.12.2024. Страница собирается из него скриптом, поэтому расходиться с источником ей
нечем. Машиночитаемая копия — [okei.json](/schemas/okei.json).

## Читайте также

- [Создание заказа](/docs/merchant/order/create/) — где указывается `measureCode`
- [Мера количества предмета расчёта](/docs/dictionary/tag2108/) — перечень ФНС для чека
- [Справочники](/docs/dictionary/)


---
<!-- https://docs.invoicebox.ru/docs/dictionary/counterparty-detail/ · markdown: https://docs.invoicebox.ru/raw/dictionary/counterparty-detail.md -->

# Поиск по ИНН

Реквизиты организации возвращает запрос по ИНН:

- метод: `GET`
- ресурс: `/v3/filter/api/counterparty-detail`
- тело ответа — коллекция объектов [Counterparty](#counterparty) в свойстве `data`

В запросе есть обязательный параметр `vatNumber` — ИНН.

Метод нужен, чтобы подставить реквизиты плательщика в заказ, не заставляя покупателя вводить их
руками: по ИНН возвращаются наименование, КПП и адреса, которые затем уходят в
[создание заказа](/docs/merchant/order/create/#customer).

> [!IMPORTANT]
> Если организация не найдена или справочный сервис недоступен, метод отвечает `200` с пустым `data`.
> Обрабатывайте такой ответ как «данных нет»: пустой `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)       | Почтовый индекс организации                      |

---


---
<!-- https://docs.invoicebox.ru/docs/dictionary/iso4217/ · markdown: https://docs.invoicebox.ru/raw/dictionary/iso4217.md -->

# Коды валют

Ниже представлены коды валют, используемые в системе.
Полный классификатор валют доступен на сайте [Центрального банка России](https://www.cbr.ru/development/mcirabis/kv/).

## Экономические единицы

| Код  | Наименование     | Знак |
|------|------------------|------|
| RUB  | Российский рубль | ₽    |
| CNY  | Юань             | ¥    |
| UZS  | Узбекский сум    | сум  |
| EUR  | Евро             | €    |
| GBP  | Фунт стерлингов  | £    |
| USD  | Доллар США       | $    | 

---


---
<!-- https://docs.invoicebox.ru/docs/dictionary/tag1212/ · markdown: https://docs.invoicebox.ru/raw/dictionary/tag1212.md -->

# Признак предмета расчёта (тег 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)

---


---
<!-- https://docs.invoicebox.ru/docs/dictionary/tag2108/ · markdown: https://docs.invoicebox.ru/raw/dictionary/tag2108.md -->

# Мера количества предмета расчёта (тег 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 (в печатной форме - шт./ед.).

---


---
<!-- https://docs.invoicebox.ru/docs/dictionary/tag1199/ · markdown: https://docs.invoicebox.ru/raw/dictionary/tag1199.md -->

# Ставка НДС (тег 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/)

---


---
<!-- https://docs.invoicebox.ru/docs/dictionary/ · markdown: https://docs.invoicebox.ru/raw/dictionary/dictionary.md -->

# Справочники

В текущем разделе описаны базовые справочники.

Рядом лежат две страницы, которые в этот раздел не входят, но нужны тем же читателям:
[термины и определения](/docs/definition/) — что мы называем заказом, счётом и магазином, и
[сроки и условия расчётов](/docs/terms/) — когда деньги доходят до вас.


---
<!-- https://docs.invoicebox.ru/docs/dictionary/error/ · markdown: https://docs.invoicebox.ru/raw/dictionary/error.md -->

# Коды ошибок

Ошибка приходит в свойстве `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` уже использовался. Приходит, только если у магазина включена проверка уникальности (тумблер «Проверять уникальность номера заказа» в кабинете app.invoicebox.ru: Мои продажи → Магазины → Общая информация) | Заказ с этим номером уже создан — найдите его выборкой и работайте с ним. Новый номер генерировать не нужно: так появится второй заказ на ту же покупку. См. [повтор после сбоя](/docs/merchant/order/create/#повтор-после-сбоя-и-таймаута) |

## Технические

| HTTP | Что произошло | Что делать |
|---|---|---|
| 429 | Слишком много запросов | Снизить частоту и повторить с задержкой — [ограничения](/docs/api/limits/). Тело может не содержать `code` |
| 500 | Необработанная ошибка на стороне сервиса | Результат операции неизвестен: запрос мог дойти. Чтение можно повторить сразу; после создания заказа, возврата или отмены сначала проверьте выборкой, прошла ли операция, — [повтор после сбоя](/docs/merchant/order/create/#повтор-после-сбоя-и-таймаута). Сообщите нам `x-request-id` из заголовков ответа. Тело может не содержать `code` |

---