Merge pull request #2079 from EDI-N/Kolya_ua

Adjustment_Act+api_cert_errors
EDI-N · Feb 13, 2024 · 1f06a38 · 1f06a38
2 parents d8d1967 + d574e2e
commit 1f06a38
Show file tree

Hide file tree

Showing 21 changed files with 214 additions and 2 deletions.
diff --git a/docs/API_ETTNv3_1/Work_with_API/AdjustmentActv3_API_work.rst b/docs/API_ETTNv3_1/Work_with_API/AdjustmentActv3_API_work.rst
@@ -26,7 +26,7 @@
 .. raw:: html
 
     <embed>
-    <iframe src="https://docs.google.com/spreadsheets/d/e/2PACX-1vR4frexHTOelX507gkoPfGk_2ewyRR5FHCiEneMoo1khyjPVcV9631kkj-SbkVgtEJj5LZnhVP4B2qb/pubhtml?gid=2079309782&single=true&range=A2:E8" width="1100" height="300" frameborder="0" marginheight="0" marginwidth="0">Loading...</iframe>
+    <iframe src="https://docs.google.com/spreadsheets/d/e/2PACX-1vR4frexHTOelX507gkoPfGk_2ewyRR5FHCiEneMoo1khyjPVcV9631kkj-SbkVgtEJj5LZnhVP4B2qb/pubhtml?gid=2079309782&single=true&range=A2:E8" width="1100" height="1800" frameborder="0" marginheight="0" marginwidth="0">Loading...</iframe>
     </embed>
 
 .. important::

diff --git a/docs/Certificate/EDIN_2_0/APIv2/API_Certificate_v2_list.rst b/docs/Certificate/EDIN_2_0/APIv2/API_Certificate_v2_list.rst
@@ -94,6 +94,16 @@
 
 ---------------------------------
 
+.. _cert-errors:
+
+Опис помилок сервісу "Е-Сертифікати"
+=========================================================================================
+
+.. csv-table:: 
+  :file: cert_errors.csv
+  :widths:  10, 20, 20, 40
+  :stub-columns: 0
+
 .. _main-errors:
 
 Загальні помилки при роботі з API (всі сервіси EDIN)

