FMSS worklogic helper

Гражданин РФ

1. При нажатии на кнопку Регистрация в фолио или на последнем шаге Мастера. Нужно запустить функцию add. Если получен хеш, то переходим к пункту 2. Если не получен. То выдаем статус -1. В описании отправки нужно писать Текст, который идет в строчке [message] =>, само слова message писать не нужно. Появляется возможность опять нажать на кнопку Регистрация. При ее нажатии опять начинается с пункта 1.
2. Делаем функцию stat и если
2.1. в теге [Value] => Есть слово «Ошибка» например «Ошибка постановки», то выдаем статус -1, и в описание ошибки даем текст тегов [Value] => и [message] =>. Без самих этих тегов. Появляется возможность опять нажать на кнопку Регистрация. При ее нажатии опять начинается с пункта 1.
2.2. Если после [Value] => нет слова Ошибка, например Не отправлен, то ставим статус 1. И переходим к следующему пункту.
3. Делаем функцию reg, в ответ получаем sended. Ставим статус 2. Делаем функцию stat и пишем в описание отправки сообщение в строчке тега [Value] => например На постановке
4. Если пришел пуш с ошибкой……………с 1-ого пункта.
4.1. Если пуш не пришел, запускаьт функцию stat раз в 8 часов до изменения статуса.
4.2. Если пришел пуш с успехом, то статус меняется на 3…В запросе stat в поле [Value] => должо быть «Поставлен на учёт» . В описании статуса нужно описание ставить тегов Value и Message.
4.2.1. Если дата выезда после отправки (п 2.2.) меняется в сторону более раннего выезда. То по наступлению этой даты запускаем функцию unreg. После ее запуска возвращается текст sended. При проверке stat появляется Пример: [Value] => На снятии [Message] => 25.10.2022 отправлено через ЕПГУ №2239754443
4.2.2. Ожидаем пуш и делаем функцию раз в 8 часов до изменения статуса или прихода пуша. Ставим статус 7 по окончании. Или -7, если пришла ошибка.
4.3. При наступлении даты, когда выехал гость, ожидаем пуш на снятие и включаем функцию stаt раз в 8 часов. (То есть делаем пункт 4.2.2.)
4.4. Когда пришел пуш или поменялся статус, ставим 7. Пример статуса без ошибки: [Value] => Снят с учёта [Message] => 25.10.2022 отправлено через ЕПГУ №2239754443 При ошибке статус -7. Описание статуса с ошибкой или успешного берем из тегов [Value] и [Message]

Иностранец

1. При нажатии на кнопку Регистрация в фолио или на последнем шаге Мастера. Нужно запустить функцию add. Если получен хеш, то переходим к пункту 2. Если не получен. То выдаем статус -1. В описании отправки нужно писать Текст, который идет в строчке [message] =>, само слова message писать не нужно. Появляется возможность опять нажать на кнопку Регистрация. При ее нажатии опять начинается с пункта 1.
2. Если есть изображение, прикрепленное к гостю или несколько, то делаем функцию add_scan и переходим к пункту 3. Если нет изображения, то сразу переходим к пункту 3. Думаю можно не проверять наличие изображения, просто запускать сразу эту функцию.
3. Делаем функцию stat и если
3.1. в теге [Value] => Есть слово «Ошибка» например «Ошибка постановки», то выдаем статус -1, и в описание ошибки даем текст тегов [Value] => и [message] =>. Без самих этих тегов. Появляется возможность опять нажать на кнопку Регистрация. При ее нажатии опять начинается с пункта 1.
3.2. Если после [Value] => нет слова Ошибка, например Не отправлен, то ставим статус 1. И переходим к следующему пункту.
4. Делаем функцию reg, в ответ получаем sended. Ставим статус 2. Делаем функцию stat и пишем в описание отправки сообщение в строчке тега [Value] => например На постановке
5. Если пришел пуш с ошибкой……………с 1-ого пункта.
5.1. Если пуш не пришел, запускаьт функцию stat раз в 8 часов до изменения статуса.
5.2. Если пришел пуш с успехом, то статус меняется на 3 ….В запросе stat в поле [Value] => должо быть «Поставлен на учёт» . В описании статуса нужно описание ставить тегов Value и Message.
5.2.1. Если дата выезда после отправки (п 2.2.) меняется в сторону более раннего выезда. То по наступлению этой даты запускаем функцию unreg. После ее запуска возвращается текст sended. При проверке stat появляется Пример: [Value] => На снятии [Message] => 25.10.2022 отправлено через ЕПГУ №2239754443
5.2.2. Ожидаем пуш и делаем функцию раз в 8 часов до изменения статуса или прихода пуша. Ставим статус 7 по окончании. Или -7, если пришла ошибка.
5.3. При наступлении даты, когда выехал гость, ожидаем пуш на снятие и включаем функцию stаt раз в 8 часов. (То есть делаем пункт 5.2.2.)
5.4. Когда пришел пуш или поменялся статус, ставим 7. Пример статуса без ошибки: [Value] => Снят с учёта [Message] => 25.10.2022 отправлено через ЕПГУ №2239754443 При ошибке статус -7. Описание статуса с ошибкой или успешного берем из тегов [Value] и [Message]

