1. Overview

The PDF conversion API 'conversion2pdf' converts image, office and PDF files to (searcheable) PDF files.

The flow is generally as follows:
1. First create a job using the /conversion2pdf/jobs POST endpoint. You will get back a job response that contains a job with its associated settings.
2. Upload one or more images/files using the /conversion2pdf/jobs/{jobId}/streams/multipart POST endpoint. You can also add stream locations from the storage API . You will get back the update job response that contains a job with its associated settings. Currently you can only merge spreadsheets with spreadsheet, documents with documents and images/pdfs with images/pdfs
3. Start the job from a PUT request to the /conversion2pdf/jobs/{jobid} endpoint, with the Job and Settings JSON as request body. The conversion to PDF will now start. The OCR setting is only applicable to images, since other files will always be searchable.
4. Check the job status from the /conversion2pdf/jobs/{jobid} GET endpoint until the status has changed to DONE or ERROR. Messaging using a websocket will be available as an alternative in a future version
5. Retrieve the PDF file using the /conversion2pdf/jobs/{jobid}/streams/result GET endpoint. This will return the PDF file only when the status is DONE. In other cases it will return the Job Response JSON (with http code 202 instead of 200)

Interactive testing: A web based test console is available in the <a href="https://store.sphereon.com">Sphereon API Store</a>

1.1. Version information

Version : 1.1

1.2. Contact information

Contact : Sphereon DevOps Team
Contact Email : dev@sphereon.com

1.3. License information

License : Apache License Version 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0
Terms of service : https://sphereon.com

1.4. URI scheme

Host : gw.api.cloud.sphereon.com
BasePath : /pdf/1.1
Schemes : HTTPS

1.5. Tags

  • Conversion2PDF : Conversion to PDF API

2. Introduction

The Sphereon PDF API provides a PDF conversion solution.
It is possible to convert one or multiple files to a PDF.

2.1. Integration with other API’s

Almost all of our Content API’s have uniform content access, meaning the storage API is the base for all content retrieval, manipulation and storage.

We provide you with 2 ways to interact with files and content.

2.1.1. Content manipulation from Content API itself

Every API has it’s own content upload and download endpoints directly in the content API. Files are stored in our cloud, or one your own storage locations. Behind the scenes we use our storage API’s. This allows for simple integrations on your behalf. Our PDF conversion API has simple multipart file upload capability for to be converted files, as wel as download capability for the result(s).

2.1.2. Pass in storage locations to the Content API

You use the Storage API directly to upload, download and delete content. The Storage API will provide you with Json objects for the storage location(s). You use these locations for initiating the specific content service.
This solution has the benefit that you don’t have to upload a file to our Content Service beforehand. We will retrieve the file when necessary.

All our API’s will always return information about stream and storage locations. This allows you to mix and match both approaches as you see fit.

3. SDKs

Our API’s are based on the OpenAPI specification (formerly known as Swagger specification). This means you can pickup our REST API definition file and generate classes for your favorite programming language.

3.1. Provided SDKs and generated SDKs

3.1.1. Provided SDKs

For some popular programming languages we provide you with an SDK implementation.
This implementation can be found at https://github.com/Sphereon-SDK/pdf-sdk

3.1.2. Generate your own SDK

Please feel free to generate an SDK for your own programming language using our Swagger file. Please note that we do not officially support your SDK, but unofficially we are here to help of course.
You can use Swagger codegen for this (https://swagger.io/swagger-codegen). Swagger codegen support almost 100 programming languages.

Please use version 2.X of swagger codegen with our current API’s

3.2. Version compatibility between SDK and API

Al of our REST API’s follow the versioning scheme below

XX.YY

When the major number (XX) changes this means we completely redesign an API.
Minor number (YY) changes means smaller backwards comptible breaks within the API. An API can be changed forward compatible within the same minor number.

Our SDK follow the below versioning scheme

XX.YY.ZZ

The major (XX) and minor (YY) number always map directly to the accompanying REST API version.
The micro number (ZZ) is used if we add forward compatible changes to our REST API, or when bugs are encountered in a specific SDK.

4. Privacy and file storage

This micro service uses the Sphereon Storage API to store or retrieve files.
Both input- and output files can be stored or retrieved using our Storage API.
Our Storage API provides integration with Amazon S3 ®, Google Cloud Storage ®, Xillio Engine or our Sphereon Storage.
Therefore you have the flexibility to store your files at a place you want.
More information about the Storage API: https://docs.sphereon.com/api/storage/0.8/html

5. About Files

5.1. Lifecycle of a file

Lifecycle specifies if a file must or must not be deleted after retrieval.

5.2. Storage location

A storage location specifies the base location on a specific backend, e.g. Amazon.

5.3. Stream location

A stream location specifies the location of a file on a specific backend.
== Specifications

5.4. Supported input formats

The following input formats can be converted to a PDF:

  • Image files: TIFF

  • Microsoft Word: DOC, DOCX

  • Text: CSV, Tab-Delimited, TXT

  • Microsoft Excel: XLS, XLSX

  • Microsoft Outlook: MSG

  • Microsoft PowerPoint: PPT, PPTX

  • CAD: DWG

5.5. Supported PDF formats

  • PDF 1.4

  • PDF 1.5

  • PDF 1.6

  • PDF 1.7

  • PDF A1b

5.6. Engines

There are three engines which you can choose from, namely : Premium, Advanced, Standard
These engines provide different quality/functionality levels at specific costs.
Please contact sales at Sphereon for pricing information.

6. Workflow

6.1. Convert a file/stream

In order to convert one or more files, the following steps have to be done.

6.1.1. Create a job

First create a job. Conversion settings can be added now or when submitting the job.

The following conversions are available:

  • Image file to PDF. Image can optionally be processed by an OCR engine. Result is a searchable PDF.

  • Word to PDF. Result is a searchable PDF

  • Merge Spreadsheets. Result is a spreadsheet with has a tab per inputfile

  • CAD to PDF. Result is spreadsheet which has the CAD drawing embedded. No layout warranty.

For more technical info also see Create a PDF conversion job

6.1.2. Upload one or multiple files or attach one or more inputlocations to the job

After the creation of a job the obtained jobId in ConversionJobResponse must be used to link files or inputlocations to the job.

One can directly upload a file with Upload a file
or use Add Input Stream Location(s). A StreamLocation is provided by Sphereon Storage API and allows a file to be remotely stored and/or retrieved.

6.1.3. Submit the job

After one or more input files or StreamLocations were added to the job, the job can be submitted for processing.
If not specified at job creation, conversion settings can also be specified.
After submitting the job, the PDF microservice will asynchronously process the conversion.

For more technical info also see Submit PDF job for processing.

6.1.4. Check by polling the job if the job is completed

Please repeatedly poll the job definition and state in order to check if the job is finished.
To reduce system load, allow one or more seconds waiting time between two polls.

For more technical info also see Job definition and state

6.1.5. Get the resulting file

After job completion the resulting file can be retrieved.
If the StorageLocation in ResultSettings which is in ConversionSettings is specified, the result will be at that StorageLocation.

For more technical info also see Get the current result stream

6.1.6. Delete the job

After the result file has been collected, the job can be deleted. Result files will be deleted depending on the Lifecycle setting.

For more technical info also see Delete a job manually.

6.2. Other functions

6.2.1. Get all your jobs

This job provides a list of jobs at a current state. This list can be used to delete a job batchwise.
Or it can be used to check the state of multiple simultaneously submitted jobs.

For more technical info also see Get all jobs.

7. Resources

7.1. Conversion2PDF

Conversion to PDF API

7.1.1. Create a PDF conversion job

POST /conversion2pdf/jobs
Description

Create a PDF conversion job using optional settings supplied, otherwise defaults will be used

Parameters
Type Name Description Schema

Body

settings
optional

Optional settings to use for this job

ConversionSettings

Responses
HTTP Code Description Schema

201

PDF conversion job created successfully. Conversion job created but not started yet

ConversionJobResponse

Consumes
  • application/json;charset=UTF-8

Produces
  • application/json;charset=UTF-8

Security
Type Name Scopes

oauth2

oauth2schema

global

Example HTTP request
PUT /pdf/1.1/conversion2pdf/jobs/e391cba2-732d-4129-bc43-cdfee63c0bc3 HTTP/1.1
Authorization: Bearer e5fb8bee-df99-379a-8a3e-98036b7a7676
Content-Type: application/json
Host: gw.api.cloud.sphereon.com
Content-Length: 1226

{
  "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
  "settings" : {
    "ocrMode" : "AUTO",
    "qualityFactor" : 10,
    "containerConversion" : "ALL",
    "engine" : "ADVANCED",
    "version" : "PDF_A_1b",
    "input" : {
      "lifecycle" : {
        "applicableJobStatusses" : [ ],
        "action" : "DELETE",
        "type" : "RETRIEVAL"
      },
      "storageLocation" : {
        "id" : "35b8e11fc73a82ae49df2cb81531b3233e4970bd04a1936ead72f0c4c4de46e7",
        "folderPath" : "input"
      }
    },
    "result" : {
      "lifecycle" : {
        "applicableJobStatusses" : [ ],
        "action" : "DELETE",
        "type" : "RETRIEVAL"
      },
      "storageLocation" : {
        "id" : "412a700369cd46200aba93f8aff8ec40e0d9eaa3dd62845289960113326fb4d1",
        "folderPath" : "result"
      },
      "fileFormat" : "PDF",
      "compression" : {
        "level" : 0,
        "type" : "NONE"
      }
    },
    "jobLifecycle" : {
      "applicableJobStatusses" : [ "DONE" ],
      "action" : "NONE",
      "type" : "RETRIEVAL"
    },
    "csv" : {
      "standardRowHeight" : 0.0,
      "standardColumnWidth" : 0.0,
      "separatorCharacter" : "COMMA"
    }
  }
}
Example HTTP response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 3164

{
  "job" : {
    "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
    "settings" : {
      "ocrMode" : "AUTO",
      "qualityFactor" : 10,
      "containerConversion" : "ALL",
      "engine" : "ADVANCED",
      "version" : "PDF_A_1b",
      "input" : {
        "lifecycle" : {
          "applicableJobStatusses" : [ ],
          "action" : "DELETE",
          "type" : "RETRIEVAL"
        },
        "storageLocation" : {
          "id" : "35b8e11fc73a82ae49df2cb81531b3233e4970bd04a1936ead72f0c4c4de46e7",
          "folderPath" : "input"
        }
      },
      "result" : {
        "lifecycle" : {
          "applicableJobStatusses" : [ ],
          "action" : "DELETE",
          "type" : "RETRIEVAL"
        },
        "storageLocation" : {
          "id" : "412a700369cd46200aba93f8aff8ec40e0d9eaa3dd62845289960113326fb4d1",
          "folderPath" : "result"
        },
        "fileFormat" : "PDF",
        "compression" : {
          "level" : 0,
          "type" : "NONE"
        }
      },
      "jobLifecycle" : {
        "applicableJobStatusses" : [ "DONE" ],
        "action" : "NONE",
        "type" : "RETRIEVAL"
      },
      "csv" : {
        "standardRowHeight" : 0.0,
        "standardColumnWidth" : 0.0,
        "separatorCharacter" : "COMMA"
      }
    }
  },
  "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
  "claimParameters" : {
    "apiEndUser" : "no-enduser@supplied",
    "sphereonIdentifier" : "LTEyMzQubm8gc3Vic2NyaWJlci5wZGYtbXMuU0FOREJPWA==",
    "apiSupplierTenantId" : "-1234",
    "applicationId" : "pdf-ms",
    "keyType" : "SANDBOX"
  },
  "credentials" : {
    "token" : "e5fb8bee-df99-379a-8a3e-98036b7a7676",
    "authenticationProvider" : "API_IMPLEMENTER",
    "credentialType" : "BEARER_TOKEN"
  },
  "input" : {
    "streamLocations" : [ {
      "id" : "4c25f18b085f27dd318153f871a394724333df5fc6679661fa9bda1dc6133680",
      "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
      "folderPath" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3",
      "filename" : "446dfcb0-d70d-4d22-bf56-f6524d000a50",
      "originalFilename" : "sample.txt",
      "name" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3/446dfcb0-d70d-4d22-bf56-f6524d000a50"
    } ]
  },
  "result" : {
    "streamLocations" : [ ]
  },
  "status" : "PROCESSING",
  "creationTime" : "2018-11-19T09:42:40.076+01:00",
  "updateTime" : "2018-11-19T09:42:43.717+01:00",
  "queueTime" : "2018-11-19T09:42:43.717+01:00",
  "conversionTasks" : [ {
    "status" : "REQUESTED",
    "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
    "engine" : "ADVANCED",
    "conversionInput" : {
      "streamLocations" : [ {
        "id" : "4c25f18b085f27dd318153f871a394724333df5fc6679661fa9bda1dc6133680",
        "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
        "folderPath" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3",
        "filename" : "446dfcb0-d70d-4d22-bf56-f6524d000a50",
        "originalFilename" : "sample.txt",
        "name" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3/446dfcb0-d70d-4d22-bf56-f6524d000a50"
      } ]
    }
  } ]
}
Example Curl request
$ curl 'https://gw.api.cloud.sphereon.com/pdf/1.1/conversion2pdf/jobs/e391cba2-732d-4129-bc43-cdfee63c0bc3' -i -X PUT -H 'Authorization: Bearer e5fb8bee-df99-379a-8a3e-98036b7a7676' -H 'Content-Type: application/json' -d '{
  "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
  "settings" : {
    "ocrMode" : "AUTO",
    "qualityFactor" : 10,
    "containerConversion" : "ALL",
    "engine" : "ADVANCED",
    "version" : "PDF_A_1b",
    "input" : {
      "lifecycle" : {
        "applicableJobStatusses" : [ ],
        "action" : "DELETE",
        "type" : "RETRIEVAL"
      },
      "storageLocation" : {
        "id" : "35b8e11fc73a82ae49df2cb81531b3233e4970bd04a1936ead72f0c4c4de46e7",
        "folderPath" : "input"
      }
    },
    "result" : {
      "lifecycle" : {
        "applicableJobStatusses" : [ ],
        "action" : "DELETE",
        "type" : "RETRIEVAL"
      },
      "storageLocation" : {
        "id" : "412a700369cd46200aba93f8aff8ec40e0d9eaa3dd62845289960113326fb4d1",
        "folderPath" : "result"
      },
      "fileFormat" : "PDF",
      "compression" : {
        "level" : 0,
        "type" : "NONE"
      }
    },
    "jobLifecycle" : {
      "applicableJobStatusses" : [ "DONE" ],
      "action" : "NONE",
      "type" : "RETRIEVAL"
    },
    "csv" : {
      "standardRowHeight" : 0.0,
      "standardColumnWidth" : 0.0,
      "separatorCharacter" : "COMMA"
    }
  }
}'

