Product detail

What this page helps you do

The Product detail page brings one farm product’s definition and operational history together. Open it from Animal Health, Feed Stock or Farm Supplies, or immediately after saving a new product. Use it to answer four different questions without confusing them:

1. What product is this and how is it configured?
2. How much usable stock is available, and where is each batch?
3. What has been received or used?
4. Does the product need correction, movement, disposal or replenishment?

The back link returns to the matching category list. Edit opens this exact product in the Products catalogue editor. Editing changes its definition and defaults; it does not change a physical batch balance.

A user with View inventory can read this page. Editing the product, receiving, adjusting, moving or disposing stock, changing purchasing defaults and adding a purchase-list item require Manage inventory. Feed nutrition is governed separately by Manage feed catalogue. The current page can still display some of these controls to a read-only user; the server refuses the save. Do not treat a visible button as evidence that your role can complete the operation.

Read the product heading

The heading shows the product Name, category or subcategory, manufacturer and code. When saved, GTIN, regulatory identifier and tags appear underneath. Check these values before receiving or adjusting stock so that a similarly named product is not used by mistake.

For a Health product, a warning appears when its subcategory is missing or is neither Medicine nor Vaccine. Farmlync can still stock and count that product, but it cannot appear in treatment or vaccination recording until the correct subcategory is saved.

Stock on hand

This section opens automatically for a stock-tracked product.

Display	Meaning
Large quantity	Available quantity in the product’s base unit. Expired and quarantined stock are excluded from this usable balance.
No stock received yet	No retained batch exists. This differs from an established stock balance of zero.
Out of stock	At least one retained batch exists, but available quantity is zero.
Below reorder	Available quantity is strictly below a positive reorder level. This raises a restock job on the Work board.
Expired badge	Quantity still physically recorded in expired batches. It remains visible until a disposal or supplier return is recorded.
Quarantined badge	Quantity physically present but blocked from normal use.
By location	Appears when stock is held in more than one location. Each location’s usable balance is shown, with expired and quarantined amounts called out separately.

The Low feed stock alert uses forecast days of cover. It is a different signal from the fixed reorder level, so the alert and Below reorder badge can legitimately disagree.

Feed such as grazed, fresh-cut or contractor feed can be marked Not stock-tracked. For those products Farmlync records intake and cost but does not keep an on-hand batch ledger. Receive and batch actions are therefore absent.

Read the batch list

Batches shown on this page are ordered by earliest expiry, with a batch without an expiry after dated batches. Each row shows its batch or lot identifier, storage location, recorded quantity and expiry. An expired date is red; an expiry within 30 days shows the number of days remaining.

The detail request retrieves at most 200 of the most recently received batches and then orders that subset by expiry. When it says the list is truncated, the totals above still cover all retained batches, but an older retained batch can be absent even if it has an earlier expiry. Use Stock Batches and Stock movements for the full register and ledger.

Actions depend on the batch’s current state:

• Move location and Send farm appear only for an Available batch with stock remaining.
• Dispose / write off appears for Expired or Quarantine stock. The regulated disposition save currently accepts Health stock only; the page can nevertheless show the action for blocked Feed or Supplies stock, which the server then refuses.
• Farmlync reloads the selected batch before opening one of these actions so a stale quantity or version is not silently used.

Move stock within this farm

Move location changes where part or all of one batch is stored. It does not transfer ownership to another farm.

Control	Accepted value and effect
Destination location	Required active location other than the current location. Add another stock location first if none is available.
Quantity	Greater than zero and no more than the batch’s available, unreserved quantity. The form starts with the full available quantity.
Moved at	Required farm-local date and time; initially the current farm time. The current save path does not reject a future time even though the physical stock balance changes immediately.
Reason	Required, 2–200 characters. State the physical reason, for example moving medicine to a fridge.
Notes	Optional audit detail, up to 500 characters.

Saving records a stock movement and refreshes the displayed balances. Use Send farm for a real farm-to-farm transfer; its receiving farm, transport and evidence controls are explained in Stock takes and farm-to-farm transfers.

Dispose or return blocked stock

Use Dispose / write off only for the selected expired or quarantined batch. The form starts with the batch’s remaining quantity.

Control	Accepted value and effect
Outcome	Disposed or Returned to supplier. The final action label changes to match.
Quantity	Greater than zero and no more than the batch’s current on-hand quantity.
Date	Required farm-local disposition date; initially today. A future date is rejected. The current save path does not compare this date with the batch receipt date, so confirm that the disposition did not occur before receipt.
Method	Required: Licensed waste contractor, Returned through vet or pharmacy, Supplier collection, Approved on-farm method, or Other documented method.
Supplier / recipient or Contractor / recipient	Required organisation accepting or witnessing the stock; maximum 200 characters.
Document reference	Required return, credit, waste-transfer or equivalent evidence reference; maximum 200 characters.
Notes	Optional segregation, collection or other evidence; maximum 1,000 characters.