ТЕЗИСЫ О РАБОТЕ АПИ

- если вернулась ошибка, то приходит пуш с ошибкой. Посмотреть описание ошибки можно по запросу stat
- unreg нужен только если гражданин выезжает досрочно
- editStayPeriod нужен только если гражданин не отправлен и ни разу не был отправлен, но уже добавлен
- редактирование ошибки происходит через edit, а также редактирование данных если не был отправлен еще, но добавлен уже
- если пишет что номер комнаты не указан или адрес не указан, то это нормально и не ошибка
- extend – это продление
Продление это действительно новое дело. Создать его можно несколькими способами. ExtensionPerson один из них. Для ExtensionPerson вам нужно после первой постановки сохранять номер дела(идентификатор гражданина который возвращает АПИ) и случае продления отправлять этот номер и новые даты проживания. *Пример. Человек жил с 9.06.2022 по 11.06.2022 и продлил проживание до 15.06.2022 в запросе ExtensionPerson даты будут 11.06.2022 15.06.2022. API вернёт номер нового дела, у которого будут даты 11.06.2022 15.06.2022
EditStayPeriodToPerson - это не продление, а редактирование даты, работает только если гражданин не отправлялся на учёт.
Так же есть ещё 2 варианта про которые не сказано.
1) Вы создаёте запрос на добавление AddPersonNew высчитывая новый промежуток сами. *Пример. Человек жил с 9.06.2022 по 11.06.2022 и продлил проживание до 15.06.2022 в запросе даты будут 11.06.2022 15.06.2022

2) *Нужно тестировать* Вы ещё раз отправляете запрос AddPersonNew на этого человека со всеми теми же данными(и вашим уникальным идентификатором гражданина), за исключением даты выезда. API должен сам вычислить новый промежуток дат. *Пример. Человек жил с 9.06.2022 по 11.06.2022 и продлил проживание до 15.06.2022 в запросе даты будут 9.06.2022 15.06.2022. API вернёт номер нового дела, у которого будут даты 11.06.2022 15.06.2022 если найдёт его прошлое дело
UnregPerson это досрочное снятие. К примеру анкета была с 9.07.2022 15.07.2022. Если отправить UnregPerson сейчас(12.07.2022) дата выезда будет изменена на 12.07.2022
Редактировать через AddPesonNew можно если позволяет статус гражданина и дата въезда/выезда совпадает

ВОПРОСЫ

1. если хеш получен после addNewPerson, значит ошибок нет, все данные добавлены и можно отправлять на регистрацию?
Нет, гражданин может добавится с ошибкой. После добавление надо проверить статус гражданина.
2. как приходит пуш об ошибке от МВД?
3. как приходит пуш об успешной регистрации от МВД?
4. можно не пользоваться edit, если нужно добавленного гражданина редактировать, так как add тоже редактирует и добавляет?

ЛОГИКА РАБОТЫ СКАЛА

Гражданин РФ

Иностранец

ТЕЗИСЫ О РАБОТЕ АПИ

ВОПРОСЫ