Мой склад ошибка 503

API для подключения торговой точки к онлайн-сервису МойСклад.

API для подключения торговой точки к онлайн-сервису МойСклад.

Основная информация ¶

При разработке клиентского приложения необходимо учитывать следующие моменты:

  • Структура ответов и типы полей поддерживаются нами неизменными

  • Может быть добавлено новое поле без нарушения структуры ответа

  • Может быть добавлен новый ресурс

Для POS API установлены следующие ограничения:

  • Не более 100 запросов за 5 секундный период

  • Не более 5 параллельных запросов от одного пользователя

  • Не более 15 параллельных запросов от аккаунта

  • Не более 500 параллельных запросов с одного ip-адреса

  • Не более 10 Мб данных в одном запросе, отправляемом на сервер

Получение информации

В рамках POS API вы можете:
Запрашивать следующие сущности:

  • Настройки точки продаж

  • Настройки компании

  • Скидки

  • Товары и услуги

  • Папки

  • Покупатели

  • Заказы покупателей

При запросе сущности в ответ от сервера приходит JSON представление сущности со всеми необходимыми для работы с ней в рознице полями.

Создание объектов

Также, в рамках POS API можно создавать следующие сущности:

  • Товары

  • Контрагенты

  • Продажи

  • Возвраты

  • Внесения денег

  • Выплаты денег

  • Предоплаты

  • Возвраты предоплат

При успешном создании сервер вернет пустое тело ответа с HTTP кодом 201.

Операции со сменами

Также доступны 2 операции со сменами:

  • Открытие

  • Закрытие

При успешной операции со сменой сервер вернёт пустое тело ответа с HTTP кодом 204.

Обновление сущностей

Розничный API сервиса МойСклад не поддерживает операции обновления сущностей.

Удаление сущностей

Розничный API сервиса МойСклад не поддерживает операции удаления сущностей.

СТРУКТУРА ОШИБОК

Ошибка в данном API представляет собой массив errors, содержащий объекты error, каждый из которых описывает отдельную ошибку.

СТРУКТУРА ОБЪЕКТА error

  • error — Описание ошибки

  • code — Код ошибки (Если поле отсутствует, смотрите HTTP status code)

  • moreInfo — Ссылка на описание ошибки в документации

  • parameter — Параметр, на котором произошла ошибка

  • line — Строка JSON, на которой произошла ошибка

  • column — Координата элемента в строке line, на котором произошла ошибка

Возвращаемые HTTP статусы ошибок и их значения:

HTTP status code Значение
301 Запрашиваемый ресурс находится по другому URL.
400 Ошибка в структуре JSON передаваемого запроса
401 Имя и/или пароль пользователя указаны неверно или заблокированы пользователь или аккаунт
403 У вас нет прав на просмотр данного объекта
404 Запрошенный ресурс не существует
405 http-метод указан неверно для запрошенного ресурса
409 Указанный объект используется и не может быть удалён
410 Версия API больше не поддерживается
412 Не указан обязательный параметр строки запроса или поле структуры JSON
413 Размер запроса или количество элементов запроса превышает лимит
429 Превышен лимит количества запросов
500 При обработке запроса возникла непредвиденная ошибка
502 Сервис временно недоступен
503 Сервис временно отключен
504 Превышен таймаут обращения к сервису, повторите попытку позднее

Также, вместе с телом ответа ошибки, вам могут прийти следующие заголовки (Headers):

  • X-Lognex-Auth — расширенный код ошибки аутентификации

  • X-Lognex-Auth-Message — сообщение об ошибке.

  • X-Lognex-API-Version-Deprecated — дата отключения запрошенной версии API.

  • Location — URL по которому доступен запрашиваемый ресурс (в случае ответа с кодом 301)

Вы можете узнать лимит оставшихся запросов с помощью следующих заголовков

  • X-RateLimit-Limit — количество запросов, которые равномерно можно сделать в течение интервала до появления 429 ошибки

  • X-Lognex-Retry-TimeInterval — интервал в миллисекундах, в течение которого можно сделать эти запросы

  • X-RateLimit-Remaining — Число запросов, которые можно отправить до получения 429 ошибки

  • X-Lognex-Reset — время до сброса ограничения в миллисекундах. Равно нулю, если ограничение не установлено

  • X-Lognex-Retry-After — время до сброса ограничения в миллисекундах.

Все коды ошибок и их описания

1000

  • Сообщение: Элемент URI не является идентификатором

  • Описание: Вероятнее всего вы пытаетесь обратиться к несуществующему ресурсу. Проверьте
    указанный вами URI, проверьте правильно ли вы указали ключевое слово сущности и полностью ли вы скопировали ID.

1002

  • Сообщение: Неопознанный путь: {путь}

  • Описание: Не удалось определить ресурс, по которому был сделан запрос. Проверьте URI, по которому совершается запрос.

1004

  • Сообщение: Ошибка при формировании результата: {текст ошибки}

  • Описание: При разборе переданного объекта произошла ошибка. Проверьте корректность переданных данных.

1005

  • Сообщение: Неизвестный тип: {тип}

  • Описание: Тип сущности, указанный в URI, не может быть найден. Проверьте корректность ключевого слова.

1007

  • Сообщение: Неизвестное поле: {имя поля}

  • Описание: При обновлении сущности указанное поле не было найдено. Проверьте правильность написания имени поля, а также убедитесь что данное поле присутствует среди атрибутов сущностей этого типа.

1008

  • Сообщение: Ошибка при загрузке объекта с типом ‘{тип}’ и идентификатором ‘{id}’

  • Описание: Не удалось загрузить сущность с данным id. Проверьте корректность id. Убедитесь что сущность с данным id присутствует среди списка сущностей данного типа (возможно сущность с данным id была удалена).

1009

  • Сообщение: Редактирование объектов типа ‘{тип}’ не поддерживается

  • Описание: Сущность которую вы пытаетесь обновить — readonly. Изменение её атрибутов не предусмотрено.

1010

  • Сообщение: Удаление объектов типа ‘{тип}’ не поддерживается

  • Описание: Нельзя удалить сущность данного типа. Проверьте есть ли среди операций данного типа сущностей операция удаления.

1011

  • Сообщение: Создание объектов типа ‘{тип}’ не поддерживается

  • Описание: Нельзя создать сущность данного типа. Проверьте есть ли среди операций данного типа сущностей операция создания.

1012

  • Сообщение: Не указан идентификатор объекта

  • Описание: Ресурс, к которому вы обратились, требует идентификатор объекта.

1014

  • Сообщение: Неверное значение ‘{значение}’ параметра фильтрации ‘{имя параметра}’

  • Описание: Вы указали значение неподдерживаемого типа для данного параметра (например передали int вместо boolean). Возможно ошибка в неправильном формате даты и времени.

1015

  • Сообщение: Указана неверная версия в url: {url}

  • Описание: Проверьте необходимую версию API в url по которому вы делаете запрос. online.moysklad.ru/api/1.x/... Версии API различаются между собой по количеству
    доступных ресурсов, а также по способу обработки данных и именно поэтому являются важным элементом идентификации того или иного ресурса.

1016

  • Сообщение: Доступ запрещен: у вас нет прав на просмотр данного объекта

  • Описание: Администратор учётной записи ограничил ваши права на просмотр сущностей данного типа. Свяжитесь с ним для выяснения подробностей.

1017

  • Сообщение: Доступ запрещен: у вас нет прав на редактирование данного объекта

  • Описание: Администратор учётной записи ограничил ваши права на редактирование сущностей данного типа. Свяжитесь с ним для выяснения подробностей.

1019

  • Сообщение: Чтение поля ‘{имя поля}’ не поддерживается

  • Описание: Невозможно чтение поля данного типа.

1020

  • Сообщение: Родительский объект с типом ‘{тип}’ и идентификатором ‘{id}’ не существует

  • Описание: Неверный id родительской сущности.

1021

  • Сообщение: Объект с типом ‘{тип}’ и идентификатором ‘{id}’ не найден

  • Описание: Не удалось загрузить сущность данного типа с данным id. Проверьте корректность id. Убедитесь что сущность с данным id присутствует среди списка сущностей данного типа (возможно сущность с данным id была удалена)

1022

  • Сообщение: Ошибка при создании объекта

  • Описание: Ошибка в процессе создания сущности данного типа.

1023

  • Сообщение: Ошибка сохранения объекта: дочерний объект с типом ‘{тип}’ и идентификатором ‘{id}’ уже используется и не может быть удален

  • Описание: Невозможно удалить объект во вложенной коллекции т.к. он уже где-то используется. Например, может возникнуть при удалении позиции из документа, по которому есть возврат,
    в котором присутствует данная позиция.

1024

  • Сообщение: Ошибка сохранения объекта: изменять стандартные объекты запрещено

  • Описание: Вы пытаетесь изменить сущность, которая создаётся по умолчанию в сервисе МойСклад сразу после регистрации учётной записи. Это делать запрещено. (Например изменение стандартных стран и единиц измерения)

1027

  • Сообщение: Запрос не содержит объектов

  • Описание: Body запросов на создание/обновление должно представляться в виде объекта либо массива JSON.

1034

  • Сообщение: Ошибка фильтрации: {текст ошибки}

  • Описание: Ошибка в процессе обработки фильтров. Проверьте переданные фильтры на валидность. Подробнее о параметрах фильтрации вы можете прочесть в соответствующем разделе документации или в документации по сущности, к которой вы пытаетесь применять фильтры.

1035

  • Сообщение: Ошибка фильтрации: неверный формат даты параметра фильтрации

  • Описание: Проверьте значение даты и времени. Оно должно соответствовать формату yyyy-MM-dd HH:mm:ss

1036

  • Сообщение: Ошибка при формировании метаданных

  • Описание Внутренняя ошибка сервиса. Попробуйте повторить запрос.

1038

  • Сообщение: Ошибка в адресе запроса

  • Описание Проверьте, указываете ли вы валидный адрес запроса.

1039

  • Сообщение: Операция {HTTP метод} не поддерживается для данного ресурса

  • Описание Проверьте метод, с которым вы обращаетесь к ресурсу. Убедитесь, что в документации ресурса этот метод описан и его можно применить.

1040

  • Сообщение: Неверно заданы параметры запроса

  • Описание Один или несколько параметров запроса заданы некорректно. Проверьте формат параметров согласно документации.

1044

  • Сообщение: Превышен максимальный размер запроса

  • Описание: Максимальный размер запроса 10 МБ.

1048

  • Сообщение: Превышено ограничение на количество попыток проверки имени и пароля

  • Описание Вы попытались авторизоваться с помощью пары логин-пароль слишком много раз.

1049

  • Сообщение: Превышено ограничение на количество запросов в единицу времени

  • Описание От вас поступает слишком много запросов в единицу времени.

1050

  • Сообщение: Запрос метаданных не поддерживается в posap

  • Описание В posap не поддерживаются запросы на получение метаданных.

1051

  • Сообщение: Тип не совпадает с типом <meta_type> из meta

  • Описание Тип, который вы указали в объекте meta не соответствует типу ресурса, к которому вы делаете запрос.

1052

  • Сообщение: Неверный формат UUID

  • Описание: Проверьте сгенерированные вами UUID на корректность.

1053

  • Сообщение: Чтение объектов типа ‘{тип}’ не поддерживается

  • Описание: Нельзя прочтитать сущность данного типа.

1054

  • Сообщение: Указанный тип {тип сущности} не найден

  • Описание Ресурс для переданного типа не существует.

1055

  • Сообщение: Неизвестное значение {значение} параметра direction

  • Описание Вы передали некорректное значение direction. Можно передать только одно из следующих значений: forward, backward.

1056

  • Сообщение: Ошибка аутентификации: {текст ошибки аутентификации}

  • Описание Проверьте указанные для аутентификации данные. Возможно для данного ресурса требуется другой вид аутентификации.

1057

  • Сообщение: Отсутствует syncid для сущности

  • Описание В posap в ссылках (href) в meta необходимо всегда указывать /syncId/{id} сущности, который должен генерироваться на клиенте.

1060

  • Сообщение: Некорректный тип данных в meta сущности, поле type

  • Описание Тип данных указанный в поле type метаданных сущности не совпадает с ожидаемым типом.

1062

  • Сообщение: Неверное значение заголовка ‘Accept’. Поддерживается только значение ‘application/json;charset=utf-8’

  • Описание Заголовок Accept должен отсутствовать либо иметь значение указанное в тексте ошибки.

1065

  • Сообщение: Ошибка сохранения объекта: объект уже изменен/удален в параллельном запросе

  • Описание Ошибка возникает при попытке изменить объект из нескольких параллельных запросов к API.

1070

  • Сообщение: Ошибка: ваш тарифный план не позволяет вам работать с данным ресурсом

  • Описание На вашем тарифном плане работа с указанным ресурсом недоступна.

1071

  • Сообщение: Превышено ограничение на количество попыток регистрации

  • Описание Вы попытались зарегистрироваться слишком много раз

1072

  • Сообщение: Превышено ограничение на количество регистраций с указанного адреса

  • Описание Вы попытались зарегистрироваться слишком много раз

1073

  • Сообщение: Превышено ограничение на одновременное количество запросов

  • Описание От вас поступает слишком много параллельных запросов в единицу времени.

1074

  • Сообщение: Сервис временно недоступен, ведутся технические работы

  • Описание На сервере проводятся технические работы.

1999

  • Сообщение: Неизвестная ошибка

  • Описание Произошла непредвиденная ошибка. Пожалуйста, обратитесь в поддержку сервиса МойСклад подробно изложив условия при которых эта ошибка произошла.

Ошибки формата

2000

  • Сообщение: Ошибка формата: отсутствует начало объекта

  • Описание: В данном месте ожидалось начало объекта. Проверьте тело запроса.

2001

  • Сообщение: Ошибка формата: входящий запрос не соответствует формату JSON

  • Описание: Данные должны быть отправлены в формате JSON. Если это так, а ошибка всё-таки возникает — попробуйте добавить Header Content-Type со значением application/json.

2002

  • Сообщение: Ошибка формата: неименованное внутреннее поле типа массив

  • Описание: Проверьте указали ли вы наименование поля типа массив. Возможно присутствуют лишние открывающиеся/закрывающиеся скобки в теле запроса.

2003

  • Сообщение: Ошибка формата: неименованное внутреннее поле типа объект

  • Описание: Проверьте указали ли вы наименование поля типа “объект”. Возможно присутствуют лишние открывающиеся/закрывающиеся скобки в теле запроса.

2004

  • Сообщение: Ошибка формата: вложенные массивы недопустимы

  • Описание: В рамках JSON API не обрабатываются массивы массивов. Проверьте тело запроса на корректность.

2005

  • Сообщение: Ошибка формата: входящий JSON должен начинаться либо с объекта, либо с массива

  • Описание: Отсутствует открывающаяся фигурная/квадратная скобка в начале тела запроса.

2006

  • Сообщение: Ошибка формата: слишком большая вложенность объектов

  • Описание: Максимальная глубина вложенности в JSON API — 10. Скорректируйте тело запроса и убедитесь, что это ограничение не нарушается.

2007

  • Сообщение: Ошибка формата: слишком большое число вложенных объектов

  • Описание: В JSON API в массиве может содержаться не более 1000 объектов.

2008

  • Сообщение: Ошибка формата: запрос на шаблон не должен содержать массив

  • Описание: С помощью запроса по ресурсу {entity_name}/new можно создать только 1 шаблон. Передача массива значений не поддерживается.

2009

  • Сообщение: Ошибка формата: запрос на создание/обновление одной сущности не должен содержать массив

  • Описание: При обновлении отдельной сущности подразумевается, что в теле запроса будет передано её новое представление (одно). В теле запроса должен быть один корневой объект.

2010

  • Сообщение: Ошибка формата: отсутствует href для meta поля ‘{доп. сообщение}’

  • Описание: В переданном объекте метаданных отсутствует поле href. Проверьте тело запроса.

2012

  • Сообщение: Ошибка формата: неизвестный type для meta поля ‘{доп. сообщение}’

  • Описание: В переданном объекте метаданных указан неизвестный тип. Проверьте тело запроса. Возможно вы указываете неверное ключевое слово для сущности. Проверьте документацию по данной сущности и убедитесь в правильности передаваемого type.

2013

  • Сообщение: Ошибка формата: неправильное значение href для meta поля ‘{доп. сообщение}’

  • Описание: Переданный href указывает на несуществующий объект. Убедитесь в корректности ссылки. Ошибка может быть в версии API, типе ресурса (entity/pos/report), ключевом слове сущности/(отчёта), id сущности.

2014

  • Сообщение: Ошибка формата: отсутствует meta для поля ‘{имя поля}’

  • Описание: Для полей типа метаданных (ссылок на другие связанные объекты) необходимо значение в виде объекта, содержащего meta.

2015

  • Сообщение: Ошибка формата: отсутствует id для поля ‘{имя поля}’

  • Описание: При передаче вложенных сущностей в виде полей необходимо указывать id этих сущностей.

2016

  • Сообщение: Ошибка формата: значение поля ‘{имя поля}’ не соответствует типу {тип поля}

  • Описание: Для указанного поле передано значение неверного типа. Исправьте тело запроса.

2017

  • Сообщение: Ошибка формата: неизвестная ошибка

  • Описание: Не удалось однозначно классифицировать ошибку. Убедитесь что формат передаваемых вами данных соответствует требуемому. Посмотрите примеры запросов в документации по используемой вами сущности.

2018

  • Сообщение: Ошибка формата: отсутствует поле для meta

  • Описание: Вы не указали обязательное поле объекта meta.

2019

  • Сообщение: Ошибка формата: Поле не совпадает с указанным в href для meta

  • Описание: В объекте meta нет соответствия между указанным полем и информацией в ссылке (href). Проверьте, совпадают ли id, idType и type в объекте meta и в ссылке (href) meta.

2020

  • Сообщение: Ошибка формата: href для meta должен ссылаться на сущность, /entity/

  • Описание: В ссылке (href) объекта meta можно ссылаться только на ресурсы из posap /entity/.

2025

  • Сообщение: Ошибка формата: Ошибка формата: значение <заголовок|параметр|поле> ‘<наименование>’ не соответствует формату даты ‘<формат даты>’

  • Описание: Переданное значение даты не соответствует формату даты

Общие ошибки валидации

3000

  • Сообщение: Ошибка сохранения объекта: поле ‘{имя поля}’ не может быть пустым или отсутствовать

  • Описание: Необходимое поле не может содержать пустого значения или отсутствовать. Все необходимые поля можно посмотреть в документации по сущности, с которой вы работаете, под заголовком “Атрибуты сущности”. Такие поля помечены как Необходимое.

3001

  • Сообщение: Ошибка сохранения объекта: поле ‘{имя поля}’ не может быть изменено

  • Описание: Вы пытаетесь изменить поле являющееся полем только для чтения. Все read-only поля можно посмотреть в документации по сущности, с которой вы работаете, под заголовком “Атрибуты сущности”. Такие поля помечены как Только для чтения.

3002

  • Сообщение: Ошибка сохранения объекта: поле ‘{имя поля}’ не может иметь отрицательное значение

  • Описание: Данное поле принимает только числовые значения больше либо равные нулю.

3003

  • Сообщение: Ошибка сохранения объекта: поле ‘{имя поля}’ должно быть больше нуля

  • Описание: Данное поле принимает только числовые значения больше нуля.

3004

  • Сообщение: Ошибка сохранения объекта: поле ‘{имя поля}’ не соответствует полю связанного объекта

  • Описание: Поле возврата не соответствует полю документа-основания. Невозможно изменить значения полей agent, currency, vatIncluded в возвратах на несоответствующие значениям этих же полей в документе-основании.

3005

  • Сообщение: Ошибка сохранения объекта: неверное значение ‘{значение}’ поля ‘{имя поля}’. Допустимые значения: {список значений}

  • Описание: Вы пытаетесь присвоить несуществующее значение полю типа “перечисление”(enum). Проверить все возможные значения этого поля вы можете в документации по данной сущности в разделе “Атрибуты сущности”.

3006

  • Сообщение: Ошибка сохранения объекта: нарушено ограничение уникальности параметра ‘{имя параметра}’

  • Описание: У указанного поля/параметра должно быть уникальное значение в системе. Например, если включена проверка на уникальность номеров операций, name у разных документов не может быть одинаковым.

3007

  • Сообщение: Ошибка валидации сохраняемого объекта: ‘{объект}’

  • Описание: Ошибка при обмене. Проверьте, соблюдает ли все условия передаваемый вами объект.

3008

  • Сообщение: Ошибка сохранения объекта: значение поля ‘{имя поля}’ превышает максимально допустимое значение

  • Описание: Значение числового поля превышает максимально допустимое значение: 9 999 999 999.

3011

  • Сообщение: Ошибка валидации штрихкода: невозможно добавить к сущности штрихкод длиной более 255 символов

  • Описание: Исправьте длину штрихкода и попробуйте повторить запрос.

3030

  • Сообщение: Ошибка валидации заголовка ‘{название заголовка}’: {описание ошибки}

  • Описание: Было передано некорректное значение в заголовке.

Точки продаж

4000

  • Сообщение: Указанная точка продаж не активна

  • Описание: Для выполнения операции необходимо активировать точку продаж.

Розничные смены (POS)

12003

  • Сообщение: Ошибка закрытия розничной смены: розничная смена находится в корзине

  • Описание: Смена с указанным id находится в корзине. Проверьте правильность указанного вами id смены.

12006

  • Сообщение: Ошибка открытия розничной смены: параметр ‘retailShift’ отсутствует или имеет неверный формат

  • Описание: Убедитесь в наличии параметра retailShift.

12007

  • Сообщение: Ошибка закрытия розничной смены: параметр ‘retailShift’ отсутствует или имеет неверный формат

  • Описание: В теле запроса должно присутствовать поле retailShift (в camel-case) типа объект, содержащее в себе meta с ссылкой, содержащей syncId открываемой смены.

12008

  • Сообщение: Ошибка открытия розничной смены: параметр ‘name’ отсутствует

  • Описание: В теле запроса должно присутствовать поле name (номер смены) типа строка.

12009

  • Сообщение: Ошибка открытия розничной смены: параметр ‘openmoment’ отсутствует

  • Описание: В теле запроса должно присутствовать поле openmoment (дата-время открытия) типа строка в формате дата-время.

12010

  • Сообщение: Ошибка закрытия розничной смены: параметр ‘closemoment’ отсутствует

  • Описание: В теле запроса должно присутствовать поле closemoment (дата-время закрытия) типа строка в формате дата-время.

12012

  • Сообщение: Розничная смена не существует

  • Описание: Смена которую вы пытаетесь закрыть не существует. Убедитесь что указываете верный syncId смены.

12013

  • Сообщение: Ошибка аутентификации. Пользователь {user} не является кассиром на точке продаж «{retailstore}»

  • Описание: Для указанной точки продаж пользователь не является кассиром. Указать кассира можно в настройках точки продаж.

12014

  • Сообщение: Непредвиденная ошибка сохранения токена

  • Описание: Попробуйте осуществить запрос на получение токена ещё раз.

12015

  • Сообщение: Ошибка получения токена: не найдена точка продаж

  • Описание: Не найдено точки продаж с указанным id.

12016

  • Сообщение: Пользователь-кассир деактивирован. Обратитесь к администратору аккаунта.

  • Описание: Вы пытаетесь аутентифицироваться как неактивный пользователь. Следует обратиться к администратору аккаунта.

12017

  • Сообщение: Неправильный или просроченный ключ доступа

  • Описание: Срок действия ключа доступа истёк или же сам переданный ключ не корректен. Уточните вводимые данные.

12018

  • Сообщение: Допустимо использование сессии только для авторизованной точки продаж

  • Описание: Точка продаж должна быть привязана к токену. О том как это сделать вы можете прочитать тут.

12021

  • Сообщение: Ошибка закрытия розничной смены: нельзя закрыть смену другой точки продаж

  • Описание: Смена, которую вы пытаетесь закрыть, принадлежит другой точке продаж. Убедитесь в правильности token, который вы используете для аутентификации, а также в правильности syncId смены.

12022

  • Сообщение: Указанный пользователь не является кассиром ни на одной точке продаж

  • Описание: Только кассир на активной точке продаж может привязать точку продаж и получить токен. Указать кассира можно в настройках точки продаж.

12023

  • Сообщение: Нельзя создать документ в рамках розничной смены, находящейся в корзине

  • Описание: Смена с указанным id находится в корзине. Проверьте правильность указанного вами id смены.

12024

  • Сообщение: Ошибка закрытия розничной смены: непредвиденная ошибка создания (входящего платежа|ПКО)

  • Описание Ошибка в процессе создания входящего платежа или ПКО во время закрытия розничной смены.

12025

  • Сообщение: Ошибка аутентификации: Неправильный пароль или имя пользователя

  • Описание Ошибка в процессе аутентификации.

Товары

16000

  • Сообщение: Ошибка сохранения товара: свойства алкогольной продукции не могут быть отрицательными

  • Описание: Алкогольные поля “код алкогольной продукции”, “крепость” и “объём” должны принимать значение строго большее 0.

16001

  • Сообщение: Ошибка сохранения товара: весовой товар не может использовать учет по серийным номерам

  • Описание: Товар не может одновременно быть весовым и использовать учёт по серийным номерам. Это — взаимоисключающие признаки.

16002

  • Сообщение: Ошибка сохранения товара: нельзя отключить серийный учёт

  • Описание: Если серийный учет однажды включен, то его уже нельзя отключить. В ином случае вы можете создать новый товар.

16003

  • Сообщение: Ошибка сохранения товара: у изображения отсутствует контент

  • Описание: При передаче изображение в составе товара в запросе на создание товара необходимо указывать поле content

16004

  • Сообщение: Ошибка сохранения товара: невозможно преобразовать поле content в изображение

  • Описание: Содержимым поля content должно быть изображение закодированное в формате base64 с расширением jpg или png.

16005

  • Сообщение: Ошибка сохранения товара: Недостаточно места в хранилище.

  • Описание: Место в хранилище, выделенное для вашей учётной записи закончилось.

16006

  • Сообщение: Ошибка сохранения товара: размер изображения превышает максимально допустимый(3 мб)

  • Описание: Попробуйте уменьшить размер изображения.

16008

  • Сообщение: Ошибка сохранения товара: для использования упаковок нужно указать единицу измерения товара

  • Описание: Для использования упаковок должна быть задана единица измерения товара

16010

  • Сообщение: Ошибка сохранения товара: если указано, что товар облагается налогом, то необходимо заполнить поле vat. Иначе vatEnabled для товара должен иметь значение false

  • Описание: При передаче поля vatEnabled = true для товара нужно указывать также значение НДС.

16011

  • Сообщение: Ошибка сохранения товара: разливной товар не может учитываться по серийным номерам.

  • Описание: Товар не может быть одновременно на разлив и с учетом по серийным номерам.

16012

  • Сообщение: Ошибка сохранения товара: товар не может быть разливным и весовым одновременно.

  • Описание: Товар не может быть одновременно весовым и на разлив.

16013

  • Сообщение: Ошибка сохранения товара: весовой товар не может иметь признак средства индивидуальной защиты.

  • Описание: Товар не может быть одновременно на разлив и иметь признак средства индивидуальной защиты.

16014

  • Сообщение: Ошибка сохранения товара: разливной товар не может иметь признак средства индивидуальной защиты.

  • Описание: Разливной товар не может иметь признак средства индивидуальной защиты.

16015

  • Сообщение: Ошибка сохранения товара: неверно указан тип маркировки «{тип маркировки}» для разливного товара.

  • Описание: Разливной товар может сочетаться только с типами маркировки MILK, PERFUMERY, NOT_TRACKED.

16103

  • Сообщение: Ошибка сохранения: маркированный товар не может учитываться по серийным номерам.

  • Описание: Маркированный товар не может учитываться по серийным номерам.

16104

  • Сообщение: Ошибка сохранения товара: маркированный товар не может быть алкогольным.

  • Описание: Маркированный товар не может быть алкогольным.

16105

  • Сообщение: Ошибка сохранения товара: Ошибка сохранения: маркированный товар не может быть весовым.

  • Описание: Весовой товар может сочетаться только с типами маркировки MILK, NOT_TRACKED.

16113

  • Сообщение: * Ошибка сохранения товара: маркированный товар не может быть средством индивидуальной защиты.*

  • Описание: Маркированный товар не может быть средством индивидуальной защиты.

Документы

17002

  • Сообщение: Ошибка сохранения позиции документа: серийный номер не может быть пустым

  • Описание: Серийный номер не может быть пустой строкой.

17003

  • Сообщение: Ошибка сохранения позиции документа: количество зарезрвированных товаров не может превышать общее количество

  • Описание: Количество зарезервированного товара позиции документа не может превышать общее количество товара по документу.

17004

  • Сообщение: Ошибка сохранения позиции документа: количество товаров в ожидании не может превышать общее количество

  • Описание: Количество ожидаемого товара позиции документа не может превышать общее количество товара по документу.

17005

  • Сообщение: Ошибка сохранения связанного документа: отсутствует ссылка на документ-основание

  • Описание: При сохранении связанного документа необходима ссылка на документ-основание (например при сохранении возврата необходима ссылка на продажу).

17007

  • Сообщение: Ошибка сохранения позиции документа: НДС не может быть больше 100

  • Описание: Процент НДС может принимать значения от 0 до 100.

17008

  • Сообщение: Ошибка сохранения позиции документа: скидка не может быть больше 100

  • Описание: Процент скидки может принимать значения от 0 до 100.

17017

  • Сообщение: Ошибка сохранения документа: количество переданных серийных номеров не соответствует количеству в позиции

  • Описание: Поле позиции quantity должно соответствовать размеру коллекции sn.

17021

  • Сообщение: Ошибка сохранения позиции документа: если указано, что позиция облагается налогом, то необходимо заполнить поле vat. Иначе vatEnabled для позиции должен иметь значение false

  • Описание: При передаче поля vatEnabled = true в позиции нужно указывать также значение НДС.

Продажи

18000

  • Сообщение: Ошибка сохранения продажи: сумма ‘cashSum’, ‘noCashSum’, ‘qrSum’, ‘prepaymentCashSum’, ‘prepaymentNoCashSum’ и ‘prepaymentQrSum’ не соответствует сумме по документу

  • Описание: Сумма полей cashSum, noCashSum, qrSum, prepaymentCashSum, prepaymentNoCashSum, prepaymentQrSum должна быть равна значению поля sum или отличаться менее чем на 10 единиц. В случае создания документа и указании вышеупомянутых полей в теле запроса, ответственность за подсчёт sum ложится на пользователя. sum считается как общая сумма по всем позициям документа. Допускается расхождение на 10 (учет идёт в копейках).

18003

  • Сообщение: Ошибка сохранения продажи: нельзя указывать баллы к начислению или списанию без указания бонусной программы

  • Описание: При заполнении любого из полей bonusValueToEarn, bonusValueToSpend, поле bonusProgram становится обязательным для заполнения.

18005

  • Сообщение: В случае заполненного поля ‘qrSum’ поля ‘cashSum’, ‘noCashSum’, ‘prepaymentCashSum’ и ‘prepaymentNoCashSum’ должны быть пустыми

  • Описание: Смешанная оплата по QR-коду и карте или по QR-коду и наличными запрещена

18006

  • Сообщение: В случае заполненного поля ‘prepaymentQrSum’ поля ‘cashSum’, ‘noCashSum’, ‘prepaymentCashSum’ и ‘prepaymentNoCashSum’ должны быть пустыми

  • Описание: В случае предоплаты по QR-коду оплата возможна только по QR-коду

Возвраты

19003

  • Сообщение: Ошибка сохранения розничного возврата: возврат возможен только по QR-коду

  • Описание: Возникает в случае, если продажа была осуществлена по QR-коду, а возврат осуществляется за наличные или по карте. При создании такого возврата поля ‘cashSum’ и ‘noCashSum’ должны отсутствовать

19004

  • Сообщение: Ошибка сохранения розничного возврата: возврат по QR-коду поддержан только для операций, оплаченных по QR-коду

  • Описание: Возникает в случае, если продажа была осуществлена за наличные или по карте, а возврат осуществляется по QR-коду. При создании такого возврата поле ‘qrSum’ должно отсутствовать

Серийные номера

45000

  • Сообщение: Ошибка формата: количество переданных серийных номеров не соответствует количеству в позиции

  • Описание: Поле позиции quantity должно соответствовать размеру коллекции sn.

45001

  • Сообщение: Ошибка формата: указаны серийные номера для позиции {id}, по которой не ведётся серийный учет

  • Описание: Для указанной позиции нельзя вести учет по товарам и передавать коллекцию sn для расчета.

46000

  • Сообщение: Ошибка вызова внешней системы лояльности

  • Описание: При вызове внешней системы лояльности возникла ошибка.

46001

  • Сообщение: Отсутствует syncid для сущности ‘counterparty’

  • Описание: В данном методе предполагается, что у сущности counterparty должно быть непустое свойство syncid

46002

  • Сообщение: Невозможно рассчитать чек

  • Описание: Во время работы метода возникла ошибка, которая не позволяет выполнить пересчет. Может возникать, как последствие ошибки при вызове внешней системы (системы лояльности)

Тарифные ограничения

47000

  • Сообщение: Тарифное ограничение: {описание ограничения}

  • Описание: Сработало тарифное ограничение для текущего тарифа.

Предоплаты

48000

  • Сообщение: Сумма предоплаты должна быть положительным числом.

  • Описание: Сумма предоплаты складывается из полей cashSum и noCashSum. Проверьте, чтобы сумма этих полей была > 0.

48001

  • Сообщение: В предоплате должна быть хотя бы одна позиция.

  • Описание: Невозможно создать предоплату без позиций.

48002

  • Сообщение: Сумма предоплаты не может превышать сумму по позициям

  • Описание: Сумма предоплаты не может быть больше суммарной стоимости всех позиций.

48003

  • Сообщение: Невозможно создать предоплату от розничного покупателя. Должен быть выбран “реальный” контрагент.

  • Описание: Предоплата не может быть создана на контрагента “Розничный покупатель”.

48004

  • Сообщение: Невозможно создать предоплату по заказу с неположительной суммой

  • Описание: Сумма заказа, по которой создаётся предоплата, должна быть >= 0.

48005

  • Сообщение: Невозможно создать предоплату по заказу у которого нет хотя бы одной позиции

  • Описание: В заказе, по которому создаётся предоплата, должна быть хотя бы одна позиция.

48006

  • Сообщение: Невозможно создать предоплату по полностью оплаченному заказу

  • Описание: Сумма платежей и предоплат по переданному заказу >= сумме самого заказа. Предоплата по такому заказу не имеет смысла.

Возвраты предоплат

49000

  • Сообщение: Сумма возврата предоплаты должна быть положительным числом.

  • Описание: Сумма возврата предоплаты складывается из полей cashSum и noCashSum. Проверьте, чтобы сумма этих полей была > 0.

49001

  • Сообщение: В возврате предоплаты должна быть хотя бы одна позиция.

  • Описание: Невозможно создать возврат предоплаты без позиций.

49002

  • Сообщение: Сумма возврата предоплаты не может превышать сумму по позициям

  • Описание: Сумма возврата предоплаты не может быть больше суммарной стоимости всех позиций.

49003

  • Сообщение: Невозможно сохранить возврат предоплаты: сумма возвратов превышает сумму предоплаты.

  • Описание: Невозможно сохранить возврат предоплаты, т.к. в противном случае сумма возвратов превысит сумму предоплаты.

Структура метаданных в posap:

Метаданные коллекций:

  • href — ссылка

  • mediaType — MIME тип

  • size — размер выборки

  • limit — макс. количество объектов в выборке

  • offsetId — id элемента, после которого начинается текущая страница сущностей

  • direction — направление листания. Одно из значений [forward, backward]

  • previousHref — Ссылка на предыдущую страницу (отображается только когда указан offsetId не по умолчанию)

  • nextHref — Ссылка на следующую страницу (отображается только когда указан offsetId не по умолчанию)

Метаданные объектов

  • href — ссылка на сущность

  • mediaType — MIME тип

  • type — тип сущности

  • id — id сущности

  • idType — тип id. Одно из значений [native, sync]

В POS API можно получать поля типа дата-время (момент времени) в формате: ГГГГ-ММ-ДД ЧЧ:ММ:СС.ммм. Для этого нужно добавить специальный заголовок к запросу:
X-Lognex-Format-Millisecond со значением true.

В POS API можно получать ответы от сервера в виде pretty-print JSON (JSON с отступами вместо JSON в одну строку). Для этого нужно добавить специальный заголовок к запросу:
Lognex-Pretty-Print-JSON со значением true.

Через JSON API или POS API при запросах можно отключить уведомления вебхуков в контексте данного запроса.
Для этого нужно указать заголовок X-Lognex-WebHook-Disable с произвольным значением.

На учётной записи пользователя есть контрагент, использующийся как контрагент для розничных продаж. По умолчанию он назван “Розничный покупатель”. Если через POS API создать продажу, не указывая при этом поле agent, контрагентом такой продажи автоматически станет “Розничный покупатель”.

Сценарий работы ¶

Сценарий работы с POS API состоит из нескольких шагов:

  • Получение токена для точки продаж

  • Загрузка необходимых для работы данных (настройки точки продаж, справочник товаров и услуг, справочник контрагентов)

  • Открытие розничной смены

  • Совершение операций (кассовые внесения и выплаты, продажи, возвраты по продажам)

  • Закрытие розничной смены

Для получения токена для точки продаж необходимо воспользоваться двумя административными ресурсами:

  • Ресурсом для получения списка точек продаж

  • Ресурсом для получения токена для выбранной точки продаж

Важное отличие административных ресурсов в том, что авторизация на них происходит с помощью пары логин-пароль от
учётной записи сервиса МойСклад (Basic Auth). На всех остальных ресурсах необходима авторизация по полученному токену для точки продаж.

После получения токена для авторизации можно начинать работу от лица POS терминала, открывать и закрывать смены, запрашивать данные и проводить операции.

При работе с POS API убедитесь:

  • Что активна текущая точка продаж, для которой открываются смены, создаются операции, и, в рамках которой посылаются запросы.

  • Что пользователь, от имени которого посылаются запросы, авторизован соответствующим для данного ресурса способом (способ авторизации указан для каждого ресурса POS API в секции “Авторизация”),
    и, в случае авторизации по token для точки продаж, он является активным пользователем и кассиром на данной точке продаж.

Ниже, в качестве примера, описан один из возможных сценариев работы с POS API, состоящий из следующих шагов:

  • Получение списка точек продаж

  • Получение токена для точки продаж

  • Загрузка настроек точки продаж

  • Открытие смены

  • Загрузка списка товаров и услуг

  • Создание продажи

  • Закрытие смены

Получить точки продаж ¶

Для начала работы нам нужно выбрать точку, с которой мы будем осуществлять розничные операции.
Для этого запросим список точек продаж.

GET https://online.moysklad.ru/api/posap/1.0/admin/retailstore

Responses200

Успешный запрос. Результат — JSON представление списка точек продаж.

Headers
Content-Type: application/json
Authorization: Basic YWRtaW5AcmVxd3k6MTIzMTIz

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/admin/retailstore",
    "mediaType": "application/json",
    "size": 1,
    "limit": 1000,
    "offsetId": "00000000-0000-0000-0000-000000000000",
    "direction": "forward"
  },
  "rows": [
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailstore/5d4d2ca2-7b1d-11e6-8a84-bae500000060",
        "mediaType": "application/json",
        "type": "retailstore",
        "id": "5d4d2ca2-7b1d-11e6-8a84-bae500000060",
        "idType": "native"
      },
      "id": "5d4d2ca2-7b1d-11e6-8a84-bae500000060",
      "version": 2,
      "updated": "2016-09-21 19:27:45",
      "name": "Точка продаж",
      "externalCode": "W0M-XxXYjPZJjA1cT3RTL2",
      "controlShippingStock": false,
      "controlCashierChoice": false,
      "discountEnable": true,
      "discountMaxPercent": 100,
      "priceType": "Цена продажи",
      "authTokenAttached": true,
      "cashiers": {
        "rows": [
          {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/employee/a4f36276-7b5a-11e6-8a84-bae500000004",
              "mediaType": "application/json",
              "type": "employee",
              "id": "a4f36276-7b5a-11e6-8a84-bae500000004",
              "idType": "native"
            },
            "uid": "cashier@myorg",
            "firstName": "Иван",
            "middleName": "Иванович",
            "lastName": "Иванов",
            "email": "ivanov@myorg.ru"
          }
        ]
      },
      "organization": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/organization/5d0f5e3e-7b1d-11e6-8a84-bae500000051",
          "mediaType": "application/json",
          "type": "organization",
          "id": "5d0f5e3e-7b1d-11e6-8a84-bae500000051",
          "idType": "native"
        },
        "id": "5d0f5e3e-7b1d-11e6-8a84-bae500000051",
        "version": 5,
        "updated": "2016-09-21 14:30:43",
        "name": "myorg",
        "description": "Моя организация",
        "code": "1234",
        "externalCode": "PW55m0xUiG1pAlGJv73Sd2",
        "companyType": "legal",
        "legalTitle": "ООО Иванов",
        "legalAddress": "г Москва, ул Гашека, д 12 к 1",
        "actualAddress": "г Москва, ул Вавилова д 19 3/4",
        "inn": "7714045520",
        "kpp": "775001001",
        "ogrn": "1027700042413",
        "okpo": "121351253251",
        "email": "myorg@orgmy.su",
        "phone": "346243637247",
        "fax": "32472377432524",
        "isEgaisEnable": true,
        "fsrarId": "the id for fr",
        "payerVat": true,
        "utmUrl": "url.coms"
      },
      "store": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/store/5d1fa036-7b1d-11e6-8a84-bae500000053",
          "mediaType": "application/json",
          "type": "counterparty",
          "id": "5d1fa036-7b1d-11e6-8a84-bae500000053",
          "idType": "native"
        },
        "pathName": "",
        "address": "г Москва ул Милашенкова д 2"
      },
      "acquire": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/1c5dcf6f-7b32-11e6-8a84-bae500000000",
          "mediaType": "application/json",
          "type": "counterparty",
          "id": "1c5dcf6f-7b32-11e6-8a84-bae500000000",
          "idType": "native"
        }
      },
      "egaisEnabled": false,
      "frNumber": "",
      "returnFromClosedShiftEnabled": false,
      "alwaysPrintCheck": false,
      "ofdEnabled": false,
      "allowCustomPrice": false,
      "isExternalCustomers": false,
      "sendMarksForCheck": false
    }
  ]
}

Получить точки продаж

GET/admin/retailstore

Запрос списка точек продаж. Basic авторизация с помощью пары логин:пароль закодированных в BASE64.
В ответ получим список точек продаж.

Назначить токен для точки продаж ¶

После того как мы выбрали точку продаж нужно получить для неё токен авторизации.
Используем id нашей точки продаж (5d4d2ca2-7b1d-11e6-8a84-bae500000060). И получаем необходимый нам токен.

POST https://online.moysklad.ru/api/posap/1.0/admin/attach/5d4d2ca2-7b1d-11e6-8a84-bae500000060

Responses201

Успешный запрос. Результат — токен для последующей аутентификации на данной точке продаж.

Headers
Content-Type: application/json
Authorization: Basic YWRtaW5AcmVxd3k6MTIzMTIz

BodyСкрытьПоказать

{
  "token": "6ab89be1ae6ff147753335ee8da948e42612233b",
  "uid": "kassir@321"
}

Назначить токен для точки продаж

POST/admin/attach/{id}

URI Параметры

СкрытьПоказать

id
string (required) Example: 5d4d2ca2-7b1d-11e6-8a84-bae500000060

id точки продаж, которой назначается token

Настройки точки продаж ¶

Теперь авторизуемся по полученному токену и запросим настройки точки продаж.

GET https://online.moysklad.ru/api/posap/1.0/settings/retailstore/

Responses200

Успешный запрос. Результат — JSON представление настроек точки продаж.

Headers
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147753335ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: example@admin
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailstore/5d4d2ca2-7b1d-11e6-8a84-bae500000060",
    "mediaType": "application/json",
    "type": "retailstore",
    "id": "5d4d2ca2-7b1d-11e6-8a84-bae500000060",
    "idType": "native"
  },
  "id": "5d4d2ca2-7b1d-11e6-8a84-bae500000060",
  "version": 2,
  "updated": "2016-09-21 19:27:45",
  "name": "Точка продаж",
  "externalCode": "W0M-XxXYjPZJjA1cT3RTL2",
  "controlShippingStock": true,
  "onlyInStock": false,
  "controlCashierChoice": false,
  "discountEnable": true,
  "discountMaxPercent": 100,
  "priceType": "Цена продажи",
  "authTokenAttached": true,
  "cashiers": {
    "rows": [
      {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/employee/a4f36276-7b5a-11e6-8a84-bae500000004",
          "mediaType": "application/json",
          "type": "employee",
          "id": "a4f36276-7b5a-11e6-8a84-bae500000004",
          "idType": "native"
        },
        "uid": "cashier@myorg",
        "firstName": "Иван",
        "middleName": "Иванович",
        "lastName": "Иванов",
        "image": {
          "href": "http://online.moysklad.ru/api/posap/1.0/download/35629a98-d029-11e7-0532-9eed00000001",
          "miniature": "http://online.moysklad.ru/api/posap/1.0/download/35629a98-d029-11e7-0532-9eed00000001?miniature=true",
          "tiny": "http://online.moysklad.ru/app/download/3626405c-d029-11e7-0532-9eed00000002/t.png"
        },
        "inn": "222490425273",
        "position": "position",
        "email": "ivanov@myorg.ru"
      }
    ]
  },
  "organization": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/organization/5d0f5e3e-7b1d-11e6-8a84-bae500000051",
      "mediaType": "application/json",
      "type": "organization",
      "id": "5d0f5e3e-7b1d-11e6-8a84-bae500000051",
      "idType": "native"
    },
    "id": "5d0f5e3e-7b1d-11e6-8a84-bae500000051",
    "version": 5,
    "updated": "2016-09-21 14:30:43",
    "name": "myorg",
    "description": "Страховое публичное акционерное общество «РЕСО-Гарантия»",
    "code": "1234",
    "externalCode": "PW55m0xUiG1pAlGJv73Sd2",
    "companyType": "legal",
    "legalTitle": "СТРАХОВОЕ ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "РЕСО-ГАРАНТИЯ"",
    "legalAddress": "г Москва, ул Гашека, д 12 к 1",
    "actualAddress": "г Москва, ул Вавилова д 19",
    "inn": "7710045520",
    "kpp": "775001001",
    "ogrn": "1027700042413",
    "okpo": "121351253251",
    "email": "myorg@orgmy.su",
    "phone": "346243637247",
    "fax": "32472377432524",
    "isEgaisEnable": true,
    "fsrarId": "the id for fr",
    "payerVat": true,
    "utmUrl": "url.coms"
  },
  "store": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/store/5d1fa036-7b1d-11e6-8a84-bae500000053",
      "mediaType": "application/json",
      "type": "counterparty",
      "id": "5d1fa036-7b1d-11e6-8a84-bae500000053",
      "idType": "native"
    },
    "name": "Основной склад",
    "pathName": "",
    "address": "г Москва ул Милашенкова д 2"
  },
  "acquire": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/1c5dcf6f-7b32-11e6-8a84-bae500000000",
      "mediaType": "application/json",
      "type": "counterparty",
      "id": "1c5dcf6f-7b32-11e6-8a84-bae500000000",
      "idType": "native"
    }
  },
  "lastOperationNames": [
    {
      "entity": "retaildemand",
      "name": "03211312",
      "moment": "2016-10-07 15:50:14"
    },
    {
      "entity": "retaildrawercashin",
      "name": "00001",
      "moment": "2016-10-07 15:50:14"
    },
    {
      "entity": "retaildrawercashout",
      "name": "00001",
      "moment": "2016-10-07 15:50:14"
    },
    {
      "entity": "retailsalesreturn",
      "name": "0002199921",
      "moment": "2016-10-07 15:50:14"
    },
    {
      "entity": "retailshift",
      "name": "042777001",
      "moment": "2016-10-07 15:50:14"
    }
  ],
  "egaisEnabled": false,
  "frNumber": "",
  "returnFromClosedShiftEnabled": false,
  "alwaysPrintCheck": false,
  "issueOrders": false,
  "sellReserves": false,
  "ofdEnabled": false,
  "allowCustomPrice": false,
  "cash": 10050,
  "createPaymentInOnRetailShiftClosing": true,
  "createCashInOnRetailShiftClosing": false,
  "allowCreateProducts": true,
  "enableReturnsWithNoReason": true,
  "isOnlineDiscount": false,
  "isExternalCustomers": false,
  "isPhonePriority": true,
  "reservePrepaidGoods": false,
  "receiptTemplate": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/receipttemplate/4636cc33-d372-11e8-ac16-000900000001",
      "mediaType": "application/json",
      "type": "receipttemplate",
      "id": "4636cc33-d372-11e8-ac16-000900000001",
      "idType": "native"
    },
    "header": "АКЦИЯ: 6 ЗА 5. ПОДРОБНЕЕ ЧИТАЙТЕ В НИЖНЕЙ ЧАСТИ ЧЕКА",
    "footer": "КУПИТЕ 5 КОФЕ И ПОЛУЧИТЕ 6-й В ПОДАРОК, ПРЕДЪЯВИВ ЭТОТ ЧЕК"
  },
  "environment": {
    "device": "RetailStorePc",
    "os": "Linux",
    "software": {
      "name": "Касса МойСклад",
      "vendor": "МойСклад",
      "version": "2.2"
    },
    "chequePrinter": {
      "vendor": "АТОЛ",
      "name": "30Ф",
      "serial": "15636313",
      "fiscalDataVersion": "1.0",
      "driver": {
        "name": "АТОЛ (бета)",
        "version": "9.1"
      },
      "fiscalMemory": {
        "fiscalDataVersion": "1.1"
      },
      "firmwareVersion": "669"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "state": {
    "sync": {
      "message": "Ошибка синхронизации, необходимо войти повторно",
      "lastAttempMoment": "2016-09-06 21:41:00"
    },
    "lastCheckMoment": "2018-06-13 16:18:00",
    "fiscalMemory": {
      "error": {
        "code": "1003",
        "message": "Критическая ошибка"
      },
      "notSendDocCount": 25,
      "notSendFirstDocMoment": "2016-09-06 21:41:00"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "qrPayEnabled": true,
  "qrAcquire": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/1c5dcf6f-7b32-11e6-8a84-bae500000000",
      "mediaType": "application/json",
      "type": "counterparty",
      "id": "1c5dcf6f-7b32-11e6-8a84-bae500000000",
      "idType": "native"
    }
  },
  "enableNotMRCTobaccoSale": false,
  "tobaccoMrcControlType": "SAME_PRICE",
  "markingSellingMode": "CORRECT_MARKS_ONLY",
  "sendMarksForCheck": false
}

Настройки точки продаж

GET/settings/retailstore/

Открытие смены ¶

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

PUT https://online.moysklad.ru/api/posap/1.0/rpc/openshift/

RequestsПример

Пример запроса на открытие смены.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147753335ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: example@admin

BodyСкрытьПоказать

{
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/388bd178-800c-11e6-8a84-bae5022000a2"
    }
  },
  "name": "0001",
  "openmoment": "2016-09-06 21:41:46"
}

Responses204

This response has no content.

Открытие смены

PUT/rpc/openshift/

Для открытия смены нам потребуется syncId. Нужно сгенерировать его самому (на клиенте) и отправить на сервер в запросе на открытие смены.

Загрузка товаров ¶

Для создания продаж потребуется справочник товаров и услуг. Самое время его загрузить.

GET https://online.moysklad.ru/api/posap/1.0/entity/assortment

Responses200

Успешный запрос. Результат — JSON представление ассортимента товаров.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147753335ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: example@admin

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/assortment",
    "mediaType": "application/json",
    "size": 7,
    "limit": 1000,
    "offsetId": "00000000-0000-0000-0000-000000000000",
    "direction": "forward"
  },
  "rows": [
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/446901e7-7c12-11e6-8a84-bae500000068",
        "mediaType": "application/json",
        "type": "product",
        "id": "446901e7-7c12-11e6-8a84-bae500000068",
        "idType": "native"
      },
      "id": "446901e7-7c12-11e6-8a84-bae500000068",
      "name": "Товар1",
      "code": "00002",
      "barcodes": [
        "2000000000022"
      ],
      "salePrices": [
        {
          "value": 0,
          "priceType": "Цена продажи"
        }
      ],
      "uom": "шт",
      "egaisIsAlcoholic": true,
      "egaisHasExciseMark": false,
      "egaisVolume": 0,
      "egaisAlcoholPercent": 0,
      "soldByWeight": false,
      "onTap": false,
      "stock": -1,
      "reserve": 0
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/81fdf852-7c21-11e6-8a84-bae500000068",
        "mediaType": "application/json",
        "type": "product",
        "id": "81fdf852-7c21-11e6-8a84-bae500000068",
        "idType": "native"
      },
      "id": "81fdf852-7c21-11e6-8a84-bae500000068",
      "name": "Пиво",
      "code": "00003",
      "barcodes": [
        "2000000000039"
      ],
      "salePrices": [
        {
          "value": 1000,
          "priceType": "Цена продажи"
        },
        {
          "value": 2000,
          "priceType": "Цена праздничная"
        }
      ],
      "productFolder": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
          "mediaType": "application/json",
          "type": "productfolder",
          "id": "dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
          "idType": "native"
        },
        "id": "dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
        "name": "Овощи",
        "namepath": "Овощи",
        "path": "/dbe2cf7f-7b5c-11e6-8a84-bae50000000e/"
      },
      "article": "Ovosh1",
      "uom": "шт",
      "egaisIsAlcoholic": true,
      "egaisHasExciseMark": false,
      "egaisProductCode": 1,
      "egaisVolume": 2,
      "egaisAlcoholPercent": 0.3,
      "soldByWeight": false,
      "onTap": false,
      "stock": -208,
      "reserve": 0
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/86e8625c-7b1d-11e6-8a84-bae500000106",
        "mediaType": "application/json",
        "type": "product",
        "id": "86e8625c-7b1d-11e6-8a84-bae500000106",
        "idType": "native"
      },
      "id": "86e8625c-7b1d-11e6-8a84-bae500000106",
      "name": "Товар",
      "code": "00001",
      "barcodes": [
        "2000000000015"
      ],
      "salePrices": [
        {
          "value": 0,
          "priceType": "Цена продажи"
        }
      ],
      "uom": "шт",
      "egaisIsAlcoholic": true,
      "egaisHasExciseMark": false,
      "egaisVolume": 0,
      "egaisAlcoholPercent": 0,
      "soldByWeight": false,
      "onTap": false,
      "stock": -23,
      "reserve": 0
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/service/a22fb175-7fcf-11e6-8a84-bae500000005",
        "mediaType": "application/json",
        "type": "service",
        "id": "a22fb175-7fcf-11e6-8a84-bae500000005",
        "idType": "native"
      },
      "id": "a22fb175-7fcf-11e6-8a84-bae500000005",
      "name": "Услуга",
      "code": "00004",
      "barcodes": [
        "2000000000046"
      ],
      "salePrices": [
        {
          "value": 0,
          "priceType": "Цена продажи"
        }
      ],
      "uom": "шт"
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/b2334e83-7fcf-11e6-8a84-bae50000000c",
        "mediaType": "application/json",
        "type": "product",
        "id": "b2334e83-7fcf-11e6-8a84-bae50000000c",
        "idType": "native"
      },
      "id": "b2334e83-7fcf-11e6-8a84-bae50000000c",
      "name": "Товар2",
      "code": "00005",
      "barcodes": [
        "2000000000053"
      ],
      "salePrices": [
        {
          "value": 0,
          "priceType": "Цена продажи"
        }
      ],
      "uom": "шт",
      "egaisIsAlcoholic": false,
      "egaisHasExciseMark": false,
      "egaisVolume": 0,
      "egaisAlcoholPercent": 0,
      "soldByWeight": false,
      "onTap": false,
      "stock": 0,
      "reserve": 0
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/variant/b23bf8f1-7fcf-11e6-8a84-bae500000010",
        "mediaType": "application/json",
        "type": "variant",
        "id": "b23bf8f1-7fcf-11e6-8a84-bae500000010",
        "idType": "native"
      },
      "id": "b23bf8f1-7fcf-11e6-8a84-bae500000010",
      "name": "(Mod)",
      "code": "00002",
      "barcodes": [
        "2000000000060"
      ],
      "salePrices": [
        {
          "value": 0,
          "priceType": "Цена продажи"
        }
      ],
      "characteristics": {
        "Style": "Hip"
      },
      "product": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/b2334e83-7fcf-11e6-8a84-bae50000000c",
          "mediaType": "application/json",
          "type": "product",
          "id": "b2334e83-7fcf-11e6-8a84-bae50000000c",
          "idType": "native"
        },
        "id": "b2334e83-7fcf-11e6-8a84-bae50000000c",
        "name": "Товар2",
        "code": "00005",
        "uom": "шт",
        "egaisIsAlcoholic": false,
        "egaisHasExciseMark": false,
        "egaisVolume": 0,
        "egaisAlcoholPercent": 0,
        "soldByWeight": false,
        "onTap": false,
        "stock": 0,
        "reserve": 0
      }
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/variant/b23ed636-7fcf-11e6-8a84-bae500000014",
        "mediaType": "application/json",
        "type": "variant",
        "id": "b23ed636-7fcf-11e6-8a84-bae500000014",
        "idType": "native"
      },
      "id": "b23ed636-7fcf-11e6-8a84-bae500000014",
      "name": "(Hop)",
      "code": "00003",
      "barcodes": [
        "2000000000077"
      ],
      "salePrices": [
        {
          "value": 0,
          "priceType": "Цена продажи"
        }
      ],
      "characteristics": {
        "Style": "Hop"
      },
      "product": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/b2334e83-7fcf-11e6-8a84-bae50000000c",
          "mediaType": "application/json",
          "type": "product",
          "id": "b2334e83-7fcf-11e6-8a84-bae50000000c",
          "idType": "native"
        },
        "id": "b2334e83-7fcf-11e6-8a84-bae50000000c",
        "name": "Товар2",
        "code": "00005",
        "uom": "шт",
        "egaisIsAlcoholic": false,
        "egaisHasExciseMark": false,
        "egaisVolume": 0,
        "egaisAlcoholPercent": 0,
        "soldByWeight": false,
        "onTap": false,
        "stock": 0,
        "reserve": 0
      }
    },
    {
      "meta": {
        "href": "http://localhost/api/posap/1.0/entity/product/216e7496-6112-11e9-ac13-000c000000bc",
        "mediaType": "application/json",
        "type": "product",
        "id": "216e7496-6112-11e9-ac13-000c000000bc",
        "idType": "native"
      },
      "id": "216e7496-6112-11e9-ac13-000c000000bc",
      "name": "Товар",
      "code": "00001",
      "barcodes": [
        "2000000000015"
      ],
      "salePrices": [
        {
          "value": 0,
          "priceType": "Цена продажи"
        }
      ],
      "favorite": false,
      "uom": "шт",
      "egaisIsAlcoholic": false,
      "egaisHasExciseMark": false,
      "egaisVolume": 0,
      "egaisAlcoholPercent": 0,
      "soldByWeight": false,
      "onTap": false,
      "tobacco": false,
      "trackingType": "NOT_TRACKED",
      "stock": 0,
      "reserve": 0,
      "isSerialTrackable": false
    },
    {
      "meta": {
        "href": "http://localhost/api/posap/1.0/entity/product/ace86997-6113-11e9-ac13-000c000000c9",
        "mediaType": "application/json",
        "type": "product",
        "id": "ace86997-6113-11e9-ac13-000c000000c9",
        "idType": "native"
      },
      "id": "ace86997-6113-11e9-ac13-000c000000c9",
      "name": "shoes",
      "code": "00002",
      "barcodes": [
        "2000000000022"
      ],
      "salePrices": [
        {
          "value": 0,
          "priceType": "Цена продажи"
        }
      ],
      "favorite": false,
      "uom": "шт",
      "egaisIsAlcoholic": false,
      "egaisHasExciseMark": false,
      "egaisVolume": 0,
      "egaisAlcoholPercent": 0,
      "soldByWeight": false,
      "onTap": false,
      "tobacco": false,
      "trackingType": "SHOES",
      "stock": 0,
      "reserve": 0,
      "isSerialTrackable": false,
      "partialDisposal": false
    },
    {
      "meta": {
        "href": "http://localhost/api/posap/1.0/entity/product/c1d3dacb-6113-11e9-ac13-000c000000d2",
        "mediaType": "application/json",
        "type": "product",
        "id": "c1d3dacb-6113-11e9-ac13-000c000000d2",
        "idType": "native"
      },
      "id": "c1d3dacb-6113-11e9-ac13-000c000000d2",
      "name": "tobacco",
      "code": "00003",
      "barcodes": [
        "2000000000039"
      ],
      "salePrices": [
        {
          "value": 0,
          "priceType": "Цена продажи"
        }
      ],
      "favorite": false,
      "uom": "шт",
      "egaisIsAlcoholic": false,
      "egaisHasExciseMark": false,
      "egaisVolume": 0,
      "egaisAlcoholPercent": 0,
      "soldByWeight": false,
      "onTap": false,
      "tobacco": true,
      "trackingType": "TOBACCO",
      "stock": 0,
      "reserve": 0,
      "isSerialTrackable": false,
      "partialDisposal": false
    }
  ]
}

Загрузка товаров

GET/entity/assortment

Создание продажи ¶

Теперь, имея открытую смену и справочник товаров, создадим пробную розничную продажу.

POST https://online.moysklad.ru/api/posap/1.0/entity/retaildemand

Requestsсоздание продажи

Пример создания новой розничной продажи.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147753335ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: example@admin

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retaildemand/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
  },
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/388bd178-800c-11e6-8a84-bae5022000a2"
    }
  },
  "name": "000219991",
  "moment": "2016-09-06 21:41:46",
  "description": "размен",
  "agent": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/688bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/81fdf852-7c21-11e6-8a84-bae500000068",
          "mediaType": "application/json"
        }
      },
      "quantity": 2,
      "price": 500,
      "discount": 10,
      "discountSum": 100,
      "vat": 10,
      "vatSum": 100,
      "sum": 1000,
      "pdf": [
        "abc",
        "def"
      ],
      "marks": [
        {
          "cis": "12345678900987ABCDEFGabcdefgh"
        },
        {
          "cis": "00000046185372KY4mjNZAB=U/FkO"
        }
      ]
    }
  ],
  "cashSum": 800,
  "noCashSum": 100,
  "vatEnabled": true,
  "vatIncluded": true,
  "bottleUrl": "https://check.egais.ru?id=a9e56cb9-21d6-4404-9f24-668020fadf6a&amp;dt=0910141104&amp;cn=Magazin2014",
  "bottleSign": "418E6A105B60250CEB20F9F9A556FA4A9575B0C07EC536DE89CA868C884E296E56BA7EC7762C9BEC285CB4D8CD90EEE9F9FC16F92CCF324829E70862F0DFEC1B418E6A105B60250CEB20F9F9A556FA4A9575B0C07EC536DE89CA868C884E296E56BA7EC7762C9BEC285CB4D8CD90EEE9F9FC16F92CCF324829E70862F0DFEC1B",
  "chequeEmail": "test@test.org",
  "chequePhone": "123456",
  "electronicCheque": true,
  "paperCheque": true
}

Responses201

This response has no content.

Создание продажи

POST/entity/retaildemand

Закрытие смены ¶

По окончании работы закроем открытую нами ранее розничную смену.

PUT https://online.moysklad.ru/api/posap/1.0/rpc/closeshift/

RequestsПример

Пример запроса на закрытие смены.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147753335ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: example@admin

BodyСкрытьПоказать

{
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/388bd178-800c-11e6-8a84-bae5022000a2"
    }
  },
  "closemoment": "2016-09-06 22:40:00"
}

Responses204

This response has no content.

Закрытие смены

PUT/rpc/closeshift/

В запрос передаём meta от ранее открытой смены, а также момент закрытия.

Точка продаж ¶

Для данного ресурса предусмотрена обычная BASIC авторизация по паре логин-пароль.

Точка продаж ¶

GET https://online.moysklad.ru/api/posap/1.0/admin/retailstore

Responses200

Успешный запрос. Результат — JSON представление точки продаж.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/admin/retailstore",
    "mediaType": "application/json",
    "size": 1,
    "limit": 1000,
    "offsetId": "00000000-0000-0000-0000-000000000000",
    "direction": "forward"
  },
  "rows": [
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailstore/5d4d2ca2-7b1d-11e6-8a84-bae500000060",
        "mediaType": "application/json",
        "type": "retailstore",
        "id": "5d4d2ca2-7b1d-11e6-8a84-bae500000060",
        "idType": "native"
      },
      "id": "5d4d2ca2-7b1d-11e6-8a84-bae500000060",
      "version": 2,
      "updated": "2016-09-21 19:27:45",
      "name": "Точка продаж",
      "externalCode": "W0M-XxXYjPZJjA1cT3RTL2",
      "controlShippingStock": true,
      "onlyInStock": false,
      "controlCashierChoice": false,
      "discountEnable": true,
      "discountMaxPercent": 100,
      "priceType": "Цена продажи",
      "authTokenAttached": true,
      "cashiers": {
        "rows": [
          {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/employee/a4f36276-7b5a-11e6-8a84-bae500000004",
              "mediaType": "application/json",
              "type": "employee",
              "id": "a4f36276-7b5a-11e6-8a84-bae500000004",
              "idType": "native"
            },
            "uid": "cashier@myorg",
            "firstName": "Иван",
            "middleName": "Иванович",
            "lastName": "Иванов",
            "image": {
              "href": "http://online.moysklad.ru/api/posap/1.0/download/35629a98-d029-11e7-0532-9eed00000001",
              "miniature": "http://online.moysklad.ru/api/posap/1.0/download/35629a98-d029-11e7-0532-9eed00000001?miniature=true",
              "tiny": "http://online.moysklad.ru/app/download/3626405c-d029-11e7-0532-9eed00000002/t.png"
            },
            "inn": "222490425273",
            "position": "position",
            "email": "ivanov@myorg.ru"
          }
        ]
      },
      "organization": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/organization/5d0f5e3e-7b1d-11e6-8a84-bae500000051",
          "mediaType": "application/json",
          "type": "organization",
          "id": "5d0f5e3e-7b1d-11e6-8a84-bae500000051",
          "idType": "native"
        },
        "id": "5d0f5e3e-7b1d-11e6-8a84-bae500000051",
        "version": 5,
        "updated": "2016-09-21 14:30:43",
        "name": "myorg",
        "description": "Страховое публичное акционерное общество «РЕСО-Гарантия»",
        "code": "1234",
        "externalCode": "PW55m0xUiG1pAlGJv73Sd2",
        "companyType": "legal",
        "legalTitle": "СТРАХОВОЕ ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "РЕСО-ГАРАНТИЯ"",
        "legalAddress": "г Москва, ул Гашека, д 12 к 1",
        "actualAddress": "г Москва, ул Вавилова д 19",
        "inn": "7710045520",
        "kpp": "775001001",
        "ogrn": "1027700042413",
        "okpo": "121351253251",
        "email": "myorg@orgmy.su",
        "phone": "346243637247",
        "fax": "32472377432524",
        "isEgaisEnable": true,
        "fsrarId": "the id for fr",
        "payerVat": true,
        "utmUrl": "url.coms"
      },
      "store": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/store/5d1fa036-7b1d-11e6-8a84-bae500000053",
          "mediaType": "application/json",
          "type": "counterparty",
          "id": "5d1fa036-7b1d-11e6-8a84-bae500000053",
          "idType": "native"
        },
        "name": "Основной склад",
        "pathName": "",
        "address": "г Москва ул Милашенкова д 2"
      },
      "acquire": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/1c5dcf6f-7b32-11e6-8a84-bae500000000",
          "mediaType": "application/json",
          "type": "counterparty",
          "id": "1c5dcf6f-7b32-11e6-8a84-bae500000000",
          "idType": "native"
        }
      },
      "lastOperationNames": [
        {
          "entity": "retaildemand",
          "name": "03211312",
          "moment": "2016-10-07 15:50:14"
        },
        {
          "entity": "retaildrawercashin",
          "name": "00001",
          "moment": "2016-10-07 15:50:14"
        },
        {
          "entity": "retaildrawercashout",
          "name": "00001",
          "moment": "2016-10-07 15:50:14"
        },
        {
          "entity": "retailsalesreturn",
          "name": "0002199921",
          "moment": "2016-10-07 15:50:14"
        },
        {
          "entity": "retailshift",
          "name": "042777001",
          "moment": "2016-10-07 15:50:14"
        }
      ],
      "egaisEnabled": false,
      "frNumber": "",
      "returnFromClosedShiftEnabled": false,
      "alwaysPrintCheck": false,
      "issueOrders": false,
      "sellReserves": false,
      "ofdEnabled": false,
      "allowCustomPrice": false,
      "cash": 10050,
      "createPaymentInOnRetailShiftClosing": true,
      "createCashInOnRetailShiftClosing": false,
      "allowCreateProducts": true,
      "enableReturnsWithNoReason": true,
      "isOnlineDiscount": false,
      "isExternalCustomers": false,
      "isPhonePriority": true,
      "reservePrepaidGoods": false,
      "receiptTemplate": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/receipttemplate/4636cc33-d372-11e8-ac16-000900000001",
          "mediaType": "application/json",
          "type": "receipttemplate",
          "id": "4636cc33-d372-11e8-ac16-000900000001",
          "idType": "native"
        },
        "header": "АКЦИЯ: 6 ЗА 5. ПОДРОБНЕЕ ЧИТАЙТЕ В НИЖНЕЙ ЧАСТИ ЧЕКА",
        "footer": "КУПИТЕ 5 КОФЕ И ПОЛУЧИТЕ 6-й В ПОДАРОК, ПРЕДЪЯВИВ ЭТОТ ЧЕК"
      },
      "environment": {
        "device": "RetailStorePc",
        "os": "Linux",
        "software": {
          "name": "Касса МойСклад",
          "vendor": "МойСклад",
          "version": "2.2"
        },
        "chequePrinter": {
          "vendor": "АТОЛ",
          "name": "30Ф",
          "serial": "15636313",
          "fiscalDataVersion": "1.0",
          "driver": {
            "name": "АТОЛ (бета)",
            "version": "9.1"
          },
          "fiscalMemory": {
            "fiscalDataVersion": "1.1"
          },
          "firmwareVersion": "669"
        },
        "paymentTerminal": {
          "acquiringType": "payme"
        }
      },
      "state": {
        "sync": {
          "message": "Ошибка синхронизации, необходимо войти повторно",
          "lastAttempMoment": "2016-09-06 21:41:00"
        },
        "lastCheckMoment": "2018-06-13 16:18:00",
        "fiscalMemory": {
          "error": {
            "code": "1003",
            "message": "Критическая ошибка"
          },
          "notSendDocCount": 25,
          "notSendFirstDocMoment": "2016-09-06 21:41:00"
        },
        "paymentTerminal": {
          "acquiringType": "payme"
        }
      },
      "qrPayEnabled": true,
      "qrAcquire": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/1c5dcf6f-7b32-11e6-8a84-bae500000000",
          "mediaType": "application/json",
          "type": "counterparty",
          "id": "1c5dcf6f-7b32-11e6-8a84-bae500000000",
          "idType": "native"
        }
      },
      "enableNotMRCTobaccoSale": false,
      "tobaccoMrcControlType": "SAME_PRICE",
      "markingSellingMode": "CORRECT_MARKS_ONLY",
      "sendMarksForCheck": false
    }
  ]
}

Получить точки продаж

GET/admin/retailstore

Запрос на получение точек продаж, на которых пользователь является кассиром.

  • meta — Метаданные точки продаж Необходимое

  • id — ID в формате UUID Необходимое

  • version — Версия сущности Необходимое

  • updated — Момент последнего обновления сущности Необходимое

  • name — Наименование точки продаж Необходимое

  • description — Описание точки продаж

  • externalCode — Внешний код точки продаж Необходимое

  • address — Адрес

  • controlShippingStock — Контроль остатков Необходимое

  • onlyInStock — Выгружать только товары в наличии. Доступно только при активном контроле остатков.

  • controlCashierChoice — Выбор продавца Необходимое

  • discountEnable — Разрешить ручные скидки Необходимое

  • discountMaxPercent — Максимально разрешенная скидка Необходимое

  • priceType — Тип цен, с которыми будут продаваться товары в рознице Необходимое

  • authTokenAttached — Флаг, указывающий, что для точки продаж уже был установлен токен обмена
    (повторная установка токена может привести к тому, что данные с предыдущего устройства перестанут выгружаться) Необходимое

  • cashiers — Кассиры которые могут работать на точке продаж Необходимое. Выводится максимум 100 кассиров.

    • meta — метаданные
    • uid — идентификатор учетной записи кассира
    • firstName — Имя
    • middleName — Отчество
    • lastName — Фамилия
    • pinCode — ПИН-код
    • image — Фотография кассира
      • href — Ссылка на изображение
      • miniature — Ссылка на миниатюру изображения
      • tiny — Ссылка на уменьшенную версию изображения
    • inn — ИНН
    • position — Должность
    • email — Адрес электронной почты

  • organization — организация которой принадлежит точка продаж Необходимое

    • meta — метаданные Необходимое
    • name — Краткое наименование Необходимое
    • companyType — Тип организации Необходимое
    • legalTitle— Полное наименование
    • legalAddress— Юридический адрес
    • actualAddress — Фактический адрес
    • inn — ИНН
    • kpp — КПП
    • ogrn — ОГРН
    • okpo — ОКПО
    • ogrnip — ОГРНИП
    • certificateNumber — Номер свидетельства
    • certificateDate — Дата свидетельства
    • email — Адрес электронной почты
    • phone — Номер телефона
    • fax — факс
    • isEgaisEnable — ЕГАИС включен
    • payerVat— Плательщик НДС
    • fsrarId — Идентификатор в ФСРАР
    • utmUrl — Адрес и порт УТМ

  • store — склад с которого торгует точка продаж

    • meta — Метаданные
    • name — Наименование склада
    • parent — родительский склад
    • pathName — Группа, к которой относится склад Необходимое
    • address — Адрес Необходимое

  • acquire — Банк эквайер операций по карте

    • meta — Метаданные

  • lastOperationNames — коллекция номеров последних созданных документов на данной точке продаж. Необходимое
    Каждый элемент коллекции — тип и имя

    • entity — тип документа Необходимое
    • name — Номер документа Необходимое
    • moment — Дата документа Необходимое

  • egaisEnabled — Точка продаж должна передавать данные в ЕГАИС Необходимое

  • frNumber — Номер модели ФР Необходимое

  • returnFromClosedShiftEnabled — Разрешить возвраты в закрытых сменах Необходимое

  • alwaysPrintCheck — Обязательная печать чеков Необходимое

  • issueOrders — Выдача заказов Необходимое

  • sellReserves — Учет резервов Необходимое

  • ofdEnabled — Отправлять электронный чек через ОФД Необходимое

  • allowCustomPrice — Разрешить продажу по свободной цене Необходимое

  • cash — Остаток денег в кассе Необходимое

  • createPaymentInOnRetailShiftClosing — Создавать входящий платеж при закрытии смен. Если флаг включен, в закрываемой смене
    указан банк-эквайер и безналичная выручка за смену (с учетом комиссии) больше 0, то при закрытии смены будет создан входящий платеж Необходимое

  • createCashInOnRetailShiftClosing — Создавать ПКО при закрытии смены. Если флаг включен, в операции закрытия смены
    есть ссылка на выплату и сумма выплаты больше 0, то при закрытии смены будет создан связанный ПКО Необходимое

  • allowCreateProducts — Разрешить создавать товары

  • allowCreateReturnWithoutDemand — Разрешить создание возвратов без основания

  • isPhonePriority — Приоритет отправки электронного чека на телефон. Если флаг выключен, приоритет отправки изменяется на email. Поле недоступно, если приоритет имеет значение Не отправлять или выключен флаг для отправки электронного чека через ОФД .

  • isOnlineDiscount — Возможность использовать скидку и рассчитывать чек на стороне сервера

  • receiptTemplate — Шаблон чека

    • meta — Метаданные шаблона чека
    • header — Верхний блок шаблона чека
    • footer — Нижний блок шаблона чека

  • reservePrepaidGoods — Резервировать товары за которые внесена предоплата

  • environment — информация об окружении

    • device — информация об устройстве
    • os — информация об операционной системе
    • software — информация о ПО
      • name — наименование ПО. Необходимое
      • vendor — Производитель.
      • version — версия ПО.
    • chequePrinter — данные о ККТ
      • vendor — Производитель
      • name — Наименование. Необходимое
      • serial — серийный номер
      • fiscalDataVersion — формат фискальных данных
      • driver — информация об используемом драйвере
        • name — наименования драйвера
        • version — Версия драйвера
      • fiscalMemory — информация о фискальном накопителе
        • fiscalDataVersion — версия фискальной памяти
      • firmwareVersion — Версия прошивки ККТ
    • paymentTerminal — информация о платежном терминале
      • acquiringType — информация о типе эквайера (например: inpas/payme)

  • state — информация о статусе точки продаж

    • sync — состояние синхронизации
      • message — состояние синхронизации.
      • lastAttempMoment — Дата последней сихронизации (не обязательно успешной). Необходимое
    • lastCheckMoment — дата и время последней синхронизации
    • fiscalMemory — информация о фискальной памяти
      • error — информация об ошибке ФН
        • сode — код ошибки ФН
        • message — описание ошибки
      • notSendDocCount — Количество неотправленных документов в ОФД
      • notSendFirstDocMoment — Дата первого документа в очереди на отправку
    • paymentTerminal — информация о платежном терминале Deprecated
      • acquiringType — информация о типе эквайера (например: inpas/payme)

  • enableNotMRCTobaccoSale — Разрешить продавать табачную продукцию не по МРЦ. Deprecated

  • tobaccoMrcControlType — Контроль МРЦ для табачной продукции

  • markingSellingMode — Продажа маркированных товаров

  • qrPayEnabled — возможность оплаты по QR-коду на точке продаж

  • qrAcquire — банк эквайер операций по QR-коду

    • meta — Метаданные

  • isExternalCustomers — Возможность искать покупателей во внешней системе лояльности

  • sendMarksForCheck — настройки для указания необходимости передавать коды маркировки для проверки с ККТ в мастер-кассу

Привязка точки, получение токена ¶

Для данного ресурса предусмотрена обычная BASIC авторизация по паре логин-пароль с небольшим отличием от стандартного поведения — сервер вместе с кодом 401 не возвращает заголовок WWW-Authenticate после неудачной аутентификации.

Получение Token ¶

Данный ресурс предназначен для получения token для аутентификации на конкретной точке продаж.
Id точки продаж передаётся в параметрах запроса. Данный запрос могут выполнить только кассиры на данной точке продаж
и администраторы. Получить информацию о точках продаж можно воспользовавшись этим ресурсом.

  • Если пользователь не является кассиром или администратором — в результате запроса произойдёт ошибка с кодом 403.

  • Если точка продаж с указанным id не найдена — возникнет ошибка с кодом 404.

После успешного запроса происходит создание токена обмена для данной точки продаж, который будет заменять связку логин-пароль при обращении к ресурсам розницы.
Все предыдущие токены для точки при этом аннулируются.

POST https://online.moysklad.ru/api/posap/1.0/admin/attach/7944ef04-f831-11e5-7a69-971500188b19

Responses201

Успешный запрос. Результат — токен для последующей аутентификации на данной точке продаж.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "token": "6ab89be1ae6ff147755625ee8da948e42612233b",
  "uid": "kassir@321"
}

Назначить токен для точки продаж

POST/admin/attach/{id}

URI Параметры

СкрытьПоказать

id
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19

id точки продаж, которой назначается token

Настройки точки продаж ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Настройки точки продаж ¶

GET https://online.moysklad.ru/api/posap/1.0/settings/retailstore/

Responses200

Успешный запрос. Результат — JSON представление точки продаж.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailstore/5d4d2ca2-7b1d-11e6-8a84-bae500000060",
    "mediaType": "application/json",
    "type": "retailstore",
    "id": "5d4d2ca2-7b1d-11e6-8a84-bae500000060",
    "idType": "native"
  },
  "id": "5d4d2ca2-7b1d-11e6-8a84-bae500000060",
  "version": 2,
  "updated": "2016-09-21 19:27:45",
  "name": "Точка продаж",
  "externalCode": "W0M-XxXYjPZJjA1cT3RTL2",
  "controlShippingStock": true,
  "onlyInStock": false,
  "controlCashierChoice": false,
  "discountEnable": true,
  "discountMaxPercent": 100,
  "priceType": "Цена продажи",
  "authTokenAttached": true,
  "cashiers": {
    "rows": [
      {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/employee/a4f36276-7b5a-11e6-8a84-bae500000004",
          "mediaType": "application/json",
          "type": "employee",
          "id": "a4f36276-7b5a-11e6-8a84-bae500000004",
          "idType": "native"
        },
        "uid": "cashier@myorg",
        "firstName": "Иван",
        "middleName": "Иванович",
        "lastName": "Иванов",
        "image": {
          "href": "http://online.moysklad.ru/api/posap/1.0/download/35629a98-d029-11e7-0532-9eed00000001",
          "miniature": "http://online.moysklad.ru/api/posap/1.0/download/35629a98-d029-11e7-0532-9eed00000001?miniature=true",
          "tiny": "http://online.moysklad.ru/app/download/3626405c-d029-11e7-0532-9eed00000002/t.png"
        },
        "inn": "222490425273",
        "position": "position",
        "email": "ivanov@myorg.ru"
      }
    ]
  },
  "organization": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/organization/5d0f5e3e-7b1d-11e6-8a84-bae500000051",
      "mediaType": "application/json",
      "type": "organization",
      "id": "5d0f5e3e-7b1d-11e6-8a84-bae500000051",
      "idType": "native"
    },
    "id": "5d0f5e3e-7b1d-11e6-8a84-bae500000051",
    "version": 5,
    "updated": "2016-09-21 14:30:43",
    "name": "myorg",
    "description": "Страховое публичное акционерное общество «РЕСО-Гарантия»",
    "code": "1234",
    "externalCode": "PW55m0xUiG1pAlGJv73Sd2",
    "companyType": "legal",
    "legalTitle": "СТРАХОВОЕ ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "РЕСО-ГАРАНТИЯ"",
    "legalAddress": "г Москва, ул Гашека, д 12 к 1",
    "actualAddress": "г Москва, ул Вавилова д 19",
    "inn": "7710045520",
    "kpp": "775001001",
    "ogrn": "1027700042413",
    "okpo": "121351253251",
    "email": "myorg@orgmy.su",
    "phone": "346243637247",
    "fax": "32472377432524",
    "isEgaisEnable": true,
    "fsrarId": "the id for fr",
    "payerVat": true,
    "utmUrl": "url.coms"
  },
  "store": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/store/5d1fa036-7b1d-11e6-8a84-bae500000053",
      "mediaType": "application/json",
      "type": "counterparty",
      "id": "5d1fa036-7b1d-11e6-8a84-bae500000053",
      "idType": "native"
    },
    "name": "Основной склад",
    "pathName": "",
    "address": "г Москва ул Милашенкова д 2"
  },
  "acquire": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/1c5dcf6f-7b32-11e6-8a84-bae500000000",
      "mediaType": "application/json",
      "type": "counterparty",
      "id": "1c5dcf6f-7b32-11e6-8a84-bae500000000",
      "idType": "native"
    }
  },
  "lastOperationNames": [
    {
      "entity": "retaildemand",
      "name": "03211312",
      "moment": "2016-10-07 15:50:14"
    },
    {
      "entity": "retaildrawercashin",
      "name": "00001",
      "moment": "2016-10-07 15:50:14"
    },
    {
      "entity": "retaildrawercashout",
      "name": "00001",
      "moment": "2016-10-07 15:50:14"
    },
    {
      "entity": "retailsalesreturn",
      "name": "0002199921",
      "moment": "2016-10-07 15:50:14"
    },
    {
      "entity": "retailshift",
      "name": "042777001",
      "moment": "2016-10-07 15:50:14"
    }
  ],
  "egaisEnabled": false,
  "frNumber": "",
  "returnFromClosedShiftEnabled": false,
  "alwaysPrintCheck": false,
  "issueOrders": false,
  "sellReserves": false,
  "ofdEnabled": false,
  "allowCustomPrice": false,
  "cash": 10050,
  "createPaymentInOnRetailShiftClosing": true,
  "createCashInOnRetailShiftClosing": false,
  "allowCreateProducts": true,
  "enableReturnsWithNoReason": true,
  "isOnlineDiscount": false,
  "isExternalCustomers": false,
  "isPhonePriority": true,
  "reservePrepaidGoods": false,
  "receiptTemplate": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/receipttemplate/4636cc33-d372-11e8-ac16-000900000001",
      "mediaType": "application/json",
      "type": "receipttemplate",
      "id": "4636cc33-d372-11e8-ac16-000900000001",
      "idType": "native"
    },
    "header": "АКЦИЯ: 6 ЗА 5. ПОДРОБНЕЕ ЧИТАЙТЕ В НИЖНЕЙ ЧАСТИ ЧЕКА",
    "footer": "КУПИТЕ 5 КОФЕ И ПОЛУЧИТЕ 6-й В ПОДАРОК, ПРЕДЪЯВИВ ЭТОТ ЧЕК"
  },
  "environment": {
    "device": "RetailStorePc",
    "os": "Linux",
    "software": {
      "name": "Касса МойСклад",
      "vendor": "МойСклад",
      "version": "2.2"
    },
    "chequePrinter": {
      "vendor": "АТОЛ",
      "name": "30Ф",
      "serial": "15636313",
      "fiscalDataVersion": "1.0",
      "driver": {
        "name": "АТОЛ (бета)",
        "version": "9.1"
      },
      "fiscalMemory": {
        "fiscalDataVersion": "1.1"
      },
      "firmwareVersion": "669"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "state": {
    "sync": {
      "message": "Ошибка синхронизации, необходимо войти повторно",
      "lastAttempMoment": "2016-09-06 21:41:00"
    },
    "lastCheckMoment": "2018-06-13 16:18:00",
    "fiscalMemory": {
      "error": {
        "code": "1003",
        "message": "Критическая ошибка"
      },
      "notSendDocCount": 25,
      "notSendFirstDocMoment": "2016-09-06 21:41:00"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "qrPayEnabled": true,
  "qrAcquire": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/1c5dcf6f-7b32-11e6-8a84-bae500000000",
      "mediaType": "application/json",
      "type": "counterparty",
      "id": "1c5dcf6f-7b32-11e6-8a84-bae500000000",
      "idType": "native"
    }
  },
  "enableNotMRCTobaccoSale": false,
  "tobaccoMrcControlType": "SAME_PRICE",
  "markingSellingMode": "CORRECT_MARKS_ONLY",
  "sendMarksForCheck": false
}

Получить настройки точки продаж

GET/settings/retailstore/

Запрос на получение отдельной точки продаж (настроек точки продаж).

  • meta — Метаданные о смене Необходимое

  • id — ID в формате UUID Необходимое

  • version — Версия сущности Необходимое

  • updated — Момент последнего обновления сущности Необходимое

  • name — Наименование точки продаж Необходимое

  • description — Описание точки продаж Необходимое

  • externalCode — Внешний код точки продаж Необходимое

  • address — Адрес

  • controlShippingStock — Контроль остатков Необходимое

  • onlyInStock — Выгружать только товары в наличии. Доступно только при активном контроле остатков.

  • controlCashierChoice — Выбор продавца Необходимое

  • discountEnable — Разрешить ручные скидки Необходимое

  • discountMaxPercent — Максимально разрешенная скидка Необходимое

  • priceType — Тип цен, с которыми будут продаваться товары в рознице Необходимое

  • authTokenAttached — Флаг, указывающий, что для точки продаж уже был установлен токен обмена
    (повторная установка токена может привести к тому, что данные с предыдущего устройства перестанут выгружаться) Необходимое

  • cashiers — Кассиры которые могут работать на точке продаж Необходимое

    • meta — метаданные
    • uid — идентификатор учетной записи кассира
    • firstName — Имя
    • middleName — Отчество
    • lastName — Фамилия
    • pinCode — ПИН-код
    • image — Фотография кассира
      • href — Ссылка на изображение
      • miniature — Ссылка на миниатюру изображения
      • tiny — Ссылка на уменьшенную версию изображения
    • inn — ИНН
    • position — Должность
    • email — Адрес электронной почты

  • organization — организация которой принадлежит точка продаж Необходимое

    • meta — метаданные Необходимое
    • name — Краткое наименование Необходимое
    • companyType — Тип организации Необходимое
    • legalTitle— Полное наименование
    • legalAddress— Юридический адрес
    • actualAddress — Фактический адрес
    • inn — ИНН
    • kpp — КПП
    • ogrn — ОГРН
    • okpo — ОКПО
    • ogrnip — ОГРНИП
    • certificateNumber — Номер свидетельства
    • certificateDate — Дата свидетельства
    • email — Адрес электронной почты
    • phone — Номер телефона
    • fax — факс
    • isEgaisEnable — ЕГАИС включен
    • payerVat— Плательщик НДС
    • fsrarId — Идентификатор в ФСРАР
    • utmUrl — Адрес и порт УТМ

  • store — склад с которого торгует точка продаж

    • meta — Метаданные
    • name — Наименование склада
    • parent — родительский склад
    • pathName — Группа, к которой относится склад Необходимое
    • address — Адрес Необходимое

  • acquire — Банк эквайер операций по карте

    • meta — Метаданные

  • lastOperationNames — коллекция номеров последних созданных документов на данной точке продаж. Необходимое
    Каждый элемент коллекции — тип и имя

    • entity — тип документа Необходимое
    • name — Номер документа Необходимое
    • moment — Дата документа Необходимое

  • egaisEnabled — Точка продаж должна передавать данные в ЕГАИС Необходимое

  • frNumber — Номер модели ФР Необходимое

  • returnFromClosedShiftEnabled — Разрешить возвраты в закрытых сменах Необходимое

  • alwaysPrintCheck — Обязательная печать чеков Необходимое

  • issueOrders — Выдача заказов Необходимое

  • sellReserves — Учет резервов Необходимое

  • ofdEnabled — Отправлять электронный чек через ОФД Необходимое

  • allowCustomPrice — Разрешить продажу по свободной цене Необходимое

  • cash — Остаток денег в кассе Необходимое

  • createPaymentInOnRetailShiftClosing — Создавать входящий платеж при закрытии смен. Если флаг включен, в закрываемой смене
    указан банк-эквайер и безналичная выручка за смену (с учетом комиссии) больше 0, то при закрытии смены будет создан входящий платеж Необходимое

  • createCashInOnRetailShiftClosing — Создавать ПКО при закрытии смены. Если флаг включен, в операции закрытия смены
    есть ссылка на выплату и сумма выплаты больше 0, то при закрытии смены будет создан связанный ПКО Необходимое

  • allowCreateProducts — Разрешить создавать товары

  • allowCreateReturnWithoutDemand — Разрешить создание возвратов без основания

  • isPhonePriority — Приоритет отправки электронного чека на телефон. Если флаг выключен, приоритет отправки изменяется на email. Поле недоступно, если приоритет имеет значение Не отправлять или выключен флаг для отправки электронного чека через ОФД .

  • isOnlineDiscount — Возможность использовать скидку и рассчитывать чек на стороне сервера

  • receiptTemplate — Шаблон чека

    • meta — Метаданные шаблона чека
    • header — Верхний блок шаблона чека
    • footer — Нижний блок шаблона чека

  • environment — информация об окружении

    • device — информация об устройстве
    • os — информация об операционной системе
    • software — информация о ПО
      • name — наименование ПО. Необходимое
      • vendor — Производитель.
      • version — версия ПО.
    • chequePrinter — данные о ККТ
      • vendor — Производитель
      • name — Наименование. Необходимое
      • serial — серийный номер
      • fiscalDataVersion — формат фискальных данных
      • driver — информация об используемом драйвере
        • name — наименования драйвера
        • version — Версия драйвера
      • fiscalMemory — информация о фискальном накопителе
        • fiscalDataVersion — версия фискальной памяти
      • firmwareVersion — Версия прошивки ККТ
    • paymentTerminal — информация о платежном терминале
      • acquiringType — информация о типе эквайера (например: inpas/payme)

  • state — информация о статусе точки продаж

    • sync — состояние синхронизации
      • message — состояние синхронизации.
      • lastAttempMoment — Дата последней сихронизации (не обязательно успешной). Необходимое
    • lastCheckMoment — дата и время последней синхронизации
    • fiscalMemory — информация о фискальной памяти
      • error — информация об ошибке ФН
        • сode — код ошибки ФН
        • message — описание ошибки
      • notSendDocCount — Количество неотправленных документов в ОФД
      • notSendFirstDocMoment — Дата первого документа в очереди на отправку
    • paymentTerminal — информация о платежном терминале Deprecated
      • acquiringType — информация о типе эквайера (например: inpas/payme)

  • defaultTaxSystem — Код системы налогообложения по умолчанию.

  • orderTaxSystem — Код системы налогообложения для заказов.

  • qrPayEnabled — возможность оплаты по QR-коду на точке продаж

  • qrAcquire — банк эквайер операций по QR-коду

    • meta — Метаданные
Система налогообложения Значение поля defaultTaxSystem/orderTaxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

  • enableNotMRCTobaccoSale — Разрешить продавать табачную продукцию не по МРЦ. Deprecated

  • tobaccoMrcControlType — Контроль МРЦ для табачной продукции. Необходимое

Контроль МРЦ для табачной продукции Значение поля tobaccoMrcControlType
Не контролировать МРЦ USER_PRICE
Продавать по МРЦ указанной на пачке MRC_PRICE
Запрещать продажу, если цена продажи не совпадает с МРЦ SAME_PRICE
  • fiscalType — Тип формирования чеков.
Формирование чеков Значение поля fiscalType
Стандартное STANDARD
Обработка облачных операций MASTER
Облачное CLOUD
  • markingSellingMode — Режим продажи маркированной продукции, если используется формат фискальных документов версии 1.2. Необходимое
Продажа маркированных товаров Значение поля markingSellingMode
Только с правильными кодами маркировки CORRECT_MARKS_ONLY
С правильными кодами и те, которые не удалось проверить WITHOUT_ERRORS
Все – независимо от результатов проверки кодов маркировки ALL

  • isExternalCustomers — Возможность искать покупателей во внешней системе лояльности

  • sendMarksForCheck — настройки для указания необходимости передавать коды маркировки для проверки с ККТ в мастер-кассу

Настройки компании ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Настройки компании ¶

GET https://online.moysklad.ru/api/posap/1.0/settings/companysettings

Responses200

Успешный запрос. Результат — JSON представление Настроек компании.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "currency": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/currency/5d204097-7b1d-11e6-8a84-bae500000058",
      "mediaType": "application/json",
      "type": "currency",
      "id": "5d204097-7b1d-11e6-8a84-bae500000058",
      "idType": "native"
    },
    "name": "руб",
    "rate": 1,
    "code": "643"
  },
  "discountStrategy": "bySum",
  "isWeightBarcodes": false,
  "weightBarcodePrefix": "00",
  "operationNumbering": "GLOBAL"
}

Получить Настройки компании

GET/settings/companysettings

Запрос на получение Настроек компании.

  • currency — стандартная валюта Необходимое

    • meta — метаданные валюты Необходимое
    • name — наименование валюты Необходимое
    • rate — курс валюты Необходимое
    • code — код валюты Необходимое

  • discountStrategy — Cовместное применение скидок. Может принимать значения [bySum, byPriority] означающие “Сумма скидок” и “Приоритетная” соответственно. Необходимое

    • “Сумма скидок” [bySum] означает, что должна действовать сумма скидок
    • “Приоритетная” [byPriority] должна действовать одна, наиболее выгодная для покупателя скидка

  • isWeightBarcodes — Флаг, используются весовые штрихкоды Необходимое

  • weightBarcodePrefix — Строка, маска весовых штрихкодов Необходимое

  • operationNumbering — Нумерация документов. Может принимать значения [GLOBAL, YEARLY] означающие “Сквозная за всю историю” и “Внутри календарного года” соответственно. Необходимое

Скидки ¶

Перед работой со скидками настоятельно рекомендуем вам прочитать вот эту статью на портале поддержки МоегоСклада.

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Скидки ¶

GET https://online.moysklad.ru/api/posap/1.0/entity/discount

Responses200

Успешный запрос. Результат — список всех скидок всех типов на учетной записи.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/discount",
    "mediaType": "application/json",
    "size": 6,
    "limit": 1000,
    "offsetId": "00000000-0000-0000-0000-000000000000",
    "direction": "forward"
  },
  "rows": [
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/specialpricediscount/33edffd5-7ff9-11e6-8a84-bae500000057",
        "mediaType": "application/json",
        "type": "specialpricediscount",
        "id": "33edffd5-7ff9-11e6-8a84-bae500000057",
        "idType": "native"
      },
      "id": "33edffd5-7ff9-11e6-8a84-bae500000057",
      "name": "Скидка1",
      "allProducts": false,
      "productFolders": [
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
            "mediaType": "application/json",
            "type": "productfolder",
            "id": "dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
            "idType": "native"
          },
          "id": "dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
          "name": "Папка 1",
          "namepath": "",
          "path": "/"
        }
      ],
      "specialPrice": {
        "priceType": "Цена продажи"
      }
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/specialpricediscount/38a43ee7-7ffd-11e6-8a84-bae50000005f",
        "mediaType": "application/json",
        "type": "specialpricediscount",
        "id": "38a43ee7-7ffd-11e6-8a84-bae50000005f",
        "idType": "native"
      },
      "id": "38a43ee7-7ffd-11e6-8a84-bae50000005f",
      "name": "Скидка2",
      "allProducts": false,
      "productFolders": [
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/276a6f50-7ffd-11e6-8a84-bae50000005c",
            "mediaType": "application/json",
            "type": "productfolder",
            "id": "276a6f50-7ffd-11e6-8a84-bae50000005c",
            "idType": "native"
          },
          "productFolder": {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
              "mediaType": "application/json",
              "type": "productfolder",
              "id": "dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
              "idType": "native"
            }
          },
          "id": "276a6f50-7ffd-11e6-8a84-bae50000005c",
          "name": "Папка 2",
          "namepath": "Папка 1",
          "path": "/dbe2cf7f-7b5c-11e6-8a84-bae50000000e/"
        }
      ],
      "specialPrice": {
        "priceType": "Цена продажи"
      }
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/941e8ce7-7b1d-11e6-8a84-bae500000111",
        "mediaType": "application/json",
        "type": "accumulationdiscount",
        "id": "941e8ce7-7b1d-11e6-8a84-bae500000111",
        "idType": "native"
      },
      "id": "941e8ce7-7b1d-11e6-8a84-bae500000111",
      "name": "Скидка 3",
      "allProducts": false,
      "levels": [
        {
          "amount": 10000,
          "discount": 1
        },
        {
          "amount": 20000,
          "discount": 2
        },
        {
          "amount": 30000,
          "discount": 3
        }
      ]
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/98af408c-7fdc-11e6-8a84-bae50000003c",
        "mediaType": "application/json",
        "type": "accumulationdiscount",
        "id": "98af408c-7fdc-11e6-8a84-bae50000003c",
        "idType": "native"
      },
      "id": "98af408c-7fdc-11e6-8a84-bae50000003c",
      "name": "накопительная Скидка",
      "allProducts": false,
      "levels": [
        {
          "amount": 200000,
          "discount": 1
        },
        {
          "amount": 1200000,
          "discount": 2
        }
      ]
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/fbd3a1b7-7fdd-11e6-8a84-bae500000047",
        "mediaType": "application/json",
        "type": "accumulationdiscount",
        "id": "fbd3a1b7-7fdd-11e6-8a84-bae500000047",
        "idType": "native"
      },
      "id": "fbd3a1b7-7fdd-11e6-8a84-bae500000047",
      "name": "Скидка 4",
      "allProducts": false,
      "levels": [
        {
          "amount": 20000,
          "discount": 0
        }
      ]
    }
  ]
}

Получить все скидки

GET/entity/discount

Запрос на получение всех скидок учётной записи.

  • meta — Метаданные Необходимое

  • id — ID в формате UUID Необходимое

  • name — Наименование скидки Необходимое

  • agentTags — Тэги контрагентов, к которым применяется скидка, если применяется не ко всем контрагентам

  • allProducts — Все товары и услуги. Если этот флаг выставлен true, то коллекции assortment и productFolders будут отсутствовать в составе объекта. Необходимое

  • assortment — Товары и услуги, которые были выбраны для применения скидки, если та применяется не ко всем товарам

    • meta — метаданные товара или услуги

  • productFolders — Товары и папки, к которым применяется скидка, если применяется не ко всем товарам

    • meta — метаданные папки
    • productFolder — ссылка на родительскую папку
    • id — id папки
    • name — наименование папки
    • namepath — путь к данной папке, состоящий из имён родительских папок
    • path — путь к данной папке, состоящий из id родительских папок

  • discount — Процент скидки если выбран фиксированный процент

  • specialPrice — Спец. цена (если выбран тип цен)

    • priceType — Наименование типа цены

  • productFolders — Товары и папки, к которым применяется скидка, если применяется не ко всем товарам

    • meta — метаданные папки
    • productFolder — ссылка на родительскую папку
    • id — id папки
    • name — наименование папки
    • namepath — путь к данной папке, состоящий из имён родительских папок
    • path — путь к данной папке, состоящий из id родительских папок

  • levels — проценты скидок при определённой сумме продаж Необходимое

    • amount — Сумма накоплений в рублях
    • discount — Процент скидки, соответствующий данной сумме

Товары и услуги ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Товары и услуги ¶

GET https://online.moysklad.ru/api/posap/1.0/entity/assortment

Responses200

Успешный запрос. Результат — JSON представление ассортимента товаров.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/assortment",
    "mediaType": "application/json",
    "size": 5,
    "limit": 4,
    "offsetId": "00000000-0000-0000-0000-000000000000",
    "direction": "forward",
    "nextHref": "http://online.moysklad.ru/api/posap/1.0/entity/assortment?limit=4&offsetId=ac6bab2d-07c8-11e7-8a84-bc5200000016&direction=forward"
  },
  "rows": [
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/7db30ee8-07c5-11e7-90a5-ba9c0000008b",
        "mediaType": "application/json",
        "type": "product",
        "id": "7db30ee8-07c5-11e7-90a5-ba9c0000008b",
        "idType": "native"
      },
      "id": "7db30ee8-07c5-11e7-90a5-ba9c0000008b",
      "name": "товар алкогольный",
      "code": "00004",
      "barcodes": [
        "2000000000015"
      ],
      "salePrices": [
        {
          "value": 6000,
          "priceType": "Цена продажи"
        },
        {
          "value": 0,
          "priceType": "нулевая цена"
        }
      ],
      "productFolder": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/200a6488-07c7-11e7-90a5-ba9c0000009a",
          "mediaType": "application/json",
          "type": "productfolder",
          "id": "200a6488-07c7-11e7-90a5-ba9c0000009a",
          "idType": "native"
        },
        "id": "200a6488-07c7-11e7-90a5-ba9c0000009a",
        "name": "папка",
        "namepath": "папка",
        "path": "/200a6488-07c7-11e7-90a5-ba9c0000009a/"
      },
      "article": "артикул",
      "uom": "шт",
      "vat": 10,
      "useParentVat": false,
      "vatEnabled": true,
      "vatDecimal": 10,
      "image": {
        "href": "https://online.moysklad.ru/api/posap/1.0/download/64aab630-07c7-11e7-90a5-ba9c0000002c",
        "miniature": "https://online.moysklad.ru/api/posap/1.0/download/64aab630-07c7-11e7-90a5-ba9c0000002c?miniature=true",
        "tiny": "https://online.moysklad.ru/static/75651645-07c5-11e7-90a5-ba9c00000006/TinyImage/64aaa5a2-07c7-11e7-90a5-ba9c0000002b.png"
      },
      "egaisIsAlcoholic": true,
      "egaisHasExciseMark": false,
      "egaisProductCode": 444,
      "egaisVolume": 0.5,
      "egaisAlcoholPercent": 4,
      "soldByWeight": false,
      "onTap": false,
      "stock": 0,
      "reserve": 0,
      "isSerialtrackable": false,
      "tobacco": false,
      "paymentItemType": "EXCISABLE_GOOD",
      "isDiscountProhibited": false,
      "packs": [
        {
          "id": "5ae9e6b5-7b95-11e9-ac12-000b000000ac",
          "name": "ящ",
          "quantity": 10,
          "barcode": "2000000000016"
        }
      ]
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/service/bb89b2b1-07c7-11e7-90a5-ba9c000000a4",
        "mediaType": "application/json",
        "type": "service",
        "id": "bb89b2b1-07c7-11e7-90a5-ba9c000000a4",
        "idType": "native"
      },
      "id": "bb89b2b1-07c7-11e7-90a5-ba9c000000a4",
      "name": "Услуга",
      "code": "00006",
      "barcodes": [
        "2000000000060"
      ],
      "salePrices": [
        {
          "value": 1500,
          "priceType": "Цена продажи"
        },
        {
          "value": 0,
          "priceType": "нулевая цена"
        }
      ],
      "productFolder": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/200a6488-07c7-11e7-90a5-ba9c0000009a",
          "mediaType": "application/json",
          "type": "productfolder",
          "id": "200a6488-07c7-11e7-90a5-ba9c0000009a",
          "idType": "native"
        },
        "id": "200a6488-07c7-11e7-90a5-ba9c0000009a",
        "name": "папка",
        "namepath": "папка",
        "path": "/200a6488-07c7-11e7-90a5-ba9c0000009a/"
      },
      "uom": "шт",
      "vat": 10,
      "useParentVat": false,
      "vatEnabled": true,
      "vatDecimal": 10,
      "taxSystem": "GENERAL_TAX_SYSTEM",
      "paymentItemType": "SERVICE",
      "isDiscountProhibited": true
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/cd39d288-07c6-11e7-90a5-ba9c00000019",
        "mediaType": "application/json",
        "type": "product",
        "id": "cd39d288-07c6-11e7-90a5-ba9c00000019",
        "idType": "native"
      },
      "id": "cd39d288-07c6-11e7-90a5-ba9c00000019",
      "name": "Товар",
      "code": "00005",
      "barcodes": [
        "2000000000022",
        "2000000000053"
      ],
      "salePrices": [
        {
          "value": 1300,
          "priceType": "Цена продажи"
        },
        {
          "value": 0,
          "priceType": "нулевая цена"
        }
      ],
      "productFolder": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/200a6488-07c7-11e7-90a5-ba9c0000009a",
          "mediaType": "application/json",
          "type": "productfolder",
          "id": "200a6488-07c7-11e7-90a5-ba9c0000009a",
          "idType": "native"
        },
        "id": "200a6488-07c7-11e7-90a5-ba9c0000009a",
        "name": "папка",
        "namepath": "папка",
        "path": "/200a6488-07c7-11e7-90a5-ba9c0000009a/"
      },
      "article": "артикул",
      "uom": "шт",
      "vat": 10,
      "useParentVat": false,
      "vatEnabled": true,
      "vatDecimal": 10,
      "taxSystem": "SIMPLIFIED_TAX_SYSTEM_INCOME",
      "image": {
        "href": "https://online.moysklad.ru/api/posap/1.0/download/59af318d-07c7-11e7-90a5-ba9c00000028",
        "miniature": "https://online.moysklad.ru/api/posap/1.0/download/59af318d-07c7-11e7-90a5-ba9c00000028?miniature=true",
        "tiny": "https://online.moysklad.ru/static/75651645-07c5-11e7-90a5-ba9c00000006/TinyImage/59af0104-07c7-11e7-90a5-ba9c00000027.png"
      },
      "egaisIsAlcoholic": false,
      "egaisHasExciseMark": false,
      "egaisVolume": 0,
      "egaisAlcoholPercent": 0,
      "soldByWeight": true,
      "onTap": false,
      "stock": 0,
      "reserve": 0,
      "isSerialtrackable": false,
      "tobacco": false,
      "paymentItemType": "GOOD",
      "isDiscountProhibited": true
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/variant/cd3ed8ed-07c6-11e7-90a5-ba9c00000020",
        "mediaType": "application/json",
        "type": "variant",
        "id": "cd3ed8ed-07c6-11e7-90a5-ba9c00000020",
        "idType": "native"
      },
      "id": "cd3ed8ed-07c6-11e7-90a5-ba9c00000020",
      "name": "Товар (версия1)",
      "code": "00002",
      "barcodes": [
        "2000000000039"
      ],
      "productFolder": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/200a6488-07c7-11e7-90a5-ba9c0000009a",
          "mediaType": "application/json",
          "type": "productfolder",
          "id": "200a6488-07c7-11e7-90a5-ba9c0000009a",
          "idType": "native"
        },
        "id": "200a6488-07c7-11e7-90a5-ba9c0000009a",
        "name": "папка",
        "namepath": "папка",
        "path": "/200a6488-07c7-11e7-90a5-ba9c0000009a/"
      },
      "characteristics": {
        "модификация": "версия1"
      },
      "stock": 0,
      "reserve": 0,
      "salePrices": [
        {
          "value": 1300,
          "priceType": "Цена продажи"
        },
        {
          "value": 0,
          "priceType": "нулевая цена"
        }
      ],
      "product": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/cd39d288-07c6-11e7-90a5-ba9c00000019",
          "mediaType": "application/json",
          "type": "product",
          "id": "cd39d288-07c6-11e7-90a5-ba9c00000019",
          "idType": "native"
        },
        "id": "cd39d288-07c6-11e7-90a5-ba9c00000019",
        "name": "Товар",
        "code": "00005",
        "salePrices": [
          {
            "value": 1300,
            "priceType": "Цена продажи"
          },
          {
            "value": 0,
            "priceType": "нулевая цена"
          }
        ],
        "article": "артикул",
        "uom": "шт",
        "vat": 10,
        "useParentVat": false,
        "vatEnabled": true,
        "vatDecimal": 10,
        "image": {
          "href": "https://online.moysklad.ru/api/posap/1.0/download/59af318d-07c7-11e7-90a5-ba9c00000028",
          "miniature": "https://online.moysklad.ru/api/posap/1.0/download/59af318d-07c7-11e7-90a5-ba9c00000028?miniature=true",
          "tiny": "https://online.moysklad.ru/static/75651645-07c5-11e7-90a5-ba9c00000006/TinyImage/59af0104-07c7-11e7-90a5-ba9c00000027.png"
        },
        "egaisIsAlcoholic": false,
        "egaisHasExciseMark": false,
        "egaisVolume": 0,
        "egaisAlcoholPercent": 0,
        "soldByWeight": true,
        "onTap": false,
        "stock": 0,
        "reserve": 0,
        "paymentItemType": "ANOTHER_PAYMENT_ITEM",
        "isDiscountProhibited": true
      },
      "isSerialtrackable": false
    },
    {
      "meta": {
        "href": "http://online.moysklad.ru/api/posap/1.0/entity/bundle/e90685f8-07c8-11e7-8a84-bc520000002d",
        "mediaType": "application/json",
        "type": "bundle",
        "id": "e90685f8-07c8-11e7-8a84-bc520000002d",
        "idType": "native"
      },
      "id": "e90685f8-07c8-11e7-8a84-bc520000002d",
      "name": "Комплект",
      "code": "00006",
      "barcodes": [
        "2000000000107"
      ],
      "salePrices": [
        {
          "value": 1500,
          "priceType": "Цена продажи"
        },
        {
          "value": 1900,
          "priceType": "нулевая цена"
        }
      ],
      "productFolder": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/200a6488-07c7-11e7-90a5-ba9c0000009a",
          "mediaType": "application/json",
          "type": "productfolder",
          "id": "200a6488-07c7-11e7-90a5-ba9c0000009a",
          "idType": "native"
        },
        "id": "200a6488-07c7-11e7-90a5-ba9c0000009a",
        "name": "папка",
        "namepath": "папка",
        "path": "/200a6488-07c7-11e7-90a5-ba9c0000009a/"
      },
      "article": "артикул",
      "uom": "шт",
      "vat": 18,
      "useParentVat": false,
      "vatEnabled": true,
      "vatDecimal": 18,
      "taxSystem": "PRESUMPTIVE_TAX_SYSTEM",
      "paymentItemType": "COMPOUND_PAYMENT_ITEM",
      "isDiscountProhibited": false,
      "image": {
        "href": "http://online.moysklad.ru/api/posap/1.0/download/d3c41c47-07c8-11e7-8a84-bc520000001f",
        "miniature": "http://online.moysklad.ru/api/posap/1.0/download/d3c41c47-07c8-11e7-8a84-bc520000001f?miniature=true",
        "tiny": "http://online.moysklad.ru/app/download/d3c3e54c-07c8-11e7-8a84-bc520000001e.png"
      },
      "components": [
        {
          "meta": {
            "href": "http://online.moysklad.ru/api/posap/1.0/entity/product/cd39d288-07c6-11e7-90a5-ba9c00000019",
            "mediaType": "application/json",
            "type": "product",
            "id": "cd39d288-07c6-11e7-90a5-ba9c00000019",
            "idType": "native"
          },
          "quantity": 5
        },
        {
          "meta": {
            "href": "http://online.moysklad.ru/api/posap/1.0/entity/variant/cd3ed8ed-07c6-11e7-90a5-ba9c00000020",
            "mediaType": "application/json",
            "type": "variant",
            "id": "ac6bab2d-07c8-11e7-8a84-bc5200000016",
            "idType": "native"
          },
          "quantity": 10
        },
        {
          "meta": {
            "href": "http://online.moysklad.ru/api/posap/1.0/entity/service/bb89b2b1-07c7-11e7-90a5-ba9c000000a4",
            "mediaType": "application/json",
            "type": "service",
            "id": "bb89b2b1-07c7-11e7-90a5-ba9c000000a4",
            "idType": "native"
          },
          "quantity": 15
        }
      ]
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/cd39d288-07c6-11e7-90a5-ba9c00000020",
        "mediaType": "application/json",
        "type": "product",
        "id": "cd39d288-07c6-11e7-90a5-ba9c00000020",
        "idType": "native"
      },
      "id": "cd39d288-07c6-11e7-90a5-ba9c00000020",
      "name": "Маска",
      "code": "00077",
      "salePrices": [
        {
          "value": 3500,
          "priceType": "Цена продажи"
        }
      ],
      "article": "артикул",
      "uom": "шт",
      "vat": 20,
      "useParentVat": false,
      "vatEnabled": true,
      "vatDecimal": 20,
      "egaisIsAlcoholic": false,
      "egaisHasExciseMark": false,
      "egaisVolume": 0,
      "egaisAlcoholPercent": 0,
      "soldByWeight": false,
      "onTap": false,
      "stock": 0,
      "reserve": 0,
      "paymentItemType": "GOOD",
      "isDiscountProhibited": false,
      "ppeType": "2400001323807"
    }
  ]
}

Получить Товары и услуги

GET/entity/assortment

Запрос на получение товаров/модификаций и остатков по ним. Результат — список соответствующих сущностей
с информацией по их остаткам на складе. Если в настройках точки продаж установлено свойство Выгружать только товары в наличии,
то запрос вернет только товары и модификации с положительным остатком. Комплекты выгружаются все, вне зависимости от их остатка и значения свойства Выгружать только товары в наличии.

  • meta — Метаданные сущности Необходимое

  • id — id сущности ассортимента Необходимое

  • syncId — syncId товара/услуги/комплекта, уникальный внешний идентификатор

  • name — Наименование сущности Необходимое

  • code — Код сущности

  • barcodes — Массив штрихкодов сущности

  • salePrices — Массив цен продажи (объектов с полем value) сущности Необходимое

  • productFolder — Папка, в которой находится сущность. Для модификаций папка родительского товара.

    • meta — метаданные папки Необходимое
    • productFolder — ссылка на родительскую папку
    • id — id папки Необходимое
    • name — наименование папки Необходимое
    • namepath — путь к товару, модификации, услуги или комплекту (но не к самой папке), состоящий из имён родительских папок Необходимое
    • path — путь к товару, модификации, услуги или комплекту (но не к самой папке), состоящий из id родительских папок Необходимое

  • vat — НДС, рассчитанный с учетом родительских групп, если такие имеются

  • vatEnabled — включен ли НДС для товара. С помощью этого флага для товара можно выставлять НДС = 0 или НДС = “без НДС”. (vat = 0, vatEnabled = false) -> vat = “без НДС”, (vat = 0, vatEnabled = true) -> vat = 0%

  • useParentVat — использовать НДС родительской группы

  • vatDecimal — НДС дробный, рассчитанный с учетом родительских групп, если такие имеются

  • article — Артикул товара

  • soldByWeight — Весовой товар

  • onTap — Разливной товар

  • uom — Единица измерения товара (строка)

  • image — Изображение товара (объект)

    • href — Ссылка на изображение
    • miniature — Ссылка на миниатюру изображения
    • tiny — Ссылка на уменьшенную версию изображения

  • egaisIsAlcoholic — признак «Алкогольная продукция» Необходимое

  • egaisHasExciseMark — признак «Содержит акцизную марку» Необходимое

  • egaisProductCode — код вида алкогольной продукции Необходимое

  • egaisAlcoholPercent — крепость алкогольной продукции Необходимое

  • egaisVolume — объем тары алкогольной продукции Необходимое

  • stock — Остаток Необходимое

  • reserve — Резерв Необходимое

  • isSerialtrackable — учёт по серийным номерам Необходимое

  • tobacco — Табачная продукция. Не может быть указан вместе с egaisIsAlcoholic, soldByWeight, isSerialtrackable и onTap

  • trackingType — Тип маркируемой продукции

    • NOT_TRACKED — Без маркировки
    • TOBACCO — Тип маркировки “Табак”
    • SHOES — Тип маркировки “Обувь”
    • LP_CLOTHES — Тип маркировки “Одежда”
    • LP_LINENS — Тип маркировки “Постельное белье”
    • PERFUMERY — Тип маркировки “Духи и туалетная вода”
    • ELECTRONICS — Тип маркировки “Фотокамеры и лампы-вспышки”
    • TIRES — Тип маркировки “Шины и покрышки”
    • MILK — Тип маркировки “Молочная продукция”
    • WATER — Тип маркировки “Упакованная вода”
    • OTP — Тип маркировки “Альтернативная табачная продукция”
    • NCP — Тип маркировки “Никотиносодержащая продукция”

  • tnved — Код ТН ВЭД

  • taxSystem — Код системы налогообложения.

  • partialDisposal — Флаг частичного выбытия.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

  • paymentItemType — Признак предмета расчета

    • GOOD — Товар
    • EXCISABLE_GOOD — Подакцизный товар
    • COMPOUND_PAYMENT_ITEM — Составной предмет расчета
    • ANOTHER_PAYMENT_ITEM — Иной предмет расчета

  • isDiscountProhibited — Запретить скидки при продаже в розницу

  • packs — Массив упаковок

    • id — id сущности упаковки Необходимое
    • name — Название упаковки Необходимое
    • quantity — Количество товаров в упаковке Необходимое
    • barcode — Штрихкод упаковки

  • ppeType — Код вида номенклатурной классификации медицинских средств индивидуальной защиты (EAN-13)

Наименование вида номенклатурной классификации медицинских изделий Код вида номенклатурной классификации медицинских изделий (EAN-13)
маска лицевая для защиты дыхательных путей, многоразового использования 2400001323807
маска лицевая для защиты дыхательных путей, одноразового использования 2400003675805
респиратор общего применения 2400001807703
респиратор хирургический 2400001818303
респиратор хирургический антибактериальный 2400002186203
средство назальное для защиты от загрязненного воздуха, местного действия 2400001368105
перчатки смотровые (процедурные) из латекса гевеи, неопудренные, нестерильные 2400001225408
перчатки смотровые (процедурные) из латекса гевеи, опудренные 2400001225606
перчатки смотровые (процедурные) из латекса гевеи, неопудренные, стерильные 2400001226108
перчатки смотровые (процедурные) из полихлоропрена, неопудренные 2400001393503
перчатки смотровые (процедурные) нитриловые, неопудренные, нестерильные 2400001858309
перчатки смотровые (процедурные) нитриловые, опудренные 2400001858507
перчатки смотровые (процедурные) виниловые, неопудренные 2400002052805
перчатки смотровые (процедурные) виниловые, опудренные 2400002052904
перчатки смотровые (процедурные) из гваюлового латекса, неопудренные 2400002984502
перчатки смотровые (процедурные) из этиленвинилацетата, неопудренные, стерильные 2400003117107
перчатки смотровые (процедурные) из этиленвинилацетата, неопудренные, нестерильные 2400003117206
перчатки смотровые (процедурные) нитриловые, неопудренные, антибактериальные 2400003207907
перчатки смотровые (процедурные) полиизопреновые, неопудренные 2400003215308
перчатки смотровые (процедурные) нитриловые, неопудренные, стерильные 2400003297700
перчатки смотровые (процедурные) виниловые, неопудренные, стерильные 2400003356704
перчатки смотровые (процедурные) виниловые, опудренные, стерильные 2400003356803
перчатки смотровые (процедурные) из латекса гевеи, опудренные, стерильные 2400003433108
перчатки смотровые (процедурные) полиизопреновые, опудренные 2400003492303
перчатки смотровые (процедурные) из полихлоропрена, неопудренные, стерильные 2400003495700
перчатки смотровые (процедурные) из полихлоропрена, неопудренные, стерильные 2400003495809
перчатки смотровые (процедурные) нитриловые, опудренные, стерильные 2400003495908
перчатки смотровые (процедурные) полиизопреновые, неопудренные, стерильные 2400003496004
перчатки смотровые (процедурные) полиизопреновые, опудренные, стерильные 2400003496103
перчатки хирургические из латекса гевеи, неопудренные 2400001226306
перчатки хирургические из латекса гевеи, опудренные 2400001226405
перчатки хирургические из полихлоропрена, неопудренные 2400001393107
перчатки смотровые (процедурные) из полихлоропрена, опудренные 2400001393602
перчатки хирургические из блоксополимера стирола, неопудренные, антибактериальные 2400001565306
перчатки хирургические нитриловые, опудренные 2400001857203
перчатки хирургические нитриловые, неопудренные 2400001857005
перчатки хирургические полиизопреновые, неопудренные 2400002015909
перчатки хирургические полиизопреновые, неопудренные, антибактериальные 2400002016005
перчатки хирургические полиизопреновые, опудренные 2400002016104
перчатки хирургические из блоксополимера стирола, неопудренные 2400003161209
перчатки хирургические полимерно-композитные, неопудренные 2400003227806
перчатки хирургические полимерно-композитные, неопудренные 2400003237409
перчатки хирургические из латекса гевеи, неопудренные, антибактериальные 2400003263408
перчатки хирургические из гваюлового латекса, неопудренные 2400003356902
перчатки хирургические из полихлоропрена, опудренные 2400003356902
набор гигиенической одежды для посетителей 2400002886806
комбинезон гигиенический для посетителей 2400002886707

  • characteristics — Массив пар вида «Наименование характеристики:значение«

  • product — Основной товар

  • isSerialtrackable — учёт по серийным номерам Необходимое

  • uom — Единица измерения услуги(строка)

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

  • paymentItemType — Признак предмета расчета

    • SERVICE — Услуга
    • WORK — Работа
    • PROVIDING_RID — Предоставление РИД
    • COMPOUND_PAYMENT_ITEM — Составной предмет расчета
    • ANOTHER_PAYMENT_ITEM — Иной предмет расчета

  • isDiscountProhibited — Запретить скидки при продаже в розницу

  • article — Артикул комплекта

  • uom — Единица измерения комплекта (строка)

  • vat — НДС

  • image — Изображение товара (объект)

    • href — Ссылка на изображение
    • miniature — Ссылка на миниатюру изображения
    • tiny — Ссылка на уменьшенную версию изображения

  • components — Компоненты комплекта, это список товаров/услуг/модификаций, который входят в состав комплекта. Компонентов у комплекта может быть от 1 до 10. Необходимое

    • meta — Метаданные сущности Необходимое
    • quantity — количество компонентов в комплекте.

  • trackingType — Тип маркируемой продукции

    • NOT_TRACKED — Без маркировки
    • TOBACCO — Тип маркировки “Табак”
    • SHOES — Тип маркировки “Обувь”
    • LP_CLOTHES — Тип маркировки “Одежда”
    • LP_LINENS — Тип маркировки “Постельное белье”
    • PERFUMERY — Тип маркировки “Духи и туалетная вода”
    • ELECTRONICS — Тип маркировки “Фотокамеры и лампы-вспышки”
    • TIRES — Тип маркировки “Шины и покрышки”
    • MILK — Тип маркировки “Молочная продукция”
    • WATER — Тип маркировки “Упакованная вода”
    • OTP — Тип маркировки “Альтернативная табачная продукция”
    • NCP — Тип маркировки “Никотиносодержащая продукция”

  • tnved — Код ТН ВЭД

  • paymentItemType — Признак предмета расчета

    • GOOD — Товар
    • EXCISABLE_GOOD — Подакцизный товар
    • COMPOUND_PAYMENT_ITEM — Составной предмет расчета
    • ANOTHER_PAYMENT_ITEM — Иной предмет расчета

  • isDiscountProhibited — Запретить скидки при продаже в розницу

  • taxSystem — Код системы налогообложения.

  • partialDisposal — Флаг частичного выбытия.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Товары/услуги/комплекты в рознице отображаются со всеми типами цен (salePrices). Если тип цен не задан явно, то возвращается значение 0.
Модификации в рознице отображаются с явно проставленными типами цен (salePrices). Если тип цен не задан явно, то будет отображаться цена родительского товара.

Папки ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Папки ¶

GET https://online.moysklad.ru/api/posap/1.0/entity/productfolder

Responses200

Успешный запрос. Результат — список всех папок на учетной записи.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder",
    "mediaType": "application/json",
    "size": 3,
    "limit": 1000,
    "offsetId": "00000000-0000-0000-0000-000000000000",
    "direction": "forward"
  },
  "rows": [
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/276a6f50-7ffd-11e6-8a84-bae50000005c",
        "mediaType": "application/json",
        "type": "productfolder",
        "id": "276a6f50-7ffd-11e6-8a84-bae50000005c",
        "idType": "native"
      },
      "productFolder": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
          "mediaType": "application/json",
          "type": "productfolder",
          "id": "dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
          "idType": "native"
        },
        "id": "dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
        "name": "Овощи",
        "namepath": "",
        "path": "/"
      },
      "id": "276a6f50-7ffd-11e6-8a84-bae50000005c",
      "name": "Цитрусовые",
      "namepath": "Овощи",
      "path": "/dbe2cf7f-7b5c-11e6-8a84-bae50000000e/"
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/83528b98-7ffd-11e6-8a84-bae500000062",
        "mediaType": "application/json",
        "type": "productfolder",
        "id": "83528b98-7ffd-11e6-8a84-bae500000062",
        "idType": "native"
      },
      "productFolder": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/276a6f50-7ffd-11e6-8a84-bae50000005c",
          "mediaType": "application/json",
          "type": "productfolder",
          "id": "276a6f50-7ffd-11e6-8a84-bae50000005c",
          "idType": "native"
        },
        "productFolder": {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
            "mediaType": "application/json",
            "type": "productfolder",
            "id": "dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
            "idType": "native"
          }
        },
        "id": "276a6f50-7ffd-11e6-8a84-bae50000005c",
        "name": "Цитрусовые",
        "namepath": "Овощи",
        "path": "/dbe2cf7f-7b5c-11e6-8a84-bae50000000e/"
      },
      "id": "83528b98-7ffd-11e6-8a84-bae500000062",
      "name": "Оранжевые",
      "namepath": "Овощи/Цитрусовые",
      "path": "/dbe2cf7f-7b5c-11e6-8a84-bae50000000e/276a6f50-7ffd-11e6-8a84-bae50000005c/"
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
        "mediaType": "application/json",
        "type": "productfolder",
        "id": "dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
        "idType": "native"
      },
      "id": "dbe2cf7f-7b5c-11e6-8a84-bae50000000e",
      "name": "Овощи",
      "namepath": "",
      "path": "/"
    }
  ]
}

Получить все папки

GET/entity/productfolder

Запрос на получение всех папок на учётной записи.

  • meta — метаданные папки Необходимое

  • productFolder — ссылка на родительскую папку

    • meta — метаданные папки Необходимое (если пришло родительское поле)
    • productFolder — ссылка на родительскую папку
    • id — id папки Необходимое (если пришло родительское поле)
    • name — наименование папки Необходимое (если пришло родительское поле)
    • namepath — путь к данной папке, состоящий из имён родительских папок Необходимое (если пришло родительское поле)
    • path — путь к данной папке, состоящий из id родительских папок Необходимое (если пришло родительское поле)

  • id — id папки Необходимое

  • name — наименование папки Необходимое

  • namepath — путь к данной папке, состоящий из имён родительских папок Необходимое

  • path — путь к данной папке, состоящий из id родительских папок Необходимое

Покупатели ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Покупатели ¶

GET https://online.moysklad.ru/api/posap/1.0/entity/counterparty

Responses200

Успешный запрос. Результат — JSON представление списка контрагентов.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty",
    "mediaType": "application/json",
    "size": 6,
    "limit": 1000,
    "offsetId": "00000000-0000-0000-0000-000000000000",
    "direction": "forward"
  },
  "rows": [
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/1c5dcf6f-7b32-11e6-8a84-bae500000000",
        "mediaType": "application/json",
        "type": "counterparty",
        "id": "1c5dcf6f-7b32-11e6-8a84-bae500000000",
        "idType": "native"
      },
      "id": "1c5dcf6f-7b32-11e6-8a84-bae500000000",
      "version": 0,
      "updated": "2016-09-15 13:49:43",
      "name": "OOOCompany",
      "externalCode": "qKQuM-6ijqMFB5TemvZxi1",
      "companyType": "legal",
      "tags": [],
      "salesAmount": 0
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/5d1fe143-7b1d-11e6-8a84-bae500000054",
        "mediaType": "application/json",
        "type": "counterparty",
        "id": "5d1fe143-7b1d-11e6-8a84-bae500000054",
        "idType": "native"
      },
      "id": "5d1fe143-7b1d-11e6-8a84-bae500000054",
      "version": 0,
      "updated": "2016-09-15 11:21:13",
      "name": "ООО "Поставщик"",
      "externalCode": "8DLiwCbIhvJz3TSNC2h1G3",
      "companyType": "legal",
      "legalTitle": "Общество с ограниченной ответственностью "Поставщик"",
      "legalAddress": "г.Москва, ул.Строителей, д.12",
      "inn": "7736570901",
      "kpp": "773601001",
      "tags": [],
      "salesAmount": 0
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/5d201705-7b1d-11e6-8a84-bae500000056",
        "mediaType": "application/json",
        "type": "counterparty",
        "id": "5d201705-7b1d-11e6-8a84-bae500000056",
        "idType": "native"
      },
      "id": "5d201705-7b1d-11e6-8a84-bae500000056",
      "version": 0,
      "updated": "2016-09-15 11:21:13",
      "name": "ООО "Покупатель"",
      "externalCode": "grYJWYhkheEmr3aNP53-72",
      "companyType": "legal",
      "legalTitle": "Общество с ограниченной ответственностью "Покупатель"",
      "legalAddress": "г.Москва, ул.Строителей, д.11",
      "inn": "7736570902",
      "kpp": "773601002",
      "tags": [],
      "salesAmount": 0
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/5d444290-7b1d-11e6-8a84-bae50000005e",
        "mediaType": "application/json",
        "type": "counterparty",
        "id": "5d444290-7b1d-11e6-8a84-bae50000005e",
        "idType": "native"
      },
      "id": "5d444290-7b1d-11e6-8a84-bae50000005e",
      "version": 10,
      "updated": "2016-09-15 11:21:13",
      "name": "Розничный покупатель",
      "externalCode": "xprOCvL2gPZjzlYwqzsvw3",
      "companyType": "legal",
      "tags": [],
      "salesAmount": 18720
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/688bd078-800c-11e6-8a84-bae5000000a2",
        "mediaType": "application/json",
        "type": "counterparty",
        "id": "688bd078-800c-11e6-8a84-bae5000000a2",
        "idType": "native"
      },
      "id": "688bd078-800c-11e6-8a84-bae5000000a2",
      "version": 4,
      "updated": "2016-09-21 18:05:01",
      "name": "АО компания-банк",
      "description": "Ключевой партнёр",
      "code": "almost-alfa-code",
      "externalCode": "6AWY7U4biGxP-HFAmEN0l3",
      "companyType": "entrepreneur",
      "legalTitle": "АКЦИОНЕРНОЕ ОБЩЕСТВО "компания-банк"",
      "legalAddress": "г Можайск, ул Недокаланчевская, д 26.99",
      "actualAddress": "г Можайск, ул Перекаланчевская, д 27.01",
      "inn": "7728178971",
      "okpo": "3519251242513",
      "ogrnip": "12412412",
      "certificateNumber": "в21421412",
      "certificateDate": "2016-09-01 00:00:00",
      "email": "aoalmost@bank.ru",
      "phone": "+7 666 555 444 333",
      "fax": "123321",
      "tags": [],
      "discounts": [
        {
          "discount": {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/941e8ce7-7b1d-11e6-8a84-bae500000111",
              "mediaType": "application/json",
              "type": "accumulationdiscount",
              "id": "941e8ce7-7b1d-11e6-8a84-bae500000111",
              "idType": "native"
            }
          },
          "salesAmountCorrection": 30000
        },
        {
          "discount": {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/98af408c-7fdc-11e6-8a84-bae50000003c",
              "mediaType": "application/json",
              "type": "accumulationdiscount",
              "id": "98af408c-7fdc-11e6-8a84-bae50000003c",
              "idType": "native"
            }
          },
          "salesAmountCorrection": 1000
        },
        {
          "discount": {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/fbd3a1b7-7fdd-11e6-8a84-bae500000047",
              "mediaType": "application/json",
              "type": "accumulationdiscount",
              "id": "fbd3a1b7-7fdd-11e6-8a84-bae500000047",
              "idType": "native"
            }
          },
          "salesAmountCorrection": 1000
        }
      ],
      "discountCardNumber": "6",
      "salesAmount": 0
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/801ee966-7b1d-11e6-8a84-bae5000000fd",
        "mediaType": "application/json",
        "type": "counterparty",
        "id": "801ee966-7b1d-11e6-8a84-bae5000000fd",
        "idType": "native"
      },
      "id": "801ee966-7b1d-11e6-8a84-bae5000000fd",
      "version": 3,
      "updated": "2016-09-21 12:21:54",
      "name": "Контрагент со скидкой",
      "externalCode": "uI93KJojjZk7F-WU9eJfr1",
      "companyType": "legal",
      "tags": [],
      "discounts": [
        {
          "discount": {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/941e8ce7-7b1d-11e6-8a84-bae500000111",
              "mediaType": "application/json",
              "type": "accumulationdiscount",
              "id": "941e8ce7-7b1d-11e6-8a84-bae500000111",
              "idType": "native"
            }
          },
          "salesAmountCorrection": 0
        },
        {
          "discount": {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/98af408c-7fdc-11e6-8a84-bae50000003c",
              "mediaType": "application/json",
              "type": "accumulationdiscount",
              "id": "98af408c-7fdc-11e6-8a84-bae50000003c",
              "idType": "native"
            }
          },
          "salesAmountCorrection": 10000
        }
      ],
      "salesAmount": 150000
    }
  ]
}

Получить Покупателей

GET/entity/counterparty

Запрос на получение списка всех контрагентов.

  • offsetId — Смещение

  • limit — Максимальное возвращаемое кол-во

  • direction — Направление следующей страницы поиска

  • search — Строка для поиска. Возвращаемые контрагенты должны содержать соответствующую подстроку в одном из полей: name, email, phone, discountCardNumber

  • meta — внешний уникальный идентификатор в формате метаданных (мета с syncId) Необходимое

  • id — ID в формате UUID Необходимое

  • syncId — ID синхронизации

  • version — Версия сущности. Изменяется при обновлении/удалении Контрагента Необходимое

  • updated — Момент последнего обновления Контрагента Необходимое

  • externalCode — Внешний код Контрагента Необходимое

  • name — Имя Контрагента Необходимое

  • code — Код Контрагента

  • description — Описание Контрагента

  • actualAddress -Фактический адрес Контрагента

  • tags — Тэги (массив) Необходимое

  • companyType — Тип Контрагента. Необходимое
    [Юридическое лицо, Индивидуальный предприниматель, Физическое лицо].
Тип контрагента Значение поля companyType
Юридическое лицо legal
Индивидуальный предприниматель entrepreneur
Физическое лицо individual

  • legalTitle — Полное наименование Контрагента

  • legalAddress — Юридический адрес Контрагента

  • inn — ИНН

  • kpp — КПП

  • ogrn — ОГРН

  • ogrnip — ОГРНИП

  • okpo — ОКПО

  • certificateNumber — Номер свидетельства

  • certificateDate — Дата свидетельства

  • email — Адрес электронной почты

  • phone — Номер городского телефона

  • fax — Номер факса

  • discounts — Массив объектов-скидок, действующих на данного контрагента.

    • discount — Скидка
      • meta — метаданные скидки
      • personalDiscount — процент персональной скидки (если тип — персональная скидка)
      • salesAmountCorrection — Коррекция

  • discountCardNumber — Номер дисконтной карты

  • salesAmount — Сумма продаж контрагента Необходимое

  • bonusProgram — Метаданные активной бонусной программы

  • bonusPoints — Бонусные баллы по активной бонусной программе

Покупатели ¶

POST https://online.moysklad.ru/api/posap/1.0/entity/counterparty/detail

RequestsПример

Пример body запроса для получения информации по контрагенту.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/688bd078-800c-11e6-8a84-bae5000000a2",
    "mediaType": "application/json",
    "type": "counterparty",
    "id": "688bd078-800c-11e6-8a84-bae5000000a2",
    "idType": "native"
  },
  "id": "688bd078-800c-11e6-8a84-bae5000000a2",
  "syncId": "688bd078-800c-11e6-8a84-bae5000000a3",
  "version": 4,
  "updated": "2016-09-21 18:05:01",
  "name": "АО компания-банк",
  "description": "Ключевой партнёр",
  "code": "almost-alfa-code",
  "externalCode": "6AWY7U4biGxP-HFAmEN0l3",
  "companyType": "entrepreneur",
  "legalTitle": "АКЦИОНЕРНОЕ ОБЩЕСТВО "компания-банк"",
  "legalAddress": "г Можайск, ул Недокаланчевская, д 26.99",
  "actualAddress": "г Можайск, ул Перекаланчевская, д 27.01",
  "inn": "7728178971",
  "okpo": "3519251242513",
  "ogrnip": "12412412",
  "certificateNumber": "в21421412",
  "certificateDate": "2016-09-01 00:00:00",
  "email": "aoalmost@bank.ru",
  "phone": "+7 666 555 444 333",
  "fax": "123321",
  "tags": [],
  "discounts": [
    {
      "discount": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/941e8ce7-7b1d-11e6-8a84-bae500000111",
          "mediaType": "application/json",
          "type": "accumulationdiscount",
          "id": "941e8ce7-7b1d-11e6-8a84-bae500000111",
          "idType": "native"
        }
      },
      "salesAmountCorrection": 30000
    },
    {
      "discount": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/98af408c-7fdc-11e6-8a84-bae50000003c",
          "mediaType": "application/json",
          "type": "accumulationdiscount",
          "id": "98af408c-7fdc-11e6-8a84-bae50000003c",
          "idType": "native"
        }
      },
      "salesAmountCorrection": 1000
    },
    {
      "discount": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/fbd3a1b7-7fdd-11e6-8a84-bae500000047",
          "mediaType": "application/json",
          "type": "accumulationdiscount",
          "id": "fbd3a1b7-7fdd-11e6-8a84-bae500000047",
          "idType": "native"
        }
      },
      "salesAmountCorrection": 1000
    }
  ],
  "discountCardNumber": "6",
  "salesAmount": 0
}

Responses200

Успешный запрос. Результат — JSON представление данных контрагента.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty",
    "mediaType": "application/json",
    "size": 6,
    "limit": 1000,
    "offsetId": "00000000-0000-0000-0000-000000000000",
    "direction": "forward"
  },
  "rows": [
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/1c5dcf6f-7b32-11e6-8a84-bae500000000",
        "mediaType": "application/json",
        "type": "counterparty",
        "id": "1c5dcf6f-7b32-11e6-8a84-bae500000000",
        "idType": "native"
      },
      "id": "1c5dcf6f-7b32-11e6-8a84-bae500000000",
      "version": 0,
      "updated": "2016-09-15 13:49:43",
      "name": "OOOCompany",
      "externalCode": "qKQuM-6ijqMFB5TemvZxi1",
      "companyType": "legal",
      "tags": [],
      "salesAmount": 0
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/5d1fe143-7b1d-11e6-8a84-bae500000054",
        "mediaType": "application/json",
        "type": "counterparty",
        "id": "5d1fe143-7b1d-11e6-8a84-bae500000054",
        "idType": "native"
      },
      "id": "5d1fe143-7b1d-11e6-8a84-bae500000054",
      "version": 0,
      "updated": "2016-09-15 11:21:13",
      "name": "ООО "Поставщик"",
      "externalCode": "8DLiwCbIhvJz3TSNC2h1G3",
      "companyType": "legal",
      "legalTitle": "Общество с ограниченной ответственностью "Поставщик"",
      "legalAddress": "г.Москва, ул.Строителей, д.12",
      "inn": "7736570901",
      "kpp": "773601001",
      "tags": [],
      "salesAmount": 0
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/5d201705-7b1d-11e6-8a84-bae500000056",
        "mediaType": "application/json",
        "type": "counterparty",
        "id": "5d201705-7b1d-11e6-8a84-bae500000056",
        "idType": "native"
      },
      "id": "5d201705-7b1d-11e6-8a84-bae500000056",
      "version": 0,
      "updated": "2016-09-15 11:21:13",
      "name": "ООО "Покупатель"",
      "externalCode": "grYJWYhkheEmr3aNP53-72",
      "companyType": "legal",
      "legalTitle": "Общество с ограниченной ответственностью "Покупатель"",
      "legalAddress": "г.Москва, ул.Строителей, д.11",
      "inn": "7736570902",
      "kpp": "773601002",
      "tags": [],
      "salesAmount": 0
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/5d444290-7b1d-11e6-8a84-bae50000005e",
        "mediaType": "application/json",
        "type": "counterparty",
        "id": "5d444290-7b1d-11e6-8a84-bae50000005e",
        "idType": "native"
      },
      "id": "5d444290-7b1d-11e6-8a84-bae50000005e",
      "version": 10,
      "updated": "2016-09-15 11:21:13",
      "name": "Розничный покупатель",
      "externalCode": "xprOCvL2gPZjzlYwqzsvw3",
      "companyType": "legal",
      "tags": [],
      "salesAmount": 18720
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/688bd078-800c-11e6-8a84-bae5000000a2",
        "mediaType": "application/json",
        "type": "counterparty",
        "id": "688bd078-800c-11e6-8a84-bae5000000a2",
        "idType": "native"
      },
      "id": "688bd078-800c-11e6-8a84-bae5000000a2",
      "version": 4,
      "updated": "2016-09-21 18:05:01",
      "name": "АО компания-банк",
      "description": "Ключевой партнёр",
      "code": "almost-alfa-code",
      "externalCode": "6AWY7U4biGxP-HFAmEN0l3",
      "companyType": "entrepreneur",
      "legalTitle": "АКЦИОНЕРНОЕ ОБЩЕСТВО "компания-банк"",
      "legalAddress": "г Можайск, ул Недокаланчевская, д 26.99",
      "actualAddress": "г Можайск, ул Перекаланчевская, д 27.01",
      "inn": "7728178971",
      "okpo": "3519251242513",
      "ogrnip": "12412412",
      "certificateNumber": "в21421412",
      "certificateDate": "2016-09-01 00:00:00",
      "email": "aoalmost@bank.ru",
      "phone": "+7 666 555 444 333",
      "fax": "123321",
      "tags": [],
      "discounts": [
        {
          "discount": {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/941e8ce7-7b1d-11e6-8a84-bae500000111",
              "mediaType": "application/json",
              "type": "accumulationdiscount",
              "id": "941e8ce7-7b1d-11e6-8a84-bae500000111",
              "idType": "native"
            }
          },
          "salesAmountCorrection": 30000
        },
        {
          "discount": {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/98af408c-7fdc-11e6-8a84-bae50000003c",
              "mediaType": "application/json",
              "type": "accumulationdiscount",
              "id": "98af408c-7fdc-11e6-8a84-bae50000003c",
              "idType": "native"
            }
          },
          "salesAmountCorrection": 1000
        },
        {
          "discount": {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/fbd3a1b7-7fdd-11e6-8a84-bae500000047",
              "mediaType": "application/json",
              "type": "accumulationdiscount",
              "id": "fbd3a1b7-7fdd-11e6-8a84-bae500000047",
              "idType": "native"
            }
          },
          "salesAmountCorrection": 1000
        }
      ],
      "discountCardNumber": "6",
      "salesAmount": 0
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/801ee966-7b1d-11e6-8a84-bae5000000fd",
        "mediaType": "application/json",
        "type": "counterparty",
        "id": "801ee966-7b1d-11e6-8a84-bae5000000fd",
        "idType": "native"
      },
      "id": "801ee966-7b1d-11e6-8a84-bae5000000fd",
      "version": 3,
      "updated": "2016-09-21 12:21:54",
      "name": "Контрагент со скидкой",
      "externalCode": "uI93KJojjZk7F-WU9eJfr1",
      "companyType": "legal",
      "tags": [],
      "discounts": [
        {
          "discount": {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/941e8ce7-7b1d-11e6-8a84-bae500000111",
              "mediaType": "application/json",
              "type": "accumulationdiscount",
              "id": "941e8ce7-7b1d-11e6-8a84-bae500000111",
              "idType": "native"
            }
          },
          "salesAmountCorrection": 0
        },
        {
          "discount": {
            "meta": {
              "href": "https://online.moysklad.ru/api/posap/1.0/entity/accumulationdiscount/98af408c-7fdc-11e6-8a84-bae50000003c",
              "mediaType": "application/json",
              "type": "accumulationdiscount",
              "id": "98af408c-7fdc-11e6-8a84-bae50000003c",
              "idType": "native"
            }
          },
          "salesAmountCorrection": 10000
        }
      ],
      "salesAmount": 150000
    }
  ]
}

Получить бонусные баллы Покупателя

POST/entity/counterparty/detail

Запрос на получение бонусных баллов контрагента. Необходимо передать объект, полученный из метода GET /entity/counterparty. Бонусные баллы возвращаются для каждого контрагента в отдельном запросе на получение баллов.

  • meta — внешний уникальный идентификатор в формате метаданных (мета с syncId) Необходимое

  • id — ID в формате UUID Необходимое

  • syncId — ID синхронизации

  • version — Версия сущности. Изменяется при обновлении/удалении Контрагента Необходимое

  • updated — Момент последнего обновления Контрагента Необходимое

  • externalCode — Внешний код Контрагента Необходимое

  • name — Имя Контрагента Необходимое

  • code — Код Контрагента

  • description — Описание Контрагента

  • actualAddress -Фактический адрес Контрагента

  • tags — Тэги (массив) Необходимое

  • companyType — Тип Контрагента. Необходимое
    [Юридическое лицо, Индивидуальный предприниматель, Физическое лицо].
Тип контрагента Значение поля companyType
Юридическое лицо legal
Индивидуальный предприниматель entrepreneur
Физическое лицо individual

  • legalTitle — Полное наименование Контрагента

  • legalAddress — Юридический адрес Контрагента

  • inn — ИНН

  • kpp — КПП

  • ogrn — ОГРН

  • ogrnip — ОГРНИП

  • okpo — ОКПО

  • certificateNumber — Номер свидетельства

  • certificateDate — Дата свидетельства

  • email — Адрес электронной почты

  • phone — Номер городского телефона

  • fax — Номер факса

  • discounts — Массив объектов-скидок, действующих на данного контрагента.

    • discount — Скидка
      • meta — метаданные скидки
      • personalDiscount — процент персональной скидки (если тип — персональная скидка)
      • salesAmountCorrection — Коррекция

  • discountCardNumber — Номер дисконтной карты

  • salesAmount — Сумма продаж контрагента Необходимое

  • meta — внешний уникальный идентификатор в формате метаданных (мета с syncId) Необходимое

  • id — ID в формате UUID Необходимое

  • syncId — ID синхронизации

  • version — Версия сущности. Изменяется при обновлении/удалении Контрагента Необходимое

  • updated — Момент последнего обновления Контрагента Необходимое

  • externalCode — Внешний код Контрагента Необходимое

  • name — Имя Контрагента Необходимое

  • code — Код Контрагента

  • description — Описание Контрагента

  • actualAddress -Фактический адрес Контрагента

  • tags — Тэги (массив) Необходимое

  • companyType — Тип Контрагента. Необходимое
    [Юридическое лицо, Индивидуальный предприниматель, Физическое лицо].
Тип контрагента Значение поля companyType
Юридическое лицо legal
Индивидуальный предприниматель entrepreneur
Физическое лицо individual

  • legalTitle — Полное наименование Контрагента

  • legalAddress — Юридический адрес Контрагента

  • inn — ИНН

  • kpp — КПП

  • ogrn — ОГРН

  • ogrnip — ОГРНИП

  • okpo — ОКПО

  • certificateNumber — Номер свидетельства

  • certificateDate — Дата свидетельства

  • email — Адрес электронной почты

  • phone — Номер городского телефона

  • fax — Номер факса

  • discounts — Массив объектов-скидок, действующих на данного контрагента.

    • discount — Скидка
      • meta — метаданные скидки
      • personalDiscount — процент персональной скидки (если тип — персональная скидка)
      • salesAmountCorrection — Коррекция

  • discountCardNumber — Номер дисконтной карты

  • salesAmount — Сумма продаж контрагента Необходимое

  • bonusProgram — Метаданные активной бонусной программы

  • bonusPoints — Бонусные баллы по активной бонусной программе

Заказы покупателей ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Заказы покупателей ¶

GET https://online.moysklad.ru/api/posap/1.0/entity/customerorder

Responses200

Успешный запрос. Результат — JSON представление списка Заказов покупателей.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/customerorder",
    "mediaType": "application/json",
    "size": 1,
    "limit": 100,
    "offset": 0
  },
  "rows": [
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/customerorder/0f175046-dbca-11e6-5bed-427b00000079",
        "mediaType": "application/json",
        "type": "customerorder",
        "id": "0f175046-dbca-11e6-5bed-427b00000079",
        "idType": "native"
      },
      "id": "0f175046-dbca-11e6-5bed-427b00000079",
      "name": "00001",
      "description": "2222222222222",
      "moment": "2017-01-16 11:59:00",
      "vatEnabled": true,
      "vatIncluded": true,
      "deliveryPlannedMoment": "2017-02-01 17:12:00",
      "state": {
        "name": "Новый",
        "color": 15106326,
        "type": "Regular"
      },
      "positions": [
        {
          "assortment": {
            "meta": {
              "href": "http://online.moysklad.ru/api/posap/1.0/entity/product/d90cda3b-1f6c-11e7-8a7f-40d000000003",
              "mediaType": "application/json",
              "type": "product",
              "id": "d90cda3b-1f6c-11e7-8a7f-40d000000003",
              "idType": "native"
            },
            "name": "good1",
            "code": "00034",
            "uom": "шт",
            "barcodes": [
              "2000000000367"
            ],
            "salePrices": [
              {
                "value": 6000,
                "priceType": "Цена продажи"
              },
              {
                "value": 4000,
                "priceType": "Цена распродажи"
              }
            ],
            "soldByWeight": false,
            "onTap": false,
            "isSerialTrackable": false,
            "paymentItemType": "GOOD",
            "isDiscountProhibited": false
          },
          "quantity": 1,
          "price": 0,
          "vat": 0,
          "vatEnabled": false,
          "discount": 0,
          "reserve": 0
        },
        {
          "assortment": {
            "meta": {
              "href": "http://online.moysklad.ru/api/posap/1.0/entity/variant/cca27551-5cc3-11e7-6a80-332a000000a4",
              "mediaType": "application/json",
              "type": "variant",
              "id": "cca27551-5cc3-11e7-6a80-332a000000a4",
              "idType": "native"
            },
            "name": "good1 (variant)",
            "code": "00035",
            "uom": "шт",
            "barcodes": [
              "2000000000369"
            ],
            "salePrices": [
              {
                "value": 6000,
                "priceType": "Цена продажи"
              },
              {
                "value": 5000,
                "priceType": "Цена распродажи"
              }
            ],
            "soldByWeight": false,
            "onTap": false,
            "isSerialTrackable": false,
            "paymentItemType": "ANOTHER_PAYMENT_ITEM",
            "isDiscountProhibited": false
          },
          "quantity": 10,
          "price": 0,
          "vat": 0,
          "vatEnabled": false,
          "discount": 0,
          "reserve": 0,
          "pack": {
            "id": "5ae9e6b5-7b95-11e9-ac12-000b000000ac",
            "name": "ящ",
            "quantity": 10,
            "barcode": "2000000000016"
          }
        },
        {
          "assortment": {
            "meta": {
              "href": "http://online.moysklad.ru/api/posap/1.0/entity/product/d90cda3b-1f6c-11e7-8a7f-40d000000103",
              "mediaType": "application/json",
              "type": "product",
              "id": "d90cda3b-1f6c-11e7-8a7f-40d000000103",
              "idType": "native"
            },
            "name": "mask",
            "code": "00134",
            "uom": "шт",
            "barcodes": [
              "2000000023367"
            ],
            "salePrices": [
              {
                "value": 3500,
                "priceType": "Цена продажи"
              }
            ],
            "soldByWeight": false,
            "onTap": false,
            "isSerialTrackable": false,
            "paymentItemType": "GOOD",
            "isDiscountProhibited": false,
            "ppeType": "2400001323807"
          },
          "quantity": 1,
          "price": 0,
          "vat": 0,
          "vatEnabled": false,
          "discount": 0,
          "reserve": 0
        }
      ],
      "agent": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/90fdbe2f-d973-11e6-5bed-427b00000056",
          "mediaType": "application/json",
          "type": "counterparty",
          "id": "90fdbe2f-d973-11e6-5bed-427b00000056",
          "idType": "native"
        },
        "name": "ООО "Покупатель""
      },
      "prepayments": [
        {
          "meta": {
            "href": "http://online.moysklad.ru/api/posap/1.0/entity/prepayment/6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e31",
            "mediaType": "application/json",
            "type": "prepayment",
            "id": "6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e31",
            "idType": "native"
          },
          "name": "00010"
        },
        {
          "meta": {
            "href": "http://online.moysklad.ru/api/posap/1.0/entity/prepayment/6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e30",
            "mediaType": "application/json",
            "type": "prepayment",
            "id": "6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e30",
            "idType": "native"
          },
          "name": "00011"
        }
      ],
      "paidInCash": 123,
      "paidNoCash": 222,
      "paidByQr": 0,
      "shippedSum": 111
    }
  ]
}

Получить Заказы покупателей

GET/entity/customerorder

Запрос на получение списка Заказов покупателей, соответствующих складу и организации точки продаж.
Не выгружаются Заказы с сериями, алкогольными товарами, непроведенные заказы, а также заказы без позиций и заказы, у которых более 1000 позиций.

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • id — ID в формате UUID Необходимое

  • name — Имя Необходимое

  • description — Описание

  • moment — Дата Необходимое

  • vatEnabled — Учитывается ли НДС Необходимое

  • vatIncluded — Включен ли НДС в цену Необходимое

  • deliveryPlannedMoment — Планируемая дата отгрузки

  • state — Статус

  • positions — Ссылка на позиции в формате метаданных Необходимое

  • agent — Ссылка на покупателя в формате метаданных (Если заказ назначен на стандартного розничный покупателя, то это поле не придёт в составе заказа)

  • paidInCash — Оплачено наличными по заказу

  • paidNoCash — Оплачено картой по заказу

  • paidByQr — Оплачено по QR-коду по заказу

  • shippedSum — Отгружено

  • prepayments — Предоплаты связанные с заказом покупателя

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Позиции Заказа — это список товаров/услуг/модификаций/комплектов.
Объект позиции Заказа содержит следующие поля:

  • assortment — Ссылка на товар/услугу/модификацию/комплект (мета), которую представляет собой позиция Необходимое

  • quantity — Количество товаров/услуг/модификаций/комплектов данного вида в позиции Необходимое

  • price — Цена товаров/услуг/модификаций/комплекта в копейках Необходимое

  • vat — НДС, которым облагается текущая позиция Необходимое

  • vatEnabled — включен ли НДС для позиции. С помощью этого флага для позиции можно выставлять НДС = 0 или НДС = “без НДС”. (vat = 0, vatEnabled = false) -> vat = “без НДС”, (vat = 0, vatEnabled = true) -> vat = 0%

  • discount — Процент скидки или наценки Необходимое

  • reserve — Резерв данной позиции Необходимое

  • pack — Упаковка

    • id — id сущности упаковки Необходимое
    • name — Название упаковки Необходимое
    • quantity — Количество товаров в упаковке Необходимое
    • barcode — Штрихкод упаковки

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Объект статуса Заказа содержит следующие поля:

  • name — Наименование Необходимое

  • color — Цвет в цветовом пространстве ARGB Необходимое

  • type — Тип. Возможные значения: [Regular(обычный), Successful(Финальный положительный), Unsuccessful(Финальный отрицательный)] Необходимое

Объект покупателя Заказа содержит следующие поля:

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • name — Имя Необходимое

Объект предоплаты Заказа содержит следующие поля:

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • name — Имя Необходимое

У точки продаж в основном приложении есть настройка: “Выгружать только заказы со статусами”, которая влияет на выдачу заказов.
Если в этой настройке указаны статусы, то, при запросе заказов, будут возвращены только заказы с указанными статусами. Если статусы не указаны, будут выгружаться заказы со всеми статусами в т.ч. пустыми.

Заказы покупателей ¶

GET https://online.moysklad.ru/api/posap/1.0/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19

Responses200

Успешный запрос. Результат — JSON представление списка Заказов покупателей.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/customerorder/0f175046-dbca-11e6-5bed-427b00000079",
    "mediaType": "application/json",
    "type": "customerorder",
    "id": "0f175046-dbca-11e6-5bed-427b00000079",
    "idType": "native"
  },
  "id": "0f175046-dbca-11e6-5bed-427b00000079",
  "name": "00001",
  "description": "2222222222222",
  "moment": "2017-01-16 11:59:00",
  "vatEnabled": true,
  "vatIncluded": true,
  "deliveryPlannedMoment": "2017-02-01 17:12:00",
  "state": {
    "name": "Новый",
    "color": 15106326,
    "type": "Regular"
  },
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "http://online.moysklad.ru/api/posap/1.0/entity/product/d90cda3b-1f6c-11e7-8a7f-40d000000003",
          "mediaType": "application/json",
          "type": "product",
          "id": "d90cda3b-1f6c-11e7-8a7f-40d000000003",
          "idType": "native"
        },
        "name": "good1",
        "code": "00034",
        "uom": "шт",
        "barcodes": [
          "2000000000367"
        ],
        "salePrices": [
          {
            "value": 6000,
            "priceType": "Цена продажи"
          },
          {
            "value": 4000,
            "priceType": "Цена распродажи"
          }
        ],
        "soldByWeight": false,
        "onTap": false,
        "isSerialTrackable": false,
        "paymentItemType": "GOOD",
        "isDiscountProhibited": false
      },
      "quantity": 1,
      "price": 0,
      "vat": 0,
      "vatEnabled": false,
      "discount": 0,
      "reserve": 0
    },
    {
      "assortment": {
        "meta": {
          "href": "http://online.moysklad.ru/api/posap/1.0/entity/variant/cca27551-5cc3-11e7-6a80-332a000000a4",
          "mediaType": "application/json",
          "type": "variant",
          "id": "cca27551-5cc3-11e7-6a80-332a000000a4",
          "idType": "native"
        },
        "name": "good1 (variant)",
        "code": "00035",
        "uom": "шт",
        "barcodes": [
          "2000000000369"
        ],
        "salePrices": [
          {
            "value": 6000,
            "priceType": "Цена продажи"
          },
          {
            "value": 5000,
            "priceType": "Цена распродажи"
          }
        ],
        "soldByWeight": false,
        "onTap": false,
        "isSerialTrackable": false,
        "paymentItemType": "ANOTHER_PAYMENT_ITEM",
        "isDiscountProhibited": false
      },
      "quantity": 10,
      "price": 0,
      "vat": 0,
      "vatEnabled": false,
      "discount": 0,
      "reserve": 0,
      "pack": {
        "id": "5ae9e6b5-7b95-11e9-ac12-000b000000ac",
        "name": "ящ",
        "quantity": 10,
        "barcode": "2000000000016"
      }
    },
    {
      "assortment": {
        "meta": {
          "href": "http://online.moysklad.ru/api/posap/1.0/entity/product/d90cda3b-1f6c-11e7-8a7f-40d000000103",
          "mediaType": "application/json",
          "type": "product",
          "id": "d90cda3b-1f6c-11e7-8a7f-40d000000103",
          "idType": "native"
        },
        "name": "mask",
        "code": "00134",
        "uom": "шт",
        "barcodes": [
          "2000000023367"
        ],
        "salePrices": [
          {
            "value": 3500,
            "priceType": "Цена продажи"
          }
        ],
        "soldByWeight": false,
        "onTap": false,
        "isSerialTrackable": false,
        "paymentItemType": "GOOD",
        "isDiscountProhibited": false,
        "ppeType": "2400001323807"
      },
      "quantity": 1,
      "price": 0,
      "vat": 0,
      "vatEnabled": false,
      "discount": 0,
      "reserve": 0
    }
  ],
  "agent": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/90fdbe2f-d973-11e6-5bed-427b00000056",
      "mediaType": "application/json",
      "type": "counterparty",
      "id": "90fdbe2f-d973-11e6-5bed-427b00000056",
      "idType": "native"
    },
    "name": "ООО "Покупатель""
  },
  "prepayments": [
    {
      "meta": {
        "href": "http://online.moysklad.ru/api/posap/1.0/entity/prepayment/6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e31",
        "mediaType": "application/json",
        "type": "prepayment",
        "id": "6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e31",
        "idType": "native"
      },
      "name": "00010"
    },
    {
      "meta": {
        "href": "http://online.moysklad.ru/api/posap/1.0/entity/prepayment/6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e30",
        "mediaType": "application/json",
        "type": "prepayment",
        "id": "6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e30",
        "idType": "native"
      },
      "name": "00011"
    }
  ],
  "paidInCash": 123,
  "paidNoCash": 222,
  "paidByQr": 0,
  "shippedSum": 111
}

Получить Заказ покупателя

GET/entity/customerorder/{id}

Запрос на получение заказа для точки продаж.

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • id — ID в формате UUID Необходимое

  • name — Имя Необходимое

  • description — Описание

  • moment — Дата Необходимое

  • vatEnabled — Учитывается ли НДС Необходимое

  • vatIncluded — Включен ли НДС в цену Необходимое

  • deliveryPlannedMoment — Планируемая дата отгрузки

  • state — Статус

  • positions — Ссылка на позиции в формате метаданных Необходимое

  • agent — Ссылка на покупателя в формате метаданных (Если заказ назначен на стандартного розничный покупателя, то это поле не придёт в составе заказа)

  • paidInCash — Оплачено наличными по заказу

  • paidNoCash — Оплачено картой по заказу

  • paidByQr — Оплачено по QR-коду по заказу

  • shippedSum — Отгружено

  • prepayments — Предоплаты связанные с заказом покупателя

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Позиции Заказа — это список товаров/услуг/модификаций/комплектов.
Объект позиции Заказа содержит следующие поля:

  • assortment — Ссылка на товар/услугу/модификацию/комплект (мета), которую представляет собой позиция Необходимое

  • quantity — Количество товаров/услуг/модификаций/комплектов данного вида в позиции Необходимое

  • price — Цена товаров/услуг/модификаций/комплекта в копейках Необходимое

  • vat — НДС, которым облагается текущая позиция Необходимое

  • vatEnabled — включен ли НДС для позиции. С помощью этого флага для позиции можно выставлять НДС = 0 или НДС = “без НДС”. (vat = 0, vatEnabled = false) -> vat = “без НДС”, (vat = 0, vatEnabled = true) -> vat = 0%

  • discount — Процент скидки или наценки Необходимое

  • reserve — Резерв данной позиции Необходимое

  • pack — Упаковка

    • id — id сущности упаковки Необходимое
    • name — Название упаковки Необходимое
    • quantity — Количество товаров в упаковке Необходимое
    • barcode — Штрихкод упаковки

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Объект статуса Заказа содержит следующие поля:

  • name — Наименование Необходимое

  • color — Цвет в цветовом пространстве ARGB Необходимое

  • type — Тип. Возможные значения: [Regular(обычный), Successful(Финальный положительный), Unsuccessful(Финальный отрицательный)] Необходимое

Объект покупателя Заказа содержит следующие поля:

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • name — Имя Необходимое

Объект предоплаты Заказа содержит следующие поля:

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • name — Имя Необходимое

У точки продаж в основном приложении есть настройка: “Выгружать только заказы со статусами”, которая влияет на выдачу заказов.
Если в этой настройке указаны статусы, то, при запросе заказов, будут возвращены только заказы с указанными статусами. Если статусы не указаны, будут выгружаться заказы со всеми статусами в т.ч. пустыми.

URI Параметры

СкрытьПоказать

id
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19

id Заказа покупателя

Заказы покупателей ¶

POST https://online.moysklad.ru/api/posap/1.0/entity/customerorder

RequestsПример 1

Пример создания нового заказа покупателя.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/customerorder/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
  },
  "moment": "2018-09-06 21:41:46",
  "description": "Описание заказа",
  "agent": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/syncid/f085d67e-6eae-11e6-8a84-bc520403352a"
    }
  },
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/f085d67e-6eae-11e6-8a84-bc520403352c"
        }
      },
      "quantity": 2,
      "price": 500,
      "discount": 10,
      "vat": 10
    },
    {
      "quantity": 3,
      "price": 400,
      "discount": 10,
      "vat": 10,
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/syncid/f085d67e-6eae-11e6-8a84-bc520403352c"
        }
      }
    }
  ],
  "taxSystem": "SIMPLIFIED_TAX_SYSTEM_INCOME"
}

Responses201

This response has no content.

Создать заказ покупателя

POST/entity/customerorder

Запрос на создание нового заказа покупателя.

Обязательные поля для создания заказа:

  • meta — Метаданные

  • agent — Ссылка на контрагента.

В случае, если не будет передано поле name — оно будет автоматически присвоено на сервере.
После создания, заказу будет выставлена Организация, указанная в настройках точки продаж.

Атрибуты запроса

  • taxSystem — Код системы налогообложения.
Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Серийные номера ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Серийные номера ¶

GET https://online.moysklad.ru/api/posap/1.0/entity/sn

Responses200

Успешный запрос. Результат — JSON представление списка серийных номеров.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn",
    "mediaType": "application/json",
    "size": 4,
    "limit": 100,
    "offsetId": "00000000-0000-0000-0000-000000000000",
    "direction": "forward"
  },
  "rows": [
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/dcb887fa-2ff8-11e7-8a84-bae500000005",
        "mediaType": "application/json",
        "type": "sn",
        "id": "dcb887fa-2ff8-11e7-8a84-bae500000005",
        "idType": "native"
      },
      "name": "12322678909292929292",
      "code": "123aa2c34eg566",
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/b7fb5459-2a83-11e7-9464-e4de00000026",
          "mediaType": "application/json",
          "type": "product",
          "id": "b7fb5459-2a83-11e7-9464-e4de00000026",
          "idType": "native"
        }
      }
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/dcb887fa-2ff8-11e7-8a84-bae500000005",
        "mediaType": "application/json",
        "type": "sn",
        "id": "dcb887fa-2ff8-11e7-8a84-bae500000005",
        "idType": "native"
      },
      "name": "12345678909292929292",
      "code": "12345678909292929292",
      "description": "Описание серийного номера",
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/bbc50755-2a83-11e7-9464-e4de0000002e",
          "mediaType": "application/json",
          "type": "product",
          "id": "bbc50755-2a83-11e7-9464-e4de0000002e",
          "idType": "native"
        }
      }
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/dcb887fa-2ff8-11e7-8a84-bae500000005",
        "mediaType": "application/json",
        "type": "sn",
        "id": "dcb887fa-2ff8-11e7-8a84-bae500000005",
        "idType": "native"
      },
      "name": "123456665556329292926",
      "code": "123456789092777629292",
      "description": "Серийный номер продукта",
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/bbc82552-2a83-11e7-9464-e4de00000032",
          "mediaType": "application/json",
          "type": "product",
          "id": "bbc82552-2a83-11e7-9464-e4de00000032",
          "idType": "native"
        }
      }
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/eb21663a-2b2b-11e7-9464-e4de0000002e",
        "mediaType": "application/json",
        "type": "sn",
        "id": "eb21663a-2b2b-11e7-9464-e4de0000002e",
        "idType": "native"
      },
      "name": "123",
      "code": "123",
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/syncid/73a83977-89c7-11e8-253d-a06100000004",
          "mediaType": "application/json",
          "type": "product",
          "id": "73a83977-89c7-11e8-253d-a06100000004",
          "idType": "sync"
        }
      }
    }
  ]
}

Получить Серийные номера

GET/entity/sn

Запрос на получение списка серийных номеров.

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • name — Имя Необходимое

  • code — Код

  • description — Описание

  • assortment — Ссылка на товар с серийным учётом, которому принадлежит серийный номер Необходимое

Операции со сменами ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Открыть смену ¶

PUT https://online.moysklad.ru/api/posap/1.0/rpc/openshift/

RequestsПример

Пример запроса на открытие смены.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
    }
  },
  "name": "0001",
  "openmoment": "2016-09-06 21:41:46",
  "cheque": {
    "start": {
      "fnNumber": "1234",
      "kktRegNumber": "5678",
      "fiscalDocSign": "9012",
      "shiftNumber": "3456",
      "fiscalDocNumber": "7890",
      "time": "2016-09-06 21:41:46"
    }
  }
}

Responses204

This response has no content.

Открыть смену

PUT/rpc/openshift/

Запрос на открытие смены, привязанной к точке продаж с указанным syncId и к указанному моменту времени.

Атрибуты запроса

  • retailShift — внешний уникальный идентификатор документа (meta с syncId). Необходимое

  • name — номер смены Необходимое

  • openmoment — дата открытия смены Необходимое

  • cheque — информация о смене

    • start — информация об открытии смены
      • fnNumber — номер ФН
      • kktRegNumber — регистрационный номер ККТ
      • fiscalDocSign — фискальный признак документа
      • shiftNumber — номер смены
      • fiscalDocNumber — номер фискального документа
      • time — дата и время открытия смены

Закрыть смену ¶

PUT https://online.moysklad.ru/api/posap/1.0/rpc/closeshift/

RequestsПример

Пример запроса на закрытие смены.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
    }
  },
  "closemoment": "2016-09-06 21:41:46",
  "retailDrawerCashout": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retaildrawercashout/syncid/388bd178-800c-11e6-8a84-bae5000000a4"
    }
  },
  "cheque": {
    "start": {
      "fnNumber": "1234",
      "kktRegNumber": "5678",
      "fiscalDocSign": "9012",
      "shiftNumber": "3456",
      "fiscalDocNumber": "7890",
      "time": "2016-09-06 20:41:46"
    },
    "end": {
      "fnNumber": "4321",
      "kktRegNumber": "0987",
      "fiscalDocSign": "6543",
      "shiftNumber": "2109",
      "chequesTotal": 15,
      "fiscalDocNumber": "8765",
      "fiscalDocsTotal": 17,
      "time": "2017-09-06 21:41:46"
    }
  }
}

Responses204

This response has no content.

Закрыть смену

PUT/rpc/closeshift/

Атрибуты запроса

  • retailShift — внешний уникальный идентификатор документа (meta с syncId). Указанная смена должна существовать и быть открытой Необходимое

  • closemoment — дата закрытия смены Необходимое

  • retailDrawerCashout — внешний уникальный идентификатор выплаты (meta с syncId). Если присутствует ссылка на выплату, сумма выплаты больше 0 и в настройках точки продаж
    стоит флаг “Создавать ПКО при закрытии смены”, то при закрытии смены будет создаваться связанный ПКО.

  • cheque — информация о смене

    • start — информация об открытии смены
      • fnNumber — номер ФН
      • kktRegNumber — регистрационный номер ККТ
      • fiscalDocSign — фискальный признак документа
      • shiftNumber — номер смены
      • fiscalDocNumber — номер фискального документа
      • time — дата и время открытия смены
    • end — информация о закрытии смены
      • fnNumber — номер ФН
      • kktRegNumber — регистрационный номер ККТ
      • fiscalDocSign — фискальный признак документа
      • shiftNumber — номер смены
      • fiscalDocNumber — номер фискального документа
      • chequesTotal — количество чеков за смену
      • fiscalDocsTotal — количество фискальных документов за смену
      • time — дата и время закрытия смены

Расчет скидок для продажи и возврата ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Расчет скидок и бонусов ¶

POST https://online.moysklad.ru/api/posap/1.0/rpc/retaildemand/recalc

RequestsПример 1

Пример расчета для новой розничной продажи с начислением бонусов.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "agent": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/1c5dcf6f-7b32-11e6-8a84-bae500000000",
      "mediaType": "application/json",
      "type": "counterparty",
      "id": "1c5dcf6f-7b32-11e6-8a84-bae500000000",
      "idType": "native"
    }
  },
  "transactionType": "EARNING",
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/7db30ee8-07c5-11e7-90a5-ba9c0000008b",
          "mediaType": "application/json",
          "type": "product",
          "id": "7db30ee8-07c5-11e7-90a5-ba9c0000008b",
          "idType": "native"
        }
      },
      "sn": [
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/bb89b2b1-07c7-11e7-90a5-ba9c000000a5",
            "mediaType": "application/json",
            "type": "sn",
            "id": "bb89b2b1-07c7-11e7-90a5-ba9c000000a5",
            "idType": "native"
          }
        }
      ],
      "quantity": 10,
      "price": 200,
      "pack": {
        "id": "5ae9e6b5-7b95-11e9-ac12-000b000000ac",
        "name": "ящ",
        "quantity": 10,
        "barcode": "2000000000016"
      }
    },
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/service/bb89b2b1-07c7-11e7-90a5-ba9c000000a4",
          "mediaType": "application/json",
          "type": "service",
          "id": "bb89b2b1-07c7-11e7-90a5-ba9c000000a4",
          "idType": "native"
        }
      },
      "quantity": 2.33,
      "price": 300
    },
    {
      "assortment": {
        "meta": {
          "href": "http://localhost/api/posap/1.0/entity/product/ace86997-6113-11e9-ac13-000c000000c9",
          "mediaType": "application/json",
          "type": "product",
          "id": "ace86997-6113-11e9-ac13-000c000000c9",
          "idType": "native"
        }
      },
      "quantity": 1,
      "price": 200
    },
    {
      "assortment": {
        "meta": {
          "href": "http://localhost/api/posap/1.0/entity/product/c1d3dacb-6113-11e9-ac13-000c000000d2",
          "mediaType": "application/json",
          "type": "product",
          "id": "c1d3dacb-6113-11e9-ac13-000c000000d2",
          "idType": "native"
        }
      },
      "quantity": 2,
      "price": 150
    }
  ]
}

Responses200

BodyСкрытьПоказать

{
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/service/bb89b2b1-07c7-11e7-90a5-ba9c000000a4",
          "mediaType": "application/json",
          "type": "service",
          "id": "bb89b2b1-07c7-11e7-90a5-ba9c000000a4",
          "idType": "native"
        },
        "image": {
          "href": "https://online.moysklad.ru/api/posap/1.0/download/64aab630-07c7-11e7-90a5-ba9c0000002c",
          "miniature": "https://online.moysklad.ru/api/posap/1.0/download/64aab630-07c7-11e7-90a5-ba9c0000002c?miniature=true",
          "tiny": "https://online.moysklad.ru/static/75651645-07c5-11e7-90a5-ba9c00000006/TinyImage/64aaa5a2-07c7-11e7-90a5-ba9c0000002b.png"
        },
        "name": "Имя товара1",
        "code": "код",
        "barcodes": [
          "9031101"
        ],
        "vat": 10,
        "uom": "ед. измерения",
        "article": "артикул",
        "soldByWeight": false,
        "onTap": false,
        "tobacco": false,
        "serialtrackable": false,
        "trackingType": "NOT_TRACKED"
      },
      "sn": [
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/bb89b2b1-07c7-11e7-90a5-ba9c000000a5",
            "mediaType": "application/json",
            "type": "sn",
            "id": "bb89b2b1-07c7-11e7-90a5-ba9c000000a5",
            "idType": "native"
          },
          "name": "Сер. номер#1"
        }
      ],
      "quantity": 10,
      "price": 100,
      "discountedPrice": 80,
      "pack": {
        "id": "5ae9e6b5-7b95-11e9-ac12-000b000000ac",
        "name": "ящ",
        "quantity": 10,
        "barcode": "2000000000016"
      }
    },
    {
      "assortment": {
        "meta": {
          "href": "http://localhost/api/posap/1.0/entity/product/ace86997-6113-11e9-ac13-000c000000c9",
          "mediaType": "application/json",
          "type": "product",
          "id": "ace86997-6113-11e9-ac13-000c000000c9",
          "idType": "native"
        },
        "name": "shoes",
        "code": "00002",
        "barcodes": [
          "2000000000022"
        ],
        "uom": "шт",
        "soldByWeight": false,
        "onTap": false,
        "tobacco": false,
        "trackingType": "SHOES",
        "isSerialTrackable": false,
        "partialDisposal": false
      },
      "quantity": 1,
      "price": 200,
      "discountedPrice": 200
    },
    {
      "assortment": {
        "meta": {
          "href": "http://localhost/api/posap/1.0/entity/product/c1d3dacb-6113-11e9-ac13-000c000000d2",
          "mediaType": "application/json",
          "type": "product",
          "id": "c1d3dacb-6113-11e9-ac13-000c000000d2",
          "idType": "native"
        },
        "name": "tobacco",
        "code": "00003",
        "barcodes": [
          "2000000000039"
        ],
        "uom": "шт",
        "soldByWeight": false,
        "onTap": false,
        "tobacco": true,
        "trackingType": "TOBACCO",
        "isSerialTrackable": false,
        "partialDisposal": false
      },
      "quantity": 2,
      "price": 150,
      "discountedPrice": 150
    }
  ],
  "bonusProgram": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/bonusprogram/00000000-07c7-11e7-90a5-ba9c0000002c",
      "mediaType": "application/json",
      "type": "bonusprogram",
      "id": "00000000-07c7-11e7-90a5-ba9c0000002c",
      "idType": "native"
    }
  },
  "receiptExtraInfo": "Текстnотnбонусов",
  "agentBonusBalance": 100,
  "bonusValueToEarn": 8,
  "bonusValueToSpend": 20,
  "chequeSumWithoutDiscount": 600,
  "valueToPay": 580,
  "paidByDiscountWithoutBonus": 0,
  "paidWithBonusPoints": 20
}

Рассчитать скидки и бонусы для продажи

POST/rpc/retaildemand/recalc

Запрос на расчет скидок и бонусов для новой розничной продажи.

Атрибуты запроса

  • agent — метаданные контрагента продажи

  • transactionType — тип операции с бонусными баллами: начисление(EARNING) или списание(SPENDING). Необходимое

  • preferredBonusToSpend — Количество бонусных баллов для списания.
    Целое положительное число больше 0.
    Если передано значение, неприменимое к данной операции, количество баллов для списания будет рассчитано,
    как максимально доступное для контрагента.

  • positions — позиции розничной продажи/возврата Необходимое

    • assortment — метаданные товара/модификации/услуги/комплекта Необходимое
    • quantity — количество реализуемого товара, должно быть больше нуля Необходимое
    • price — цена Необходимое
    • sn — Для товаров Массив серийных номеров. Необходимо указывать только при учёте товара по серийным номерам.
      • meta — Общее метаданные серийного номера товара Необходимое
    • pack — Упаковка
      • id — id сущности упаковки Необходимое
      • name — Название упаковки Необходимое
      • quantity — Количество товаров в упаковке Необходимое
      • barcode — Штрихкод упаковки

  • bonusProgram — метаданные активной бонусной программы Необходимое

  • receiptExtraInfo — текст для вывода в чеке

  • agentBonusBalance — Баланс контрагента по активной бонусной программе ДО совершения операции Необходимое

  • bonusValueToEarn — Количество баллов которое будет начислено этой операцией Необходимое

  • bonusValueToSpend — Количество баллов которое будет списано этой операцией Необходимое

  • chequeSumWithoutDiscount — Сумма для уплаты без учета скидок Необходимое

  • paidByDiscountWithoutBonus — Сумма, оплаченная скидками, без учета бонусной программы Необходимое

  • paidWithBonusPoints — Сумма, оплаченная из бонусных баллов Необходимое

  • valueToPay — Сумма для уплаты с учетом скидок Необходимое

  • positions — позиции розничной продажи/возврата в порядке соответствующем запросу Необходимое

    • quantity — количество Необходимое
    • price — цена Необходимое
    • discountedPrice — цена после применения всех скидок Необходимое
    • assortment — даные товара/модификации/услуги/комплекта Необходимое
      • meta — Общее метаданные товара/модификации/услуги/комплекта Необходимое
      • name — Общее Наименование объекта Необходимое
      • code — Общее Код сущности
      • barcodes — Общее Массив штрихкодов сущности
      • uom — Общее Единица измерения товара (строка)
      • vat — Общее НДС
      • article — Для товаров и комплектов Артикул товара
      • soldByWeight — Для товаров Весовой товар
        • onTap — Для товаров Разливной товар
      • isSerialTrackable — Для товаров учёт по серийным номерам Необходимое
      • tobacco — Для товаров Табачная продукция. Не может быть указан вместе с egaisIsAlcoholic, soldByWeight и isSerialtrackable

      • trackingType — Тип маркируемой продукции

        • NOT_TRACKED — Без маркировки
        • TOBACCO — Тип маркировки “Табак”
        • SHOES — Тип маркировки “Обувь”
        • LP_CLOTHES — Тип маркировки “Одежда”
        • LP_LINENS — Тип маркировки “Постельное белье”
        • PERFUMERY — Тип маркировки “Духи и туалетная вода”
        • ELECTRONICS — Тип маркировки “Фотокамеры и лампы-вспышки”
        • TIRES — Тип маркировки “Шины и покрышки”
        • MILK — Тип маркировки “Молочная продукция”
        • WATER — Тип маркировки “Упакованная вода”
        • OTP — Тип маркировки “Альтернативная табачная продукция”
        • NCP — Тип маркировки “Никотиносодержащая продукция”

      • tnved — Код ТН ВЭД

      • partialDisposal — Флаг частичного выбытия

      • paymentItemType — Признак предмета расчета

        • GOOD — Товар (Товар/Комплект)
        • SERVICE — Услуга (Услуга)
        • EXCISABLE_GOOD — Подакцизный товар (Товар/Комплект)
        • WORK — Работа (Услуга)
        • PROVIDING_RID — Предоставление РИД (Услуга)
        • COMPOUND_PAYMENT_ITEM — Составной предмет расчета (Товар/Комплект/Услуга)
        • ANOTHER_PAYMENT_ITEM — Иной предмет расчета (Товар/Комплект/Услуга)
      • image — Для товаров и комплектов Изображение товара (объект)
        • href — Ссылка на изображение
        • miniature — Ссылка на миниатюру изображения
        • tiny — Ссылка на уменьшенную версию изображения
      • components — Для комплектов Компоненты комплекта, это список товаров/услуг/модификаций, который входят в состав комплекта. Компонентов у комплекта может быть от 1 до 10. Необходимое
        • meta — Метаданные сущности Необходимое
        • quantity — количество компонентов в комплекте.
    • sn — Для товаров Массив серийных номеров. Необходимо указывать только при учёте товара по серийным номерам.
      • meta — метаданные серийного номера товара Необходимое
      • name — Наименование серийного номера
    • pack — Упаковка
      • id — id сущности упаковки Необходимое
      • name — Название упаковки Необходимое
      • quantity — Количество товаров в упаковке Необходимое
      • barcode — Штрихкод упаковки

Продажи ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Продажи в смене ¶

POST https://online.moysklad.ru/api/posap/1.0/entity/retaildemand

RequestsПример 1

Пример создания новой розничной продажи.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retaildemand/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
  },
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "name": "000219991",
  "moment": "2016-09-06 21:41:46",
  "description": "размен",
  "agent": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/688bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/81fdf852-7c21-11e6-8a84-bae500000068",
          "mediaType": "application/json"
        }
      },
      "quantity": 2,
      "price": 500,
      "discount": 10,
      "vat": 10,
      "sum": 1000,
      "pdf": [
        "abc",
        "def"
      ],
      "marks": [
        {
          "cis": "12345678900987ABCDEFGabcdefgh"
        },
        {
          "cis": "00000046185372KY4mjNZAB=U/FkO"
        }
      ]
    },
    {
      "quantity": 3,
      "price": 400,
      "discount": 10,
      "vat": 10,
      "sum": 800,
      "sn": [
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/f085d67e-6eae-11e6-8a84-bc520403352a",
            "mediaType": "application/json"
          }
        },
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/f085d67e-6eae-11e6-8a84-bc520403352b",
            "mediaType": "application/json"
          }
        },
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/f085d67e-6eae-11e6-8a84-bc520403352d",
            "mediaType": "application/json"
          }
        }
      ],
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/syncid/f085d67e-6eae-11e6-8a84-bc520403352c"
        }
      }
    }
  ],
  "cashSum": 800,
  "noCashSum": 100,
  "qrSum": 0,
  "vatEnabled": true,
  "vatIncluded": true,
  "bottleUrl": "https://check.egais.ru?id=a9e56cb9-21d6-4404-9f24-668020fadf6a&amp;dt=0910141104&amp;cn=Magazin2014",
  "bottleSign": "418E6A105B60250CEB20F9F9A556FA4A9575B0C07EC536DE89CA868C884E296E56BA7EC7762C9BEC285CB4D8CD90EEE9F9FC16F92CCF324829E70862F0DFEC1B418E6A105B60250CEB20F9F9A556FA4A9575B0C07EC536DE89CA868C884E296E56BA7EC7762C9BEC285CB4D8CD90EEE9F9FC16F92CCF324829E70862F0DFEC1B",
  "cheque": {
    "fiscal": true,
    "online": true,
    "printed": true,
    "phone": "89992223311",
    "email": "1@m.com",
    "number": "4165132132",
    "sum": 123.6,
    "fnNumber": "1223334444",
    "fiscalDocSign": "111222333",
    "fiscalDocNumber": "1234567",
    "time": "2016-09-06 21:41:46"
  },
  "environment": {
    "os": "Linux",
    "device": "Some device name",
    "software": {
      "name": "Касса МойСклад",
      "vendor": "МойСклад",
      "version": "2.2"
    },
    "chequePrinter": {
      "vendor": "АТОЛ",
      "name": "30Ф",
      "serial": "15636313",
      "fiscalDataVersion": "1.0",
      "driver": {
        "name": "АТОЛ (бета)",
        "version": "9.1"
      },
      "fiscalMemory": {
        "fiscalDataVersion": "1.0"
      },
      "firmwareVersion": "669"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "cardTransaction": {
    "pan": "547127******8519",
    "transactionId": "5abce3f3c0ffdc014f1040de",
    "authCode": "889872",
    "rrnCode": "000010000467",
    "amount": 8600,
    "acquiringType": "Inpas",
    "approvalNumber": "055747",
    "description": "платеж картой n-Банка"
  },
  "customerOrder": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/customerorder/7c1b81ab-5a9d-11e8-7a31-ca1400000027",
      "mediaType": "application/json",
      "type": "customerorder",
      "id": "7c1b81ab-5a9d-11e8-7a31-ca1400000027",
      "idType": "native"
    }
  },
  "bonusProgram": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/bonusprogram/7c1b81ab-5a9d-11e8-7a31-ca1400000026",
      "mediaType": "application/json",
      "type": "bonusprogram",
      "id": "7c1b81ab-5a9d-11e8-7a31-ca1400000026",
      "idType": "native"
    }
  },
  "bonusValueToEarn": 0,
  "bonusValueToSpend": 0,
  "prepaymentCash": 123,
  "prepaymentNoCash": 222,
  "prepaymentQrSum": 0
}

Responses201

This response has no content.

Создать продажу в смене

POST/entity/retaildemand

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

Атрибуты запроса

  • meta — внешний уникальный идентификатор документа в формате метаданных (meta с syncId) Необходимое

  • retailShift — ссылка на смену (meta с syncId). Необходимое

  • name — Номер розничной продажи Необходимое

  • moment — Дата и время розничной продажи Необходимое

  • description — Комментарий

  • owner — Владелец (Сотрудник)

  • agent — Покупатель ссылка на контрагента в формате метаданных

  • positions — позиции розничной продажи Необходимое

    • assortment — позиция документа, ссылка на товар/модификацию/услугу/комплект в формате метаданных Необходимое
    • quantity — количество реализуемого товара, должно быть положительным Необходимое
    • price — цена Необходимое
    • discount — процент скидки
    • vat — процент НДС
    • vatEnabled — включен ли НДС для позиции. С помощью этого флага для позиции можно выставлять НДС = 0 или НДС = “без НДС”. (vat = 0, vatEnabled = false) -> vat = “без НДС”, (vat = 0, vatEnabled = true) -> vat = 0%
    • pdf — массив PDF-417 для алкогольных товаров
    • sn — коллекция уникальных идентификаторов серийных номеров в формате метаданных.
      Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете.
      В ином случае количество товаров в позиции (quantity) должно быть равно количеству серийных номеров, переданных в значении атрибута.
    • pack — Упаковка
      • id — id сущности упаковки Необходимое
      • name — Название упаковки Необходимое
      • quantity — Количество товаров в упаковке Необходимое
      • barcode — Штрихкод упаковки
    • marks — массив кодов маркировки

  • cashSum — Оплачено наличными

  • noCashSum — Оплачено картой

  • qrSum — оплачено по QR-коду

  • vatEnabled — флаг, указывающий, что документ содержит НДС

  • vatIncluded — флаг, указывающий, включен ли НДС в цену (по умолчанию включен)

  • bottleUrl — подпись ЕГАИС

  • bottleSign — URL чека ЕГАИС

  • customerOrder — Ссылка на заказ покупателя (meta)

  • environment — информация об окружении

    • device — информация об устройстве
    • os — информация об операционной системе
    • software — информация о ПО
      • name — наименование ПО Необходимое при передаче software
      • vendor — производитель
      • version — версия ПО
    • chequePrinter — данные о ККТ
      • vendor — производитель
      • name — наименование Необходимое при передаче chequePrinter
      • serial — серийный номер
      • fiscalDataVersion — формат фискальных данных
      • driver — информация об используемом драйвере
        • name — наименование драйвера
        • version — версия драйвера
      • fiscalMemory — информация о фискальном накопителе
        • fiscalDataVersion — версия фискальной памяти
      • firmwareVersion — Версия прошивки ККТ
    • paymentTerminal — информация о платежном терминале
      • acquiringType — информация о типе эквайера (например: inpas/payme)

  • cheque — информация о чеке

    • fiscal — отметка о том, был ли использован ФР
    • online — признак электронного чека
    • printed — признак бумажного чека
    • phone — номер телефона, на который высылается электронный чек
    • email — адрес электронной почты, на который высылается электронный чек
    • number — номер чека
    • sum — сумма чека
    • fnNumber — номер ФН
    • fiscalDocSign — Фискальный признак документа
    • fiscalDocNumber — Номер фискального документа
    • time — время фискализации

  • cardTransaction — информация о транзакции в случае оплаты картой

    • pan — номер банковской карты
    • transactionId — id транзакции
    • authCode — inpas код аутентификации
    • rrnCode — Номер ссылки (RRN)
    • amount — сумма Необходимое
    • acquiringType — информация о типе эквайера (например: inpas/payme) Необходимое
    • approvalNumber — inpas/payme номер операции (код подтверждения)
    • description — комментарий

  • qrTransaction — информация о транзакции в случае оплаты по QR-коду

    • transactionId — id транзакции
    • externalOperationId — id заказа в системе банка
    • authCode — код авторизации транзакции
    • acquiringType — название API, через которое была проведена оплата

  • bonusProgram — Бонусная программа, ссылка в формате метаданных

  • bonusValueToEarn — Количество бонусных балов к зачислению

  • bonusValueToSpend — Количество бонусных балов к списанию

  • prepaymentCash — Предоплата нал

  • prepaymentNoCash — Предоплата безнал

  • prepaymentQrSum — предоплата по QR-коду

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Возможна привязка заказа к Розничной продаже при создании продажи. Связь передается в объекте customerOrder (meta) при создании продажи.

Если поле vatEnabled=true, а поле vatIncluded=false, то НДС не входит в цену и ее надо считать.

Возвраты ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Возвраты в смене ¶

POST https://online.moysklad.ru/api/posap/1.0/entity/retailsalesreturn

RequestsПример 1

Пример создания нового Розничного возврата.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailsalesreturn/syncid/388bd178-800c-11e6-8a84-bae5000000a3"
  },
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "demand": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retaildemand/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
    }
  },
  "name": "0002199921",
  "moment": "2016-09-06 21:42:46",
  "description": "возврат размена",
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/81fdf852-7c21-11e6-8a84-bae500000068",
          "mediaType": "application/json"
        }
      },
      "quantity": 2,
      "price": 500,
      "discount": 10,
      "vat": 10,
      "sum": 1000,
      "pdf": [
        "abc",
        "def"
      ],
      "marks": [
        {
          "cis": "12345678900987ABCDEFGabcdefgh"
        },
        {
          "cis": "00000046185372KY4mjNZAB=U/FkO"
        }
      ]
    },
    {
      "quantity": 3,
      "price": 400,
      "discount": 10,
      "vat": 10,
      "sum": 800,
      "sn": [
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/f085d67e-6eae-11e6-8a84-bc520403352a",
            "mediaType": "application/json"
          }
        },
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/f085d67e-6eae-11e6-8a84-bc520403352b",
            "mediaType": "application/json"
          }
        },
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/f085d67e-6eae-11e6-8a84-bc520403352d",
            "mediaType": "application/json"
          }
        }
      ],
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/syncid/f085d67e-6eae-11e6-8a84-bc520403352c"
        }
      }
    }
  ],
  "cashSum": 800,
  "noCashSum": 100,
  "qrSum": 0,
  "vatEnabled": true,
  "vatIncluded": true,
  "bottleUrl": "https://check.egais.ru?id=a9e56cb9-21d6-4404-9f24-668020fadf6a&amp;dt=0910141104&amp;cn=Magazin2014",
  "bottleSign": "418E6A105B60250CEB20F9F9A556FA4A9575B0C07EC536DE89CA868C884E296E56BA7EC7762C9BEC285CB4D8CD90EEE9F9FC16F92CCF324829E70862F0DFEC1B418E6A105B60250CEB20F9F9A556FA4A9575B0C07EC536DE89CA868C884E296E56BA7EC7762C9BEC285CB4D8CD90EEE9F9FC16F92CCF324829E70862F0DFEC1B",
  "cheque": {
    "fiscal": true,
    "online": true,
    "printed": true,
    "phone": "89992223311",
    "email": "1@m.com",
    "number": "4165132132",
    "sum": 123.6,
    "fnNumber": "1223334444",
    "fiscalDocSign": "111222333",
    "fiscalDocNumber": "1234567",
    "time": "2016-09-06 21:41:46"
  },
  "environment": {
    "os": "Linux",
    "device": "Some device name",
    "software": {
      "name": "Касса МойСклад",
      "vendor": "МойСклад",
      "version": "2.2"
    },
    "chequePrinter": {
      "vendor": "АТОЛ",
      "name": "30Ф",
      "serial": "15636313",
      "fiscalDataVersion": "1.0",
      "driver": {
        "name": "АТОЛ (бета)",
        "version": "9.1"
      },
      "fiscalMemory": {
        "fiscalDataVersion": "1.0"
      },
      "firmwareVersion": "669"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "cardTransaction": {
    "pan": "547127******8519",
    "transactionId": "5abce3f3c0ffdc014f1040de",
    "authCode": "889872",
    "rrnCode": "000010000467",
    "amount": 8600,
    "acquiringType": "Inpas",
    "approvalNumber": "055747",
    "description": "платеж картой n-Банка"
  }
}

Responses201

This response has no content.

Создать возврат в смене

POST/entity/retailsalesreturn

Атрибуты запроса

  • meta — внешний уникальный идентификатор документа в формате метаданных (meta с syncId) Необходимое

  • retailShift — ссылка на смену (meta с syncId). Необходимое

  • demand — Ссылка на розничную продажу в формате метаданных

  • name — Номер розничного возврата Необходимое

  • moment — Дата и время розничного возврата Необходимое

  • description — Комментарий

  • positions — позиции розничного возврата Необходимое

    • assortment — позиция документа, ссылка на товар/модификацию/услугу/комплект в формате метаданных Необходимое
    • quantity — количество реализуемого товара, должно быть положительным Необходимое
    • price — цена Необходимое
    • discount — процент скидки (поле игнорируется для возврата без основания)
    • vat — процент НДС
    • vatEnabled — включен ли НДС для позиции. С помощью этого флага для позиции можно выставлять НДС = 0 или НДС = “без НДС”. (vat = 0, vatEnabled = false) -> vat = “без НДС”, (vat = 0, vatEnabled = true) -> vat = 0%
    • pdf — массив PDF-417 для алкогольных товаров
    • sn — коллекция уникальных идентификаторов серийных номеров в формате метаданных.
      Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете.
      В ином случае количество товаров в позиции (quantity) должно быть равно количеству серийных номеров, переданных в значении атрибута.
    • pack — Упаковка
      • id — id сущности упаковки Необходимое
      • name — Название упаковки Необходимое
      • quantity — Количество товаров в упаковке Необходимое
      • barcode — Штрихкод упаковки
      • marks — массив кодов маркировки

  • cashSum — Оплачено наличными

  • noCashSum — Оплачено картой

  • qrSum — оплачено по QR-коду

  • vatEnabled — флаг, указывающий, что документ содержит НДС

  • vatIncluded — флаг, указывающий, включен ли НДС в цену (по умолчанию включен)

  • bottleUrl — подпись ЕГАИС

  • bottleSign — URL чека ЕГАИС

  • environment — информация об окружении

    • device — информация об устройстве
    • os — информация об операционной системе
    • software — информация о ПО
      • name — наименование ПО Необходимое при передаче software
      • vendor — производитель
      • version — версия ПО
    • chequePrinter — данные о ККТ
      • vendor — производитель
      • name — наименование Необходимое при передаче chequePrinter
      • serial — серийный номер
      • fiscalDataVersion — формат фискальных данных
      • driver — информация об используемом драйвере
        • name — наименование драйвера
        • version — версия драйвера
      • fiscalMemory — информация о фискальном накопителе
        • fiscalDataVersion — версия фискальной памяти
      • firmwareVersion — Версия прошивки ККТ
    • paymentTerminal — информация о платежном терминале
      • acquiringType — информация о типе эквайера (например: inpas/payme)

  • cheque — информация о чеке

    • fiscal — отметка о том, был ли использован ФР
    • online — признак электронного чека
    • printed — признак бумажного чека
    • phone — номер телефона, на который высылается электронный чек
    • email — адрес электронной почты, на который высылается электронный чек
    • number — номер чека
    • sum — сумма чека
    • fnNumber — номер ФН
    • fiscalDocSign — Фискальный признак документа
    • fiscalDocNumber — Номер фискального документа
    • time — время фискализации

  • cardTransaction — информация о транзакции в случае оплаты картой

    • pan — номер банковской карты
    • transactionId — id транзакции
    • authCode — inpas код аутентификации
    • rrnCode — Номер ссылки (RRN)
    • amount — сумма Необходимое
    • acquiringType — информация о типе эквайера (например: inpas/payme) Необходимое
    • approvalNumber — inpas/payme номер операции (код подтверждения)
    • description — комментарий

  • qrTransaction — информация о транзакции в случае оплаты по QR-коду

    • transactionId — id транзакции
    • externalOperationId — id заказа в системе банка
    • authCode — код авторизации транзакции
    • acquiringType — название API, через которое была проведена оплата

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Если поле vatEnabled=true, а поле vatIncluded=false, то НДС не входит в цену и ее надо считать.

Внесение денег ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Внесение денег ¶

POST https://online.moysklad.ru/api/posap/1.0/entity/retaildrawercashin/

RequestsПример 1

Пример создания нового внесения денег.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retaildrawercashin/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
  },
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "name": "000012",
  "moment": "2016-03-16 19:41:19",
  "sum": 7500,
  "description": "Внесение денег в денежный ящик"
}

Responses201

This response has no content.

Создать внесение денег

POST/entity/retaildrawercashin/

Запрос на создание внесения денег.

Атрибуты запроса

  • meta — внешний уникальный идентификатор документа в формате метаданных (meta с syncId) Необходимое

  • retailShift — ссылка на смену в формате метаданных. Необходимое

  • name — Номер внесения денег Необходимое

  • moment — Дата внесения денег Необходимое

  • description — Комментарий

  • sum — Сумма внесения денег Необходимое

Выплата денег ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Выплата денег ¶

POST https://online.moysklad.ru/api/posap/1.0/entity/retaildrawercashout/

RequestsПример 1

Пример создания новой выплаты денег.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retaildrawercashout/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
  },
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "name": "0020012",
  "moment": "2016-04-16 19:41:19",
  "sum": 73500,
  "description": "Выплата денег из денежного ящика"
}

Responses201

This response has no content.

Создать выплату денег

POST/entity/retaildrawercashout/

Запрос на создание выплаты денег.

Атрибуты запроса

  • meta — внешний уникальный идентификатор документа в формате метаданных (meta с syncId) Необходимое

  • retailShift — ссылка на смену в формате метаданных. Необходимое

  • name — Номер выплаты денег Необходимое

  • moment — Дата выплаты денег Необходимое

  • description — Комментарий

  • sum — Сумма выплаты денег Необходимое

Предоплаты ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Предоплаты ¶

POST https://online.moysklad.ru/api/posap/1.0/entity/prepayment

RequestsПример 1

Пример создания новой предоплаты.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/prepayment/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
  },
  "name": "000219991",
  "description": "предоплата по заказу из интернет-магазин",
  "moment": "2016-09-06 21:41:46",
  "sum": 250000,
  "agent": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/688bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/81fdf852-7c21-11e6-8a84-bae500000068",
          "mediaType": "application/json"
        }
      },
      "quantity": 2,
      "price": 500,
      "discount": 10,
      "vat": 10
    },
    {
      "quantity": 3,
      "price": 400,
      "discount": 10,
      "vat": 10,
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/syncid/f085d67e-6eae-11e6-8a84-bc520403352c"
        }
      }
    }
  ],
  "vatEnabled": true,
  "vatIncluded": true,
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "customerOrder": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/customerorder/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "cashSum": 125000,
  "noCashSum": 125000,
  "qrSum": 0,
  "cheque": {
    "fiscal": true,
    "online": true,
    "printed": true,
    "phone": "89992223311",
    "email": "1@m.com",
    "number": "4165132132",
    "sum": 123.6,
    "fnNumber": "1223334444",
    "fiscalDocSign": "111222333",
    "fiscalDocNumber": "1234567",
    "time": "2016-09-06 21:41:46"
  },
  "environment": {
    "os": "Linux",
    "device": "Some device name",
    "software": {
      "name": "Касса МойСклад",
      "vendor": "МойСклад",
      "version": "2.2"
    },
    "chequePrinter": {
      "vendor": "АТОЛ",
      "name": "30Ф",
      "serial": "15636313",
      "fiscalDataVersion": "1.0",
      "driver": {
        "name": "АТОЛ (бета)",
        "version": "9.1"
      },
      "fiscalMemory": {
        "fiscalDataVersion": "1.0"
      },
      "firmwareVersion": "669"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "cardTransaction": {
    "pan": "547127******8519",
    "transactionId": "5abce3f3c0ffdc014f1040de",
    "authCode": "889872",
    "rrnCode": "000010000467",
    "amount": 8600,
    "acquiringType": "Inpas",
    "approvalNumber": "055747",
    "description": "платеж картой n-Банка"
  }
}

Responses201

This response has no content.

Создать предоплату

POST/entity/prepayment

Запрос на создание новой предоплаты по заказу в рамках смены с указанным id.

Атрибуты запроса

  • meta — внешний уникальный идентификатор документа в формате метаданных (meta с syncId) Необходимое

  • id — id сущности в сервисе

  • name — Номер предоплаты Необходимое

  • description — Комментарий

  • moment — Дата и время предоплаты

  • sum — Итоговая сумма предоплаты. Равна сумме нал + безнал.

  • agent — Покупатель ссылка на контрагента в формате метаданных

  • positions — позиции предоплаты Необходимое

    • assortment — позиция документа, ссылка на товар/модификацию/услугу/комплект в формате метаданных Необходимое
    • quantity — количество реализуемого товара, должно быть положительным Необходимое
    • price — цена Необходимое
    • discount — процент скидки
    • vat — процент НДС
    • vatEnabled — включен ли НДС для позиции. С помощью этого флага для позиции можно выставлять НДС = 0 или НДС = “без НДС”. (vat = 0, vatEnabled = false) -> vat = “без НДС”, (vat = 0, vatEnabled = true) -> vat = 0%

  • vatEnabled — флаг, указывающий, что документ содержит НДС

  • vatIncluded — флаг, указывающий, включен ли НДС в цену (по умолчанию включен)

  • vatIncluded — Цена включает НДС

  • vatSum — Сумма НДС

  • retailStore — ссылка на точку продаж (meta с syncId).

  • retailShift — ссылка на смену (meta с syncId). Необходимое

  • cashier — ссылка на кассира в формате метаданных.

  • customerOrder — ссылка на заказ, по которому производится предоплата в формате метаданных. Необходимое

  • cashSum — Оплачено наличными

  • noCashSum — Оплачено картой

  • qrSum — оплачено по QR-коду

  • environment — информация об окружении

    • device — информация об устройстве
    • os — информация об операционной системе
    • software — информация о ПО
      • name — наименование ПО Необходимое при передаче software
      • vendor — производитель
      • version — версия ПО
    • chequePrinter — данные о ККТ
      • vendor — производитель
      • name — наименование Необходимое при передаче chequePrinter
      • serial — серийный номер
      • fiscalDataVersion — формат фискальных данных
      • driver — информация об используемом драйвере
        • name — наименование драйвера
        • version — версия драйвера
      • fiscalMemory — информация о фискальном накопителе
        • fiscalDataVersion — версия фискальной памяти
      • firmwareVersion — Версия прошивки ККТ
    • paymentTerminal — информация о платежном терминале
      • acquiringType — информация о типе эквайера (например: inpas/payme)

  • cheque — информация о чеке

    • fiscal — отметка о том, был ли использован ФР
    • online — признак электронного чека
    • printed — признак бумажного чека
    • phone — номер телефона, на который высылается электронный чек
    • email — адрес электронной почты, на который высылается электронный чек
    • number — номер чека
    • sum — сумма чека
    • fnNumber — номер ФН
    • fiscalDocSign — Фискальный признак документа
    • fiscalDocNumber — Номер фискального документа
    • time — время фискализации

  • cardTransaction — информация о транзакции в случае оплаты картой

    • pan — номер банковской карты
    • transactionId — id транзакции
    • authCode — inpas код аутентификации
    • rrnCode — Номер ссылки (RRN)
    • amount — сумма Необходимое
    • acquiringType — информация о типе эквайера (например: inpas/payme) Необходимое
    • approvalNumber — inpas/payme номер операции (код подтверждения)
    • description — комментарий

  • qrTransaction — информация о транзакции в случае оплаты по QR-коду

    • transactionId — id транзакции
    • externalOperationId — id заказа в системе банка
    • authCode — код авторизации транзакции
    • acquiringType — название API, через которое была проведена оплата

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Если поле vatEnabled=true, а поле vatIncluded=false, то НДС не входит в цену и ее надо считать.

Возвраты предоплат ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Возвраты предоплат ¶

POST https://online.moysklad.ru/api/posap/1.0/entity/prepaymentreturn

RequestsПример 1

Пример создания нового возврата предоплаты.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/prepaymentreturn/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
  },
  "name": "000219991",
  "description": "возврат предоплаты",
  "moment": "2016-09-06 21:41:46",
  "sum": 250000,
  "agent": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/688bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/81fdf852-7c21-11e6-8a84-bae500000068",
          "mediaType": "application/json"
        }
      },
      "quantity": 2,
      "price": 500,
      "discount": 10,
      "vat": 10
    },
    {
      "quantity": 3,
      "price": 400,
      "discount": 10,
      "vat": 10,
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/syncid/f085d67e-6eae-11e6-8a84-bc520403352c"
        }
      }
    }
  ],
  "vatEnabled": true,
  "vatIncluded": true,
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "prepayment": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/prepayment/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "cashSum": 125000,
  "noCashSum": 125000,
  "qrSum": 0,
  "cheque": {
    "fiscal": true,
    "online": true,
    "printed": true,
    "phone": "89992223311",
    "email": "1@m.com",
    "number": "4165132132",
    "sum": 123.6,
    "fnNumber": "1223334444",
    "fiscalDocSign": "111222333",
    "fiscalDocNumber": "1234567",
    "time": "2016-09-06 21:41:46"
  },
  "environment": {
    "os": "Linux",
    "device": "Some device name",
    "software": {
      "name": "Касса МойСклад",
      "vendor": "МойСклад",
      "version": "2.2"
    },
    "chequePrinter": {
      "vendor": "АТОЛ",
      "name": "30Ф",
      "serial": "15636313",
      "fiscalDataVersion": "1.0",
      "driver": {
        "name": "АТОЛ (бета)",
        "version": "9.1"
      },
      "fiscalMemory": {
        "fiscalDataVersion": "1.0"
      },
      "firmwareVersion": "669"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "cardTransaction": {
    "pan": "547127******8519",
    "transactionId": "5abce3f3c0ffdc014f1040de",
    "authCode": "889872",
    "rrnCode": "000010000467",
    "amount": 8600,
    "acquiringType": "Inpas",
    "approvalNumber": "055747",
    "description": "платеж картой n-Банка"
  }
}

Responses201

This response has no content.

Создать возврат предоплаты

POST/entity/prepaymentreturn

Запрос на создание нового возврата предоплаты рамках смены с указанным id.

Атрибуты запроса

  • meta — внешний уникальный идентификатор документа в формате метаданных (meta с syncId) Необходимое

  • id — id сущности в сервисе

  • name — Номер возврата предоплаты Необходимое

  • description — Комментарий

  • moment — Дата и время возврата предоплаты

  • sum — Итоговая сумма возврата предоплаты. Равна сумме нал + безнал. Может быть меньше суммы предоплаты.

  • positions — позиции возврата предоплаты Необходимое

    • assortment — позиция документа, ссылка на товар/модификацию/услугу/комплект в формате метаданных Необходимое
    • quantity — количество реализуемого товара, должно быть положительным Необходимое
    • price — цена Необходимое
    • discount — процент скидки
    • vat — процент НДС
    • vatEnabled — включен ли НДС для позиции. С помощью этого флага для позиции можно выставлять НДС = 0 или НДС = “без НДС”. (vat = 0, vatEnabled = false) -> vat = “без НДС”, (vat = 0, vatEnabled = true) -> vat = 0%

  • vatEnabled — флаг, указывающий, что документ содержит НДС

  • vatIncluded — флаг, указывающий, включен ли НДС в цену (по умолчанию включен)

  • vatIncluded — Цена включает НДС

  • vatSum — Сумма НДС

  • retailStore — ссылка на точку продаж (meta с syncId).

  • retailShift — ссылка на смену (meta с syncId). Необходимое

  • cashier — ссылка на кассира в формате метаданных.

  • prepayment — ссылка на предоплату, для которой производится возврат в формате метаданных. Необходимое

  • cashSum — Оплачено наличными

  • noCashSum — Оплачено картой

  • qrSum — оплачено по QR-коду

  • environment — информация об окружении

    • device — информация об устройстве
    • os — информация об операционной системе
    • software — информация о ПО
      • name — наименование ПО Необходимое при передаче software
      • vendor — производитель
      • version — версия ПО
    • chequePrinter — данные о ККТ
      • vendor — производитель
      • name — наименование Необходимое при передаче chequePrinter
      • serial — серийный номер
      • fiscalDataVersion — формат фискальных данных
      • driver — информация об используемом драйвере
        • name — наименование драйвера
        • version — версия драйвера
      • fiscalMemory — информация о фискальном накопителе
        • fiscalDataVersion — версия фискальной памяти
      • firmwareVersion — Версия прошивки ККТ
    • paymentTerminal — информация о платежном терминале
      • acquiringType — информация о типе эквайера (например: inpas/payme)

  • cheque — информация о чеке

    • fiscal — отметка о том, был ли использован ФР
    • online — признак электронного чека
    • printed — признак бумажного чека
    • phone — номер телефона, на который высылается электронный чек
    • email — адрес электронной почты, на который высылается электронный чек
    • number — номер чека
    • sum — сумма чека
    • fnNumber — номер ФН
    • fiscalDocSign — Фискальный признак документа
    • fiscalDocNumber — Номер фискального документа
    • time — время фискализации

  • cardTransaction — информация о транзакции в случае оплаты картой

    • pan — номер банковской карты
    • transactionId — id транзакции
    • authCode — inpas код аутентификации
    • rrnCode — Номер ссылки (RRN)
    • amount — сумма Необходимое
    • acquiringType — информация о типе эквайера (например: inpas/payme) Необходимое
    • approvalNumber — inpas/payme номер операции (код подтверждения)
    • description — комментарий

  • qrTransaction — информация о транзакции в случае оплаты по QR-коду

    • transactionId — id транзакции
    • externalOperationId — id заказа в системе банка
    • authCode — код авторизации транзакции
    • acquiringType — название API, через которое была проведена оплата

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Если поле vatEnabled=true, а поле vatIncluded=false, то НДС не входит в цену и ее надо считать.

Заказы покупателей ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Заказы покупателей ¶

GET https://online.moysklad.ru/api/posap/1.0/entity/customerorder

Responses200

Успешный запрос. Результат — JSON представление списка Заказов покупателей.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/customerorder",
    "mediaType": "application/json",
    "size": 1,
    "limit": 100,
    "offset": 0
  },
  "rows": [
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/customerorder/0f175046-dbca-11e6-5bed-427b00000079",
        "mediaType": "application/json",
        "type": "customerorder",
        "id": "0f175046-dbca-11e6-5bed-427b00000079",
        "idType": "native"
      },
      "id": "0f175046-dbca-11e6-5bed-427b00000079",
      "name": "00001",
      "description": "2222222222222",
      "moment": "2017-01-16 11:59:00",
      "vatEnabled": true,
      "vatIncluded": true,
      "deliveryPlannedMoment": "2017-02-01 17:12:00",
      "state": {
        "name": "Новый",
        "color": 15106326,
        "type": "Regular"
      },
      "positions": [
        {
          "assortment": {
            "meta": {
              "href": "http://online.moysklad.ru/api/posap/1.0/entity/product/d90cda3b-1f6c-11e7-8a7f-40d000000003",
              "mediaType": "application/json",
              "type": "product",
              "id": "d90cda3b-1f6c-11e7-8a7f-40d000000003",
              "idType": "native"
            },
            "name": "good1",
            "code": "00034",
            "uom": "шт",
            "barcodes": [
              "2000000000367"
            ],
            "salePrices": [
              {
                "value": 6000,
                "priceType": "Цена продажи"
              },
              {
                "value": 4000,
                "priceType": "Цена распродажи"
              }
            ],
            "soldByWeight": false,
            "onTap": false,
            "isSerialTrackable": false,
            "paymentItemType": "GOOD",
            "isDiscountProhibited": false
          },
          "quantity": 1,
          "price": 0,
          "vat": 0,
          "vatEnabled": false,
          "discount": 0,
          "reserve": 0
        },
        {
          "assortment": {
            "meta": {
              "href": "http://online.moysklad.ru/api/posap/1.0/entity/variant/cca27551-5cc3-11e7-6a80-332a000000a4",
              "mediaType": "application/json",
              "type": "variant",
              "id": "cca27551-5cc3-11e7-6a80-332a000000a4",
              "idType": "native"
            },
            "name": "good1 (variant)",
            "code": "00035",
            "uom": "шт",
            "barcodes": [
              "2000000000369"
            ],
            "salePrices": [
              {
                "value": 6000,
                "priceType": "Цена продажи"
              },
              {
                "value": 5000,
                "priceType": "Цена распродажи"
              }
            ],
            "soldByWeight": false,
            "onTap": false,
            "isSerialTrackable": false,
            "paymentItemType": "ANOTHER_PAYMENT_ITEM",
            "isDiscountProhibited": false
          },
          "quantity": 10,
          "price": 0,
          "vat": 0,
          "vatEnabled": false,
          "discount": 0,
          "reserve": 0,
          "pack": {
            "id": "5ae9e6b5-7b95-11e9-ac12-000b000000ac",
            "name": "ящ",
            "quantity": 10,
            "barcode": "2000000000016"
          }
        },
        {
          "assortment": {
            "meta": {
              "href": "http://online.moysklad.ru/api/posap/1.0/entity/product/d90cda3b-1f6c-11e7-8a7f-40d000000103",
              "mediaType": "application/json",
              "type": "product",
              "id": "d90cda3b-1f6c-11e7-8a7f-40d000000103",
              "idType": "native"
            },
            "name": "mask",
            "code": "00134",
            "uom": "шт",
            "barcodes": [
              "2000000023367"
            ],
            "salePrices": [
              {
                "value": 3500,
                "priceType": "Цена продажи"
              }
            ],
            "soldByWeight": false,
            "onTap": false,
            "isSerialTrackable": false,
            "paymentItemType": "GOOD",
            "isDiscountProhibited": false,
            "ppeType": "2400001323807"
          },
          "quantity": 1,
          "price": 0,
          "vat": 0,
          "vatEnabled": false,
          "discount": 0,
          "reserve": 0
        }
      ],
      "agent": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/90fdbe2f-d973-11e6-5bed-427b00000056",
          "mediaType": "application/json",
          "type": "counterparty",
          "id": "90fdbe2f-d973-11e6-5bed-427b00000056",
          "idType": "native"
        },
        "name": "ООО "Покупатель""
      },
      "prepayments": [
        {
          "meta": {
            "href": "http://online.moysklad.ru/api/posap/1.0/entity/prepayment/6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e31",
            "mediaType": "application/json",
            "type": "prepayment",
            "id": "6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e31",
            "idType": "native"
          },
          "name": "00010"
        },
        {
          "meta": {
            "href": "http://online.moysklad.ru/api/posap/1.0/entity/prepayment/6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e30",
            "mediaType": "application/json",
            "type": "prepayment",
            "id": "6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e30",
            "idType": "native"
          },
          "name": "00011"
        }
      ],
      "paidInCash": 123,
      "paidNoCash": 222,
      "paidByQr": 0,
      "shippedSum": 111
    }
  ]
}

Получить Заказы покупателей

GET/entity/customerorder

Запрос на получение списка Заказов покупателей, соответствующих складу и организации точки продаж.
Не выгружаются Заказы с сериями, алкогольными товарами, непроведенные заказы, а также заказы без позиций и заказы, у которых более 1000 позиций.

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • id — ID в формате UUID Необходимое

  • name — Имя Необходимое

  • description — Описание

  • moment — Дата Необходимое

  • vatEnabled — Учитывается ли НДС Необходимое

  • vatIncluded — Включен ли НДС в цену Необходимое

  • deliveryPlannedMoment — Планируемая дата отгрузки

  • state — Статус

  • positions — Ссылка на позиции в формате метаданных Необходимое

  • agent — Ссылка на покупателя в формате метаданных (Если заказ назначен на стандартного розничный покупателя, то это поле не придёт в составе заказа)

  • paidInCash — Оплачено наличными по заказу

  • paidNoCash — Оплачено картой по заказу

  • paidByQr — Оплачено по QR-коду по заказу

  • shippedSum — Отгружено

  • prepayments — Предоплаты связанные с заказом покупателя

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Позиции Заказа — это список товаров/услуг/модификаций/комплектов.
Объект позиции Заказа содержит следующие поля:

  • assortment — Ссылка на товар/услугу/модификацию/комплект (мета), которую представляет собой позиция Необходимое

  • quantity — Количество товаров/услуг/модификаций/комплектов данного вида в позиции Необходимое

  • price — Цена товаров/услуг/модификаций/комплекта в копейках Необходимое

  • vat — НДС, которым облагается текущая позиция Необходимое

  • vatEnabled — включен ли НДС для позиции. С помощью этого флага для позиции можно выставлять НДС = 0 или НДС = “без НДС”. (vat = 0, vatEnabled = false) -> vat = “без НДС”, (vat = 0, vatEnabled = true) -> vat = 0%

  • discount — Процент скидки или наценки Необходимое

  • reserve — Резерв данной позиции Необходимое

  • pack — Упаковка

    • id — id сущности упаковки Необходимое
    • name — Название упаковки Необходимое
    • quantity — Количество товаров в упаковке Необходимое
    • barcode — Штрихкод упаковки

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Объект статуса Заказа содержит следующие поля:

  • name — Наименование Необходимое

  • color — Цвет в цветовом пространстве ARGB Необходимое

  • type — Тип. Возможные значения: [Regular(обычный), Successful(Финальный положительный), Unsuccessful(Финальный отрицательный)] Необходимое

Объект покупателя Заказа содержит следующие поля:

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • name — Имя Необходимое

Объект предоплаты Заказа содержит следующие поля:

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • name — Имя Необходимое

У точки продаж в основном приложении есть настройка: “Выгружать только заказы со статусами”, которая влияет на выдачу заказов.
Если в этой настройке указаны статусы, то, при запросе заказов, будут возвращены только заказы с указанными статусами. Если статусы не указаны, будут выгружаться заказы со всеми статусами в т.ч. пустыми.

Заказы покупателей ¶

GET https://online.moysklad.ru/api/posap/1.0/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19

Responses200

Успешный запрос. Результат — JSON представление списка Заказов покупателей.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/customerorder/0f175046-dbca-11e6-5bed-427b00000079",
    "mediaType": "application/json",
    "type": "customerorder",
    "id": "0f175046-dbca-11e6-5bed-427b00000079",
    "idType": "native"
  },
  "id": "0f175046-dbca-11e6-5bed-427b00000079",
  "name": "00001",
  "description": "2222222222222",
  "moment": "2017-01-16 11:59:00",
  "vatEnabled": true,
  "vatIncluded": true,
  "deliveryPlannedMoment": "2017-02-01 17:12:00",
  "state": {
    "name": "Новый",
    "color": 15106326,
    "type": "Regular"
  },
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "http://online.moysklad.ru/api/posap/1.0/entity/product/d90cda3b-1f6c-11e7-8a7f-40d000000003",
          "mediaType": "application/json",
          "type": "product",
          "id": "d90cda3b-1f6c-11e7-8a7f-40d000000003",
          "idType": "native"
        },
        "name": "good1",
        "code": "00034",
        "uom": "шт",
        "barcodes": [
          "2000000000367"
        ],
        "salePrices": [
          {
            "value": 6000,
            "priceType": "Цена продажи"
          },
          {
            "value": 4000,
            "priceType": "Цена распродажи"
          }
        ],
        "soldByWeight": false,
        "onTap": false,
        "isSerialTrackable": false,
        "paymentItemType": "GOOD",
        "isDiscountProhibited": false
      },
      "quantity": 1,
      "price": 0,
      "vat": 0,
      "vatEnabled": false,
      "discount": 0,
      "reserve": 0
    },
    {
      "assortment": {
        "meta": {
          "href": "http://online.moysklad.ru/api/posap/1.0/entity/variant/cca27551-5cc3-11e7-6a80-332a000000a4",
          "mediaType": "application/json",
          "type": "variant",
          "id": "cca27551-5cc3-11e7-6a80-332a000000a4",
          "idType": "native"
        },
        "name": "good1 (variant)",
        "code": "00035",
        "uom": "шт",
        "barcodes": [
          "2000000000369"
        ],
        "salePrices": [
          {
            "value": 6000,
            "priceType": "Цена продажи"
          },
          {
            "value": 5000,
            "priceType": "Цена распродажи"
          }
        ],
        "soldByWeight": false,
        "onTap": false,
        "isSerialTrackable": false,
        "paymentItemType": "ANOTHER_PAYMENT_ITEM",
        "isDiscountProhibited": false
      },
      "quantity": 10,
      "price": 0,
      "vat": 0,
      "vatEnabled": false,
      "discount": 0,
      "reserve": 0,
      "pack": {
        "id": "5ae9e6b5-7b95-11e9-ac12-000b000000ac",
        "name": "ящ",
        "quantity": 10,
        "barcode": "2000000000016"
      }
    },
    {
      "assortment": {
        "meta": {
          "href": "http://online.moysklad.ru/api/posap/1.0/entity/product/d90cda3b-1f6c-11e7-8a7f-40d000000103",
          "mediaType": "application/json",
          "type": "product",
          "id": "d90cda3b-1f6c-11e7-8a7f-40d000000103",
          "idType": "native"
        },
        "name": "mask",
        "code": "00134",
        "uom": "шт",
        "barcodes": [
          "2000000023367"
        ],
        "salePrices": [
          {
            "value": 3500,
            "priceType": "Цена продажи"
          }
        ],
        "soldByWeight": false,
        "onTap": false,
        "isSerialTrackable": false,
        "paymentItemType": "GOOD",
        "isDiscountProhibited": false,
        "ppeType": "2400001323807"
      },
      "quantity": 1,
      "price": 0,
      "vat": 0,
      "vatEnabled": false,
      "discount": 0,
      "reserve": 0
    }
  ],
  "agent": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/90fdbe2f-d973-11e6-5bed-427b00000056",
      "mediaType": "application/json",
      "type": "counterparty",
      "id": "90fdbe2f-d973-11e6-5bed-427b00000056",
      "idType": "native"
    },
    "name": "ООО "Покупатель""
  },
  "prepayments": [
    {
      "meta": {
        "href": "http://online.moysklad.ru/api/posap/1.0/entity/prepayment/6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e31",
        "mediaType": "application/json",
        "type": "prepayment",
        "id": "6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e31",
        "idType": "native"
      },
      "name": "00010"
    },
    {
      "meta": {
        "href": "http://online.moysklad.ru/api/posap/1.0/entity/prepayment/6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e30",
        "mediaType": "application/json",
        "type": "prepayment",
        "id": "6e13d2e1-b0ba-4f70-bd39-0b7dfd6c2e30",
        "idType": "native"
      },
      "name": "00011"
    }
  ],
  "paidInCash": 123,
  "paidNoCash": 222,
  "paidByQr": 0,
  "shippedSum": 111
}

Получить Заказ покупателя

GET/entity/customerorder/{id}

Запрос на получение заказа для точки продаж.

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • id — ID в формате UUID Необходимое

  • name — Имя Необходимое

  • description — Описание

  • moment — Дата Необходимое

  • vatEnabled — Учитывается ли НДС Необходимое

  • vatIncluded — Включен ли НДС в цену Необходимое

  • deliveryPlannedMoment — Планируемая дата отгрузки

  • state — Статус

  • positions — Ссылка на позиции в формате метаданных Необходимое

  • agent — Ссылка на покупателя в формате метаданных (Если заказ назначен на стандартного розничный покупателя, то это поле не придёт в составе заказа)

  • paidInCash — Оплачено наличными по заказу

  • paidNoCash — Оплачено картой по заказу

  • paidByQr — Оплачено по QR-коду по заказу

  • shippedSum — Отгружено

  • prepayments — Предоплаты связанные с заказом покупателя

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Позиции Заказа — это список товаров/услуг/модификаций/комплектов.
Объект позиции Заказа содержит следующие поля:

  • assortment — Ссылка на товар/услугу/модификацию/комплект (мета), которую представляет собой позиция Необходимое

  • quantity — Количество товаров/услуг/модификаций/комплектов данного вида в позиции Необходимое

  • price — Цена товаров/услуг/модификаций/комплекта в копейках Необходимое

  • vat — НДС, которым облагается текущая позиция Необходимое

  • vatEnabled — включен ли НДС для позиции. С помощью этого флага для позиции можно выставлять НДС = 0 или НДС = “без НДС”. (vat = 0, vatEnabled = false) -> vat = “без НДС”, (vat = 0, vatEnabled = true) -> vat = 0%

  • discount — Процент скидки или наценки Необходимое

  • reserve — Резерв данной позиции Необходимое

  • pack — Упаковка

    • id — id сущности упаковки Необходимое
    • name — Название упаковки Необходимое
    • quantity — Количество товаров в упаковке Необходимое
    • barcode — Штрихкод упаковки

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Объект статуса Заказа содержит следующие поля:

  • name — Наименование Необходимое

  • color — Цвет в цветовом пространстве ARGB Необходимое

  • type — Тип. Возможные значения: [Regular(обычный), Successful(Финальный положительный), Unsuccessful(Финальный отрицательный)] Необходимое

Объект покупателя Заказа содержит следующие поля:

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • name — Имя Необходимое

Объект предоплаты Заказа содержит следующие поля:

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • name — Имя Необходимое

У точки продаж в основном приложении есть настройка: “Выгружать только заказы со статусами”, которая влияет на выдачу заказов.
Если в этой настройке указаны статусы, то, при запросе заказов, будут возвращены только заказы с указанными статусами. Если статусы не указаны, будут выгружаться заказы со всеми статусами в т.ч. пустыми.

URI Параметры

СкрытьПоказать

id
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19

id Заказа покупателя

Заказы покупателей ¶

POST https://online.moysklad.ru/api/posap/1.0/entity/customerorder

RequestsПример 1

Пример создания нового заказа покупателя.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/customerorder/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
  },
  "moment": "2018-09-06 21:41:46",
  "description": "Описание заказа",
  "agent": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/syncid/f085d67e-6eae-11e6-8a84-bc520403352a"
    }
  },
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/f085d67e-6eae-11e6-8a84-bc520403352c"
        }
      },
      "quantity": 2,
      "price": 500,
      "discount": 10,
      "vat": 10
    },
    {
      "quantity": 3,
      "price": 400,
      "discount": 10,
      "vat": 10,
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/syncid/f085d67e-6eae-11e6-8a84-bc520403352c"
        }
      }
    }
  ],
  "taxSystem": "SIMPLIFIED_TAX_SYSTEM_INCOME"
}

Responses201

This response has no content.

Создать заказ покупателя

POST/entity/customerorder

Запрос на создание нового заказа покупателя.

Обязательные поля для создания заказа:

  • meta — Метаданные

  • agent — Ссылка на контрагента.

В случае, если не будет передано поле name — оно будет автоматически присвоено на сервере.
После создания, заказу будет выставлена Организация, указанная в настройках точки продаж.

Атрибуты запроса

  • taxSystem — Код системы налогообложения.
Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED

Розничные операции ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Розничные операции ¶

GET https://online.moysklad.ru/api/posap/1.0/entity/retailoperation

Responses200

Успешный запрос. Результат — JSON представление списка Заказов покупателей.

Headers
Content-Type: application/json

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailoperation",
    "mediaType": "application/json",
    "size": 2,
    "limit": 25,
    "offset": 0
  },
  "rows": [
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailsalesreturn/syncid/6f2a160d-5842-452c-9845-a8fd82b43a62",
        "mediaType": "application/json",
        "type": "retailsalesreturn",
        "id": "6f2a160d-5842-452c-9845-a8fd82b43a62",
        "idType": "sync"
      },
      "id": "9f80f80e-d49e-11e9-ac12-000b000001a4",
      "name": "00001",
      "moment": "2019-09-11 17:15:00",
      "sum": 0,
      "noCashSum": 0,
      "qrSum": 0,
      "agent": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/organization/1415fdba-d49b-11e9-ac12-000b00000068",
          "mediaType": "application/json",
          "type": "organization",
          "id": "1415fdba-d49b-11e9-ac12-000b00000068",
          "idType": "native"
        },
        "name": "123"
      },
      "retailShift": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/4676fe33-d49d-11e9-ac12-000b0000018f",
          "mediaType": "application/json",
          "type": "retailshift",
          "id": "4676fe33-d49d-11e9-ac12-000b0000018f",
          "idType": "native"
        },
        "name": "00001",
        "openmoment": "2019-09-11 17:05:00"
      },
      "prepaymentCash": 0,
      "prepaymentNoCash": 0,
      "prepaymentQrSum": 0,
      "returned": false
    },
    {
      "meta": {
        "href": "https://online.moysklad.ru/api/posap/1.0/entity/retaildemand/syncid/21356f1a-1826-475b-bf7c-80d2ced0229f",
        "mediaType": "application/json",
        "type": "retaildemand",
        "id": "21356f1a-1826-475b-bf7c-80d2ced0229f",
        "idType": "sync"
      },
      "id": "4682ea35-d49d-11e9-ac12-000b00000191",
      "name": "00001",
      "moment": "2019-09-11 17:05:00",
      "sum": 1000,
      "noCashSum": 1000,
      "qrSum": 0,
      "retailShift": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/4676fe33-d49d-11e9-ac12-000b0000018f",
          "mediaType": "application/json",
          "type": "retailshift",
          "id": "4676fe33-d49d-11e9-ac12-000b0000018f",
          "idType": "native"
        },
        "name": "00001",
        "openmoment": "2019-09-11 17:05:00"
      },
      "prepaymentCash": 0,
      "prepaymentNoCash": 0,
      "prepaymentQrSum": 0,
      "returned": true
    }
  ]
}

Получить Розничные операции

GET/entity/retailoperation

Запрос на получение розничных операций.

  • meta — Уникальный идентификатор в формате метаданных Необходимое

  • id — ID в формате UUID Необходимое

  • name — Имя Необходимое

  • agent — Ссылка на покупателя в формате метаданных

  • sum — Сумма операции

  • noCashSum — Оплачено картой

  • qrSum — оплачено по QR-коду

  • moment — Дата и время розничной операции

  • retailShift — Смена с датой открытия и закрытия

  • prepaymentCash — Предоплата наличными

  • prepaymentNoCash — Предоплата картой

  • prepaymentQrSum — предоплата по QR-коду

  • returned — Признак того, был ли сделан возврат

  • masterShift — Смена на которой была фискализирована операция с датой открытия и закрытия

  • isCloud — Признак того, что операция была фискализирована удаленно

  • prepaymentCash — Предоплата наличными

  • prepaymentNoCash — Предоплата картой

  • prepaymentQrSum — предоплата по QR-коду

  • name — Имя Необходимое

  • description — Описание

  • moment — Дата Необходимое

  • vatIncluded — Включен ли НДС в цену Необходимое

  • vatEnabled — Учитывается ли НДС Необходимое

  • deliveryPlannedMoment — Планируемая дата отгрузки

  • state — Статус

  • positions — Ссылка на позиции в формате метаданных Необходимое

  • agent — Ссылка на покупателя в формате метаданных вместе с телефоном, именем и email Необходимое

Позиции Заказа — это список товаров/услуг/модификаций/комплектов. Объект позиции Заказа содержит следующие поля:

  • assortment — Ссылка на товар/услугу/модификацию/комплект в формате метаданных, которую представляет собой позиция Необходимое

  • quantity — Количество товаров/услуг/модификаций/комплектов данного вида в позиции Необходимое

  • price — Цена товаров/услуг/модификаций/комплекта в копейках Необходимое

  • vat — НДС, которым облагается текущая позиция Необходимое

  • discount — Процент скидки или наценки Необходимое

  • reserve — Резерв данной позиции Необходимое

  • sn — список серийных номеров

    • meta — Метаданные о серийном номере
    • name — Имя

Ассортимент позиции — информация о товаре в позиции заказа Объект ассортимента содержит следующие поля:

  • meta — Метаданные, представляющие собой ссылку на объект

  • name — Наименование

  • code — Код

  • article — Артикул товара

  • images — Изображения товара в формате метаданных

  • barcodes — Массив штрихкодов

  • uom — Единица измерения

  • soldByWeight — Продажа по весу (только у товара)

  • onTap — Продажа на разлив (только у товара)

  • isSerialTrackable — Учет по серийным номерам. Не может быть указан вместе с alcoholic и weighed (только у товара)

  • salePrices — Цены продажи (нет у серий)

  • egaisIsAlcoholic — отметка о том, является ли товар алкогольным (приходит только для товаров)

  • label — Имя серии (выводится только для серий)

  • components — Компоненты комплекта, это список товаров/услуг/модификаций, который входят в состав комплекта. Компонентов у комплекта может быть от 1 до 10 Необходимое
    • meta — Метаданные сущности Необходимое
    • quantity — Количество компонентов в комплекте. Выводятся в виде метаданных сущности.

  • search — Поиск по номеру операции (вхождение поисковой строки, как подстроки имени операции), по сумме операции
    (с точностью до знака после точки), по названию позиции (только одной) и по имени контрагента, если длина поискового запроса больше 2х символов. Тип значения — строка.

  • dtype — Поиск по типу операции (только по одному и в нижнем регистре). Тип значения — строка.

Создание продажи на фискализацию ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Продажа на фискализацию ¶

POST https://online.moysklad.ru/api/posap/1.0/cheque/minion/entity/retaildemand

RequestsПример 1

Пример создания новой розничной продажи.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retaildemand/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
  },
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "name": "000219991",
  "moment": "2016-09-06 21:41:46",
  "description": "размен",
  "agent": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/688bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/81fdf852-7c21-11e6-8a84-bae500000068",
          "mediaType": "application/json"
        }
      },
      "quantity": 2,
      "price": 500,
      "discount": 10,
      "vat": 10,
      "sum": 1000,
      "pdf": [
        "abc",
        "def"
      ],
      "marks": [
        {
          "cis": "12345678900987ABCDEFGabcdefgh"
        },
        {
          "cis": "00000046185372KY4mjNZAB=U/FkO"
        }
      ]
    },
    {
      "quantity": 3,
      "price": 400,
      "discount": 10,
      "vat": 10,
      "sum": 800,
      "sn": [
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/f085d67e-6eae-11e6-8a84-bc520403352a",
            "mediaType": "application/json"
          }
        },
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/f085d67e-6eae-11e6-8a84-bc520403352b",
            "mediaType": "application/json"
          }
        },
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/f085d67e-6eae-11e6-8a84-bc520403352d",
            "mediaType": "application/json"
          }
        }
      ],
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/syncid/f085d67e-6eae-11e6-8a84-bc520403352c"
        }
      }
    }
  ],
  "cashSum": 800,
  "noCashSum": 100,
  "qrSum": 0,
  "vatEnabled": true,
  "vatIncluded": true,
  "bottleUrl": "https://check.egais.ru?id=a9e56cb9-21d6-4404-9f24-668020fadf6a&amp;dt=0910141104&amp;cn=Magazin2014",
  "bottleSign": "418E6A105B60250CEB20F9F9A556FA4A9575B0C07EC536DE89CA868C884E296E56BA7EC7762C9BEC285CB4D8CD90EEE9F9FC16F92CCF324829E70862F0DFEC1B418E6A105B60250CEB20F9F9A556FA4A9575B0C07EC536DE89CA868C884E296E56BA7EC7762C9BEC285CB4D8CD90EEE9F9FC16F92CCF324829E70862F0DFEC1B",
  "cheque": {
    "fiscal": true,
    "online": true,
    "printed": true,
    "phone": "89992223311",
    "email": "1@m.com",
    "number": "4165132132",
    "sum": 123.6,
    "fnNumber": "1223334444",
    "fiscalDocSign": "111222333",
    "fiscalDocNumber": "1234567",
    "time": "2016-09-06 21:41:46"
  },
  "environment": {
    "os": "Linux",
    "device": "Some device name",
    "software": {
      "name": "Касса МойСклад",
      "vendor": "МойСклад",
      "version": "2.2"
    },
    "chequePrinter": {
      "vendor": "АТОЛ",
      "name": "30Ф",
      "serial": "15636313",
      "fiscalDataVersion": "1.0",
      "driver": {
        "name": "АТОЛ (бета)",
        "version": "9.1"
      },
      "fiscalMemory": {
        "fiscalDataVersion": "1.0"
      },
      "firmwareVersion": "669"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "cardTransaction": {
    "pan": "547127******8519",
    "transactionId": "5abce3f3c0ffdc014f1040de",
    "authCode": "889872",
    "rrnCode": "000010000467",
    "amount": 8600,
    "acquiringType": "Inpas",
    "approvalNumber": "055747",
    "description": "платеж картой n-Банка"
  },
  "customerOrder": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/customerorder/7c1b81ab-5a9d-11e8-7a31-ca1400000027",
      "mediaType": "application/json",
      "type": "customerorder",
      "id": "7c1b81ab-5a9d-11e8-7a31-ca1400000027",
      "idType": "native"
    }
  },
  "bonusProgram": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/bonusprogram/7c1b81ab-5a9d-11e8-7a31-ca1400000026",
      "mediaType": "application/json",
      "type": "bonusprogram",
      "id": "7c1b81ab-5a9d-11e8-7a31-ca1400000026",
      "idType": "native"
    }
  },
  "bonusValueToEarn": 0,
  "bonusValueToSpend": 0,
  "prepaymentCash": 123,
  "prepaymentNoCash": 222,
  "prepaymentQrSum": 0
}

Responses201

This response has no content.

Создать продажу на фискализацию

POST/cheque/minion/entity/retaildemand

Запрос на создание продажи и помещение ее в очередь облачных чеков на фискализацию.

Атрибуты запроса

Структура полностью соответствует обычному созданию продажи для эндпоинта entity/retaildemand

Создание возврата на фискализацию ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Возврат на фискализацию ¶

POST https://online.moysklad.ru/api/posap/1.0/cheque/minion/entity/retailsalesreturn

RequestsПример 1

Пример создания нового Розничного возврата.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailsalesreturn/syncid/388bd178-800c-11e6-8a84-bae5000000a3"
  },
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "demand": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retaildemand/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
    }
  },
  "name": "0002199921",
  "moment": "2016-09-06 21:42:46",
  "description": "возврат размена",
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/81fdf852-7c21-11e6-8a84-bae500000068",
          "mediaType": "application/json"
        }
      },
      "quantity": 2,
      "price": 500,
      "discount": 10,
      "vat": 10,
      "sum": 1000,
      "pdf": [
        "abc",
        "def"
      ],
      "marks": [
        {
          "cis": "12345678900987ABCDEFGabcdefgh"
        },
        {
          "cis": "00000046185372KY4mjNZAB=U/FkO"
        }
      ]
    },
    {
      "quantity": 3,
      "price": 400,
      "discount": 10,
      "vat": 10,
      "sum": 800,
      "sn": [
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/f085d67e-6eae-11e6-8a84-bc520403352a",
            "mediaType": "application/json"
          }
        },
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/f085d67e-6eae-11e6-8a84-bc520403352b",
            "mediaType": "application/json"
          }
        },
        {
          "meta": {
            "href": "https://online.moysklad.ru/api/posap/1.0/entity/sn/f085d67e-6eae-11e6-8a84-bc520403352d",
            "mediaType": "application/json"
          }
        }
      ],
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/syncid/f085d67e-6eae-11e6-8a84-bc520403352c"
        }
      }
    }
  ],
  "cashSum": 800,
  "noCashSum": 100,
  "qrSum": 0,
  "vatEnabled": true,
  "vatIncluded": true,
  "bottleUrl": "https://check.egais.ru?id=a9e56cb9-21d6-4404-9f24-668020fadf6a&amp;dt=0910141104&amp;cn=Magazin2014",
  "bottleSign": "418E6A105B60250CEB20F9F9A556FA4A9575B0C07EC536DE89CA868C884E296E56BA7EC7762C9BEC285CB4D8CD90EEE9F9FC16F92CCF324829E70862F0DFEC1B418E6A105B60250CEB20F9F9A556FA4A9575B0C07EC536DE89CA868C884E296E56BA7EC7762C9BEC285CB4D8CD90EEE9F9FC16F92CCF324829E70862F0DFEC1B",
  "cheque": {
    "fiscal": true,
    "online": true,
    "printed": true,
    "phone": "89992223311",
    "email": "1@m.com",
    "number": "4165132132",
    "sum": 123.6,
    "fnNumber": "1223334444",
    "fiscalDocSign": "111222333",
    "fiscalDocNumber": "1234567",
    "time": "2016-09-06 21:41:46"
  },
  "environment": {
    "os": "Linux",
    "device": "Some device name",
    "software": {
      "name": "Касса МойСклад",
      "vendor": "МойСклад",
      "version": "2.2"
    },
    "chequePrinter": {
      "vendor": "АТОЛ",
      "name": "30Ф",
      "serial": "15636313",
      "fiscalDataVersion": "1.0",
      "driver": {
        "name": "АТОЛ (бета)",
        "version": "9.1"
      },
      "fiscalMemory": {
        "fiscalDataVersion": "1.0"
      },
      "firmwareVersion": "669"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "cardTransaction": {
    "pan": "547127******8519",
    "transactionId": "5abce3f3c0ffdc014f1040de",
    "authCode": "889872",
    "rrnCode": "000010000467",
    "amount": 8600,
    "acquiringType": "Inpas",
    "approvalNumber": "055747",
    "description": "платеж картой n-Банка"
  }
}

Responses201

This response has no content.

Создать возврат на фискализацию

POST/cheque/minion/entity/retailsalesreturn

Запрос на создание возврата и помещение его в очередь облачных чеков на фискализацию.

Атрибуты запроса

Структура полностью соответствует обычному созданию возврата для эндпоинта entity/retailsalesreturn

Создание предоплаты на фискализацию ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Предоплата на фискализацию ¶

POST https://online.moysklad.ru/api/posap/1.0/cheque/minion/entity/prepayment

RequestsПример 1

Пример создания новой предоплаты.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/prepayment/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
  },
  "name": "000219991",
  "description": "предоплата по заказу из интернет-магазин",
  "moment": "2016-09-06 21:41:46",
  "sum": 250000,
  "agent": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/688bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/81fdf852-7c21-11e6-8a84-bae500000068",
          "mediaType": "application/json"
        }
      },
      "quantity": 2,
      "price": 500,
      "discount": 10,
      "vat": 10
    },
    {
      "quantity": 3,
      "price": 400,
      "discount": 10,
      "vat": 10,
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/syncid/f085d67e-6eae-11e6-8a84-bc520403352c"
        }
      }
    }
  ],
  "vatEnabled": true,
  "vatIncluded": true,
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "customerOrder": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/customerorder/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "cashSum": 125000,
  "noCashSum": 125000,
  "qrSum": 0,
  "cheque": {
    "fiscal": true,
    "online": true,
    "printed": true,
    "phone": "89992223311",
    "email": "1@m.com",
    "number": "4165132132",
    "sum": 123.6,
    "fnNumber": "1223334444",
    "fiscalDocSign": "111222333",
    "fiscalDocNumber": "1234567",
    "time": "2016-09-06 21:41:46"
  },
  "environment": {
    "os": "Linux",
    "device": "Some device name",
    "software": {
      "name": "Касса МойСклад",
      "vendor": "МойСклад",
      "version": "2.2"
    },
    "chequePrinter": {
      "vendor": "АТОЛ",
      "name": "30Ф",
      "serial": "15636313",
      "fiscalDataVersion": "1.0",
      "driver": {
        "name": "АТОЛ (бета)",
        "version": "9.1"
      },
      "fiscalMemory": {
        "fiscalDataVersion": "1.0"
      },
      "firmwareVersion": "669"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "cardTransaction": {
    "pan": "547127******8519",
    "transactionId": "5abce3f3c0ffdc014f1040de",
    "authCode": "889872",
    "rrnCode": "000010000467",
    "amount": 8600,
    "acquiringType": "Inpas",
    "approvalNumber": "055747",
    "description": "платеж картой n-Банка"
  }
}

Responses201

This response has no content.

Создать предоплату на фискализацию

POST/cheque/minion/entity/prepayment

Запрос на создание предоплаты и помещение ее в очередь облачных чеков на фискализацию.

Атрибуты запроса

Структура полностью соответствует обычному созданию предоплаты для эндпоинта entity/prepayment

Создание возврата предоплаты на фискализацию ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Возврат предоплаты на фискализацию ¶

POST https://online.moysklad.ru/api/posap/1.0/cheque/minion/entity/prepaymentreturn

RequestsПример 1

Пример создания нового возврата предоплаты.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/prepaymentreturn/syncid/388bd178-800c-11e6-8a84-bae5000000a2"
  },
  "name": "000219991",
  "description": "возврат предоплаты",
  "moment": "2016-09-06 21:41:46",
  "sum": 250000,
  "agent": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/688bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "positions": [
    {
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/81fdf852-7c21-11e6-8a84-bae500000068",
          "mediaType": "application/json"
        }
      },
      "quantity": 2,
      "price": 500,
      "discount": 10,
      "vat": 10
    },
    {
      "quantity": 3,
      "price": 400,
      "discount": 10,
      "vat": 10,
      "assortment": {
        "meta": {
          "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/syncid/f085d67e-6eae-11e6-8a84-bc520403352c"
        }
      }
    }
  ],
  "vatEnabled": true,
  "vatIncluded": true,
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "prepayment": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/prepayment/syncid/288bd078-800c-11e6-8a84-bae5000000a2"
    }
  },
  "cashSum": 125000,
  "noCashSum": 125000,
  "qrSum": 0,
  "cheque": {
    "fiscal": true,
    "online": true,
    "printed": true,
    "phone": "89992223311",
    "email": "1@m.com",
    "number": "4165132132",
    "sum": 123.6,
    "fnNumber": "1223334444",
    "fiscalDocSign": "111222333",
    "fiscalDocNumber": "1234567",
    "time": "2016-09-06 21:41:46"
  },
  "environment": {
    "os": "Linux",
    "device": "Some device name",
    "software": {
      "name": "Касса МойСклад",
      "vendor": "МойСклад",
      "version": "2.2"
    },
    "chequePrinter": {
      "vendor": "АТОЛ",
      "name": "30Ф",
      "serial": "15636313",
      "fiscalDataVersion": "1.0",
      "driver": {
        "name": "АТОЛ (бета)",
        "version": "9.1"
      },
      "fiscalMemory": {
        "fiscalDataVersion": "1.0"
      },
      "firmwareVersion": "669"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "cardTransaction": {
    "pan": "547127******8519",
    "transactionId": "5abce3f3c0ffdc014f1040de",
    "authCode": "889872",
    "rrnCode": "000010000467",
    "amount": 8600,
    "acquiringType": "Inpas",
    "approvalNumber": "055747",
    "description": "платеж картой n-Банка"
  }
}

Responses201

This response has no content.

Создать возврат предоплаты на фискализацию

POST/cheque/minion/entity/prepaymentreturn

Запрос на создание возврата предоплаты и помещение его в очередь облачных чеков на фискализацию.

Атрибуты запроса

Структура полностью соответствует обычному созданию возврата предоплаты для эндпоинта entity/prepaymentreturn

Запрос статуса фискализации операции ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Статус фискализации операции ¶

GET https://online.moysklad.ru/api/posap/1.0/cheque/rpc/minion/status/syncid/7944ef04-f831-11e5-7a69-971500188b19

Responses200

Успешный запрос. Результат — JSON представление статуса фискализации.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "operation": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retaildemand/syncid/a4a94924-ab7a-447e-b1ae-6b874242cbdd",
    "mediaType": "application/json",
    "type": "retaildemand",
    "id": "a4a94924-ab7a-447e-b1ae-6b874242cbdd",
    "idType": "sync"
  },
  "fiscalStatus": "OK",
  "cheque": {
    "fiscal": true,
    "online": true,
    "printed": true,
    "phone": "89992223311",
    "email": "1@m.com",
    "number": "4165132132",
    "sum": 123.6,
    "fnNumber": "1223334444",
    "fiscalDocSign": "111222333",
    "fiscalDocNumber": "1234567",
    "time": "2016-09-06 21:41:46"
  }
}

Получить статус фискализации операции

GET/cheque/rpc/minion/status/syncid/{syncid}

  • operation — Метаданные о операции Необходимое

  • fiscalStatus — Статус фискализации Необходимое

Статус фискализации Значение поля fiscalStatus
Фискализирована OK
Ожидает фискализации PENDING
В процессе фискализации IN_PROGRESS
  • cheque — информация о чеке
    • fiscal — отметка о том, был ли использован ФР
    • online — признак электронного чека
    • printed — признак бумажного чека
    • phone — номер телефона, на который высылается электронный чек
    • email — адрес электронной почты, на который высылается электронный чек
    • number — номер чека
    • sum — сумма чека
    • fnNumber — номер ФН
    • fiscalDocSign — Фискальный признак документа
    • fiscalDocNumber — Номер фискального документа
    • time — время фискализации

URI Параметры

СкрытьПоказать

syncid
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19

syncid операции

Запрос операции на фискализацию ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Запрос операции на фискализацию ¶

GET https://online.moysklad.ru/api/posap/1.0/cheque/rpc/master/poll/7944ef04-f831-11e5-7a69-971500188b19

Responses200

Headers
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company
Content-Type: application/json

BodyСкрытьПоказать

Успешный запрос. Результат - JSON представление операции.

Получить операцию на фискализацию

GET/cheque/rpc/master/poll/{orgId}

Структура полностью соответствует обычному получению операции по id для эндпоинтов entity/type

URI Параметры

СкрытьПоказать

orgId
string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19

id организации

Успешная фискализация ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Успешная фискализация ¶

PUT https://online.moysklad.ru/api/posap/1.0/cheque/rpc/master/approve

Responses204

Успешный запрос. Результат — JSON представление фискализированной операции.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retaildemand/syncid/a4a94924-ab7a-447e-b1ae-6b874242cbdd",
    "mediaType": "application/json",
    "type": "retaildemand",
    "id": "a4a94924-ab7a-447e-b1ae-6b874242cbdd",
    "idType": "sync"
  },
  "cheque": {
    "fiscal": true,
    "online": true,
    "printed": true,
    "phone": "89992223311",
    "email": "1@m.com",
    "number": "4165132132",
    "sum": 123.6,
    "fnNumber": "1223334444",
    "fiscalDocSign": "111222333",
    "fiscalDocNumber": "1234567",
    "time": "2016-09-06 21:41:46"
  },
  "chequePrinter": {
    "vendor": "АТОЛ",
    "name": "30Ф",
    "serial": "15636313",
    "fiscalDataVersion": "1.0",
    "driver": {
      "name": "АТОЛ (бета)",
      "version": "9.1"
    },
    "fiscalMemory": {
      "fiscalDataVersion": "1.0"
    },
    "firmwareVersion": "669"
  },
  "taxSystem": "GENERAL_TAX_SYSTEM",
  "retailShift": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/retailshift/syncid/288bd078-800c-11e6-8a84-bae5000000a2",
      "type": "retailshift",
      "id": "288bd078-800c-11e6-8a84-bae5000000a2",
      "idType": "sync"
    }
  }
}

Успешная фискализация

PUT/cheque/rpc/master/approve

  • meta — Метаданные о операции Необходимое

  • cheque — информация о чеке

    • fiscal — отметка о том, был ли использован ФР
    • online — признак электронного чека
    • printed — признак бумажного чека
    • phone — номер телефона, на который высылается электронный чек
    • email — адрес электронной почты, на который высылается электронный чек
    • number — номер чека
    • sum — сумма чека
    • fnNumber — номер ФН
    • fiscalDocSign — Фискальный признак документа
    • fiscalDocNumber — Номер фискального документа
    • time — время фискализации

  • chequePrinter — данные о ККТ

    • vendor — производитель
    • name — наименование Необходимое при передаче chequePrinter
    • serial — серийный номер
    • fiscalDataVersion — формат фискальных данных
    • driver — информация об используемом драйвере
      • name — наименование драйвера
      • version — версия драйвера
    • fiscalMemory — информация о фискальном накопителе
      • fiscalDataVersion — версия фискальной памяти
    • firmwareVersion — Версия прошивки ККТ

  • taxSystem — Код системы налогообложения.

Система налогообложения Значение поля taxSystem
ОСН GENERAL_TAX_SYSTEM
УСН. Доход SIMPLIFIED_TAX_SYSTEM_INCOME
УСН. Доход-Расход SIMPLIFIED_TAX_SYSTEM_INCOME_OUTCOME
ЕСХН UNIFIED_AGRICULTURAL_TAX
ЕНВД PRESUMPTIVE_TAX_SYSTEM
Патент PATENT_BASED
  • retailShift — Метаданные о смене, в которой была фискализирована операция Необходимое

Неуспешная фискализация ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Неуспешная фискализация ¶

PUT https://online.moysklad.ru/api/posap/1.0/cheque/rpc/master/reject

Responses204

Успешный запрос. Результат — JSON представление о ошибке фискализации.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/retaildemand/syncid/a4a94924-ab7a-447e-b1ae-6b874242cbdd",
    "mediaType": "application/json",
    "type": "retaildemand",
    "id": "a4a94924-ab7a-447e-b1ae-6b874242cbdd",
    "idType": "sync"
  },
  "fiscalErrMsg": "ФН переполнен"
}

Неуспешная фискализация

PUT/cheque/rpc/master/reject

  • meta — Метаданные о операции Необходимое

  • fiscalErrMsg — информация о ошибке

Обновить статус точки продаж ¶

Для данного ресурса предусмотрена авторизация по token. Все запросы к ресурсам справочника товаров и услуг должны сопровождаться
HTTP заголовок Lognex-Pos-Auth-Token со значением токена, а также HTTP заголовком Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира,
от имени которого выполняется запрос. При этом заголовок Authorization НЕ указывается.

  • Пример:
    • Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
    • Lognex-Pos-Auth-Cashier-Uid:employee@company

О том как получить данный token можно прочитать тут.

Обновить статус точки продаж ¶

POST https://online.moysklad.ru/api/posap/1.0/state

RequestsПример

Пример body запроса для обновления статуса точки продаж.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "environment": {
    "device": "Some device name",
    "os": "Linux",
    "software": {
      "name": "Касса МойСклад",
      "vendor": "МойСклад",
      "version": "2.2"
    },
    "chequePrinter": {
      "vendor": "АТОЛ",
      "name": "30Ф",
      "serial": "15636313",
      "fiscalDataVersion": "1.0",
      "driver": {
        "name": "АТОЛ (бета)",
        "version": "9.1"
      },
      "fiscalMemory": {
        "fiscalDataVersion": "1.1"
      },
      "firmwareVersion": "669"
    },
    "paymentTerminal": {
      "acquiringType": "payme"
    }
  },
  "state": {
    "sync": {
      "message": "Ошибка синхронизации, необходимо войти повторно",
      "lastAttemptMoment": "2016-09-06 21:41:00"
    },
    "fiscalMemory": {
      "error": {
        "code": "1003",
        "message": "Критическая ошибка"
      },
      "notSendDocCount": 25,
      "notSendFirstDocMoment": "2016-09-06 21:41:00"
    }
  }
}

Responses204

Headers
Content-Type: application/json

Обновить статус точки продаж

POST/state

Запрос на обновление статуса точки продаж.

Если поле, помеченое как Необходимое, отсутствует в запросе на обновление статуса точки продаж, то все JSON поля данного объекта (включая поля дочерних объектов), в котором находится данное поле, устанавливаются в null

  • environment — Информация об окружении

    • device — Информация об устройстве
    • os — Информация об операционной системе
    • software — Информация о ПО
      • name — Наименование ПО Необходимое
      • vendor — Производитель
      • version — Версия ПО
    • chequePrinter — Данные о ККТ
      • vendor — Производитель
      • name — Наименование ПО Необходимое
      • fiscalDataVersion — Формат фискальных данных
      • driver — Информация об используемом драйвере
        • name — Наименование драйвера
        • version — Версия драйвера
      • fiscalMemory — Информация о фискальном накопителе
        • fiscalDataVersion — Версия фискальной памяти
        • fiscalValidityDate — Срок действия ФН
      • firmwareVersion — Версия прошивки ККТ
      • taxSystem — Системы налогообложения, зарегистрированные в ККТ. Если в ККТ зарегистрировано несколько систем налогообложения, строка будет содержать все названия через запятую
      • frDate — Дата ККТ
    • paymentTerminal — информация о платежном терминале
      • acquiringType — информация о типе эквайера (например: inpas/payme)

  • state — Статус синхронизации

    • sync — Состояние синхронизации точки продаж
      • message — Информация о состоянии синхронизации
      • lastAttemptMoment — Дата последней синхронизации Необходимое
    • fiscalMemory — Состояние фискального накопителя
      • error — Информация об ошибке фискального накопителя
        • code — Код ошибки фискального накопителя
        • message — Описание ошибки
      • notSendDocCount — количество не отправленных в ОФД документов
      • notSendFirstDocMoment — Дата первого документа в очереди на отправку
    • paymentTerminal — информация о платежном терминале Deprecated
      • acquiringType — информация о типе эквайера (например: inpas/payme)

Создание товаров ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Создание Товара ¶

POST https://online.moysklad.ru/api/posap/1.0/entity/product

RequestsПример

Пример body запроса для создания нового товара.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/product/syncid/388bd178-800c-11e6-8a84-bae500000099"
  },
  "name": "товар",
  "barcodes": [
    "6756173856073261598132",
    "41272104617235",
    "123"
  ],
  "price": 100.5,
  "vat": 18,
  "useParentVat": false,
  "description": "Товар, который мы создаём через posap",
  "article": "арт-10002",
  "productFolder": {
    "meta": {
      "href": "https://online.moysklad.ru/api/posap/1.0/entity/productfolder/c380a8b1-745e-11e6-007d-ff4e0000005e"
    }
  },
  "image": {
    "filename": "cat.jpg",
    "content": "/9j/4QAYRXhpZgAASUkqAAgAAAAAAAAAAAAAAP/sABFEdWNreQABAAQAAABkAAD/7gAmQWRvYmUAZMAAAAABAwAVBAMGCg0AACbxAABz6wAAtw4AARiwn/AHNXab18Tzkr39p3xlS3p7c5/9k="
  }
}

Responses201

This response has no content.

Создать новый товар

POST/entity/product

Запрос на создание нового товара.

  • meta — внешний уникальный идентификатор в формате метаданных (мета с syncId) Необходимое

  • name — Наименование Товара Необходимое

  • barcodes — Массив штрихкодов товара

  • OnTap — Поле, показывающее является ли товар разливным.

  • price — Цена продажи

  • vat — НДС %

  • vatEnabled — Включен ли НДС для товара. С помощью этого флага для товара можно выставлять НДС = 0 или НДС = “без НДС”. (vat = 0, vatEnabled = false) -> vat = “без НДС”, (vat = 0, vatEnabled = true) -> vat = 0%

  • useParentVat — использовать НДС родительской группы

  • description — Описание Товара

  • article — Артикул

  • productFolder — Ссылка на группу Товаров

  • image — Изображение Товара

    • filename — название файла с изображением Необходимое
    • content — изображение, закодированное в BASE64 Необходимое

Создание контрагентов ¶

Для данного ресурса необходима авторизация по token. О том как получить данный token можно прочитать тут.
Варианты аутентификации с помощью token:

  • С помощью заголовков (Header):
    Lognex-Pos-Auth-Token со значением токена, а также Header’ом Lognex-Pos-Auth-Cashier-Uid, значением которого будет uid кассира, от имени которого выполняется запрос. При этом Header Authorization НЕ указывается.

    • Пример:
    - `Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b`
- `Lognex-Pos-Auth-Cashier-Uid:employee@company`

  • C помощью обычной BASIC авторизации с парой логин-пароль, где:

    • логин — uid кассира, от имени которого выполняется запрос
    • пароль — token точки продаж
      • Пример:
        • Username: admin@myorg
        • Password: 9aa01067f9abc091ec6354fa73b5e05fda9e07fa

  • С помощью cookie:

    • имя куки: Lognex-Pos-Auth
    • значение: <uid кассира>:<token точки продаж>
      • Пример:
        • name = Lognex-Pos-Auth
        • value = admin@myorg:4f2dc4d646bf0275de20b8f7f0b4f6fdda79cec0

Создание контрагента ¶

POST https://online.moysklad.ru/api/posap/1.0/entity/counterparty

RequestsПример

Пример body запроса для создания нового контрагента.

Headers
Content-Type: application/json
Lognex-Pos-Auth-Token: 6ab89be1ae6ff147755625ee8da948e42612233b
Lognex-Pos-Auth-Cashier-Uid: employee@company

BodyСкрытьПоказать

{
  "meta": {
    "href": "https://online.moysklad.ru/api/posap/1.0/entity/counterparty/syncid/276a6f50-7ffd-11e6-8a84-bae50000005"
  },
  "name": "Иван Иванович",
  "discountCardNumber": "101",
  "phone": "+7 925 8762323",
  "email": "email@example.com",
  "descrption": "мой комментарий"
}

Responses201

This response has no content.

Создать Покупателя

POST/entity/counterparty

Запрос на создание нового контрагента.

  • meta -внешний уникальный идентификатор в формате метаданных (мета с syncId) Необходимое

  • name — Имя Контрагента Необходимое

  • discountCardNumber — Номер дисконтной карты

  • phone — Номер городского телефона

  • email — Адрес электронной почты

  • description — Комментарий

Generated by aglio on 17 Oct 2022

Источник

Как и любая проблема с доступом к интернет-ресурсам, ошибка 503 Service Unavailable («Сервис недоступен») может быть вызвана сбоями как на стороне пользователя, так и на стороне сервера, на котором находится сайт. Поэтому первое, что нужно сделать, если вы столкнулись с таким сообщением при посещении веб-ресурса, попробовать устранить сбой своими силами. Это намного проще и быстрее, чем пытаться донести информацию о возникших сложностях до владельца сайта.

Процедура устранения проблемы со стороны администратора веб-ресурса более сложная, но в большинстве случаев именно неправильные настройки на уровне хостинга или настроек сайта в панели управления CMS приводят к появлению ошибки сервера с кодом 503.

Мощный хостинг в подарок при заказе лицензии 1С-Битрикс

Выбирайте надежную CMS с регулярными обновлениями системы и профессиональной поддержкой. А мы подарим вам год мощного хостинга – специально для сайтов на 1С-Битрикс.

Заказать

Устранение ошибки 503 пользователем

Возникает резонный вопрос: почему бы просто не покинуть проблемный сайт, пусть сами разбираются со своими багами? Это решение очевидное, но не совсем верное. Во-первых, вам может быть очень необходимо посетить именно этот веб-ресурс. Во-вторых, появление сигнала об ошибке доступа может говорить о том, что с вашим браузером, программным обеспечением, компьютером или другими устройствами что-то не в порядке. И тогда это уже ваша проблема, которая может повторяться систематически и при посещении других сайтов. Рассмотрим, что можно сделать самому, чтобы исправить ошибку 503, двигаясь от простого к сложному.

  1. Обновите вкладку браузера. Это покажется странным, но зачастую такое простое действие приводит к положительному результату. Нажмите клавишу F5 или воспользуйтесь специальной кнопкой в меню браузера.
  2. Закройте и откройте браузер. Таким образом вы произведете сброс текущей сессии соединения и обновите его. При новом подключении скрипт браузера может не обнаружить ошибку 503, если она была воспринята им ошибочно.
  3. Стоит убедиться, что сбой не связан именно с вашим компьютером. Это особенно актуально, если ошибки соединения с веб-ресурсами повторяются регулярно и возникают с разными кодировками на других сайтах. Для этого необходимо посетить проблемную страницу с другого устройства и желательно через новое интернет-соединение.
  4. Зайдите на страницу, выдавшую ошибку 503, используя другой браузер. Вполне вероятно, что дефект возникает из-за некорректных настроек текущего. Если это подтвердится, стоит в них покопаться и найти источник возникновения проблемы. Самое простое, это восстановить настройки по умолчанию.
  5. Перезагрузка компьютера. Как и любой программный сбой на уровне операционной системы или другого программного обеспечения, он может быть исправлен автоматически при новой загрузке системы.
  6. Очистка кэша и удаление файлов cookies.  В зависимости от настроек конкретного браузера в них может сохраняться много «лишней» информации при обмене web-данными. Операция довольно несложная, но стоит предварительно посмотреть help по данному вопросу, т.к. в каждом браузере она проводится по-разному.
  7. Перезагрузка сетевого оборудования. Часто сложности при соединении с интернет-ресурсами возникают из-за некорректного поведения ПО на внешних устройствах, через которые вы получаете трафик. Это может быть роутер, раздающий интернет как по кабелю, так и через Wi-Fi. Необходимо отключить соответствующую железку по питанию, т.е. полностью обесточить ее примерно на одну минуту. Если провайдер выдает вам динамический ip-адрес, то произойдет его смена, что тоже может привести к устранению появления ошибки 503.
  8. Смена DNS-адреса на сервере. Это решение является наиболее сложным для обычного пользователя. В большинстве интернет-соединений используется общедоступный DNS-адрес Google. Изменить его можно через «Панель управления компьютера» в «Центре управления сетями и общим доступом». Данные манипуляции довольно критичны для устойчивой работы интернета на вашем компьютере. Поэтому производить их стоит только тогда, когда вы абсолютно уверены в своей IT-подготовке.

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

Ошибка 503 может отображаться в разных форматах с дополнительными информативными сообщениями. Появление страницы «503 Service Temporary Unavailable – Сервис временно недоступен» говорит о том, что проблема носит временный характер. В этом случае пользователю рекомендуется не предпринимать никаких действий и просто дождаться, когда доступ восстановится автоматически.

Ошибка 503 HTTP

Решение проблем с ошибкой 503 администратором веб-ресурса

При возникновении ошибки 503 Service Unavailable в любом ее проявлении администратор web-ресурса в первую очередь должен разобраться в причине ее появления. Игнорирование данной процедуры по принципу «само пройдет» может привести к тому, что сайт понесет глобальные потери в объеме пользовательского трафика и, как следствие, конверсии. Посетители, регулярно сталкивающиеся с проблемами доступа к определенному ресурсу, очень быстро занесут его в «игнор».

В зависимости от конкретного тарифного плана хостинга каждый сайт имеет ограничения по одновременной обработке запросов, поступающих на сервер от конечных пользователей. Более простые запросы браузеров обрабатываются практически мгновенно, сложные ожидают очереди в порядке их поступления. Количество отложенных запросов лимитировано, при превышении нормы каждый следующий отклоняется. В этом случае посетитель сайта видит на экране сообщение с кодировкой error 503.

Наиболее частые причины возникновения ошибки 503 на стороне сервера

  1. При получении запроса от пользователя конкретная страница сайта не может установить соединение с базой данных MySQL.
  2. Некорректная работа плагинов и расширений из-за внутренних ошибок или конфликта между собой.
  3. Использование недорого хостинга и маломощного сервера приводит к тому, что оборудование не справляется с обработкой входящего трафика.
  4. Ресурсоемкие скрипты создают дополнительную нагрузку на сервер.
  5. Задействован почтовый сервис, выполняющий автоматическую рассылку сообщений в большом объеме.
  6. Соединение с удаленным сервером может привести к замедлению обработки запросов.
  7. Передача файлов большого объема при помощи PHP-скрипта.
  8. Значительное количество нерабочих модулей конкретной CMS.

Как видим, решение практически всех проблем, приводящих к появлению ошибки 503, достигается использованием более мощных серверов и высокоскоростного качественного хостинга. Отрицательная сторона этого способа в его затратности. Распределение пользовательского трафика неравномерно по времени, и банальный апгрейд железа не поможет полностью исключить сбои в моменты пиковых нагрузок.

Как избежать появления ошибок 503

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

Уменьшение нагрузки на базу данных можно добиться следующими способами:

  • Регулярное обновление CMS, которое позволяет оптимизировать работу движка, уменьшить количество багов.
  • Установка защиты от ботов и парсеров, которые часто запускаются вашими конкурентами, чтобы создать дополнительную нагрузку на ресурс и тем самым вывести его частично или полностью из строя.
  • Уменьшение размера и, если это возможно, количества графических файлов на сайте, а также «тяжелых» таблиц.
  • Ввод ограничений на количество одновременных участников в чате.

Оптимизация работы скриптов

  • Отключите все лишние плагины и дополнения, кроме тех, которые реально необходимы для бесперебойной работы сайта (кэширование, оптимизация базы данных, создание бэкапов, сжатие изображений).
  • Осуществляйте передачу файлов большого объема через FTP, т.к. использование других способов передачи данных приводит к созданию отдельного процесса.
  • Осуществляйте массовую почтовую рассылку в моменты отсутствия пиковой нагрузки на сайт, например, ночью или ранним утром.
  • При использовании удаленного сервера минимизируйте время ответа и оптимизируйте канал соединения.
  • Проверьте наличие проблемных запросов к базе MySQL в файле mysql-slow.log.

Дополнительную нагрузку на сервер, приводящую к появлению ошибки 503, могут создать DDoS-атаки. Защита от них с помощью фильтрации относится к отдельной теме обсуждения.

Следует отметить, что ошибка 503, вызванная перегрузкой серверных мощностей, может пройти сама собой, без внешнего вмешательства. Чтобы понять, произошло ли исправление ситуации, достаточно периодически перезагружать сайт.

Заключение

Ошибка 503 Service Unavailable может возникнуть на любом сайте, управляемом одной из наиболее популярных CMS – WordPress (Вордпресс), Joomla (Джумла), DLE (ДЛЕ) и любой другой, использующей базы данных MySQL. Способов ее решения много, начиная от самых простых на уровне пользователя и заканчивая довольно сложными процедурами, которые должен выполнить администратор сайта.

Буду благодарен, если вы нашли нестандартный подход к устранению сбоя с кодировкой 503 и готовы поделиться своим опытом в комментариях!

Источник

Инструкции для обычных пользователей и для администраторов сайтов.

Как исправить ошибку 503: исчерпывающее руководство

Что означает ошибка 503

Код 503 сообщает, что запущенный сервис недоступен (Service Unavailable). Чаще всего это ненадолго: например, доступ к ресурсу закрывают на время перезагрузки или для проведения технического обслуживания.

Но иногда ошибка 503 возникает из-за того, что работа системы организована неправильно. Сервер взаимодействует с очередью запросов: принимает их, обрабатывает и выдаёт ответ. С лёгкими запросами он справляется быстро, со сложными — долго. Если таких тяжёлых запросов много, очередь продвигается медленно.

Длина очереди обычно фиксированная. Когда вы заходите на сайт, то отправляете запрос серверу. Если для него нет места, появится ошибка 503.

Что делать пользователю при ошибке 503

Попробуйте выполнить эти действия — есть шанс, что проблема решится.

Проверьте, у всех ли возникает ошибка

Эти онлайн-сервисы покажут, все ли пользователи не могут получить доступ к сайту или ошибка 503 появляется только у вас:

  • Down for Everyone or Just Me;
  • Website Planet;
  • 2IP.

Последний особенно удобен: он делает запросы к сайту с серверов из разных стран и показывает код ответа. Если хотя бы в одном случае есть ошибка 503, значит, вы точно не одиноки.

Если сервисы показывают, что ресурс доступен, попробуйте зайти на него с другого устройства. Или попросите друзей проверить, всё ли с сайтом в порядке.

Подождите и попробуйте позже

Обновите страницу. Если по-прежнему видите ошибку 503, попробуйте зайти на сайт позднее: через пару минут или когда там потенциально будет меньше пользователей. Это касается прежде всего игр или ресурсов, которые резко стали популярны. Например, если государство объявило о новых выплатах, которые оформляются онлайн, мощностей сервера может на всех не хватить.

Перезагрузите устройство

Если проблема возникает только у вас, перезагрузка смартфона, компьютера или планшета может помочь.

Если это не сработало, перезапустите и роутер. Сделать это можно тремя способами.

1. Через панель управления

Обычно она находится по адресу 192.168.0.1 или 192.168.0.1. IP вводится прямо в браузере, но возможны варианты — сверьтесь с инструкцией к вашей модели.

В панели нужно найти кнопку «Перезагрузка» или «Перезагрузить»: она может быть в меню «Система», «Системные» и так далее. Нажмите и дождитесь, пока страница обновится.

2. С помощью кнопки отключения

Кнопка On / Off обычно находится на задней панели роутера. Нажмите на неё, подождите 20–30 секунд и включите устройство снова. Этого времени хватит, чтобы конденсаторы разрядились, чипы памяти перестали получать питание, все временные данные сбросились.

Важно! Не перепутайте кнопку On / Off с Reset, которая не только перезагружает роутер, но также сбрасывает его настройки. Если кнопка утоплена в корпус и, чтобы нажать на неё, требуется спичка или отвёртка, точно не пытайтесь достать её.

3. С помощью отключения из розетки

Выньте адаптер питания из розетки, подождите 20–30 секунд и подключите снова.

Смените DNS-адреса

DNS (Domain Name System — система доменных имён) переводит текстовые URL-адреса сайтов в IP, например https://lifehacker.ru/ в 116.202.209.72. Такой конвертацией занимаются DNS-серверы. Проблемы на них иногда приводят к тому, что вы видите ошибку 503.

К счастью, адреса DNS-серверов можно сменить. Так, вы можете использовать IP публичных DNS Google: 8.8.8.8 и 8.8.4.4 для стандарта IPv4, 2001:4860:4860::8888 и 2001:4860:4860::8844 для нового IPv6. Вот как это сделать.

1. На компьютере с Windows

Нажмите Win + R. В окне «Выполнить» введите ncpa.cpl и нажмите Enter.

Выберите подключение, которое используете, кликните по нему правой кнопкой, нажмите на «Свойства».

В списке компонентов найдите пункт «IP версии 4» или «TCP/IPv4», нажмите «Свойства». Установите переключатель «Использовать следующие адреса DNS-серверов», введите 8.8.8.8 и 8.8.4.4 в две строки.

Если в списке компонентов у вас есть «IP версии 6» или «TCP/IPv6», можете аналогично задать адреса 2001:4860:4860::8888 и 2001:4860:4860::8844.

Желательно также сбросить кеш DNS. Для этого снова зажмите Win + R, в окне «Выполнить» введите cmd.

В консоли напишите ipconfig /flushdns и кликните Enter.

2. На компьютере с macOS

Зайдите в меню «Системные настройки» — «Сеть». Если слева внизу вы видите иконку с закрытым замком, кликните по ней и в появившемся окне введите пароль администратора.

Кликните по нужному подключению и выберите в меню пункт «Дополнительно».

На вкладке DNS нажмите на «+» и добавьте адреса в список.

Очистите кеш DNS. Запустите терминал, напишите команду sudo killall -HUP mDNSResponder. Затем нажмите Return и введите пароль администратора.

3. На роутере

Зайдите в панель управления роутера и найдите пункт с адресами DNS-серверов — они могут быть в настройках DHCP. Введите два адреса нужного формата (IPv4 или IPv6) — в зависимости от того, что поддерживает ваше устройство.

Очистите кеш YouTube на Android

На Android-устройствах ошибка 503 в приложении YouTube иногда возникает из-за повреждённой информации в кеше. Попробуйте очистить его, чтобы сервис снова заработал. Действуйте так.

Зайдите в настройки. В списке приложений найдите YouTube.

Остановите его работу и нажмите «Очистить кеш». Затем снова запустите приложение.

Уменьшите список воспроизведения YouTube

Иногда ошибка 503 возникает, когда в вашем списке воспроизведения «Смотреть позже» слишком много видео. Попробуйте уменьшить его, а затем перезагрузите страницу или приложение.

Свяжитесь с администрацией ресурса

Возможно, администраторы сайта ещё не в курсе проблемы. Или, наоборот, знают, как её решить либо через сколько всё заработает. Словом, если ничего из перечисленного не помогло, обратитесь к ним.

Что делать администратору при ошибке 503

Всё зависит от движка вашего сайта и его настроек. Выбирайте подходящие варианты и проверяйте, решило ли это проблему.

Установите параметр Retry After

Он показывает, сколько времени после получения ошибки 503 должен подождать клиент до следующего запроса к серверу. Значение указывается в миллисекундах, его величину вы задаёте самостоятельно. Это предупредит слишком частые повторные запросы.

Пересмотрите время выполнения регулярных заданий

Отправку рассылок и другие задачи, которые обычно располагают в системном Cron, перенесите на время минимальной загрузки сервера. А заодно освежите в памяти правила пользования хостингом, чтобы не нарушить ограничения по количеству отправленных писем и времени работы скриптов.

Установите защиту от DDoS-атак

Это также запросы, которые поступают в общую очередь. Избавитесь от них — сможете быстрее предоставлять пользователям доступ к своему ресурсу.

Не передавайте крупные файлы через HTTP

Обычно хостеры ограничивают время работы скриптов. Если вы будете передавать большие файлы через такой скрипт, высока вероятность, что в лимит вы не вложитесь. К тому же передача будет занимать отдельный процесс, а значит, он не сможет обрабатывать запросы из общей очереди.

Передача файлов напрямую в этой ситуации выгоднее. В ней задействуется многопоточный процесс, который не так влияет на скорость загрузки сайта или сервиса в целом.

Удалите тяжёлые или устаревшие компоненты CMS

Попробуйте по очереди отключать компоненты вашей CMS и смотреть, как меняется ситуация. Если вы нашли потенциальный источник проблемы, попробуйте обновить этот компонент. Или подумайте, как обойтись без него — например, заменить на более новый и быстрый аналог.

Объедините ресурсы в один файл, чтобы уменьшить число запросов

Если ваше веб-приложение использует множество мелких ресурсов (изображений, таблиц стилей, скриптов и так далее) и загружает каждый из них отдельным запросом, они могут занимать значительную часть очереди. Чтобы решить проблему, объедините всё в один файл.

Уберите соединения с удалёнными серверами

Они могут не отвечать слишком долго. А тем временем остальные запросы к вашему серверу будут ждать обработки.

Бывает, что в скриптах вместо локальных путей используются глобальные, формата http://…. Они также воспринимаются как запросы к удалённому серверу и замедляют работу.

Поищите такие проблемы в коде, и, если без удалённого сервера не обойтись, выставьте небольшой тайм-аут на ожидание. Предусмотрите действия на случай, если он не успеет ответить.

Оптимизируйте MySQL-запросы

Если вы используете MySQL и часть запросов выполняется достаточно медленно, некоторые хостинги автоматически создают файл логов mysql-slow.log. В нём собираются наиболее проблемные обращения к базе данных. Проанализируйте их и по возможности выполните оптимизацию.

Также проиндексируйте базу и попробуйте задействовать кеширующие компоненты, которые позволили бы уменьшить количество запросов.

Установите антилич

Если другой веб-мастер использует прямые ссылки на ваш ресурс, например вставляет у себя на страницах ваши картинки, это также увеличивает очередь запросов. Антилич-модули и настройки эффективно борются с этим. Некоторые хостеры позволяют включить их в панели администрирования. Для других нужно всё настроить вручную, например через правила mod_rewrite в файле .htaccess или отдельные модули.

Установите кеширующие компоненты

Они помогут вам разгрузить очередь запросов и сократить среднее время их обработки. В результате для новых обращений останется место, и пользователи не будут видеть ошибку 503.

Проконсультируйтесь с хостером

Возможно, проблема не только у вас, и специалисты хостинг-компании знают, как её решить. Нелишним будет перед этим пробежаться по FAQ-материалам и просмотреть свежие темы на форуме ресурса. Есть вероятность, что там уже лежат готовые инструкции.

Читайте также 👩‍💻💻🎮

  • Как исправить ошибку CPU Fan Error при загрузке компьютера
  • Как очистить кеш браузера
  • 21 способ ускорить интернет, если всё висит
  • Что означает 404 Not Found и другие ошибки веб-страниц
  • Что делать с ошибкой «Запуск этого устройства невозможен. (Код 10)» в Windows 10
Источник

Подсказки? Разочарования? Обсуждаем проблемы сервиса с другими посетителями сайта:



идентификация не требуется

комментарии с нецензурной лексикой и оскорблениями удаляются

Артём

  
•
 

5 дней назад

 #

6 февраля 2023

+
0
—

Перестала работать сайт!

Гость

  
•
 

12 дней назад

 #

30 января 2023

+
0
—


★
☆
☆
☆
☆

не работает не обновляется, нет возможности работать!!!

Гость

  
•
 

25 дней назад

 #

17 января 2023

+
0
—

лайфхак как запустить МС в сложившийся ситуации

Коллеги, подскажу лайфхак
Сейчас Сервер МС блокирует статические адреса с большим количеством пользователей для защиты от doss атак. Решение можно найти с помощью подключения интернета через мобильный телефон или VPN.
Нам помогло.

user

  
•
 

25 дней назад

 #

17 января 2023

+
0
—

Минск донт ворк

Наталья

  
•
 

25 дней назад

 #

17 января 2023

+
0
—

Усть-Каменогорск не работает

USER

  
•
 

25 дней назад

 #

+
0
—

Вроде заработал

Юлия

  
•
 

25 дней назад

 #

+
0
—

Электросталь МО, опять не работает

Казанский

  
•
 

25 дней назад

 #

+
0
—

Казань, не работает

USER

  
•
 

25 дней назад

 #

+
0
—

Не работает, Ташкент

Сергей

  
•
 

25 дней назад

 #

+
0
—

МС Снова упал, НИжний Новгород

Гость

  
•
 

25 дней назад

 #

+
0
—

опять проблемы с МС, надеюсь что исправят в ближайшие время

Я

  
•
 

26 дней назад

 #

+
0
—

Спб, работает.

укропский борщщщ

  
•
 

26 дней назад

 #

+
0
—

тюмень работает

Миша на порядок выше

  
•
 

26 дней назад

 #

+
0
—

С-Пб, снова перестал работать

Андрей

  
•
 

26 дней назад

 #

+
1
—

Опять не работает. Таже ошибка

Костя

  
•
 

26 дней назад

 #

+
1
—

Не могу посмотреть сейчас, а ночью работать в МС. Заработала Москва подскажите?

Костя

  
•
 

26 дней назад

 #

+
1
—

Москва заработала?

Дмитрий

  
•
 

26 дней назад

 #

+
0
—

Рязань, понеслось!!!

Дмитрий

  
•
 

26 дней назад

 #

+
0
—

МО, заработало.

Владимир

  
•
 

26 дней назад

 #

+
0
—

Москва Работает

Казань

  
•
 

26 дней назад

 #

+
0
—

Казань, заработало!

Владислав

  
•
 

26 дней назад

 #

+
0
—

понеслась!

Владислав

  
•
 

26 дней назад

 #

+
0
—

админ жестко игнорирует вопрос «когда начнет работать»! )))))))))

юлия

  
•
 

26 дней назад

 #

+
0
—

москва, у меня так и не работает

ZOV

  
•
 

26 дней назад

 #

+
1
—

Горжусь нашими ITишниками, молодцы!

Гость

  
•
 

26 дней назад

 #

+
0
—

Москва — заработал

Микола Буча

  
•
 

26 дней назад

 #

+
1
—

залезли в наш дом, теперь мы будем лазить в ваш
и так
объявляем технические работы
исправление ошибок, оптимизация приложения

Гость

  
•
 

26 дней назад

 #

+
0
—

Модератору

Уважаемый модератор, убедительная просьба забанить невменько. Мешает нормальному общению и конструктивному диалогу. К тому же антироссийская пропаганда и оскорбления налицо, нет?

ненавижу русню

  
•
 

26 дней назад

 #

+
-5
—

рашисты — террористы

У вас настолько маленький ум, что кроме слов мразь, саосать и амерекос, вы больше ничего не знаете, а вы на машине какой ездите? Наверное москвич? телефон какой у вас? Не забывайте что у вас ничего нет, вы только много кричите, а кричит, как правило, больше тот — кто глупый. Ай, что вам говорить то, у вас наверняка машины нет, живете от зарплаты до зарплаты, а учить думаете. книги почитайте, потом умом блещите

Дмитрий

  
•
 

26 дней назад

 #

+
2
—

И здесь укромразь!

Твою мать! Даже здесь эта укромразь свой нос суёт! Всей вашей незалежной Украиной будете у америкосов сосать до скончания времён. Правда, если останется кому сосать…

Ирина

  
•
 

26 дней назад

 #

+
2
—

не работает со второй половины дня, когда исправите ситуацию?

Гость

  
•
 

26 дней назад

 #

+
3
—


★
★
★
☆
☆

Не работает сейчас и последнее время часто глючит

Казань. Татарстан

  
•
 

26 дней назад

 #

+
7
—

Перестал работать с 14 часов, до сих не зарботал. Когда исправите ошибку?

Пригожин

  
•
 

26 дней назад

 #

+
-8
—

не работает сладд — бери в руки автомат

Работающий человек ты ненадолго. Мобилизация скоро, часики тикают, а ты по телеку войну смотришь. БЕРИ В РУКИ АВТОМАТ сыкло

Йошкар Ола

  
•
 

26 дней назад

 #

+
0
—

Минуту работает , 2 нет связи

ПЕНЗА

  
•
 

26 дней назад

 #

+
0
—

НЕ РАБОТАЕТ

Гость

  
•
 

26 дней назад

 #

+
14
—

Рот закройте, нацик. Здесь ЛЮДИ общаются. Работающие люди. Ваше вяканье здесь неуместно. Дуйте на свой майдан и там флажком машите. Кыш

Шойгу

  
•
 

26 дней назад

 #

+
-5
—

Вова, иди в палату

Владимир Владимирович. Мы же обсуждали в сами что ядерный арсенал не обслуживался 30 лет. все деньги ушли на водку, стройку дворца, вы опять не в себе, сейчас вам таблетки Пригожин принесет, отойдите от компутера

Гость

  
•
 

26 дней назад

 #

+
-1
—


★
★
☆
☆
☆

Нужно срочно счёт выставить. Уже 4 часа не работает(((

Владимир Владимирович П.

  
•
 

26 дней назад

 #

+
1
—

Если «складик» завтра не заработает, нанесем ядерный удар по Киеву.

Украина

  
•
 

26 дней назад

 #

+
-1
—

в стране газа проект подари дрова — помогите себе сначала

россия кроме ракет больше ничего не имеет, ну кроме людей. людей россия имеет хорошо, за год войны 100 тыс ублюдков в наших черноземах. а вы такая могущественная страна — где жрете там и срете. Туалеты забрали, да забирайте туалеты, стиралки, у вас же кроме москвы и питера все остальные города нищие, без воды и газа.
Страна газа в своей стране запускает проект «подари дрова» https://podari-drova.ru/ в своей стране не можете своим гражданам газ провести, и сидите вякаете — вякайте.
Заплатите за все, уже платите своими потерями денег за сегодня.
Это только начало

Укроп вялый

  
•
 

26 дней назад

 #

+
1
—

отдам килограмм сала бесплатно, может кто голодает в Киеве

Гость

  
•
 

26 дней назад

 #

+
2
—

Вологда не работает

николай

  
•
 

26 дней назад

 #

+
2
—

москва не работает

А

  
•
 

26 дней назад

 #

+
0
—

Чините уже. Дос атаки у них

Хохлы кроме того как гадости писать не на что не способны)) Уже про**ли миллиарды помощи, которая больше чем годовой бюджет на вооружение нескольких стран, а все гордятся что им еще не хана)) Были бы вы одни там и со своими бабками — давно не было бы украины) Вырастили дебилов дали им интернет, теперь вот наблюдаем имбецилов))

Даниил

  
•
 

26 дней назад

 #

+
1
—

Владимир, не работает: Код ошибки: 326756812284196

Казанский

  
•
 

26 дней назад

 #

+
0
—

Казань, не работает

Илья

  
•
 

26 дней назад

 #

+
1
—

беларусь сбой

Мария

  
•
 

26 дней назад

 #

+
0
—

Марий Эл заработал!

Гость

  
•
 

26 дней назад

 #

+
0
—


★
★
★
☆
☆

Частые сбои, иногда возникают непредвиденные ситуации из-за этого

User

  
•
 

26 дней назад

 #

+
0
—

Осспадя, а пафоса то. Вы б ещё сайты детсадов за ddosили, неудачники ????

Россия

  
•
 

26 дней назад

 #

+
3
—

ахахаха когда дойдет пукан свой разогрей, и вопрос почему пишешь то на русском смотри а то вои поимеют))))))

Украина

  
•
 

26 дней назад

 #

+
-6
—

Спасите росию от гноя

Ваш херсонский пукан уже разорван, вам видимо мало.
Думать не умеешь — считай колека. А у вас колек 140 миллионов. 140 миллионов лишний людей на планете. Разлилась росиия как говно. У самих нихера нет, они спасать идут. Смешные вы ребятам. Ничего. Будете работать на репарации — поумнеете

урус

  
•
 

26 дней назад

 #

+
-2
—

хохлы п.и.д.о.р.а.с.ы

урус

  
•
 

26 дней назад

 #

+
-2
—

хохлы ********

Валентин

  
•
 

26 дней назад

 #

+
0
—

Ростов-на-Дону не работает! чините быстрее!!

ZOV

  
•
 

26 дней назад

 #

+
0
—

О повылазили, пукан не надорвите

Уже лучше

  
•
 

26 дней назад

 #

+
0
—

Норм, отпускает. Потерь нет.

Сириус

  
•
 

26 дней назад

 #

+
0
—

Смоленск
подает признаки жизни…надеемся реанимируют

Украина

  
•
 

26 дней назад

 #

+
-18
—

Рашисты — террористы

Как вы рашисты суетитесь, а нам в кайф наблюдать как вы теряете деньги, «чините быстрее» «умираем» да зачем вам это «мой склад», идите учитесь автомат держать, у вас мобилизация скоро, страна идиотов.

Гостомель а не Гостомеля

  
•
 

26 дней назад

 #

+
-8
—

>Александр
>москва не работает, СРОЧНО быстрее чините, горим умираем теряем деньги

Горите-умираете в Украине, а сейчас пока бегаете

Дмитрий

  
•
 

26 дней назад

 #

+
0
—

Московская область, сильно тормозит. Иван, заряжай! Ахмат, стреляй! На Вашингтон!

Кузя

  
•
 

26 дней назад

 #

+
-1
—

Это потеря потерь

Чапаев

  
•
 

26 дней назад

 #

+
5
—

Вот за это хохлов и не любят. А потом визг стоит — а нас за що??? Работайте, братья

Владимир

  
•
 

26 дней назад

 #

+
0
—

Гомель, не работает

серега

  
•
 

26 дней назад

 #

+
0
—

тюмень не фурычит

Константин

  
•
 

26 дней назад

 #

+
0
—

Пермь. Не работает.

Алёна

  
•
 

26 дней назад

 #

+
0
—

Кострома ,не работает

Максим

  
•
 

26 дней назад

 #

+
1
—

Курск. Не работает.

Юрий

  
•
 

26 дней назад

 #

+
1
—

СПб, не работает

Украина

  
•
 

26 дней назад

 #

+
-21
—

Как работать вы думаете? А вы думайте за Днепр! Бучу! Бахмут! Рашисты — террористы

Наталья

  
•
 

26 дней назад

 #

+
0
—

Не работает сайт, приложение, касса виснет. Как работать???

Украина

  
•
 

26 дней назад

 #

+
-13
—

Это вам за Днепр!

oi

  
•
 

26 дней назад

 #

+
-3
—

dos (:

авва

  
•
 

26 дней назад

 #

+
-1
—

Ребят, ну что за фигня. не работает, как работать???

Жека

  
•
 

26 дней назад

 #

+
0
—

Владивосток, не работает. Но Нам похрену, мы спать)))

Сергей

  
•
 

26 дней назад

 #

+
0
—

Казахстан Алматы не работает ни сайт ни приложение.

Ольга

  
•
 

26 дней назад

 #

+
2
—

Пензенская обл. Не работает, очень долго грузит и выдает ошибку.

Имя

  
•
 

26 дней назад

 #

+
0
—

молодцы *****, раз в пол года такая ****** !!!

Татьяна

  
•
 

26 дней назад

 #

+
0
—

Не работает мой склад Амурская область

Александр

  
•
 

26 дней назад

 #

+
0
—

москва не работает, СРОЧНО быстрее чините, горим умираем теряем деньги

Денис

  
•
 

26 дней назад

 #

+
3
—

Ярославль, не работает. Но мы спокойны, как дохлые львы. Один хрен наши ихних бармалеев передидосят.)))

Надежда

  
•
 

26 дней назад

 #

+
1
—

Не работает мой склад и это в середине рабочего дня(( Мурманск

Катя

  
•
 

26 дней назад

 #

+
0
—

Великий Новгород не работает

Макс

  
•
 

26 дней назад

 #

+
1
—

Дудосят, происки зели! Не работает 2й час

Данила

  
•
 

26 дней назад

 #

+
0
—

МС додосят, пока сроков решения нету на сколько я понял

Дина

  
•
 

26 дней назад

 #

+
0
—

Уфа. Не работает 2 часа

Юлия

  
•
 

26 дней назад

 #

+
0
—

Не работает волгоград

Ай

  
•
 

26 дней назад

 #

+
1
—

нет соединения/ только с телефона и очень долго все грузит

Алексей

  
•
 

26 дней назад

 #

+
3
—

Москва. Не работает. За 2 года на моей памяти впервые падает

Алексей

  
•
 

26 дней назад

 #

+
1
—

не работает. Протвино

Евгений

  
•
 

26 дней назад

 #

+
2
—

Санкт-петербург, не работает

Инна

  
•
 

26 дней назад

 #

+
0
—

не работает . Подольск

Юлия

  
•
 

26 дней назад

 #

+
0
—

Москва не работает

Наталья

  
•
 

26 дней назад

 #

+
0
—

Симферополь не работает(!

Sergey

  
•
 

26 дней назад

 #

+
0
—

Нижний Новгород не Работает

Холден Колфилд

  
•
 

26 дней назад

 #

+
1
—

Киров , не работает

петя

  
•
 

26 дней назад

 #

+
0
—

воронеж. не работает сайт.

Дмитрий

  
•
 

26 дней назад

 #

+
0
—

Рязань, не работает

Анатолий

  
•
 

26 дней назад

 #

+
0
—

Мурманск.Не работает.Сайт не открывается.Мобильные приложения не грузятся.

Анатолий

  
•
 

26 дней назад

 #

+
0
—

не работает

Мари

  
•
 

26 дней назад

 #

+
0
—

что с моим складом?

Александр

  
•
 

26 дней назад

 #

+
0
—

Не работает Москва
Ошибка
Код ошибки: 709100144170902

василий

  
•
 

26 дней назад

 #

+
0
—

Мск, ЦАО, не работает(

Артём

  
•
 

26 дней назад

 #

+
2
—

Работает, но тупит

Даниил

  
•
 

26 дней назад

 #

+
0
—

Владимирская область — не работает, не загружает номенклатуру, остатки

Андрей

  
•
 

26 дней назад

 #

+
0
—

МО Коломна , не работает

Александр

  
•
 

26 дней назад

 #

+
0
—

Не работает. Пишут, что на сервер идет DDos атака.

Наталья

  
•
 

26 дней назад

 #

+
0
—

Тамбов не работает

Илья

  
•
 

26 дней назад

 #

+
1
—

Владимир не работает

Тимофей

  
•
 

26 дней назад

 #

+
3
—

Надеемся и ждем, ждем и надеемся)

Александра

  
•
 

26 дней назад

 #

+
2
—

Екатеринбург, снова теряем… Ничего не грузит.

Онлайн-поддержка сервис МойСклад

  
•
 

26 дней назад

 #

+
7
—

Онлайн-поддержка

Здравствуйте.
В данный момент наблюдаются сбои на площадке провайдера, это сказывается на работе МоегоСклада. С перебоями работает доступ к аккаунтам и другим сервисам.
Мы отслеживаем статус и работаем над скорейшим решением. Приносим извинения за эту ситуацию.
Срок ожидания ответа в чате увеличен, но мы в любом случае рассмотрим все обращения и ответим на электронную почту. Благодарим вас за понимание.

Артём

  
•
 

26 дней назад

 #

+
3
—

В сложные времена живём.

Ого, оказывается, нас много Мойскладских) Зато какие обновления недавно были… Ребятки сэкономили мне столько времени, что я готов прогулять от компа пару часов время ожидания.

Терешкин

  
•
 

26 дней назад

 #

+
0
—

мой склад. зао. можайка не работает.

Евгения

  
•
 

26 дней назад

 #

+
0
—

Казань не работает

Александра

  
•
 

26 дней назад

 #

+
0
—

Невероятно медленно, но работает, Екатеринбург

Мария

  
•
 

26 дней назад

 #

+
0
—

Марий Эл не работает

Роман

  
•
 

26 дней назад

 #

+
1
—

Москва
Не работает
15-00, 16.01.23

Kat

  
•
 

26 дней назад

 #

+
0
—

не работает

Андрей

  
•
 

26 дней назад

 #

+
1
—

Бизнес встал, одни убытки!!!!

Алена

  
•
 

26 дней назад

 #

+
1
—

Вологда не работает.

Дарья, Израиль ????

  
•
 

26 дней назад

 #

+
0
—

Не работает

Автор

  
•
 

26 дней назад

 #

+
0
—

Пишут, что фиксируют атаки с зарубежных адресов и прогнозируют восстановление в течении 30 минут

М

  
•
 

26 дней назад

 #

+
0
—

Не работает

Ответ службы поддержки: «Конкретных сроков по решению данного вопроса пока нет, мы стараемся решить это настолько быстро, насколько возможно. ожидайте, пожалуйста»

Сиди и жди непонятно сколько…

Алексей

  
•
 

26 дней назад

 #

+
0
—

Брянск не работает.. всем по году бесплатной подписки!

Дмитрий

  
•
 

26 дней назад

 #

+
0
—

Код ошибки: 494612845920833 МСК уже полчаса

Римма

  
•
 

26 дней назад

 #

+
0
—

Не работает

Владимир

  
•
 

26 дней назад

 #

+
0
—

не работает.
выдал ошибку 474411746524075 и больше не загружается.

ксения

  
•
 

26 дней назад

 #

+
1
—

ответ менеджера: Добрый день
Разработчики в курсе, чинят, скоро все заработает

Почините скорее!

  
•
 

26 дней назад

 #

+
5
—

Наверно уборщица проводок зацепила шваброй, когда в серверной полы мыла))

Анастасия

  
•
 

26 дней назад

 #

+
1
—

Не работает, Москва. Когда починят!?

Петр

  
•
 

26 дней назад

 #

+
3
—

не работает. Новосибирск!!!

Недовольный юзер

  
•
 

26 дней назад

 #

+
2
—

Умираем

Павел

  
•
 

26 дней назад

 #

+
2
—

не работает !!!
когда починят ?

Васёк

  
•
 

26 дней назад

 #

+
-6
—

Работает!

ксения

  
•
 

26 дней назад

 #

+
0
—

не работает. москва. на телефон поддержки не дозвониться

.)

  
•
 

26 дней назад

 #

+
0
—

Не входит в систему

Биб

  
•
 

26 дней назад

 #

+
0
—

Очень долго грузит. Работать невозможно

Владимир

  
•
 

26 дней назад

 #

+
3
—

Тоже не работает. Новосибирск

Роб

  
•
 

26 дней назад

 #

+
10
—

нет соединения

Денис

  
•
 

26 дней назад

 #

+
2
—

Не работает

Ольга

  
•
 

26 дней назад

 #

+
3
—

Кто знает как долго это будет? У нас как на зло инвентаризация встала.

Илья

  
•
 

26 дней назад

 #

+
3
—

Не работает, ни сайт, ни приложение.. Работа парализована

Артём

  
•
 

26 дней назад

 #

+
1
—

Работа встала…

Саша

  
•
 

26 дней назад

 #

+
1
—

Не работает

Юрий

  
•
 

26 дней назад

 #

+
0
—

опять ру программисты забыли двоеточие поставить в конце функции и все упало ?

Макс

  
•
 

26 дней назад

 #

+
13
—

не работает и сайт тоже лег

вячеслав

  
•
 

26 дней назад

 #

+
89
—

не работает

Олег

  
•
 

26 дней назад

 #

+
3
—

Не работает!

Артем

  
•
 

31 дней назад

 #

+
0
—

Не работает!!!

Ильдар

  
•
 

344 дней назад

 #

+
0
—

Заработало.. Спасибо

Mr.Finch

  
•
 

344 дней назад

 #

+
0
—

Chrome
3 точки
Настройки
Безопасность и конфиденциальность
Безопасность
Использовать безопасный DNS-сервер-
Использовать Google (Pablik DNS)

Ирина

  
•
 

344 дней назад

 #

+
0
—

не работает, СПб. сколько ждать?

SanchoS

  
•
 

344 дней назад

 #

+
0
—

через впн только работает :(((

Гость

  
•
 

344 дней назад

 #

+
0
—


★
☆
☆
☆
☆

Не работает
Только что заплатил. Не ужели усе

Андрей

  
•
 

344 дней назад

 #

+
0
—

Нижний Новгород 4 марта 22г вечером около 18:30 перестал открываться мой склад в веб и в мобильной версии(( Что делать, как работать?

Виталий

  
•
 

344 дней назад

 #

+
0
—

Нахер. Надо искать аналог. Надоели.. Хорошо что не повелся на их замануху и за год вперед не оплатил

Олег

  
•
 

344 дней назад

 #

+
0
—

Я так понял сейчас только через ВПН? или починят?

Любовь

  
•
 

344 дней назад

 #

+
0
—

Цветочники) не работает сайт, вообще вне доступа…

Артур

  
•
 

344 дней назад

 #

+
0
—

Мойсклад тоже украйнская компания, не нашел инфу, ничего не работает!!!

Ильдар

  
•
 

344 дней назад

 #

+
0
—

Согласен через ВПН работает но это уже нето , А что мой склад тоже иностранная хрень? что то я непонимаю

1231

  
•
 

344 дней назад

 #

+
0
—

Мой склад работает через cyberghost vpn

Александр

  
•
 

344 дней назад

 #

+
0
—

Цветочники , у нас народ идет а сервис не работает .
пздц терминал иногда пропускает чек без оплаты я в шоке

Борис

  
•
 

344 дней назад

 #

+
0
—

Цветочники перед 8 марта не работает касса. Пздц

Кос

  
•
 

344 дней назад

 #

+
0
—

Новосибирск, не работает Мой склад. За такие сбои компания обязана предоставлять скидки и тд.

павел

  
•
 

344 дней назад

 #

+
0
—

Не могу уже два часа войти в склад

Денис

  
•
 

344 дней назад

 #

+
0
—

Не работает Краснодар

Ильдар

  
•
 

344 дней назад

 #

+
0
—

тоже не работает г.Казань

вика

  
•
 

344 дней назад

 #

+
0
—

Нижний Новгород тоже самое сайт не работает где админы?

саша

  
•
 

344 дней назад

 #

+
0
—

хакеры долбанули ?

Виктор

  
•
 

344 дней назад

 #

+
0
—

не работает сайт! Мой склад

антон

  
•
 

344 дней назад

 #

+
0
—

сайт не работает

Антон

  
•
 

344 дней назад

 #

+
0
—

кому-нибудь ответили по продолжительности этих проблем ?

Люцифер

  
•
 

344 дней назад

 #

+
0
—

Не работает уже пол дня

Иван

  
•
 

344 дней назад

 #

+
0
—

не работает сайт мой склад!!!

Владимир

  
•
 

344 дней назад

 #

+
0
—

г. Орел. Программа висит,сайт просто не прогружается..ошибку на странице выдает при попытке войти.Звонили в техподдержку , сказали , мол все работает штатно, это вы дескать «фантазируете»!? Это корпаративная форма психологического насилия клиентов, убеждать в работоспособности не работающей программы?

Виктория

  
•
 

344 дней назад

 #

+
0
—

Нет у всех, виснет, обновляет страницу, снова виснет. Нет доступа к серверу. Не удается получить доступ к сайти

Гость

  
•
 

344 дней назад

 #

+
0
—


★
☆
☆
☆
☆

Не работает

Светлана

  
•
 

344 дней назад

 #

+
0
—

Не могу войти. Это только у меня?

Алена

  
•
 

441 дней назад

 #

+
0
—

Этот дырявый склад опять не работает .Час висит и нет просвета!

Анастасия

  
•
 

451 дней назад

 #

+
0
—

у меня пишет, что приложение недоступно, потому что хост не существует

Ната

  
•
 

451 дней назад

 #

+
0
—

не работает опять!!!! после обновления

Katya

  
•
 

451 дней назад

 #

+
0
—

не работает… капец блин

вася

  
•
 

451 дней назад

 #

+
0
—

не работает

Андрей

  
•
 

451 дней назад

 #

+
0
—

Видимо опять улегся…

алексей

  
•
 

460 дней назад

 #

+
0
—

не работает

Елена

  
•
 

461 дней назад

 #

+
0
—

Вчера не работал с 17 до 23, сегодня с утра та же ситуация…Что происходит?

МойСклад

  
•
 

462 дней назад

 #

+
0
—

Текущий сбой вызван крупной аварией, затронувшей сетевые каналы нескольких магистральных провайдеров в регионе.

Наталья

  
•
 

462 дней назад

 #

+
0
—

Ну копец, заставили людей около 6 часов нервы помотать ……

Евгений

  
•
 

462 дней назад

 #

+
0
—

С волнением весь вечер наблюдаю за этой ситуацией. Вот только, что проверил — все работает, как минимум на первый взгляд данные на месте!

Димитрий

  
•
 

462 дней назад

 #

+
0
—

Тоже самое и в тех поддержку не дозвонится . Более 20 человек в очереди

Katya

  
•
 

462 дней назад

 #

+
0
—

пришло уведомление на телефон, но так и не работает в итоге, видимо временное действие

Евгений

  
•
 

462 дней назад

 #

+
0
—

Мы из Москвы, у нас по прежнему не работает ни на ПК ни с телефона.

Рустам

  
•
 

462 дней назад

 #

+
0
—

Привет ВСЕМ !
Не работает …

Ока

  
•
 

462 дней назад

 #

+
2
—

заработало. заходите

Иван

  
•
 

462 дней назад

 #

+
0
—

Уряяя, заррработало!!!

Мой Склад очень и очень сильно Разочаровал !

  
•
 

462 дней назад

 #

+
0
—

Окончательно решил, что перехожу в оффлайн складирование
Это просто капец тех поддержка не может дать никакой исчерпывающей информации

Екатерина

  
•
 

462 дней назад

 #

+
0
—

Здравствуйте , есть понимание когда работа сервиса восстановится?)

Наталья

  
•
 

462 дней назад

 #

+
0
—

До конца текущего дня ? Время уже 22 : 25 , сайт не работает несколько часов , что произошло ????

Источник

Сообщение на странице сайта 503 Service Temporary Unavailable – «сервис временно недоступен» может появляться из-за технических сбоев как на сервере, так и на компьютере пользователя. Последнее случается реже.

Наиболее распространенная причина проблемы – перегруженность сервера запросами. Он не успевает их обрабатывать, и всем клиентам в очереди выдает ошибку с кодом 503. Такая картина может наблюдаться, например, во время DDoS-атаки.

Обнаружив ошибку 503, лучше всего ничего не делать. Подождите 3-5 минут. Очередь запросов в большинстве случаев – временное явление, и вскоре сайт станет доступен. Чего точно не нужно делать,– это постоянно перезагружать страницу с ошибкой. Так вы только увеличиваете число запросов в очереди.

Как устранить ошибку 503 на стороне пользователя?

Сразу скажем, что вряд ли пользователю удастся ее исправить. Ошибка 503 чаще возникает из-за проблем на самом сайте или хостинге. Но на всякий случай можно выполнить несложные быстрые действия, чтобы быть точно уверенным — причина не в вас.

  • Проверьте доступность сайта с помощью специальных сервисов. Например, https://2ip.ru/site-availability/. Если проверка показала, что из вашей страны сайт доступен – исправить ошибку 503 нужно на вашей стороне.
  • Перезагрузите страницу с помощью клавиш Ctrl F5 (в браузерах macOS используйте сочетание Cmd + R или Cmd + Alt + E в Safari.
  • Попробуйте открыть страницу в другом браузере, на другом компьютере. Так вы определите уровень возникновения проблемы – у вас в браузере или у вас на компьютере – и будете действовать исходя из этого. Если страница везде выдает Error 503 – то причина все же на самом сайте.
  • Закройте браузер и откройте заново. Иногда это помогает сбросить неправильные настройки сессий.
  • ​Почистите кэш и cookies браузера. Большое количество сохраненной старой информации может мешать браузеру обрабатывать соединение правильно.
  • Откройте страницу в режиме инкогнито или просто отключите все работающие в браузере дополнения и расширения – возможно, какое-то некорректно работает и приводит к появлению ошибки 503.
  • Перезагрузите компьютер. Это самый простой и быстрый способ исправить сбой в работе ПО.
  • Если не помогла перезагрузка компьютера – перезагрузите также роутер.

Что делать, если ошибка 503 – на стороне веб-ресурса?

Прежде всего, администратору сайта для ошибки сервера с кодом 503 желательно прописать параметр Retry After. Он будет показывать клиенту, через какое время тот может попробовать повторно соединится с сервером. Это уменьшит число бесконечных перезагрузок страниц и поможет снизить и без того чрезмерную в данный момент нагрузку на сервер.

Распространенные причины возникновения ошибки 503 и их исправление

В основном, ошибка 503 Service Unavailable вызывается следующими категориями причин:

  • Слишком много запросов к веб-серверу.
  • Много медленных запросов к MySQL.
  • На сайте много устаревших, нерабочих, конфликтующих плагинов и модулей CMS.
  • Неоптимизированная работа скриптов.

Также ошибка 503 может быть вызвана тем, что ваш сайт «перерос» возможности вашего хостингового тарифного плана. В этом случае стоит подумать над тем, чтобы выбрать более производительный тариф виртуального хостинга или же VPS/VDS, выделенный сервер.

Как исправить причины ошибки

Уменьшаем число запросов к веб-серверу

Устранение ошибки 503 прежде всего подразумевает снижение нагрузки на веб-сервер. Для этого:

  • установите антилич-систему. Она не позволит скачивать ваши файлы и картинки по ссылке на сторонних ресурсах – ведь так увеличивается нагрузка на ваш сервер и может возникать ошибка 503;
  • ограничьте деятельность различных ботов и роботов. При сканировании они создают множество запросов;
  • проверьте, чтобы на сайте было как можно меньше ссылок на внешние ресурсы. Оставьте только необходимые и важные. Например, иногда можно встретить большое количество информеров на странице. Каждый информер — ссылка на другой сайт, соединение с чужим сервером. Это создает дополнительную нагрузку на сервер;
  • по возможности объедините обращения к большому числу мелких файлов (скриптов, картинок, таблиц стилей), чтобы они обрабатывались одним запросом, а не множеством.

Оптимизируем работу с MySQL

  • Включите кеширование – так время обработки запроса существенно уменьшится.
  • Объединяйте запросы к БД (базе данных), чтобы один запрос обрабатывал сразу множество строк или столбцов, а не по одному.
  • Используйте индексирование по столбцам, которые часто используются в выборках.
  • Старайтесь не вкладывать один запрос в другой, так как в этом случае MySQL часто не может использовать индексы и будет долго возвращать результат.

Исправляем проблемы с CMS

Ошибка 503 Service Unavailable может быть вызвана некорректно работающими или «тяжелыми» компонентами движка вашего сайта. Чтобы выявить это, отключайте последовательно плагины или модули. Так вы найдете компонент, после выключения которого все начнет нормально работать. Оптимизируйте его или замените на более современный и быстрый.

Также рекомендуется поддерживать порядок в вашем «парке» плагинов – вовремя их обновлять, удалять те, что не используются, Плюс необходимо отслеживать корректность работы сайта после установки каждого нового модуля, а также после обновления старых – могут возникать конфликты программного обеспечения.

Оптимизируем работу скриптов

  • В скриптах поставьте локальные ссылки вместо глобальных. В глобальных указывается полный URL вместе с http, https. Они обрабатываются как отдельные запросы к внешнему ресурсу, и это гораздо большая нагрузка, чем при использовании ссылок локального вида.
  • Не передавайте файлы большого размера с помощью скриптов. Во-первых, такая передача задействует рабочие процессы сервера, нагружает его. Во-вторых, она может давать сбои, так как работа скрипта ограничена по времени,и процесс зависает.
  • Выполнение «тяжелых», масштабных скриптов и операций (почтовой рассылки, например) запланируйте на то время, когда на сайте меньше всего посетителей.

Что можно сделать для предотвращения проблемы?

В заключение дадим несколько советов – как предотвратить возникновение ошибки 503 Service Unavailable:

  • При выборе тарифа хостинга не ориентируйтесь на среднюю нагрузки вашего сайта. Закладывайте небольшой запас мощностей, чтобы в часы пик ресурсов сервера хватало на обработку запросов.
  • Установите защиту от DDoS-атак.
  • Обновляйте плагины, темы и модули CMS, отключайте то, что не используете.
  • Регулярно анализируйте работу компонентов сайта: сервера, базы MySQL, скриптов – и вовремя оптимизируйте их, не доводя ситуацию до критической.
  • Ограничьте сканирование сайта ботами и User-агентами. Оставьте только то, что необходимо, например, боты поисковых систем, остальные заблокируйте. Обычно хостер сам блокирует большинство ненужных User-агентов, но вы можете добавить и свои кастомные настройки.
Источник

Страницы 1

Чтобы отправить ответ, вы должны войти или зарегистрироваться

1 27.05.2016 16:46:41

  • Владимир
  • Участник
  • Неактивен
  • Откуда: Казахстан г.Караганда
  • Зарегистрирован: 07.11.2015
  • Сообщений: 237
  • Рейтинг: 3

Тема: Ошибка при синхронизации остатков с мой склад

Добрый день!
У меня ошибка при синхронизации с мой склад.
2016.05.27 18:40:07 Остатки: Получен ответ на запрос. Отправлен каталог товаров. Отправлены остатки. Ошибка на стороне интернет магазина: Server returned HTTP response code: 500 for URL: http://cloudvapor.rscms.ru/site1/exchan … mport.xml.

Повысить оценку Понизить оценку

2 Ответ от Владимир 27.05.2016 16:50:52

  • Владимир
  • Участник
  • Неактивен
  • Откуда: Казахстан г.Караганда
  • Зарегистрирован: 07.11.2015
  • Сообщений: 237
  • Рейтинг: 3

Re: Ошибка при синхронизации остатков с мой склад

Я уже перепробовал все что мог, ошибка не понятна для меня. Все работало сегодня, пару часов назад появилась ошибка.

Повысить оценку Понизить оценку

3 Ответ от Закусило Александр 27.05.2016 17:13:44

  • Закусило Александр
  • Закусило Александр
  • Участник
  • Неактивен
  • Откуда: Краснодар
  • Зарегистрирован: 01.09.2014
  • Сообщений: 2,949
  • Рейтинг: 251

Re: Ошибка при синхронизации остатков с мой склад

500 значит, что у Вас сайт упал во время импорта. Возможно слабый хостинг или с ограничениями. Либо тариф с совсем слабыми параметрами.

4 Ответ от Владимир 27.05.2016 17:16:27

  • Владимир
  • Участник
  • Неактивен
  • Откуда: Казахстан г.Караганда
  • Зарегистрирован: 07.11.2015
  • Сообщений: 237
  • Рейтинг: 3

Re: Ошибка при синхронизации остатков с мой склад

Я использую облачный вариант.

Повысить оценку Понизить оценку

5 Ответ от Владимир 27.05.2016 17:43:37

  • Владимир
  • Участник
  • Неактивен
  • Откуда: Казахстан г.Караганда
  • Зарегистрирован: 07.11.2015
  • Сообщений: 237
  • Рейтинг: 3

Re: Ошибка при синхронизации остатков с мой склад

И почему то в настройках модулей, некоторые подкрасились желтым цветом.
https://yadi.sk/i/Y7maIiOHs4Pj8

Повысить оценку Понизить оценку

6 Ответ от Закусило Александр 27.05.2016 18:25:50

  • Закусило Александр
  • Закусило Александр
  • Участник
  • Неактивен
  • Откуда: Краснодар
  • Зарегистрирован: 01.09.2014
  • Сообщений: 2,949
  • Рейтинг: 251

Re: Ошибка при синхронизации остатков с мой склад

Ну тогда скорее всего в этот момент происходило обновление системы, поэтому 500 и сработала видимо. Желтым подсвечиваются те модули которые были обновлены в течении 24 часов.

7 Ответ от Владимир 27.05.2016 18:38:40

  • Владимир
  • Участник
  • Неактивен
  • Откуда: Казахстан г.Караганда
  • Зарегистрирован: 07.11.2015
  • Сообщений: 237
  • Рейтинг: 3

Re: Ошибка при синхронизации остатков с мой склад

Так ошибку выдает до сих пор, не загружаются товары и остатки. Может в чем то еще проблема.

Повысить оценку Понизить оценку

8 Ответ от Закусило Александр 27.05.2016 18:47:47

  • Закусило Александр
  • Закусило Александр
  • Участник
  • Неактивен
  • Откуда: Краснодар
  • Зарегистрирован: 01.09.2014
  • Сообщений: 2,949
  • Рейтинг: 251

Re: Ошибка при синхронизации остатков с мой склад

Напишите в тех. поддержку разберёмся.

9 Ответ от Владимир 28.05.2016 09:02:26

  • Владимир
  • Участник
  • Неактивен
  • Откуда: Казахстан г.Караганда
  • Зарегистрирован: 07.11.2015
  • Сообщений: 237
  • Рейтинг: 3

Re: Ошибка при синхронизации остатков с мой склад

Похоже поддержка сегодня не работает?

Повысить оценку Понизить оценку

10 Ответ от Владимир 28.05.2016 09:03:51

  • Владимир
  • Участник
  • Неактивен
  • Откуда: Казахстан г.Караганда
  • Зарегистрирован: 07.11.2015
  • Сообщений: 237
  • Рейтинг: 3

Re: Ошибка при синхронизации остатков с мой склад

Попросили входы от аккаунтов вчера, и нечего не решили. Видать рабочий день закончился.(

Повысить оценку Понизить оценку

11 Ответ от Владимир 28.05.2016 10:00:38

  • Владимир
  • Участник
  • Неактивен
  • Откуда: Казахстан г.Караганда
  • Зарегистрирован: 07.11.2015
  • Сообщений: 237
  • Рейтинг: 3

Re: Ошибка при синхронизации остатков с мой склад

Видать после обновления модуля «Обмен данными», это произошло. Возможно вернуть предыдущею версию модуля?

Повысить оценку Понизить оценку

12 Ответ от admin 28.05.2016 14:15:38

  • admin
  • в работе
  • Неактивен
  • Откуда: Краснодар
  • Зарегистрирован: 19.06.2014
  • Сообщений: 1,081
  • Рейтинг: 146

Re: Ошибка при синхронизации остатков с мой склад

Добрый день!
Разбираемся в ситуации. Ошибка будет исправлена в ближайшие минуты.

Повысить оценку Понизить оценку

13 Ответ от admin 28.05.2016 14:27:00

  • admin
  • в работе
  • Неактивен
  • Откуда: Краснодар
  • Зарегистрирован: 19.06.2014
  • Сообщений: 1,081
  • Рейтинг: 146

Re: Ошибка при синхронизации остатков с мой склад

Извините за ожидание. Исправлено. Проверьте пожалуйста.

Повысить оценку Понизить оценку

14 Ответ от Владимир 28.05.2016 14:33:09

  • Владимир
  • Участник
  • Неактивен
  • Откуда: Казахстан г.Караганда
  • Зарегистрирован: 07.11.2015
  • Сообщений: 237
  • Рейтинг: 3

Re: Ошибка при синхронизации остатков с мой склад

Добрый день!
Спасибо большое!
В чем была причина? Чтобы потом вас не беспокоить. Или больше не повторится?

Повысить оценку Понизить оценку

15 Ответ от Владимир 28.05.2016 14:34:38

  • Владимир
  • Участник
  • Неактивен
  • Откуда: Казахстан г.Караганда
  • Зарегистрирован: 07.11.2015
  • Сообщений: 237
  • Рейтинг: 3

Re: Ошибка при синхронизации остатков с мой склад

Может что я сделал? Чтобы знать и не менять потом.

Повысить оценку Понизить оценку

16 Ответ от admin 28.05.2016 21:36:41

  • admin
  • в работе
  • Неактивен
  • Откуда: Краснодар
  • Зарегистрирован: 19.06.2014
  • Сообщений: 1,081
  • Рейтинг: 146

Re: Ошибка при синхронизации остатков с мой склад

не повториться, поправили ошибку в коде.

Повысить оценку Понизить оценку

17 Ответ от Владимир 30.05.2016 13:30:22

  • Владимир
  • Участник
  • Неактивен
  • Откуда: Казахстан г.Караганда
  • Зарегистрирован: 07.11.2015
  • Сообщений: 237
  • Рейтинг: 3

Re: Ошибка при синхронизации остатков с мой склад

Добрый день! Обмен работает отлично, но не выгружает комплектации заказного товара в мой склад. И не выгружает склад с которого надо продать или поставить в резерв. До обновления модуля комплектации выгружались точно, а вот насчет складов не знаю.

Повысить оценку Понизить оценку

18 Ответ от Владимир 30.05.2016 14:59:00

  • Владимир
  • Участник
  • Неактивен
  • Откуда: Казахстан г.Караганда
  • Зарегистрирован: 07.11.2015
  • Сообщений: 237
  • Рейтинг: 3

Re: Ошибка при синхронизации остатков с мой склад

Заметил что такое происходит, когда в модуле Обмен данными стоят галочки на Использовать импорт многомерных комплектаций и Устанавливать списковые характеристики товара исходя из наличия в комплектациях. И почемуто при каждой синхронизации внесенные изменения в комплектации товара меняются обратно в изначальное положения. Например если я в коких то товарах использую многомерные комплектации а в каких то простые, то при синхронизации все изменения слетают и все обратно становится многомерные.

Повысить оценку Понизить оценку

19 Ответ от Закусило Александр 31.05.2016 11:44:35

  • Закусило Александр
  • Закусило Александр
  • Участник
  • Неактивен
  • Откуда: Краснодар
  • Зарегистрирован: 01.09.2014
  • Сообщений: 2,949
  • Рейтинг: 251

Re: Ошибка при синхронизации остатков с мой склад

Диалог ведётся в поддержке.

20 Ответ от Денис 22.07.2018 10:34:10 Отредактировано Денис (22.07.2018 10:49:23)

  • Денис
  • Новый участник
  • Неактивен
  • Зарегистрирован: 04.08.2017
  • Сообщений: 3

Re: Ошибка при синхронизации остатков с мой склад

Уже 2 дня как упала синхронизация на сайте, притом на одном то появляется то пропадает, у вас есть какая то информация по этому поводу? Ошибка
Остатки: Получен ответ на запрос. Отправлен каталог товаров. Отправлены остатки. В интернет магазине произошла ошибка во время сеанса отправки каталога: failure UPDATE `mangol_game`.`endw_product_dir` SET `xml_id` = ‘4MOGoy5ygjGWlhmjOOC5E1’ WHERE (`id` = ‘4MOGoy5ygjGWlhmjOOC5E1’ AND `site_id` = ‘1’) LIMIT 1Duplicate entry ‘1-4MOGoy5ygjGWlhmjOOC5E1’ for key ‘site_id_xml_id’.

2 дня назад ошибка была такая
Остатки: Получен ответ на запрос. Отправлен каталог товаров. Отправлены остатки. Ошибка при обращении к сервису экспорта: failure Обмен не инициализирован.

Повысить оценку Понизить оценку

Страницы 1

Чтобы отправить ответ, вы должны войти или зарегистрироваться

Источник

Ошибка 503 Service Unavailable распространена во всех операционных системах и веб-браузерах. Он может появиться даже на мобильных телефонах и в консольных веб-браузерах. Ошибка возникает при просмотре веб-страниц или при использовании веб-приложения, когда сервер веб-сайта не может загрузить содержимое в данный момент.

Попробуйте эти простые решения, чтобы исправить это сообщение об ошибке.

Как исправить код ошибки 503 «Сервис недоступен»

Когда вы видите такой код состояния, как 503 Service Unavailable, вашим первым побуждением может быть вопрос, что вы сделали не так, но помните, что это сообщение появляется только в ответ на ошибку на стороне сервера. Хотя ваши возможности обычно ограничены, вы все же можете сделать несколько вещей.

Обновите страницу

Сообщение об ошибке 503 Service Unavailable обычно указывает на временную проблему. Иногда для сброса кода ошибки достаточно нажать F5 или CTRL + R, чтобы обновить веб-страницу. Перезагрузите сайт и посмотрите, получите ли вы доступ. Однако это также может усугубить проблему, особенно на страницах, перегруженных неожиданным наплывом пользователей.

Примечание. Если вы получите эту ошибку на последнем этапе процесса оформления заказа, повторное обновление страницы может привести к нескольким транзакциям и списанию средств с вашей кредитной карты.

Перезагрузите модем и маршрутизатор

В большинстве случаев за ошибку отвечает веб-сервер. Однако, если вы видите 503 Служба временно недоступна, проблема может заключаться в конфигурации DNS-сервера на вашем маршрутизаторе. Плохой код или сбой могут привести к отказу загрузки сайта.

Перезагрузите модем и маршрутизатор и, как только они снова включатся, повторите попытку на веб-сайте или в программе. Перезапуск этих двух устройств «очищает» ваш кеш от временного кода, который часто является причиной проблемы. 

Проверьте позднее

Иногда лучше всего подождать, особенно если веб-сайт подвергается DDOS-атаке. Это сокращение от распределенного отказа в обслуживании и означает, что веб-сайт перегружен трафиком. В большинстве случаев DDOS-атаки являются вредоносными, но иногда небольшой веб-сайт может получать больше трафика, чем обычно (например, если он попадает на главную страницу Reddit), и в результате происходит временный сбой.

Если сайт не работает из-за того, что трафик исчерпал его доступную пропускную способность, обновление страницы только усугубит проблему. Дайте ему десять минут и попробуйте еще раз. Если вы не уверены, что веб-сайт не работает из-за трафика, рассмотрите возможность использования веб-сайта, такого как Is It Down Right Now?

Связаться с веб-сайтом

Свяжитесь с веб-сайтом или хостинг-провайдером, если ни одна из ваших попыток устранения неполадок не сработала. Проблема может заключаться в WordPress или в неисправном плагине, требующем вмешательства владельца. 

Если вы не знаете, к кому обратиться, перейдите по ссылке https://lookup.icann.org/.

  1. Введите URL-адрес или доменное имя в строку поиска и выберите « Поиск».

  1. На следующей странице будет отображаться имя, идентификатор реестра, статус домена, серверы имен и т. д. Если они доступны, вы можете прокрутить страницу вниз и просмотреть владельца, его контактную информацию и т. д. Во многих случаях эта информация удаляется в целях конфиденциальности. 

Как исправить ошибку HTTP 503 на вашем сайте

Поскольку ошибка HTTP 503 обычно является ошибкой сервера, вы несете ответственность за ее исправление на своем веб-сайте. Вы можете увидеть падение трафика на ваш сайт, поскольку никто не может получить к нему доступ. 

Попробуйте одно из этих исправлений.

Перезагрузите свой сервер

Точно так же, как перезапуск маршрутизатора работает как конечный пользователь, перезапуск вашего сервера может восстановить доступ к вашему веб-сайту для зрителей. Вы можете перезагрузить сервер, зайдя на страницу управления веб-хостингом. Обычно перезапуск сервера занимает несколько минут.

Ищите автоматическое обслуживание

Если вы пользуетесь сторонним веб-хостингом (как это делает большинство людей), автоматическое обслуживание может иногда вызывать ошибку 503. Это техническое обслуживание обычно длится всего несколько минут, но может привести к отключению вашей страницы. Следите за графиками обслуживания, чтобы знать, когда ваш сайт может быть недоступен.

Когда WordPress подвергается обновлениям, он выдает ошибку HTTP 503. 

Проверьте настройки конфигурации брандмауэра

Если вы неправильно настроили брандмауэр своего сервера, он может ошибочно принять серию связанных IP-адресов за DDOS-атаку. Опять же, точное определение того, как настроить брандмауэр, зависит от различных факторов, включая ваши системы управления и поставщика услуг, поэтому здесь невозможно предоставить точный пошаговый процесс.

Если вы подозреваете, что виноват ваш брандмауэр, посмотрите журналы на стороне сервера. Если вы не можете различить там информацию, обратитесь за помощью в службу поддержки вашего хостинг-провайдера. Дежурные группы обслуживания клиентов могут помочь отладить ваш сайт и определить, является ли причиной проблемы неисправный брандмауэр или что-то еще. 

Коды ошибок веб-сайтов имеют разное значение в зависимости от их первой цифры. Например, любой код, начинающийся с 5, указывает на ошибку на стороне сервера, а любой код, начинающийся с 4 (например, печально известная ошибка 403 запрещена), указывает на ошибку на стороне клиента. Хотя вы не всегда можете многое сделать, чтобы исправить ошибку сервера, все же полезно знать ваши варианты.

Источник

Learn how to get rid of this error for good

by Milan Stanojevic

Milan has been enthusiastic about technology ever since his childhood days, and this led him to take interest in all PC-related technologies. He’s a PC enthusiast and he… read more


Updated on January 26, 2023

Fact checked by
Alex Serban

Alex Serban

After moving away from the corporate work-style, Alex has found rewards in a lifestyle of constant analysis, team coordination and pestering his colleagues. Holding an MCSA Windows Server… read more

  • Browsers are essential tools for surfing the Internet, they are the middleman between your computer and the websites you visit.
  • There are plenty of different browsers on the market, each targetting specific user needs, but there is one thing that browsers have in common: error 503.
  • HTTP error 503: The service is unavailable is one of the most frequent error codes affecting browsers.

Strugling with your current browser? Upgrade to a better one: OperaYou deserve a better browser! 350 million people use Opera daily, a fully-fledged navigation experience that comes with various built-in packages, enhanced resource consumption and great design. Here’s what Opera can do:

  • Easy migration: use the Opera assistant to transfer exiting data, such as bookmarks, passwords, etc.
  • Optimize resource usage: your RAM memory is used more efficiently than in other browsers
  • Enhanced privacy: free and unlimited VPN integrated
  • No ads: built-in Ad Blocker speeds up loading of pages and protects against data-mining
  • Gaming friendly: Opera GX is the first and best browser for gaming
  • Download Opera

HTTP errors usually come in the form of status codes which are standard response codes that help you identify the cause of the problem given by a website server when either a web page or other resource fails to load properly while online.

Whenever you get an HTTP status code, it comes with the code itself, and the corresponding explanation such as HTTP error 503: The service is unavailable.

Something else you may want to keep in mind is that each of these codes, also known as browser errors, Internet error codes or Internet connection errors have its groups.

What is the HTTP error 503?

The HTTP 503 error falls under the 5xx server error group of HTTP status codes. They usually indicate that the web page or resource request is understood by the server, but the latter cannot fill it for one reason or another.

However, the HTTP error or status codes shouldn’t be confused with Device Manager errors or system error codes, because the latter is associated with different errors and meanings altogether.

When you get HTTP error 503, this usually points to the website’s server, which may have been compromised by an overload (temporarily) or it is too busy, or there’s some ongoing such as scheduled maintenance.

Fortunately, although this error comes up often, there are fairly quick solutions to fix the issue and get the website back online.

What is HTTP error 503 and how can I fix it?

  1. Preliminary checks
  2. Close your proxy server
  3. Start the destination application pool
  4. Change Load User Profile
  5. Change Identity in Application Pool

1. Preliminary checks

Whether the issue is with the server or your computer, there are some things you can try and check before fixing HTTP error 503: The service is unavailable. You could start by retrying the URL from the address bar by reloading or refreshing the page.

You can also restart your modem and router, then restart your computer or device – this is especially so if you see the ‘service unavailable – DNS failure’ message. If this doesn’t fix the error 503 DNS issue, pick new DNS servers and change them on your PC or router.

Check with the website itself directly for assistance as they may be aware of the error 503, so they may let you know if it is an issue that’s with everyone, not just you. Sometimes waiting it out is the easiest fix to this error.

  • ALSO READ: 4 best browsers with built-in VPN you should use today

2. Close your proxy server

Perhaps you use a VPN or a proxy server, in which case, you need to check whether the connection is working the way it should, or properly. If the proxy server is down, then you may end up getting the HTTP error 503: The service is unavailable message.

This usually happens with free proxy servers, but if you do not use a proxy server, you can disable it and then try to open the website that is showing the HTTP error 503 the service is unavailable.

3. Start the destination application pool

If the application pool of the corresponding web application is stopped, or disabled, it causes the website to show HTTP error 503: The service is unavailable.

Additionally, any misconfiguration in the application pool or site settings can cause an error on the site. Process crashes also happen due to incorrect application logic.

Sometimes the user account related to the user identity of an application pool can be locked or has an expired password or even inadequate privileges which tamper with the functioning of the website.

Some PC issues are hard to tackle, especially when it comes to corrupted repositories or missing Windows files. If you are having troubles fixing an error, your system may be partially broken.
We recommend installing Restoro, a tool that will scan your machine and identify what the fault is.
Click here to download and start repairing.

If the application pool runs out of RAM or other resources, it can crash and lead to HTTP error 503, plus server migrations also lead to such errors.

If HTTP error 503 the service is unavailable is caused by a stopped application pool, starting it would resolve the issue.

  • Click Start
  • In the search bar, type Windows Features
  • Select Turn Windows Features on or off
http error 503 the service is unavailable turn windows features off
  • Locate Internet Information Services and check the box – this will install everything you need to use IIS
http error 503 the service is unavailable locate internet information services
  • Go to Control Panel
http error 503 the service is unavailable control panel
  • Select View By and click Large Icons
  • Click Administrative Tools
http error 503 administrative tools
  • Find IIS Manager and double-click on it
http error 503 the service is unavailable IIS manager
  • Select Application Pools node
http error 503 the service is unavailable view application pools
  • Right-click on DefaultAppPool to check the status. If it is stopped, start it. If it is running, restart it and see if HTTP error 503 the service is unavailable is gone.
http error 503 default app pool
  • ALSO READ: 3 best browsers with VPN that don’t slow down Internet connection

4. Change Load User Profile

If the problem is the DefaultAppPool, change the ‘Load User Profile’ to false by doing the following:

  • Go to Control Panel
  • Select View By and click Large Icons
  • Click Administrative Tools
http error 503 the service is unavailable administrative tools
  • Find IIS Manager and double click on it
http error 503 double click on IIS
  • Select Application Pools node
http error 503 the service is unavailable application pools
  • Click on DefaultAppPool to select or highlight it
default app pool iis
  • On the right pane, select Advanced settings
advanced settings iis manager
  • Find Process Model
find process model iis
  • Go to Load User Profile
load user profile iis manager
  • Change from True to False
load user profile iis manager

5. Change Identity in Application Pool

  • Go to Control Panel
  • Select View By and click Large Icons
  • Click Administrative Tools
  • Find IIS Manager and double-click on it
  • Select Application Pools node
iis 503 error view application pools iis
  • Find the correct Application Pool for your website and click on it
  • Click Advanced Settings
iis 503 error advanced settings
  • Under Process Model, select Identity and change it, then enter a new user and password
iis 503 error fix identity
  • Click on your Application Pool again and select Recycle to restart it.
  1. Reload the website
  2. Restart your modem and your computer
  3. Clear the browser cache
  4. Check your proxy settings
  5. Restart the DefaultAppPool 
  • What does service temporarily unavailable mean?

The error message Service temporarily unavailable indicates the server is not available either due to overloading issues or scheduled maintenance work. This is only a temporary issue, the service should get back online once the problem has been solved.

How can I fix error 503 on specific services?

1. Fix Tachiyomi HTTP error 503

This error affects Manga fans since Tachiyomi is a popular Manga reader for Android. PC users can also use this app with the help of an emulator or a bootable USB device. Here’s how to fix error 503 on Tachiyomi:

  1. Update the app, and make sure you’re using the latest version.
  2. Reset your Internet connection, and restart your modem and computer.
  3. Go back to the chapter menu, reload a new chapter and resume reading.
  4. Open a manga from the catalog throwing error 503. Click on the menu and select the option that allows you to open it in the browser. Close the browser and the source should be fixed now.

2. Fix HTTP error 503 the service is unavailable in IIS

To fix error 503 on IIS, you can do so through the built-in Application Pool. IIS stands for Information System Security and can be easily modified through the following steps.

1. Enable IIS

  1. Press the Windows Key and type windows features in the search box.
  2. Click on the result to open the Windows Features tab.
  3. Check the box next to Internet Information Services to enable it.

2. Start the Application Pool

  1. Press the Windows Key and type control panel.
  2. Click on the result to open Control Panel.
  3. Select Administrative Tools from the list.
  4. Find IIS Manager and click on it.
  5. Click on View Application Pools from the actions tab.

3. Change the AppPool username and password

  1. Go to Server, select the Application Pools and select the Application Pool of your website.
  2. Go to Advanced Settings and select Identity.
  3. Enter a new username and password, click on your Application Pool again.
  4. Select Recycle to restart it.

4. Tweak the Load User Profile

  1. Open the Advanced Settings of the DefaultAppPool.
  2. Change the Load User Profile option to false as shown at step 4.

5. Delete the URL ACL

If the URL’s ACL is reserver somewhere else in the system, you’re bound to get error 503. Here’s how to fix that:

  1. Open the console command and enter the netsh http show urlacl command to dump all URL ACLs.
  2. If the command returns the URL that triggered error 503, delete it using the netsh http delete urlacl url=[Insert URL] command.

3. Fix urllib.error.httperror: http error 503: service unavailable

Here’s what you can do to fix urllib 503 errors:

  1. Reset your Internet connection. Or connect to a different network (eg: temporarily switch to your mobile hotspot).
  2. Replace urllib by curl

4. Fix www.netflix.com is currently unable to handle this request. HTTP error 503

We’re sure one of these solutions will help you fix the problem:

  1. Try a different Internet connection if available.
  2. Make sure your firewall settings are not blocking Netflix.
  3. Sign in to your Netflix account using another device.
  4. Clear your browser’s cache and cookies.

You may also want to try the solutions listed in this Netflix site error troubleshooting guide.

5. Fix Subsonic HTTP error 503

To fix error 503 on Subsonic, follow these steps:

  1. Clean your Subsonic database. But first, do keep a copy of your database folder. Then, open the subsonic.data file and deleted all the media entries. Keep only the settings.
  2. Reinstall the player.

Did any of these solutions help fix HTTP error 503? Let us know by leaving a comment in the section below.

newsletter icon

Newsletter

Источник

Learn how to get rid of this error for good

by Milan Stanojevic

Milan has been enthusiastic about technology ever since his childhood days, and this led him to take interest in all PC-related technologies. He’s a PC enthusiast and he… read more


Updated on January 26, 2023

Fact checked by
Alex Serban

Alex Serban

After moving away from the corporate work-style, Alex has found rewards in a lifestyle of constant analysis, team coordination and pestering his colleagues. Holding an MCSA Windows Server… read more

  • Browsers are essential tools for surfing the Internet, they are the middleman between your computer and the websites you visit.
  • There are plenty of different browsers on the market, each targetting specific user needs, but there is one thing that browsers have in common: error 503.
  • HTTP error 503: The service is unavailable is one of the most frequent error codes affecting browsers.

Strugling with your current browser? Upgrade to a better one: OperaYou deserve a better browser! 350 million people use Opera daily, a fully-fledged navigation experience that comes with various built-in packages, enhanced resource consumption and great design. Here’s what Opera can do:

  • Easy migration: use the Opera assistant to transfer exiting data, such as bookmarks, passwords, etc.
  • Optimize resource usage: your RAM memory is used more efficiently than in other browsers
  • Enhanced privacy: free and unlimited VPN integrated
  • No ads: built-in Ad Blocker speeds up loading of pages and protects against data-mining
  • Gaming friendly: Opera GX is the first and best browser for gaming
  • Download Opera

HTTP errors usually come in the form of status codes which are standard response codes that help you identify the cause of the problem given by a website server when either a web page or other resource fails to load properly while online.

Whenever you get an HTTP status code, it comes with the code itself, and the corresponding explanation such as HTTP error 503: The service is unavailable.

Something else you may want to keep in mind is that each of these codes, also known as browser errors, Internet error codes or Internet connection errors have its groups.

What is the HTTP error 503?

The HTTP 503 error falls under the 5xx server error group of HTTP status codes. They usually indicate that the web page or resource request is understood by the server, but the latter cannot fill it for one reason or another.

However, the HTTP error or status codes shouldn’t be confused with Device Manager errors or system error codes, because the latter is associated with different errors and meanings altogether.

When you get HTTP error 503, this usually points to the website’s server, which may have been compromised by an overload (temporarily) or it is too busy, or there’s some ongoing such as scheduled maintenance.

Fortunately, although this error comes up often, there are fairly quick solutions to fix the issue and get the website back online.

What is HTTP error 503 and how can I fix it?

  1. Preliminary checks
  2. Close your proxy server
  3. Start the destination application pool
  4. Change Load User Profile
  5. Change Identity in Application Pool

1. Preliminary checks

Whether the issue is with the server or your computer, there are some things you can try and check before fixing HTTP error 503: The service is unavailable. You could start by retrying the URL from the address bar by reloading or refreshing the page.

You can also restart your modem and router, then restart your computer or device – this is especially so if you see the ‘service unavailable – DNS failure’ message. If this doesn’t fix the error 503 DNS issue, pick new DNS servers and change them on your PC or router.

Check with the website itself directly for assistance as they may be aware of the error 503, so they may let you know if it is an issue that’s with everyone, not just you. Sometimes waiting it out is the easiest fix to this error.

  • ALSO READ: 4 best browsers with built-in VPN you should use today

2. Close your proxy server

Perhaps you use a VPN or a proxy server, in which case, you need to check whether the connection is working the way it should, or properly. If the proxy server is down, then you may end up getting the HTTP error 503: The service is unavailable message.

This usually happens with free proxy servers, but if you do not use a proxy server, you can disable it and then try to open the website that is showing the HTTP error 503 the service is unavailable.

3. Start the destination application pool

If the application pool of the corresponding web application is stopped, or disabled, it causes the website to show HTTP error 503: The service is unavailable.

Additionally, any misconfiguration in the application pool or site settings can cause an error on the site. Process crashes also happen due to incorrect application logic.

Sometimes the user account related to the user identity of an application pool can be locked or has an expired password or even inadequate privileges which tamper with the functioning of the website.

Some PC issues are hard to tackle, especially when it comes to corrupted repositories or missing Windows files. If you are having troubles fixing an error, your system may be partially broken.
We recommend installing Restoro, a tool that will scan your machine and identify what the fault is.
Click here to download and start repairing.

If the application pool runs out of RAM or other resources, it can crash and lead to HTTP error 503, plus server migrations also lead to such errors.

If HTTP error 503 the service is unavailable is caused by a stopped application pool, starting it would resolve the issue.

  • Click Start
  • In the search bar, type Windows Features
  • Select Turn Windows Features on or off
http error 503 the service is unavailable turn windows features off
  • Locate Internet Information Services and check the box – this will install everything you need to use IIS
http error 503 the service is unavailable locate internet information services
  • Go to Control Panel
http error 503 the service is unavailable control panel
  • Select View By and click Large Icons
  • Click Administrative Tools
http error 503 administrative tools
  • Find IIS Manager and double-click on it
http error 503 the service is unavailable IIS manager
  • Select Application Pools node
http error 503 the service is unavailable view application pools
  • Right-click on DefaultAppPool to check the status. If it is stopped, start it. If it is running, restart it and see if HTTP error 503 the service is unavailable is gone.
http error 503 default app pool
  • ALSO READ: 3 best browsers with VPN that don’t slow down Internet connection

4. Change Load User Profile

If the problem is the DefaultAppPool, change the ‘Load User Profile’ to false by doing the following:

  • Go to Control Panel
  • Select View By and click Large Icons
  • Click Administrative Tools
http error 503 the service is unavailable administrative tools
  • Find IIS Manager and double click on it
http error 503 double click on IIS
  • Select Application Pools node
http error 503 the service is unavailable application pools
  • Click on DefaultAppPool to select or highlight it
default app pool iis
  • On the right pane, select Advanced settings
advanced settings iis manager
  • Find Process Model
find process model iis
  • Go to Load User Profile
load user profile iis manager
  • Change from True to False
load user profile iis manager

5. Change Identity in Application Pool

  • Go to Control Panel
  • Select View By and click Large Icons
  • Click Administrative Tools
  • Find IIS Manager and double-click on it
  • Select Application Pools node
iis 503 error view application pools iis
  • Find the correct Application Pool for your website and click on it
  • Click Advanced Settings
iis 503 error advanced settings
  • Under Process Model, select Identity and change it, then enter a new user and password
iis 503 error fix identity
  • Click on your Application Pool again and select Recycle to restart it.
  1. Reload the website
  2. Restart your modem and your computer
  3. Clear the browser cache
  4. Check your proxy settings
  5. Restart the DefaultAppPool 
  • What does service temporarily unavailable mean?

The error message Service temporarily unavailable indicates the server is not available either due to overloading issues or scheduled maintenance work. This is only a temporary issue, the service should get back online once the problem has been solved.

How can I fix error 503 on specific services?

1. Fix Tachiyomi HTTP error 503

This error affects Manga fans since Tachiyomi is a popular Manga reader for Android. PC users can also use this app with the help of an emulator or a bootable USB device. Here’s how to fix error 503 on Tachiyomi:

  1. Update the app, and make sure you’re using the latest version.
  2. Reset your Internet connection, and restart your modem and computer.
  3. Go back to the chapter menu, reload a new chapter and resume reading.
  4. Open a manga from the catalog throwing error 503. Click on the menu and select the option that allows you to open it in the browser. Close the browser and the source should be fixed now.

2. Fix HTTP error 503 the service is unavailable in IIS

To fix error 503 on IIS, you can do so through the built-in Application Pool. IIS stands for Information System Security and can be easily modified through the following steps.

1. Enable IIS

  1. Press the Windows Key and type windows features in the search box.
  2. Click on the result to open the Windows Features tab.
  3. Check the box next to Internet Information Services to enable it.

2. Start the Application Pool

  1. Press the Windows Key and type control panel.
  2. Click on the result to open Control Panel.
  3. Select Administrative Tools from the list.
  4. Find IIS Manager and click on it.
  5. Click on View Application Pools from the actions tab.

3. Change the AppPool username and password

  1. Go to Server, select the Application Pools and select the Application Pool of your website.
  2. Go to Advanced Settings and select Identity.
  3. Enter a new username and password, click on your Application Pool again.
  4. Select Recycle to restart it.

4. Tweak the Load User Profile

  1. Open the Advanced Settings of the DefaultAppPool.
  2. Change the Load User Profile option to false as shown at step 4.

5. Delete the URL ACL

If the URL’s ACL is reserver somewhere else in the system, you’re bound to get error 503. Here’s how to fix that:

  1. Open the console command and enter the netsh http show urlacl command to dump all URL ACLs.
  2. If the command returns the URL that triggered error 503, delete it using the netsh http delete urlacl url=[Insert URL] command.

3. Fix urllib.error.httperror: http error 503: service unavailable

Here’s what you can do to fix urllib 503 errors:

  1. Reset your Internet connection. Or connect to a different network (eg: temporarily switch to your mobile hotspot).
  2. Replace urllib by curl

4. Fix www.netflix.com is currently unable to handle this request. HTTP error 503

We’re sure one of these solutions will help you fix the problem:

  1. Try a different Internet connection if available.
  2. Make sure your firewall settings are not blocking Netflix.
  3. Sign in to your Netflix account using another device.
  4. Clear your browser’s cache and cookies.

You may also want to try the solutions listed in this Netflix site error troubleshooting guide.

5. Fix Subsonic HTTP error 503

To fix error 503 on Subsonic, follow these steps:

  1. Clean your Subsonic database. But first, do keep a copy of your database folder. Then, open the subsonic.data file and deleted all the media entries. Keep only the settings.
  2. Reinstall the player.

Did any of these solutions help fix HTTP error 503? Let us know by leaving a comment in the section below.

newsletter icon

Newsletter

Источник

Понравилась статья? Поделить с друзьями:

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

  • Мой процессор не поддерживает windows 11 как исправить
  • Мой парень быстро заканчивает как это исправить
  • Мой отчет был полон ошибок перевод на английский дуолинго
  • Мой налог произошла внутренняя ошибка во время обращения к серверу есиа
  • Мой налог ошибка оплаты что делать

    • 0 0 голоса
    Рейтинг статьи
    Подписаться
    Уведомить о
    guest

    0 комментариев
    Старые
    Новые Популярные
    Межтекстовые Отзывы
    Посмотреть все комментарии