GET SalesOrderV2/GetSalesOrderV2?salesOrderGuid={salesOrderGuid}&orderNumber={orderNumber}&custIdOrGuid={custIdOrGuid}&statusFilter={statusFilter}&processedFilter={processedFilter}

Returns a list of Sales Orders

Request Information

URI Parameters

NameDescriptionTypeAdditional Information
salesOrderGuid

The unique identifier for a specific sales order (optional)

globally unique identifier
orderNumber

The unique user facing identifier for a specific sales order (optional)

integer

Default value is 0

custIdOrGuid

Customer ID or Customer GUID of a customer on a sales order (optional)

string

Default value is string.Empty

statusFilter

The enumeration value to filter the results to a given status. This will be ignored if the salesOrderGuid or orderNumber are set. (optional)

EnumStatusFilter

Default value is All

processedFilter

The enumeration value to filter the results based on the processed setting. The default is to only return the Unprocessed sales orders. This will be ignored if the salesOrderGuid or orderNumber are set. (optional)

EnumProcessedFilter

Default value is OnlyUnprocessed

Body Parameters

Response Information

Resource Description

Returns a list of Sales Orders

AgvSalesOrderV2
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
Count

Number of results returned.

string
SalesOrders

List of Properties and Values returned for each Sales Order that matches the request.

Collection of ClsSalesOrder

Response Formats

application/json, text/json

