Skip to main content

Алгоритм «Акт коригування» (AdjustmentAct)

Акт коригування складається Замовником або будь-яким іншим учасником е-ТТН, що ініціює виправлення помилки. В залежності від стадії перевезення набір сторін-підписувачів може змінюватись. Так, Акт підписується всіма учасниками перевезення, які заявлені в мета-даних е-ТТН і накладали свій підпис на документ у процесі перевезення , при цьому учасники, які ще не накладали підпис на е-ТТН (наприклад, Вантажоодержувач), можуть не підписувати Акт.

../../_images/AdjustmentActv3_API_work_002.png

Зображення 1 - Схема роботи з «Актом коригування», створеним на підставі типової е-ТТН

Дод. транзакції (коли формуються та ким реєструються)
Реєструється до початку ЖЦ Акту (завжди ініціатором акта) Хто виступає ініціатором Акта (ролі вказані з ТТН) Реєструється після завершення ЖЦ Акту Хто реєструє транзакцію ТТН по завершенню ЖЦ Акта (ролі вказані з ТТН)
Акт коригування

Замовник OB, Вантажовідправник CZ, Перевізник CA або Водій DR, Вантажоодержувач CN
Ініціатор акта (Замовник OB, Вантажовідправник CZ, Перевізник CA або Водій DR, Вантажоодержувач CN)
Зміни, які вносяться коригуючим Актом до ТТН
Реєструється до початку ЖЦ Акту (завжди ініціатором акта) Реєструється після завершення ЖЦ Акту
Акт коригування
-
  1. В тіло ТТН додається коригуючий акт:
    • `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт коригування"
    • `AssociatedReferencedDocument.ID` = номер акту коригування
    • `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту коригування
  2. В тілі ТТН можливі внесення змін в такі блоки:
    • ExchangedDocument
      • ExchangedDocument.IssueLogisticsLocation.Name + ExchangedDocument.IssueLogisticsLocation.Description
        SpecifiedSupplyChainConsignment
      • DeliveryInstructions.Description
        ConsignorTradeParty
      • ConsignorTradeParty. ID (schemeAgencyID="ЄДРПОУ")
      • ConsignorTradeParty.Name
      • ConsignorTradeParty.RoleCode
      • ConsignorTradeParty.PostalTradeAddress
      • ConsignorTradeParty.DefinedTradeContact
    • ConsigneeTradeParty
      • ConsigneeTradeParty. ID (schemeAgencyID="ЄДРПОУ")
      • ConsigneeTradeParty.Name
      • ConsigneeTradeParty.RoleCode
      • ConsigneeTradeParty.PostalTradeAddress
      • ConsigneeTradeParty.DefinedTradeContact
    • CarrierTradeParty
      • CarrierTradeParty. ID (schemeAgencyID="ЄДРПОУ")
      • CarrierTradeParty.Name
      • CarrierTradeParty.RoleCode
      • CarrierTradeParty.PostalTradeAddress
      • CarrierTradeParty.DefinedTradeContact
    • NotifiedTradeParty (роль - FW)
      • NotifiedTradeParty.Name
      • NotifiedTradeParty.PostalTradeAddress
      • NotifiedTradeParty.DefinedTradeContact
    • NotifiedTradeParty (роль - OB)
      • NotifiedTradeParty.ID (schemeAgencyID="ЄДРПОУ")
      • NotifiedTradeParty.Name
      • NotifiedTradeParty.RoleCode
      • NotifiedTradeParty.PostalTradeAddress
      • NotifiedTradeParty.DefinedTradeContact
    • NotifiedTradeParty (роль - WD)
      • NotifiedTradeParty.Name
      • NotifiedTradeParty.PostalTradeAddress
      • NotifiedTradeParty.DefinedTradeContact
    • NotifiedTradeParty (роль - COP)
      • NotifiedTradeParty.Name
      • NotifiedTradeParty.DefinedTradeContact.PersonName
    • CarrierAcceptanceLogisticsLocation
      • CarrierAcceptanceLogisticsLocation.Name + CarrierAcceptanceLogisticsLocation.Description
      • "CarrierAcceptanceLogisticsLocation. PhysicalGeographicalCoordinate. LatitudeMeasure +
      • CarrierAcceptanceLogisticsLocation. PhysicalGeographicalCoordinate. LongitudeMeasure"
    • ConsigneeReceiptLogisticsLocation
      • ConsigneeReceiptLogisticsLocation.Name + ConsigneeReceiptLogisticsLocation.Description
      • ConsigneeAcceptanceLogisticsLocation. PhysicalGeographicalCoordinate. LatitudeMeasure +
    • ConsigneeAcceptanceLogisticsLocation. PhysicalGeographicalCoordinate. LongitudeMeasure
    • DeliveryTransportEvent
      • DeliveryTransportEvent.ActualOccurrenceDateTime
      • DeliveryTransportEvent.ScheduledOccurrenceDateTime
      • DeliveryTransportEvent.ApplicableNote (з кодом DOWNTIME)
    • PickUpTransportEvent
      • PickUpTransportEvent.ActualOccurrenceDateTime
      • PickUpTransportEvent.ScheduledOccurrenceDateTime
      • PickUpTransportEvent.ApplicableNote (з кодом DOWNTIME)
    • IncludedSupplyChainConsignmentItem
      • IncludedSupplyChainConsignmentItem.GlobalID (schemeAgencyID="УКТЗЕД")
      • IncludedSupplyChainConsignmentItem.NatureIdentificationTransportCargo. Identification
      • IncludedSupplyChainConsignmentItem.ApplicableTransportDangerousGoods.UNDGIdentificationCode
      • IncludedSupplyChainConsignmentItem.AssociatedReferencedDocument.ID + IncludedSupplyChainConsignmentItem.AssociatedReferencedDocument.Remarks
      • IncludedSupplyChainConsignmentItem.TransportLogisticsPackage.PhysicalLogisticsShippingMarks.Marking
      • IncludedSupplyChainConsignmentItem.TransportLogisticsPackage.PhysicalLogisticsShippingMarks.BarcodeLogisticsLabel.ID
      • IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом VENDOR_CODE)
      • IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом URL)
      • IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом BASE_UOM)
      • IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом BUYER_CODE)
      • IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом RETURN_TARE)
      • IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом RTP_QUANTITY)
      • IncludedNote (transportation_max_temperature, logger_return, logistic_unit_number_with_logger, gps_number, logger_number, comment, reserve_number, vehicle_length, vehicle_width, vehicle_height, gross_vehicle_weight_with_cargo, pallets_with_temperature_control_quantity, pallets_without_temperature_control_quantity)
  3. UaSignatureStorage - підпис ініціатора (Замовника OB, Вантажовідправника CZ, Перевізника CA або Водія DR, Вантажоодержувача CN)

