1 Описание
2 Авторизация
3 SetMobyAPI
- 3.1 Проверка подключения к серверу (check)
  - 3.1.1 Параметры
  - 3.1.2 Пример запроса (Request body)
  - 3.1.3 Ответ
- 3.2 Загрузка/обновление справочника товаров (goods)
  - 3.2.1 Параметры
    - 3.2.1.1 Параметры товара (goods)
    - 3.2.1.2 Параметры штрихкода (barcodes)
    - 3.2.1.3 Параметры производителя (producer)
  - 3.2.2 Пример запроса (Request body)
  - 3.2.3 Ответ
- 3.3 Загрузка/обновление справочника магазинов (shop)
  - 3.3.1 Параметры
    - 3.3.1.1 Параметры магазина (shop)
  - 3.3.2 Пример запроса (Request body)
  - 3.3.3 Ответ
- 3.4 Работа с документами (document_api)
  - 3.4.1 PUT/POST
  - 3.4.2 DELETE
    - 3.4.2.1 Параметры
    - 3.4.2.2 Пример запроса (Request body)
    - 3.4.2.3 Ответ
  - 3.4.3 GET
    - 3.4.3.1 Параметры
    - 3.4.3.2 Пример запроса (Request body)
    - 3.4.3.3 Ответ

Описание

В качестве API в нашей системе используется REST API, объединяющий самые распространенные методы обработки данных посредством HTTP-запросов (GET, POST, PUT, DELETE).

Авторизация

Чтобы начать работу с SetMobyApi, необходимо пройти процедуру авторизации. Используется схема базовой аутентификации (Basic Auth).

Это механизм, при котором имя пользователя и пароль отправляются прямо в заголовке HTTP-запроса, но предварительно кодируются методом Base64. Таким образом, хотя данные передаются открыто, они выглядят зашифрованными для обычного просмотра.

Пример заголовка Basic Auth выглядит так:

Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

Где dXNlcm5hbWU6cGFzc3dvcmQ= — это имя пользователя (username) и пароль (password), закодированные в Base64.

Для получения учетных данных (имени пользователя и пароля) обратитесь к вашему персональному менеджеру CSI. В результате вам будут предоставлены стандартные логин и пароль, которые по умолчанию используются для авторизации.

SetMobyAPI

SetMobyApi включает ресурсы:

check — проверка подключения к серверу.
goods — загрузка/обновление справочника товаров.
shop — загрузка/обновление справочника магазинов.
document_api — работа с документами (создание, изменение, удаление, получение).

Данные передаются внутри тела запроса в формате JSON.

Проверка подключения к серверу (check)

Метод	Путь к методу (endpoint)	Описание

Метод	Путь к методу (endpoint)	Описание
GET	/api/cheсkConnection	Возвращает статус подключения к серверу SetMoby

Параметры

Нет параметров.

Пример запроса (Request body)

Curl

curl -X 'GET' \
  'http://172.29.21.221:8088/api/checkConnection' \
  -H 'accept: */*'

Request URL

http://172.29.21.221:8088/api/checkConnection

Ответ

Код статуса	Описание

Код статуса	Описание
200	Запрос подключения выполнен успешно
401	Неверный логин или пароль

Загрузка/обновление справочника товаров (goods)

Метод	Путь к методу (endpoint)	Описание

Метод	Путь к методу (endpoint)	Описание
POST	/api/goods	Загрузка/обновление справочника товаров

Параметры

Параметр	Тип данных	Описание	Обязательность	Пример значения

Параметр

Тип данных

Описание

Обязательность

Пример значения

version

string

Версия структуры JSON

Да

01.0

goods[]

array

Товар

Параметры товара (goods)

Да

—

Параметры товара (goods)

Если загружаете новые товары, то их id должны быть уникальными.
Если обновляете данные ранее загруженных товаров, заполните только те параметры, которые необходимо изменить. Параметр id при обновлении товара не меняйте.

Параметр	Тип данных	Описание	Обязательность	Пример значения

