Available on: UK - Go Paperless and above | US - Not available
Connecting your City Plumbing account lets you check live part prices when raising purchase orders and send those orders electronically. This keeps your pricing accurate and speeds up how you order parts from your supplier.
Prerequisites
Before you connect, make sure both your Commusoft and City Plumbing accounts are ready.
In Commusoft, you'll need:
A City Plumbing supplier: A City Plumbing supplier must already be set up in Commusoft, with branches and contacts. See the supplier article for help setting one up.
A comprehensive parts list: Your parts list must include supplier product codes and prices. See Parts for help creating and maintaining your parts database.
Note: Only one supplier in Commusoft can connect to City Plumbing.
In your City Plumbing account, you'll need:
An active account: You must have an active City Plumbing account.
Account verification: City Plumbing accounts are verified directly during setup. Raise any account queries with City Plumbing.
A parts list request: Email [email protected] to request a supplier-specific parts and prices list.
Note: The prices shown depend on your City Plumbing contract, deals, and account type, and VAT is not included in live unit prices. Raise any price discrepancies directly with City Plumbing.
These are the requirements related to your Commusoft account:
City Plumber Supplier: A City Plumbing supplier must already be set up in Commusoft with branches and contacts.
A Comprehensive Parts List: Your parts list must include supplier product codes and prices.
In practice
See our recommended setup for the City Plumbing supplier, branches and contacts.
Integration setup
➡️ Click your Profile icon > Integrations > Suppliers
On City Plumbing, click Add Integration.
Enter your City Plumbing account number, username, password, postcode, and telephone number, then click Continue.
Search for your City Plumbing supplier name in Commusoft, select it from the results, then click Continue.
Commusoft sends a confirmation email to the address in your company details.
Viewing live prices
Once the integration is confirmed, create a purchase order on a job or supplier to see live prices.
➡️ Click Add purchase order
Type the part name, MPN, or product code.
Select the part from the results.
Commusoft uses the product code — not the part name — to find the live price from Wolseley.
The price stored in your supplier pricing database shows in Unit cost, with an icon indicating the price source and age.
The icons you may see are explained below.
Live pricing icons
When you're integrated with Wolseley, Commusoft shows an icon against the Unit cost to tell you where the price came from and how current it is.
Live price found
A green star icon shows that a live price was found for the selected part.
This is a live price: A green star icon indicates the live price has been found for the selected part.
Warnings
Product not recognized: The product code isn't recognized, or there's a network error. If the code isn't recognized, update it and try again. If it's a network error, check your integration details are valid, then wait 1 hour before retrying.
Supplier product code missing: No supplier product code is stored for this part. To fix it, click the icon, enter the supplier product code, then click Save. Commusoft stores it in parts and prices for this supplier.
Loading
Loading dots show if there are temporary connection issues with Wolseley's API. Retry in 30 minutes.
Stored price icons
Base price used: The price comes from the stored base price, because no supplier price was stored for this supplier.
Supplier price age: When the price comes from a stored supplier price, a clock icon shows how current it is — green is under 30 days old, amber is 31 to 60 days old, and red is over 61 days old.
Note: Live prices used on a purchase order don't update the stored supplier price in your parts database.
Important: Line item type Item isn't supported. All line items must use the Part type.
Send a purchase order
When you're integrated with City Plumbing, you can send purchase orders directly through Commusoft.
➡️ Click Add purchase order
Add line items with the type Part.
Choose Collect from supplier and select the branch.
Review the purchase order details, then click Save.
Click Send to City Plumbing via Integration, type Confirm, then click Submit.
Note: Purchase orders created from reorder templates send automatically through the integration. See Part reorder templates.
If sending fails
If a purchase order fails to send, you'll get a notification with an error reason. Resolve the error, then try sending again.
Manage the integration
Once connected, you can review your City Plumbing connection or disconnect it at any time.
➡️ Click your Profile icon > Integrations > Suppliers > Manage
Your City Plumbing account number appears on the Manage screen.
Disconnect
Disconnecting stops live price checks and electronic purchase orders for City Plumbing.
On the Manage screen, click Disconnect.
Type disconnect to confirm.
Click Disconnect again to complete it.
Common questions
Are live prices shown including VAT?
Are live prices shown including VAT?
No, live prices don't include VAT. VAT is not included in the live unit prices returned from City Plumbing.
Why are my prices different from another account's?
Why are my prices different from another account's?
Your prices depend on your City Plumbing contract, deals, and account type, so they can differ between accounts. Raise any price discrepancies directly with City Plumbing.
Why can't I see a live price for a part?
Why can't I see a live price for a part?
A live price won't show if the product code isn't recognized or if there's a network error. Hover over the warning icon to see the reason, update the product code if needed, and retry.