Crop Supply Plans
Last updated
Was this helpful?
Last updated
Was this helpful?
The Crop Supply Plans GET
endpoint is paginated, so please refer to the documentation prior to usage.
As with all Claret API endpoints, the Crop Supply Plan APIs require token authentication. For instructions on how to retrieve and pass through the authentication token, please refer to the documentation.
Important note on Pagination: PLEASE READ
As Crop Supply Plan data is based on the output of the Crop Supply Plan module, the data for the API call is structured and stored in a table that will need a request_id
as an index.
How it works:
Follow all instructions in the documentation
Along with the current_index
argument (in consecutive calls after the 1st call), the request_id
argument will also need to be passed through.
NOTE: This value will appear in the response from your initial request
Pagination arguments for Crop Supply Planning:
1st call: no arguments required:
2nd (and each additional) call(s): current_index
(set to the next_index
value from the previous response, request_id
(set to the request_id
from the previous response)
CURRENTLY UNDER CONSTRUCTION - THIS ENDPOINT IS NOT YET LIVE
GET
https://plan.claret.app/{tenant}/api/v1/crop-supply-plans
Retrieves data from the Crop Supply Planning module as Item@Location records with all connected Supply and Demand records.
Headers
Content-Type
application/json
Authorization
Bearer <token>
Body
include_flattened_hierarchies
tinyInteger
Optional argument in the form of 1 for true or 0 for false.
Selecting 1 will include the names of the Items and Locations that are the parent hierarchical records of the Item@Location records that the demand and supply are attached to.
crop_supply_planning_view_name
string
The name of a Workspace view that is currently set up for the Crop Supply Planning module.
This is optional, but - if it is not provided - all arguments below will be required.
raw_material_hierarchy_type
string
The name of the Raw Material Hierarchy Type that should be used to retrieve the crop Items.
This is optional unless crop_supply_planning_view_name
is not provided.
crop_location_hierarchy_type
string
The name of the Crop Location Hierarchy Type that should be used to retrieve the crop Locations.
This is optional unless crop_supply_planning_view_name
is not provided.
selected_uom
string
The name or abbreviation of the Unit of Measure that the quantities should be converted to in the payload.
This is optional unless crop_supply_planning_view_name
is not provided.
include_allocations
tinyInteger
1 (true) or 0 (false) indicating whether to include demand from Contract Allocations in the response.
This is optional unless crop_supply_planning_view_name
is not provided.
calendars
array of strings
Array of Calendar names that should be included in the response (i.e., "FY24", "FY25", etc.).
This is optional unless crop_supply_planning_view_name
is not provided.
supply_types
array of strings
Array of Supply Type names that will represent the Crop Supply Supply Plan values.
This is optional unless crop_supply_planning_view_name
is not provided.
supply_statuses
array of strings
Array of Supply Plan Status names that the Supply Plans in the response should belong to.
This is optional unless crop_supply_planning_view_name
is not provided.
dependent_demand_supply_types
array of strings
Array of Supply Type names that will represent the Dependent Demand Supply Types.
This is optional unless crop_supply_planning_view_name
is not provided.
Response