Параметр	Тип данных	Описание	Обязательность	Пример значения
`id`	string	Уникальный идентификатор товара в ERP	Да	`0b90ed69-26a4-11e8-816a-0050569579f0`
`item`	string	Артикул товара	Нет	`0132061`
`name`	string	Наименование товара	Да	`Мороженое "ВАРЯ" с соленой карамелью БЗМЖ, 500г ( Контейнер)`
`checkDateMake`	boolean	Признак ввода даты производства	Нет	`false`
`checkDateBefore`	boolean	Признак ввода срока годности	Нет	`true`
`checkMark`	boolean	Признак проверки марки ЧЗ	Нет	`true`
`unit`	string	Базовая единица измерения	Нет	`шт`
`salePrice`	number	Цена товара	Нет	`325.99`
`barcodes[]`	array	Параметры штрихкода (barcodes) Штрихкод добавляемого товара	Да	—
`producer`	object	Параметры производителя (producer)	Нет	—

Параметры штрихкода (barcodes)

Параметр	Тип данных	Описание	Обязательность	Пример значения
`barcode`	string	Штрихкод товара	Да	`4610083912686`
`quantity`	number	Количество товара с этим штрихкодом	Да	`1`

Параметры производителя (producer)

Параметр	Тип данных	Описание	Обязательность	Пример значения
`name`	string	Наименование производителя	Да	`ООО “Петрохолод”`

Пример запроса (Request body)

Указанный ниже пример запроса соответствует актуальной версии API 01.0 с обязательным параметром version. Также поддерживается старый вариант запроса без параметра version.

{
  "version": "01.0",
  "goods": [
    {
      "id": "0b90ed69-26a4-11e8-816a-0050569579f0",
      "item": "0132061",
      "name": "Мороженое \"ВАРЯ с соленой карамелью\" БЗМЖ, 500г (Контейнер)",
      "checkDateMake": false,
      "checkDateBefore": true,
      "checkMark": true,
      "salePrice": 325.99,
      "unit": "шт",
      "barcodes": [
        {
          "barcode": "4610083912686",
          "quantity": 1
        }
      ],
      "producer": {
        "name": "ООО \"Петрохолод\""
      }
    }
  ]
}

[
  {
    "id": "0b90ed69-26a4-11e8-816a-0050569579f0",
    "item": "0132061",
    "name": "Мороженое \"ВАРЯ с соленой карамелью\" БЗМЖ, 500г (Контейнер)",
    "checkDateMake": false,
    "checkDateBefore": true,
    "checkMark": true,
    "barcodes": [
      {
        "barcode": "4610083912686",
        "quantity": 1
      }
    ],
    "producer": {
        "name": "ООО \"Петрохолод\""
    }
  },
  {
    "id": "0b90ed69-26a4-11e8-816a-0050569579f1",
    "item": "0132062",
    "name": "Сухари ржаные 200 г.",
    "checkDateMake": false,
    "checkDateBefore": true,
    "checkMark": false,
    "barcodes": [
      {
        "barcode": "4610083912686",
        "quantity": 1
      }
    ],
    "producer": {
        "name": "ООО \"Петрохолод\""
    }
  }
]

Ответ

Код статуса	Описание

Код статуса	Описание
200	Успешно загружен/обновлен справочник товаров
500	Структура запроса не соответствует требуемой JSON-схеме/ ошибка в работе базы данных
400	Ошибка в типе данных/ отсутствуют обязательные параметры
401	Неверный логин или пароль

Загрузка/обновление справочника магазинов (shop)

Метод	Путь к методу (endpoint)	Описание

Метод	Путь к методу (endpoint)	Описание
POST	/api/shops	Загрузка/обновление справочника магазинов

Параметры

Параметр	Тип данных	Описание	Обязательность	Пример значения

Параметр

Тип данных

Описание

Обязательность

Пример значения

version

string

Версия структуры JSON

Да

01.0

shops[]

array

Список магазинов, которые необходимо загрузить

Параметры магазина (shop)

Да

—

Параметры магазина (shop)

Параметр number является необязательным, если его не указать, система присвоит номер магазина автоматически.
Если загружаете новые магазины, то их id должны быть уникальными.
Если обновляете данные ранее загруженных магазинов, заполните только те параметры, которые необходимо изменить. Параметр id при обновлении магазина не меняйте.

Параметр	Тип данных	Описание	Обязательность	Пример значения

