PUT PurchaseContract/PutPurchaseContractWithQuantityReceivedPrivateRestricted

Updates a purchase contract overriding the received contract quantity (NOT FOR PUBLIC USE EVER)

Request Information

URI Parameters

Body Parameters

Model used to update the purchase contract

ClsGrPurConUpdateWithQuantityReceivedPopulated

Name	Description	Type	Additional Information
QuantityReceived	Quantity received so far	decimal number	Required Cannot be negative
PurchaseContractGUID	Guid of the contract - will be used to look up the contract if provided	globally unique identifier
ContractID	ID of the purchase contract - Required if PurchaseContractGUID is not set	string	Max length: 15
LocationID	ID of the delivery location for the contract - Required if PurchaseContractGUID is not set	string	Max length: 6
NewLocationToSetID	New Loction Id for the contract	string	Max length: 6
CustomerID	ID of the customer on the contract	string	Required Max length: 6
CommodityID	ID of the commodity on the contract	string	Required Max length: 6
DateEstablished	Date the contract was established	string	Required Format must be MM/dd/yyyy
ContractType	Type of contract	PurchaseContractType	Required
ContractStatus	Current status of the contract	PurchaseContractStatus	Required
CashPrice	Cash price established for the contract	decimal number	Max of 5 decimal places
ContractQuantity	Contracted quantity of the commodity	decimal number	Required Cannot be negative
BasisPrice	Difference between the futures price and cash price	decimal number	Max of 5 decimal places
FuturesMonthID	ID of the futures month used for the futures price	string	Max length: 10
ExchangeID	ID of the exchange used to establish the price	string	Max length: 10
StrikePrice	Price at which a futures contract can be bought or sold	decimal number	Max of 5 decimal places
ExpireDate	Expiration date of the contract	string	Format must be MM/dd/yyyy
FuturesPrice	Futures price established for the contract	decimal number	Max of 5 decimal places
ContractSigned	Indicates whether or not the contract has been signed	boolean
BidCriteriaID	ID for the terms of the bid	string	Max length: 20
ShippingDestinationID	ID of the shipping destination to apply to the contract	string	Max length: 6
SalespersonID	ID of the salesperson associated with the contract	string	Max length: 15
PricingNotes	Note related to pricing for the contract	string	Max length: 50
PriceByDate	Date by which the contract should be priced or rolled	string	Format must be MM/dd/yyyy
FreightOnBoard	Indicates whether or not the contract includes freight in the established price	boolean
ContractFormat	The format used to create the physical contract to sign. NOTE: This is required when the database column exists and no defaults are set in Agvance.	string	Max length: 50
DirectShipped	Flag that indicates if the purchase contract is to be treated as direct shipped	boolean
AgvanceUserIdToAssignBuyerSignatureFrom	The Agvance user id to use to assign the buyer signature	string
BuyerSignatureDateSignedToPrint	The date the buyer's signature was applied to the contract (Only used with a valid AgvanceUserIdToAssignBuyerSignatureFrom set)	date
BuyerSignatureDateTimeSignedUtc	The date and time the buyer's signature was captured in UTC (Only used with a valid AgvanceUserIdToAssignBuyerSignatureFrom set)	date
FarmId	Farm ID for the contract - free text field	string	Max length: 8
MOTGuid	The Method of Transportation Guid	globally unique identifier
SellerSignatureDateSignedToPrint	The date the seller signed the contract. Only valid when ContractSiigned is true. Only the date portion is used.	date
PurchaseContractComments	List of comments associated with the contract	Collection of ClsGrPurConCommUpdate
PurchaseContractDeliveryDates	List of delivery dates for the contract	Collection of ClsGrPurConDdUpdate
PurchaseContractSchedules	List of Premium Discount schedules attached to the contract	Collection of ClsGrPurConGfUpdate
PurchaseContractMinimumPriceInfo	List of minimum price roll records	Collection of ClsGrPurConRollUpdate
PurchaseContractChangeReasons	Class containing change reasons for each type of change	ClsGrPurChangeReasons

Request Formats

application/json, text/json

Sample:

