Bitoff Bulk Order Management

Introducing Bitoff's Bulk Order Management!

- ⏱ Create hundreds of orders in few minutes!

- ❌ Cancel multiple orders at once with ease.

- 🔄 Modify discount rates for orders in bulk - no more one-by-one changes.

- 🚀 Experience shopping efficiency like never before.

- 👋 Say goodbye to the stress of placing individual orders.

- 🔁 Handle all your items in one go with our sleek CLI feature.

Bitoff has introduced a new feature called Order Management. It allows users to create, modify, and cancel orders in bulk using the Bitoff Command Line Interface (CLI). This feature is currently in beta but can already bring significant efficiency to your shopping experience on Bitoff. Here, we'll guide you on how to use this feature.

Install Requirements

Mac OS
First you need to install Homebrew on your MAC device, then go for Git and Golang:

Homebrew:
1- Open the Terminal app (can be found in Applications > Utilities).
2- Install Homebrew by pasting the following command and hitting Enter:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Git:
Once Homebrew is installed, run this command to install Git:
brew install git

Golang:
Once Homebrew is installed, run this command to install Go:
brew install go



Windows OS
Simply follow below steps to install Git and Golang on your Windows:

Git Installer:
1- Go to the Git website
2- Download the Windows version.
3- Double-click the downloaded .exe file and follow the installation instructions. The default settings should work fine for most users.



Go Installer:
1- Go to the Go website
2- Download the Windows installer MSI package.
3- Double-click the downloaded .msi file and follow the installation instructions. The default settings should work fine for most users.

Running Command

After installing the Golang compiler on your machine, you need to run the following commands to install "bulky".

1- Clone the Repository:
This command will create a local copy of the "bulky" repository from GitHub onto your machine.
git clone https://github.com/bitoffgit/bulky.git

2- Change Directory:
This command changes the current working directory to the "bulky" directory that was just cloned.
cd bulky

3- Run the Installation Script:
This command executes the install.sh shell script from the "bin" directory. The script is responsible for installing the necessary dependencies and setting up the "bulky" on your machine.
For Unix base OS (like Linux & Mac) use:
sh bin/install.sh

For Windows OS use:
go run main.go

Authentication

Login to Bitoff: Login to your Bitoff account
First, login to your Bitoff account as you normally would.

Find Your localUserToken:
After logging in, you need to find your localUserToken. This is a unique identifier associated with your account.

To find your localUserToken:
1 . Open your browser's web inspector. (This is typically accessed by right-clicking on the webpage and selecting 'Inspect' or 'Inspect Element')
2 . Navigate to the 'Application' tab (for Chrome) or 'Storage' tab (for Firefox).
3 . Click on 'local storage' in the left sidebar.
4 . In the list of local storage, look for the one named 'localUserToken'.
5 . Copy the value of the localUserToken cookie.

Prepare Your .csv File:

1- Bulk Order Creation:
For bulk order creation, you need to create a .csv file with all your order details. The file must be formatted exactly as shown in this example file:

create.csv





ASIN: This stands for Amazon Standard Identification Number. Each row should contain one ASIN.

Quantity: This field should specify the quantity you want to order for each ASIN. Max quantity for each ASIN is 5.

Discount: Here, you can set the discount percentage you desire for each ASIN. Note that the discount is assigned to each order, not to each Assin. As you can see in the example image, the discount for group_order #1 is 20, and the discount for group_order #2 is 15.

Currency: This field denotes the type of cryptocurrency you want to use for your purchase. For Bitcoin, type 'btc', and for Tether, type 'usdt'.

Address and Info: Please provide your shipping address and additional necessary information in this field. Please be aware that the standard zip code has a maximum length of 5 digits.

Group Order: This field allows you to group different products into the same order. Starting from 1, all ASINs with the same group order number will be placed in the same order. For instance, all ASINs marked as '1' will be together in one order, '2' in another order, and so forth. In the provided example, a group_order marked as '1' indicates an order containing three distinct products with a total of 7 items (given the quantities of 2, 2, and 3 for each product respectively).

Once the Bitoff CLI has finished creating the orders, it will generate two new .csv files:

1 . Success Orders: This file lists all the orders that were successfully created. It allows you to verify that all necessary orders have been placed as per your initial .csv file.


2 . Failed Orders: This file lists all the orders that could not be created for some reason. You can use this list to identify any issues and correct them.

2-Bulk Order Modification (update):

For modification of orders, you need to create a .csv file including order_id & discount. Please take note that the 'discount' field is the only updatable field in order details that you may need to modify.
The file must be formatted exactly as shown in this example file:

update.csv




Order_id: The order_id is a unique identifier assigned to a specific order in the database.

Discount: You can set the desired discount percentage that will replace the existing one.


3- Bulk Order Cancelation:

For bulk order cancelation, you need to create a .csv file including order_id & note. The file must be formatted exactly as shown in this example file:

cancel.csv




Order_id: The order_id is a unique identifier assigned to a specific order in the database.

Note: Kindly provide a brief reason for the cancellation of the order.

4- Get Order Details:
To retrieve order details, you should generate a .csv file as shown below, in order to provide the Bulky with the necessary order IDs for obtaining the details:



In response, you will receive a .csv file that includes currency, status, discount, date, items, total price, and saved amount.



5- Filter Orders by Status:

If you wish to inquire about the status of each order, you can choose option 5, specify a time range and a status, and then you will receive a .csv file containing a list of orders within the selected status and time frame.

Start Bulk Order Management:

To create orders, simply use the bulky. With it, you can easily create, update, or cancel orders.




1- Provide the path to the previously prepared .csv file.

2- Input the localusertoken extracted from your browser.

3- Select an action:
Enter 1 to create orders.
Enter 2 to update orders.
Enter 3 to cancel orders.
Enter 4 to get order Details.
Enter 5 to filter orders by status.

Review the Output .csv Files:

And now, We're back with some fantastic news for our Bitoff users. Our Bulk Order Management feature has just become even more powerful and user-friendly, thanks to two exciting new additions.




Enter 4 to get order Details.
Enter 5 to filter orders by status.






Get Balk Order Details


Have you ever needed quick access to specific order details? Now, you can effortlessly retrieve all the information you need with a single command. No more sifting through piles of data or searching through order histories. Bitoff's Bulk Order Management allows you to stay organized and informed like never before.

Filter Balk Orders By Status

Want to find specific orders within a particular timeframe and based on their status? With this new feature, it's a breeze. Streamline your order management by quickly sorting and accessing orders based on their status.


Convenient CSV Export:

But that's not all! We've taken it a step further by allowing you to have your filtered orders as a CSV file.


You can cross-verify these .csv files against your original orders file to ensure all orders have been successfully processed. In the event of any failed orders, you can correct the issues (like product availability, incorrect ASIN, etc.) and rerun the "bulky" with the corrected .csv file to attempt to create those orders again.


By offering a comprehensive report of both successful and failed orders, Bitoff's CLI provides an efficient and straightforward way of managing your bulk orders, ultimately saving you significant time and effort.

That's it! You've successfully created bulk orders on Bitoff using the new Order Management feature. This new feature can drastically streamline your shopping process, allowing for greater convenience and efficiency.

Please note that as this feature is still in beta, you may experience occasional bugs or issues. We appreciate your feedback and patience as we work to refine and enhance this tool.

Updated on: 17/10/2023