Skip to main content

Error when receiving a Purchase Order (Housecall Pro Users)

Housecall Pro users only - this error appears during PO reconciliation when a material is assigned to a parent category instead of a leaf (deepest) category.

This error appears when you try to receive or reconcile a purchase order and one or more materials on that PO are assigned to a parent category in your catalog instead of a leaf (deepest) category. Housecall Pro blocks the sync until this is fixed.

Notion Image

When reconciling or receiving a Purchase Order in Ply, you may see an error while sending materials to a job or fleet location. This usually happens during the reconciliation / receiving flow and prevents the PO from being completed.

One common cause of this reconciliation error is how a material is assigned within the category structure. Housecall Pro only allows materials to sync when they are assigned to a leaf (deepest) category.

If a material is assigned to a parent category, Housecall Pro blocks the update and Ply surfaces this error during reconciliation.


Why this happens

This typically occurs when:

  • A material in Ply is assigned to a parent category instead of a leaf category

  • Less commonly, the material is not properly mapped as part of the Housecall Pro integration

This is expected behavior from Housecall Pro and needs to be fixed in Ply, not directly in HCP.


How to fix it (step by step)

1️⃣ Identify the material causing the error

  1. Open the Purchase Order where the reconciliation error appears

  2. Look for the material that failed during reconciliation or receiving

  3. Take note of:

    • Material name or item number

    • The category currently assigned to it

    Notion Image


2️⃣ Check the category structure in Ply

  1. Go to Settings → Catalog → Categories

  2. Search for the category currently assigned to the material

  3. Check whether the category is a parent or a leaf (deepest) category

How to tell the difference:

  • If the category can be expanded (shows an arrow), it’s a parent category

  • If it cannot be expanded, it’s a leaf category

Notion Image


3️⃣ Update the material to a leaf category

  1. Go to Catalog → Materials

  2. Open the material that’s failing

  3. Click Edit

  4. Change the Category to a leaf (deepest) category under the correct branch

  5. Click Save

Notion Image
Notion Image

Important notes:

  • This change must be made in Ply

  • You do not need to update anything directly in Housecall Pro

  • Any valid leaf category will work, as long as it has no subcategories


4️⃣ Retry the reconciliation

  1. Go back to the Purchase Order

  2. Retry the reconciliation or receiving action

  3. If needed, run a category resync and try again


✅ Quick checklist

Before retrying the reconciliation, confirm that:

  • The material is assigned to a leaf (deepest) category

  • The material changes were saved

  • The reconciliation or receiving action was retried


Still need help? Contact Support!

Still seeing this error after following the steps? Our support team can trace the specific material and category causing the issue

.

Did this answer your question?