Agriax

Read saved seller, default receiving account, invoice preferences and today. Missing defaults must be supplied or configured; never fabricate them. Defaults do not prove VAT eligibility or agreed payment terms. Explicitly copy chosen values into a new draft; retain them on retries.

get_invoice_creation_options

Read a receipt and authenticated PDF URL. The user must sign in to Agriax to download; this is not a public sharing link.

get_receipt

Read your own running work session and elapsedMilliseconds calculated at server observedAt. Use this to answer how long you have worked this session and obtain session ID/version before clocking out. No running session returns NotFound.

get_running_work_session

Issue only an explicitly approved reviewed draft. Read get_invoice and show recipient, seller, rows, VAT, total and due date before approval to issue. Assigns legal number and freezes content/PDF; does NOT send or transfer money. Use reviewed expectedVersion. Keep original arguments/key on uncertain outcomes; never create a replacement invoice to recover from timeout.

issue_invoice

List sales receipts and refunds. Follow nextOffset to get all pages.

list_receipts

List all companies where the authenticated user currently has active membership, with their own role, employee reference and eligibility for own time reporting. Use before choosing a company for clock-in. If more than one company is eligible and the user has not selected one, ask which company; never choose the first arbitrarily. No eligible companies means clock-in is unavailable. This tool does not clock in or authorize a later write; permissions and employment must be checked again when acting.

list_my_companies

Read today, last payment method, default VAT and active products priced INCLUDING VAT. Search by query and follow nextOffset. Never silently choose between ambiguous products.

get_receipt_options

Receive stock only after explicit product and amount intent. Reuse the same idempotencyKey for retries. Atomic product creation/catalog copy and RECEIPT. locationId or explicitly requested newLocationName are mutually exclusive. If both omitted, use the sole existing location only; otherwise require selection, never invent a location. Optional lot must belong to resolved company product. Current manager authority is required even on replay. All returned quantities are base-unit values. No partial local product/location/stock/receipt writes on failure. TOTAL requires amount and unit, forbids package fields/count. PACKAGES requires positive integral count and exactly one of selected packagingId or explicit packageSize/packageUnit. Selected packaging defines its size in product base units. Explicit size never mutates existing packaging. Positive quantities only; exact base-unit conversion must fit six decimals and existing stock range. Ask whether ambiguous 150g means total or package size; ask size and count when amount is absent. Explicit 2 packages of 150g needs no additional confirmation. If a catalog selection reuses a company copy, a selected packagingId must still represent the same exact physical size; changed or missing packaging returns 409 CatalogPackagingChanged and requires company-product discovery. Explicit totals/package sizes retain their user-specified meaning. A non-exact or nearby product name MUST be confirmed with the user even when there is only one candidate (for example Premium Classic versus Premium Classic SX). Combine this question with missing size/count when useful. An exact product or ID already explicitly selected by the user requires no redundant confirmation. Never treat a single similar-name result as confirmed identity. An explicitly named alternative already approved by the user needs no further name confirmation when the stated condition is met (for example, use Premium Classic SX if that is the only match). This confirms product identity only, not missing quantity, package size, count or the receipt to reverse. Never guess or prefill a missing package count, including in a generated form. Leave an unknown count empty and require the user to supply it before receipt submission.

receive_inventory_stock

Only on explicit authorization after money has been returned: create a full negative receipt linked to the original. No partial refunds. Reuse idempotencyKey on retries.

refund_receipt

Record an actual received payment, not a bank transfer. First find the invoice. Select automatically only when exactly one match and hasMore is false; otherwise ask which invoice. Omitted amount pays remaining balance; omitted date uses today. Partial payments require amount. Preserve key and all arguments on uncertain outcomes. On VersionMismatch refresh and review; do not blindly repeat with another key.

register_invoice_payment

Cancel your own running or completed unpaid work session after an explicit request to remove it. This stops a running timer and excludes the session from totals and payment selection. It preserves a locked cancelled record and audit history; there is no hard deletion or undo. Never cancel paid time: its payment marking must first be reversed by an administrator. For a running session, get_running_work_session provides sessionId and expectedVersion. Never guess a historical session ID or version. Retain the original arguments and idempotency key after an uncertain result.

cancel_work_session

Record an activity change or note now on your own running work session using server time. Read get_running_work_session first for sessionId and expectedVersion. For an activity change such as starting feeding, use kind activityChange and activity; for a note use kind note and note. The same work session continues: this never pauses time, deducts breaks or creates customer work. Retain the original arguments and idempotency key after uncertain outcomes.

add_work_session_checkpoint

Reverse only an explicitly selected company RECEIPT. Current manager permission required even on replay. Append an exact opposite ISSUE at the same product/location/lot/unit and atomically store its immutable original link and idempotency response. Never delete or edit original history or product. A receipt may be reversed once across all actors/keys; another key after reversal returns 409 ReceiptAlreadyReversed. A non-RECEIPT returns 409 NotReversible. Negative resulting balances follow the existing ledger policy. No quantity or replacement identity is accepted. Use find_inventory_receipts when the target ID is not already explicit. Reuse the same idempotencyKey for retries. Ask for clarification if multiple receipts could match; do not invent or guess an ID. Successful reversal corrects stock only, leaving product/location and original history intact. A non-exact or nearby product name MUST be confirmed even for correction selection; never guess the original movement from a similar name. An explicitly named alternative already approved by the user needs no further name confirmation when the stated condition is met (for example, use Premium Classic SX if that is the only match). This confirms product identity only, not missing quantity, package size, count or the receipt to reverse. Require explicit user undo or correction intent. A technical timeout is not undo intent: retry the original operation with its original idempotency key first. Derive a concise reason such as mistaken receipt from the user's stated correction; do not ask an extra question just to phrase it when intent and movement are already clear.

reverse_inventory_receipt

Replace the COMPLETE editable draft after get_invoice. Replacement can discard existing fields or lines; no version-restore operation is available. Preserve fields not explicitly changed. On VersionMismatch read and review, never blindly overwrite. Issued invoices cannot be edited. Prices are NET excluding VAT. Retain original arguments/key on uncertain retries.

update_invoice_draft