Skip to main content
City Plumbing
Updated over a month ago

Connecting to your City Plumbing account enables live price checking for parts when raising purchase orders and seamless sending of electronic purchase orders. This integration enhances efficiency in managing supplier interactions and ensures accurate pricing for parts procurement.


Prerequisites

Commusoft

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.

Only one supplier in Commusoft can connect to City Plumbing.

Our Parts article will help you create and maintain your parts database.


City Plumbing

These are the requirements and considerations for your City Plumbing account:

  • Active Account: You must have an active City Plumbing account.

  • Account Verification: City Plumbing accounts are directly verified during the integration setup. Queries regarding account details should be addressed with City Plumbing directly.

  • Request a Parts List: Email [email protected] to request a supplier-specific parts and prices list.

  • Customer Pricing: Prices displayed depend on your City Plumbing account contract, deals, and account type.

  • Price discrepancies: Any price discrepancies must be addressed directly with City Plumbing.

  • Unit prices: VAT is not included in live unit prices.


Integration Setup

➡️ Navigate to the Profile icon > Click Integrations > Go to Suppliers > On City Plumbing, click Add Integration

  1. Enter Account Details: Provide your City Plumbing account number, username, password, postcode, and telephone number > Click Continue.

  2. Select Supplier: Search for your City Plumbing supplier name in Commusoft and select it from the results > Click Continue.

  3. You will receive a confirmation email to the email address in your company details.


Viewing live prices

Once the integration is confirmed, you can create purchase orders on a job or the supplier to view the live prices.

➡️ Add purchase order

  1. Type either the part name, MPN or product code

  2. Select the part from the list of results

  3. The product code is used to locate the live price from City Plumbing

Live prices are checked using the product code, not the product name.

Purchase orders can be created on a supplier or a job - Supplier details page | Create a purchase order for a job

Live price generated

  • A green star icon indicates the live price has been found for the selected part.

    city.png

Live price NOT generated

  • A warning icon will display if the product code cannot be recognised, or, if there is a network error. Hover over the icon to display the error.

    • If the product code is not recognised, update it and try again.

      city_2.png
    • If there is a network error, check the integration details are valid then wait for 1 hour before trying again.

  • Circular loading dots will display if there are temporary connection issues with Wolseley's API (retry in 30 minutes).

    image__3_.png

Live prices used on a PO will not update the stored supplier price in your parts database.


Send a purchase order

Purchase orders can be sent directly through Commusoft when integrated with City Plumbing.

➡️ Click Add purchase order

  1. Add line items with the type Part.

  2. Choose Collect from supplier and select the branch.

  3. Review to ensure all PO details are correct > Save

  4. Click Send to City Plumbing via Integration > Type Confirm > Submit.

Line item type Item is not supported, all line items must use the Part type.

Purchase orders generated from reorder templates will be sent automatically through the integration once created.

Sending failed

If your purchase order fails to send, you will receive a notification with an error reason. You will need to resolve the error before retrying.


Manage integration

➡️ Click Manage​ > View Account number

Disconnect

➡️ Click Disconnect > Type disconnect > Click Disconnect

Did this answer your question?