Skip to main content
API docs by Redocly

Inventory API (1.0.0)

Download OpenAPI specification:Download

commodities

Retrieve commodities

Retrieve commodities

Authorizations:
jwt
query Parameters
countryISO
string

Filter by country

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Retrieve commodity specifications

Retrieve commodity specifications

Authorizations:
jwt
path Parameters
commodityType
required
string
Example: crop

Commodity type

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Retrieve commodity default specifications

Retrieve commodity default specifications

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

query Parameters
commodityGrade
string

Filter records by commodity grade

commodityType
string

Filter by commodity type

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Suggest commodities

Retrieve commodities based on input suggestions

Authorizations:
jwt
query Parameters
type
string

Filter by type

query
required
string

Free text search field for querying

Responses

Response samples

Content type
application/json
[
  • {
    }
]

configuration

Retrieve inventory configuration

Retrieve inventory configuration

Authorizations:
jwt

Responses

Response samples

Content type
application/json
{
  • "adjustmentReasons": [
    ]
}

movements

Search Movements Between Dates

Search Movements Between Dates

Authorizations:
jwt
query Parameters
limit
integer

Limit page size of results

offset
integer

Number of results to skip for the current page

sortBy
string

Sort results by this field

sortDesc
boolean

Sort results descending if true, otherwise ascending

startDateISO
string

Filter by start date ISO

endDateISO
string

Filter by end date ISO

f:type
string

Filter by type

f:commodity
string

Filter by commodity

f:commodityType
string

Filter by commodity type

f:commodityGrade
string

Filter records by commodity grade

f:status
string
Enum: "complete" "incomplete"

Filter by movement status

f:storageSourceId
string

Filter by movement source

f:storageDestinationId
string

Filter by movement destination

conflicts
boolean

Calculate conflicts if true

type
string
Enum: "intake" "internal" "outbound"

Filter by movement type

actions
boolean

Filter by movements requiring action

format
string

Format for the endpoint response, supports JSON (default) or CSV

Responses

Response samples

Content type
application/json
{
  • "totalDocs": 0,
  • "limit": 0,
  • "offset": 0,
  • "docs": [
    ]
}

Create A Movement

Create A Movement

Authorizations:
jwt
Request Body schema: application/json
recordId
required
string
organisationId
string
organisationName
string
movementDateISO
required
string
weight
required
number
object or null
required
object
object or null

Responses

Request samples