Saving creates a permanent disposition record and reduces the affected batch. Keep the physical evidence referenced by the record.

Receive, correct or replenish stock

Action	What it does
Receive new batch	Opens a receipt with this product and category already selected. Enter the actual delivery, batch, expiry, location, supplier and cost evidence. See Deliveries.
Adjust stock	Adds or removes quantity through an audited adjustment. It is for a verified discrepancy, not ordinary use, receipt or disposal.
Add to purchase list	Adds a replenishment proposal. When Farmlync has no positive recommendation, it asks for a positive quantity in the product’s base unit and an optional note of up to 240 characters. It does not place an order or receive stock.

Adjust stock fields

The picker is restricted to available batches for this product. When only one usable batch exists, Farmlync selects it; with several batches, choose the batch you physically checked.

Control	Accepted value and effect
Stock Batch	Required available batch belonging to this product. The portal picker enforces that rule. The server currently does not repeat the batch-status rule for a direct client.
Direction	Add increases the recorded batch balance; Remove decreases it.
Reason	Optional structured reason: Count correction, Expired, Spoilage, Breakage, Spillage, Contamination, Loss or theft, Returned to supplier, or Other. Use the most accurate reason. It is currently optional even for regulated Health stock.
Quantity	Required number greater than zero, in the product’s base unit. The server rejects a removal above the physical on-hand balance, but currently does not subtract reserved quantity when deciding the removable amount.
Notes	Optional explanation, maximum 500 characters. Include the physical count or supporting reference when useful.

After saving, verify the page’s available, blocked and location balances and inspect Stock movements. Do not use an adjustment to hide a missed treatment, feeding event, receipt, transfer or disposal.

Category-specific information

Feed nutrition

A Feed product shows Dry matter, Crude protein and Metabolisable energy. Choose Add nutrition or Edit nutrition when your permission allows it.

Field	Accepted value
Dry matter (%)	Optional number from 0 to 100.
Crude protein (%)	Optional number from 0 to 100.
Metabolisable energy (MJ/kg)	Optional number of zero or greater.

Blank values remain unset. If someone changes the nutrition record while your form is open, Farmlync keeps your unsaved draft and offers Reload latest values; review before entering the change again.

Medicine withdrawal

A Health product with subcategory Medicine shows default Milk and Meat withdrawal days and badges for Requires prescription, Antibiotic and Controlled substance. These are product defaults used by clinical recording; they are not evidence that an individual animal has completed a withdrawal. Edit incorrect defaults through Edit, and check the animal’s treatment and active withdrawal record before milk or meat enters the supply chain.

Purchasing and planning

The section shows the Preferred supplier, Default receipt location and the current protocol-demand explanation. Not yet quantifiable means Farmlync cannot convert configured protocol demand into a reliable purchase quantity; it does not mean that no product will be needed.

Choose Edit purchasing defaults to set or clear:

• Preferred supplier — a saved party with Supplier role.
• Default receipt location — an active farm stock location.

These values prefill orders and receipts. They are defaults rather than locks, so a purchaser can choose a different supplier or location on an individual transaction.

Recent usage

This section opens automatically and shows the first 12 entries from a server result that currently retrieves up to 50. The page does not identify the hidden count or provide a link to the rest. Each visible row gives the farm-local date, quantity and unit, plus the reason or notes. Treatment use links the animal tag to that animal’s page. Feed usage without an animal is labelled Feeding. An empty section means no usage was returned for this product; it does not prove that no physical stock has left the store outside Farmlync.

Purchase history and receipt evidence

Expand Purchase history to review receipts. A row shows either the package calculation or total received quantity, supplier/reference/batch/location context, cost, received date and notes. Receipt evidence loads documents for that receipt only; choose a file to open it in a new browser tab. A dash for cost means that no usable cost was stored, not that the delivery was free.

Cost

Expand Cost to see:

• Avg unit cost — calculated cost per saved base unit when available.
• Stock value — current recorded stock value. The service distinguishes a known zero (no usable stock) from unknown value (usable stock without cost), but the current page renders both as a dash.
• Spent YTD — recorded spend during the current year; zero is displayed as a dash.
• Treatments YTD for medicine, or Uses YTD for other products — the number of recorded uses, not the quantity consumed.

Cost and usage are derived from saved Farmlync transactions. Missing receipts, omitted costs or activity recorded outside Farmlync make these figures incomplete.

Before leaving the page

1. Confirm the product identity and base unit.
2. Separate usable stock from expired or quarantined quantities.
3. Check the actual batch and physical location before acting.
4. Use the action that describes what happened; avoid a generic adjustment when a receipt, use, move, transfer or disposal applies.
5. After saving, verify the updated quantity and follow the transaction, clinical or purchasing workflow as needed.