¶ General
To upoload your data you need an Okta authentication token. This token is 24 hours valid.
With a valid authorization token you can request a presign upload url. With this url you can upload your data packages to TecCom Business Cloud.
Only zipped data packages are allowed.
¶ Import Api Description
Import API description describes the import API for TecCom Business Cloud
¶ Upload process
The following steps describes the upload process.
¶ Request authentication token
To be able to upload your data you have to request a token with a POST request to
https://login.tecalliance.net/oauth2/default/v1/token
Required Parameters
- grant_type=client_credentials
- scope=paapi
Authorization
BasicAuthentication - Username = YourClientId, Password = YourClientSecret.
¶ Get presigned Upload Url
Request a presigned upload url
Post request to
api.tbc.tecalliance.net/v1/suppliers/imports
Authorization - Bearer Token
Body - ImportRequestModel
The definition for ImportRequestModel can be found in in Import API description
The import modes are
- MODIFY
Updates existing data and adds new data from import depending on import files. In some specific cases existing data will be deleted, e.g. for prices - REPLACE
Deletes existing data and adds new data from import - REPLACE_LIST
Deletes existing data depending on article number and brand and adds new data from import. Import zip-archives must include replace_list.csv.
More details about update and delete process with different modes can be found in TecCom Business Cloud Import Specification
The upload url will be valid for 15 minutes and for exactly 1 upload. It is not possible to use the upload url after 15 minutes or to use it for multiple uploads. A new upload url can be requested every time.
¶ Upload your data
With a PUT request with the returned upload url you can upload your zipped data.
¶ Example Postman collection
The Postman collection includes an example for this upload process.
Download TecCom Business Cloud Postman Collection
To use this you need to create an environment with these variables:
| Variable | Type | Description |
|---|---|---|
| clientId | secret | Client ID for your client from TecCom Portal |
| clientSecret | secret | Client Secret for your client from TecCom Portal |
| tecId | default | TecCom ID for your organization |
| importMode | default | Import mode for TecCom Business Cloud |
| tomUser | secret | TecOpenMessaging web service user for your organization (optional for Classic Supply Cloud if you want to download orders) |
| tomPassword | secret | TecOpenMessaging web service password for your organization (optional for Classic Supply Cloud if you want to download orders) |
| tomLanguage | default | TecOpenMessaging web service language (optional for Classic Supply Cloud if you want to download orders) |