Параметр	Тип данных	Описание	Обязательность	Пример значения
`id`	string	Уникальный идентификатор магазина	Да	`0b90ed69-26a4-11e8-816a-0050569579f0`
`number`	integer	Номер магазина	Нет	`123`
`name`	string	Наименование магазина	Да	`ТК-123`
`address`	string	Адрес магазина	Нет	`СПб, Чкаловский 52`

Пример запроса (Request body)

Указанный ниже пример запроса соответствует актуальной версии API 01.0 с обязательным параметром version. Также поддерживается старый вариант запроса без параметра version.

{
  "version": "01.0",
  "shops": [
    {
      "id": "0b90ed69-26a4-11e8-816a-0050569579f0",
      "number": 123,
      "name": "ТК-123",
      "address": "СПб, Чкаловский 52"
    }
  ]
}

[
  {
    "id": "0b90ed69-26a4-11e8-816a-0050569579f0",
    "number": 123,
    "name": "ТК-123",
    "address": "СПб, Чкаловский 52"
  },
  {
    "id": "0b90ed69-26a4-11e8-816a-0050569579f1",
    "number": 321,
    "name": "ТК-321",
    "address": "СПб, Левашовский 25"
  }
]

Ответ

Код статуса	Описание

Код статуса	Описание
200	Успешно загружен/обновлен справочник магазинов
500	Структура запроса не соответствует требуемой JSON-схеме/ ошибка в работе базы данных
400	Ошибка в типе данных/ отсутствуют обязательные параметры
401	Неверный логин или пароль

Работа с документами (document_api)

Метод	Путь к методу (endpoint)	Описание

Метод	Путь к методу (endpoint)	Описание
PUT	/api/document	Изменение существующего документа
POST	/api/document	Создание новых документов на сервере
DELETE	/api/document	Удаление документа
GET	/api/document	Получение документа с результатами приемки, инвентаризации

PUT/POST

Параметры

Если загружаете новые документы, то их id должны быть уникальными.
Если обновляете данные ранее загруженных документов, заполните только те параметры, которые необходимо изменить. Параметр id при обновлении документа не меняйте.

Параметр	Тип данных	Описание	Обязательность	Пример значения

Параметр	Тип данных	Описание	Обязательность	Пример значения
`version`	string	Версия структуры JSON	Да	`01.0`
`id`	string	Идентификатор документа в ERP	Да	`832363a1-d21b-11e8-8179-0050569579f0`
`shop`	object	Магазин Параметры магазина (shop)	Да	—
`contractor`	object	Поставщик Параметры поставщика (contractor)	Да	—
`number`	string	Номер документа	Да	`00000000244`
`type`	string	Тип документа	Да	`inventory` /`incoming` / `inventoryEGAIS` / `incomingEGAIS` / `order`
`dateTimeCreate`	string	Время создания документа	Да	`2023-05-02T00:00:00+03:00`
`positions[]`	array	Список товаров, которые необходимо загрузить Параметры списка товаров (positions)	Да	—

Параметры поставщика (contractor)

Параметр	Тип данных	Описание	Обязательность	Пример значения
`id`	string	Идентификатор контрагента	Да	`cf7d5809-0a7e-11e8-8168-0050569579f0`
`name`	string	Наименование контрагента	Да	`ООО \"Петрохолод\"`

Параметры списка товаров (positions)

Параметр	Тип данных	Описание	Обязательность	Пример значения
`pos`	integer	Номер позиции в документе	Да	`1`
`quantityPlan`	number	Количество по плану	Да	`64`
`quantityFact`	number	Количество по факту	Нет	`0`
`goods`	object	Список товаров, которые необходимо загрузить Параметры товара (Goods)	Да
`unit`	string	Базовая единица измерения	Нет	`шт`
`markList`	array of strings	Список марок ЧЗ	Обязательно только для марок	`02046100839126863764`
`boxList`	array of strings	Список коробок с алкогольным товаром Параметры списка коробок с алкогольным товаром (boxList)	Обязательно только для марок ЕГАИС	`01000000017412323000278512`
`boxTree[]`	array	Список паллет Параметры списка паллет (boxTree)	Обязательно только для марок ЕГАИС	—
`dateMake`	string	Дата производства	Нет	`2023-01-31T08:00:00+03:00`
`dateBefore`	string	Срок годности	Нет	`2025-01-31T08:00:00+05:00`

Параметры списка коробок с алкогольным товаром (boxList)

