Articles in this section

How to Set Up Ad Hoc Charges for Work Orders in 3PL Billing

Ad-hoc charges let you bill a 3PL client directly from a work order's detail page in ShipHero. Use them to add per-hour, per-unit, or per-order charges for work completed — these flow automatically into the client's 3PL Billing portal when the work order is marked Done, and appear on their next generated invoice.

Before You Begin

  • Permission Requirements: Only ShipHero users with "Billing" or "Admin" permissions can add ad-hoc charges.
  • Active Work Orders Only: Ad-hoc charges can only be added to work orders that are in an "Open" or "In Progress" status in ShipHero.
  • Completed Work Orders: Once a work order is marked "Complete" or "Done", the system prevents adding new charges. To add ad-hoc charges to a work order with a Done or Completed status, you need to click Re-open the work order, add the new charge, and then re-close it.
  • Invoice Generation: Ad-hoc charges from the work orders page are added to the client's 3PL Billing portal after the work order status is updated to "Done" or "Complete", and will be included in the next invoice that is generated.
  • Editing and deleting ad-hoc charges: Ad-hoc charges added via the work order page do not have an active sync after being sent to the 3PL billing portal. Edits or deletions made to an ad-hoc charge after re-opening a work order do not update the ad-hoc charge in the 3PL billing portal and vice versa.

    If adjustments need to be made to an existing ad-hoc charge, you must complete the edit on both platforms: the work order page and the customer's current ad-hoc charges section of their 3PL billing page.

If you are tracking labor hours for a work order using WorkforceHero, those hours are sent to the Ad-hoc charges section automatically. See Billing Special Projects via Work Orders for details.

Adding an Ad-Hoc Charge on the Work Order Page

Using the Ad-hoc charges section on the work order's details page allows your accounting team and 3PL customers to cross-reference completed work easily.

  1. Open the work order's details page and click the "Add new charge" button in the Ad-hoc charges section.
  2. Fill in the required information:
    • Select the Unit: Per hour, Per unit, or Per order
    • Description of the charge (optional)
    • Quantity of the units to be charged
    • Rate to charge for each unit
  3. Review the information for accuracy.
  4. The information entered per charge is automatically saved on the work order and a note is added to the work order's timeline for each edit made.
  5. If you need to add multiple ad-hoc charges to the same work order you can do so by selecting the Add new charge button and repeating the steps as needed.
  6. Once all the charges have been added, update the work order status to Complete by using the Mark as done button.
Work order detail page showing the Ad-hoc charges section with the Add new charge button Ad-hoc charge form showing Unit, Description, Quantity, and Rate fields Work order detail page showing a saved ad-hoc charge with the Mark as done button

How Work Order Ad-hoc Charges Appear in 3PL Billing

When an ad-hoc charge is added via the work order page, the system automatically categorizes it in the 3PL Billing page as an ad-hoc charge and provides the specific details entered.

To review the ad-hoc charges added to your customer's account:

  1. Go to the 3PL Billing portal and open your customer's billing page by selecting their name. If you have multiple warehouses, be sure to open the corresponding customer page for the warehouse the work order was completed in.
  2. The ad-hoc charge will show in the Current Ad-hoc charges section and display the charge details, including:

    Column Name Definition
    Charge Work order ID
    Date When the work order status was updated to Done or Complete
    Unit Type of unit being charged
    Qty Number of units charged
    Unit rate Cost per unit charged
    Total Total cost of the ad-hoc charge: Quantity x Unit rate
    Current Ad-hoc charges section in the 3PL Billing portal showing charge columns for a work order
  3. The ad-hoc charges will be added to the next bill that is generated for the customer.

    3PL Billing invoice showing ad-hoc charges included in the customer's next bill

Troubleshooting

  • Charge Not Saving: Verify you have Billing or Admin permissions in ShipHero. Also confirm the work order is in an "Open" or "In Progress" status — charges cannot be added to a Done or Completed work order without reopening it first.
  • Charge Not Appearing on Invoice: Charges are only included in invoices generated after the work order is marked Done. If the invoice was already generated before the work order was closed, the charge will appear on the customer's next invoice instead.
  • Charge Updated in One Place but Not the Other: Ad-hoc charges do not sync between the work order page and the 3PL Billing portal after the work order is closed. If you edit or delete a charge in one place, you must manually apply the same change in the other.

More Resources

  • ShipHero Public API

    Connect your tools and AI agents directly to ShipHero with the Public API. Build powerful integrations, automate workflows, and tap into real-time data using the AI tools you prefer, with the option for secure, read-only access for AI-driven insights without added risk.

  • ShipHero Academy

    Explore ShipHero Academy for certifications, deep-dive training, and expert-led courses on WMS and fulfillment. Build your expertise and help your team operate at a higher level.

  • Change Log

    Stay up to date with the latest improvements across ShipHero. The Change Log gives you a clear view of new features, enhancements, and fixes as they roll out—so you always know what’s new and what’s better.