Skip to main content
All documentation

Supply โ€” offering availability

A supply entry is a producer or processor saying: "I will have this much of this commodity available during this window, at this price." Supply is the forward primitive of OnlyTons โ€” it is about availability across dates, not stock on a shelf.

Only organizations that are producers or processors can post supply.

Posting supply

From Supply โ†’ New, you choose the commodity and fill in:

  • Quantity and unit (kg, t, L, units).
  • Availability window โ€” a date range (start โ†’ end). This is the heart of the entry: it says when the goods will be available. A range that starts in the future is forward supply (a promised harvest).
  • Lead time (optional) โ€” days of notice you need before delivery.
  • Pricing โ€” see Pricing modes below.
  • Organic certification (optional) โ€” link one of your organization's certifications; this is what qualifies the entry as organic (see Organic qualification).
  • Attributes โ€” the commodity-specific fields (protein %, variety, โ€ฆ) appear automatically.
  • Traceability note and general notes (optional).

You can save a draft (not visible to matching) or publish (active, and eligible for matching).

Pricing modes

  • Fixed price โ€” a per-unit price (e.g. โ‚ฌ0.8525 / kg). Everyone sees it.
  • On request โ€” no visible number; the price shows as "On request" to everyone except the broker and your own organization. Use this to keep pricing private and route negotiation through the broker.
  • Indexed โ€” priced against an external index (recorded as on-request-style for display).

Per-unit prices are stored as exact decimals with an explicit currency, so sub-cent precision is preserved.

Organic qualification

Linking an organic certification does not automatically make an entry organic. OnlyTons recomputes qualification on the server every time you save, using the organic gate:

An entry is organic-qualified only if the linked certification is an organic scheme (EU Organic, Bio, or Demeter), is active, and its validity covers the entire availability window.

So if your certificate expires in October but your window runs into November, the entry is not organic-qualified โ€” the form warns you as you set it up, and publishing anyway stores it as non-organic. This is deliberate: an organic claim must hold for the whole time the goods are on offer. See Certifications & verification.

The availability timeline

On each commodity's page, all supply is drawn on a single time axis:

  • Past windows are dimmed (expired / fulfilled).
  • Current windows (spanning today) are solid.
  • Forward windows are striped and carry a "Forward" badge.
  • A "today" line marks the present.

This is the screen that makes forward planning tangible: a buyer can literally see September's harvest availability forming across several producers. On-request prices are masked here for anyone who isn't the broker or the owning org.

Supply lifecycle

A supply entry moves through these states:

draft โ”€โ”€โ–ถ active โ”€โ”€โ–ถ reserved โ”€โ”€โ–ถ committed โ”€โ”€โ–ถ fulfilled
             โ”‚  โ–ฒ          โ”‚             โ”‚
             โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ (deal released / cancelled returns it to active)
             โ”œโ”€โ”€โ–ถ withdrawn
             โ””โ”€โ”€โ–ถ expired  (past its availability end)
  • draft โ€” saved but not published; invisible to matching.
  • active โ€” published and eligible for matching.
  • reserved โ€” attached to a deal that's being coordinated (the deal reserved it). If that deal is released or cancelled, it returns to active.
  • committed โ€” the deal reached agreed; the supply is committed to it.
  • fulfilled โ€” the deal was delivered.
  • withdrawn โ€” you took it off the market.
  • expired โ€” its availability window has passed.

You (or the broker) can withdraw an active entry. Reservation and commitment happen automatically as the deal it's part of advances โ€” you don't manage those by hand. A withdrawn or expired entry stays that way even if a deal it was never part of changes around it.


Next: Demand ยท Back to index