Параметр	Тип данных	Описание	Обязательность	Пример значения
`boxNumber`	string	Номер коробки (упаковки) или пустая строка	Обязательно только для марок ЕГАИС	`01000000017412323000278520`
`markList[]`	array of strings	Массив марок	Обязательно только для марок ЕГАИС	`192309996302831222001NQJYEGS2NNMI4THYYFAEI4NISUWPRBNEES6RJF4QUKTT4KLHJIIHIY3WSGP3K5O5RCGGDBMBGKZKYHZNCFXJRZDQ5GHLHG5UJA44FHR5ITJA7JZNLZPZHJRDQU3VNP56Q`

Параметры списка паллет (boxTree)

Параметр	Тип данных	Описание	Обязательность	Пример значения
`boxNumber`	string	Номер паллеты (или пустая строка)	Обязательно только для марок ЕГАИС	`01000000017422323200002375`
`boxList`	array of strings	Массив коробок (упаковок)	Обязательно только для марок ЕГАИС	`01000000017412323000278512`

Примеры запросов документов (Request body)

Пример запроса документа приемки

{
  "version": "01.0",
  "shop": {
    "number": 1002,
    "name": "ТК 1002, СПб, Савушкина 121"
  },
  "id": "832363a1-d21b-11e8-8179-0050569579f0",
  "type": "incoming",
  "number": "00000001328",
  "dateTimeCreate": "2023-01-31T08:00:00+03:00",
  "contractor": {
    "id": "cf7d5809-0a7e-11e8-8168-0050569579f0",
    "name": "Саратов-Холод Плюс, ООО"
  },
  "positions": [
    {
      "pos": 1,
      "goods": {
        "id": "0b90ed69-26a4-11e8-816a-0050569579f0",
        "item": "0132061",
        "name": "Мороженое \"ВАРЯ с соленой карамелью\" БЗМЖ, 500г (Контейнер)",
        "checkDateMake": false,
        "checkDateBefore": true,
        "checkMark": true,
        "barcodes": [
          {
            "barcode": "4610083912686",
            "quantity": 1
          }
        ],
        "producer": {
          "name": "ООО \"Петрохолод\""
        }
      },
      "unit": "шт",
      "quantityPlan": 64,
      "quantityFact": 0,
      "dateMake": "2023-01-30T00:00:00+03:00",
      "markList": [
        "02046100839126863764"
      ]
    }
  ]
}

Пример запроса документа инвентаризации


{
  "version": "01.0",
  "shop": {
    "number": 1002,
    "name": "ТК 1002, СПб, Савушкина 121"
  },
  "id": "832363a1-d21b-11e8-8179-0050569579f0",
  "type": "inventory",
  "number": "00000000244",
  "dateTimeCreate": "2023-05-02T00:00:00+03:00",
  "positions": [
    {
      "pos": 1,
      "goods": {
        "id": "0b90ed69-26a4-11e8-816a-0050569579f0",
        "item": "0132061",
        "name": "Мороженое \"ВАРЯ с соленой карамелью\" БЗМЖ, 500г (Контейнер)",
        "barcodes": [
          {
            "barcode": "4610083912686",
            "quantity": 1
          }
        ],
        "producer": {
          "name": "ООО \"Петрохолод\""
        }
      },
      "unit": "шт",
      "quantityPlan": 180,
      "quantityFact": 0
    }
  ]
}

Пример запроса документа приемки ЕГАИС

