Skip to content

Where in the app

System → Settings → Chemistry (/settings/chemistry). Requires settings view/edit permission.

⚗️ Chemistry settings ​

Define which catalog product the calculator uses for each correction type (raise pH, chlorine shock, algaecide…) and water targets.


What this screen controls ​

BlockPurpose
TargetspH, free chlorine, alkalinity, salt, CYA, hardness, shock chlorine
Dosing modeStandard or conservative (affects quantities)
Product by roleWhich catalog item is suggested per need
Product profileConcentration, dose unit, per-visit cap
CoefficientsFine-tune formulas (advanced users)
PreviewSample suggestions with current setup

Same configuration powers:

  • Phone/office consultation (Operations → Chemical consultation)
  • Technician work order (Step 2 — dosing)
  • Chemical PDF for the client

Starter catalog on signup ​

New accounts may get a demo chemical catalog (13 products at price 0 with SKUs like QR-001, QD-005…).

Next steps

  1. Review names and set real prices under Warehouse → Products.
  2. Open Settings → Chemistry and confirm each role points to the product you actually use.
  3. When changing brands, do not delete the old product if it has history: create a new one and reassign the role.

How to change products (brand switch) ​

Step 1 — Add the new product ​

  1. Warehouse → Products → New product
  2. Name, sales unit (kg, L…), purchase price (for consultation costs)
  3. Optional: your own SKU (not required if you map by role manually)

Step 2 — Chemical profile on the product ​

On the product page, Chemistry tab:

FieldExampleEffect
Chemical rolePH_INCREASEOne primary role per product
Active %100Scales dose (e.g. 10% acid)
Dose unitg, ml, kgWhat the technician sees
Per-visit cap2000 gPart of the dose may stay pending for the next visit
Sanitation typesChlorine, Salt, Bromine…Skipped if pool type does not match

Step 3 — Assign in Settings → Chemistry ​

Under Product by role, pick the new item for each correction.

Immediate effect: consultation and technician order suggest the new product on the next measurement. No app restart needed.

Step 4 — Van stock ​

Technician sees In van / Out of stock from the mobile warehouse. Restock the new product after the switch.


Chemical roles (reference) ​

RoleWhen used
PH_DECREASE / PH_INCREASEHigh / low pH
CHLORINE_LIQUID_MAINTLow free chlorine (maintenance)
CHLORINE_LIQUID_SHOCK / CHLORINE_GRANULAR_SHOCKShock or high combined chlorine
ALKALINITY_INCREASELow TA
CALCIUM_INCREASELow hardness (secondary)
STABILIZERLow CYA (chlorine pools only)
SALTLow salt (electrolysis)
ALGAECIDE / FLOCULANTWater condition (algae / cloudy)

If a role has no product

The calculator skips that correction without a loud error. Check chemistry settings if an expected suggestion is missing.


Coefficients and conservative mode ​

  • Conservative mode: slightly lower doses (safety margin).
  • Coefficients: multipliers per product type; use only if you know your supplier formulation or after field calibration.

Restore defaults resets standard engine coefficients.


Prices and costs ​

DataWhereEffect
Purchase priceProduct pageEstimated cost in consultation and visit
Price 0 (demo)Starter catalogCosts show €0 until you update
Sales unit vs doseChemical profileAuto conversion (g→kg, ml→L) in consumption cart

Checklist after changing products ​

  • [ ] Each used role has assigned product and active profile
  • [ ] Purchase prices updated
  • [ ] Stock in technician van
  • [ ] Test in Chemical consultation with real readings
  • [ ] Test on technician work order (same doses with visitCapPolicy=apply)

Detailed test guide: E2E calculator test.


🔗 See also ​

Need help? soporte@poolcontrolpro.com