7.1.2. Get all jobs

GET /conversion2pdf/jobs
Description

Get all PDF job definitions and their current state.

Parameters
Type Name Description Schema

Query

status
optional

A list of status to filter on.

< enum (INIT, INPUTS_UPLOADED, PROCESSING, DONE, ERROR, DELETED) > array(multi)

Responses
HTTP Code Description Schema

200

All PDF jobs that have not been deleted

< ConversionJobResponse > array

Consumes
  • application/json

Produces
  • application/json;charset=UTF-8

Security
Type Name Scopes

oauth2

oauth2schema

global

Example HTTP request
GET /pdf/1.1/conversion2pdf/jobs HTTP/1.1
Authorization: Bearer e5fb8bee-df99-379a-8a3e-98036b7a7676
Content-Type: application/json
Host: gw.api.cloud.sphereon.com
Example HTTP response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2570

[ {
  "job" : {
    "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
    "settings" : {
      "ocrMode" : "AUTO",
      "qualityFactor" : 10,
      "containerConversion" : "ALL",
      "engine" : "ADVANCED",
      "version" : "PDF_A_1b",
      "input" : {
        "lifecycle" : {
          "applicableJobStatusses" : [ ],
          "action" : "DELETE",
          "type" : "RETRIEVAL"
        },
        "storageLocation" : {
          "id" : "328e0e3ee068dc41dec8c0dddc7f03ea5d92c368ed69ce138fceb0ab9856400e",
          "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
          "folderPath" : "input"
        }
      },
      "result" : {
        "lifecycle" : {
          "applicableJobStatusses" : [ ],
          "action" : "DELETE",
          "type" : "RETRIEVAL"
        },
        "storageLocation" : {
          "id" : "412a700369cd46200aba93f8aff8ec40e0d9eaa3dd62845289960113326fb4d1",
          "folderPath" : "result"
        },
        "fileFormat" : "PDF",
        "compression" : {
          "level" : 0,
          "type" : "NONE"
        }
      },
      "jobLifecycle" : {
        "applicableJobStatusses" : [ "DONE" ],
        "action" : "NONE",
        "type" : "RETRIEVAL"
      },
      "csv" : {
        "standardRowHeight" : 0.0,
        "standardColumnWidth" : 0.0,
        "separatorCharacter" : "COMMA"
      }
    }
  },
  "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
  "claimParameters" : {
    "apiEndUser" : "no-enduser@supplied",
    "sphereonIdentifier" : "LTEyMzQubm8gc3Vic2NyaWJlci5wZGYtbXMuU0FOREJPWA==",
    "apiSupplierTenantId" : "-1234",
    "applicationId" : "pdf-ms",
    "keyType" : "SANDBOX"
  },
  "credentials" : {
    "token" : "e5fb8bee-df99-379a-8a3e-98036b7a7676",
    "authenticationProvider" : "API_IMPLEMENTER",
    "credentialType" : "BEARER_TOKEN"
  },
  "input" : {
    "streamLocations" : [ {
      "id" : "4c25f18b085f27dd318153f871a394724333df5fc6679661fa9bda1dc6133680",
      "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
      "folderPath" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3",
      "filename" : "446dfcb0-d70d-4d22-bf56-f6524d000a50",
      "originalFilename" : "sample.txt",
      "name" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3/446dfcb0-d70d-4d22-bf56-f6524d000a50"
    } ]
  },
  "result" : {
    "streamLocations" : [ ]
  },
  "status" : "INPUTS_UPLOADED",
  "creationTime" : "2018-11-19T09:42:40.076+01:00",
  "updateTime" : "2018-11-19T09:42:40.076+01:00",
  "conversionTasks" : [ ]
} ]
Example Curl request
$ curl 'https://gw.api.cloud.sphereon.com/pdf/1.1/conversion2pdf/jobs' -i -H 'Authorization: Bearer e5fb8bee-df99-379a-8a3e-98036b7a7676' -H 'Content-Type: application/json'

7.1.3. Job definition and state

GET /conversion2pdf/jobs/{jobid}
Description

Get the PDF job definition and current state. Please note that you can differentiate based on http response status.

Parameters
Type Name Description Schema

Path

jobid
required

jobid

string

Responses
HTTP Code Description Schema

200

PDF job returned and Job is done or in error

ConversionJobResponse

202

PDF job returned and Job is still processing

ConversionJobResponse

404

Invalid job id

ErrorResponse

Consumes
  • application/json

Produces
  • application/json;charset=UTF-8

Security
Type Name Scopes

oauth2

oauth2schema

global

Example HTTP request
GET /pdf/1.1/conversion2pdf/jobs/e391cba2-732d-4129-bc43-cdfee63c0bc3 HTTP/1.1
Authorization: Bearer e5fb8bee-df99-379a-8a3e-98036b7a7676
Content-Type: application/json
Host: gw.api.cloud.sphereon.com
Example HTTP response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 3737

{
  "job" : {
    "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
    "settings" : {
      "ocrMode" : "AUTO",
      "qualityFactor" : 10,
      "containerConversion" : "ALL",
      "engine" : "ADVANCED",
      "version" : "PDF_A_1b",
      "input" : {
        "lifecycle" : {
          "applicableJobStatusses" : [ ],
          "action" : "DELETE",
          "type" : "RETRIEVAL"
        },
        "storageLocation" : {
          "id" : "35b8e11fc73a82ae49df2cb81531b3233e4970bd04a1936ead72f0c4c4de46e7",
          "folderPath" : "input"
        }
      },
      "result" : {
        "lifecycle" : {
          "applicableJobStatusses" : [ ],
          "action" : "DELETE",
          "type" : "RETRIEVAL"
        },
        "storageLocation" : {
          "id" : "66f2f3eaeb96a278fd22389fb43c33306c011bdead635db56eed1d9073d1a647",
          "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
          "folderPath" : "result"
        },
        "fileFormat" : "PDF",
        "compression" : {
          "level" : 0,
          "type" : "NONE"
        }
      },
      "jobLifecycle" : {
        "applicableJobStatusses" : [ "DONE" ],
        "action" : "NONE",
        "type" : "RETRIEVAL"
      },
      "csv" : {
        "standardRowHeight" : 0.0,
        "standardColumnWidth" : 0.0,
        "separatorCharacter" : "COMMA"
      }
    }
  },
  "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
  "claimParameters" : {
    "apiEndUser" : "no-enduser@supplied",
    "sphereonIdentifier" : "LTEyMzQubm8gc3Vic2NyaWJlci5wZGYtbXMuU0FOREJPWA==",
    "apiSupplierTenantId" : "-1234",
    "applicationId" : "pdf-ms",
    "keyType" : "SANDBOX"
  },
  "credentials" : {
    "token" : "e5fb8bee-df99-379a-8a3e-98036b7a7676",
    "authenticationProvider" : "API_IMPLEMENTER",
    "credentialType" : "BEARER_TOKEN"
  },
  "input" : {
    "streamLocations" : [ {
      "id" : "4c25f18b085f27dd318153f871a394724333df5fc6679661fa9bda1dc6133680",
      "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
      "folderPath" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3",
      "filename" : "446dfcb0-d70d-4d22-bf56-f6524d000a50",
      "originalFilename" : "sample.txt",
      "name" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3/446dfcb0-d70d-4d22-bf56-f6524d000a50"
    } ]
  },
  "result" : {
    "streamLocations" : [ {
      "id" : "0498c44d23e93c8f73d23da9553a62df7d4fd35c34e4cec8b53e0d1c56a2813e",
      "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
      "folderPath" : "result/e391cba2-732d-4129-bc43-cdfee63c0bc3",
      "filename" : "446dfcb0-d70d-4d22-bf56-f6524d000a50.pdf",
      "originalFilename" : "446dfcb0-d70d-4d22-bf56-f6524d000a50.pdf",
      "name" : "result/e391cba2-732d-4129-bc43-cdfee63c0bc3/446dfcb0-d70d-4d22-bf56-f6524d000a50.pdf"
    } ]
  },
  "status" : "DONE",
  "creationTime" : "2018-11-19T09:42:40.076+01:00",
  "updateTime" : "2018-11-19T09:42:49.639+01:00",
  "queueTime" : "2018-11-19T09:42:43.717+01:00",
  "completionTime" : "2018-11-19T09:42:49.633+01:00",
  "conversionTasks" : [ {
    "status" : "DONE",
    "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
    "engine" : "ADVANCED",
    "conversionInput" : {
      "streamLocations" : [ {
        "id" : "4c25f18b085f27dd318153f871a394724333df5fc6679661fa9bda1dc6133680",
        "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
        "folderPath" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3",
        "filename" : "446dfcb0-d70d-4d22-bf56-f6524d000a50",
        "originalFilename" : "sample.txt",
        "name" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3/446dfcb0-d70d-4d22-bf56-f6524d000a50"
      } ]
    }
  } ]
}
Example Curl request
$ curl 'https://gw.api.cloud.sphereon.com/pdf/1.1/conversion2pdf/jobs/e391cba2-732d-4129-bc43-cdfee63c0bc3' -i -H 'Authorization: Bearer e5fb8bee-df99-379a-8a3e-98036b7a7676' -H 'Content-Type: application/json'

7.1.4. Submit PDF job for processing

PUT /conversion2pdf/jobs/{jobid}
Description

Start PDF conversion. Convert the previously uploaded file(s) to PDF. The settings supplied with the job in the request body are used for the conversion. You can only submit the job after a new Job is created with status INPUTS_UPLOADED or resubmit an existing Job with status ERROR. In all cases the job Id in the path must match the jobId in the request.

Parameters
Type Name Description Schema

Path

jobid
required

jobid

string

Body

job
required

jobEntity

ConversionJob

Responses
HTTP Code Description Schema

200

Conversion job submitted

ConversionJobResponse

400

Resubmitted job not allowed because the job is currently processing or already processed and had status DONE

ErrorResponse

404

Invalid job id

ErrorResponse

Consumes
  • application/json;charset=UTF-8

Produces
  • application/json;charset=UTF-8

Security
Type Name Scopes

oauth2

oauth2schema

global

7.1.5. Delete a job manually

DELETE /conversion2pdf/jobs/{jobid}
Description

Delete the PDF job and all related files.

Parameters
Type Name Description Schema

Path

jobid
required

jobid

string

Responses
HTTP Code Description Schema

200

PDF job returned and Job is done or in error

ConversionJobResponse

400

Could not delete all parts

ErrorResponse

404

Invalid job id

ErrorResponse

Consumes
  • application/json

Produces
  • application/json;charset=UTF-8

Security
Type Name Scopes

oauth2

oauth2schema

global

Example HTTP request
DELETE /pdf/1.1/conversion2pdf/jobs/e391cba2-732d-4129-bc43-cdfee63c0bc3 HTTP/1.1
Authorization: Bearer e5fb8bee-df99-379a-8a3e-98036b7a7676
Content-Type: application/json
Host: gw.api.cloud.sphereon.com
Example HTTP response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 3740

{
  "job" : {
    "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
    "settings" : {
      "ocrMode" : "AUTO",
      "qualityFactor" : 10,
      "containerConversion" : "ALL",
      "engine" : "ADVANCED",
      "version" : "PDF_A_1b",
      "input" : {
        "lifecycle" : {
          "applicableJobStatusses" : [ ],
          "action" : "DELETE",
          "type" : "RETRIEVAL"
        },
        "storageLocation" : {
          "id" : "35b8e11fc73a82ae49df2cb81531b3233e4970bd04a1936ead72f0c4c4de46e7",
          "folderPath" : "input"
        }
      },
      "result" : {
        "lifecycle" : {
          "applicableJobStatusses" : [ ],
          "action" : "DELETE",
          "type" : "RETRIEVAL"
        },
        "storageLocation" : {
          "id" : "66f2f3eaeb96a278fd22389fb43c33306c011bdead635db56eed1d9073d1a647",
          "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
          "folderPath" : "result"
        },
        "fileFormat" : "PDF",
        "compression" : {
          "level" : 0,
          "type" : "NONE"
        }
      },
      "jobLifecycle" : {
        "applicableJobStatusses" : [ "DONE" ],
        "action" : "NONE",
        "type" : "RETRIEVAL"
      },
      "csv" : {
        "standardRowHeight" : 0.0,
        "standardColumnWidth" : 0.0,
        "separatorCharacter" : "COMMA"
      }
    }
  },
  "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
  "claimParameters" : {
    "apiEndUser" : "no-enduser@supplied",
    "sphereonIdentifier" : "LTEyMzQubm8gc3Vic2NyaWJlci5wZGYtbXMuU0FOREJPWA==",
    "apiSupplierTenantId" : "-1234",
    "applicationId" : "pdf-ms",
    "keyType" : "SANDBOX"
  },
  "credentials" : {
    "token" : "e5fb8bee-df99-379a-8a3e-98036b7a7676",
    "authenticationProvider" : "API_IMPLEMENTER",
    "credentialType" : "BEARER_TOKEN"
  },
  "input" : {
    "streamLocations" : [ {
      "id" : "4c25f18b085f27dd318153f871a394724333df5fc6679661fa9bda1dc6133680",
      "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
      "folderPath" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3",
      "filename" : "446dfcb0-d70d-4d22-bf56-f6524d000a50",
      "originalFilename" : "sample.txt",
      "name" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3/446dfcb0-d70d-4d22-bf56-f6524d000a50"
    } ]
  },
  "result" : {
    "streamLocations" : [ {
      "id" : "0498c44d23e93c8f73d23da9553a62df7d4fd35c34e4cec8b53e0d1c56a2813e",
      "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
      "folderPath" : "result/e391cba2-732d-4129-bc43-cdfee63c0bc3",
      "filename" : "446dfcb0-d70d-4d22-bf56-f6524d000a50.pdf",
      "originalFilename" : "446dfcb0-d70d-4d22-bf56-f6524d000a50.pdf",
      "name" : "result/e391cba2-732d-4129-bc43-cdfee63c0bc3/446dfcb0-d70d-4d22-bf56-f6524d000a50.pdf"
    } ]
  },
  "status" : "DELETED",
  "creationTime" : "2018-11-19T09:42:40.076+01:00",
  "updateTime" : "2018-11-19T09:42:49.639+01:00",
  "queueTime" : "2018-11-19T09:42:43.717+01:00",
  "completionTime" : "2018-11-19T09:42:49.633+01:00",
  "conversionTasks" : [ {
    "status" : "DONE",
    "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
    "engine" : "ADVANCED",
    "conversionInput" : {
      "streamLocations" : [ {
        "id" : "4c25f18b085f27dd318153f871a394724333df5fc6679661fa9bda1dc6133680",
        "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
        "folderPath" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3",
        "filename" : "446dfcb0-d70d-4d22-bf56-f6524d000a50",
        "originalFilename" : "sample.txt",
        "name" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3/446dfcb0-d70d-4d22-bf56-f6524d000a50"
      } ]
    }
  } ]
}
Example Curl request
$ curl 'https://gw.api.cloud.sphereon.com/pdf/1.1/conversion2pdf/jobs/e391cba2-732d-4129-bc43-cdfee63c0bc3' -i -X DELETE -H 'Authorization: Bearer e5fb8bee-df99-379a-8a3e-98036b7a7676' -H 'Content-Type: application/json'