{
  "version": "01.0",
  "shop": {
    "number": 1002,
    "name": "ТК 1002, СПб, Савушкина 121"
  },
  "id": "832363a1-d21b-11e8-8179-0050569579f0",
  "type": "incomingEGAIS",
  "number": "00000000005",
  "dateTimeCreate": "2023-04-27T12:12:22+03:00",
  "contractor": {
    "id": "cf7d5809-0a7e-11e8-8168-0050569579f0",
    "name": "ООО \"Долина\""
  },
  "positions": [
    {
      "pos": 1,
      "goods": {
        "id": "0b90ed69-26a4-11e8-816a-0050569579f0",
        "item": "0100000001740000136",
        "name": "Вино полусладкое красное \"Изабелла прекрасная\""
      },
      "quantityPlan": 12,
      "quantityFact": 0,
      "boxList": [
        {
          "boxNumber": "01000000017412323000278520",
          "markList": [
            "192309996302831222001NQJYEGS2NNMI4THYYFAEI4NISUWPRBNEES6RJF4QUKTT4KLHJIIHIY3WSGP3K5O5RCGGDBMBGKZKYHZNCFXJRZDQ5GHLHG5UJA44FHR5ITJA7JZNLZPZHJRDQU3VNP56Q",
            "192309996302851222001O4WKASY7MCTNG2XHFRMSI65BBIHE7BJJSRBQPUWT2D5VGOVYWTIRTSYIYWV5QMYMOYZ26IO3S6RXQ6WR43MOLGDRC3VYHGL7IHJZM2KVUWFLW5TMD3BJMI3LRTXDFFEKQ",
            "192309996302951222001RCCN5EORPUO5IH5CWKDIYCC7ZYR3SD2BIAXWNJCLR7TTZ54X4H4KWRLUMA4FVHSRKV7HYNF6TAHG5C2UTB22TTOFI5KSQEXSQXBNDQ5UW2AENGGTD7Z6ZDJKU2INAQPTY",
            "192309996302981222001J4UAKU7IQRBTOIRTJV5PZXCZQYJ7CD4U3HRWT67SFGNP2VYZNL5KQSL3BIQYZYD4IVJCDJN2H525TOFVW44O4AUSAD6D2JH7V4ZKAZWBVBGKT5JHH2BONXKTGLVLSEO2Y",
            "192309996303551222001VSROUAH64IPEYJUJKAB5QTFAOIK5LH6HEXXP5MCNIHKBBMJYAEPIQ7XBQTW3VRUZ5YMMNTA7CKLTQZWRPNS7R4L7U7XCRPSORPFO2DLPVDYXRRNAEN2364MFW6YJH2LRQ",
            "1923099963035712220016OPSQA75CKCL2BG2NV6KRHILXUNDP254LRO5ZQSGMCVASHOWMFPNP3TCVPXSIH6YMXRBRIP4VSWJBN6IJDRFW7L53VUQQ6STQMUDW6FQH6U7VPLSI4367KDDS2JGOVZTQ"
          ]
        },
        {
          "boxNumber": "01000000017412323000278512",
          "markList": [
            "192309996303031222001RKVWAFSV3YUYJK3QZNTVU3VESQV2UCJ3XQMC6CQO7RTJY3KUHO6KSXYSXS4WSBMJQJ7JEVXYPL4OPGPEI2YS3LPD7QHNHPBX465M4VIRF4DFEATI7FWJ3OPP5XQERLITA",
            "192309996303131222001DI247G4NIFRVMFNJOA34RB7X3YSY2LAPIA2AGJ3XIY7JU6UYX246Z5QXMOEQPJJJXQQMRVUKXXTSDECTXSQ6KBMPPHVCKRPC33KISYPUYQMYIK6Y7FUGZV6Q7N4GWK5UQ",
            "192309996303151222001POG7RGQMQ6RIMRGT7P4TUNC6OUYDHRHLFZ4ALFIGYKDLHTH25R5DWBEKYB6N6GQPGBIB2UMBADUPPSAUT5NTGDA4IZL745CQYLE2522O5BJ6JSJRDVNUYW4ROA2ZTFPVY",
            "1923099963034512220016VV22NAIZ65IDRAUHGIJYD6TV4WHGZ244PSXPWHZNMBDQ2FFMVTTMVMU2XPXH5AM4K3KXKZSPDEQ3EWU2UDJIRWWFPW6C3VISO7FSBVS3W6DT55DFXPYTRQ5FBH7TZCPQ",
            "192309996303611222001YWSLZBD5XUJ7DAJKISDAF4MOAMTT5NSMUU2KICTTDOHY3PES3VC5YVLZ42WX5AOFBO3EUR5YJPXGCRUF5BGFZDZ3D5UUCXB7Y6IT3E3RN6T3KFNWR3ZBQBSZW43H3MJCA",
            "192309996303631222001KC6FYMMY2LJ22MUZ5G4A764TWQ24OOSEHX7533KOUFAD3RD2BVXQDLIQNIQA5ZVJSOD3GYXREVTI7WIJZSHMISNN5ZGW6XBU5NGRMCAZSBCOM443BKUTTJVUQS6CBAWWI"
          ]
        }
      ],
      "boxTree": [
        {
          "boxNumber": "01000000017422323200002375",
          "boxList": [
            "01000000017412323000278520",
            "01000000017412323000278512"
          ]
        }
      ]
    }
  ]
}

