SHOPEE

INTEGRATION DOCUMENT




About Shopee


Shopee is a Singaporean e-commerce platform headquartered under Sea Group, which is a global consumer internet company founded in 2015 by Forrest Li. Shopee first launched in Singapore in 2015, and since expanded its reach to Malaysia, Thailand, Taiwan, Indonesia, Vietnam, the Philippines, and Brazil. It serves users in Southeast Asia and Taiwan to buy and sell products online. Due to the mobile and social element built within the concept, Shopee was described as one of the "5 disruptive e-commerce startups we saw in 2015" by Tech in Asia.

Shopee is a Pure B2C Marketplace and has only business mode available i.e. Dropshipping which includes Ship by Shopee and Self Shipping. 


In Shopee Integration, we support Inventory management, Order Fulfillment, and return management. For this, we have:

1. SKU Pull 

2. Order Pull and Create 

3. Order Pack i.e. Invoice/Ship Label document generation. 

4. Order Shipment 

5. Inventory Push (both single and multi-location) 

6. Inventory Reconciliation 

7. Order Return Pull


Prerequisites

Below mentioned key/IDs are required to configure the Shopee channel for any client. 

  • Shop Id
  • Partner Key
  • Partner Id 

 

Below are the details of Partner Key and Partner Id  

  • Partner ID:   841366 
  • Partner Key: 2f316ac9e613bf4dc247444430b3c254ad3aa79d905840130d063120c6f543c7


Process to Register Shopee on Vinculum Partner’s ID & How to obtain Shop ID?


1. Click on the link below to register shop on Vinculum’s Developer id: https://partner.shopeemobile.com/api/v1/shop/auth_partner?id=841366&token=8356a7ab1c862ca1d776e768d23f97c2efc68620c36fe5fb9ef7f575a2607d0c&redirect=https://www.vinculumgroup.com

 

2. Select Geography from the dropdown and input seller login credentials (make sure that the seller portal login credentials are correct).


3. Click on Confirm Authorization Button as mentioned below.



4. Once you click on confirm authorization button, it will take you to the Vinculum group official website and the URL have the Shop Id available (refer to screenshot below):

 

a. Copy from the URL: Copy numeric value after = sign; OR


 


b. you can also refer to the Shoppe Seller Panel to fetch the Shop Id



c. Shop Profile > PC Shop view > Copy Shop ID from URL

 


Configuring SHOPEE


Below is all about how to configure Shopee in Vin e-Retail for Inventory Management, Order Fulfilment, and Return

Management.

 

1. Once all the IDs are ready, login to Vin ERP instance and go to “Manage Channels” under Sales Section.


 

2. Go to the top right-hand side of the window and click on “Add New.”


 

3. Pick the channel from the list as per the location.  Two channels are listed 1st covering Malaysia, Singapore, Philippines, and 2nd listing Thailand, Vietnam, Indonesia basis on time zones.


 

4. Fill in all the details like Channel Name, order Source WH, Order Sync from date, Return Sync from Date, Inventory Sync Method, Enable Inventory Reconciliation, etc.


 

5. Click on Configure Interface.


6. Enter the mandatory details:

  • Shop Id (Mandatory): Store Id of that Shop (Process to view Shop Id is mentioned above)
  • Partner Id (Mandatory): App Id of Developer, already shared above. 
  • Partner Key (Mandatory): API key of the developer, already shared above. 
  • Is Label PDF: Shopee provides Shipping labels in both formats i.e. HTML and PDF. For PDF Label, we set the shipping label directly in Vin e-Retail by fetching it from Shopee. 

However, for the HTML label, we first convert the label into PDF and then set it in Vin e-Retail Pack Label.  

(PDF Field value in channel config can be identified by generating 1 Shipping label from Shopee. If the label type is “PDF” then set the PDF Label as YES else, NO).

  • Is Ship by Seller: Enable this Flag if the Client is working on Self Ship Model (90% of sellers operate in Ship by Marketplace Mode and hence this flag is always set as NO). Enable this flag if the client explicitly requested to configure Shopee in Self Ship mode.
  • Skip Sunday PickUp: Like Amazon, Shopee also has the provision to provide pick-up slots and choose the slot on which the client wants to arrange the Pickup. Using this Flag will ignore the pick-up slots on Sundays. 