7.1.6. Upload a base64 encoded file

POST /conversion2pdf/jobs/{jobid}/streams/content
Description

Upload an image, office or pdf for conversion to PDF, embedded in a json as a base64 encoded string

Parameters
Type Name Description Schema

Path

jobid
required

jobid

string

Body

fileContent
required

File content

FileContentRequest

Responses
HTTP Code Description Schema

200

File content uploaded. The JSON Job response will be returned in the body.

ConversionJobResponse

400

Job could not be stored/processed

ErrorResponse

404

Invalid job id.

ErrorResponse

Consumes
  • application/json;charset=UTF-8

Produces
  • application/json;charset=UTF-8

Security
Type Name Scopes

oauth2

oauth2schema

global

7.1.7. Add Input Stream Location(s)

POST /conversion2pdf/jobs/{jobid}/streams/location
Description

Add image, office or pdf input stream location(s) from the storage API for conversion to PDF. Please note that you can upload multiple files. Conversion will not be started yet.

Parameters
Type Name Description Schema

Path

jobid
required

jobid

string

Body

inputStreamLocations
required

The (additional) binary image or PDF (file/inputstream) to convert to PDF

< StreamLocation > array

Responses
HTTP Code Description Schema

200

Stream location(s) added. The JSON Job response will be returned in the body.

ConversionJobResponse

400

Job could not be stored/processed

ErrorResponse

404

Invalid job id.

ErrorResponse

Consumes
  • application/json;charset=UTF-8

Produces
  • application/json;charset=UTF-8

Security
Type Name Scopes

oauth2

oauth2schema

global

7.1.8. Upload a file

POST /conversion2pdf/jobs/{jobid}/streams/multipart
Description

Upload an image, office or pdf for conversion to PDF. Please note that you can upload multiple files. Conversion will not be started yet.

Parameters
Type Name Description Schema

Path

jobid
required

jobid

string

Query

fileName
optional

Optional input file name.

string

FormData

stream
required

The (additional) binary image or PDF (file/inputstream) to convert to PDF

file

Responses
HTTP Code Description Schema

200

File uploaded. The JSON Job response will be returned in the body.

ConversionJobResponse

400

Job could not be stored/processed

ErrorResponse

404

Invalid job id.

ErrorResponse

Consumes
  • multipart/form-data

Produces
  • application/json;charset=UTF-8

Security
Type Name Scopes

oauth2

oauth2schema

global

Example HTTP request
POST /pdf/1.1/conversion2pdf/jobs/e391cba2-732d-4129-bc43-cdfee63c0bc3/streams/multipart HTTP/1.1
Content-Type: multipart/form-data; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Authorization: Bearer e5fb8bee-df99-379a-8a3e-98036b7a7676
Host: gw.api.cloud.sphereon.com

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=stream
Content-Type: plain/text

Sample content
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--
Example HTTP response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2566

{
  "job" : {
    "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
    "settings" : {
      "ocrMode" : "AUTO",
      "qualityFactor" : 10,
      "containerConversion" : "ALL",
      "engine" : "ADVANCED",
      "version" : "PDF_A_1b",
      "input" : {
        "lifecycle" : {
          "applicableJobStatusses" : [ ],
          "action" : "DELETE",
          "type" : "RETRIEVAL"
        },
        "storageLocation" : {
          "id" : "328e0e3ee068dc41dec8c0dddc7f03ea5d92c368ed69ce138fceb0ab9856400e",
          "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
          "folderPath" : "input"
        }
      },
      "result" : {
        "lifecycle" : {
          "applicableJobStatusses" : [ ],
          "action" : "DELETE",
          "type" : "RETRIEVAL"
        },
        "storageLocation" : {
          "id" : "412a700369cd46200aba93f8aff8ec40e0d9eaa3dd62845289960113326fb4d1",
          "folderPath" : "result"
        },
        "fileFormat" : "PDF",
        "compression" : {
          "level" : 0,
          "type" : "NONE"
        }
      },
      "jobLifecycle" : {
        "applicableJobStatusses" : [ "DONE" ],
        "action" : "NONE",
        "type" : "RETRIEVAL"
      },
      "csv" : {
        "standardRowHeight" : 0.0,
        "standardColumnWidth" : 0.0,
        "separatorCharacter" : "COMMA"
      }
    }
  },
  "jobId" : "e391cba2-732d-4129-bc43-cdfee63c0bc3",
  "claimParameters" : {
    "apiEndUser" : "no-enduser@supplied",
    "sphereonIdentifier" : "LTEyMzQubm8gc3Vic2NyaWJlci5wZGYtbXMuU0FOREJPWA==",
    "apiSupplierTenantId" : "-1234",
    "applicationId" : "pdf-ms",
    "keyType" : "SANDBOX"
  },
  "credentials" : {
    "token" : "e5fb8bee-df99-379a-8a3e-98036b7a7676",
    "authenticationProvider" : "API_IMPLEMENTER",
    "credentialType" : "BEARER_TOKEN"
  },
  "input" : {
    "streamLocations" : [ {
      "id" : "4c25f18b085f27dd318153f871a394724333df5fc6679661fa9bda1dc6133680",
      "containerId" : "47a4bdfc-5525-417c-b0ee-fd242db7afd2",
      "folderPath" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3",
      "filename" : "446dfcb0-d70d-4d22-bf56-f6524d000a50",
      "originalFilename" : "sample.txt",
      "name" : "input/e391cba2-732d-4129-bc43-cdfee63c0bc3/446dfcb0-d70d-4d22-bf56-f6524d000a50"
    } ]
  },
  "result" : {
    "streamLocations" : [ ]
  },
  "status" : "INPUTS_UPLOADED",
  "creationTime" : "2018-11-19T09:42:40.076+01:00",
  "updateTime" : "2018-11-19T09:42:40.076+01:00",
  "conversionTasks" : [ ]
}
Example Curl request
$ curl 'https://gw.api.cloud.sphereon.com/pdf/1.1/conversion2pdf/jobs/e391cba2-732d-4129-bc43-cdfee63c0bc3/streams/multipart' -i -X POST -H 'Content-Type: multipart/form-data' -H 'Authorization: Bearer e5fb8bee-df99-379a-8a3e-98036b7a7676' -F 'stream=@sample.txt;type=plain/text'

7.1.9. Get the current result stream

GET /conversion2pdf/jobs/{jobid}/streams/result
Description

Get the PDF as binary stream/file.
Our API generation does not allow changing the media type based on the Accepted header unfortunately.
This means we use a seperate path postfix with the value '/stream'.
This API only returns the PDF when the response status.

Parameters
Type Name Description Schema

Path

jobid
required

jobid

string

Responses
HTTP Code Description Schema

200

PDF successfully created and returned

string (byte)

202

PDF not yet created. Job is still executing. Will return the JSON job instead of the PDF

string (byte)

400

PDF could not be created.

ErrorResponse

404

Invalid job id. No response body is supplied

ErrorResponse

Consumes
  • application/json

Produces
  • application/octet-stream

Security
Type Name Scopes

oauth2

oauth2schema

global

Example HTTP request
GET /pdf/1.1/conversion2pdf/jobs/e391cba2-732d-4129-bc43-cdfee63c0bc3/streams/result HTTP/1.1
Authorization: Bearer e5fb8bee-df99-379a-8a3e-98036b7a7676
Host: gw.api.cloud.sphereon.com
Example HTTP response
HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Length: 38919

