innovint_list_wineries
List wineries
List the connected winery with id, name and the user's permissions. Hosted connections and scoped stdio return only the selected winery; unscoped stdio lists all accessible wineries. GET /api/v1/wineries or /api/v1/wineries/{wineryId}.
Parameterslimitoffset
innovint_get_winery
Get winery
One winery by id: name, internal id and the token user's permissions there. GET /api/v1/wineries/{wineryId}.
Parameterswinery_idrequired
innovint_list_lots
List lots
List the winery's lots (wine, juice, fruit or case-goods batches) with code, name, stage, color, type, tax class, volume, weight, bottles on hand and tags. Filter by search term, code, id, bond, archived state or last update. GET /api/v1/wineries/{wineryId}/lots.
Parametersqid_inlimitoffsetbond_incode_inarchivedwinery_idrequiredupdated_afterupdated_before
One lot by id with its stage, volume, weight, bottles on hand, tags and links to related data. GET /api/v1/wineries/{wineryId}/lots/{id}.
Parameterslot_idrequiredwinery_idrequired
innovint_get_lot_composition
Get lot composition
The lot's makeup composition (what it is made of), now or right after a given action. GET /api/v1/wineries/{wineryId}/lots/{lotId}/makeupComposition.
Parameterslot_idrequiredwinery_idrequiredafter_action
innovint_get_lot_components_summary
Get lot components summary
A summary of the lot's components. GET /api/v1/wineries/{wineryId}/lots/{lotId}/componentsSummary.
Parameterslot_idrequiredwinery_idrequired
innovint_list_lot_analyses
List lot analyses
Lab and in-house analysis results recorded on a lot (pH, TA, free SO2, Brix, VA, ...). Filter by analysis type slug, vessel or date range. GET /api/v1/wineries/{wineryId}/lots/{lotId}/analyses.
Parameterssortlimitlot_idrequiredoffsetvesselswinery_idrequiredanalysis_typerecorded_afterrecorded_beforeis_lot_composite
innovint_list_lot_additives
List lot additives
Additives that have been added to a lot. GET /api/v1/wineries/{wineryId}/lots/{lotId}/additives.
Parameterslimitlot_idrequiredoffsetwinery_idrequired
innovint_list_lot_costs
List lot costs
Cost data per lot as of a date. Filter by lot code or id. GET /api/v1/wineries/{wineryId}/lotCosts.
Parameterslimitlot_inoffsetcode_inwinery_idrequiredeffective_atmodified_after
innovint_list_vessels
List vessels
List tanks, barrels and other vessels with their codes and current contents. Filter by search term, code, id, lot or archived state. GET /api/v1/wineries/{wineryId}/vessels.
Parametersqid_inlimitlot_inoffsetcode_inarchivedwinery_idrequired
innovint_list_vessels_at_point_in_time
List vessels at a point in time
Preview (vendor contract may change): What every vessel held at a past date-time (history of cellar contents). GET /api/v1/wineries/{wineryId}/vesselsAtPointInTime.
Parametersqlimitoffsetwinery_idrequiredvessel_typeeffective_atrequired
innovint_list_actions
List actions (work history)
The winery's work history across all action types (additions, analyses, transfers, racking, blending, bottling, fruit receiving, ...), filterable by type, state, reference number and dates. Each record has the action type, effective date and the lots and vessels involved; use the typed list tools for full detail of one kind. GET /api/v1/wineries/{wineryId}/actions.
Parametersidsortlimitstateoffsetwinery_idrequiredaction_typecreated_afterupdated_aftercreated_beforeupdated_beforeeffective_after+2 more
innovint_list_analysis_actions
List analysis actions
Analysis actions: the lab and in-house results entered in the winery, with the analyses (type, value, unit) and the lots and vessels they were taken on. GET /api/v1/wineries/{wineryId}/actions/analysisActions.
Parametersidsortlimitstateoffsetwinery_idrequiredcreated_afterupdated_aftercreated_beforeupdated_beforeeffective_aftereffective_before+1 more
innovint_list_addition_actions
List addition actions
Addition actions: what additives were added to which lots and vessels, and when. GET /api/v1/wineries/{wineryId}/additionActions.
Parametersidsortlimitstateoffsetwinery_idrequiredcreated_afterupdated_aftercreated_beforeupdated_beforeeffective_aftereffective_before+1 more
innovint_list_transfer_actions
List transfer actions
Transfer actions: racking, filtering, topping off, barrel-down and other transfers between vessels. GET /api/v1/wineries/{wineryId}/transferActions.
Parametersidsortlimitstateoffsetwinery_idrequiredaction_typecreated_afterupdated_aftercreated_beforeupdated_beforeeffective_after+2 more
innovint_list_adjustment_actions
List adjustment actions
Adjustment actions: volume or weight changes, water adds and makeup changes. GET /api/v1/wineries/{wineryId}/actions/adjustmentActions.
Parametersidsortlimitstateoffsetwinery_idrequiredaction_typecreated_afterupdated_aftercreated_beforeupdated_beforeeffective_after+2 more
innovint_list_receive_fruit_actions
List fruit receiving actions
Fruit receiving actions (harvest intake) with the fruit received and the lots created. GET /api/v1/wineries/{wineryId}/actions/receiveFruitActions.
Parametersidsortlimitstateoffsetwinery_idrequiredcreated_afterupdated_aftercreated_beforeupdated_beforeeffective_aftereffective_before+1 more
innovint_list_analysis_types
List analysis types
The analysis types InnoVint knows (pH, TA, free SO2, Brix, ...), with the slug that innovint_create_analysis_action and the analysis filters need. GET /api/v1/analysisTypes.
Parametersqsluglimitoffset
innovint_list_additives
List additives
The winery's additive products and their batches. GET /api/v1/wineries/{wineryId}/additives.
Parametersqtagsid_inlimitoffsetarchivedwinery_idrequiredproduct_name_in
innovint_list_vineyards
List vineyards
The winery's vineyards (grower sources). GET /api/v1/wineries/{wineryId}/vineyards.
Parametersid_inlimitoffsetwinery_idrequired
innovint_list_blocks
List vineyard blocks
Vineyard blocks of the winery's vineyards. Filter by vineyard. GET /api/v1/wineries/{wineryId}/blocks.
Parametersid_inlimitoffsetarchivedwinery_idrequiredvineyard_in
innovint_list_growers
List growers
The growers the winery buys fruit from. GET /api/v1/wineries/{wineryId}/growers.
Parametersidlimitoffsetwinery_idrequired
innovint_list_grower_receipts
List grower receipts for a vintage
Fruit receipts from growers for one vintage (year). GET /api/v1/wineries/{wineryId}/growerReceipts/{vintage}.
Parameterslimitoffsetvintagerequiredwinery_idrequired
innovint_list_vendors
List vendors
The winery's vendors (suppliers of additives, dry goods, services). GET /api/v1/wineries/{wineryId}/vendors.
Parametersnamesortid_inlimitoffsetwinery_idrequiredname_contains
innovint_list_bonds
List bonds
The winery's bonded premises (TTB bonds), whose ids lots belong to. GET /api/v1/wineries/{wineryId}/bonds.
Parameterslimitoffsetwinery_idrequired
innovint_create_analysis_action
Record analysis results
WRITE: records analysis results (e.g. pH 3.45, free SO2 28 mg/L) as a new analysis action in the winery's InnoVint records, effective at the given time. Each result needs an analysis type slug (innovint_list_analysis_types), a value and a unit, and a lot (add a vessel for a vessel-level result; without a vessel it is a lot composite result). The new action shows up in the cellar history and feeds lot data and reports; InnoVint's API has no delete here, so only call this when the numbers are confirmed. POST /api/v1/wineries/{wineryId}/actions/analysisActions.
Parametersnoteanalysesrequiredwinery_idrequiredpanel_nameeffective_atrequired
innovint_create_vendor
Create vendor
WRITE: adds a new vendor (supplier) by name to the winery's InnoVint records. Check innovint_list_vendors first to avoid a duplicate. POST /api/v1/wineries/{wineryId}/vendors.
Parametersnamerequiredwinery_idrequired