Surplus logo
Surplus Docsby Sharing Excess
GuidesAdmins

Hub collections

When a donor drops food off directly at a hub (rather than having it picked up on a route), you record it as a hub collection (also called a market collection or onsite collection).

Creating a hub collection

From the hub's Collections tab:

  1. Tap Create collection
  2. Select the donor and donor location
  3. Add donation lines — for each product, enter the product type, quantity, and weight
  4. Save and complete the collection
Creating a collection at a hub (desktop)
Creating a collection at a hub (mobile)

The collections list

The collections tab shows all collections at this hub — both completed and scheduled. Each entry shows the donor, date, and total weight.

Hub collections list (desktop)
Hub collections list (mobile)

Editing a collection

Open a completed collection to edit its details:

  • Adjust donation line quantities and weights
  • Add or remove product lines
  • Update donor information
  • Add attachments (photos, receipts)
Editing a hub collection (desktop)
Editing a hub collection (mobile)

What happens when you save

When a hub collection is created and completed:

  1. Collection event items are created — the permanent donation receipt
  2. Items are created in hub inventory — one per donation line, status active, located at this hub
  3. These items are immediately available for sorting, allocation, or transfer

Correcting errors

If a collection was recorded with incorrect data:

  • Edit quantities/weights — adjustments cascade to item partitions while maintaining conservation
  • Delete lines — removes both the collection event item and its inventory item (only if the item hasn't been allocated or moved downstream)
  • Un-complete (admin) — returns the event to scheduled status; items remain but can be modified

Route collections vs hub collections

AspectRoute collectionHub collection
How food arrivesDriver picks up on a routeDonor drops off at hub
Who records itDriver at the stopHub staff in the hub UI
Where items goOn the route vehicle (routeId)In hub inventory (hubId)
Event typeroutemarket