Повний опис всіх додаткових транзакцій та змін, що вносяться в ТТН при формуванні Актів за посиланням.

№ кроку ВАНТАЖОВІДПРАВНИК
1.1 Авторизація
1.2 Створення/редагування чернетки «Акта коригування»
1.3 Підписання «Акта коригування» Вантажовідправником
1.4 Відправка «Акта коригування» Вантажовідправником
1.5* Відхилення «Акта коригування» Вантажовідправником
  ПЕРЕВІЗНИК
2.1 Авторизація
2.2 Отримання контенту (json) «Акта коригування»
2.2* Відхилення «Акта коригування» Перевізником
2.3 Створення/редагування нової транзакції (чернетки) до «Акта коригування»
2.4 Отримання контенту (ecmr) «Акта коригування»
2.5 Підписання «Акта коригування» Перевізником
2.6 Надсилання «Акта коригування» Перевізником

ВАНТАЖООДЕРЖУВАЧ
3.1 Авторизація
3.2 Отримання контенту (ecmr) «Акта коригування» Вантажоодержувачем
3.2* Відхилення «Акта коригування» Вантажоодержувачем
3.3 Підписання «Акта коригування» Вантажоодержувачем
3.4 Надсилання «Акта коригування» Вантажоодержувачем

ВАНТАЖОВІДПРАВНИК
4.1 Авторизація
4.2 Отримання тіла документа (рекомендовано в ecmr) «е-ТТН» для подальшого підписання Вантажовідправником
4.3 Підписання змін до «е-ТТН» Вантажовіправником
4.4 Надсилання нової транзакції до е-ТТН документа Вантажовідправником


Додаткові методи API: