¶ Getting started - Supplier
TecCom Business Cloud enables you to reach all TecCom network partners and carry out multiple businesses effortlessly.
A single upload of data on the cloud opens new opportunities like Classic Supply Cloud, Cloud CMD and Webshop integrations.
¶ Getting connected
To be able to upload data to TecCom Business Cloud you have to create a client id with secret.
For this login to TecCom Portal with an administration user. Choose your organization which you want to connect and select in the menu Administration > TecCom Business Cloud.
¶ Create a client and get the secret
When you are an admin for your selected organization and the organization is not already assigned to a client, you we will see this page with a button to create a client.
For creating a client click on the Create client button.
Please Note: If one of your assigned organization is already assigned to a client you can't create a new client.
After the request was successful, you will see the client id and your user will be assigned to this client as an administrator.
¶ Client secret
Clicking on Show client secret button you can retrieve the secret for your future sending data requests. Also with clicking on Rotate secret button you can refresh the secret for security reason.
¶ Add organization
Now you can add all to you assigned supplier organizations to this client. After adding organizations you are allowed to send data with this client.
Click on the + Add TecCom Id button on the Organization tab. A window will be opened where you can select your supplier organization for which you have organization admin rights.
Select your orgnization, enable or disable the organization for sending data and also add email addresses for getting notifications for failed imports with clicking on the + Add email button.
You also can enable Activate dynamic stock decrease for Classic Supply Cloud Settings.
You can find more information about this topic on page Classic Supply Cloud
After clicking on the Ok button the organization will be added to your client and you will go back to the overview where you can see you added organization..
This setting can be changed when clicking on the edit button (pencil) in the organization list.
Here you can also delete the relation from your client by clicking on the delete button.
¶ Add client administrators
You can also add more administrators to this client. This client administrator can also retrieve the secret or rotate the secret, add, edit or remove organizations (with organization admin rights) or add more client administrators.
Choose Administrators tab and click on + Add user button. A window will be opened where you can add the user email address.
Add the email address in the search user by email field and click on the Search button. The email will now be verified. If the user is found you will see the first and last name, otherwise you get a user not found message.
To add the user click the ok button, the window will be closed and the added user appears in the list of administrators.
At least one administrator must be assigned to a client.
If you are the last administrator for a client, you have to add another administrator to this client before you can remove your user from this relation.
¶ Import specification
The import specification describes which files and data can be imported for the upload process. The complete description can be found on page Import specification - Supplier
¶ Upload process
The following steps has to be followed to upload data packages.
¶ Request authentication token
To be able to upload your data you have to request a token with a POST request to
Login Authentication with BasicAuthentication - Username = YourClientId, Password = YourClientSecret.
¶ Get Upload Url
Reuest a Upload Url with Authorization - Bearer Token.
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 every time.
¶ Upload your data
With a PUT request with the upload url you can upload your zipped data.
¶ API description
More information about the api can be found in API description
¶ Example Postman collection
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) |