
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 ...............................................................................
Details
-
File Typepdf
-
Upload Time-
-
Content LanguagesEnglish
-
Upload UserAnonymous/Not logged-in
-
File Pages81 Page
-
File Size-