Sample:
{
  "Status": "sample string 1",
  "Message": "sample string 2",
  "ErrorList": [
    "sample string 1",
    "sample string 2"
  ],
  "Count": "2",
  "SalesOrders": [
    {
      "SalesOrderGUID": "e4c46b35-0884-4307-baaf-199b66947658",
      "OrderNum": 8,
      "OrderDate": "2025-07-11T03:13:30.5706085+00:00",
      "FieldOwnerId": "sample string 10",
      "FieldOwnerGuid": "fb739aac-8715-4541-b131-795bcb142af2",
      "FieldOwnerFirstName": "sample string 11",
      "FieldOwnerLastName": "sample string 12",
      "FieldOwnerName": "sample string 11 sample string 12",
      "FieldId": "sample string 13",
      "FieldGuid": "ee5e3663-c59c-4e58-b1fe-256e50811639",
      "FieldDescription": "sample string 14",
      "BillComment": "sample string 15",
      "EstDelDate": "2025-07-11T03:13:30.5715907+00:00",
      "PickupOrDeliver": 0,
      "PickupOrDeliverAsString": "Pickup",
      "Status": 0,
      "StatusAsString": "Offered",
      "ShipVia": "sample string 17",
      "ShipTo": "sample string 18",
      "County": "sample string 19",
      "Territory": "sample string 20",
      "ControlNum": "sample string 21",
      "SalespersonId": "sample string 22",
      "SalespersonFirstName": "sample string 23",
      "SalespersonLastName": "sample string 24",
      "SalespersonName": "sample string 23 sample string 24",
      "CropId": "sample string 25",
      "CropGuid": "926a0c95-467c-4be7-b7a0-290311094cb5",
      "CustPo": "sample string 26",
      "AuthAgent": "sample string 27",
      "AaRelatedHow": "sample string 28",
      "AaAddr1": "sample string 29",
      "AaAddr2": "sample string 30",
      "AaCity": "sample string 31",
      "AaState": "sample string 32",
      "AaZip": "sample string 33",
      "CustomApplied": true,
      "AddComments": "sample string 35",
      "Acres": 36.1,
      "UnitType": 0,
      "UnitTypeAsString": "A",
      "FedPermit": "sample string 37",
      "FedPermitExpDate": "2025-07-11T03:13:30.5719262+00:00",
      "DiscOpt": "sample string 38",
      "PaymentTermDescription": "sample string 39",
      "ProcessedYn": true,
      "Location": "sample string 41",
      "LocationGuid": "68556c47-94e9-4d83-b73f-0b2ef8e94a1a",
      "LocationName": "sample string 43",
      "OfferExpiresDate": "2025-07-11T03:13:30.5719262+00:00",
      "PaymentDate": "2025-07-11T03:13:30.5719262+00:00",
      "CheckNumber": "sample string 44",
      "StartDate": "2025-07-11T03:13:30.5719262+00:00",
      "ExpirationDate": "2025-07-11T03:13:30.5719262+00:00",
      "AddedByUserId": "sample string 45",
      "AddedByUserGuid": "14e5cf6b-6285-481a-aede-725b86045af4",
      "AddedByUserFirstName": "sample string 46",
      "AddedByUserLastName": "sample string 47",
      "AddedByUserName": "sample string 46 sample string 47",
      "LastEditedUserId": "sample string 48",
      "LastEditedUserGuid": "425ff37c-fb1e-4b97-8d0f-32bf25e0ab60",
      "LastEditedUserFirstName": "sample string 49",
      "LastEditedUserLastName": "sample string 50",
      "LastEditedUserName": "sample string 49 sample string 50",
      "ContractFormat": "sample string 51",
      "Splits": [
        {
          "SalesOrderSplitGUID": "3f2b7bdc-cbf1-4a81-bb4a-218d0309b216",
          "SplitNum": 2,
          "CustId": "sample string 3",
          "CustomerGuid": "ae6e5b63-ffe9-4d93-b795-1bc70e85d942",
          "CustomerFirstName": "sample string 5",
          "CustomerLastName": "sample string 6",
          "CustomerName": "sample string 5 sample string 6",
          "PercentS1": 7.1,
          "PercentS2": 8.1,
          "PercentS3": 9.1,
          "LineItems": [
            {
              "SalesOrderLineItemGUID": "db6e55fe-6d06-43a2-bfd3-9cf2587b4688",
              "LineItem": 2,
              "DeptId": "sample string 3",
              "ProdId": "sample string 4",
              "ProductGuid": "0296c0f9-a77d-4bdd-a935-39aae9f35f3c",
              "ProductDescription": "sample string 6",
              "Quantity": 7.1,
              "QuantityUnits": "sample string 8",
              "Price": 9.1,
              "PriceUnits": "sample string 10",
              "QuantityToPricingRatio": 11.1,
              "PriceLevel": 0,
              "PriceLevelDescription": "sample string 12",
              "SplitNum": 13,
              "SplitPercent": 14.1,
              "LotNumber": "sample string 15",
              "CropCode": "sample string 17",
              "CropCodeGuid": "4983732e-df60-44dd-b3c9-caadb070683a",
              "AllocationNumber": 20,
              "ProdIdAlternate": "sample string 22"
            },
            {
              "SalesOrderLineItemGUID": "db6e55fe-6d06-43a2-bfd3-9cf2587b4688",
              "LineItem": 2,
              "DeptId": "sample string 3",
              "ProdId": "sample string 4",
              "ProductGuid": "0296c0f9-a77d-4bdd-a935-39aae9f35f3c",
              "ProductDescription": "sample string 6",
              "Quantity": 7.1,
              "QuantityUnits": "sample string 8",
              "Price": 9.1,
              "PriceUnits": "sample string 10",
              "QuantityToPricingRatio": 11.1,
              "PriceLevel": 0,
              "PriceLevelDescription": "sample string 12",
              "SplitNum": 13,
              "SplitPercent": 14.1,
              "LotNumber": "sample string 15",
              "CropCode": "sample string 17",
              "CropCodeGuid": "4983732e-df60-44dd-b3c9-caadb070683a",
              "AllocationNumber": 20,
              "ProdIdAlternate": "sample string 22"
            }
          ]
        },
        {
          "SalesOrderSplitGUID": "3f2b7bdc-cbf1-4a81-bb4a-218d0309b216",
          "SplitNum": 2,
          "CustId": "sample string 3",
          "CustomerGuid": "ae6e5b63-ffe9-4d93-b795-1bc70e85d942",
          "CustomerFirstName": "sample string 5",
          "CustomerLastName": "sample string 6",
          "CustomerName": "sample string 5 sample string 6",
          "PercentS1": 7.1,
          "PercentS2": 8.1,
          "PercentS3": 9.1,
          "LineItems": [
            {
              "SalesOrderLineItemGUID": "db6e55fe-6d06-43a2-bfd3-9cf2587b4688",
              "LineItem": 2,
              "DeptId": "sample string 3",
              "ProdId": "sample string 4",
              "ProductGuid": "0296c0f9-a77d-4bdd-a935-39aae9f35f3c",
              "ProductDescription": "sample string 6",
              "Quantity": 7.1,
              "QuantityUnits": "sample string 8",
              "Price": 9.1,
              "PriceUnits": "sample string 10",
              "QuantityToPricingRatio": 11.1,
              "PriceLevel": 0,
              "PriceLevelDescription": "sample string 12",
              "SplitNum": 13,
              "SplitPercent": 14.1,
              "LotNumber": "sample string 15",
              "CropCode": "sample string 17",
              "CropCodeGuid": "4983732e-df60-44dd-b3c9-caadb070683a",
              "AllocationNumber": 20,
              "ProdIdAlternate": "sample string 22"
            },
            {
              "SalesOrderLineItemGUID": "db6e55fe-6d06-43a2-bfd3-9cf2587b4688",
              "LineItem": 2,
              "DeptId": "sample string 3",
              "ProdId": "sample string 4",
              "ProductGuid": "0296c0f9-a77d-4bdd-a935-39aae9f35f3c",
              "ProductDescription": "sample string 6",
              "Quantity": 7.1,
              "QuantityUnits": "sample string 8",
              "Price": 9.1,
              "PriceUnits": "sample string 10",
              "QuantityToPricingRatio": 11.1,
              "PriceLevel": 0,
              "PriceLevelDescription": "sample string 12",
              "SplitNum": 13,
              "SplitPercent": 14.1,
              "LotNumber": "sample string 15",
              "CropCode": "sample string 17",
              "CropCodeGuid": "4983732e-df60-44dd-b3c9-caadb070683a",
              "AllocationNumber": 20,
              "ProdIdAlternate": "sample string 22"
            }
          ]
        }
      ],
      "Applications": [
        {
          "SalesOrderApplicationGUID": "3385cc12-c330-4f37-8c29-8a7623bfef9b",
          "LineItem": 2,
          "ApplicatorId": "sample string 3",
          "ApplicatorFirstName": "sample string 4",
          "ApplicatorLastName": "sample string 5",
          "ApplicatorName": "sample string 4 sample string 5",
          "VehicleId": "sample string 6",
          "Vehicledescription": "sample string 7",
          "Acres": 8.1
        },
        {
          "SalesOrderApplicationGUID": "3385cc12-c330-4f37-8c29-8a7623bfef9b",
          "LineItem": 2,
          "ApplicatorId": "sample string 3",
          "ApplicatorFirstName": "sample string 4",
          "ApplicatorLastName": "sample string 5",
          "ApplicatorName": "sample string 4 sample string 5",
          "VehicleId": "sample string 6",
          "Vehicledescription": "sample string 7",
          "Acres": 8.1
        }
      ],
      "Discounts": [
        {
          "SalesOrderDiscountGUID": "2434466f-0da0-4a1e-a77c-19ecd1d4a259",
          "LineItem": 3,
          "DiscountName": "sample string 4",
          "Quantity": 5.1,
          "Total": 6.1,
          "Manual": 7.1,
          "Rate": 8.1,
          "DiscountType": 0,
          "DiscountTypeAsString": "Percent",
          "SalesOrderDiscountKey": 9
        },
        {
          "SalesOrderDiscountGUID": "2434466f-0da0-4a1e-a77c-19ecd1d4a259",
          "LineItem": 3,
          "DiscountName": "sample string 4",
          "Quantity": 5.1,
          "Total": 6.1,
          "Manual": 7.1,
          "Rate": 8.1,
          "DiscountType": 0,
          "DiscountTypeAsString": "Percent",
          "SalesOrderDiscountKey": 9
        }
      ]
    },
    {
      "SalesOrderGUID": "e4c46b35-0884-4307-baaf-199b66947658",
      "OrderNum": 8,
      "OrderDate": "2025-07-11T03:13:30.5706085+00:00",
      "FieldOwnerId": "sample string 10",
      "FieldOwnerGuid": "fb739aac-8715-4541-b131-795bcb142af2",
      "FieldOwnerFirstName": "sample string 11",
      "FieldOwnerLastName": "sample string 12",
      "FieldOwnerName": "sample string 11 sample string 12",
      "FieldId": "sample string 13",
      "FieldGuid": "ee5e3663-c59c-4e58-b1fe-256e50811639",
      "FieldDescription": "sample string 14",
      "BillComment": "sample string 15",
      "EstDelDate": "2025-07-11T03:13:30.5715907+00:00",
      "PickupOrDeliver": 0,
      "PickupOrDeliverAsString": "Pickup",
      "Status": 0,
      "StatusAsString": "Offered",
      "ShipVia": "sample string 17",
      "ShipTo": "sample string 18",
      "County": "sample string 19",
      "Territory": "sample string 20",
      "ControlNum": "sample string 21",
      "SalespersonId": "sample string 22",
      "SalespersonFirstName": "sample string 23",
      "SalespersonLastName": "sample string 24",
      "SalespersonName": "sample string 23 sample string 24",
      "CropId": "sample string 25",
      "CropGuid": "926a0c95-467c-4be7-b7a0-290311094cb5",
      "CustPo": "sample string 26",
      "AuthAgent": "sample string 27",
      "AaRelatedHow": "sample string 28",
      "AaAddr1": "sample string 29",
      "AaAddr2": "sample string 30",
      "AaCity": "sample string 31",
      "AaState": "sample string 32",
      "AaZip": "sample string 33",
      "CustomApplied": true,
      "AddComments": "sample string 35",
      "Acres": 36.1,
      "UnitType": 0,
      "UnitTypeAsString": "A",
      "FedPermit": "sample string 37",
      "FedPermitExpDate": "2025-07-11T03:13:30.5719262+00:00",
      "DiscOpt": "sample string 38",
      "PaymentTermDescription": "sample string 39",
      "ProcessedYn": true,
      "Location": "sample string 41",
      "LocationGuid": "68556c47-94e9-4d83-b73f-0b2ef8e94a1a",
      "LocationName": "sample string 43",
      "OfferExpiresDate": "2025-07-11T03:13:30.5719262+00:00",
      "PaymentDate": "2025-07-11T03:13:30.5719262+00:00",
      "CheckNumber": "sample string 44",
      "StartDate": "2025-07-11T03:13:30.5719262+00:00",
      "ExpirationDate": "2025-07-11T03:13:30.5719262+00:00",
      "AddedByUserId": "sample string 45",
      "AddedByUserGuid": "14e5cf6b-6285-481a-aede-725b86045af4",
      "AddedByUserFirstName": "sample string 46",
      "AddedByUserLastName": "sample string 47",
      "AddedByUserName": "sample string 46 sample string 47",
      "LastEditedUserId": "sample string 48",
      "LastEditedUserGuid": "425ff37c-fb1e-4b97-8d0f-32bf25e0ab60",
      "LastEditedUserFirstName": "sample string 49",
      "LastEditedUserLastName": "sample string 50",
      "LastEditedUserName": "sample string 49 sample string 50",
      "ContractFormat": "sample string 51",
      "Splits": [
        {
          "SalesOrderSplitGUID": "3f2b7bdc-cbf1-4a81-bb4a-218d0309b216",
          "SplitNum": 2,
          "CustId": "sample string 3",
          "CustomerGuid": "ae6e5b63-ffe9-4d93-b795-1bc70e85d942",
          "CustomerFirstName": "sample string 5",
          "CustomerLastName": "sample string 6",
          "CustomerName": "sample string 5 sample string 6",
          "PercentS1": 7.1,
          "PercentS2": 8.1,
          "PercentS3": 9.1,
          "LineItems": [
            {
              "SalesOrderLineItemGUID": "db6e55fe-6d06-43a2-bfd3-9cf2587b4688",
              "LineItem": 2,
              "DeptId": "sample string 3",
              "ProdId": "sample string 4",
              "ProductGuid": "0296c0f9-a77d-4bdd-a935-39aae9f35f3c",
              "ProductDescription": "sample string 6",
              "Quantity": 7.1,
              "QuantityUnits": "sample string 8",
              "Price": 9.1,
              "PriceUnits": "sample string 10",
              "QuantityToPricingRatio": 11.1,
              "PriceLevel": 0,
              "PriceLevelDescription": "sample string 12",
              "SplitNum": 13,
              "SplitPercent": 14.1,
              "LotNumber": "sample string 15",
              "CropCode": "sample string 17",
              "CropCodeGuid": "4983732e-df60-44dd-b3c9-caadb070683a",
              "AllocationNumber": 20,
              "ProdIdAlternate": "sample string 22"
            },
            {
              "SalesOrderLineItemGUID": "db6e55fe-6d06-43a2-bfd3-9cf2587b4688",
              "LineItem": 2,
              "DeptId": "sample string 3",
              "ProdId": "sample string 4",
              "ProductGuid": "0296c0f9-a77d-4bdd-a935-39aae9f35f3c",
              "ProductDescription": "sample string 6",
              "Quantity": 7.1,
              "QuantityUnits": "sample string 8",
              "Price": 9.1,
              "PriceUnits": "sample string 10",
              "QuantityToPricingRatio": 11.1,
              "PriceLevel": 0,
              "PriceLevelDescription": "sample string 12",
              "SplitNum": 13,
              "SplitPercent": 14.1,
              "LotNumber": "sample string 15",
              "CropCode": "sample string 17",
              "CropCodeGuid": "4983732e-df60-44dd-b3c9-caadb070683a",
              "AllocationNumber": 20,
              "ProdIdAlternate": "sample string 22"
            }
          ]
        },
        {
          "SalesOrderSplitGUID": "3f2b7bdc-cbf1-4a81-bb4a-218d0309b216",
          "SplitNum": 2,
          "CustId": "sample string 3",
          "CustomerGuid": "ae6e5b63-ffe9-4d93-b795-1bc70e85d942",
          "CustomerFirstName": "sample string 5",
          "CustomerLastName": "sample string 6",
          "CustomerName": "sample string 5 sample string 6",
          "PercentS1": 7.1,
          "PercentS2": 8.1,
          "PercentS3": 9.1,
          "LineItems": [
            {
              "SalesOrderLineItemGUID": "db6e55fe-6d06-43a2-bfd3-9cf2587b4688",
              "LineItem": 2,
              "DeptId": "sample string 3",
              "ProdId": "sample string 4",
              "ProductGuid": "0296c0f9-a77d-4bdd-a935-39aae9f35f3c",
              "ProductDescription": "sample string 6",
              "Quantity": 7.1,
              "QuantityUnits": "sample string 8",
              "Price": 9.1,
              "PriceUnits": "sample string 10",
              "QuantityToPricingRatio": 11.1,
              "PriceLevel": 0,
              "PriceLevelDescription": "sample string 12",
              "SplitNum": 13,
              "SplitPercent": 14.1,
              "LotNumber": "sample string 15",
              "CropCode": "sample string 17",
              "CropCodeGuid": "4983732e-df60-44dd-b3c9-caadb070683a",
              "AllocationNumber": 20,
              "ProdIdAlternate": "sample string 22"
            },
            {
              "SalesOrderLineItemGUID": "db6e55fe-6d06-43a2-bfd3-9cf2587b4688",
              "LineItem": 2,
              "DeptId": "sample string 3",
              "ProdId": "sample string 4",
              "ProductGuid": "0296c0f9-a77d-4bdd-a935-39aae9f35f3c",
              "ProductDescription": "sample string 6",
              "Quantity": 7.1,
              "QuantityUnits": "sample string 8",
              "Price": 9.1,
              "PriceUnits": "sample string 10",
              "QuantityToPricingRatio": 11.1,
              "PriceLevel": 0,
              "PriceLevelDescription": "sample string 12",
              "SplitNum": 13,
              "SplitPercent": 14.1,
              "LotNumber": "sample string 15",
              "CropCode": "sample string 17",
              "CropCodeGuid": "4983732e-df60-44dd-b3c9-caadb070683a",
              "AllocationNumber": 20,
              "ProdIdAlternate": "sample string 22"
            }
          ]
        }
      ],
      "Applications": [
        {
          "SalesOrderApplicationGUID": "3385cc12-c330-4f37-8c29-8a7623bfef9b",
          "LineItem": 2,
          "ApplicatorId": "sample string 3",
          "ApplicatorFirstName": "sample string 4",
          "ApplicatorLastName": "sample string 5",
          "ApplicatorName": "sample string 4 sample string 5",
          "VehicleId": "sample string 6",
          "Vehicledescription": "sample string 7",
          "Acres": 8.1
        },
        {
          "SalesOrderApplicationGUID": "3385cc12-c330-4f37-8c29-8a7623bfef9b",
          "LineItem": 2,
          "ApplicatorId": "sample string 3",
          "ApplicatorFirstName": "sample string 4",
          "ApplicatorLastName": "sample string 5",
          "ApplicatorName": "sample string 4 sample string 5",
          "VehicleId": "sample string 6",
          "Vehicledescription": "sample string 7",
          "Acres": 8.1
        }
      ],
      "Discounts": [
        {
          "SalesOrderDiscountGUID": "2434466f-0da0-4a1e-a77c-19ecd1d4a259",
          "LineItem": 3,
          "DiscountName": "sample string 4",
          "Quantity": 5.1,
          "Total": 6.1,
          "Manual": 7.1,
          "Rate": 8.1,
          "DiscountType": 0,
          "DiscountTypeAsString": "Percent",
          "SalesOrderDiscountKey": 9
        },
        {
          "SalesOrderDiscountGUID": "2434466f-0da0-4a1e-a77c-19ecd1d4a259",
          "LineItem": 3,
          "DiscountName": "sample string 4",
          "Quantity": 5.1,
          "Total": 6.1,
          "Manual": 7.1,
          "Rate": 8.1,
          "DiscountType": 0,
          "DiscountTypeAsString": "Percent",
          "SalesOrderDiscountKey": 9
        }
      ]
    }
  ]
}

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 'LastEditedUserName' in type 'SSI.plbl.ClsSalesOrder'.

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 'LastEditedUserName' in type 'SSI.plbl.ClsSalesOrder'.