Пример запроса документа инвентаризации ЕГАИС

{
  "version": "01.0",
  "shop": {
    "number": 1002,
    "name": "ТК 1002, СПб, Савушкина 121"
  },
  "id": "832363a1-d21b-11e8-8179-0050569579f0",
  "type": "inventoryEGAIS",
  "number": "00000000247",
  "dateTimeCreate": "2023-05-15T10:00:00+03:00",
  "positions": [
    {
      "pos": 1,
      "goods": {
        "id": "0b90ed69-26a4-11e8-816a-0050569579f0",
        "item": "0100000001740000136",
        "name": "Вино полусладкое красное \"Изабелла прекрасная\""
      },
      "boxList": [
        {
          "boxNumber": "01000000017412323000278520",
          "markList": [
            "192309996302831222001NQJYEGS2NNMI4THYYFAEI4NISUWPRBNEES6RJF4QUKTT4KLHJIIHIY3WSGP3K5O5RCGGDBMBGKZKYHZNCFXJRZDQ5GHLHG5UJA44FHR5ITJA7JZNLZPZHJRDQU3VNP56Q",
            "192309996302851222001O4WKASY7MCTNG2XHFRMSI65BBIHE7BJJSRBQPUWT2D5VGOVYWTIRTSYIYWV5QMYMOYZ26IO3S6RXQ6WR43MOLGDRC3VYHGL7IHJZM2KVUWFLW5TMD3BJMI3LRTXDFFEKQ",
            "192309996302951222001RCCN5EORPUO5IH5CWKDIYCC7ZYR3SD2BIAXWNJCLR7TTZ54X4H4KWRLUMA4FVHSRKV7HYNF6TAHG5C2UTB22TTOFI5KSQEXSQXBNDQ5UW2AENGGTD7Z6ZDJKU2INAQPTY",
            "192309996302981222001J4UAKU7IQRBTOIRTJV5PZXCZQYJ7CD4U3HRWT67SFGNP2VYZNL5KQSL3BIQYZYD4IVJCDJN2H525TOFVW44O4AUSAD6D2JH7V4ZKAZWBVBGKT5JHH2BONXKTGLVLSEO2Y",
            "192309996303551222001VSROUAH64IPEYJUJKAB5QTFAOIK5LH6HEXXP5MCNIHKBBMJYAEPIQ7XBQTW3VRUZ5YMMNTA7CKLTQZWRPNS7R4L7U7XCRPSORPFO2DLPVDYXRRNAEN2364MFW6YJH2LRQ",
            "1923099963035712220016OPSQA75CKCL2BG2NV6KRHILXUNDP254LRO5ZQSGMCVASHOWMFPNP3TCVPXSIH6YMXRBRIP4VSWJBN6IJDRFW7L53VUQQ6STQMUDW6FQH6U7VPLSI4367KDDS2JGOVZTQ"
          ]
        },
        {
          "boxNumber": "01000000017412323000278512",
          "markList": [
            "192309996303031222001RKVWAFSV3YUYJK3QZNTVU3VESQV2UCJ3XQMC6CQO7RTJY3KUHO6KSXYSXS4WSBMJQJ7JEVXYPL4OPGPEI2YS3LPD7QHNHPBX465M4VIRF4DFEATI7FWJ3OPP5XQERLITA",
            "192309996303131222001DI247G4NIFRVMFNJOA34RB7X3YSY2LAPIA2AGJ3XIY7JU6UYX246Z5QXMOEQPJJJXQQMRVUKXXTSDECTXSQ6KBMPPHVCKRPC33KISYPUYQMYIK6Y7FUGZV6Q7N4GWK5UQ",
            "192309996303151222001POG7RGQMQ6RIMRGT7P4TUNC6OUYDHRHLFZ4ALFIGYKDLHTH25R5DWBEKYB6N6GQPGBIB2UMBADUPPSAUT5NTGDA4IZL745CQYLE2522O5BJ6JSJRDVNUYW4ROA2ZTFPVY",
            "1923099963034512220016VV22NAIZ65IDRAUHGIJYD6TV4WHGZ244PSXPWHZNMBDQ2FFMVTTMVMU2XPXH5AM4K3KXKZSPDEQ3EWU2UDJIRWWFPW6C3VISO7FSBVS3W6DT55DFXPYTRQ5FBH7TZCPQ",
            "192309996303611222001YWSLZBD5XUJ7DAJKISDAF4MOAMTT5NSMUU2KICTTDOHY3PES3VC5YVLZ42WX5AOFBO3EUR5YJPXGCRUF5BGFZDZ3D5UUCXB7Y6IT3E3RN6T3KFNWR3ZBQBSZW43H3MJCA",
            "192309996303631222001KC6FYMMY2LJ22MUZ5G4A764TWQ24OOSEHX7533KOUFAD3RD2BVXQDLIQNIQA5ZVJSOD3GYXREVTI7WIJZSHMISNN5ZGW6XBU5NGRMCAZSBCOM443BKUTTJVUQS6CBAWWI"
          ]
        }
      ],
      "boxTree": [
        {
          "boxNumber": "01000000017422323200002375",
          "boxList": [
            "01000000017412323000278520",
            "01000000017412323000278512"
          ]
        }
      ]
    }
  ]
}