{
  "QuantityReceived": 1.1,
  "PurchaseContractGUID": "d26ee589-2738-4ad5-94a8-8703b36a1ba4",
  "ContractID": "sample string 2",
  "LocationID": "sample string 3",
  "NewLocationToSetID": "sample string 4",
  "CustomerID": "sample string 5",
  "CommodityID": "sample string 6",
  "DateEstablished": "sample string 7",
  "ContractType": 1,
  "ContractStatus": 1,
  "CashPrice": 8.1,
  "ContractQuantity": 9.1,
  "BasisPrice": 10.1,
  "FuturesMonthID": "sample string 11",
  "ExchangeID": "sample string 12",
  "StrikePrice": 13.1,
  "ExpireDate": "sample string 14",
  "FuturesPrice": 15.1,
  "ContractSigned": true,
  "BidCriteriaID": "sample string 17",
  "ShippingDestinationID": "sample string 18",
  "SalespersonID": "sample string 19",
  "PricingNotes": "sample string 20",
  "PriceByDate": "sample string 21",
  "FreightOnBoard": true,
  "ContractFormat": "sample string 23",
  "DirectShipped": true,
  "AgvanceUserIdToAssignBuyerSignatureFrom": "sample string 25",
  "BuyerSignatureDateSignedToPrint": "2025-05-15T14:52:57.2217801+00:00",
  "BuyerSignatureDateTimeSignedUtc": "2025-05-15T14:52:57.2217801+00:00",
  "FarmId": "sample string 26",
  "MOTGuid": "ca816594-3952-49d6-8eb5-fae894c50004",
  "SellerSignatureDateSignedToPrint": "2025-05-15T14:52:57.2217801+00:00",
  "PurchaseContractComments": [
    {
      "Comment": "sample string 1",
      "CommentDate": "sample string 2"
    },
    {
      "Comment": "sample string 1",
      "CommentDate": "sample string 2"
    }
  ],
  "PurchaseContractDeliveryDates": [
    {
      "StartDate": "sample string 1",
      "CompleteDate": "sample string 2",
      "Quantity": 3.1
    },
    {
      "StartDate": "sample string 1",
      "CompleteDate": "sample string 2",
      "Quantity": 3.1
    }
  ],
  "PurchaseContractSchedules": [
    {
      "PremiumDiscountGuid": "7844a64d-ca26-44d6-bb65-78e3b6918469",
      "GradFactorId": "sample string 1",
      "ScheduleId": "sample string 2"
    },
    {
      "PremiumDiscountGuid": "7844a64d-ca26-44d6-bb65-78e3b6918469",
      "GradFactorId": "sample string 1",
      "ScheduleId": "sample string 2"
    }
  ],
  "PurchaseContractMinimumPriceInfo": [
    {
      "FuturesPrice": 1.1,
      "BasisPrice": 2.1,
      "BuyOptionPrice": 3.1,
      "BuyOptionMonth": "sample string 4",
      "BuyOptionPorC": "sample string 5",
      "BuyOptionStrike": 6.1,
      "SellOptionPrice": 7.1,
      "SellOptionMonth": "sample string 8",
      "SellOptionPorC": "sample string 9",
      "SellOptionStrike": 10.1,
      "Storage": 11.1,
      "ServiceCharge": 12.1,
      "MinimumPrice": 13.1,
      "ExpirationDate": "2025-05-15T14:52:57.2217801+00:00",
      "Comments": "sample string 14"
    },
    {
      "FuturesPrice": 1.1,
      "BasisPrice": 2.1,
      "BuyOptionPrice": 3.1,
      "BuyOptionMonth": "sample string 4",
      "BuyOptionPorC": "sample string 5",
      "BuyOptionStrike": 6.1,
      "SellOptionPrice": 7.1,
      "SellOptionMonth": "sample string 8",
      "SellOptionPorC": "sample string 9",
      "SellOptionStrike": 10.1,
      "Storage": 11.1,
      "ServiceCharge": 12.1,
      "MinimumPrice": 13.1,
      "ExpirationDate": "2025-05-15T14:52:57.2217801+00:00",
      "Comments": "sample string 14"
    }
  ],
  "PurchaseContractChangeReasons": {
    "BasisPriceReason": "sample string 1",
    "CashPriceReason": "sample string 2",
    "FuturesPriceReason": "sample string 3",
    "ContractQuantityReason": "sample string 4",
    "ContractStatusReason": "sample string 5",
    "FOBReason": "sample string 6"
  }
}

application/xml, text/xml

Sample:

<ClsGrPurCon.ClsGrPurConUpdateWithQuantityReceivedPopulated xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SKY.Core.Grain">
  <AgvanceUserIdToAssignBuyerSignatureFrom>sample string 25</AgvanceUserIdToAssignBuyerSignatureFrom>
  <BasisPrice>10.1</BasisPrice>
  <BidCriteriaID>sample string 17</BidCriteriaID>
  <BuyerSignatureDateSignedToPrint>2025-05-15T14:52:57.2217801+00:00</BuyerSignatureDateSignedToPrint>
  <BuyerSignatureDateTimeSignedUtc>2025-05-15T14:52:57.2217801+00:00</BuyerSignatureDateTimeSignedUtc>
  <CashPrice>8.1</CashPrice>
  <CommodityID>sample string 6</CommodityID>
  <ContractFormat>sample string 23</ContractFormat>
  <ContractID>sample string 2</ContractID>
  <ContractQuantity>9.1</ContractQuantity>
  <ContractSigned>true</ContractSigned>
  <ContractStatus>Open</ContractStatus>
  <ContractType>Priced</ContractType>
  <CustomerID>sample string 5</CustomerID>
  <DateEstablished>sample string 7</DateEstablished>
  <DirectShipped>true</DirectShipped>
  <ExchangeID>sample string 12</ExchangeID>
  <ExpireDate>sample string 14</ExpireDate>
  <FarmId>sample string 26</FarmId>
  <FreightOnBoard>true</FreightOnBoard>
  <FuturesMonthID>sample string 11</FuturesMonthID>
  <FuturesPrice>15.1</FuturesPrice>
  <LocationID>sample string 3</LocationID>
  <MOTGuid>ca816594-3952-49d6-8eb5-fae894c50004</MOTGuid>
  <NewLocationToSetID>sample string 4</NewLocationToSetID>
  <PriceByDate>sample string 21</PriceByDate>
  <PricingNotes>sample string 20</PricingNotes>
  <PurchaseContractChangeReasons>
    <BasisPriceReason>sample string 1</BasisPriceReason>
    <CashPriceReason>sample string 2</CashPriceReason>
    <ContractQuantityReason>sample string 4</ContractQuantityReason>
    <ContractStatusReason>sample string 5</ContractStatusReason>
    <FOBReason>sample string 6</FOBReason>
    <FuturesPriceReason>sample string 3</FuturesPriceReason>
  </PurchaseContractChangeReasons>
  <PurchaseContractComments>
    <ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConCommUpdate>
      <Comment>sample string 1</Comment>
      <CommentDate>sample string 2</CommentDate>
    </ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConCommUpdate>
    <ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConCommUpdate>
      <Comment>sample string 1</Comment>
      <CommentDate>sample string 2</CommentDate>
    </ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConCommUpdate>
  </PurchaseContractComments>
  <PurchaseContractDeliveryDates>
    <ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConDdUpdate>
      <CompleteDate>sample string 2</CompleteDate>
      <Quantity>3.1</Quantity>
      <StartDate>sample string 1</StartDate>
    </ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConDdUpdate>
    <ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConDdUpdate>
      <CompleteDate>sample string 2</CompleteDate>
      <Quantity>3.1</Quantity>
      <StartDate>sample string 1</StartDate>
    </ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConDdUpdate>
  </PurchaseContractDeliveryDates>
  <PurchaseContractGUID>d26ee589-2738-4ad5-94a8-8703b36a1ba4</PurchaseContractGUID>
  <PurchaseContractMinimumPriceInfo>
    <ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConRollUpdate>
      <BasisPrice>2.1</BasisPrice>
      <BuyOptionMonth>sample string 4</BuyOptionMonth>
      <BuyOptionPorC>sample string 5</BuyOptionPorC>
      <BuyOptionPrice>3.1</BuyOptionPrice>
      <BuyOptionStrike>6.1</BuyOptionStrike>
      <Comments>sample string 14</Comments>
      <ExpirationDate>2025-05-15T14:52:57.2217801+00:00</ExpirationDate>
      <FuturesPrice>1.1</FuturesPrice>
      <MinimumPrice>13.1</MinimumPrice>
      <SellOptionMonth>sample string 8</SellOptionMonth>
      <SellOptionPorC>sample string 9</SellOptionPorC>
      <SellOptionPrice>7.1</SellOptionPrice>
      <SellOptionStrike>10.1</SellOptionStrike>
      <ServiceCharge>12.1</ServiceCharge>
      <Storage>11.1</Storage>
    </ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConRollUpdate>
    <ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConRollUpdate>
      <BasisPrice>2.1</BasisPrice>
      <BuyOptionMonth>sample string 4</BuyOptionMonth>
      <BuyOptionPorC>sample string 5</BuyOptionPorC>
      <BuyOptionPrice>3.1</BuyOptionPrice>
      <BuyOptionStrike>6.1</BuyOptionStrike>
      <Comments>sample string 14</Comments>
      <ExpirationDate>2025-05-15T14:52:57.2217801+00:00</ExpirationDate>
      <FuturesPrice>1.1</FuturesPrice>
      <MinimumPrice>13.1</MinimumPrice>
      <SellOptionMonth>sample string 8</SellOptionMonth>
      <SellOptionPorC>sample string 9</SellOptionPorC>
      <SellOptionPrice>7.1</SellOptionPrice>
      <SellOptionStrike>10.1</SellOptionStrike>
      <ServiceCharge>12.1</ServiceCharge>
      <Storage>11.1</Storage>
    </ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConRollUpdate>
  </PurchaseContractMinimumPriceInfo>
  <PurchaseContractSchedules>
    <ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConGfUpdate>
      <GradFactorId>sample string 1</GradFactorId>
      <PremiumDiscountGuid>7844a64d-ca26-44d6-bb65-78e3b6918469</PremiumDiscountGuid>
      <ScheduleId>sample string 2</ScheduleId>
    </ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConGfUpdate>
    <ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConGfUpdate>
      <GradFactorId>sample string 1</GradFactorId>
      <PremiumDiscountGuid>7844a64d-ca26-44d6-bb65-78e3b6918469</PremiumDiscountGuid>
      <ScheduleId>sample string 2</ScheduleId>
    </ClsGrPurCon.ClsGrPurConUpdate.ClsGrPurConGfUpdate>
  </PurchaseContractSchedules>
  <SalespersonID>sample string 19</SalespersonID>
  <SellerSignatureDateSignedToPrint>2025-05-15T14:52:57.2217801+00:00</SellerSignatureDateSignedToPrint>
  <ShippingDestinationID>sample string 18</ShippingDestinationID>
  <StrikePrice>13.1</StrikePrice>
  <QuantityReceived>1.1</QuantityReceived>
