Quote Management System

This project includes a comprehensive quote management system that handles various aspects of quoting, such as cart quotes, customer quotes, order changes, and order quotes.

Features

1. Cart Quotes

   • Handles the creation and management of quotes associated with shopping carts.
   • Includes logic for calculating discounts, taxes, and total amounts.

2. Customer Quotes

   • Manages quotes specific to individual customers.
   • Supports personalized pricing and customer-specific terms.

3. Order Change Quotes

   • Facilitates quotes for changes to existing orders.
   • Ensures accurate recalculations for modifications.

4. Order Quotes

   • Generates quotes for finalized orders.
   • Includes support for order-specific adjustments and promotions.

5. Quote Modules

   • Contains reusable modules and utilities for quote management.
   • Provides a centralized location for shared quote-related logic.

How It Works

1. Initialization: Quotes are initialized based on the context (cart, customer, or order).
2. Calculation: The system calculates the quote details, including pricing, discounts, and taxes.
3. Validation: Ensures all required fields are populated and the quote meets business rules.
4. Finalization: Once approved, the quote is converted into an order or saved for future reference.

API Documentation

1. Preview Quote

Endpoint: GET /store/customers/me/quotes/{{quoteId}}/preview

curl -X GET "{{backend_url}}/store/customers/me/quotes/{{quoteId}}/preview" \
-H "Authorization: Bearer {{token}}" \
-H "x-publishable-api-key: {{x-publishable-api-key}}"

2. Customer Accept Quote

Endpoint: POST /store/customers/me/quotes/{{quoteId}}/accept

curl -X POST "{{backend_url}}/store/customers/me/quotes/{{quoteId}}/accept" \
-H "Authorization: Bearer {{token}}" \
-H "x-publishable-api-key: {{x-publishable-api-key}}"

3. Create Request for Quote

Endpoint: POST /store/customers/quotes

curl -X POST "{{backend_url}}/store/customers/quotes" \
-H "Authorization: Bearer {{token}}" \
-H "x-publishable-api-key: {{x-publishable-api-key}}" \
-H "Content-Type: application/json" \
-d '{
  "region_id": "reg_01JQ950RWSF4HPHKQHB4FMB1EM",
  "first_name": "fn",
  "last_name": "ln",
  "quantity": 5,
  "email": "[email protected]",
  "variant_id": "variant_01JQ950S0R2YJ8WN7KJ6K0YZA7"
}'

4. Get Customer Quotes

Endpoint: GET /store/customers/me/quotes

curl -X GET "{{backend_url}}/store/customers/me/quotes" \
-H "Authorization: Bearer {{token}}" \
-H "x-publishable-api-key: {{x-publishable-api-key}}"

5. Customer Reject Quote

Endpoint: POST /store/customers/me/quotes/{{quoteId}}/reject

curl -X POST "{{backend_url}}/store/customers/me/quotes/{{quoteId}}/reject" \
-H "Authorization: Bearer {{token}}" \
-H "x-publishable-api-key: {{x-publishable-api-key}}"

6. Admin Get All Quotes

Endpoint: GET /admin/quotes

curl -X GET "{{backend_url}}/admin/quotes" \
-H "Authorization: Bearer {{adminAuth}}"

8. Admin Reject Quote

Endpoint: POST /admin/quotes/{{quoteId}}/reject

curl -X POST "{{backend_url}}/admin/quotes/{{quoteId}}/reject" \
-H "Authorization: Bearer {{adminAuth}}"

9. Admin Create Quote

Endpoint: POST /admin/quotes

curl -X POST "{{backend_url}}/admin/quotes" \
-H "Authorization: Bearer {{adminAuth}}" \
-H "Content-Type: application/json" \
-d '{
  "customer_id": "cus_01JQNBNXTHYW6KNH2GX85YQGVZ",
  "region_id": "reg_01JQN8EF6A9SPHZ0E33EAD9ASW",
  "variant_id": "variant_01JQN8EFBEKQ25BS7QW71X5BBF",
  "quantity": 5
}'

10. Admin Send Quote

Endpoint: POST /admin/quotes/{{quoteId}}/send

curl -X POST "{{backend_url}}/admin/quotes/{{quoteId}}/send" \
-H "Authorization: Bearer {{adminAuth}}"