TronAPI is online ecommerce service for promotional industry which connects PromoTron platform (TronShop) with Products Suppliers. TronAPI adds ability to create purchase order from customer order and send it to suppliers API.
TronAPI Setup
First, to use TronAPI and Purchase order, you have setup TronAPI integration in TronShop Administration Portal.
1. Go to TronAPI Integration settings, enable TronAPI by toggle switch, type API key and click save
2. Now you should see a list of suppliers whose products you have in the shop. Here you can setup and edit credentials for supplier’s APIs.
PLEASE TAKE ATTENTION
Please check also which environment is set to the supplier’s API integration – If you want to make just testing orders the environment should be “Testing” or “Development”If the environment is “Production”, TronAPI is connected to real production supplier’s API and by sending purchase order to the supplier you will make a binding order which will be processed by supplier! You have to obtain credentials (token, password, login, …) to supplier’s APIs yourself. 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 token, login and password but for Makito Importaciones S.L. you need only 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.
TIP
Value of fields in the table above where is “--” in value column has to be empty.
Purchase Order
For sending order to suppliers API, you need to create purchase order. Purchase order is made from specific customer’s order and when you are creating purchase order you are able to select what products do you want to add to the purchase order and you can also change quantity what you will order. Quantity has to be equal or less than the quantity in the original (customer’s order) from which is being this purchase order created.
CREATING PURCHASE ORDER
1. First, you have to choose one of the customer’s orders what you want to send to the supplier’s API (From what do you want to create purchase order). Then, go to the order detail and click on “SEND TO SUPPLIER” button.
2. Now, you can see “Send to supplier” popup where you can choose to what supplier do you want to send this order. Note, that order (original customer’s) order can have multiple products from multiple suppliers but purchase order can obtain products only from one supplier. In the popup you will see as many suppliers as many suppliers the products in the order comes from. So, if there are products from two suppliers e.g., PF Concept and Makito and you want to order these items via TronAPI and purchase order from both suppliers you have to create orders, one for each supplier/
PLEASE TAKE ATTENTION
You can send only the same or the smaller number of products which was 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 in the bottom to confirm selected items and amounts
If there are any products with printings (customer made a calculation) in the order you have to fill in printing parameters in the Print Data Popup. Click to “EDIT” to open the popup.
TIP
Every supplier wants different printing data to be sent to his API. So, for every supplier the popup can look differently (There can be different fields to fill in).
4. In the next step you can review your purchase order. After review you can send this purchase order to the supplier or cancel it.
After sending an order to supplier you will receive a response from supplier’s API. If sending was successful and all data in the order was correct you will see success message with supplier’s order code. Sometimes supplier’s API can split one order to 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 suppliers API it’s VERY RECOMMENDED to check what data has supplier received (Check it for example in supplier’s portal, if exists). It’s important to check whether data received by supplier is same as data which you can see in PromoTron Admin Portal – Count of products, Prices, Printing data …
PLEASE TAKE ATTENTION
PromoTron Solutions S.A. is not responsible for wrong data in supplier’s system!
Comments
0 comments
Please sign in to leave a comment.