Introduction

Packaging Service is a service with a SOAP web service interface. It is used for packaging one or more native SDO’s into a richer SDO of different types. It may i.e. be used to package one or more LTV-SDOs into a PAdES SDO.

The service may be used from any platform capable of making a SOAP web service call.

The service relies on Signicat’s SDS service for uploading and downloading binary document data.

Differences from PackagingService v2

PackagingService v3 adds the possibility to specify to use an original document that is separate from the SDO (normally, the original document is part of the SDO).

Currently, this feature is only relevant when you package LTV-SDOs created with bundling, and where the original document is not included in the LTV-SDO (using original-inclusion-mode “detached”).

PackagingService v3 is backwards compatible with PackagingService v2.

Location

The WSDL for the service is available at:

Infrastructure Location
Pre-prod https://preprod.signicat.com/ws/packagingservice-v3?wsdl
Production https://id.signicat.com/ws/packagingservice-v3?wsdl

The only difference between the WSDL in preprod and production is the soap address location attribute.

List of methods

Method
Description
createPackage Creates an SDO as specified in the request

createPackage

Purpose

This method is used for creating an SDO package. The SDO will be available for download in the SDS system when this method returns.

Parameters

Name Data type Description
service String The name of the customer service (the customer account).
password String The password for this service. This is different in preprod and production.
validation-policy String The name of the validation policy to use for validating the SDOs
packaging-method String The name of the method to use when creating the package. This method will define both the packaging format and graphical profiles (if relevant)
sdo List of DocumentId or SdoExtended Specifies SDOs to be included in the package. Each element in the list is typically a reference to the SDO of type DocumentId.
To specify the original document separately from the SDO, use SdoExtended. The two types DocumentId and SdoExtended may be mixed.

Return value

Name Data type Description
id String URL to the document package in SDS
error Error An error code and message

Data type: DocumentId

Description

The DocumentId data type is a reference to a document in the SDS system. A DocumentId can be one of three data types that extend the general DocumentId data type.

Each extension provides field that identifies the document in each target system.

Extensions:

Extension Description
OrderDocumentId A document that was created recently by the signature portal and is still available there.
ArchiveDocumentId A document in the archive
SdsDocumentId A document located in the Session Data Storage. This is a temporary storage that is accessible via a REST interface.

Data type: SdoExtended

Description

The SdoExtended data type contains references to an SDO and the corresponding original document in the SDS system.

Fields

Name Data type Description
sdo DocumentId A reference to the SDO.
supplementary-data SupplementaryData Contains a reference to the original document associated with this SDO

Data type: SupplementaryData

Description

The SupplementaryData data type contains data that is associated with the SDO.

Fields

Name Data type Description
original-document DocumentId Contains a reference to the original document