POST FuturesMonth/PostFuturesMonthAddOrUpdate

Save to the Agvance database the Futures Month Pricing Information

Request Information

URI Parameters

Body Parameters

Object that contains the data to write to the Futures Pricing setup in Agvance

ClsSkyGrFuturesPriceAddOrUpdate
NameDescriptionTypeAdditional Information
LocationIdOrGuidForTimeStamp

Location ID or GUID to get the current date and time stamp to use for audit tracking of the Pricing records

 string

Required

Max length: 36
Data

The list of pricing records to add if missing, or update the basis price when found

 Collection of ClsSkyGrFuturesPriceAddDetail

Required

List cannot be empty

Request Formats

application/json, text/json

Sample: 
{
  "LocationIdOrGuidForTimeStamp": "sample string 3",
  "Data": [
    {
      "CommodityId": "sample string 2",
      "LocationId": "sample string 3",
      "ExchangeId": "sample string 4",
      "BidCriteriaId": "sample string 5",
      "FutMonth": "sample string 6",
      "StartingDeliveryPeriod": "2024-11-21T09:32:35.3539217+00:00",
      "EndingDeliveryPeriod": "2024-11-21T09:32:35.3549211+00:00",
      "FutMoEndDate": "2024-11-21T09:32:35.3549211+00:00",
      "FuturesPrice": 1.1,
      "FuturesPriceDateTimeLocal": "2024-11-21T09:32:35.3549211+00:00",
      "BasisPrice": 1.1,
      "BasisDateTimeLocal": "2024-11-21T09:32:35.3549211+00:00",
      "CommoditySymbol": "sample string 7",
      "FutureMonthAliasId": "sample string 8",
      "IndustryCode": "sample string 9"
    },
    {
      "CommodityId": "sample string 2",
      "LocationId": "sample string 3",
      "ExchangeId": "sample string 4",
      "BidCriteriaId": "sample string 5",
      "FutMonth": "sample string 6",
      "StartingDeliveryPeriod": "2024-11-21T09:32:35.3539217+00:00",
      "EndingDeliveryPeriod": "2024-11-21T09:32:35.3549211+00:00",
      "FutMoEndDate": "2024-11-21T09:32:35.3549211+00:00",
      "FuturesPrice": 1.1,
      "FuturesPriceDateTimeLocal": "2024-11-21T09:32:35.3549211+00:00",
      "BasisPrice": 1.1,
      "BasisDateTimeLocal": "2024-11-21T09:32:35.3549211+00:00",
      "CommoditySymbol": "sample string 7",
      "FutureMonthAliasId": "sample string 8",
      "IndustryCode": "sample string 9"
    }
  ]
}

application/xml, text/xml

Sample: 
<FuturesPriceAddOrUpdate xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SKY.Core.Grain">
  <Data>
    <FuturesPriceAddOrUpdateDetail>
      <BasisDateTimeLocal>2024-11-21T09:32:35.3549211+00:00</BasisDateTimeLocal>
      <BasisPrice>1.1</BasisPrice>
      <BidCriteriaId>sample string 5</BidCriteriaId>
      <CommodityId>sample string 2</CommodityId>
      <CommoditySymbol>sample string 7</CommoditySymbol>
      <EndingDeliveryPeriod>2024-11-21T09:32:35.3549211+00:00</EndingDeliveryPeriod>
      <ExchangeId>sample string 4</ExchangeId>
      <FutMoEndDate>2024-11-21T09:32:35.3549211+00:00</FutMoEndDate>
      <FutMonth>sample string 6</FutMonth>
      <FutureMonthAliasId>sample string 8</FutureMonthAliasId>
      <FuturesPrice>1.1</FuturesPrice>
      <FuturesPriceDateTimeLocal>2024-11-21T09:32:35.3549211+00:00</FuturesPriceDateTimeLocal>
      <IndustryCode>sample string 9</IndustryCode>
      <LocationId>sample string 3</LocationId>
      <StartingDeliveryPeriod>2024-11-21T09:32:35.3539217+00:00</StartingDeliveryPeriod>
    </FuturesPriceAddOrUpdateDetail>
    <FuturesPriceAddOrUpdateDetail>
      <BasisDateTimeLocal>2024-11-21T09:32:35.3549211+00:00</BasisDateTimeLocal>
      <BasisPrice>1.1</BasisPrice>
      <BidCriteriaId>sample string 5</BidCriteriaId>
      <CommodityId>sample string 2</CommodityId>
      <CommoditySymbol>sample string 7</CommoditySymbol>
      <EndingDeliveryPeriod>2024-11-21T09:32:35.3549211+00:00</EndingDeliveryPeriod>
      <ExchangeId>sample string 4</ExchangeId>
      <FutMoEndDate>2024-11-21T09:32:35.3549211+00:00</FutMoEndDate>
      <FutMonth>sample string 6</FutMonth>
      <FutureMonthAliasId>sample string 8</FutureMonthAliasId>
      <FuturesPrice>1.1</FuturesPrice>
      <FuturesPriceDateTimeLocal>2024-11-21T09:32:35.3549211+00:00</FuturesPriceDateTimeLocal>
      <IndustryCode>sample string 9</IndustryCode>
      <LocationId>sample string 3</LocationId>
      <StartingDeliveryPeriod>2024-11-21T09:32:35.3539217+00:00</StartingDeliveryPeriod>
    </FuturesPriceAddOrUpdateDetail>
  </Data>
  <LocationIdOrGuidForTimeStamp>sample string 3</LocationIdOrGuidForTimeStamp>
</FuturesPriceAddOrUpdate>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'ClsSkyGrFuturesPriceAddOrUpdate'.

Response Information

Resource Description

Save to the Agvance database the Futures Month Pricing Information

AgvFuturesMonthAddOrUpdate
NameDescriptionTypeAdditional Information
Status

0 - Success; 1 - An error occurred; 2 - An error occurred; 3 - Descriptive message, process was successful

 string
Message

Informational message that corresponds to the Status returned; 0 - Message will be "OK"; 1 - Detailed message returned to give user an indication of what went wrong; 2 - Less detailed message returned that may not mean anything to the user but that the application might use to take a corrective action; 3 - Not an error but something the user might need to know

 string
ErrorList

List of error messages of the API call.

 Collection of string
WarningList

List of warning messages of the API call.

 Collection of string
Count

Number of records saved

 integer

Response Formats

application/json, text/json

Sample: 
{
  "Status": "sample string 1",
  "Message": "sample string 2",
  "ErrorList": [
    "sample string 1",
    "sample string 2"
  ],
  "WarningList": [
    "sample string 1",
    "sample string 2"
  ],
  "Count": 1
}

application/xml, text/xml

Sample: 
<AgvFuturesMonthAddOrUpdate xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AgvWebAPICSharp.Models.Contract.Purchase">
  <Count>1</Count>
  <ErrorList xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </ErrorList>
  <Message>sample string 2</Message>
  <Status>sample string 1</Status>
  <WarningList xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </WarningList>
</AgvFuturesMonthAddOrUpdate>