User Stories
Table of Contents
- Introduction
- Purpose
- Scope
- User Stories
- Acceptance Criteria
- Definitions, Acronyms, and Abbreviations
- Appendix
- Approval
Introduction
This document outlines the user stories for the Duty Inclusive Pricing (DIP) project for Mouser Electronics. The document includes detailed requirements and acceptance criteria to capture the user needs for this project.
Purpose
The purpose of this User Stories document is to capture the user requirements for the Duty Inclusive Pricing project. It aims to provide a clear and concise understanding of the functionalities needed to be developed.
Scope
The scope of this document covers the Duty Inclusive Pricing functionalities for Mouser Electronics, focusing on calculating and displaying duty-inclusive prices across all Mouser applications that calculate and display pricing in India.
User Stories
User Story 1: Duty Inclusive Pricing Calculation
- As a: Pricing Analyst
- I want to: Calculate duty-inclusive prices for products shipped to India
- So that: Customers can see the final price including duties and tariffs
Description
The system should calculate duty-inclusive prices based on various parameters such as HTS codes, COO, and supplier ID overrides.
Acceptance Criteria
- The system should apply duties for orders with sender code "MI," ship-to as "India," and OPC code as un-skippable.
- If the COO is missing, return a zero rate.
- If the India HTS code is missing, use the US HTS code.
- If the US HTS code is missing, return a zero rate.
- If the part has an IPC duty override, return the override rate.
- If the part has a supplier ID duty override, return the override rate.
- Retrieve the business rate with given COO/HTS/Ship-to/Sender Code combination.
- If the part has multiple COOs, use the COO with the lowest rate.
Notes
- The calculated surcharge amount should be included in the final price presented to the customer.
User Story 2: Web Interface Display
- As a: Customer
- I want to: See the duty-inclusive price on the Mouser website
- So that: I can make an informed purchasing decision
Description
The web interface should display the duty-inclusive price for products, including the surcharge amount and relevant messages.
Acceptance Criteria
- Display the duty-inclusive price flag.
- Show the surcharge amount and name.
- Replace the resale price with the duty-inclusive price.
- Charge taxes on the duty-inclusive price as per GST tax rules.
Notes
- Ensure that the duty-inclusive price is displayed consistently across all web pages where the product price is shown.
User Story 3: API Updates
- As a: Developer
- I want to: Update APIs to support duty-inclusive pricing
- So that: The backend system can provide accurate pricing information
Description
Update the APIs such as Quote, Cart, Checkout, and Search to support duty-inclusive pricing and return relevant messages based on the customer’s request.
Acceptance Criteria
- Add an optional attribute "MouserPaysCustomsAndDuties" to the APIs.
- Return appropriate messages based on whether the customer requested duty-inclusive pricing.
- Validate GSTIN number for order API to provide duty-inclusive pricing.
Notes
- Ensure that the APIs are backward compatible and do not break existing functionalities.
User Story 4: Onboarding Modal
- As a: Customer
- I want to: Select my preferred pricing method via an onboarding modal
- So that: I can choose between duty-inclusive pricing and standard pricing
Description
Create an onboarding modal to allow customers to select their preferred pricing method, with options for duty-inclusive pricing or standard pricing.
Acceptance Criteria
- Display the onboarding modal with options for duty-inclusive pricing and standard pricing.
- Include a "learn more" link for additional information.
- Allow customers to close the modal without making a selection.
- Default to standard pricing if no selection is made.
Notes
- The modal should pop up after the flag and cookies modal and should be accessible sitewide in future phases.
User Story 5: Order Entry and Update
- As a: Sales Representative
- I want to: Enter and update orders with duty-inclusive pricing
- So that: Customers receive accurate pricing information on their orders
Description
Allow sales representatives to enter and update orders in the system, ensuring that duty-inclusive pricing is applied where applicable.
Acceptance Criteria
- Allow users to indicate if an order is for MI or ME.
- Ensure rules pertaining to parts, currency, ship vias, and payment types are maintained.
- Store duty amounts and sender codes at the line level.
- Validate pricing overrides to ensure they do not violate min/max price rules.
Notes
- Ensure that correction orders honor the original invoice price.
Acceptance Criteria
- Duty-inclusive prices should be accurately calculated and displayed.
- APIs should support duty-inclusive pricing and return relevant messages.
- Onboarding modal should allow customers to choose their preferred pricing method.
- Orders should be processed with accurate duty-inclusive pricing.
Definitions, Acronyms, and Abbreviations
- DIP: Duty Inclusive Pricing
- COO: Country of Origin
- HTS: Harmonized Tariff Schedule
- GSTIN: Goods and Services Tax Identification Number
- MI: Mouser India
- ME: Mouser Entity
- IPC: Importer of Record Code
Appendix
Approval
- Prepared by: Preema Pais
- Email: alexhogan@me.com
- Date: 02/21/2025
- Approved by: Heather Morrison and Nick Smith
- Date: 02/07/2025