TronAPI - settings and basic information

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?
• TronAPI Setup
• Purchase Order

How to obtain access to your TronAPI?

TronAPI Setup

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.

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.

Purchase Order

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:

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:



TIP

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.



TIP

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).