Content type
application/json
{
  • "recordId": "string",
  • "organisationId": "string",
  • "organisationName": "string",
  • "movementDateISO": "string",
  • "weight": 0,
  • "driver": {
    },
  • "destination": {
    },
  • "adjustment": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Create Movements

Create Movements

Authorizations:
jwt
Request Body schema: application/json
required
Array of objects
organisationId
string
organisationName
string
movementDateISO
required
string
object or null
required
object

Responses

Request samples

Content type
application/json
{
  • "records": [
    ],
  • "organisationId": "string",
  • "organisationName": "string",
  • "movementDateISO": "string",
  • "driver": {
    },
  • "destination": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Create A Movement

Create A Movement

Authorizations:
jwt
Request Body schema: application/json
recordId
required
string
organisationId
string
organisationName
string
movementDateISO
required
string
weight
required
number
sold
required
boolean
object or null
required
object
object or null

Responses

Request samples

Content type
application/json
{
  • "recordId": "string",
  • "organisationId": "string",
  • "organisationName": "string",
  • "movementDateISO": "string",
  • "weight": 0,
  • "sold": true,
  • "driver": {
    },
  • "destination": {
    },
  • "adjustment": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Create Movements

Create Movements

Authorizations:
jwt
Request Body schema: application/json
required
Array of objects
organisationId
string
organisationName
string
movementDateISO
required
string
sold
required
boolean
object or null
required
object

Responses

Request samples

Content type
application/json
{
  • "records": [
    ],
  • "organisationId": "string",
  • "organisationName": "string",
  • "movementDateISO": "string",
  • "sold": true,
  • "driver": {
    },
  • "destination": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Create A Harvest Plan

Create a harvest plan of planned movements from fields to stores

Authorizations:
jwt
Request Body schema: application/json
movementDateISO
required
string
recordIds
required
Array of strings
required
Array of objects

Responses

Request samples

Content type
application/json
{
  • "movementDateISO": "string",
  • "recordIds": [
    ],
  • "destinations": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Create A Harvest Plan

Create a harvest plan of planned movements from fields to stores

Authorizations:
jwt
Request Body schema: application/json
movementDateISO
required
string
required
Array of objects
required
Array of objects

Responses

Request samples

Content type
application/json
{
  • "movementDateISO": "string",
  • "records": [
    ],
  • "destinations": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Create A Harvest Plan

Create a harvest plan of planned movements from fields to an outbound organisation

Authorizations:
jwt
Request Body schema: application/json
movementDateISO
required
string
recordIds
required
Array of strings
required
Array of objects

Responses

Request samples

Content type
application/json
{
  • "movementDateISO": "string",
  • "recordIds": [
    ],
  • "destinations": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Create A Harvest Plan

Create a harvest plan of planned movements from fields to an outbound organisation

Authorizations:
jwt
Request Body schema: application/json
movementDateISO
required
string
required
Array of objects
required
Array of objects

Responses

Request samples

Content type
application/json
{
  • "movementDateISO": "string",
  • "records": [
    ],
  • "destinations": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Delete Movement

Delete Movement

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Request Body schema: application/json
recordId
string

Responses

Request samples

Content type
application/json
{
  • "recordId": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Edit Movement

Edit Movement

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Request Body schema: application/json
recordId
required
string
organisationId
string
organisationName
string
movementDateISO
required
string
weight
required
number
object or null
required
object

Responses

Request samples

Content type
application/json
{
  • "recordId": "string",
  • "organisationId": "string",
  • "organisationName": "string",
  • "movementDateISO": "string",
  • "weight": 0,
  • "driver": {
    },
  • "destination": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Edit Movement

Edit Movement

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Request Body schema: application/json
recordId
required
string
organisationId
string
organisationName
string
movementDateISO
required
string
weight
required
number
sold
boolean
object or null
required
object

Responses

Request samples

Content type
application/json
{
  • "recordId": "string",
  • "organisationId": "string",
  • "organisationName": "string",
  • "movementDateISO": "string",
  • "weight": 0,
  • "sold": true,
  • "driver": {
    },
  • "destination": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Update Movement Actions

Update Movement Actions

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Request Body schema: application/json
recordId
required
string
isComplete
boolean
object or null
object

Responses

Request samples

Content type
application/json
{
  • "recordId": "string",
  • "isComplete": true,
  • "driver": {
    },
  • "weighbridge": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Get Expired Movements

Get Expired Movements

Authorizations:
jwt

Responses

Response samples

Content type
application/json
{
  • "totalDocs": 0,
  • "limit": 0,
  • "offset": 0,
  • "docs": [
    ]
}

Apply Passed Movements

Apply Passed Movements

Authorizations:
jwt

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

records

Get Record

Get Record

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "status": "string",
  • "owners": [
    ],
  • "source": "planting",
  • "type": "crop",
  • "commodity": {
    },
  • "harvestYear": "string",
  • "isRecordInStorage": true,
  • "yield": {
    },
  • "storage": {
    },
  • "timeline": [
    ]
}

Update Record

Update Record

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Request Body schema: application/json
commodityGrade
number or null

Adjustment to commodity grade

harvestYear
string

Adjustment to harvest year

tags
Array of numbers
plantingAtUTC
string or null
plantingAtDateType
string or null
Enum: "date" "month"
plantingExpectedYield
number or null

Responses

Request samples

Content type
application/json
{
  • "commodityGrade": 0,
  • "harvestYear": "string",
  • "tags": [
    ],
  • "plantingAtUTC": "string",
  • "plantingAtDateType": "date",
  • "plantingExpectedYield": 0
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "status": "string",
  • "owners": [
    ],
  • "source": "planting",
  • "type": "crop",
  • "commodity": {
    },
  • "harvestYear": "string",
  • "isRecordInStorage": true,
  • "yield": {
    },
  • "storage": {
    },
  • "timeline": [
    ]
}

Get Records by id

Get Records by id

Authorizations:
jwt
query Parameters
ids
required
string

Comma separated list of ids

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create adjustments for one or more records

Create adjustments for one or more records

Authorizations:
jwt
Request Body schema: application/json
required
Array of objects

Array of records to adjust

Array of objects or null

A list of files to associate with the adjustments

reasonId
required
number

Reason for the adjustment, from dropdown of managed reasons

Responses

Request samples

Content type
application/json
{
  • "records": [
    ],
  • "files": [
    ],
  • "reasonId": 0
}

Response samples

Content type
application/json
[
  • {
    }
]

Creates or updates a file on an adjustment

Creates or updates a file on an adjustment

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

adjustmentId
required
number

Adjustment ID

Request Body schema: application/json
name
string
id
required
string
url
string or null

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "id": "string",
  • "url": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Deletes a file on an adjustment

Deletes a file on an adjustment

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

adjustmentId
required
number

Adjustment ID

fileId
required
string

File ID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Add a sample to this record

Add a sample to this record

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Request Body schema: application/json
Array of objects

Array of sample fields

object or null
commodityGradeId
number

If adjusting the grade, the new grade for the record

Responses

Request samples

Content type
application/json
{
  • "fields": [
    ],
  • "file": {
    },
  • "commodityGradeId": 0
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "status": "string",
  • "owners": [
    ],
  • "source": "planting",
  • "type": "crop",
  • "commodity": {
    },
  • "harvestYear": "string",
  • "isRecordInStorage": true,
  • "yield": {
    },
  • "storage": {
    },
  • "timeline": [
    ]
}

Search Inventory Record

Search Inventory Record

Authorizations:
jwt
query Parameters
limit
integer

Limit page size of results

offset
integer

Number of results to skip for the current page

sortBy
string

Sort results by this field

sortDesc
boolean

Sort results descending if true, otherwise ascending

docs
boolean

Defaults to true, but if included and set to false, only fitlers will be returned for the search, no documents

f:type
string

Filter by type

f:tags
string

Filter by tags

f:commodity
string

Filter by commodity

f:commodityGrade
string

Filter records by commodity grade

f:commodityTags
string

Filter records by commodity tags

f:commodityType
string

Filter by commodity type

f:commodityVariety
string

Filter records by commodity variety

f:harvestYear
string

Filter by harvest year

f:organisationId
string

Filter records by inventory owner

f:storageOrganisationId
string

Filter records by storage owner

f:storageId
string

Filter by storage location

f:storageType
string

records storage type

format
string

Format for the endpoint response, supports JSON (default) or CSV

ownerStatus
string

Filter records by owned by or stored by

f:businessUnitIds
string

Filter by business units

requiresCleaning
boolean

Requires Cleaning

Responses

Response samples

Content type
application/json
{
  • "docs": {
    },
  • "custom": {
    },
  • "totalDocs": 0,
  • "limit": 0,
  • "offset": 0,
  • "clearUrl": "string",
  • "activeFilters": [
    ],
  • "facets": [
    ],
  • "aggregations": [
    ]
}

Create a new inventory record

Create a new inventory record

Authorizations:
jwt
Request Body schema: application/json
name
string or null

Name of the commodity

Array of objects or null

Array of storage locations where the new inventory record is being stored

type
required
string
Enum: "crop" "produce"

Type of commodity

harvestYear
required
string
required
object
required
object
tags
Array of strings

Custom tags to help organise inventory

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "storage": [
    ],
  • "type": "crop",
  • "harvestYear": "string",
  • "commodity": {
    },
  • "source": {
    },
  • "tags": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "status": "string",
  • "owners": [
    ],
  • "source": "planting",
  • "type": "crop",
  • "commodity": {
    },
  • "harvestYear": "string",
  • "isRecordInStorage": true,
  • "yield": {
    },
  • "storage": {
    }
}

Deletes a sample on a record

Deletes a sample on a record

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

sampleId
required
number

Sample ID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

varieties

Suggest varieties

Suggest varieties based on term

Authorizations:
jwt
query Parameters
commodityType
string

Filter by commodity type

commodity
string

Filter by commodity

query
required
string

Free text search field for querying

Responses

Response samples

Content type
application/json
[
  • {
    }
]

storage

Get Storage

Get storage facilities

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "organisationId": "string",
  • "businessUnits": [
    ],
  • "name": "string",
  • "area": 0,
  • "type": "field",
  • "isConflicted": true,
  • "location": {
    },
  • "substorageCount": 0,
  • "substorage": [
    ],
  • "substorageSeed": 0
}

Update a storage location

Update a storage location

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Request Body schema: application/json
businessUnitIds
Array of strings
name
string
type
string
Enum: "field" "store"
object or null
tags
Array of strings

Custom tags to help organise storage

Array of objects or null

Responses

Request samples

Content type
application/json
{
  • "businessUnitIds": [
    ],
  • "name": "string",
  • "type": "field",
  • "location": {
    },
  • "tags": [
    ],
  • "substorage": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "organisationId": "string",
  • "businessUnits": [
    ],
  • "name": "string",
  • "area": 0,
  • "type": "field",
  • "isConflicted": true,
  • "location": {
    },
  • "substorageCount": 0,
  • "substorage": [
    ],
  • "substorageSeed": 0
}

Deletes a storage location

Deletes a storage location

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Get substorage and all future movements with conflict status if any

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

substorageId
required
number

Substorage ID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Deletes a substorage location

Deletes a substorage location

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

substorageId
required
number

Substorage ID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Get storage locations by inventory record ids

Get storage locations by inventory record ids

Authorizations:
jwt
query Parameters
ids
required
string

Comma separated list of ids

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Search storage facilities

Search Storage

Authorizations:
jwt
query Parameters
limit
integer

Limit page size of results

offset
integer

Number of results to skip for the current page

sortBy
string

Sort results by this field

sortDesc
boolean

Sort results descending if true, otherwise ascending

docs
boolean

Defaults to true, but if included and set to false, only fitlers will be returned for the search, no documents

format
string

Format for the endpoint response, supports JSON (default) or CSV

query
string

Free text search field for querying

f:type
string

Filter by type

f:commodity
string

Filter by commodity

f:commodityType
string

Filter by commodity type

f:commodityGrade
string

Filter records by commodity grade

f:commodityVariety
string

Filter records by commodity variety

f:tags
string

Filter by tags

f:hasInventory
boolean

Filter by has inventory

f:harvestYear
string

Filter by harvest year

f:ownerOrganisationId
string

Filter records by inventory owner

f:storageId
string

Filter by storage location

f:inventoryType
string

Filter by inventory type (crop / produce

conflict
boolean

Filter by conflicted storage locations if set

f:businessUnitIds
string

Filter by business units

Responses

Response samples

Content type
application/json
{
  • "docs": {
    },
  • "custom": { },
  • "totalDocs": 0,
  • "limit": 0,
  • "offset": 0,
  • "clearUrl": "string",
  • "activeFilters": [
    ],
  • "facets": [
    ],
  • "aggregations": [
    ]
}

Create a new storage location

Create a new storage location

Authorizations:
jwt
Request Body schema: application/json
name
required
string
area
number or null
type
required
string
Enum: "field" "store"
businessUnitIds
Array of strings
required
object or null
tags
Array of strings

Custom tags to help organise storage

Array of objects

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "area": 0,
  • "type": "field",
  • "businessUnitIds": [
    ],
  • "location": {
    },
  • "tags": [
    ],
  • "substorage": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "organisationId": "string",
  • "businessUnits": [
    ],
  • "name": "string",
  • "area": 0,
  • "type": "field",
  • "isConflicted": true,
  • "location": {
    },
  • "substorageCount": 0,
  • "substorage": [
    ],
  • "substorageSeed": 0
}

List Storage

List storage facilities

Authorizations:
jwt
query Parameters
limit
integer

Limit page size of results

offset
integer

Number of results to skip for the current page

type
string

Filter by type

sortBy
string

Sort results by this field

sortDesc
boolean

Sort results descending if true, otherwise ascending

format
string

Format for the endpoint response, supports JSON (default) or CSV

query
string

Free text search field for querying

conflict
boolean

Filter by conflicted storage locations if set

businessUnitIds
string

Filter by business units

tags
string

Filter by tags

Responses

Response samples

Content type
application/json
{
  • "docs": {
    },
  • "custom": { },
  • "totalDocs": 0,
  • "limit": 0,
  • "offset": 0,
  • "clearUrl": "string",
  • "activeFilters": [
    ],
  • "facets": [
    ],
  • "aggregations": [
    ]
}

List Storage Facility Names

Return a list of storage facility id and name and location summary for an organisation

Authorizations:
jwt

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Storage type ahead

suggests a storage location based on name && address

Authorizations:
jwt
query Parameters
query
required
string

Free text search field for querying

Responses

Response samples

Content type
application/json
[
  • {
    }
]

add commodity to storage

adds the desired commodity as a storable option on the sotage

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Request Body schema: application/json
substorageId
required
number
commodityId
required
number
weight
required
number

Responses

Request samples

Content type
application/json
{
  • "substorageId": 0,
  • "commodityId": 0,
  • "weight": 0
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "organisationId": "string",
  • "businessUnits": [
    ],
  • "name": "string",
  • "area": 0,
  • "type": "field",
  • "isConflicted": true,
  • "location": {
    },
  • "substorageCount": 0,
  • "substorage": [
    ],
  • "substorageSeed": 0
}

Determine conflict status for all storage locations

Authorizations:
jwt
query Parameters
storageId
string

Filter by storage id

organisationId
string

Filter by organisation Id

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Get storage counts by business units

Returns count of stores and fields by business unit id

Authorizations:
jwt

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Updates business units of storage locations in bulk

Authorizations:
jwt
Request Body schema: application/json
businessUnitId
required
string
storageIds
required
Array of strings

Responses

Request samples

Content type
application/json
{
  • "businessUnitId": "string",
  • "storageIds": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

storage contracts

Lookup storage contract

Lookup available storage contract for an intake

Authorizations:
jwt
query Parameters
commodity
required
string

Filter by commodity

commodityType
required
string

Filter by commodity type

commodityGrade
string

Filter records by commodity grade

dateISO
required
string

Filter by date

ownerOrganisationId
required
string

Filter records by inventory owner

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "status": "active",
  • "owner": {
    },
  • "details": {
    },
  • "inventory": {
    }
}

Search Storage Contracts

Search Storage Contracts

Authorizations:
jwt
query Parameters
limit
integer

Limit page size of results

offset
integer

Number of results to skip for the current page

sortBy
string

Sort results by this field

sortDesc
boolean

Sort results descending if true, otherwise ascending

docs
boolean

Defaults to true, but if included and set to false, only fitlers will be returned for the search, no documents

status
string

Filter by status

format
string

Format for the endpoint response, supports JSON (default) or CSV

query
string

Free text search field for querying

f:tags
string

Filter by tags

f:commodity
string

Filter by commodity

f:commodityType
string

Filter by commodity type

f:commodityGrade
string

Filter records by commodity grade

f:ownerOrganisationId
string

Filter records by inventory owner

Responses

Response samples

Content type
application/json
{
  • "docs": {
    },
  • "custom": { },
  • "totalDocs": 0,
  • "limit": 0,
  • "offset": 0,
  • "clearUrl": "string",
  • "activeFilters": [
    ],
  • "facets": [
    ],
  • "aggregations": [
    ]
}

Create a new Storage Contract

Create a new storageContractUpdate contract

Authorizations:
jwt
Request Body schema: application/json
ownerOrganisationId
required
string
ownerOrganisationName
required
string
required
object
required
object

Responses

Request samples

Content type
application/json
{
  • "ownerOrganisationId": "1-A",
  • "ownerOrganisationName": "Andrews Farm",
  • "details": {
    },
  • "inventory": {
    }
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "status": "active",
  • "owner": {
    },
  • "details": {
    },
  • "inventory": {
    }
}

Retrieve a Storage Contract

Retrieves a single Storage Contract using the id

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "status": "active",
  • "owner": {
    },
  • "details": {
    },
  • "inventory": {
    }
}

Update storage contract

Update storage contract

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Request Body schema: application/json
required
object
required
object

Responses

Request samples

Content type
application/json
{
  • "details": {
    },
  • "inventory": {
    }
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "status": "active",
  • "owner": {
    },
  • "details": {
    },
  • "inventory": {
    }
}

Delete a Storage Contract

Delete a Storage Contract

Authorizations:
jwt
path Parameters
id
required
string

ID of the Storage Contract to delete

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

adjustments

Create adjustments for one or more records

Create adjustments for one or more records

Authorizations:
jwt
Request Body schema: application/json
required
Array of objects

Array of records to adjust

Array of objects or null

A list of files to associate with the adjustments

reasonId
required
number

Reason for the adjustment, from dropdown of managed reasons

Responses

Request samples

Content type
application/json
{
  • "records": [
    ],
  • "files": [
    ],
  • "reasonId": 0
}

Response samples

Content type
application/json
[
  • {
    }
]

Creates or updates a file on an adjustment

Creates or updates a file on an adjustment

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

adjustmentId
required
number

Adjustment ID

Request Body schema: application/json
name
string
id
required
string
url
string or null

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "id": "string",
  • "url": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Deletes a file on an adjustment

Deletes a file on an adjustment

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

adjustmentId
required
number

Adjustment ID

fileId
required
string

File ID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

samples

Add a sample to this record

Add a sample to this record

Authorizations:
jwt
path Parameters
id
required
string

Id of the resource

Request Body schema: application/json
Array of objects

Array of sample fields

object or null
commodityGradeId
number

If adjusting the grade, the new grade for the record

Responses

Request samples

Content type
application/json
{
  • "fields": [
    ],
  • "file": {
    },
  • "commodityGradeId": 0
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "status": "string",
  • "owners": [
    ],
  • "source": "planting",
  • "type": "crop",
  • "commodity": {
    },
  • "harvestYear": "string",
  • "isRecordInStorage": true,
  • "yield": {
    },
  • "storage": {
    },
  • "timeline": [
    ]
}

Inventory service

Ping api

Ping inventory api

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Execute event

Execute event in inventory module

Authorizations:
jwt
path Parameters
action
required
string

Action to perform

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Update system settings

Change the system settings document in the inventory module

Authorizations:
jwt
Request Body schema: application/json
required
object
level
required
string
filter
required
string or null

Responses

Request samples

Content type
application/json
{
  • "logging": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}