About file uploads
Your customers can add items to the shopping cart by uploading a file.
To enable this feature for a customer, assign the customer to a role that has the Order file upload feature element. Perform this task in the Business Center.
- The file must be a CSV file encoded using UTF-8.
- Each line in the CSV file corresponds to an order line.
- Each line must start with the item number, followed by the separator character, followed by the quantity. Customers can use either commas or semi-colon as the separator. If the user can add order line notes, then the file must include another separator character after the quantity, followed by the order line note.
- If style items are included in the file, the item number for the individual SKU must be used. The item number of the parent item cannot be used.
- You can use the Ordering.File Upload OrderLine Limit application property in the Business Center to control the order line limit.
If the uploaded file contains errors, the user is notified by opening editable fields that contains the item with errors such as invalid item numbers. The user must correct the errors first before the users can add it to the cart. If the user navigates away from the Shopping Cart page before correcting errors, the items are removed from the Shopping Cart page.
If you sell items in modular quantities, users are notified if the quantity uploaded is an incorrect quantity. For example, if you sell items in multiples of two, and the user uploads an order for a quantity of 3, the item with the incorrect quantity is opened in an editable field and a revised quantity is suggested. Depending on how the Items.Enable ModularQuantity Check tenant application property is set up, users may add incorrect modular quantities to the cart.