Interface description

Service version

Method GetVersion returns string containing current verion of TARIC Traders Export service.

Information about last full export

Method GetLastFullExport returns information about the last full export created. Returns null if no full export was created.

Output

Name

Type

Format

Description

VersionNumber

string

4 digits year and update order number within the year separated by dot

Version identification number

PackagesCount

Int

 

Number of the packages the export zip file consists of

ExportDate

datetime

 

Date when the export was created

Information about following updates

Method GetUpdateList returns collection of update information about all updates created after given update version excluding all full exports. If no new update was made, empty collection is returned.

Input parameters

Name

Type

Format

Description

VersionNumber

string

4 digits year and update order number within the year separated by dot

Version identification number

Digits year and update order number within the year separated by dot

Version identification number

Output

List of Update objects

Name

Type

Format

Description

VersionNumber

string

4 digits year and update order number within the year separated by dot

Version identification number

PackagesCount

Int

 

Number of the packages the export zip file consists of

ExportDate

datetime

 

Date when the export was created

List of possible errors

Error

Incorrect export version format

Retrieving export data

Export data are stored as XML files compressed in zip file. These files, mainly full exports, can have a few megabytes in size, so the service has set limit and splits these zip files into smaller parts – packages. Number of the packages is returned in Update object. Method GetData returns byte array with data from the requested update version and package number. To create whole zip file with export data, all data parts are required to be downloaded and merged.

Input parameters

Name

Type

Format

Description

VersionNumber

string

4 digits year and update order number within the year separated by dot

Version identification number

PackageNumber

int

Number > 0

Number of the package to retrieve

Output

Byte array containing data

List of possible errors

Error

Incorrect export version format