If you are interested in implementing for your business, fill out our form and indicate the name of the desired product in the
Comments
section.
VTEX Pick and Pack is a solution to streamline stores’ fulfillment processes by optimizing orders’ picking and packing, and the last-mile delivery. The solution is composed of the Last Mile and VTEX Pick and Pack Fulfillment features, and appears in your VTEX Admin in Apps.
The VTEX Pick and Pack Fulfillment module is related to the order handling process and has the following sections:
VTEX Pick and Pack is not an invoicing system. After picking and packing, the order must be invoiced and updated as
Invoiced
in the OMS, so that VTEX Fulfillment can end the picking and packing flow and proceed to shipping.
Picking and Packing
This is the order management interface, with two main pages:
Picking and Packing list page
When you access Fulfillment > Picking and Packing, you find a page listing all the orders that had the payment confirmed and are on the order status ready for handling
, as in the image below:
The table below contains a description of the columns:
Column | Description |
---|---|
Created date | Order placement date and time. |
Delivery date | Order shipping deadline, according to the Service Level Agreement (SLA) defined between the store and the customer. |
Delivery method | Order shipping type, which can be delivery, send to customer’s address, or pickup from pickup point. |
Order number | Unique ID that identifies an order, the same one used in the Order Management System (OMS). |
Picker | Name of the picker assigned to the order. The picker is the person responsible for the picking process. The default value is Unassigned until a picker is assigned. |
Status | Order status, which can be:
|
To view more details about an order, select one from the list and the information below will appear:
Column | Description |
---|---|
Customer information | Customer’s name, email and contact number. |
Delivery information | Customer’s address for delivery or pickup point address, when the customer is picking up from the store. |
Delivery window | Shows the date the order was placed and the date the customer should receive it. |
Order items | Number of items and their categories. |
Payment method | Order's total amount and the payment method used, like credit or debit cards. |
You can perform the following actions in the Picking and Packing page:
Search
On the top of the page, there is a search box with the magnifier icon in which you can search for orders using the following criteria:
- Order ID
- Customer name
- Store operator managing the order
Filter
You can filter orders using different criteria, and when you click Filters
, a modal displays these options:
- Sort Ascending/Descending: Ascending sort makes the orders with the most recent delivery date and time set by customers at checkout appear first in the list. Descending sort organizes the list in the opposite way.
- Order date: Set a range to filter orders created within the chosen start and end date.
- Due date: Delivery deadlines occur within the chosen start and end date.
- Status: One or more selected order status.
- Order total: Order’s cost range, which can go from $0 to $5 millions.
- Number of items: Number of orders’ items, which can go from 0 to 99.
- Carrier: The carrier assigned to the delivery.
- Payment method: The payment method used by the customer, like credit or debit cards.
- Picker: Picker assigned for the order picking process. Use available pickers’ emails.
- Categories: Orders items' categories, for example, Beverage or Clothes. It depends on the store’s category tree configured in the Catalog.
If you wish to remove the selected filters, click Filters
, and then click Clear filters
.
Import
By default, orders in the ready for handling
status should be automatically imported from OMS to Picking and Packing. If an order is not appearing on the fulfillment module, although is ready for handling
, it could be due to manual changes to the order’s status in the OMS, and you can import it manually.
To import an order manually, follow the steps below:
- Click
Import
. - Enter the Order ID.
- Select the checkbox “Only orders that did not download automatically will be imported”.
- Click
Import
.
Export
You can export a list of orders following the steps below:
- Click
Export
. - Add the desired filters.
It is not possible to export all orders. You can duplicate or delete filters in the menu . The available filters are:
- Picker
- Categories
- Carrier
- Start date
- End date
- City
- Click
Export
.
Print receipt
The receipt is a report that contains what the picker has collected and the order's total amount. It may count as an invoice in some countries, but that is not a rule.
To print an order receipt, click on the menu of the row that corresponds to the order and select Print receipt
.
Assign/Reassign picker
To assign or reassign a picker, on the row of the desired order, click the menu and select Assign
or Reassign
. It will open a modal where you will choose the name of the picker.
You can also assign or reassign a picker in the Picking and Packing details page, by clicking on the pencil icon and selecting the picker.
Picking and Packing details page
To access an order details page, on the Picking and Packing list page click on the menu button at the row of the order you want to see more information about and select See details
. You will find a page like the one below:
In the details page, you can do the actions below. The actions available on the Picking and Packing details page will change according to the order status on the Picking and Packing list page.
- Picking*
- Add item*
- Create personalized product
- Replace with recommended item (Suggestions)*
- Replace item (Search)*
- Change price*
- Delete item*
- Finish picking/confirm pickup*
- Packing*
- Print receipt and voucher
- Add shipping service
- Track order
Although the actions above can be performed by users with access to the Admin, typically the actions with an ***** (asterisk) should be executed only by pickers using their mobile devices, without any access to the store's Admin.
Picking
In the natural flow, the picking is made by pickers using their mobile devices. This section shows how to do it via Admin, in case other users need to perform this action.
In the product row, as in the image below, you can pick a product and perform other actions.
To pick a product, follow the steps below:
- On the Quantity column, select the desired number of items.
- Click the check button at the end of the row.
- Click
Confirm
.
In case you need to undo the picking, click on the menu in the product's row and select Restore
.
Add item
In the natural flow, adding items is done by pickers using their mobile devices. This section shows how to do it via Admin, in case other users need to perform this action.
You can add another product by following the steps below:
- On the menu on the same row of the Order ID, click
+Add item
. - Search for the desired product.
- Click
Select
. - Click
Add products
.
Create personalized product
You can create a personalized product by following the steps below:
- On the menu on the same row of the Order ID, click on
+Add item
. - Click the icon with a plus sign.
- Fill in the following fields:
- Name
- Price
- Refid
- Ean
- Select a category.
- Click
Add
. - Click
Add products
.
Search: replace item
In the natural flow, the replacement of items is made by pickers using their mobile devices. This section shows how to do it via Admin, in case other users need to perform this action.
You can replace a product by doing the following:
- On the row corresponding to a product that was not picked, click on the menu .
- Click
Search
. - Search for the desired product.
- Click
Select
. - Click
Confirm
. - In the modal that opens, select a reason for the replacement.
The reasons have to be configured, as explained in the Picking settings section.
- Fill in the field Notes with a brief explanation for the replacement (required).
- Click
Confirm
.
Suggestions: replace with recommended item
In the natural flow, the replacement of items is made by pickers using their mobile devices. This section shows how to do it via Admin, in case other users need to perform this action.
You can replace an item for another one based on a recommendation. The option displayed depends on what your settings are in Intelligent Search.
To replace an item for a recommendation, follow the steps below:
- On the row corresponding to a product that was not picked, click on the menu .
- Click
Suggestions
. - Add the product that appears by clicking on
Select
. - Click
Confirm
. - In the modal that opens, select a reason for the replacement.
The reasons have to be configured, as explained in the Picking settings section.
- Fill in the field Notes with a brief explanation for the replacement (required).
- Click
Confirm
.
You can also search manually for a product, by doing the following:
- On the menu , click
Suggestions
. - Click
Search manually
. - Search for the desired product.
- Click
Select
. - Click
Confirm
. - In the modal that opens, select a reason for the replacement.
The reasons have to be configured, as explained in the Picking settings section.
- Fill in the field Notes with a brief explanation for the replacement (required).
- Click
Confirm
.
Change price
In the natural flow, the price change is made by pickers using their mobile devices. This section shows how to do it via Admin, in case other users need to perform this action.
In order to change the price of an item, follow the steps below:
- On the row corresponding to a product that was not picked, click on the menu .
- Click
Change price
. - In the modal that opens, fill in the fields:
- New price
- Reason
- Notes
- Click
Change price
.
Delete item
In the natural flow, deleting items is made by pickers using their mobile devices. This section shows how to do it via Admin, in case other users need to perform this action.
You can reject a product by following the steps below:
- On the menu , click
Delete item
. - In the modal that opens, select a reason for the rejection.
- Fill in the field Notes with a brief explanation for the deletion (required).
- Click
Confirm
.
In case you need to restore the product, click on the menu <insert_icon> and select Restore
.
Finish picking/confirm pickup
In the natural flow, this is made by pickers using their mobile devices. This section shows how to do it via Admin, in case other users need to do it.
Depending on the order status displayed on the Picking and Packing list page, in the Status section you will find different buttons for specific actions, like the Finish Picking
in the image below:
The button options and the actions you perform by clicking on them can be one of the following:
Finish picking
: All items were picked, and you conclude the picking, moving to the packing process.Confirm pickup
: If it is a delivery, you confirm pickup when the packages are ready to be delivered, and a carrier has picked them up. If the customer will get the order at a pickup point, you confirm pickup after the customer receives the packages.
Packing
In the natural flow, the packing is made by pickers using their mobile devices. This section shows how to do it via Admin, in case other users need to perform this action.
Once you have finished the picking process, you have to create the packages and indicate which item goes in each package. The packages’ settings of how to configure bags and any kind of packages will be seen in the next sections.
To create a new package, follow the steps below:
- Click on the icon in the section Package List.
- Select the package type.
- Click
Create package
.
You can add a single product to a package or all products at once. After all products are packed, click Close Packages
. Once you close packages, you are no longer able to add items or make any kind of change.
VTEX Pick and Pack is not an invoicing system. Once the order gets to
Ready for invoicing
status, it must be invoiced and updated asInvoiced
in OMS. Only after that, VTEX Fulfillment will end the picking and packing flow and proceed to shipping. If the order is invoiced in a status different fromReady for invoicing
, the system will consider it an external fulfillment and change the order status toIdle
, unabling VTEX Pick and Pack to process it.
Print receipt and voucher
On the top of the details page, on the left side of Status, you will find a menu and when you click on it, it displays the following options:
- Receipt: print the order’s receipt regarding all items.
- Voucher: print the voucher, a report for customers that contains general information and that can be signed by them.
- Receipt picked items: print the order’s receipt related only to items already picked.
- Voucher picked items: print the voucher related only to items already picked.
- + Add item: add a new product or create a personalized product.
Add shipping service
When the order picking, packing and invoicing is complete, and the order is in the Prepare services
status, you can add a shipping service following the steps below:
- Click the
Add service
button. - Select the day and time when the order will be dispatched.
- Select the day and time when the order will be shipped.
- Choose a carrier.
- Select a Service Type.
- Select a payment method.
- Select the packages that will be shipped.
- Click
Confirm shipments
.
You will receive a message of success and the order will move to the Ready for shipping status.
Track order
Once the order gets to the Ready for shipping or Delivered status, the Go to tracking
button will appear in the Picking and Packing details page. When you click it, you will be redirected to Last Mile to track the order.
Or you can go to Last Mile directly in the store’s Admin, accessing Apps > Last Mile > Shipping Services.
Insights
In VTEX Pick and Pack, the Insights page provides data and analytics about your orders during the fulfillment process. In that page, you will see two tabs:
Insights: Picking and Packing
Total orders is a real time chart where you see information about all orders during a period in comparison to another. You can use multiple filters to get different results.
Insights: Filters
You can combine multiple filters to filter the information you want to see in the charts, by accessing Filters
on the top of the page. You can filter by the following criteria:
- Picker
- Delivery method
- Carrier
- City
- Seller
The filter Seller is visible only for the account that operates as a marketplace. White label sellers do not have that filter option in Insights.
Besides the Total orders chart, there is a sequence of charts where you obtain data about Payment methods and orders that were:
- Picked
- Shipped
- Delivered
- Cancelled
You can apply multiple filters to get different results.
Insights: Performance of categories and products
Below Total orders, you will find a chart about the number of orders and units bought and to what category they belong to. You can choose to group by Categories
or Products
.
Insights: Operation
In the tab Operation, you will see the Picking and Packing Order flow, a chart with the total amount of orders distributed per day in the last seven days. The darker the blue, the more orders, the lighter the blue, the less.
The Picking and Packing Order flow chart is calculated taking into account all orders of the last 7 days, and distributes them in hours, going from 0 to 23. Even if you change the period to 15 days, for example, the chart will remain fixed considering 7 days.
Below the Order flow, there is another chart with orders data filtered by picker. You will see information about:
- Orders
- Products
- Rejected products
- Fulfillment rate
- Average time
The page also provides charts related to the following topics:
- Picked orders: number of orders picked in the selected period.
- Fulfillment rate: percentage of orders picked within the minimum delivery due date.
- Time: average time of the picking process.
- Rejection reasons: explanation of why a product was rejected.
- Replacement reasons: explanation of why a product was replaced.
- Price change reason: explanation of why a product has a price change.
Settings
In order to configure VTEX Pick and Pack for your store, in your Admin, go to Apps > Fulfillment > Settings. You will a page with the following tabs:
To be able to access Settings, you need to be a VTEX Fulfillment admin user or a customer service user.
General settings
In this tab, you can configure the store you are adding VTEX Pick and Pack to. You can choose a store by clicking on the pencil at the top of the page and selecting the desired one.
To configure a store, follow the steps below:
- Fill in the boxes next to the map with the information of the store’s address.
- In Contact information, fill in with data about the person who is going to be contacted, if necessary.
- In Work Schedules, set up the starting and ending hour of the days of the week when the store’s picking can be performed.
- In Units of measure, select which unit is going to be the default to measure the length of items and packages, for example.
- Click the
Save
button.
Picking settings
In this tab, you can configure some of the main aspects and preferences of the picking process, for example, rejection reasons and pickers.
To determine the picking settings, follow the steps below:
- In Picker Assignation, select if the store will assign pickers manually (
manual
), by an Admin User, or automatically (automatic
), based on the pickers’ availability. - In Packing Path, select the moment you want the packing process to start, which can be:
- After picking
- After invoice
- From invoice
- In Picking app, enable the toggles related to the preferences of what pickers will be able to see and perform through the mobile application. It is not mandatory to enable them, and the options are the following:
- Show customer information
- Allow price change
- Allow product replacement
- Allow rejecting products
- Limit collection item quantity
- Allow mobile packing
- In Reasons, under Replacement reasons, fill in the box with the name of the label that will identify a valid replacement reason and press
enter
. Repeat the process to add as many labels as you want. - Under Changes price reasons, fill in the box with the name of the label that will identify the reason for price changes and press
enter
. Repeat the process to add as many labels as you want. - Fill in the box under Limits for changes with the number of how many changes can be performed per order.
- In Priority order, choose the level of priority in the category tree level to sort items in the picking process. You can choose between
1
(main categories), or2
(children categories). - Click the
Save
button.
Categories settings
In this tab, you will find categories and subcategories that should be listed according to the store’s business model priorities.
The actions you can do are the following:
- Change priority: Click the category and drag it to the position you want.
- Delete category: Click the trash icon and click
Yes, delete
. This action will make the category disappear from the list and appear on the side, under Collection / Category priority. - Add category: If one category was deleted, it will appear under Collection / Category priority, and you can add them to the list by clicking on it.
After changing the priorities list, you need to click Save
.
Packages settings
In this tab, you can control the packages used to deliver the order and can create or delete a package.
To create a package, do the following:
- Click
Add new
. - Fill in the name that will identify the package.
- Fill in with the package’s measures: height, width and length, using numbers only.
The measurement unit is the one configured in the tab General, in Units of measure.
- Click
Add
.
To delete a package, click on the row that corresponds to it and then click Yes, delete
.
Shipping settings
In this tab, you can associate a Last Mile service to your store, which allows you to have status and location tracking with real-time updates, while your in-house courier’s fleet delivers orders to customers.
If the Last Mile toggle is disabled, there are no setting options. To start using Last Mile, do the following:
- Enable the toggle by clicking on it .
- In Associated carrier, select the name of the carrier.
- If you do not want to enable automatic courier assignment when creating shipping services, leave the toggle disabled and click
Save
. - If you want to enable automatic courier assignment, enable the toggle
Automatic courier assignment
. - In Type of assignment, select the assignment rule for choosing carriers, which can be:
- One at a time: The task notification is sent to the courier that is closest to the collecting point. If the first courier does not accept the task within the request expiration time, the task is sent to the second nearest courier and so on. If no courier accepts the task, it remains unassigned.
- Send to all: All the couriers available in the task time zone receive the notification, limited to a maximum of 500 couriers. The task is assigned to the first courier that accepts it, and it stays unassigned until someone accepts it.
- Round robin: Within a certain radius, a round robin — an algorithm for scheduling and assigning resources — is assigned to the courier, and you can select the following options:
- Assign services to disconnected users
- Restart assignment if the service is rejected
- Prioritize couriers without services
- Prioritize couriers with shorter delivery time
- The nearest one: The task assignment is given to the available courier that is closest to the point where the order will be collected.
- Fill in the field Expires in (seconds) with x, using numbers only.
- Fill in the field Number of reattempts with x, using numbers only.
- Click
Save
.
Printing settings
In this tab, you can configure printing preferences, organized in the following sections:
- Receipt: Order’s receipt.
- Package label: Label to identify a package, with bar codes for scanning.
- Shipping label: Label with the shipping address.
In each one of those sections, you have to enable the toggle for the configuration to be valid.
Once you are done with the printing settings, click Save
.
Webhook settings
In this tab, you can configure a webhook to be notified about orders’ status changes and to get information about a given order.
For more information, see our VTEX Pick and Pack documentation for developers.
Users
In VTEX Pick and Pack, the Users page allows you to manage the profiles involved in the fulfillment process, called users. There are three types of users:
User | Description | Permission |
---|---|---|
Picker | Person responsible for the picking. |
|
Customer Service | The store’s operator responsible for the order, the customer support with access to the Admin. |
|
Admin | The admin role has access to check pickers, manage all settings, and order flow, including canceling orders if necessary. | All the permissions given to Customer Service user, plus:
|
Users and License Manager in VTEX Fulfillment
The VTEX Pick and Pack concept of user is different from the common meaning of the term in VTEX. In VTEX Fulfillment, there are three types of users that participate in the fulfillment process - picker, customer service and admin. Usually, in VTEX, users are related to roles and License Manager resources.
To access the VTEX Fulfillment, the admin and customer service users must have permissions related to License Manager resources. We recommend creating a role identified as “Fulfillment admin”, which must have at least the following products and resources associated with it:
Product | Associated Resources |
---|---|
Insights |
|
License Manager |
|
Actions in the Users page
In the page Users, you can perform the following actions:
Add a picker user
To create a new picker, follow the steps below:
- In your Admin, go to Apps > Fulfillment > Users.
- On the top menu , click
Add picker
. - Fill in the following information:
- Name: Picker’s complete name.
- Email: Picker’s email.
- User: Username that will identify the picker.
- Password: The password the picker will need to identify and authenticate himself in the app. The password must have at least:
- One uppercase letter
- One lowercase letter
- One number
- Stores: Select the environment the picker will be associated with. Each environment can have multiple white label sellers associated with it.
- Categories: Select up to four categories related to the products the picker will collect.
The categories related to the picker optimize the algorithm when determining which picker will get the order. However, it is not a limitation, any picker can be assigned to tasks from all categories.
- Click
Save user
.
Add a Customer Service user
Only admin users can create new customer service users. To do so, follow the steps below:
- In your VTEX Admin, go to Apps > Fulfillment > Users.
- On the top menu , click
Add customer service user
. - In the box, search by typing the user’s name, email or Id.
- Click
Confirm
.
Add an Admin user
Only an admin user can create another admin user. To do so, follow the steps below:
- In your VTEX Admin, go to Apps > Fulfillment > Users.
- On the top menu , click
Add admin
. - In the box, search by typing the user’s name, email or Id.
- Click
Confirm
.
Edit users
You can edit any kind of user to change the information listed below:
- Name
- Password
- Categories
- Store
To edit a user, follow these steps:
- In your VTEX Admin, go to Apps > Fulfillment > Users.
- On the row that corresponds to the user you want to edit, click on the menu .
- Select the option
Edit
. - Change the fields you want.
- Insert the password.
- Click
Save
.
Generate Api-Key
Admin users can generate Api-Keys to use VTEX Pick and Pack APIs. For more information, see our documentation for developers.
To generate an Api-Key, follow the steps below:
- In your VTEX Admin, go to Apps > Fulfillment > Users.
- On the row that corresponds to an admin user, click the menu .
- Select the option
Edit
. - Click
Generate
. - Save the Api-Key in a safe place.
You only see the Api-Key once, you will not be able to access this information again, so make sure it is in a safe place.
- Enter the password.
- Click
Save
.
Delete users
Only admin users can delete other users, by following the steps below:
- In your VTEX Admin, go to Apps > Fulfillment > Users.
- On the row that corresponds to the user you want to edit, click on the menu .
- Select the option
Delete
. - Click
Save
.