Serial Numbers

Objective

The Seller can now set up a serial number for each item when setting an order in “Ready to ship.” Later, the serial numbers can be printed as bar codes.

  • This serial number is an identification code that is unique to the product.
    • This allows specific items to be more easily identified in the warehouse (e.g., after returns).

A serial number is 26 characters (Latin characters and integer digits), and is unique on Seller order-level. The serial numbers can be set when setting an order to “Ready to ship” in the Order Overview, by CSV or by API. The introduction of serial numbers is optional and when not set, the OMS id_sales_order_item will be assumed.

Serial numbers can be printed in the Order Overview or by API.

Critical KnowledgeIf you want to use the Serial Numbers feature, please create a TMLSD ticket. The configuration parameter that needs to be changed is serial_number/enabled.

 

Seller Setup

Step Description Image
1 Go to Administration > Seller Management > Edit Seller (selecting the specific Seller that will be integrated with the shipment provider) shipment_setting6
2 Under Order Processing, the option “ allows you to enable or disable the feature for the Seller. sn_seller_switch
3  Click “Submit”

Setting Serial Numbers

Order Overview

Step Description Image
1

Go to Orders > Manage Orders

Select an order and click “Ready to Ship”

 sn_orders
2 Select the shipment provider and click “Create Package & Next” sc_orders_1
3 Insert the serial numbers (optional) for the desired order items and click “Save Serial Numbers & Next” sc_orders2
4 Continue with the rest of the process.

By CSV

Step Description Image
1

Go to Orders > Manage Orders

Select an order and click “Bulk Order Update”

 sn_orders
2

Select the option “Set to Ready to Ship” as the “Import Mode” and upload a pending order items CSV file with the new column “Serial Numbers” filled for the desired order items.

When uploading a pending order (numbers), there is no option to set the serial numbers, meaning that the OMS id_sales_order_item will be assumed.
sc_csv
3 Click “Upload File”

By API

Shop facing APIIn order to use the Serial Numbers feature, an updated API call to the Shop’s Order Management System for setStatusToPackedByMarketplace needs to be triggered.

  • Implementation / documentation for the API call:  setStatusToPackedByMarketplaceV4().
  • Please create a TMLSD ticket so that this call can also be enabled and configured in Seller Center. The API call setStatusToPackedByMarketplace needs to be set to version 4.
Seller facing APIFor Seller, nothing changes during order processing via API. Sellers only have to include the serial number within the setStatusToReadyToShip-call.

Printing Serial Numbers

Step Description Image
1

Go to Orders > Manage Orders

Select an order(s)

 sn_orders
2 In the actions drop down, select “Print Serial Numbers for select items” sc_print
3 Insert the serial numbers (optional) for the desired order items and click “Save Serial Numbers & Next” sn_print1
4 Continue with the rest of the process.

Serial numbers can be requested and later printed by API in the call get document with the DocumentType: serialNumbers