TronAPI is an online ecommerce service for promotional industry that connects PromoTron platform (TronShop) with your product suppliers.
With TronAPI feature you will be able to process your customer orders and create purchase orders that will be sent directly to the supplier via API service with only a few clicks. This service is currently available only for specific suppliers although more suppliers will be implemented in future.
On This Page
How to obtain access to your TronAPI?
If you are interested in TronAPI, please contact our sales department. Email to email@example.com or call +420 295 562 060.
You will receive the API key and list of supported suppliers.
First, to use TronAPI and Purchase order, you have to setup TronAPI integration into your TronShop Administration Portal.
1. Go to TronAPI Integration settings, enable TronAPI by toggle switch, type API key and click save
2. Below you will see a list of suppliers implemented for TronAPI function. Clicking on the edit "pencil" button you can setup and edit credentials for supplier’s APIs.
PLEASE TAKE ATTENTION
Please check which "ENVIRONMENT" is assigned for the supplier’s API integration!
1. “TESTING” environment - will help you to setup the whole TronAPI process and create testing orders.
2. “PRODUCTION” environment - with this setup you will move into live production and all purchase orders will be processed by the supplier!
NOTE: Contact our tech support in order to switch the environment.
Take extra caution when you are moving into the "production" environment! In this environment, all purchase orders will be sent to the supplier for processing!
TronAPI is connected to a real production supplier’s API and by sending a purchase order in the "production" environment to the supplier will make a binding order which will be processed by the supplier!
You have to obtain credentials (token, password, login, …) to supplier’s APIs yourself. The set of credentials can be different for each supplier’s API (e.g.: to use API of PF Concept International B.V. you have to obtain a token, login and password but for Makito Importaciones S.L. you need only a token – see in the next section)
SUPPLIERS CREDENTIALS CONFIGURATION
In the table below you can find credential fields and values for each supplier’s API.
When the field in the column "Value" is marked with "--" symbol signs the value has to be empty.
For sending a direct order to suppliers API, you need to create a purchase order. A purchase order is created based on the specific customer’s order that has been submitted by your customer to your TronShop admin.
When you are creating a purchase order you have the ability to select what products do you actually want to add to the purchase order for the processing. At the same time, you can also amend the item quantities that will be processed - however, this option does not apply to products with "printing/branding service"!
The amended quantity has to be "equal or less" than the quantity in the original (customer’s order) from which is being this purchase order created. It cannot exceed the original count in the customer's order.
CREATING PURCHASE ORDER
1. First, you have to choose one of the customer’s orders that you want to send to the supplier’s API (the actual purchase order will be created based on the original customer's order and will be sent to the supplier via API service). Then, go to the order detail and click on the “SEND TO SUPPLIER” button.
2. Now, you can see the “Send to supplier” popup where you can choose to what supplier you want to send this order. In the popup window, you will be able to see only such suppliers whose products were listed in the original customer order and whose are integrated into TronAPI service:
There are 4 important parts that need to be understood when creating a purchase order with multiple items and suppliers:
a) Each supplier has different rules for processing purchase orders. Such rules are identified by TronAPI and based on this check you will subsequently receive information/error messages indicating issues in the purchase order.
b) If the order (the original customer’s order) contains multiple products from multiple suppliers, separate purchase orders need to be created for each supplier individually. So, if there are products from two suppliers (e.g., PF Concept and Makito) and you want to order these items via TronAPI you will need to create a separate purchase order for PF Concept and a separate purchase order for Makito.
c) If the order (the original customer’s order) contains multiple products from one supplier (that supports TronAPI) and the list of products is a mix of plain items and items with printing/branding services - you have to create two separate purchase orders - one purchase order for plain items and the second purchase order for items that include the printing/branding service (suppliers are not able to process purchase orders that contain a mix of plain products and products with printing, therefore it is necessary to separate them.
d) If the order (the original customer’s order) contains multiple products from one supplier (that supports TronAPI) but the supplier does not allow to combine a different order group categories. In such case it is necessary to create one or more separate purchase orders for each order group:
a) Say you have an order "123XXXXX" from your customer that contains: 1 item from Makito, 1 Item from PF Concept and 1 item from another supplier: You need to create 1 purchase order for Makito separately, 1 purchase order for PF Concept separately - and finally for the last item that does not support TronAPI service you need to process it manually.
b) Say you have an order "123XXXXX" from your customer that contains: 2 items from Makito - but 1 item is a plain item and 1 item does include printing/branding service. You will need to create 2 separate purchase orders - 1 purchase order for the plain item and 1 purchase order for the item with branding.
c) Say you have an order "123XXXXX" from your customer that contains: 2 items from PF Concept - but 1 item is from the group category "writing instruments" and 1 items from a group category "textile". Some suppliers does not allow to combine different group categories - therefore you have to create 2 individual purchase orders.
PLEASE TAKE ATTENTION
You can send only the same or the smaller number of products which were in the original order. If you have already sent all products via TronAPI and purchase order to the supplier(s) you can see this popup:
3. Fill in contact information, delivery address and select products with their prices. Then check the "checkbox" at the bottom to confirm selected items and amounts:
In the figure below you can see the example of two products - one with printing - the quantity of the products is NOT possible to Change. The second one - a product without printing/branding service - it is possible to change the quantity for the purchase order.
If there are any products with printings (the customer made a calculation) in the order you have to fill in the printing parameters in the "Print Data" Popup.
Click on “EDIT” to open the popup.
It is important to understand that every supplier needs different printing data information to be processed and sent to their API. That means for each supplier the "popup" window can look a bit different (there can be for example different text fields and values to fill in).
4. In the next step thoroughly review your purchase order details! After the check, you can send this purchase order to the supplier or cancel it.
After sending an order to the supplier you will receive a response from the supplier’s API.
If sending was successful and all data in the order was correct you will see a success message with the supplier’s order code:
As mentioned in the step 2. sometimes supplier’s API can split one order into two or more purchase orders. For example, one order for items with printings and another one for items without printings. This depends on supplier’s API.
If the order was split into two or more orders you will see two or more supplier order codes in the response (Sending was successful popup).
PLEASE TAKE ATTENTION
After sending an order to supplier API it is HIGHLY RECOMMENDED to check what data has the supplier received in the created purchase order (For example check the purchase order in the supplier’s portal, if exists).
It’s important to double-check whether the data received by the supplier is the same as the data that you can see in the PromoTron Admin Portal – such as the count of products, Prices, Printing data etc!
Make sure that your personnel is properly trained and understands the functionality of TronAPI service. Unqualified interference can end up with unwanted deliveries and large quantities of products. Such a mistake could cause significant costs! If in doubt please contact our Tech Support team.
PromoTron Solutions S.A. hereby disclaims any responsibility for inaccuracies or errors in purchase orders generated using the TronAPI service. It is entirely your responsibility to carefully review each purchase order, confirming its alignment with your customer's input and ensuring its accuracy as the definitive purchase order for processing and delivery.