POST Booking/PostGenericNonPaidBooking

Creates a new Generic Non-Paid Booking

Request Information

URI Parameters

Body Parameters

Booking object used to create the Generic Non-Paid Booking

ClsGenericNonPaidBookAdd
NameDescriptionTypeAdditional Information
LocationId

The ID of the location where the booking will be created.

string

Required

Max length: 6

BookDate

The date of the booking.

string

Required

Data type: DateTime

Format must be MM/dd/yyyy

GrowerId

The Agvance Grower identifier of the Field: ONLY used when FieldId is populated.

string

Max length: 6

FieldId

The Agvance field identifier.

string

Max length: 8

SalespersonId

The Agvance salesperson for the booking.

string

Max length: 15

Comments

Comments.

string

Max length: 80

AdditionalComments

Additional comments.

string

Max length: 240

Term

string

Max length: 15

ControlNumber

An alternative way of identifying the booking.

string

Max length: 15

ExpireDate

The date the booking will expire.

string

Data type: DateTime

Format must be MM/dd/yyyy

StartDate

The date the booking will start.

string

Data type: DateTime

Format must be MM/dd/yyyy

ContractFormat

The format of the booking contract assigned to this transaction

string

Max length: 40

AgvanceUserIdToAssignSellerSignatureFrom

Agvance user ID to assign to the seller signature

string
SellerSignatureDateSignedToPrint

Date the sellers signature was applied to the contract (only if the signature is valid)

date
SellerSignatureDateTimeSignedUtc

Date and time the sellers signature was captured in UTC (only if the signature is valid)

date
ProdClassFlag

The unique identifier of the GenTypes record to use for the Generic Non-Paid Booking

integer

Required

Must be a value greater than zero

GenericNonPaidBookSplitsAdd

Where the user can add splits to the booking.

Collection of ClsGenericNonPaidBookSplitAdd

List cannot be empty

Maximum of 1 allowed

Request Formats

application/json, text/json

Sample:
{
  "LocationId": "sample string 1",
  "BookDate": "sample string 2",
  "GrowerId": "sample string 3",
  "FieldId": "sample string 4",
  "SalespersonId": "sample string 5",
  "Comments": "sample string 6",
  "AdditionalComments": "sample string 7",
  "Term": "sample string 8",
  "ControlNumber": "sample string 9",
  "ExpireDate": "sample string 10",
  "StartDate": "sample string 11",
  "ContractFormat": "sample string 12",
  "AgvanceUserIdToAssignSellerSignatureFrom": "sample string 13",
  "SellerSignatureDateSignedToPrint": "2026-04-13T07:52:05.5264823+00:00",
  "SellerSignatureDateTimeSignedUtc": "2026-04-13T07:52:05.5264823+00:00",
  "ProdClassFlag": 14,
  "GenericNonPaidBookSplitsAdd": [
    {
      "CustomerId": "sample string 1",
      "BookPayMethodGuid": "6ef542d1-aead-48d4-a1fa-c84bbbc1b544",
      "ContractSigned": true,
      "PriceLevel": 0,
      "BookedDollars": 3.1
    },
    {
      "CustomerId": "sample string 1",
      "BookPayMethodGuid": "6ef542d1-aead-48d4-a1fa-c84bbbc1b544",
      "ContractSigned": true,
      "PriceLevel": 0,
      "BookedDollars": 3.1
    }
  ]
}

application/xml, text/xml

