Welcome to the Jose Madrid Salsa developer docs — explore features, APIs, and deployment guides.
Jose Madrid SalsaJMS Docs

Wholesale Accounts

Trade accounts — application, approval, and the pricing they unlock.

Wholesale Accounts

A wholesale account is a business that buys to resell. It hangs off a User with the WHOLESALE role and is managed at /admin/wholesale.

Application

WholesaleAccount is created when a business applies:

FieldNotes
businessName, contactNameRequired
businessTypeRETAIL_STORE, RESTAURANT, DISTRIBUTOR, ONLINE_STORE, OTHER
taxId, resaleNumberFor tax-exempt resale
website, yearsInBusiness, estimatedVolumeQualification detail

One account per user (userId is unique).

Approval

StatusMeaning
PENDINGAwaiting review
APPROVEDTrading — approvedAt / approvedBy record who signed it off
REJECTEDDeclined
SUSPENDEDWas approved, now stopped

Trade terms

Two fields carry the commercial arrangement:

  • discountRate — a percentage off catalogue price, Decimal(5,2), defaulting to zero.
  • minimumOrder — the order value below which the account cannot check out.

The WHOLESALE role carries no admin permissions by default. It designates the account type; it does not grant back-office access.

How is this guide?

Edit on GitHub

Last updated on

On this page