Merge pull request #2112 from EDI-N/Kolya_ua

transport_renew

docs/API_ETTN/Methods/EveryBody/GetEttnBodyFinalExample.rst

@@ -25,7 +25,7 @@
 	        "DOCUMENT_PLACE": "test",
 	        "R01G1S": "Тестовая марка 2",
 	        "R01G11S": "Тестовая модель 2",
-	        "R01G2S": "АА0001АА",
+	        "R01G2S": "AA0001AA",
 	        "R01G3S": "Тестовый тип 2",
 	        "R01G10S": "централізоване перевезення",
 	        "R02G11S": "31600022",

docs/API_ETTNv3_1/API_ETTNv3_1_list.rst

@@ -78,6 +78,10 @@
 +-----------+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | PATCH     | ``/api/eds/docs``               | `Видалити документи-чернетки <https://wiki.edin.ua/uk/latest/integration_2_0/APIv2/Methods/DeleteDocuments.html>`__                                                       |
 +-----------+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| GET       | ``/api/oas/v2/transport``       | :doc:`/API_ETTNv3_1/Methods/GetTransport`                                                                                                                                 |
++-----------+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| POST      | ``/api/oas/v2/transport``       | :doc:`/API_ETTNv3_1/Methods/PostTransport`                                                                                                                                |
++-----------+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
 .. beauty list
 
@@ -91,6 +95,8 @@
    /integration_2_0/APIv2/Methods/GetDocument
    Methods/GetEttnSignInfo
    /integration_2_0/APIv2/Methods/DeleteDocuments
+   Methods/GetTransport
+   Methods/PostTransport
 
 .. _ecmr-ttn:
 

docs/API_ETTNv3_1/Methods/EveryBody/Transport.rst

