##########################################################################################################################
**"Акт примусового завершення е-ТТН"**
##########################################################################################################################

.. https://docs.google.com/spreadsheets/d/1eiLgIFbZBOK9hXDf2pirKB88izrdOqj1vSdV3R8tvbM/edit?pli=1#gid=804820694

**Шановні користувачі!**

Ми активно працюємо над оновленням бази знань EDIN-WiKi, тому ця сторінка втратила актуальність.

Актуальну версію документації ви знайдете за новим `посиланням <https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/akt-primusovogo-zaversennia-e-ttn>`__

Свої побажання, зауваження ви можете залишати в коментарях до статті на новій EDIN-WiKi.

Дякуємо за розуміння та користування сервісом!

.. сторінка перенесена на нову вікі

   .. important::
   Зверніть увагу, що поля в json та `в xml форматі <https://wiki.edin.ua/uk/latest/Docs_ETTNv3/STOP_ACT/STOP_ACTpage_v3.html>`__ відрізняються! 

   **JSON:**

   .. code:: json

  {
    "ram": "urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:103",
    "udt": "urn:un:unece:uncefact:data:standard:UnqualifiedDataType:27",
    "qdt": "urn:un:unece:uncefact:data:standard:QualifiedDataType:103",
    "uas": "urn:ua:signatures:SignaturesExtensions:1",
    "act": {
      "documentContext": {
        "transactionID": "0",
        "documentCode": {
          "id": "urn:ua:e-transport.gov.ua:act:01"
        },
        "documentSubCode": {
          "id": "urn:ua:e-transport.gov.ua:act:01:stop:001"
        }
      },
      "exchangedDocument": {
        "id": "123123",
        "issueDateTime": {
          "dateTime": "2022-10-26T18:32:52+02:00"
        },
        "issueLogisticsLocation": {
          "name": "Місце складання документу",
          "description": "79000, м.Львів, вул. Словацького, 1"
        },
        "includedNote": []
      },
      "stopActPayload": {
        "previousAdministrativeReferencedDocuments": [
          {
            "typeCode": "730",
            "id": "0d39da11-087f-4a4e-8728-d9fba1df526e",
            "formattedIssueDateTime": {
              "dateTime": "2023-07-18T19:17:00.000Z"
            }
          }
        ],
        "initiatorTradeParty": {
          "id": {
            "schemeAgencyID": "ЄДРПОУ",
            "value": "85854949"
          },
          "name": "ТОВ \"ТЕСТ\"",
          "roleCode": "OB"
        },
        "specifiedGovernmentRegistrations": [
          {
            "id": "9864065738701",
            "typeCode": "TRADEPARTY_GLN"
          }
        ],
        "carrierTradeParty": {
          "id": {
            "schemeAgencyID": "ЄДРПОУ",
            "value": "85854949"
          },
          "name": "etnn-test-consignor",
          "roleCode": "CA",
          "tradeContact": {
            "personName": "Driver Name"
          },
          "postalTradeAddress": {
            "postCode": "02090",
            "streetName": "Some Street, 6",
            "cityName": "Some City",
            "countryID": "UA"
          },
          "taxRegistration": {
            "id": "3350319275"
          },
          "specifiedGovernmentRegistrations": [
            {
              "id": "XYZ000012",
            },
            {
              "id": "9864065747239",
              "typeCode": "DRIVER_GLN"
            },
            {
              "id": "9864065738701",
              "typeCode": "TRADEPARTY_GLN"
            }
          ]
        },
        "initiatorNotes": "ДТП"
      },
      "certifyingPartyPayload": {
        "certifyingTradeParty": [
          {
            "id": {
              "schemeAgencyID": "РНОКПП",
              "value": "1111111111"
            },
            "name": "Комірник",
            "roleCode": "OB",
            "tradeContact": {
              "personName": "Тест Тест Тест"
            }
          }
        ]
      }
    }
  }

   .. role:: orange

   .. raw:: html

    <embed>
    <iframe src="https://docs.google.com/spreadsheets/d/e/2PACX-1vRPbzkPgNe3yqDqIzd_3PyYlNGPbaL27tiF7z5CPd5iexGV74qv6KkAGquRrJL9OQ/pubhtml?gid=2013259786&single=true" width="1100" height="2550" frameborder="0" marginheight="0" marginwidth="0">Loading...</iframe>
    </embed>

   -------------------------

   .. [#] Під визначенням колонки **Тип поля** мається на увазі скорочене позначення:

   * M (mandatory) — обов'язкові до заповнення поля;
   * O (optional) — необов'язкові (опціональні) до заповнення поля.

   .. [#] елементи структури мають наступний вигляд:

   * параметрЗіЗначенням;
   * **об'єктЗПараметрами**;
   * :orange:`масивОб'єктів`;
   * жовтим фоном виділяються комірки, в яких відбувались останні зміни

.. data from table (remember to renew time to time)

.. raw:: html

  <!-- <div>№ з/п,Параметр²,Тип¹,Формат,Опис
  I,act,M,,(початок змісту документа)
  1,documentContext,M,,Технічні дані
  1.1,transactionID,M,string,Номер версії документа (транзакції) в ланцюгу підписання документів
  1.2.1,documentCode.id,M,string,код документа
  1.3.1,documentSubCode.id,M,unsignedByte,підтип документа
  2,exchangedDocument,M,,Реквізити Акта
  2.1,id,M,string,номер документа
  2.2.1,issueDateTime.dateTime,M,datetime (2021-12-13T14:19:23+02:00),Дата і час складання Акта
  2.3,remarks,O,string,Інші примітки
  2.4.1,issueLogisticsLocation.name,M,string,Найменування місця складання Акта
  2.4.2,issueLogisticsLocation.description,M,string,Опис (адреса) місця складання Акта
  3,stopActPayload,M,,Зміст «Акта примусового завершення е-ТТН»
  3.1,previousAdministrativeReferencedDocuments (TypeCode=730),M,,"Інформація про е-ТТН, для якої складається акт"
  3.1.1,typeCode,M,decimal,Тип документа (730 - ТТН). Довідник кодів документів
  3.1.2,id,M,string,Номер документа-підстави (ТТН); має відповідати номеру документа ExchangedDocument.ID еТТН
  3.1.3.1,formattedIssueDateTime.dateTime,M,datetime (2021-12-13T14:19:23+02:00),Дата та час документа-підстави (ТТН); має відповідати даті документа ExchangedDocument.IssueDateTime еТТН
  3.1.4,attachedSpecifiedBinaryFile,M,,"Дані е-ТТН, для якої складається акт"
  3.1.4.1,id,M,string,Ідентифікатор (guid) документа-підстави (ТТН); має відповідати document.id еТТН в ЦБД (значення ettnId з методу Отримання списку подій з ЦБД = значення external_doc_id Отримання мета-даних документа)
  3.1.4.2,uriid,O,string,посилання на документ
  3.1.4.3,MIMECode,O,string,MIME типізація
  3.1.4.4,SizeMeasure,O,long,розмір файлу в байтах
  3.2,previousAdministrativeReferencedDocuments,-/M,,"Інформація про попередній акт, у випадку наступної транзакції"
  3.2.1,typeCode,M,decimal,Тип документа. Довідник кодів документів
  3.2.2,id,M,string,Номер документа-підстави (Акт); має відповідати номеру документа ExchangedDocument.ID Акта
  3.2.3.1,formattedIssueDateTime.dateTime,M,datetime (2021-12-13T14:19:23+02:00),Дата та час документа-підстави (Акта)
  3.3,initiatorTradeParty,M,,"Ініціатор акта - Замовник (початок блоку). Тут наведено приклад, коли ініціатором Акта є Замовник - у документа буде дві сторони-підписувачі: Замовник та Перевізник."
  3.3.1.1,id.schemeAgencyID,M,string,ЄДРПОУ / РНОКПП Замовника
  3.3.1.2,id.value,M,decimal,Значення
  3.3.2,name,M,string,"Повне найменування Замовника (юридичної особи або ПІБ фізичної-особи підприємця), що проводить одержання (оприбуткування) перелічених в ТТН товарно-матеріальних цінностей"
  3.3.3,roleCode,M,string,Роль учасника (Замовник - OB). Довідник ролей
  3.3.4,tradeContact,O, ,Контакти відповідального представника
  3.3.4.1,personName,O,string,ПІБ
  3.3.4.2.1,telephoneUniversalCommunication.completeNumber,O,string,Основний телефон
  3.3.4.3.1,mobileTelephoneUniversalCommunication.completeNumber,O,string,Мобільний телефон
  3.3.4.4.1,emailURIUniversalCommunication.completeNumber,O,string,Електронна адреса
  3.3.5,postalTradeAddress,M, ,Юридична адреса Замовника
  3.3.5.1,postCode,O,decimal,Індекс
  3.3.5.2,streetName,M,string,Адреса (назва вулиці + номер будівлі)
  3.3.5.3,cityName,M,string,Місто (назва населеного пункту)
  3.3.5.4,countryID,M,string,Країна (UA)
  3.3.5.5,countrySubDivisionName,O,string,Область та район (за наявності)
  3.3.6.1,taxRegistration.id,O,string,РНОКПП відповідальної особи
  3.3.7,specifiedGovernmentRegistrations,M/O, ,GLN Замовника (блок обов'язковий до заповнення для відправника транзакції)
  3.3.7.1,id,M/O,decimal,GLN Замовника (поле обов'язкове до заповнення для відправника транзакції)
  3.3.7.2,typeCode,O,string,"Код типу:

  * TRADEPARTY_GLN"
  3.4,carrierTradeParty,M,,Перевізник
  3.4.1.1,id.schemeAgencyID,M,string,ЄДРПОУ / РНОКПП Перевізника
  3.4.1.2,id.value,M,decimal,Значення
  3.4.2,name,M,string,"Повне найменування Перевізника (юридичної особи або фізичної особи - підприємця) або прізвище, ім’я, по батькові фізичної особи, з яким вантажовідправник уклав договір на надання транспортних послуг"
  3.4.3,roleCode,M,string,Роль учасника (Перевізник - CA). Довідник ролей
  3.4.4,tradeContact,M, ,Контакти відповідального представника
  3.4.4.1,personName,M,string,"ПІБ водія, що керуватиме ТЗ при перевезенні вантажу"
  3.4.4.2.1,telephoneUniversalCommunication.completeNumber,O,string,Основний телефон
  3.4.4.3.1,mobileTelephoneUniversalCommunication.completeNumber,O,string,Мобільний телефон
  3.4.4.4.1,emailURIUniversalCommunication.completeNumber,O,string,Електронна адреса
  3.4.5,postalTradeAddress,M, ,Юридична адреса Перевізника
  3.4.5.1,postCode,O,decimal,Індекс
  3.4.5.2,streetName,M,string,Адреса (назва вулиці + номер будівлі)
  3.4.5.3,cityName,M,string,Місто (назва населеного пункту)
  3.4.5.4,countryID,M,string,Країна (UA)
  3.4.5.5,countrySubDivisionName,O,string,Область та район (за наявності)
  3.4.6.1,taxRegistration.id,M,string,РНОКПП відповідальної особи (водія)
  3.4.7,specifiedGovernmentRegistrations,M, ,Посвідчення Водія / GLN Водія / GLN компанії-учасника
  3.4.7.1,id,M/O,"* string
  * decimal при typeCode=DRIVER_GLN / TRADEPARTY_GLN","* Серія та номер водійського посвідчення Водія (поле обов'язкове до заповнення). Заповнюється в форматі «3 заголовні кириличні літери + 6 цифр без пробілів», наприклад: DGJ123456, АБВ123456
  * для typeCode=DRIVER_GLN - GLN Водія (поле опціональне до заповнення)
  * для typeCode=TRADEPARTY_GLN - GLN компанії-учасника (поле обов'язкове до заповнення для відправника транзакції)"
  3.4.7.2,typeCode,O,string,"Код типу:

  * DRIVER_GLN
  * TRADEPARTY_GLN"
  3.5,initiatorNotes,M,string,Короткий або повний опис причин складання акта (Замовник)
  3.6,carrierNotes,O,string,Особливі відмітки / Інформація щодо незгоди зі змістом Акта (Перевізник)
  4,certifyingPartyPayload,M,,Інформація про відповідальних осіб
  4.1,certifyingTradeParty (RoleCode=ОВ),M,,Інформація про Замовника
  4.1.1.1,id.schemeAgencyID,O,string,РНОКПП
  4.1.1.2,id.value,O,decimal,Значення
  4.1.2,name,M,string,Посада Замовника
  4.1.3,roleCode,M,string,Роль учасника (Замовник - OB). Довідник ролей
  4.1.4.1,tradeContact.personName,M,string,ПІБ Замовника
  4.2,certifyingTradeParty (RoleCode=CA),M,,Інформація про Перевізника
  4.2.1.1,id.schemeAgencyID,O,string,РНОКПП
  4.2.1.2,id.value,O,decimal,Значення
  4.2.2,name,M,string,Посада Перевізника
  4.2.3,roleCode,M,string,Роль учасника (Перевізник - CA). Довідник ролей
  4.2.4.1,tradeContact.personName,M,string,ПІБ Перевізника
  II,signatureStorage,M,,Підписи
  5,signatures (SigningPartyRoleCode=OB),M,,КЕП Замовника
  5.1,signingPartyRoleCode,M,string,Роль підписанта (Замовник - OB). Довідник ролей
  5.2,partySignature,M,string,Підпис (base64 підпису p7s)
  5.3,name,M,string,ПІБ підписанта (Замовника)
  5.4,position,O,string,Посада підписанта (Замовника)
  5.5.1,specifiedTaxRegistration.id,M,string,РНОКПП підписанта (Замовника)
  6,signatures (SigningPartyRoleCode=CA),M,,КЕП Перевізника
  6.1,signingPartyRoleCode,M,string,Роль підписанта (Перевізник - CA). Довідник ролей
  6.2,partySignature,M,string,Підпис (base64 підпису p7s)
  6.3,name,M,string,ПІБ підписанта (Перевізника)
  6.4,position,O,string,Посада підписанта (Перевізника)
  6.5.1,specifiedTaxRegistration.id,M,string,РНОКПП підписанта (Перевізника)

.. old style

  Таблиця 1 - Специфікація "Акта примусового завершення е-ТТН" (JSON)

  .. csv-table:: 
    :file: for_csv/stop_act_v3_json.csv
    :widths:  1, 1, 5, 12, 41
    :header-rows: 1
    :stub-columns: 0