Direct Message Exchange with Finnish Customs Technical Guidebook Updated 5.8.2021 Contents 1 Purpose of This Guidebook

Direct Message Exchange with Finnish Customs Technical Guidebook Updated 5.8.2021 Contents 1 Purpose of This Guidebook

Direct message exchange with Finnish Customs Technical guidebook Updated 5.8.2021 Contents 1 Purpose of this guidebook ............................................................................................... 6 2 Web service for direct message exchange ............................................................................. 7 2.1 Logical architecture of direct message exchange ................................................................ 7 2.2 Data security of the service ...................................................................................... 9 2.3 Message Notification Service ................................................................................... 10 2.4 Attachment message service ......................................................................................... 11 3 Customs’ SOAP messages ............................................................................................. 11 3.1 Structure of SOAP messages ................................................................................... 11 3.1.1 SOAP request message ................................................................................... 13 3.1.2 SOAP response message ................................................................................. 13 3.2 Response in normal and error situations ...................................................................... 14 3.2.1 ResponseHeader response codes ....................................................................... 14 3.2.2 SOAP fault ................................................................................................ 14 3.2.3 Preparation of customer software for error situations ................................................ 14 3.2.4 Resending of a message .................................................................................. 14 3.3 The phases of building and transmitting the message (UPLOAD) ........................................... 16 3.4 The phases of building and transmitting a message (UPLOADATTACHMENT) ................................. 17 4 WDSL and XDS files of Customs ..................................................................................... 18 5 Schema error message ................................................................................................. 19 5.1.1 DmeErrorMessage structure .................................................................................... 19 5.1.2 DmeErrorMessage, element description ....................................................................... 19 6 attachment files in reply messages ......................................................................................... 21 6.3 Metadata message of PDF document (DmeDocumentInfoMessage) .............................................. 24 6.3.1 DmeDocumentInfoMessage, element description ............................................................. 24 6.3.2. PDF document retrieval from the direct message exchange interface ...................................... 25 7 Operations provided by the service ................................................................................. 26 7.1 Services implemented by Customs .................................................................................. 26 7.2 Service implemented by the customer ............................................................................... 26 7.3 Service operations in WSDL ......................................................................................... 26 7.3.1 Upload ............................................................................................................ 26 7.3.2 UploadAttachment ............................................................................................... 30 7.3.3 DownloadList ................................................................................................ 34 7.3.4 Download ........................................................................................................ 37 7.3.5 Notify ............................................................................................................. 40 7.3.6 CheckConnectivity .............................................................................................. 43 8 Descriptions of XML element data ................................................................................... 44 8.1 RequestHeader ........................................................................................................ 44 © Finnish Customs Message exchange with Finnish Customs, Technical guidebook, updated 5 August 2021 1/81 8.2 ApplicationRequestMessage .......................................................................................... 44 8.3 ResponseHeader ...................................................................................................... 45 8.4 MessageInformation ................................................................................................... 46 8.5 AttachmentRequestMessage .................................................................................... 47 8.6 AttachmentResponseMessage .................................................................................. 47 8.7 DownloadMessageListFilteringCriteria......................................................................... 47 8.8 DownloadMessageFilteringCriteria ............................................................................ 49 8.9 ApplicationResponseMessage ................................................................................... 49 8.10 EchoContent .................................................................................................... 49 8.11 ApplicationRequest .............................................................................................. 50 8.12 AttachmentRequest ............................................................................................. 51 8.13 ApplicationContent .................................................................................................. 52 8.14 AttachmentContent ................................................................................................. 52 8.16 NotifyRequest ........................................................................................................ 53 Table: 31 NotifyRequest .................................................................................................. 54 8.17 NotifyResponse ...................................................................................................... 55 8.18 DocumentInformation ............................................................................................... 55 9 Authentication and authorisation of technical customer parties .................................................... 57 9.1 Authentication of the message declarant ............................................................................ 57 9.2 Authentication of the builder/the intermediary ..................................................................... 57 9.3 Authentication of the Message Notification Service provider ...................................................... 58 10 Server certificate ....................................................................................................... 59 10.1 Acquisition and implementation of a server certificate ........................................................... 60 10.2 Renewing the server certificate ..................................................................................... 60 11 Customer message transmission data ................................................................................ 61 11.1 Service provider’s identification .................................................................................... 61 11.2 URL of the service ................................................................................................... 61 11.3 Interchange identifier ................................................................................................ 61 11.4 Transmission data in the customer message ....................................................................... 62 10.4.1 RequestHeader ................................................................................................. 62 10.4.2 ApplicationRequest ............................................................................................. 62 11.4.3 Payload .......................................................................................................... 63 12 XML signature .......................................................................................................... 64 12.1 Structure of the XML signature ..................................................................................... 64 12.2 Implementation of the XML signature .............................................................................. 64 12.3 Validation of the XML signature and possible problems .......................................................... 64 13 Restrictions on direct message exchange ............................................................................ 65 13.1 Protocol versions .................................................................................................... 65 © Finnish Customs Message exchange with Finnish Customs, Technical guidebook, updated 5 August 2021 2/81 13.2 Encryption algorithms ............................................................................................... 65 13.3 Restrictions related to the message ...............................................................................

View Full Text

Details

  • File Type
    pdf
  • Upload Time
    -
  • Content Languages
    English
  • Upload User
    Anonymous/Not logged-in
  • File Pages
    81 Page
  • File Size
    -

Download

Channel Download Status
Express Download Enable

Copyright

We respect the copyrights and intellectual property rights of all users. All uploaded documents are either original works of the uploader or authorized works of the rightful owners.

  • Not to be reproduced or distributed without explicit permission.
  • Not used for commercial purposes outside of approved use cases.
  • Not used to infringe on the rights of the original creators.
  • If you believe any content infringes your copyright, please contact us immediately.

Support

For help with questions, suggestions, or problems, please contact us