%PDF-1.4
%����
6 0 obj
<</Type /Page/Parent 3 0 R/Contents 7 0 R/MediaBox [0 0 612 792]/Resources<</Font<</FAAAAJ 9 0 R/FAAABC 12 0 R>>>>>>
endobj
7 0 obj
<</Length 14 0 R/Filter /FlateDecode>>stream
x�e��j�0 �_e����Vv�蘄� 
m���҃�����j�߾�`J��j � 1�D��        �±� t� �
�[k��݊c R��Yq�E$�L%��m��p�[��,��W]���� 6�+�+�U� VcߍN�vC9�(N(��i�b�Ηp�PR�����b<�        �� �;� [{�ʕ
m�� m�� � �?�K�3bm� h���R4}�5�]�]�| ���B�&� �,8 8��7~ '[S�
endstream
endobj
14 0 obj
226
endobj
1 0 obj
<</Creator(�� S p h e r e o n)/Producer(�� A s p o s e . W o r d s   f o r   J a v a   1 6 . 1 2 . 0 . 0)>>
endobj
2 0 obj
<</Type /Catalog/Pages 3 0 R/Lang(en-US)/Metadata 5 0 R/OutputIntents  [<</Type /OutputIntent/Info(sRGB IEC61966-2.1)/S /GTS_PDFA1/OutputConditionIdentifier(Custom)/DestOutputProfile 4 0 R>>]>>
endobj
3 0 obj
<</Type /Pages/Count 1/Kids[6 0 R ]>>
endobj
4 0 obj
<</Filter /FlateDecode/N 3/Length 15 0 R>>stream
H���yTSw �oɞ����c
[�� �5la�  Q I   BH� AD  ED���2�mtFOE�.�c� �}�� �0��8� ׎� 8G�Ng��� ��9�w���߽��� �'����0  �֠�J��   b�          
    2y�.-;! ���K�Z�        ���^ �i�"L��0���-��
 @ 8 (��r�;q��7�L� �y��&�Q �� q�4�j���|�9��
�V��)g�B�0�i�W� �8#�8wթ��8_�٥ʨQ��� �Q�j @�&�A)/�� g�>'K��  �t�;\�  �
 ӥ$պF�ZUn��� �(4T�%)뫔 �0C&��� ��Z��i  ���8��bx��E���B �;�����P���ӓ̹�A� om?�W=
�x ������- �� ���[��� 0� ���}��y)7 ta�����>j���T�7�� �@���tܛ�`q�2��ʀ��&���6�Z�L�Ą? �_ ��yxg)˔z� ��çL�U���*� u� Sk�S e�O4?׸�c� �� �.� �  �� R�
߁��-�� 2�5������        ��S�>ӣV����d�`r��n~��Y  � &� +` ��;    �A4� �  � � �A9� =� -� t� � l �`;  ��~p ����        �Gp |        ��[` L��` < �  "A � YA �+� �Cb( ��R�,� *�T� 2B-�
� ꇆ� �n���Q� t � } MA �0 �a l ���� ��S� x        ��k�&� ^  ���>�0| > _�'��,   �G  !"F$H:R��!z� �F �Qd?r 9�\A&�G� ��rQ  ��h ���� � �E��]�a�4z �Bg��  ���E #H        � *B=��0H�I��p�p�0MxJ$ �D 1��D, V ���ĭ� ���KĻ�Y �dE�"E��I2���E�B�G��t�4MzN�� ��� r!YK�  ���?%_&�#���(��0J:EAi��Q�(�( )ӔWT6U@���P+���!�~� �m�  ��D �e�Դ�!��h�Ӧh/� �']B/� ��� ҏӿ�?a0 n�hF!��X���8����܌k�c&5S����� 6�l��Ia�2c�K�M�A�!�E�# ��ƒ�d�V� �(� k��e���l
����}�}�C�q�9
N'� �)�].�u�J�r�
� � w�G�        xR^ ���[� oƜc h�g�`>b���$ ���*~ � �:����E���b��~�� �,m,�-��ݖ ,�Y��¬�*�6X�[ݱF�=�3�뭷Y��~dó        ���t� ��i �z�f�6�~`{�v���.�Ng����#{�}�}������  � � j� �� ���c1X 6���f m � ��; ' _9        �r�:� 8�q�:��˜ �O:ϸ8������u��Jq ���nv=���M����m���R  4        �
n�3ܣ�k�Gݯz =� � [=��=�<�=G</z�^�^j��^��        ޡ�Z�Q� B�0FX'�+������t���<�u�-���{���_�_�ߘ�- G�,�   }���/� � � H h 8 �m�W�2p[����AiA��N �#8$X �?�A�KHI�{!7�<q��W�y(!46�-��� a�a���a  �W��        ��@�@�`l�� � YĎ��H,�$����(�(Y�h�7��ъ���b<b*b��<�����~ �L &Y&9 ��%�u�M�s�s��NpJP%�M�I JlN<�DHJIڐtCj'�KwKg�C��%�N��d� �|�ꙪO=� �%�mL���u�v�x:H��oL��!Ȩ��C&13#s$�/Y����������=�Osbs�rn�� sO�1��v�=ˏ��ϟ\�h٢� � �#��¼���� oZ<] T�Ut}�`IÒsK��V-���Y,+>TB(�/�S�,]6*�-���W:#��7� *�  � � e��^YDY�}U�j��AyT�`�#�D=���"�b{ų��� +�ʯ:�!kJ4G� m��t�}uC�%���K7Y V��fF���Y �.�=b��?S ��ƕƩ�Ⱥ����y�� �
چ ���k �5%4�� m�7�lqlio�Z �lG+�Z�z�͹��mzy��]�����?u�u�w|�"űN���wW&���e֥ﺱ*|����j��5 k��yݭ���ǯg��^y� kEk�����l�D_p߶������7Dm����o꿻1m�� l�{��Mś�
  n�L�l�<9��O � [����$�����h�՛B��� �����d�Ҟ@��� �����i�ءG���&��� �v��V�ǥ8��� �����n��R�ĩ7��� ��� �u��\�ЭD���-��� ��� �u��`�ֲK�³8���%��� ��� �y��h��Y�ѹJ�º;���.���!��� ���
�����z���p���g���_���X���Q���K���F���Aǿ�=ȼ�:ɹ�8ʷ�6˶�5̵�5͵�6ζ�7ϸ�9к�<Ѿ�?���D���I���N���U���\���d���l���v��ۀ� ܊� ݖ� ޢ�)߯�6��D���S���c���s����
�� ��2��F���[���p���� ��(��@���X���r���� ��4���P���m����� ���8���W���w� ���)���K���m��   ����
endstream
endobj
15 0 obj
2574
endobj
5 0 obj
<</Type /Metadata/Subtype /XML/Length 16 0 R>>stream
<?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?>
<x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="PDFNet">
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
<rdf:Description rdf:about="" xmlns:xmp="http://ns.adobe.com/xap/1.0/">
<xmp:CreatorTool>Sphereon</xmp:CreatorTool>
</rdf:Description>
<rdf:Description rdf:about="" xmlns:dc="http://purl.org/dc/elements/1.1/">
<dc:format>application/pdf</dc:format>
</rdf:Description>
<rdf:Description rdf:about="" xmlns:pdf="http://ns.adobe.com/pdf/1.3/">
<pdf:Producer>Aspose.Words for Java 16.12.0.0</pdf:Producer>
</rdf:Description>
<rdf:Description rdf:about="" xmlns:pdfaid="http://www.aiim.org/pdfa/ns/id/">
<pdfaid:part>1</pdfaid:part>
<pdfaid:conformance>B</pdfaid:conformance>
</rdf:Description>
</rdf:RDF>
</x:xmpmeta>
<?xpacket end="w"?>

endstream
endobj
16 0 obj
807
endobj
12 0 obj
<</Type /Font/Subtype /TrueType/BaseFont /FAAABC+CourierNewPSMT/Encoding /WinAnsiEncoding/FirstChar 32/LastChar 116/Widths [600 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 600 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 600 0 0 0 0 0 0 0 0 0 0 0 0 0 600 0 600 0 600 0 0 0 0 0 0 600 600 600 600 600 0 0 0 600 ]/FontDescriptor 13 0 R>>
endobj
13 0 obj
<</Type /FontDescriptor/FontName /FAAABC+CourierNewPSMT/StemV 80/Descent -300/Ascent 833/CapHeight 571/Flags 32/ItalicAngle 0/FontBBox [-122 -680 622 1021]/FontFile2 11 0 R>>
endobj
9 0 obj
<</Type /Font/Subtype /TrueType/BaseFont /FAAAAJ+TimesNewRomanPS-BoldMT/Encoding /WinAnsiEncoding/FirstChar 32/LastChar 121/Widths [250 0 0 0 0 0 0 0 0 0 0 0 0 333 250 0 500 500 500 500 0 0 500 0 0 0 0 0 0 0 0 0 0 722 0 722 0 667 0 0 0 0 0 0 667 0 0 778 611 0 0 0 0 0 0 1000 0 0 0 0 0 0 0 0 0 500 0 0 556 444 0 500 556 278 0 0 278 0 556 500 556 0 444 389 333 556 500 722 0 500 ]/FontDescriptor 10 0 R>>
endobj
10 0 obj
<</Type /FontDescriptor/FontName /FAAAAJ+TimesNewRomanPS-BoldMT/StemV 80/Descent -216/Ascent 891/CapHeight 662/Flags 262176/ItalicAngle 0/FontBBox [-558 -328 2000 1055]/FontFile2 8 0 R>>
endobj
11 0 obj
<</Length1 17 0 R/Length 18 0 R/Filter /FlateDecode>>stream
x��| X\յ���y00̃�5 � &<gx � �� 0 �          ��0� F        C H mMj�D�����\m{�3 �J���m��Z���V�m�Wk��T۫�����k�s ����~���~�s�{����k����k�a � � �  m� E%           @� Xz��yG��s� � ����1.> �3a�$�j����m� �� �4 (�e���ؽW�
@� ��4�� �� >
` ��+� �y�� ��b�ж�T� _�>�eÁ~/� �� �eۼ_  ��| I�� G��| �� �(����@p|. � �����o����M�  �� x� �  �Vܣ(E�ӥ��� gT(8  �q
N �Ba�$|� ��`���  \ �? ޝ� �� �� $  ��>�6*
 �&h7j�8  � 3� ��Q7t� �� ð
F  �0N�_|,�V�d8 ~0�}, �w������]L�E^»Xn  � | d ����-�9 ��
����e�Ezu��mVw�f�� x 5� �D\)z�!�� � O�tC � ;�U�
� �6x > '����  `7̑����  g��˸��\ � ��5�b� r
  �N� ��E� �`�0��U�Nx�ߢv���!'���}� ��N ��/� � `� �h�{! >��g ^ ކ��� &૨� � �@z�5܉���S7� ���C � �Ў�߄��(� ^���;�  �%{���  ̞�; n �� �� h�=8�N�����o� �3�osg� Ȼ v�ׯ�[`?< ����w��4\'��?  X  � �y;�� < g��,#���\G �v ��)�  #i �3��
 Ц߃Cp
^�_!�?�My�J ��l"_#ג�ɷ��ȣ�q�> �oy��������&|O�!�k�4��<�L 4�?_��p}��I�ȯ9 �� 7;7W ^ � ~&� �C Ү�Z\s3l@�w�7�8<�s_�_� ��J<� #�B$v�N:� j� ���rI�2n���^� � � ���#s�s�s ̅Ï`T�4� �� (� =� c>�<� �y ކ��Q��XQ�z҈� ��!�b8����G�0����?'�
w͵�m��k�pxY���B ��2|Vc4uA � �� <��9��s �DRH )&
d=�&�d� �(�N�"_E�>D����4� � 'pJ. �����k�۹#�)�4�6 | ��o��o��/� �S( ��^a�p�  �2I��O�?�6�7{��O�
�j箘�;���鹷±� �w@        Ũc lE ��� n��1> F ߄w�}��_� <�!f����V�z7�� H  �g�\���C !���$y�<G�'�&o� 8�� �S���� �5��=…������?|6��K�R�����\�߀빓�G��Da��!� ~��  �;   � ?W���+/�sDgt���=-T��p �8���5WA��}B��K'O��t��o�j�r��q��m`R Pڔ6� zU/���� � �l> �q� ������ �'\=F� � � ��? �&T���n�        ��� 3��T��^��� ���K�Q��?Ul���w  �k̃k �� �HΑ6.        �U�� v���9l p ����l�2�,����� ��v�4��8 s�� �2܏c����/���v��*��� dr�\&�s �'��$��� }��  ��r��
׃^� �Br5��6�K&�If�,� w+� >�ǟ���r��sd���)��� ' ��њŘ=\ ! b��i�1j�@�91�7c l  �1�*7 ~r ���{� Z�� �:r��ǂ�/E� �lR�\� E�"]X�  *1 ��97$�Q\Ca�e��pO�6�E ?� \�֩�� �R=�N��ed� � �px=<�  � '�8b�_�q��=A*Ȓ�H��c�:��˔ ��-� � &�����        f���6� ~���w���A;6�57a��� Q %� WW        ՘� p�
�c>��,9�g�v̼���0�'T#��2�7 �#>�'�Up5���a �;���+�a�~����=�����:����w����p�� ��%��$���%+�� ~ �� ��2ܥ ���ç�?�} �} u�MY
�+k  Z�_ 3Q�j��:]U�k*�W�*[�|Yi���� �#?/7';k�=�&Z3��,�Ԕ�DS�Ѡ��k�b51j�R!�  ��^�+��{CB�������^Dx� �! Qu�iBb/#  S��r�<J�D隧$z� *
���.�^���3d�n�o�����s nf�~ k ��p��I � C�W��v Mzzk��T���^�� 8aJ �`,B�d�� I�$ ��=��8PkQ���^�        ��k� !>��  �����Zl�� g�����B`� � � j����&�bbD?]
� ��''��衯� 7` �n� �� *��@����+�NY�"scM��ѣ ~ғ� iwr�z1tp]w����==� �rYu��u(z  ��CDiܵ=�!r-� �J誤��� ��\ �ث�C����k̓!h�e�6�]G�g�� ';��P����M�2�d��é.1u�H�sJo� ; ���8m4�� c #�Pc��e        ��ހ   �EԤێk*��� &�ː _= g� �#�PLM�~5���!E��.N~   �s�� �1�,��@A '�� 8�p���i��jЧ�c%�//p����Q��
� �жޞ�Eh~��:x� �� ڳ�[��g� W��'��ґ����.:�'22?�׎�|�]� C��� �>)�3�:D�>g�'�7v� �m� =���m ; ����1 
%�t� N�8 �F1(7� �Nw\H�� % � � ��a�X ���Ku��f���f� �Y�Y�&� Z�X�/_�_�^�$�
 �\c���I͢�:�@��uv�n�w�; ��g ��ɣx ɞ ��F<: >�� ��׃� "�1Z9���� �M��
  �����
���x����Z�c�GE  �r K��#� 4  �i�:Rz�Q ��d� C�~�  �SGp �g8        �� e3A.���� ҈+B- N-��HԹ2� G�t� �{�JC � � 5�����6 K 8 "��U��ئpRh̾� �! s R���z&'E|�ȿ}�T��C�RZ� �pj �Ӑw M�=}�`r��F�
sH:r�P6ڍO�a � w��f��2z  �*�� *��R�fH� \�B� ��U* x��9s���$��n�*�Ѣ���y��E�׊f�l TU�Vв���`3d� �� |*�'?u)�  ��(̀�N�;�|($O� + ���,�Ε k�
�&g]A��-i�y����o�: ��;         � h�3�w]I�[��k�3Z��3h�zC��`��ѡ��������t{�3�g(���S*y.=�+HM`����Ƥ� cz�ѐ�FQ�V����/Y�5�b��Y�3-f�3??�b6Y,f���� �P�%v;��@2 �B+^� cR ���ls*g>�os���e�϶�t1U` :��r��E�� ��\�� �x�T�!|�ASe�        �t�Vg `h5|`    � .� �`{�C���ۉ���9�9        ��� �� Z�`\U�� �B_q����5��� S ��T
���kp<����y{�G�� W��V�+*hYZL6  _Z�� �ݖ��|ي�Rb�  9o���<��o��S�ٜ1�,��$�7ڒ&�� �gV��z��?Z�$�Ͻ��`LI1&$��%'$$�H�\����G s4|F0        ��}�-W���&Kk��ҝI�%]o�Ѳo��՚ ����j}���� կ&�!��d�e&��鄔 3�߻�8\yk��):�        ����b;_�L� � ��]Q�̐U +��Tw�� 
��,˲�� �����g�{Wfm� dp �:S�ki�=�� ��λ%���Cy��T�}Lj R��p�ln~� : �����Y� ��ԛ� �Yê�s c�*Z �s �W--���2� �o&ԐhUj����l{�2є�%'%'1[g�HC�%BĖ��X� I�Ð��Ԕh�d�x�{�[��;��{C� ~��oP�J#ǿ��<�w�jӦ�          �i�9�3�)���n񖴗Z
i�9�����b:�G+ m��;��[3 �x����?� � ���߃�� �ϵ�a�w�  �٪,k�0��Ӽò�t��6ӷ͏� ��k~��        � �LG�G3���hi� ߸� � ÷��U��� 
 ��𙥯.}g�:7s�{�e�*�eee�2s��        �y+l�"��q1� 3�k#�! 4�6>6� N�s��;����rM��m�*:� Q���IU: )�U�Zm[l�� �N����6sY�-�6%  (�W�P�Q
�ԕ�ǥ=I�J ͳh��$M�Pu���9�3�6#TU� :vռ[W V������S���PjGch        � '@ � ,  ˱��?:lT ��ث 6oG�X$5!�q�@���I:�ѱٶ\)�>�=�ݞ�� +W�d�c��$��� M4>V��O�t��g����={��� }�&��޶��G�n|���
Omm�9��x��{� \��N�gp�&�h������ϾB#�<`з��7
m�Bwf"����:.�U�[�+�_�[��Эѹt5:O�1;nE� ˴S�!+ ו֧�K W��)V�J�<*OZ�JQ�^��:9��j���r��5��+ u �! I��%�Y�F �z��� ��F]|fb����!S��e�edfZ32�V K�R})WZWTZZ\����E��35������U�YP���.,�MOS U�JW9�)�m��  ëV�X�����Ƌ�I.���=I\ҧ�� bN6�g���?��"���� T��|���L]��X� ,4D pT�7����`��  z$  W�|�l�T��b���� �R� �QP�Y��d ��氅�g�
�e�p8z� ��r��y)��8A ��'�X�B��I��\E���ę� I�C_�p| _�y3ƣE ]� 4�?��E ~ e� $�� ���v�� � ��\���Z��4�L �9!���
�� ��n���T- � c��?^1� W_�b�Z�� ��  �� غ������ߢ�D��u =uu�򦍳O�p��tuz|�/3�֚
�y R� @�� �0� �]-l�(ς���U�T�[��ey�:��m�   �S^� 'W� ��TyR�굘�s^[� �; u*��R���� �Ii4 cS��SS��3��8�5�|QP�3��xƋO��<1� �|�-V�g#� *��g)�m:5Q�K� /f��[ӷ� ҅�Ԓ�n^�[4 +�a�Gѹ���Y��1H�Tt���vX�#`:7��X�#( t� � ɱ�[�4��S9�2��C��Q�� �H�L�-�s�p�m!�I�L:�h�"���N|����� ��� � ����́��|�ݯ�r����}w_�i�ű'��O�)�C-!Y(�.�����K�o}�E�P�1C��w! 6���%  ����b���� N��&$SmLI����� 1j
 Ѡ׷�O�y}j��)�F��[u ��J � ��d�-Z�-�8�Vr        Ͱ�)� t�_�i ��d[$̄J f g{�$-�8K  ^r�5Iw'r%\5���s�r�&�K����S߰�[�;��NҦ��-��2.�4Y7Y6Z �a�Ֆ}�����xJ��H:�v�?e|.� �� �Y � C�-Y%� �q���@F�F3� Wr�XN� �H�t����I0��� ]�����؅������ؠ�����H2�����d��f��1� �����tF�TJ<�`�2(-  �㨄�O���C��ҝ �O� ���Ν!����h6��z���} ���T�j0�K6 �sO ��~}���DϢG�z�h�|��        �&VW�� @� ��%���Z�Y�Y��Y�娖$�$Պ�Y�9]�欍9��.O�gݘ �4 ��+�`�IX�xE�`�_�
�9U�h��� �̓� �;R�m�^���֞m4�RM  �:>5-Y�M�
 [�*���L{ �f��/W� ���֓V�jv�l�����l�˶f��w˩�SQ� �L3�9no���st��{[�0��" O �YH7���ʈW �f�;�2�θ�� k��`̥�� C2�<���?9�p���zC����??�        �}�i^�F#��Vs�e���|��6S��Q} ��<���z+Z� �  ɤ�UfL �L�I�s��W��)�U�j��
���an �j��r���0��N��:[ ^�Tq6�'�.����ɬui ���� z�M� w�+ňw3$S��&�׳ �g� * � ��� <t#�� �f7ow� �k7 �X9@�C f. f.�)ޔL3WB���� C�|��,{�A�M2�-U&Z h0%�2�bMX�5X�h���p� c�T�X# b�d2$W�h�`ҙ(�)�  �&N�3��x���8�y ��!4MFvETR *�����ܟ���OHBכ  �I 9tr�Cb8q� �>|�;�?s߽g��N ƜGϫ2r�k��W��)�)5��zZ9�淫���~Հz�� �|O�]e=L�p|��r+ D� ̈� �K�&r�u���)��Ƽ"vT97 ;�Eřy�Xvk�x _�����d �ۺ ��Y\�&��^VB���uK�//Y�YR^�$��Y I�+!�&��rs�x͌ш�3�$u�{Х_
6q����\qꪵޅ4L��� �9�:w�c��nO �:��\�� �ɒ�P��J5�LS� ɢN��$�������h�j©�������vܝX6o��A� �3��ŷ�� � �o��m-���_ޤ۲�m Wn�Ž�?�z�|���S����a���  �sU͵�>�B� r ��r�6p�s�%�X��b�p��<����e�� Ŏ��� ���gcO�*��Du�{  2�JT �J�I���D�No0� �qy3�A�!�|� U9!����ƚn f�C.�ө� �m�B�>ML M;��� �;� �U w���L�);T�8��Ϟ�� � �w        AGě-��Xs� 4�8+P � ��7�� l0��d/�سTΔ �?g ,�����J�V�� �k�� `�G�#�>j��_5����T�Nkk����(��> �o���_;�uK� ]��� 5�����u^ڞ.�Q V��~� ��} ���� ��'�w�.}!�
o >��7A�� � �  R�Q,��$b)�r � ,�`� �0���#����"���& ] �� @�= q� �� н �� ��I��߄ � J��z(�  �=�  � ���1�P�}�k�> f�Hb=��^1�+�a \\�  Q4
Hᮖa%�qwȰ
F�� VC1/�p ��m2��W�� ; �alޖ���2́�8)�<��[eX��Q@�qJ�� o�� �`��y VCJ '�1 �`�a��Oȥ�  x� gv0XA-f^�`%ïe���; �fp?�cP� sP�% J�dC        �l(�B �dC        �l(��
%X�� K6�`m|Jڭ �D� Ku���qQ�x
� e���� �  6��`S }"�� ����l�� �P  ���( k ���;  ��` �  \Dau���(YqQ���Z ��t        ^&��J�:a |�6C�}Ck v�(��`o aZ{ �g ��{]���Ў��8 ����և�;� `�Z|�ׇX �DL+�>�r#r���.�=�|D� @�~�G��}cl ΍� �/�R���{+1wS ��a iE��E9�G?\!�^��!���        �18�&j ?[��E� d� � �}8B�^f��k�� 䕊L� ������ �މs� f � ��D�G�р:Q��ټ f�r6��(|�
eRK �Z�5�Њ  D ���  �A��Q ?� � jd=��.-l=ԯ[ ?��=?NV_d� �H�g� �k΃��*8��
��
}���ģ
:�~c�b $;{��h� 0�P-�`� �����Q���K�Ff�q���Y�| P�M �Q�-�o���8�� �V��c �
ɗ��� ��� �%4��>>�   ݨ �Nf� &g��P��/s��}/�=ʴކT�l���czD���  �gH ?� ��� ���� ��uFY ��c�)�;�)�\缜�W�g�٩�e� �l��R?�
�, D�����s� ���y��܅�K:�����є�Vč�=<�<�? s ZAD�g�*�� � i-�L^$��X ����� �|ދ�T�=�vg@��UI0ͥ�rF��F� �3ľ#<��1*�<#�g �Gv�_�� ��~���qٷ� ��k��a����V^ �N� /� �8�lf>'� ��s5� ��H!�q ˿>�U/⨅�"Ed�H��l�'�ޅl ��XD���<��痘v ��  1}>�/G��H��ع?,�{ ��ygr$*/~.Sϵ��`��!�[� �,k+�� ��N��1���r � ^f�ϑ8��jT>�$         �*��#�ⅅ{������/�-�ek�v�˹~@ޫ��}��G N%*��N� �MYNj� ��7 �v^�� �)3�(�|v��Ïe_?� ��pvs���"�?6���O�� �k�ָ�k N�� �,� �����/*Bhޒ< Dn '��u ��'�T ��%� �d� �. ��!�� �� �j�        /�2��Y � ����� �c�4��� �2�(
 XMe.��r��:;�?' K��� r�^�Ž�1�2΅�'H7��)�`��I�`�蜲xV��
�W}�/|�z/�ѱ�� Y��0��.�N�� � ����V  6�
u�ۀ�e;�4 N�,ڎ#�G��� 19�/t�� �
� �G�.v�I<ڱn�~ �qu �>�5"} �s=��dx�[ �lg�� ۄ�G��3j �ž�� kY ���,�]O�|&J�v"^�_�b� �Ĉf��kG��� y70~T*���-�z�ɚ���(gʓ��F �Ql �mH���ٚ%m[� �p\Z��i@% �k��}��#�GT�&| V�f6�g�,د �6Ԝ�_��zFd4M̋ e5�O�HW��z ��<U�VC�JmP�p3���kg��K{ �Ŷ��� ����庆Y���$o԰^'�  uʾlg�8_�  � F�f+�: �����d�Fi"ɣ���% ���� �Kd�K��g�B��f6�zu�K� gܛ �%�KW��C>�90  �5� k c��1�?0R(����v�֡��� ��v� 
E����7��)���F:�&��ĸ8 ��� � ���� ��/. �i��)�{�G��z�H��
�^    �' �TR�?( G�  �����a�wX�%"M �����X� ����1�812�  ��: :�&�o$�+ �>�����  �
�� V � ����t�Lƀo��   � O?ri��l�m� ��El�:jH�m��� ����� 岢pU�L� m ͝� Pg�8>� �m�]!  /n�
� p� b�o||�76�� �   ���  #�bO`B���%N�*ǩ=)Z  ��c>��) ���hc��   G��8ڏ$>l�Aq�7��?>���v1[F,6� h�� 0H%8i�,>���X``��)�H��N:'"�?"� �� Ei� ��G��' hXE� � � s�y��ȑ��i+9�?�U � �����r  ��y^�� �~�2��F�<�G� ��#� ��b�y%S�;q9  ����( ꀏ.�� ��G [ 7��.��:  �}��}~ԹP���     vR�eS;�>o u
�� s�        �C�㣫��|#�;�W�G} ~oa`lk � !� 9��н,,�T1�����B���2E �x���� ���Ʒ�7�{��{�N��\����6� � �n4� gm �e ��� �K���!��V\3�1�
=���@ �� j /�%�8�⫠
y��@��K�c �?�
=╶� -�K9.Z��!'���F >d��pA:q�|�����)� �>2<��8�dS^cR:E        l � :�m� � m}� � ��� ۰Ⱥo�n� E�Q�+,… }��� ��l� �*mx )m ��L��C�m��F�
&�FP  c0 ���t���?         ��8�� 𳍷Z
qo_`�/�L��F� Ӈn�хH���C^\U�o���F-t�� �c0��E�y���y ����#v��unp�{Ć ���u}C��V�qw`?�)nh�o�� ������#�։� �����)z���=  bk�������A\CKMSWmC�Z� 絴��Ӏ; �v��T�̪��A�5{�k��nhj��q�u
�-�g 2u�m��Ά��&w��������A�ȶ���� �x�=-��( q�g=vĎzwS  ��B�ۙ~5�m=�
k�;��֦Z "�=�����#��E�4� ��b��ٽ��f�"�vF&k����P(ύ?5�
�-t 5�-���u�*�;�nh��8Ew{C 5H]{+���� ��        �k�H\���E A ����,�R�q7!� :9��P� � {��eo��` ��ۍ���ʿ��J�� ��̀�kp� ~��  �Q� ���珜4�|������������ I����‡$R����� �H���Ò/?,��Ò/?,9?����� L"���C�/?4��C��q ���\�탗� ���؋�̈́o�� �/�E��mE� �
��Za
֫ q ��-H����|6DB�x`�Ս�c�2�!}� `���? 9�{�p :�'���]�� lV��p���=��ղv:���]ğ�Q,����E�-X�1<X���B�����q a9��%, s 1� s 1� S�� �⟜^bE�G �.)��m� C  ����  �Ln���-��c�_no��N�[u� � � �0  �v���֒� XY��  ́È��S�{Q�{Q�{Q�{Q� �&�� �  � � 0� �'&�ʖ'���{�uI2  �����C        ���
��� �        w/߅� �� ߉�-����VV�f��  `p��U ��aZ E�VV�hͷ� x�����KX��{  �V�Ӷ�o`m3���M�O�� ��^�ױ~ OS����>m��uӵ�b�(��� ��(� u�E�j�H s ��X�0� �wcy  �(        _�O
>nލ3\�Å#.�y >U�T�8� i�`��+� +�� %U��*�s �� �S *� k�_ �X\Xڰ�bQ  '�s�^N��� `        �q����(�Vn/d`���ΰ��1� h�ҋe � �ȴ¨s���� aiŲ �n,�c9�E
U҈+����V�� 0�� WT���t�Ԧ�Km��D� ���Lyp?  U�C��p���  ��� '����  j� 4F  #  ���s ���}�%��� �A��i l� KQ  ��EL.�rqN.��"� ք͠�mXn�rB �d��ɂ3 ye��EXW1H���Ϝ�bt3h_�Z�B��b�A�&��Mh��h*��&ֱ�H��!� "3n�r ��?�O >9��Ⓣ�
   �(���܏�-�܌�M���g/z�t�q��mY X�{�-��_~h���� �^�ץ��$L�F����s l -�oV?��1V�X��2oҾ�I��Mڻ7i��I۽I۲I[�I[�I;C�\� �� �� �z�v�C�ܡ-uh� Z����
x~���լ.au&��Ɇi-���\
65� �s��u�;� �L[�a�Qcs�ԻTj�)�Ik�m��)a��f��G r�.�(����T=�ڢr�V�
U �\U�ʮ��Lj�Z��Wǩ5j�Z� Ԝ Ԧ��Y��� &��6J�� �� �9�ሚ���� ��k�&������'���a�!�u C
{5          ���:%���8�
��� ����K�� �� {!�  ��3$LQ�Z�?�;
�8���"�==tN��@n�� �vT�T +
��j/P��u��k�D��&�$=tGcGw����P         ��=�h9���re�
O�Qn%mz��j�pe�v����Y�  �G�F F "� �<� n%�ˢ�D���2 �M��yj�l� � F�f1���4[ �V���hlQ4��`c46����d| �� �DY�W��� 9
���S5W���k������ J���J<
5����{���h��͐�v_m��^+N]r�g�CW��K�Sp���{�J��v� �% �����Zo�c���  7�� 3/e�Oe�}� Ï��T�cT�cT�Z�Z&�E=�� �{j6I�a.V� �k��T'�G+Y4��R��  �� b =�8{uH��  � �t w  ���cQ J���f9F~  � m�WC��_�?�� |�� }�_ ����'8>��:��w  \�;�ee+�g�ef��i����q� �� @���j��<4��I0:  x��Ɔ ��� �A��  9p�  �
P%e.� L+ C
endstream
endobj
18 0 obj
11610
endobj
17 0 obj
23852
endobj
8 0 obj
<</Length1 19 0 R/Length 20 0 R/Filter /FlateDecode>>stream
x��        \\��0~νw��ξ�̝ � �e � ��%�@         Y�  DH { 㖸k�MZwckjݪ}  �DkM����6���V_Mkڪ �m�] �{ι3�������������ɹ�9�>g{�s�        � ! ڋX�ڲ:Q�p�7��UH ]�;� �� �p �`��1a�w�:BL B�ؖ��~�| !�� ɫ��߽�9� :��� ZpUoOg��� O!��
�[�  fN9 e�G���c�_�5e ��P���� ���F�!        �k�w�?��*? ��AY �����__ e�_q����X*��B� �?4�3�l�ȁr B�^IJ[��! R�n� �
BR� B[  �1��U�d ˝D��c��s�  $��\# ��>�m����
 ~\D8�JA��dMd4d�+ � 
j � �/A"����8�G �  �b� U� T��P jE�P'�F=�<ԋ�P? @�h ��Q4�v��h �M��?�#���{����S���z >�Rϧ���E��q��N}7���C� �nO}=u0uo� ��R7����J�ԍte���� /Ћ�,�F�F(�[H� �9���  f��N�f"aRJ��� (��D7�'Q;�        â:���SJ; ���r�#;�a5�A � �bE���   ����ѥ8 �� ��
d 
~  �KSo�Kы� = ���"��&ܐz �D��Ga � �[��X��pG� �נ�Qt5z �
��Ft�� �ҊV��ԣ�\�s� ���B���KЭ��        t
_��q�T *A�� V`3�a/Kݏ�d/� I=�:�x��&��  ��S����� H.2 ϋ��]� z ;p        [��(        c����a6 �؀���=�/ćY}�nXM)�B{�I|>>��d/��O]�L��$�t � � ��O�[=nc��V�V ��(
r5 Ծ
} (�C�<�
؇ �� ���o� � ��}h }���sp ���b.� �\�z �a�"�� rُ���X��@�;�]�%� � �*�ý�*K=��( ��� `]?C/���_�� ������]�� � �� �  E ` Va-�`  �RXم� �-�� ���f������ԗ� d� 4� mE��+ѣ�8� � ��.h���U�  ��O3��u��͜���=����Xf��p��'�ꤟ � �v� ] ����S�7��n쁞 �e��&� _� ����� ~ ��o����  s=s#�8��q� ��汵����
���s&{����R�T4U�: z�Jj�r! $�
t|#� ��
t ݄� 4 � � ��u�9��  |�� MN��  p �`u��z� ��7��3��� ��A����'�Y�,c�e.c�a>f�l��f�goa_`��� ��A�#��� !��  �ym ����<{0U �( �3��%��5��� �3 � ji.��� ���3� Gϡ����+�E�|��-��i4�f1 ��a%|��  gj@Z:p �V�\�/���[�s   ��s� ~ ���� ��  g�����V� � >��.�R�:�a���� �
�;� ,� Y/ a����k�}�8�0� ��\��� �mܳ��a�
�F�&Y��:�7eߒ�P�c�)YJ~��.���M�Z�@ѪhS\����qū��2 �� �ϝg�n��p        � N1S���3c�O� �gY�}0�n���b�`�~� �w�w�� �j���`ŞG�C��^䬲7ѳ� � ��F���>s �� �Eܕ��`uv�<�ż�(�À�'��&� ;џ���=��q�>�i=� ~�y�Y ��2��y ݆ � \
��F����⣬�����A'�;���r��%L����/   �+S�2��?��� _�^a� �� ��        t/z ��K��^n�s����� �D���?悠A ��l m�N � 3?������� �j`��Z� b�� �
���Q=: � V�j���O� ����7�v� =�ZQ����ˤ��8 }
�d�`ԋ�>e�$�� <#�� f� ��2T�7㍨ �4 Oj;��^�Eb���m�
�(� n�V�$X/ P�f�jv 0  =| 5����l7: ~ŁC� �iZ�Sv@���a��e?� ��Ak   �N�� p ��m�W��%�=1Пj�E ��~f � ��.��/��* �j �� /s>X��A��  �3�>�����e� ;�y ���~��5��Qt/X���$�t# � :� �q 3 � ;{3��c0�W� �r��bx � �u�� ]�  �V� ��#� <e-�<�=
�w] :z7�� �УlT.{ 3(6�"U���O` xC=HU x��x fa�u� +nA%�K�� ����� �  �`e��:� ��o��� ����� ��K��ܐ�dM�XU��b���ҒdqQaA"? ����D¡`�� ���,���۬ ��� �:�F�R*�2�e0�� �;��p�8  44�I9�         ��*:� ��? g\�h�٘"`n� �(a�s�� *PE<&� ��� �)�q�z��\ � �OS��� (� �� B���V � B�x���}u ���C uM��G ����  5 �� C a{%� c�[� ��:�Ը+P[7� Ԓ �������֕��j�>߆xl �t 6����qC��� :̸�f\A� ��j�u�C�c�����推�;��y��q�s  � �qk�� �r�)B禚�WϿ�f��9� Rܷ�ja��������u� � �2���}�0��@��  ��r��q|% )���UI��        ԑ���¸*�$лok �Ƶo ���p�ģ���U'�k[ ��W�  :k� ��}�vO:E�y��x�!�( �!�!
hu󁞹{ �� Z�j����(�  1.t        0�� XS ����}]e�  0� � ��j:�� I=i?. � a�  $ 0���5�� y��  ��ɜ��� < ����  Q� Oa���\ ��b�  � d@>�
��ܰ0 ��� ��� �f(��]�^* h�{ ���q���9��c]C���ܙk�  I~�� �����? o3��. Ƕq�G��|u`�ʍ녺} i�.o;�$�/������5�Y7�� 7K�P�;�L
��\ �ɩPwO)� ��  ��|G�tݠ����FS��I+��i��������Eg�Ϛ�v   �������ϺW  h߾��P��c_�Tj��� � ��&�o��#�ѩ�c׹��� ��� AZ �� �f�C"�f���Ga�.\Ӷ~��LMǒ
  ���� B"�eH-�$ � `s �>�()�����^z�� ��5� �Sf�0�b�:^ (L  ��wMq� 1��A�R��+a礱�p�'w �� B���G�FM����@�lC �p D Y2ؤ# Z�0���+�X�hF2�) � �S 9�r�S �=\�T���"G���b�b ��y� U � �� ��g � gq�c�=��(C !�; c��
��e�dǀ � ���T�����
\�_ x@�(��Y7�cp0�  �S�5�j�ϑmר��Qf�lFk�
 ��o 
 x!�|���  _��[�F>� |L��`��
�N=֫/0b �=� � � �� �?� a Ƨx�7�v�M
 �`ö��e(��ŀ�v ���{Ç�'�'�`P�BX �B́�xX��#�b�o?�t5�L�#GU  ��
 ?� �0� M�rL.������Q���Ӑ; ��t�X^ � ����1��>���+*  @SԎ�q � r��n�[}%  ����& ��J �$#�H�eٶY_yV�{����/��ߛ�[�q�̐�E�ə��?>�/�bI���+C!M�An�G�#�+ �l��dV-� ~q6 R        �:� Y *�+�i �T1BqA�P����/Y^����W�j�z�zQ����,�kշ���o���ޯ� �:�X�Z����Y��) -ڪ �;Tws�U�k�i1R��j��V B��,,�m,;*_��Od�r���� `9�*t��C d�Z�6֮��&M��œ\���:r �R�0(Z L \�+ +�+^W�
�A �(*> }2�$�Uі��`tOt�Ψ2z9o � ��6�X���A��1�J��,Z� �u;�w���ͧڇ����  z��<1��g�"���vH�/���w ?��2E���Y  n�?4���E J���|&`��lŴ�J| N         +Á@��   ��w_:Ƈ���-���•��}Qh�G��EA�^#S��K��`8����vnv�廾1�p����ˆ���gW��z�c {ѹր9+4;x�^�        �kN�b�e�CY�
�e�
"6! �
< �  ��G�'=�{  �� � Ȏ��,o���b[+g z�W�ٱ���ڑ��3r,��m��k�J]+n5�,���Uo�-   ��K =@�,=F�� l�*^ �(  dx����� ˲@  
�< i��w  DC��5����"4�D� | 3 ���1�[��&+Z�t��@$� u�$��� ��p� ��:�l� f'}?X�F���h��p{4:�<�~�1
 LR�4K�� �W�G�Dee�� �~��f��  ]��  � 2Y �,� ��0��R'',�4���o  C �� d X )�Y�T��fPiZ��  �i�?� { �w���~aI�  ���f��b~yy��
��6Oh��7q� �  
� \1�'6���_��اP!�`� �r�/� ��H��M^Wr��`        [Ih׹��H9�Dqo�; �Ɵ���{)�r� � E�b�y���d�}��&t�� |  Qj� xo�m���;
9T�Z�e� ��l=��Y�$>Y�V�Z+� �
J�j�2��(e��� �b%�?���h, ��V ?X�x1� /.n.�����w �G� �?+����b� h�"�T�y� ��YcQ��=� J�Q.R6)/P^��Sy��9寕*�ҭ R� ��u���(���%���)� �' �C̍&
 �c�c�q���I��u�;�� ��!�����* �!�%bU1.V�[c yCL�m�T 2|BU�ڣzR�        �1Hū � ~\��ʽ��X�Q�T�o�V7YmNkNUʍ�QTʗ2�E21 J �ޗ1 2Q�*�q2��5�)\x%1;��������� ���ç��G� �O><�NMO4   ���        �9}��6ډe�R� ΄
/�#%_���@�Q<������l ��7  �� �� f �<� B�a_H . �=F �
* �  �� �g�<X�K �ȃ �(����z)���v          G�0ԅ� �$�  �  Hb [�t��"pWVj��J�rR 1�%��"���kZ�N� ��S���
7.�Z3���� �z�E�r{��նnT�^ �9�E�n�k���W���47��z�9�uM�
�� /ɻe�&�LJ �j�߄˗�\P� p�� QP� x4   �L{���   7a� � �� rM�+���>��A��  m��  � �R.S#b{ ��ՈЅ �<���d��d��B��b�lO�k�~
F ^�h.�� ��Ml�Te�o:f:i�� ~a2I�#���q�1�������}�Һ < 5P� ��@= :�8�� � x2�fVQ��/�5}����   ���}ns) "��J��
����׎� ����%�� AF�uk�Z�\{{ַ����� �* ���%}� �1 u���
� c �          A�9 � � �ɀ*� �F�A~��b�#y^�H �X�4)  ��� H� �PP �H \�A�D�p�x�� ���� ǂ�����
Q.uP�UW �ʒ � tBs��|�O�I��g�C�$ �fk�X {��A&  
2A� 44Ϡ'X�1�K &i�(�9tF2ќ L���        �1�        =�w V\�Hk*e � xɣH���J�{ӄ}RpX1]Eu�} K  ����g�I�",�ԗ֕ ���>��x��V�\� �� �s��윲H%{�Lp[�"xqkc�ew�ѭIeh��� �� �&%�~8� �fn 9ѭ�~�f��� � 9�� щ9���^�`��)Ј V3���k v
��l����� � 2����m���hQk�2 *���d�|�|�̚�� k$  �@(E bX�
���i(���S�d�@hr� �? J Ӹ� �� �< ! 4ԝz�5C��^�YydÅF� �<����}�k�ɕ��.۱������  ��M<^ \ �~�AY� ��!�n0" �� y �%� �&�㺠�Hu� �f=��E $�� � ���X �3m��dT�� ��V��"���J1c��N��]� ���� ���b"^� ���v�켝�_(zZ=��F(� .��� � �+�l�� @gi?���(5 U d�@  �1��O �p��sDq���� �~Z!���.�qϙ ��EL ��AD�(D
:��m��Y �h�i�R �A�n +TJM�ȑ5鋜U�  g�a�  �_^B��RVE����I����h�X� �� b�#@@��w�^�`� �xB���~i ]���V��8���އ#%e� ��`  j�n_1�w  ��I  � �:�Z N�        y=���[�V3#���Y�,g +7�L Xe� �T& r(�#ب�G���{�Ym��,�=�(��%/�� n�f�X���q#n�wkeC�=�=��s�|�v?��� �W�G1� 2�q�W���5�w(q;j ހAӋl�1 ��)I��~9u~��/ \ �� ^��s�K/�z�xq�]�iȏ{":K8�b����}�^u �y�G8���� ok_���_�        � ؓm%6� �l���(�  I~� M�J��4� k �2�L ���f~����Z�%�z�� ~�͘ zؖG�z��G  �4(�;� � ��WD�? �� ~uЫ  ��^a���h
D��(��  "{�s��� �)�i� l��R��k % T2*W{a��g�Z� ��70X�`9na,�=X�5X�k��% � v�B���8         q  � ,�?� l!.����ǙD|(���/��~���I<� �i� O;�x�1P� �1ij �K�F$ ��
 |?� �c��g�i� N{ �� � v�Ҏ�Zsb舢f�>���� ���
 ?p::<-        *q        �>�C�����( ` ��J� � �@�<� ��� ��pq ��� D�|���@ ޡ  ȈK�� [�]� ��>e/�j����-|�r6Rb�MQ��e����"�����+��,/�k��~p5AE�م �V�.����A�\��3<u6@���o!�� �ă  �{�^��L/9_v���R� M*�C�3 ��eϊ� sĒ�R{���I;�XA�'!7�s]:�m�^�  9���b� ���&�My�� ݽ̽�geϪ��~        ���1�B)W�հQe�Z�Ζ���ܒu�l�v�sg�-�#�#�/��Wj���%���(T&��;���� �ܼ݉�q7�,f]        �J` �d5�E ЇÐ�E�Y ��i��� T5] �h��� �T�U��  �nKX ���.��!�( tr��U        �]  آ �e1p kd !   �"��� 
���  �yX)7�˦R�E���q�ʵ���ԛ �r�T� �d��+ W��C�r4'2� h� � 2�
�'D�F � �7�vj�L%< f� �t�s�7�~�o����Ζ ��v^���� e��� �/��>=��ߞ�:��oh�� ����s�X�����:� �S��zv b� �z��Q��I�fk%�-x Z�kpmpmt�������Ϳ�=�~έ�1�X�P�� ��Γ��8O{k�~t��%� z�%tڄ^�Ux�V��k��Ss�+���^K�5� �� �z���r9�:�Cg��}        a �� ƾ�˩�i�� I�  �Z��oG x ��=V�E.��]H�Qx���B���Β�,��] k��X�0+�e��B$ ���� ��Hv �%gA�� �ۛOϴ� ������ ё��f �e� ,�>�� �ʯV�G�c }�  I7���!l � d� qC� ��'        �:X` ����        �ե�ϳ/�V���.�):�}Qa%.�_X;�AOa]���&� c�T  � a摯7�C!��  �~
�oY �1��l�C3�g?�h�T��I�        k4�y7 �oL� ߇� �� F�r
ėfQ#�
 �rj �%z�q;��5�  pn����:;q�fuu�I+�Ҭ K ��G�M2 Yic!�g<�
 h]*� s��*�u���k��ی�L���M� �߯�����'n�܆�5�ꬽ�+�W���z�{ܣN�{���;u;�W� 3(J�FS0 md���a� ���F�^�5��o���  ]Ca 6� ��"D  �DeP{Ռ���<M Ǥ MoH 5Rs ��wN  �OO#   �QD�GЖ%�i���R�P1rwXgS��< . �>�T.Y K          V�: C�A  ��Ā��M6r�h%{�         D��EvZ%[ ���_ V��� {�s���z��?� ~���s�BB!�6�7���v�r���/o �vǮm���S?�� � &� �h9B� � �8"�5aM�Ƣ奠  9��t{����7J� �%��푪
<�ňŖ��f́(�q�IC6�\o6��s��j�ۑ�.�����g��4�  ��d�� P  DO xʬ�*�y$8A�rO��Ўԏ�M�Û =�8�8�` S�1Q�r
v/x���_�h�4�H&i� h. ����xȏ���3���� ���!`?}�}z�?%E���Q� U��
���GGq:��
`4�%Q�У `��NbC鰟�         '�����j��KV(ԺlW�U�
m�lV�8�T� ��~��MuU5�j9��_չ㥲r��d�AY� ��Ֆ   �� "�v��         �D\/7-��[ -�� �n�"���y�������ٗu/[���M��c�~ ⥵� vп��㿜�J���M�*O��a�J EJ^)(Ye�L�!\o��9 ��f�l
{&� ���O !�Mt���>D"|( @l �5�$�E�� � �*�&�{~�/�J�        E|z�@s�I�� I��Z�*��1���}%���]  Z�[�(9Y �P
;=C���`�9Lw  �';�;�<��� ���� �ۃ�V� �Uy���-�0��$��'Y�SM����d�V+�>�Rm���\�o��}b�ڙ ���w !k �[�?x�u�:��K ]������]�<�k*�p0 q���5���� b�V�����Gm��T�D ��ؽq�� ��� �«` D��]r/ �<��^��*5^ �E�}�/lQ@W�0�Q�! �` y8��3� ̌C��JH2O��E��        *�@��ĉ 3�8�` ^�g"���4�19�o�O� ��/�; ��fdk��T��N�������?�� � e�BP�  ���t�`( b�pN$7���!�9 Ay:���� � � �2 .�R� K�n�<� � O Kȇ�{L;�{ C� Ư��ߪ��v0v����c1�^õF���l��v V��U� ; �Oؽ�L~ j�FI e%  K�4��@��2 ̩�6� ��x�쎥����m�����.Ri �\�l[� J$����+dM =��� 8_�k+ ]��-�]��Ʈm�쬼���b���͇  ��� )uJ6 1R�Y��         ql*�7�>�%�X�il ;�x��         K–�WY�lU� K��ž^�޴ֳ]�Eݭ�5m�m�w{�xw� �.�]d �� Ώ�Ͽ5���M� �۱�� � h>�  ��r�\��2#� �[�;�U 3&��lFj^�U;<N�� NDs� �4�SzUv� 33ۼ�� �ũ��I#���eT�� ��꽂�� �H��^ }�끢�cU 8Izv J��z�        ` ϱ ��y�&��F���$| �u4�
^ y����X$찫U� � M>�%��|�g+K�\��\t8]�|�  X s8 �C� �!��ď� �!#c| Ǒ�T �V�Q�Tl�JT��X�3�?Ŭ�!� �]Iø��         ��q9g 4�k� $�Q 1��7�Hi��u�򫛥 ���!� � �O�����]�3 9I׫y� �
�`o�
�'urRC�c&���6�۔�r;$�y�� ��S')6���H�=�B %�^ q � �µW�=� ~�̓}���p)��/���#����*�ރ         ��,�q��
x�cy�2 b�v�r(�6�"A. ��\4�̜Z������ɩ�� �rʳ�򒤬�aZ�O�3
�Ln���A��(���~>&7 �?�g� ��^�tR !G�~UЫ�' >rR� �        zc� vCS���)�>�^�S+鹄�L�%��(�,..1�5�� B�� .� �D�p� �LN"���ڌ
f,��� ތ��P�t, {���D�P>�/VJ� ]��#��� ��s���� ]� �k>2dy�������qD '"�"'`G�>����#"�*" K�� g�̱�t.1�X�}x� �ә� �t �3���:��I' �̉���H�2' zr"�'' zr"��䉄��b�<����HM�g�G� �̫
gN$��֭�87g�l��i2E�9M1�y�l� IȚf�XY�}��� ��#        �� sl���nV���+��6�H� |e� � �y�� �s5 V���u� >;��[l�gBτͿ���W��2~A�՚� 7 ���V`J�p@#��t�\�v�f�V.jD-c*򢃌 ��� ��Uw��/\'��AS *���D ^�A���"� � pa� �&z� m1�d���        �4&)� M�$>� �=���"_C Q��0k� ]h �1$���>�X �ʫ�z�!� ɖ��`rO�pR�4) �        �2k J/D "4� �+7' ��� �_��9�br�Jd ����vȢ         �( `���١�R���� � \l!(���<' � � ǟi� $�9)�� ߗ�=Y�$tAs��� �'���n8 %6Mtb1� D�2…w�Eo� ��%4���@ ��P�J�nRk�r� � �SD�w �R��&��y Q� ,�%�¿C �� �w� DC  hU �op�� 4�$a��Cq� loNLJ9, �"  ��ҋ�
�P 4&4���I 3 ?�(� �,�A��c`% �� �  �,m��91Gv 4 ��#� ��cj�� i / �̍ ��˫s Z  n_�5C ������� ,��-��/7-u M6 ��� |��4�v�>{�� 7��i�p� W,�+�_��lUW���  gz��e� �Ǐ xLt� J� )��+� �QnN  � I ���!OO�� H?_ ݁� v��$7 塰W#��P.� �.S� u ��Nz�R v���D!SP( �   r�i��әD-.Њ�V�1�        �L�,X1Lw_���J!�6 �i�! �k��F �~ �PB-L� �C� D� ��3 b ϊU�p  �P4� ��b��  {���GpNVh.F%Gt$F]  ��& �DZdz'�'ƍY�8��/
 E�D��\ ��r��6�m���{-��? <b�^�Tk�T ��
!�ll���Y ��4-  [�]0  |�^P?�'�� _SXܸ��o�?�?�6� ��ݼ �, �=՛f�nH:B!�g�`_!O�.l  �������B��� �����E_#~ڔ���]�F # '�����4:���vL9�s��|+WQ���� �� �R����x R ��b�&�P��� Ň�NjU?�Nj�@A�"٨j�9�s��r�!t�u =�T g.��$��Q�P_8�F�
�`4�"�r: *���t�\J
r�T����  y ��l����  � ��l���d{ �
� E.�C��WL:4j J/ �r�
�%퉔�� Knn�VzJ��;� �îR��� � `�\���� �<�V��� ���@��y�y�9��z�J�� 
^#� �Z�P C�����         +s�
$" S 0 F�<�p  O1�M��o��)iD9?��D$i* !A�I�#�bF��}  �(=,,?+���#C��A;
'/~�j d=*�<�h���%� ���  0L�����   Bl ��o^�͑|&@J�L$)���w�I��|v]dv|�+��%� D�ii� �Y�_T]�|��cu���_ ��E� b�!�����n��fn�}�r��Hv�™ �9��� 
a��g���۸$+7��ț�ͳ��+`�
�bԄ_ ׅx��* �ZuM���G�����#�� ?�U��U%�r�"a�L         �\U�����^ye�A�}��j4bCp�O��� �P �T�� �ʤ�Ĭ��M�<��J�T^)�#�J  V�VG�� �ۓ&G�r��D��B�O,٥�h��        � !~c��,�g(ZxKBQ �64�c S �E5�Yh�

���V�D� /,r�( <�U�� +�X�� [B�/\�;-��%�%̒  O*yZ�c �� ~����p� �b�ؐ�&��� Gcd</��Ĝ�d���d�
�����؉  ��\&�q�c�S ��5�i�od�3�� W�i5���C���h���/I^\J��d ��dt�t4�xL�>�*a�!� 1���$�;�gJ t������H9L �� ��3��8H[qi �PH�P$ �J �9*$�"j Y�vR� f�� M � �O.��� �V�� -ýk.���  �t��ѫ�?9޾lak˂�ָ�c��|緮������1P��`Q�
�e�r�$�r�u���u ��Nq��C}���r��M� wNV |��FoI��e5N�� 6� �� Y/�Bo��k��2�aو�&�Qk� �dn�!��6Ɩ�0v��(��p� S�>ng�S�?�MJ*2��r�
>��a-;�O�n$�e��UӋ�,�d �ry  ?        �3�1�  � ҧڇ        O�� T ���:f%y{QI�z%�땢�\
�f�
�� j:���$ �  4}  b )j3�q��XNXWN��hG�>_        2�9   Io ,
9� - ���~�;<��˾t��ЂW ��@Dz����Pu�?hÏ�� }�ݮ;6�q_�� �}� �C�w   :�@4��N�[T�v��m �!G�J�Ļ��SX=a�E ���L�)V-��  '� ͇K� �@ "�Vt ,�+n2��~�O0��uXG�X�}�߄� FG T  o���H�O:�N���A? N � R�y�&M?@�t |�C �? �:��V�g� ol�y���c� =�g��@(��5Z�V�Uj9��f�1r�� ���3�� f�y��(#� ��QX �,�}3Α�ŧ�ތ ��f�  � ч ��b��R4���E�g�4�1Kӏ�e|$}�I� JO��G���_[�� �c�he񉱝?-��}�S��eQg�e1��w�ə{2޿oew{��m�����}��<�*�^t]�� <4�����K �� $���`� W���U ������+m �7پm����Y Ϫ�b,J�v�$�  ߋ�OS�� H�|��(�� �� "�I�-��RN1?;"�e. �L1� �e���MH�]G<�� � 5��r�\&���h�c�+n�`   �36O���I�  �)�O� � N�t rTU���}<ş K� �PR \R��� b��" �.�O��81�^ܽ��͡�����k��q��Ogg��R�$���Z�l�1����|G��]7���;�˯+)��_̾T�S�_�W޹c�$�  2��J"װ}} !� ;���2] � �h&O�|%>f��Qf) <N�p5ب.�� ]�=����K� �sĿ��c��u�F��� Ȇ�A �Wd�  Èz� ɔ
m���)V%�z}�a�p��� lp:�� �)�g 6����7KN�c�v�
 ����q " ����<��Â�� "!栭��;� �n �*��F ����� /���B9�{�'���        �S�Z4���!]Q $Kea� �N �&�dV�%�� ��Z�*���pxe���        �� �x �·?  �H� #�0�󿪝¿�D�\� �G .��q q�H ߙ#���� �� �!y���"�)0������� ���p�;���M!}8��o� �k3    4���m�nF> \PFiɣ�K���� �� ��/��c�>���� �!��Dw� >�ʞ@,�zɭ? ���ſ��
�a�Gʒ|_<��&ژ#�������<*�=y�� ��ʃ��o� � ���&C��Ɩ�Z�f !� � �P  'o��mB[. Z��)o        �[  �? ����Y�G � ~? ����N�6� �| ��ʒ�M�B��}��Z�m��N kۗ �[ �� iy-Ӫ��2ڋC��a ��b�@�C� z��L �J۷
���<�~ �<�� ,.�AO��K`� .~k0� �'�޸� b�] �l��d��'HQ kL+h��uם;�� ����i��ٻ t��g���+.g��^3P �j�l� "Љ;������:s��ꭷ\O4,��L   ����x � ��܁���AV-d3~� H��� �F  �s � ���Pho�PH ��GE^��0&#�aS z } O1�E����� w�F�  D�ȡ ����Ҟ�����3���*����� � r;��� ��^J�~+Ś~@i�O>� ��t� 5I�G�ՔǙ   l�8 Ύ�� }        ��l0�5��d$$�  �-׫��>D  ! B?� ��d��@�T�����FI=�u�˛?�v��G� �UA�~i �
�l Zǣ�����G��  �� gɞE<C~Q`-�� 2C:�)GQn U1 ��(GyP� ���r�
� �7B����rH-p� �F��f���G`�&�m�TD��x� ����Ľ��0f8=�~0> )��ٜ �G�Y�&B�? �} !� !���m B�1�l ����� !�i�ܰ Ͼ !�2���.��PN By�@(~        B�� Tp B�������Mr        B%W�� ���1/�
� ��o�%�Z��A�i�+< �faF�!��q�Y��� Z"0 �,
�h #�a �0�Ұ ���Ұ ŀ& �@;�_�a%���iX��b�ҰNϱ/d��u�_���`z#
3�3�9
�(��a �ŔJ�2�5{Ӱ ���4�@���iX� ��J�*Tc�(
� ��I�KE  c�]?H� �w �0���5��9��VP�PU�.L� 
�K)� ts��a�����J�׺���9 s�Fa�e ��?ӰD        ��/� �%X�� K��`�� ,�_�%�K�D        ��-�oPXM� �k ���d �@�)V��9T �����-�+
�|b{(�'� �/
s� �(�y�� �0��� 6  ƣi h ��i!�K�0��DC+�[�7�a %��X6��J &�oQ�I���i ��ȉ�:S  ���Q8��=
 �J�z)�
i����A���g�0�4�E
� ���0�'!�L���H�a�'QN`�<�+��_9o]�y����������6×o# v�䷲J jC�� �f4H k �FC�� J# �k'��Q�|�S
�� �UPG~Uk ��R �=��nzP7���� J��� 킚 �� �� �        z�
}�~ �w ��C] w�_��
m3� s�/@� ��J�(F��        =  � �v�8��.�-�� J�PK� �YS �u�Q:�6�-�  Z ��p��vRJ��F����J :� ��E�KJ[��]�v��� �nJ9 �3�h�9 ���v ���h� �у�Ø����*�g�� h�(� �
�q��:��1� �U�Q�B @�i  �H�e �n��\ P?����,��v�\K �@�>:��9:� ꡿ǖ�_)�-��y�J��� �F�y3j��9H<�  I�"�vʁm�W[�G��i�3r]Kqw � H ��-��KK y�`5�� �� ZI�Й�^�<���ci~5��vS  �,D� E�AS"%;` CT&$��B{ �Ҿ�J�@)��J�$1csZ�� �� ����ά��
��%Fi;@� �k��v�{�̸��=D�M~sh��#�6�yd����<�n!��ȧj�̭!6W>�I��� -wC B�XZ���ƍ͍�� �Qi�E��E��g�lWz�}� �S[������ ���T;�@ �k�g�.��J��v##�#Ts�(�����V� ���Z4O �J�����2�3Bm�n*?�@� j_;��J%��<K�$;9��J��`b���v��v眶I� L� ���J�m ͙3�g4�/M� �I� �K�9�z��
�BmS?]e��gKu�r����i9�����&�P?Hֹ "� ��O��F�| �j'� 
�  �{�t��>�Sr��{�Z��Q,3�� ��ozI!� }4e� ��y+�I|�HM �.�����t�+ϟ����        �Z�4gt�/��-IAOz��, �� �k I{e�� ��I�/�9#ǒ\
���4� �*y�9I�Dg��Oڳ� x1G�N�vB�����N�j ��=�#g<�@=ZZfr2s��E�� � �s�Ѩ�z����̧��/��ַ���`�u�}ºeh����4���ĺ3�: ��њ3�(�� ���t�-s�y B�ġQ�팇�f��Υ'�v��r�-�x�Hs|�jI�� 2z}�,��T���U��4g�� J�t��?�c� ��y M��y3�W2� �l ��y�c�_�c��w� d<�³�x'�8H-�g�F��/�e��'����h�M9��(�  �6����>��ptdn���r��o?� �?ߣ�O% �� P �ۂ꡴ ��*Z� u ��� �[ !���$� `�NߏPN��~� ��P '��
�+���ڸz$�2)- � � i[���1꠷� s � j� �K� 5P� � ^J��4�
h%� �>Q�i � s+<{V�t��̚��
�oH߭�� id�d�z
���g}z�ՔF�g�g
̨��H� �[ o5 ���Y��
��z�k�d-ut d���Z%<B���;�Gd~M�9��jJ� :�3��������� �Q � -k�JWS�եiFV�DKgV%q����P�Р �fHK�h��^������ٴ[G����W���PʵВč Zj��"wci^������$�Q�j���s RO�W�}F:�1Z��D ��v�\2R-�  �z��_�����B�^MiB�zn��s������R���Gh    �=�#� �
�t��
 � ���ª��z�F�U=�=#;{�� ���g�H�.�e�g���i��=�cL� <��K�  �=B� ���b!L�Ҙ����Wh� � �� �� { �� ݣd��޾Q�~?[ G�%}����:���3 �
��;F�z �2��s�G�1��3"��u4�        M}]= �=��ў �g����n�_� �{F�F��� � �=c�}���m}�{F� 0ʪ�� K ��3DY��{ �)�4�u� �9��  %���  P\@����㴣�O� +� �F:�{�w�l  ��s.�URZ׎t�� 8Ohٲ  $ą�c� �=���H �2&��� �u5u�t� �        ���Es3 Fw
�� 9�  ��   w �;w ;�0c� �Z   �Fz:�zbBw�� �%&t t C#}p� PHǝ��P�����1�n�nJ� ��� �j$ l!#�HN�47����� ]c1�  ���6� � �]�}]��f�  � ����M$13�����BN_���y��ÿ��$ ��#=�c#@7��� H� Q
���(c=�        sF�`���] ����gS�S" �$,g ��뎱!��� �L����?t6EA� v��        C�C�Oo��>�s�NG$d�`�  �4�c���Q������g���;66�0�� ��շ�o����3p� )% sSZSr��T,F��H7��ڟ��/�1� Ƌ��[ aM�4=;{�A])��V~Bʳ�_�k%� �Z �  �@��F:�2�1a� �2HOWo��y�fBc� p � ��A�  Q:����ٿ�
2�������N" ݃];� G:%+�� ��!=��Zau����Kg��  �I|�L<aW�X/��'n�����gn����Jc��F$  #P%"+�        � ������ dh ,h��*,t�y Q�QR�� Xa  >� & z �NS�3�*)< ))M��t �z ���5 5�12 �� t ���s���5� �3r ���G o�$❛ w��s#`����� % :#)�[������=gin缅���G�P�� �@y%E�W  ��P'�n�o[W��Nh\-��jY�X[W+D�WC9  �5�5��i  cU���
BK�P�b���qEmL�[ߺ�n�j�e������X u�+j���6�X*,�v+Z�[5�&B�m-  0�Uc�j�Ysݪ� (V/iljl�  � �V�>��j��zU[c͚��UB�U�-��`�Z�vE��U0J]s݊�|  ꄺ�P V7T75ѡ����W��մ�nXո��Mhhi����%u0��%Mu�P�������P[�\����j�^VQ����5��* � �մ5�� ˨iYѶ
�1X媶��� W�ń�U��        A�W�@���Т�v �V�I� R gq PHy��3s���n��V�������ytKB6;�w�6� ځuP���;���n�> _ª��}.v ���}�}�} � }^��p��}���� y��<����  ��x �� !�r~�P��͇B ��x0�Ń�/  }�`�����Cg? �P� D_< �� ��e ���A���NM$l   ;��F^������n���F���2�W��  �
} }� u��r6~��Q$�� ��#�i��B��N�j�6u'= ��6gc�R�:B��d�?�C��f>�>�gas^��[��p �2N� s˹���៴�wO��`.'���4v��m�`.�~g 8��+�����wl �|N�9��tt�� 9��� 
B) �?�?�W�Em��� e#/g���3�
�͓�l�0�i'��"�O��ES�f2G� �y΄�Bb� �U�6Ab� #�3M�_,NA6"e R�U�ڊ�� �2T�:ƙ&�"R=�� �%�RE�Ɖ��b��3�\ <#� �O� ��ͤ #h �����Z-��+�� ���A( �DHC� Cz � foD        H  � q�D��@� � �� ���,6T�9 ��t�<P��6<���~Kf�^
� ��D-��$߶�� ��{ :a'��L��h>�'rr��        WV�  �� ч *���M%K���2        �̋ �^�� z  �! ����/z�I(cv  0&��Ǔ� Fcg&
�"��g��Z!1h�}  �ĠA� �   �'�d ��Z_� �{H��  � � Ӳ ��7i����8a0�v�O $%`�w �V[�Wa>?b_@ �e � �g! �c�a�������I _� �� ���
[//{ { *��~� �h���K��z"'��Z���^DQF�a�����6Q�  g�&�Ⱦ3�Ґ��3�[��`�b�! `� ,��� ;� ��J�&U�� �Zv
�9 d�ү��I�"�� t �}�݋lp�8{)�B� {ل�{�q�� �C� �w H �&u��c�*�."!쟁����� � ��0{=*�� Q� �
�u%�]�� 6� �y X�.��] Z�NÝi�I���!� t ҝ s���        ��Q
 s��� �  %�ǁv j/�T���.�0�)�ED���`_B-� ���D#  g�B�r`��&
~1�� �.�x 
/ <x���^F)q)����� ��^N �&�Ƣ=��6( �u?� �ރ� Z ��
m�� z��Pdx��H 7N苽O�
�� J��        ���yi �  nO��        ��| R��' ޕ���A~Z�  �^���        �4\1Y����qv �Ŋ        o@��0;)P?���fRm$3����        ��VG�*��MZ�E^�Ӆt���[{l)�� XS
zRL�Q4ɛ@���"��"� � �qH � Ћ��E�$�1� `� P
  �]�އ ��-DU��Cz �IH2Z� ���  � �  1�c �<\EH ��B: � ��!)�q6 㐯~ �u/�qH��� `�l � #_�c 4�Dȋ�0�� � � �a��{�=�=� �R,        Ŋĭ�O.9p)�P
����x%� T �u ��b�C/&����4����f�Tz@~@� �ւ�{ �{�Xt �P�ċW��+_�|��=��z�{����^�������WqW  �q�gf���bc�q1��o�˱ c�����|w�#m/k���]�` y� ع3R�J��P �TM )8�ԠЄ�q �G���V� ��T8M �J�6�T�*������:���꟮y��y�y�wƻ���ٶ?�i        �iCG�.z�>C��U��� ��V�� k�h�kU\k�zp/T
 G��AM~]�?�� CA6 � ��Jp:X��*�i߬��7� ��&|�> ���{�        _՝d/{ �:        �B  ��PV��T��U{B� �GT; ݯ, z��  b� �q�        ��ɶ �F�!�賷�7 = a��Ċ�H"��"� # z'B�#� �F* VIn`3�� T9����� �{ qaA T{C�n�wC�n�'� �
B�(+ ݯ, z���
at�&��� q �Y�-�Fڡ{ �U�K {        :�NO=�0^�초��H@؃  V(����]�ZlP�BnA4"[ �#[w+�HK�)����Gn%��-*K9E.@ � }VY��=ʺ�8���.���F�'�ۥ,�㐏�W���9 ��=�ާ AF  ���_ �/�+b_=/��D� 0偐�\�4���>���7�>��7���ҵ������d� z��}�D�}G�?(�?�(��>��8�� ѿ ѯ�ߒ0 ���a�ݰ��~)�� �O�� a}KX,,CŰMԙ��l��TzEbYH�gH�MH�yH�IH%��C�� ���x���e�_P���Z��՛��W ֆn �d�U��v�k5Œ�@ k �J�
a' M�  , ���%�>ɓ X--a���"Z
H\(�cp =  s'�Z��y��[� �#�4 > N � � �/� � q �п � ���HL���#Qv X v ؗ���- �+�-���         ��sŒ ^ f �] ^ & �"�Հ3�9        ��pn N��A � ��8/��‚���  ��0"�v�aaw  ��u�> �-��%���:�T�� �) Ҟ�ȗIL�w�N �Qa�%�$�$u���H���} Mђ�� � ��Œ �����p,�: � �. ;����\�U��s�FP� d �<H\8� -�� ��H �d.k=���  S�� �?�A⨈5$JO_��B܏�e�E�?L� T��  ���!�G��]/ ����� �7�0 A�+�6�        �`$��O����ѧx9v�O�-���\g�_pT�7� &��X�Q��t �/� !Z�5| ��  t�|�%z���V(�����Gb;���L���3 �^Ld � ;{�n�$ �T �4��j YG��sq���3�7� 8z�  l�}ف��;��5�n�w�:�B�5�71 �<�X�����ȿ͟�;�!�J��ſ4P � ,
, �   _�*� $@�Ry§% %X�S�N����R�<k��� ���r�� [� -˲[Sn��-�� �묬 �ߞ+Q��<ͺ�'Hv(�~��(Ӛ-���F���Y�ݖj �e_+S�-W�w��M�3�        �  �I������HOcO}|��M� ��9�I�w p�e}���~+�5�ޜw;�q�9�uW�O�_f ��L�2; !��L���� �O���mT4 g @#� ��  �4�️FK�N��q����$         �fEz�#��O�N�^E��N(� /��:�0! ���T        �ꃊ�(i�h �����:� �� ʽe� ��ox�7��L鼿3�U #Q�!�b�X��k8�? �S�G �2�Ff�� C � G�6��C�P�� � �Ztp艽 w �G��{�H�Jݹ �s��m�K$�ٖ+� �iѝ�� �����c�F?���{�� {@�c2�:��o� �Q�Fe�Q��/ѧre R4۟+ HJ��p� k� 6��S
u#q��llm<�t���s$h�݅F��!�ՖlKJ  i�Z���9W�э�MW�9W �  )Rl��K�O W�8� k\(xk��9�VF�A(�*� L�R
�w�_$c�ey\R�zs%��4�K���Nɽ��/ �� Z AN�Zm� �f?�kx� �����VQ��iȬ��W�ß��b�ߢU���ٸV���YpoNߜ��Uڦ�f۴��
d�<E��?cVa�� �R�U��wM�0�?^��r ������P ��{íy��9�� ��0 �!� Ǭ���^ ��[� �0E3
endstream
endobj
20 0 obj
20796
endobj
19 0 obj
36788
endobj
xref
0 21
0000000000 65535 f
0000000478 00000 n
0000000604 00000 n
0000000816 00000 n
0000000872 00000 n
0000003551 00000 n
0000000017 00000 n
0000000152 00000 n
0000017404 00000 n
0000005023 00000 n
0000005444 00000 n
0000005650 00000 n
0000004466 00000 n
0000004829 00000 n
0000000454 00000 n
0000003526 00000 n
0000004442 00000 n
0000017378 00000 n
0000017352 00000 n
0000038317 00000 n
0000038291 00000 n
trailer
<</Size 21/Info 1 0 R/Root 2 0 R/ID [<E9006DEB18F5454ADA0F033C1E93616F><E9006DEB18F5454ADA0F033C1E93616F>]>>
startxref
38343
%%EOF
Example Curl request
$ curl 'https://gw.api.cloud.sphereon.com/pdf/1.1/conversion2pdf/jobs/e391cba2-732d-4129-bc43-cdfee63c0bc3/streams/result' -i -H 'Authorization: Bearer e5fb8bee-df99-379a-8a3e-98036b7a7676'

8. Security

8.1. oauth2schema

Type : oauth2
Flow : application
Token URL : https://gw.api.cloud.sphereon.com/token

Name Description

global

accessEverything

9. Definitions

9.1. CSVSettings

Specify CSV settings if one of the input files is a CSV

Name Description Schema

separatorCharacter
optional

Set the separator for the columns. Choose between a comma (,), semicolon(;) and tab( )

enum (COMMA, SEMICOLON, TAB)

standardColumnWidth
optional

Set the quality factor for the resulting PDF. Range from 1 (lowest) to 255 (highest)
Minimum value : 1
Maximum value : 255

number (double)

standardRowHeight
optional

Set the standard row Height. Range from 1 (lowest) to 409 (highest)
Minimum value : 1
Maximum value : 409

number (double)

9.2. Compression

Compression settings

Name Description Schema

level
optional

Compression level. Value from 0 (min) to 10 (max) allowed
Minimum value : 0
Maximum value : 10

integer (int32)

type
optional

Compression type. ADVANCED is only allowed and should be used with the ADVANCED engine

enum (NONE, ADVANCED)

9.3. ConversionJob

The PDF conversion job. Has access to the job settings.

Name Description Schema

jobId
required

The server generated job jobId. This jobId is checked against the jobId in the request path on overy invocation

string

settings
optional

The settings to use during the conversion job

ConversionSettings

9.4. ConversionJobResponse

The PDF job. Has access to the job settings as well as (ocr) engine tasks

Name Description Schema

completionTime
optional
read-only

The completion date/time of this job in ISO 8601 format

string (date-time)

conversionTasks
optional

< ConversionTask > array

creationTime
optional
read-only

The creation date/time of this job in ISO 8601 format

string (date-time)

input
required

The input(s)

InputResponse

job
required

The job

ConversionJob

jobId
required
read-only

The job id

string

queueTime
optional
read-only

The conversion queue date/time of this job in ISO 8601 format

string (date-time)

result
required

The result(s)

ResultResponse

status
required
read-only

The status of the job

enum (INIT, INPUTS_UPLOADED, PROCESSING, DONE, ERROR, DELETED)

statusMessage
optional
read-only

A status message, which can be informational, warning or error. AA message here does not indicate an error perse

string

updateTime
optional
read-only

The last update date/time of this job in ISO 8601 format

string (date-time)

9.5. ConversionSettings

Conversion settings

Name Description Schema

containerConversion
optional

Specify which container to process. Currently used for email (ALL=Both message and attachments, MAIN=Only message, SUB=attachments

enum (ALL, MAIN, SUB)

csv
optional

CSVSettings

engine
optional

Engine to use for conversion. Costs apply. Default engine : ADVANCED

enum (BASIC, ADVANCED, PREMIUM)

input
optional

The input file and lifecycle settings

InputSettings

jobLifecycle
optional

The lifecycle of the job itself

Lifecycle

ocrMode
optional

Specify if a file must be processed by OCR engine. Default ocrMode : AUTO (only when not already processed)

enum (ALWAYS, NEVER, AUTO)

qualityFactor
optional

Set the quality factor for the resulting PDF. Range from 0 (lowest) to 10 (highest)
Minimum value : 0
Maximum value : 10

integer (int32)

result
optional

The result file and lifecycle settings

ResultSettings

version
optional

The PDF version to use for conversion. Default value : PDF1_7

enum (PDF_1_4, PDF_1_5, PDF_1_6, PDF_1_7, PDF_A_1b)

9.6. ConversionTask

Name Description Schema

conversionInput
optional

Conversion input

ConversionTaskInput

documentId
optional
read-only

The document Id provided by a backend system

string

engine
optional
read-only

The Engine being used

enum (ADVANCED, PREMIUM, BASIC)

jobId
optional
read-only

The current job Id

string

queueId
optional
read-only

The queue Id provided by a backend system

string

status
optional
read-only

The status of the Conversion task itself

enum (REQUESTED, QUEUED, PROCESSING, DONE, ERROR)

9.7. ConversionTaskInput

Conversion Task Input

Name Description Schema

streamLocations
optional

Input Stream Locations

< StreamLocation > array

9.8. Error

An error

Name Schema

cause
optional

Error

code
required

string

level
required

enum (INFO, WARNING, FATAL)

message
required

string

9.9. ErrorResponse

The error response

Name Schema

errors
optional

< Error > array

9.10. FileContentRequest

Filecontent request

Name Description Schema

content
required

The file as base64 encoded string

string (byte)

contentType
required

Content type

string

originalFileName
required

Original filename

string

9.11. InputResponse

Input response

Name Description Schema

streamLocations
optional

Input Stream Locations

< StreamLocation > array

9.12. InputSettings

Input settings. Specify, if applicable, external location of the inputfile(s)

Name Description Schema

lifecycle
optional

The lifecycle of input files

Lifecycle

storageLocation
optional

Input Storage location. This where input files will be stored when addInput is called

StorageLocation

9.13. Lifecycle

Lifecycle settings. When no lifecycle settings are supplied, the job and files will be deleted directly after retrieval of the file

Name Description Schema

action
optional

enum (DELETE, NONE)

applicableJobStatusses
optional

Job status needs to be in this list in order for the action to be performed!

< enum (INIT, INPUTS_UPLOADED, PROCESSING, DONE, ERROR, DELETED) > array

type
optional

enum (RETRIEVAL)

9.14. ResultResponse

Result response

Name Description Schema

streamLocations
optional

Result Stream Locations

< StreamLocation > array

9.15. ResultSettings

Result settings

Name Description Schema

compression
optional

Compression

fileFormat
required

Resulting file format. Restrictions apply. Default : PDF

enum (PDF, XLSX, DOCX)

lifecycle
optional

Lifecycle

storageLocation
optional

Result Storage location

StorageLocation

9.16. StorageLocation

Storage Location

Name Schema

containerId
optional

string

folderPath
optional

string

id
optional
read-only

string

9.17. StreamLocation

Location record of data stream

Name Schema

containerId
optional

string

filename
optional

string

folderPath
optional

string

id
optional
read-only

string

name
optional

string

originalFilename
optional

string