CHANNEL MAINTENANCE

 

Channel Maintenance setup helps the seller reduce manual intervention and avoid the multiple usages of the marketplace seller portal. With the selection of below options at the Channel Maintenance window (Sales > Manage Channels > Add New > Select Channel) in Vin E-retails instance, the user can get the advantage of using multiple features of Vin E-retail:

 

S.No

Feature(s)

Where to Click

Dropbox/Checkbox option

Details

1.

SKU Pull

Channel Maintenance>

Channel SKU > SKU Sync > Pull/Push

 

 

 

 

 

SKU Sync: SKU Sync between Channel and e-Retail can be done via PULL & PUSH.


Users can choose to Pull the SKU’s from the channel to the e-Retail panel.


And User can choose Push to send the SKU data or changes from e-Retail to the channel.

2.

Order Pull/Order Pack/Invoice/Order Shipment/Shipping label generation

Channel Maintenance > Orders > Order Sync > Yes/No

 

 

Order Pull: The user can choose to sync the order from the channel to e-Retail by managing this option. If this is disabled, the Order pull will not happen also the shipping label/Invoice and manifest will not get generated.

 


3.

Ready to Ship Status at

 

Channel Maintenance > Orders > Ready to Ship At

 

 

 

 

Users can choose to mark the status of ready to ship at any of the two events:

-at Manifest or

-at Pack

4.

Use Market Place Shipping Label

Channel Maintenance > Orders > Use Marketplace Shipping Label checkbox

  

Users can check this option to notify the Shipping label by the marketplace and then opt from the Shipment label dropbox.

5.

Inventory update

Channel Maintenance > Inventory Sync

 

 

Automatically pull and update the inventory

6.

Inventory Reconciliation

Channel Maintenance > Enable Inventory Recon

 

Despite Inventory Sync, at times, there is a possibility of Inventory mismatch. By clicking Inventory Recon as “Yes,” it enables Vin E-retail to reconcile the inventory. (* It is only scheduled for once/day)



Channel Mappings


For Normal SKUs on Shopee: The Parent SKU code of Shopee should be mapped in ChannelSKUcode of Vin e-Retail, Product Id needs to be mapped in ChannelProductId.  

 

For Style-Variant SKUs on Shopee: The Variant SKU code of Shopee should be mapped in ChannelSKUcode of Vin e-Retail, Product Id~VariantId (Product Id and Variant Id should be separated by ~) needs to be mapped in ChannelProductId.  

 

 

Common Issues and solution 

 

1. Error: ‘Pickup time Id not available.’ This error occurred at the time of the order pack because the seller/client has processed the orders from the seller panel directly, or the order is packed after SLA Breach. Shopee does not provide the Shipping Labels after the SLA breach. 

 

2. Error: KINDLY WAIT FOR THE ORDER [ORDERNO] TO GET AWB NO TO PRINT THE INVOICE. This error comes at the time of Order pack If and only If in the Channel configuration “is PDF” Field Value is not set correctly. Shopee provides Shipping labels in both formats i.e. HTML and PDF. For PDF Label, we set the shipping label directly in Vin-eRetail by fetching it from Shopee. However, for the HTML label, we first convert the label into PDF and then set it in Vin-eRetail Pack Label.  (Is PDF Field value in channel config can be identified by generating 1 Shipping label from Shopee. If the label type is PDF then set is PDF Label as YES else NO). 

 

3. Inventory Not Updated with API Error: - {"msg": "this item is not allowed to edit", "request_id": "9a7ca33d8a5b43f30b1ec89aa8794f39", "error": "error banned"}. This error is coming in inventory Push because the inventory update is not allowed for that product by Shopee. Clients must get in touch with Shopee SPOC to fix the same.