Supplies catalog

What it is

The supplies catalog is the screen where you log and maintain all of your supplies: every non-edible material with its cost per unit, its consumption unit, its supplier, and optionally its own fields. It's a per-user catalog (you create it; there's no global base like for ingredients) and it's the source recipes draw from when you add supplies.

It lives on a single screen: there are no sub-routes (/supplies/catalog, /supplies/categories…). Everything — search, filters, creating, editing, custom fields, and import/export — is run from here through modals.

Access path

• URL: https://app.areacacao.com/supplies
• How to get there: side menu → FORMULATION → Supplies.
• Availability: any signed-in user (no plan restriction).
• The old /insumos redirects here.

Screen sections

Header

At the top you'll find the Back to dashboard link and the Supplies catalog title, with a subhead showing the real count of supplies ("N supplies in your catalog") or, if you have none yet, "Packaging, labels, boxes and non-edible consumables".

To the right there are four buttons:

• New supply — opens the form to create a supply with its full sheet. See Create a supply.
• Manage categories — opens the panel to rename, delete, or add supply categories. See Supply categories.
• Custom fields — opens the manager to define your own supply fields (material, batch, certification…). See Custom fields.
• Import / Export — opens the modal to dump or load your catalog in CSV. See Import and export.

Filter bar

Above the table there's a bar with four controls:

• Search box with the placeholder "Search by name, code or supplier…". It searches by name, internal code (SKU), supplier reference, and supplier.
• Category selector with the default option All categories (loaded from your managed categories).
• Supplier selector with the default option All suppliers.
• Stock-tracked only — checkbox that limits the list to supplies with stock tracking on.

Changing any filter sends the list back to page 1.

Results table

Each row shows these columns:

Click any row to open the supply's detail sheet.

Pagination

The list shows 50 supplies per page. When there's more than one page, a footer appears with the visible range ("Showing X–Y of TOTAL") and the Previous page / Next page arrows.

Create a supply

Click New supply to open the form, with the subtext "Non-edible materials allocated per sellable product unit.". It's organized into sections:

• Identity — Name (required), optional Name (English), Category (see Categories), Description, Supplier, Supplier reference, and Internal code (SKU).
• Units & purchasing — the dual-unit model:
  • Consumption unit — the unit you'll use in the recipe (e.g. unit, sheet, metre).
  • Purchase unit — how you buy it (e.g. box of 500).
  • Consumption units per purchase unit — the factor (e.g. a box of 500 cup liners → 500). Used to compute the cost per consumption unit.
• Cost — Cost per consumption unit and the Cost breakdown bucket (where this cost is grouped: Supplies, Ingredients, or Overhead; defaults to Supplies).
• Stock (optional) — Track stock enables perpetual stock in the Warehouse, with a Low-stock alert.
• Additional information — Image URL, Notes, and any Custom fields you've defined.

Click Create supply to save it (or Save changes when editing).

Custom fields

Just like for ingredients, you can extend your supplies with your account's own fields (material, batch, certification…). Click Custom fields in the header to open the manager:

• The N fields defined list with each field (Label, Key, Type, Required) and edit/delete actions.
• New field opens an editor with Label (required), an internal Key in snake_case (auto-generated, not editable later), Type (Text, Number, Date, List, or Yes/No), Options (List only), Help text, and the Required field checkbox.

Deleting a field does not erase the values already captured on your supplies. Each field's values are filled in inside each supply, in the form's Additional information section.

Import and export

Click Import / Export to open the modal (subtitle "Bulk-create supplies or download your catalog."), with two tabs:

Import

• Download template gives you supplies-template.csv with the right columns.
• Provide the content by dragging a CSV, with Choose file, or by pasting it directly ("…or paste the content directly").
• The How to prepare the CSV disclosure reminds you of the key rules:
  • name is the only required column.
  • purchaseUnit, trackingUnit, and purchaseToTrackingFactor define the dual-unit model (you buy a "box of 500", you consume "unit").
  • costPerUnit is the cost per consumption unit, in euros.
  • costBucket accepts insumos, ingredientes, or overhead.
• The Mode selector decides how it's applied:

Before confirming you can Preview: it shows a summary like "N rows — create X, update Y, skip Z, errors W". Click Import to apply.

Export

Download your whole catalog as CSV (supplies.csv), one row per supply with every column. Custom-field columns are added with the cf_ prefix; the allergens field doesn't apply to supplies.

Cost history

Every time a supply's cost changes, AreaCacao records it. When you open the detail sheet (click a row) you'll see, alongside its general and unit data, a Cost history section with the date, the Before cost, the After cost, and a Note for each change. If there are no changes yet, it shows "No cost changes recorded yet.".

Screen states

• Loading: shows a table skeleton.
• Empty catalog: "You have no supplies yet" + "Add packaging, labels, cups, boxes or any non-edible material to include them in your recipe costs." with a New supply button.
• No results with filters: "No supplies match those filters.".
• Load error: red banner with "Could not load supplies".

Availability by plan

Available on all plans.

Next steps