Stock movements
What this page helps you do
Section titled “What this page helps you do”Stock Movements is the farm’s inventory ledger. It explains why a batch balance changed: a receipt brought stock in, farm work consumed it, a count corrected it, a transfer moved it, or a disposal removed it. Use this page when a displayed balance does not match your expectation, when checking who recorded a change, or when tracing medicine and feed use back to its source record.
The page is an advanced Inventory destination available through Manage or Farmlync search. It is a read-only history: correct the source event or use the appropriate inventory action instead of editing a ledger row.
Choose the period
Section titled “Choose the period”The page initially shows movements from the last 30 farm-local days. This bounded view keeps a busy farm’s ledger quick to open.
| Control | Accepted value and effect |
|---|---|
| From | Optional farm-local start date. The selected day is included. |
| To | Optional farm-local end date. The whole selected day is included. It must be the same as or later than From. |
| Last 30 days | Restores the normal rolling period. |
| Show all | Removes the date boundary and searches all retained movements. Use product and type filters on a long-running farm to keep the result manageable. |
Changing either date leaves Show all mode and returns to page one. Farmlync interprets the boundaries in the selected farm’s timezone, even when the person viewing it is elsewhere.
Filter the ledger
Section titled “Filter the ledger”| Control | How to use it |
|---|---|
| All Categories | Choose a current backend-provided stock category, such as Health, Feed or Supplies. The exact list follows the farm catalog. |
| All Items | Type to search active products by name or code, then select one. Farmlync loads up to 50 matching products for each search. A chosen category narrows these results. An inactive historical product is not offered as a new selection in this control. |
| All Types | Choose Receipt, Consumption, Adjustment, Expired, Return, Transfer, Disposal or WriteOff. |
| Page controls | Results are server-paged at 20 movements per page. Any filter change returns to page one. |
If a selected product does not belong to a newly selected category, Farmlync clears the product selection rather than applying an impossible filter. The filters and page are stored in the URL, so a copied link can reopen the same ledger view, subject to current access and retained data.
Understand movement types
Section titled “Understand movement types”| Type | What it means in the ledger |
|---|---|
| Receipt | Stock entered the farm through a saved batch receipt or delivery. Farmlync derives this incoming row from the received batch, so the receipt and ledger cannot drift into duplicate records. |
| Consumption | Stock left a batch because it was used, for example by a treatment, vaccination, feeding event or recorded manual use. |
| Adjustment | An authorised count or correction added or removed stock. Open the details and read the reason and notes before relying on it. |
| Expired | Farmlync marked a batch expired after its labelled expiry date passed in farm-local time. This is a zero-quantity marker: it blocks issue but does not pretend the physical stock vanished. A later disposition removes it from on-hand quantity. |
| Return | Stock was put back into a batch by the workflow that originally used or reserved it. Follow the source reference and notes to understand the reason. |
| Transfer | Stock moved between locations or farms. A same-farm location move has an outgoing entry for the source batch and an incoming entry for the destination batch; total farm stock is unchanged. |
| Disposal | Regulated health stock was disposed of or returned to a supplier through the disposition workflow. Details may include method, recipient and external reference. |
| WriteOff | Stock was removed as an inventory loss under a write-off workflow. |
Farmlync may also display a ConsumptionReversal entry created when a source operation is cancelled. The movement details identify the original entry it cancels. The current All Types list does not include ConsumptionReversal, so locate it with the product and date filters rather than expecting a dedicated reversal filter.
Read the table
Section titled “Read the table”The desktop table shows the following columns. Use the column control to hide optional columns; Farmlync remembers the choice for this farm.
| Column | Meaning |
|---|---|
| Date | When the movement occurred, shown as a farm-local date. Open the row for the precise local time. |
| Product | Product name and code from the farm catalog. This column always remains visible. |
| Category | Product category at the time of the query. |
| Batch # | Batch identifier, when one was recorded. |
| Type | The movement kind described above. |
| Quantity | Farmer-facing direction and amount. + means stock came in; − means stock went out. A zero Expired marker changes availability rather than physical quantity. The current ledger does not show the product unit beside the number; confirm it on Product Detail or the product label before comparing unlike products. |
| Reference | Human-readable source context where available. Treatment use is enriched with the animal and a profile link. Other source types may display their type and technical identifier rather than a named farm record; the reference may be absent for a standalone manual movement. |
| Notes | Saved explanation plus View movement details. Notes can carry operational evidence; read them before treating an adjustment as an error. |
The mobile card presents the same core product, batch, type, category, date, quantity, reason/source, reversal marker and notes in a compact layout.
Open movement details
Section titled “Open movement details”Choose View movement details on a row or mobile card. The panel shows:
- product and batch;
- movement type and exact farm-local date/time;
- signed quantity, with + for stock in and − for stock out; the panel currently does not repeat the product unit;
- the saved manual-use or adjustment reason, when present;
- the person who performed the action, when Farmlync can resolve that user;
- source type and reference; a treatment source can include a link to the affected animal, while other source types may retain their technical identifier;
- whether the row reverses an earlier movement;
- full notes with line breaks preserved; and
- disposition type, method, recipient and document/reference number when the movement came from regulated disposal.
Not recorded or Not available means the source record did not supply that value or it can no longer be resolved. It does not mean that Farmlync has inferred a value.
Follow a reversal
Section titled “Follow a reversal”A reversal preserves both sides of the correction rather than rewriting history.
- Open the reversing row.
- Read Reversal of to identify the original movement.
- If the original is present on the current page, select its descriptive link to open it in the same details panel.
- If it is outside the current page, Farmlync shows its full transaction identifier for traceability. Narrow the product, date and type filters to locate the surrounding activity.
On the table, a compact cancels #… marker appears when the reversal points to an original movement. The shortened identifier is only a navigation aid; the detail view retains the complete identity where needed.
Investigate a balance difference
Section titled “Investigate a balance difference”- Confirm the selected farm and the physical product label.
- Filter All Items to the product and set a date range beginning before the last known correct count.
- Compare Receipt rows with supplier documents and Deliveries. Product and batch names are currently labels rather than direct navigation links, so open the corresponding Inventory page separately.
- Review Consumption sources against treatments, vaccinations, feeding events or other farm work.
- Pair incoming and outgoing Transfer entries and confirm their source/destination notes.
- Inspect Adjustment, Disposal, WriteOff, Expired and reversal details for reasons and evidence.
- Compare the resulting trail with Product detail and the physical batch in Stock Batches.
- If the physical count is still different, use the documented stock-take or adjustment workflow and state the real reason. Do not create an unrelated receipt or consumption simply to force a balance.
Access and empty results
Section titled “Access and empty results”You need inventory viewing permission for the selected farm. If the list is empty, widen the date range, clear product/category/type filters and confirm the farm. A genuinely unused product has no movement history until a batch is received or another stock action is recorded. If From is later than To, the service rejects the range and the current page shows its general loading error rather than a field-level date message; correct the dates and try again.
The page does not provide an on-screen CSV export. A technical inventory-transaction export endpoint exists, but it is not exposed here and does not currently mirror this screen’s category filter, farmer-facing direction, farm-local timestamp or full audit details. Treat the portal ledger and its details panel as the supported investigation view. Organisation-wide data export is a separate administration workflow; do not look for an export button in this ledger.