An E-commerce site selling fashion products such as T-shirts, pants, jackets, and dresses needs to integrate with the 4ws.suite to handle the registration of sales through fiscal and non-fiscal receipts.The 4ws.suite provides three APIs that the e-commerce system must invoke to complete the sales process.
WARNING
By using the API as specified in this documentation, the document will be recorded as unfiscalized (not printed). The salesperson will still have the option to print the document later using the MobileShop application. This functionality allows for efficient handling of document processing and printing.
E-commerce System: The external system initiating the order processing and stock transfer.
4ws.trade Service: The service Save sale handling the creation of sales and stock transfer documents.
Store Clerks: The clerks or warehouse workers are responsible for preparing the items and the package, printing the sales receipt and preparing the documentation for shipment.
The external system must ensure that prices in the documents are valued according to the following rules:
priceSale: the product's selling price is a gross VAT amount;
priceInvoice: the product's invoice price (purchase invoice) is a net VAT amount;
pricePurchase: the product's purchase price (typically purchase order) is a net VAT amount.
If the fields priceSale is mandotary instead priceInvoice, and pricePurchase are not provided, the system will attempt to retrieve prices based on the branchCode and the sale, invoice, and purchase price lists. If no matching price is found, the API will return an error, and the document will not be created.
It is strongly recommended that the e-commerce site stores the unique receipt ID 02931b8a-a6c8-4e47-b3f1-041ffb1e432q and links it uniquely to the collected order.
Here is the procedure that the clerk must follow when receiving an e-commerce sale via the Save sale service in the 4ws Mobile Shop register:
1.
Order Reception:
The clerk receives a notification of a new e-commerce sale in the 4ws Mobile Shop register.
2.
Package Preparation:
The clerk begins preparing the package with the products ordered by the customer.
3.
Sale Fiscalization:
Before closing the package, the clerk must fiscalize the sale.
Access the 4ws Mobile Shop register and print the receipt for the received e-commerce sale.
4.
Receipt Insertion:
Once the receipt is printed, the clerk inserts it into the package along with the ordered products.
5.
Package Closure:
The package is then closed and sealed, ready for shipment.
6.
Contact Shipping Service:
With the package ready, the clerk contacts the shipping service to arrange for the package to be sent to the customer.
By following this procedure, the clerk ensures that each e-commerce order is correctly processed, fiscalized, and shipped to the customer, complying with all fiscal regulations and the store's operational practices.
If the goods sold are returned by the customer, the e-commerce must send the return movement through a return receipt that will return the goods to the warehouse. Refer to the use case E-commerce Return Receipt Processing with 4ws.trade