Sample:
<GenericNonPaidBookAdd xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SSI.AR">
  <AdditionalComments>sample string 7</AdditionalComments>
  <AgvanceUserIdToAssignSellerSignatureFrom>sample string 13</AgvanceUserIdToAssignSellerSignatureFrom>
  <BookDate>sample string 2</BookDate>
  <Comments>sample string 6</Comments>
  <ContractFormat>sample string 12</ContractFormat>
  <ControlNumber>sample string 9</ControlNumber>
  <ExpireDate>sample string 10</ExpireDate>
  <FieldId>sample string 4</FieldId>
  <GenericNonPaidBookSplitsAdd>
    <ClsBookAPI.ClsGenericNonPaidBookAdd.ClsGenericNonPaidBookSplitAdd>
      <BookPayMethodGuid>6ef542d1-aead-48d4-a1fa-c84bbbc1b544</BookPayMethodGuid>
      <BookedDollars>3.1</BookedDollars>
      <ContractSigned>true</ContractSigned>
      <CustomerId>sample string 1</CustomerId>
      <PriceLevel>List</PriceLevel>
    </ClsBookAPI.ClsGenericNonPaidBookAdd.ClsGenericNonPaidBookSplitAdd>
    <ClsBookAPI.ClsGenericNonPaidBookAdd.ClsGenericNonPaidBookSplitAdd>
      <BookPayMethodGuid>6ef542d1-aead-48d4-a1fa-c84bbbc1b544</BookPayMethodGuid>
      <BookedDollars>3.1</BookedDollars>
      <ContractSigned>true</ContractSigned>
      <CustomerId>sample string 1</CustomerId>
      <PriceLevel>List</PriceLevel>
    </ClsBookAPI.ClsGenericNonPaidBookAdd.ClsGenericNonPaidBookSplitAdd>
  </GenericNonPaidBookSplitsAdd>
  <GrowerId>sample string 3</GrowerId>
  <LocationId>sample string 1</LocationId>
  <ProdClassFlag>14</ProdClassFlag>
  <SalespersonId>sample string 5</SalespersonId>
  <SellerSignatureDateSignedToPrint>2026-04-13T07:52:05.5264823+00:00</SellerSignatureDateSignedToPrint>
  <SellerSignatureDateTimeSignedUtc>2026-04-13T07:52:05.5264823+00:00</SellerSignatureDateTimeSignedUtc>
  <StartDate>sample string 11</StartDate>
  <Term>sample string 8</Term>
</GenericNonPaidBookAdd>

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

Response Information

Resource Description

Creates a new Generic Non-Paid Booking

AgvBooking
NameDescriptionTypeAdditional Information
Status

Status of the API call.

string
Message

Message of the API call.

string
ErrorList

List of error messages of the API call.

Collection of string
Count

Count of how many Bookings.

string
BookingRecords

JSON dictionary of BookRecords.

Collection of clsAPIBook

Response Formats

application/json, text/json

Sample:
{
  "Status": "sample string 1",
  "Message": "sample string 2",
  "ErrorList": [
    "sample string 1",
    "sample string 2"
  ],
  "Count": "2",
  "BookingRecords": [
    {
      "BookDate": "sample string 1",
      "BookLocation": "sample string 2",
      "BookNumber": "sample string 3",
      "BookGuid": "5cf641c6-0fe8-4076-9d82-2b8aa24a142a",
      "BookingRecordHeaderDetails": null,
      "BookingRecordSplitDetails": [],
      "BookingRecordLineItemDetails": [],
      "BookingRecordAnalysisDetails": []
    },
    {
      "BookDate": "sample string 1",
      "BookLocation": "sample string 2",
      "BookNumber": "sample string 3",
      "BookGuid": "5cf641c6-0fe8-4076-9d82-2b8aa24a142a",
      "BookingRecordHeaderDetails": null,
      "BookingRecordSplitDetails": [],
      "BookingRecordLineItemDetails": [],
      "BookingRecordAnalysisDetails": []
    }
  ]
}

application/xml

Sample:

An exception has occurred while using the formatter 'XmlMediaTypeFormatter' to generate sample for media type 'application/xml'. Exception message: Cannot serialize the DataTable. DataTable name is not set.

text/xml

Sample:

An exception has occurred while using the formatter 'XmlMediaTypeFormatter' to generate sample for media type 'text/xml'. Exception message: Cannot serialize the DataTable. DataTable name is not set.