diff --git a/docs/Certificate/EDIN_2_0/APIv2/cert_errors.csv b/docs/Certificate/EDIN_2_0/APIv2/cert_errors.csv
@@ -0,0 +1,13 @@
+**Код відповіді**,**Індекс помилки**,**Текст помилки**,**Опис**
+400,ERR_CRT-1,"Unknown certificate type: %s
+
+Тип сертифіката некоректний: %s","Невідомий тип сертифікату при зміні типу доступу (PUT, «/api/ecs/access»)"
+400,ERR_CRT-2,"Search query error: %s
+
+Помилка пошукового запиту: %s","Некоректне тіло запиту (POST, «/api/ecs/search»)"
+400,ERR_CRT-3,"Certificate with UUID [%s] not found
+
+Сертифікат із указаним UUID [%s] не знайдено","Сертифікат не знайдено (GET, «/api/ecs/certificate»)"
+400,ERR_CRT-4,"Data validation errors detected
+
+Виявлено помилки при обробленні даних","Помилки при опрацюванні сертифікатів завантажених із excel (POST, «/api/ecs/certificates»)"
diff --git a/docs/ETTN_3_0/Create_Adjustment_Act_from.rst b/docs/ETTN_3_0/Create_Adjustment_Act_from.rst
@@ -0,0 +1,184 @@
+Створення "Акта коригування" до е-ТТН
+###################################################################################################
+
+.. картинки в текст
+
+.. |лупа| image:: /_constant/icons/magnifying_glass.png
+
+.. |будинок| image:: /_constant/icons/house.png
+
+.. |pencil_stencil| image:: /_constant/icons/pencil_stencil.png
+
+.. |лупа2| image:: /_constant/icons/magnifying_glass2.png
+
+.. role:: red
+
+.. role:: green
+
+.. role:: orange
+
+.. role:: underline
+
+.. contents:: Зміст:
+   :depth: 3
+
+---------
+
+В разі виявлення помилки в реквізитах "е-ТТН" є можливість створити і зберегти "Акт коригування", щоб зафіксувати в ньому правильні реквізити "е-ТТН".
+
+Серед передбачених в сервісі "EDI Network" ролей учасників ініціатором "Акта коригування" може виступати: **"Замовник"**, **"Вантажовідправник"**, **"Перевізник/Водій"**, **"Вантажоодержувач"**. 
+
+.. attention::
+   Акт коригування складається Замовником або будь-яким іншим учасником е-ТТН, що ініціює виправлення помилки. В залежності від стадії перевезення набір сторін-підписувачів може змінюватись. Так, **Акт підписується всіма учасниками перевезення, які заявлені в мета-даних е-ТТН і накладали свій підпис на документ у процесі перевезення** , при цьому учасники, які ще не накладали підпис на е-ТТН (наприклад, Вантажоодержувач), можуть не підписувати Акт.
+
+.. приховали через неточність:
+
+   Схема і послідовність підписання документа "Акт коригування" в залежності від ролі Ініціатора:
+
+   1) "Вантажовідправник" **=>** :green:`"Вантажовідправник" -> "Перевізник" -> "Вантажоодержувач"` (3 підписанти)
+
+   2) "Перевізник" **=>** :green:`"Перевізник" -> "Вантажовідправник" -> "Вантажоодержувач"` (3 підписанти)
+
+   3) "Вантажоодержувач" **=>** :green:`"Вантажоодержувач" -> "Вантажовідправник" -> "Перевізник"` (3 підписанти)
+
+   4) "Замовник" **=>** :green:`"Замовник" -> "Вантажовідправник" -> "Перевізник" -> "Вантажоодержувач"` (4 підписанти)
+
+"Акт коригування" створюється на підставі "е-ТТН", що вже підписаний **Перевізником** (документ має статус :orange:`"Очікує підписання вантажоодержувачем"`) чи **Вантажоодержувачем** (документ має статус :green:`"Підписано вантажоодержувачем"`).
+
+.. _create-from-ttn:
+
+**1 Створення "Акта коригування" на підставі "е-ТТН"**
+================================================================================================================================
+
+Розглянемо створення "Акта коригування" в сервісі "EDI Network" з боку **Перевізника** на прикладі підписаного трьома сторонами "е-ТТН" (в статусі :green:`"Підписано вантажоодержувачем"`):
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_001.png
+   :align: center
+
+У відкритому документі натисніть **"Створити документ"** "Акт коригування" в блоці `ланцюжка документів <https://wiki.edin.ua/uk/latest/_constant/chain/chain.html>`__:
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_002.png
+   :align: center
+
+При створенні документа "Акта коригування" його форма в значній мірі автоматично заповнюється даними (дані **"Перевізника"**, **"Вантажовідправника"**, **"Водія"**, **"Замовника"**, **"Вантажоодержувача"**) з "е-ТТН", як документа-підстави: 
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_003.png
+   :align: center
+
+Потрібно зазначити номер Акта (автоматично проставляється поточна дата та час створення документа) та місце його складання (обов'язкові до заповнення поля позначені червоною зірочкою :red:`*`). "Акт коригування" складається з незмінного блоку з даними "е-ТТН" та **Даних до коригування** - дані в цьому блоці також заповнюються, але доступні до редагування:
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_004.png
+   :align: center
+
+При коригуванні даних **"Перевізника"** / **"Замовника"** / **"Вантажовідправника"** / **"Вантажоодержувача"** відкривається модальне вікно **"Дані компанії"** для **"Зміни"** одного чи кількох полів блоку контрагента:
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_005.png
+   :align: center
+
+При коригуванні даних **"Водія"** в модальнму вікні **"Відповідальної особи"** можливо **"Змінити"** ПІБ та/або номер телефону:
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_006.png
+   :align: center
+
+При коригуванні даних **"Пункту завантаження"** / **"Пункту розвантаження"** в модальнму вікні **"Місцезнаходження"** можливо **"Змінити"** назву та адресу пункту:
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_007.png
+   :align: center
+
+Для коригування **Відомостей про вантаж** (табличну частину) потрібно натиснути **"Змінити"** навпроти бажаної позиції, внести зміни в модальному вікні з даними та **"Змінити"**, натиснувши одноіменну кнопку:
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_008.png
+   :align: center
+
+До кожної позиції також можливо змінити чи **"+Додати"** дані про документ з вантажем:
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_009.gif
+   :align: center
+
+Для коригування дати і часу **Вантажно-розвантажувальних операцій** передбачений зручний календар та годинник: 
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_010.png
+   :align: center
+
+При формуванні "Акта коригування" обов'язково заповнюється поле **"Додаткова інформація"** з описом причини складання Акта!
+
+В документі також обов'язково зазначається відповідальна/-ні особи **Ініціатора** акта (в нашому прикладі **"Перевізника"**) за допомогою кнопки **"+Додати"**. Дані раніше доданих відповідальних осіб можливо обрати з віртуального довідника:
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_011.png
+   :align: center
+
+Довідник автоматично наповнюється при додаванні нового відповідального (кнопка **"+Додати особу"**). При додаванні нового відповідального в модальному вікні потрібно заповнити обов'язкові контактні дані (обов'язкові поля позначені червоною зірочкою :red:`*`).
+
+Редагувати дані раніше введених осіб можливо за допомогою кнопки **"Змінити"** (|pencil_stencil|):
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_012.png
+   :align: center
+
+За потреби можливо **"Обрати"** (|лупа2|) іншу особу замість обраної/доданої раніше.
+
+Після того, як обов'язкові дані будуть введені потрібно **"Зберегти"**, **"Підписати"** та **"Надіслати"** документ (кнопки в правій верхній частині форми документа відображаються для виконання потрібної дії):
+
+.. image:: /_constant/signing/universal_button.gif
+   :align: center
+
+.. _sign:
+
+**1.1 Підписання та відправка "Акта коригування" Ініціатором**
+------------------------------------------------------------------------------------------------------------
+
+.. include:: /_constant/atb_check/atb_check.rst
+   :start-after: .. початок блоку для ATB_check
+   :end-before: .. кінець блоку для ATB_check
+
+.. tabs::
+
+   .. tab:: Файловий ключ
+
+      .. include:: /_constant/signing/signing.rst
+         :start-after: .. початок блоку для Signing
+         :end-before: .. кінець блоку для Signing
+
+   .. tab:: Token
+
+      .. include:: /_constant/token_signing/token_signing.rst
+         :start-after: .. початок блоку для TokenSign
+         :end-before: .. кінець блоку для TokenSign
+
+   .. tab:: Гряда
+
+      .. include:: /_constant/gryada_signing/gryada_signing.rst
+         :start-after: .. початок блоку для GryadaSign
+         :end-before: .. кінець блоку для GryadaSign
+
+   .. tab:: Дія.Підпис
+
+      .. include:: /_constant/diya_signing/diya_signing.rst
+         :start-after: .. початок блоку для DiyaPidps
+         :end-before: .. кінець блоку для DiyaPidps
+
+   .. tab:: Cloud
+
+      .. include:: /_constant/cloud_signing/cloud_signing.rst
+         :start-after: .. початок блоку для CloudSign
+         :end-before: .. кінець блоку для CloudSign
+
+Після підписання "Акта коригування" відображається "Інформація про підписантів", а документ можливо **"Надіслати"**:
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_013.png
+   :align: center
+
+Після відправки автоматично відкривається папка **"Надіслані"**, де надісланий акт відображається зі статусом :orange:`"Очікує на підписання отримувачем"`:
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_014.png
+   :align: center
+
+Після відправки у пов'язаного документа "е-ТТН" при його перегляді в блоці `ланцюжка документів <https://wiki.edin.ua/uk/latest/_constant/chain/chain.html>`__ відобрається створений Акт і виводиться повідомлення про обмежені дії з документом до кінця життєвого циклу акта (поки всі учасники "Акта коригування" не підпишуть документ або один з учасників не відхилить документ):
+
+.. image:: pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_015.png
+   :align: center
+
+-------------------------------------
+
+.. include:: /_constant/kontakti.rst
+
+
diff --git a/docs/ETTN_3_0/Create_Stop_Act_from.rst b/docs/ETTN_3_0/Create_Stop_Act_from.rst
@@ -79,7 +79,6 @@
 .. image:: /_constant/signing/universal_button.gif
    :align: center
 
-
 .. _sign:
 
 **1.1 Підписання та відправка "Акта примусового завершення" "Замовником"**

diff --git a/docs/ETTN_3_0/ETTN_3_0_list.rst b/docs/ETTN_3_0/ETTN_3_0_list.rst
@@ -117,7 +117,13 @@
    Processing_Stop_Act
    Stop_Act_Reject
 
+.. _adjustment-act:
 
+.. toctree::
+   :maxdepth: 1
+   :caption: Акт коригування
+
+   Create_Adjustment_Act_from
 
 
 

diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_001.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_001.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_002.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_002.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_003.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_003.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_004.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_004.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_005.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_005.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_006.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_006.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_007.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_007.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_008.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_008.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_009.gif b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_009.gif
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_010.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_010.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_011.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_011.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_012.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_012.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_013.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_013.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_014.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_014.png
diff --git a/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_015.png b/docs/ETTN_3_0/pics_Create_Adjustment_Act_from/Create_Adjustment_Act_from_015.png