</ClsGrPurCon.ClsGrPurConUpdateWithQuantityReceivedPopulated>

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 'ClsGrPurConUpdateWithQuantityReceivedPopulated'.

Response Information

Resource Description

Updates a purchase contract overriding the received contract quantity (NOT FOR PUBLIC USE EVER)

AgvPurchaseContractDetails

Name	Description	Type
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
Count	The number of results returned.	string
PurchaseContract		ClsGrPurCon

Response Formats

application/json, text/json

Sample:

{
  "Status": "sample string 1",
  "Message": "sample string 2",
  "Count": "1",
  "PurchaseContract": {
    "Contract": "sample string 1",
    "CustID": "sample string 2",
    "Location": "sample string 3",
    "Commodity": "sample string 4",
    "Dateest": "sample string 5",
    "ExpireDate": "sample string 6",
    "ContractStatus": "sample string 7",
    "ContractType": "sample string 8",
    "CashPrice": 9.1,
    "ContractQuantity": 10.1,
    "QuantityRecvd": 11.1,
    "Basisprice": 12.1,
    "FuturesMonth": "sample string 13",
    "Exchange": "sample string 15",
    "StrikePrice": 16.1,
    "Futuresprice": 17.1,
    "ContractSigned": true,
    "BidCriteria": "sample string 19",
    "ShipDestination": "sample string 20",
    "OriginContract": "sample string 21",
    "OriginLocation": "sample string 22",
    "SalesmanID": "sample string 23",
    "PricingNotes": "sample string 24",
    "IsSpot": true,
    "originalContractQuantity": 26.1,
    "PurchaseContractGuid": "99d22285-aa73-479e-ba43-5d916aaa7785",
    "SellerSignatureDateSignedToPrint": "2025-05-15T14:52:57.2382952+00:00",
    "ContractFormat": "sample string 35",
    "DirectShipped": true,
    "LastModifiedUTC": "2025-05-15T14:52:57.2382952+00:00",
    "PurchaseContractDeliveryDates": [
      {
        "Contract": "sample string 1",
        "Location": "sample string 2",
        "Lineitem": "3",
        "StartDate": "sample string 4",
        "Quantity": "5.1",
        "CompleteDate": "sample string 6"
      },
      {
        "Contract": "sample string 1",
        "Location": "sample string 2",
        "Lineitem": "3",
        "StartDate": "sample string 4",
        "Quantity": "5.1",
        "CompleteDate": "sample string 6"
      }
    ],
    "PurchaseContractGradeFactors": [
      {
        "Contract": "sample string 1",
        "Location": "sample string 2",
        "Lineitem": "3",
        "GradFact": "sample string 4",
        "Schedule": "sample string 5",
        "Commodity": "sample string 6"
      },
      {
        "Contract": "sample string 1",
        "Location": "sample string 2",
        "Lineitem": "3",
        "GradFact": "sample string 4",
        "Schedule": "sample string 5",
        "Commodity": "sample string 6"
      }
    ],
    "PurchaseContractComments": [
      {
        "CommentDate": "sample string 4",
        "Comment": "sample string 5"
      },
      {
        "CommentDate": "sample string 4",
        "Comment": "sample string 5"
      }
    ]
  }
}

application/xml

Sample:

An exception has occurred while using the formatter 'XmlMediaTypeFormatter' to generate sample for media type 'application/xml'. Exception message: No set method for property 'QuantityAsStringForApi' in type 'SKY.Core.Grain.ClsGrPurCon+ClsGrPurConDd'.

text/xml

Sample:

An exception has occurred while using the formatter 'XmlMediaTypeFormatter' to generate sample for media type 'text/xml'. Exception message: No set method for property 'QuantityAsStringForApi' in type 'SKY.Core.Grain.ClsGrPurCon+ClsGrPurConDd'.