Who Is This For?
StoreHub merchants in Malaysia who use Bukku accounting software and want their StoreHub sales to go into Bukku without typing them in.
Overview
To connect StoreHub to Bukku, ask StoreHub Care (our support team) for API credentials, then enter them in Bukku. API credentials are a special username and password that let Bukku read your StoreHub sales. Care's email may call them an 'API key'. They are not your BackOffice login.
Bukku then collects your StoreHub orders once a day, at midnight. It turns each day's sales into one summary, which becomes one invoice in Bukku.
Bukku built and manages this connection, so setup is done directly within Bukku. No configuration is required on StoreHub BackOffice. For more about Bukku's own screens, see Bukku's guide Connecting StoreHub to Bukku & Configuring Stream Settings.
Before You Begin
You have a Bukku account.
You can use your StoreHub account's main email address. This is the email used to create your StoreHub account. Care accepts credential requests only from it, and emails the credentials to it.
Your tax codes and payment options are set up in BackOffice, because you will type their names into Bukku. See How to Manage Your Tax Codes and How to Manage Your Payment Options.
Step-by-Step Guide
Ask StoreHub Care for Your API Credentials
1. Email [email protected] from your StoreHub account's main email address, or contact StoreHub Care by live chat in your StoreHub app or BackOffice. Say that you want API credentials to connect Bukku.
Note:
To keep your account safe, Care only accepts this request from your account's main email address, or from a live chat where you are logged in with it.
2. Wait for Care's email. It comes from [email protected] once your request is approved. If you do not see it, check your spam or junk folder.
3. Keep Care's credentials email open. You need the API username and password in it for 'Connect StoreHub in Bukku'. The email may call them an 'API key'. They are not the email and password you use to log in to BackOffice.
Connect StoreHub in Bukku
Bukku updates its own screens, so follow Bukku's guide for the latest steps: Connecting StoreHub to Bukku & Configuring Stream Settings.
When Bukku asks for your StoreHub details, enter the API username and password from StoreHub Care's credentials email. Do not use your BackOffice login.
Note:
For help with Bukku's screens or settings, contact Bukku support.
Match Your Stores, Tax Codes and Payment Options in Bukku
In Bukku, you match each StoreHub store, tax code and payment option to one in Bukku. This is called mapping. Follow Bukku's guide for the latest steps: Configuring Stream Mappings for StoreHub.
Bukku needs your tax code and payment option names typed exactly as they appear in BackOffice, or it will not recognise them. Open BackOffice in a new tab and find your names on these pages:
1. Your store names, which you match to locations in Bukku: go to 'Settings', then 'Stores', and look at the 'Store Name' column.
2. Your tax code names: go to 'Settings', then 'Tax Codes', and copy the names in the 'Tax Code Name' column.
3. Your payment option names: go to 'Settings', then 'Payment Options', and copy the names in the 'Payment Option Name' column.
Note:
If you add a new tax code or payment option in BackOffice later, add it to your Bukku mappings too, using exactly the same name
Check Your Sales in Bukku
Bukku shows your StoreHub sales as one summary for each day, which becomes one invoice. To find, check and post these daily summaries, follow Bukku's guide: Syncing StoreHub Orders to Bukku and Managing Sales Digests.
Troubleshooting
The table below covers common problems when connecting StoreHub to Bukku.
Problem | Solution |
Bukku says my username or password is wrong | Use the API username and password from StoreHub Care's credentials email (it may call them an 'API key'), not your BackOffice login. Copy them exactly, with no extra spaces. If they still do not work, contact StoreHub Care to check your credentials. |
I did not get the credentials email | Check your spam or junk folder for an email from [email protected]. Make sure you asked from your StoreHub account's main email address. If it still has not arrived, contact StoreHub Care. |
I cannot find Bukku in my BackOffice | Bukku is not in BackOffice. You connect from inside Bukku, using API credentials from StoreHub Care. Email [email protected] from your account's main email address to ask for them. |
My new payment method does not show in Bukku's mapping | Bukku does not list your StoreHub payment options for you. In 'Payment Method Mappings', type the new name exactly as it appears in BackOffice under 'Settings', then 'Payment Options'. Then choose the Bukku account the money goes into. |
Some days are missing in Bukku | Check 'Auto Sync' and 'Start Sync Date' in Bukku. If days are still missing, contact Bukku support, because Bukku built and runs this connection. |
My totals in Bukku do not match my StoreHub reports | Check that every tax code and payment option name in Bukku matches BackOffice exactly. If the totals are still wrong, contact Bukku support. |
FAQs
1. Does StoreHub work with Bukku?
Yes. Bukku connects to StoreHub and collects your StoreHub orders once a day. Bukku built and runs this connection, and it is available in Malaysia. You set it up inside Bukku, using API credentials from StoreHub Care.
2. What username and password do I enter in Bukku?
Enter the API username and password that StoreHub Care emails you. Care's email may call them an 'API key'. To get them, email [email protected] from your StoreHub account's main email address, or contact Care by live chat.
3. Why does Bukku show my whole day's sales as one invoice? Can I get one invoice per receipt for e-Invoice?
Bukku adds up each day's orders into one daily summary, then turns it into one invoice. 'Sales Grouping' in Bukku changes the lines on that invoice, not the number of invoices. You can still see every order in Bukku's daily summary (see Check Your Sales in Bukku). For one invoice per receipt, or for e-Invoice questions about Bukku, contact Bukku support.
4. Do my sales go to Bukku straight away?
No. With 'Auto Sync' on, Bukku collects your StoreHub orders once a day, at midnight. A day's sales show in Bukku after that midnight.
Need Help?
Contact StoreHub Support via live chat in your StoreHub app or email [email protected].
Was This Article Helpful?
Let us know below or contact support for further assistance.