@@ -0,0 +1,31 @@
+############################################################################################################################
+**Дані транспортного засобу (об'єкт Transport)**
+############################################################################################################################
+
+**JSON:**
+
+.. code:: json
+
+  {
+    "number": "AA0000AA",
+    "brand": "Тестовий траспорт",
+    "model": "модель модель",
+    "type": "Тип",
+    "color": "брудний",
+    "isTrailer": 0
+  }
+
+Таблиця 1 - Опис параметрів об'єкта **Transport**
+
+.. csv-table:: 
+  :file: for_csv/Transport.csv
+  :widths:  1, 5, 12, 41
+  :header-rows: 1
+  :stub-columns: 0
+
+-------------------------
+
+.. [#] Під визначенням колонки **Тип поля** мається на увазі скорочене позначення:
+
+   * M (mandatory) — обов'язкові до заповнення поля;
+   * O (optional) — необов'язкові (опціональні) до заповнення поля.

docs/API_ETTNv3_1/Methods/EveryBody/Transports.rst

@@ -0,0 +1,174 @@
+############################################################################################################################
+**Дані знайдених транспортних засобів (масив об'єктів Transport)**
+############################################################################################################################
+
+**JSON:**
+
+.. code:: json
+
+  [
+      {
+          "id": 93,
+          "number": "AA0000AA",
+          "brand": "Тестовий траспорт",
+          "model": "модель модель",
+          "type": "Тип",
+          "color": "брудний",
+          "isTrailer": 1
+      },
+      {
+          "id": 104,
+          "number": "AA0001AA",
+          "brand": "Trailer",
+          "model": "Модель",
+          "type": "Trailer",
+          "color": "lime",
+          "isTrailer": 2
+      },
+      {
+          "id": 130,
+          "number": "AA0020XH",
+          "brand": "1",
+          "model": "SCHMITZ",
+          "type": "рефрижератор",
+          "isTrailer": 0
+      },
+      {
+          "id": 150,
+          "number": "AA0000",
+          "brand": "vv",
+          "model": "78",
+          "type": "вантажний",
+          "isTrailer": 2
+      },
+      {
+          "id": 265,
+          "number": "AA0099BB",
+          "brand": "hyundai",
+          "type": "вантажний",
+          "isTrailer": 0
+      },
+      {
+          "id": 266,
+          "number": "AA0098AП",
+          "brand": "Renault",
+          "type": "грузовий",
+          "isTrailer": 0
+      },
+      {
+          "id": 267,
+          "number": "AA0002BA",
+          "brand": "Hyundai",
+          "type": "тестовий",
+          "isTrailer": 0
+      },
+      {
+          "id": 273,
+          "number": "AA0011AA",
+          "brand": "тест",
+          "model": "тест",
+          "type": "тягач",
+          "color": "Синій, Текст,ТекстекстТекстТекстТекст",
+          "isTrailer": 0
+      },
+      {
+          "id": 274,
+          "number": "AA0011BB",
+          "brand": "тест",
+          "model": "тест",
+          "type": "тягач",
+          "isTrailer": 0
+      },
+      {
+          "id": 431,
+          "number": "AA0003AA",
+          "brand": "Ferrari",
+          "model": "F40",
+          "type": "cabriolet",
+          "color": "yellow",
+          "isTrailer": 0
+      },
+      {
+          "id": 435,
+          "number": "AA0000BB",
+          "brand": "Марка",
+          "model": "Модель",
+          "type": "Тип",
+          "isTrailer": 0
+      },
+      {
+          "id": 457,
+          "number": "AA0000123AA",
+          "brand": "Mazda",
+          "model": "R8",
+          "type": "Fast",
+          "color": "Black",
+          "isTrailer": 0
+      },
+      {
+          "id": 495,
+          "number": "AA00000AA",
+          "brand": "Ferrari",
+          "model": "F40",
+          "type": "cabriolet",
+          "color": "yellow",
+          "isTrailer": 0
+      },
+      {
+          "id": 501,
+          "number": "AA001100AA",
+          "brand": "test1",
+          "model": "test2",
+          "type": "test3",
+          "isTrailer": 0
+      },
+      {
+          "id": 575,
+          "number": "AA000001AB",
+          "brand": "testMarka",
+          "model": "testModel",
+          "type": "testTypeCar",
+          "color": "testColorCar",
+          "isTrailer": 0
+      },
+      {
+          "id": 577,
+          "number": "AA000002BB",
+          "brand": "testMarka2",
+          "model": "testModel2",
+          "type": "testType2",
+          "isTrailer": 1
+      },
+      {
+          "id": 579,
+          "number": "AA000003BB",
+          "brand": "testMarka3",
+          "model": "testModel3",
+          "type": "testType3",
+          "isTrailer": 1
+      },
+      {
+          "id": 613,
+          "number": "AA00001AA",
+          "brand": "AUTO",
+          "model": "AUTO",
+          "type": "AUTO",
+          "color": "AUTO",
+          "isTrailer": 0
+      }
+  ]
+
+Таблиця 1 - Опис параметрів об'єкта **Transport**
+
+.. csv-table:: 
+  :file: for_csv/Transport.csv
+  :widths:  1, 5, 12, 41
+  :header-rows: 1
+  :stub-columns: 0
+
+-------------------------
+
+.. [#] Під визначенням колонки **Тип поля** мається на увазі скорочене позначення:
+
+   * M (mandatory) — обов'язкові до заповнення поля;
+   * O (optional) — необов'язкові (опціональні) до заповнення поля.

docs/API_ETTNv3_1/Methods/EveryBody/for_csv/Transport.csv

@@ -0,0 +1,17 @@
+Параметр,Тип [1]_,Формат,Опис
+.. _Transport:,,Об'єкт **Transport**,
+id,,long,ідентифікатор транспортного засобу
+number,M,String,номер транспортного засобу (у літеросполученні допускається лише латинниця (case sensitive)) в форматі «AA0001AA»
+brand,M,String,марка транспортного засобу («Hyundai»)
+model,M,String,модель транспортного засобу («HD 78»)
+type,M,String,тип транспортного засобу («рефрижератор»)
+color,O,String,колір транспортного засобу
+length,O,String,довжина транспортного засобу
+width,O,String,ширина транспортного засобу
+height,O,String,висота транспортного засобу
+weight,O,String,вага транспортного засобу
+isTrailer,O,int,"відмітка про тип транспортного засобу:
+
+* 0 - авто (за замовчуванням)
+* 1 - причіп
+* 2 - напівпричіп"

docs/API_ETTNv3_1/Methods/GetTransport.csv

@@ -0,0 +1,7 @@
+**URL**       ,
+Метод запиту  , GET                                          
+URL запиту    ,**/api/oas/v2/transport?transport_number=AA00**
+URL параметри ,"**transport_number** (обов'язково) String - номер транспортного засобу (у літеросполученні допускається лише латинниця) від 4 символів. Так номер **AA0001AA** користувач може знайти за ``AA00, 0001, 01AA, ...``"
+**Headers**   ,
+Authorization ,"**SID** - токен, отриманий при `авторизації <https://wiki.edin.ua/uk/latest/integration_2_0/APIv2/Methods/Authorization.html>`__"
+Content-Type  , *application/json*

docs/API_ETTNv3_1/Methods/GetTransport.rst

@@ -0,0 +1,15 @@
+#########################################################################################################
+**Пошук транспортного засобу з Вашого довідника транспортних засобів**
+#########################################################################################################
+
+Для роботи з цим методом користувач повинен бути `авторизованим <https://wiki.edin.ua/uk/latest/integration_2_0/APIv2/Methods/Authorization.html>`__.
+
+.. csv-table:: 
+  :file: GetTransport.csv
+  :widths:  10, 41
+  :stub-columns: 0
+
+**RESPONSE**
+
+У тілі **відповіді** з довідника передаються дані знайдених `транспортних засобів <https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Methods/EveryBody/Transports.html>`__ (масив об'єктів Transport).
+

docs/API_ETTNv3_1/Methods/PostTransport.csv

@@ -0,0 +1,8 @@
+**URL**       ,
+Метод запиту  , POST                                          
+URL запиту    ,**/api/oas/v2/transport**
+**Headers**   ,
+Authorization ,"**SID** - токен, отриманий при `авторизації <https://wiki.edin.ua/uk/latest/integration_2_0/APIv2/Methods/Authorization.html>`__"
+Content-Type  , *application/json*
+**REQUEST**   ,
+JSON Body     ,"В тілі запиту методу (в json форматі) передаються дані нового `транспортного засобу <https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Methods/EveryBody/Transport.html>`__ (об'єкт Transport)."

docs/API_ETTNv3_1/Methods/PostTransport.rst

@@ -0,0 +1,14 @@
+######################################################################################
+**Додати в довідник (створити) новий транспортний засіб**
+######################################################################################
+
+Для роботи з цим методом користувач повинен бути `авторизованим <https://wiki.edin.ua/uk/latest/integration_2_0/APIv2/Methods/Authorization.html>`__.
+
+.. csv-table:: 
+  :file: PostTransport.csv
+  :widths:  10, 41
+  :stub-columns: 0
+
+**RESPONSE**
+
+Код сервера 200 (ok).

docs/Docs_ETTNv2/for_csv/RELOAD/RELOAD_ACT_ORIGINATOR_SIGNED.csv

@@ -17,15 +17,15 @@ UUID_TTN,M,UUID,унікальний ідентифікатор ТТН
 **TRANSPORT_UNLOAD**,M,,"інформація про Перевізника, що здав вантаж та його авто (початок блоку)"
 R01G1S,M,String,марка автомобіля
 R01G11S,O,String,модель автомобіля
-R01G2S,M,String,реєстраційний номер автомобіля. У літеросполученні допустима тільки кирилиця (АА0000АА)
+R01G2S,M,String,реєстраційний номер автомобіля. У літеросполученні допускається кирилиця однак в довідник записується лише латинниця (AA0000AA)
 R01G3S,M,String,тип автомобіля
 R01G4S,O,String,марка причіп/напівпричіп
 R01G12S,O,String,модель причіп/напівпричіп
-R01G5S,O,String,реєстраційний номер причіп/напівпричіп. У літеросполученні допустима тільки кирилиця (АА0000АА)
+R01G5S,O,String,реєстраційний номер причіп/напівпричіп. У літеросполученні допускається кирилиця однак в довідник записується лише латинниця (AA0000AA)
 R01G6S,O,String,тип автомобіля причіп/напівпричіп
 R01G7S,O,String,марка причіп/напівпричіп 2
 R01G13S,O,String,модель причіп/напівпричіп 2
-R01G8S,O,String,реєстраційний номер причіп/напівпричіп 2. У літеросполученні допустима тільки кирилиця (АА0000АА)
+R01G8S,O,String,реєстраційний номер причіп/напівпричіп 2. У літеросполученні допускається кирилиця однак в довідник записується лише латинниця (AA0000AA)
 R01G9S,O,String,тип автомобіля причіп/напівпричіп 2
 R02G11S,M,String,"ідентифікаційний код Перевізника (ЄДРПОУ юридичної особи або ІПН фізичної-особи підприємця), який здав вантаж"
 R02G1S,M,String,"повне найменування Перевізника (найменування юридичної особи або ПІБ фізичної-особи підприємця), який здав вантаж"
@@ -39,15 +39,15 @@ SEAL_NO,O,String,номер пломби
 **TRANSPORT_LOAD**,M,,"інформація про Перевізника, що прийняв вантаж та його авто (початок блоку)"
 R01G1S,M,String,марка автомобіля
 R01G11S,O,String,модель автомобіля
-R01G2S,M,String,реєстраційний номер автомобіля. У літеросполученні допустима тільки кирилиця (АА0000АА)
+R01G2S,M,String,реєстраційний номер автомобіля. У літеросполученні допускається кирилиця однак в довідник записується лише латинниця (AA0000AA)
 R01G3S,M,String,тип автомобіля
 R01G4S,O,String,марка причіп/напівпричіп
 R01G12S,O,String,модель причіп/напівпричіп
-R01G5S,O,String,реєстраційний номер причіп/напівпричіп. У літеросполученні допустима тільки кирилиця (АА0000АА)
+R01G5S,O,String,реєстраційний номер причіп/напівпричіп. У літеросполученні допускається кирилиця однак в довідник записується лише латинниця (AA0000AA)
 R01G6S,O,String,тип автомобіля причіп/напівпричіп
 R01G7S,O,String,марка причіп/напівпричіп 2
 R01G13S,O,String,модель причіп/напівпричіп 2
-R01G8S,O,String,реєстраційний номер причіп/напівпричіп 2. У літеросполученні допустима тільки кирилиця (АА0000АА)
+R01G8S,O,String,реєстраційний номер причіп/напівпричіп 2. У літеросполученні допускається кирилиця однак в довідник записується лише латинниця (AA0000AA)
 R01G9S,O,String,тип автомобіля причіп/напівпричіп 2
 R02G11S,M,String,"ідентифікаційний код Перевізника (ЄДРПОУ юридичної особи або ІПН фізичної-особи підприємця), який прийняв вантаж"
 R02G1S,M,String,"повне найменування Перевізника (найменування юридичної особи або ПІБ фізичної-особи підприємця), який прийняв вантаж"