- Tullin ohjeet
- en
- Fintaric
- TARIC Data Export for Traders
- Interface description
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 |