Пример запроса документ сборки заказа

{
  "version": "01.0",
  "shop": {
    "number": 1002
  },
  "id": "832363a1",
  "type": "order",
  "number": "online-0001328",
  "dateTimeCreate": "2025-01-15T08:00:00+03:00",
  "positions": [
    {
      "pos": 1,
      "goods": {
        "id": "00505695",
        "item": "0132061",
        "name": "Мороженое \"ВАРЯ с соленой карамелью\" БЗМЖ, 500г (Контейнер)",
        "checkMark": true,
        "barcodes": [
          {
            "barcode": "4610083912686",
            "quantity": 1
          }
        ],
        "producer": {
          "name": "ООО \"Петрохолод\""
        }
      },
      "unit": "шт",
      "quantityPlan": 64,
      "quantityFact": 1,
      "markList": [
        "02046100839126863764"
      ]
    }
  ]
}

Ответ для PUT/POST

Код статуса	Описание

Код статуса	Описание
200 (PUT)	Успешно изменены документы
200 (POST)	Успешно созданы новые документы
403	Документ завершен
409	Документ в работе
404	Документ не найден
500	Структура запроса не соответствует требуемой JSON-схеме/ ошибка в работе базы данных
400	Ошибка в типе данных/ отсутствуют обязательные параметры
401	Неверный логин или пароль

DELETE

Параметры

Параметр	Тип данных	Описание	Обязательность	Пример значения

Параметр	Тип данных	Описание	Обязательность	Пример значения
`id`	string	Идентификатор документа в ERP	Запрос можно выполнять одним из способов: только с параметром `id`; только с параметрами: `type`, `number`, `shop`.	`832363a1-d21b-11e8-8179-0050569579f0`
`shop`	string	Номер магазина		`inventory` /`incoming` / `inventoryEGAIS` / `incomingEGAIS` / `order`
`type`	string	Тип документа		`00000000244`
`number`	string	Номер документа		`123`

SetMoby ◾️Справочник API SetMobyApi

Описание

Авторизация

SetMobyAPI

Проверка подключения к серверу (check)

Параметры

Пример запроса (Request body)

Ответ

Загрузка/обновление справочника товаров (goods)

Параметры

Параметры товара (goods)

Параметры штрихкода (barcodes)

Параметры производителя (producer)

Пример запроса (Request body)

Ответ

Загрузка/обновление справочника магазинов (shop)

Параметры

Параметры магазина (shop)

Пример запроса (Request body)

Ответ

Работа с документами (document_api)

PUT/POST

Параметры

Параметры поставщика (contractor)

Параметры списка товаров (positions)

Параметры списка коробок с алкогольным товаром (boxList)

Параметры списка паллет (boxTree)

Примеры запросов документов (Request body)

Пример запроса документа приемки

Пример запроса документа инвентаризации

Пример запроса документа приемки ЕГАИС

Пример запроса документа инвентаризации ЕГАИС

Пример запроса документ сборки заказа

Ответ для PUT/POST

DELETE

Параметры

Пример запроса (Request body)