> For the complete documentation index, see [llms.txt](https://docs.xorosoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xorosoft.com/developers-api/third-party-logistics-3pl/list-sales-orders.md).
# List Sales Orders
The API retrieves a list of sales orders based on the provided 3PL account token from the data source. The API response supports paging, facilitating efficient navigation through the returned data.
```json
{"openapi":"3.0.3","info":{"title":"Xorosoft ERP Public API","version":"2026.07"},"tags":[{"name":"Third-Party Logistics (3PL)","description":"Use 3PL APIs when a warehouse or logistics provider needs account-specific access to customer orders, inventory, purchase orders, RMAs, bills, item receipts, packing slips, and related documents. 3PL requests use the 3PL account token generated in Xorosoft ERP so data access can be limited to the connected client account."}],"servers":[{"url":"https://res.xorosoft.io","description":"Xorosoft ERP API server"}],"security":[{"basic":[]}],"components":{"securitySchemes":{"basic":{"scheme":"basic","type":"http"}}},"paths":{"/api/xerp/account3pl/getsalesorder":{"get":{"parameters":[{"description":"A comma-separated list of sales order ids","in":"query","name":"id","required":false,"schema":{"type":"number"}},{"description":"A comma-separated list of sales order numbers","in":"query","name":"order_number","required":false,"schema":{"type":"string"}},{"description":"A comma-separated list of customer names","in":"query","name":"customer_name","required":false,"schema":{"type":"string"}},{"description":"A comma-separated list of store names","in":"query","name":"store_name","required":false,"schema":{"type":"string"}},{"description":"A comma-separated list of third party reference numbers","in":"query","name":"third_party_ref_no","required":false,"schema":{"type":"string"}},{"description":"A comma-separated list of sales order reference numbers","in":"query","name":"ref_no","required":false,"schema":{"type":"string"}},{"description":"Restrict results to after the specified ID","in":"query","name":"since_id","required":false,"schema":{"type":"string"}},{"description":"Show sales orders created at or after date (format: 2014-04-25T16:15:47-04:00)","in":"query","name":"created_at_min","required":false,"schema":{"type":"string"}},{"description":"Show sales orders updated at or after date (format: 2014-04-25T16:15:47-04:00)","in":"query","name":"updated_at_min","required":false,"schema":{"type":"string"}},{"description":"Show sales orders created at or before date (format: 2014-04-25T16:15:47-04:00)","in":"query","name":"created_at_max","required":false,"schema":{"type":"string"}},{"description":"Show sales orders updated at or before date (format: 2014-04-25T16:15:47-04:00)","in":"query","name":"updated_at_max","required":false,"schema":{"type":"string"}},{"description":"A comma-separated list of statuses","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"description":"Page number for the query result set. Default = 1","in":"query","name":"page","required":true,"schema":{"type":"number"}},{"description":"A unique authentication token assigned to each 3PL account within the system","in":"query","name":"account_token","required":true,"schema":{"type":"string"}},{"description":"This will exclude processed orders","in":"query","name":"exclude_processed","required":false,"schema":{"type":"string"}},{"name":"sale_store_name","in":"query","required":false,"description":"Sales store name used to filter or assign the transaction.","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"Data":{"items":{"properties":{"SoEstimateHeader":{"properties":{"ACHAccountDataId":{"type":"number","nullable":true},"ACHPaymentMethodName":{"type":"string","nullable":true},"ACHPaymentStatusId":{"type":"number","nullable":true},"ACHPaymentStatusName":{"type":"string","nullable":true},"ACHRefundStatusId":{"type":"number","nullable":true},"ACHRefundStatusName":{"type":"string","nullable":true},"Account3plId":{"type":"number"},"Account3plName":{"type":"string","nullable":true},"AccountCode3PL":{"type":"string","nullable":true},"AllocatableAmount":{"type":"number"},"AllocationPercentage":{"type":"number"},"AllocationPercentagePreview":{"type":"number"},"AllocationStatusId":{"type":"number","nullable":true},"AllocationStatusName":{"type":"string","nullable":true},"ApplyPricingRule":{"type":"boolean"},"ApprovalStatusChangeDttm":{"type":"string","nullable":true},"ApprovalStatusChangeSource":{"type":"string","nullable":true},"ApprovalStatusName":{"type":"string","nullable":true},"Attachment":{"type":"string","nullable":true},"AuthorizationDetailList":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true},"AutoCreateCarrierFlag":{"type":"boolean"},"AutoCreateCustomer":{"type":"boolean"},"AutoDepositTotalAmount":{"type":"number","nullable":true},"AutoProcessPayment":{"type":"boolean"},"AutoProcessPaymentId":{"type":"number","nullable":true},"AutoReleaseSalesOrder":{"type":"boolean"},"AutoWaveSalesOrder":{"type":"boolean"},"BillToAddr":{"type":"string"},"BillToAddr2":{"type":"string"},"BillToAddrName":{"type":"string","nullable":true},"BillToCity":{"type":"string"},"BillToCompanyName":{"type":"string"},"BillToCountry":{"type":"string"},"BillToCountryISO2":{"type":"string","nullable":true},"BillToEmail":{"type":"string"},"BillToFirstName":{"type":"string"},"BillToLastName":{"type":"string"},"BillToName":{"type":"string"},"BillToPhoneNumber":{"type":"string"},"BillToState":{"type":"string"},"BillToStateAbbr":{"type":"string","nullable":true},"BillToZip":{"type":"string","nullable":true},"BillToZpCode":{"type":"string"},"BrandId":{"type":"number","nullable":true},"BrandName":{"type":"string","nullable":true},"BuyerId":{"type":"number","nullable":true},"BuyerName":{"type":"string","nullable":true},"CampaignId":{"type":"number","nullable":true},"CampaignName":{"type":"string","nullable":true},"CancelledFlag":{"type":"boolean"},"CaptureLater":{"type":"boolean"},"CardId":{"type":"number","nullable":true},"CardNumber":{"type":"number","nullable":true},"CardPaymentProcessedFlag":{"type":"boolean"},"CarrierCode":{"type":"string","nullable":true},"CarrierId":{"type":"number"},"CarrierName":{"type":"string"},"CartonBreakRuleId":{"type":"number","nullable":true},"ChargeId":{"type":"number","nullable":true},"ChargeTypeId":{"type":"number","nullable":true},"CombineLines":{"type":"boolean"},"CreateDttm":{"type":"string"},"CreateSource":{"type":"string"},"CreditMemoCount":{"type":"number","nullable":true},"CreditMemoNumber":{"type":"number","nullable":true},"CurrencyCode":{"type":"string"},"CurrencyId":{"type":"number"},"CurrencyName":{"type":"string"},"CurrencySymbol":{"type":"string"},"CustomComment":{"type":"string","nullable":true},"CustomFieldH1":{"type":"string","nullable":true},"CustomFieldH10":{"type":"string","nullable":true},"CustomFieldH11":{"type":"string","nullable":true},"CustomFieldH12":{"type":"string","nullable":true},"CustomFieldH13":{"type":"string","nullable":true},"CustomFieldH14":{"type":"string","nullable":true},"CustomFieldH15":{"type":"string","nullable":true},"CustomFieldH16":{"type":"string","nullable":true},"CustomFieldH17":{"type":"string","nullable":true},"CustomFieldH18":{"type":"string","nullable":true},"CustomFieldH19":{"type":"string","nullable":true},"CustomFieldH2":{"type":"string","nullable":true},"CustomFieldH20":{"type":"string","nullable":true},"CustomFieldH21":{"type":"string","nullable":true},"CustomFieldH22":{"type":"string","nullable":true},"CustomFieldH23":{"type":"string","nullable":true},"CustomFieldH24":{"type":"string","nullable":true},"CustomFieldH25":{"type":"string","nullable":true},"CustomFieldH26":{"type":"string","nullable":true},"CustomFieldH27":{"type":"string","nullable":true},"CustomFieldH28":{"type":"string","nullable":true},"CustomFieldH29":{"type":"string","nullable":true},"CustomFieldH3":{"type":"string","nullable":true},"CustomFieldH30":{"type":"string","nullable":true},"CustomFieldH31":{"type":"string","nullable":true},"CustomFieldH32":{"type":"string","nullable":true},"CustomFieldH33":{"type":"string","nullable":true},"CustomFieldH34":{"type":"string","nullable":true},"CustomFieldH35":{"type":"string","nullable":true},"CustomFieldH36":{"type":"string","nullable":true},"CustomFieldH37":{"type":"string","nullable":true},"CustomFieldH38":{"type":"string","nullable":true},"CustomFieldH39":{"type":"string","nullable":true},"CustomFieldH4":{"type":"string","nullable":true},"CustomFieldH40":{"type":"string","nullable":true},"CustomFieldH41":{"type":"string","nullable":true},"CustomFieldH42":{"type":"string","nullable":true},"CustomFieldH43":{"type":"string","nullable":true},"CustomFieldH44":{"type":"string","nullable":true},"CustomFieldH45":{"type":"string","nullable":true},"CustomFieldH46":{"type":"string","nullable":true},"CustomFieldH47":{"type":"string","nullable":true},"CustomFieldH48":{"type":"string","nullable":true},"CustomFieldH49":{"type":"string","nullable":true},"CustomFieldH5":{"type":"string","nullable":true},"CustomFieldH50":{"type":"string","nullable":true},"CustomFieldH6":{"type":"string","nullable":true},"CustomFieldH7":{"type":"string","nullable":true},"CustomFieldH8":{"type":"string","nullable":true},"CustomFieldH9":{"type":"string","nullable":true},"Customer3plTypeName":{"type":"string","nullable":true},"CustomerAccountNumber":{"type":"number","nullable":true},"CustomerContact":{"type":"string"},"CustomerDefaultBillingEmail":{"type":"string","nullable":true},"CustomerDefaultOrderTypeName":{"type":"string","nullable":true},"CustomerDefaultProjectClassName":{"type":"string","nullable":true},"CustomerDefaultShipmentupdatesEmail":{"type":"string","nullable":true},"CustomerDepositCount":{"type":"number","nullable":true},"CustomerEmailCC":{"type":"string","nullable":true},"CustomerEmailMain":{"type":"string"},"CustomerFirstName":{"type":"string","nullable":true},"CustomerFullName":{"type":"string","nullable":true},"CustomerGroupId":{"type":"number","nullable":true},"CustomerGroupName":{"type":"string","nullable":true},"CustomerId":{"type":"number","nullable":true},"CustomerLastName":{"type":"string","nullable":true},"CustomerMainPhone":{"type":"string"},"CustomerMessage":{"type":"string"},"CustomerName":{"type":"string","nullable":true},"CustomerPO":{"type":"string"},"CustomerParentName":{"type":"string","nullable":true},"CustomerServiceRepFullName":{"type":"string","nullable":true},"CustomerServiceRepId":{"type":"number","nullable":true},"CustomerTags":{"type":"string","nullable":true},"CustomerTaxCodeId":{"type":"number","nullable":true},"CustomerTypeName":{"type":"string","nullable":true},"Cvc":{"type":"string","nullable":true},"DateFirstShip":{"type":"string","nullable":true},"DateFulFilled":{"type":"string","nullable":true},"DateLastShip":{"type":"string","nullable":true},"DateRelease":{"type":"string"},"DateTimeCancelled":{"type":"string","nullable":true},"DateToBeCancelled":{"type":"string","nullable":true},"DateToBeShipped":{"type":"string"},"DefaultLocationId":{"type":"number","nullable":true},"DefaultLocationName":{"type":"string","nullable":true},"DepositAccountName":{"type":"string","nullable":true},"DepositAmount":{"type":"number","nullable":true},"DepositDue":{"type":"number"},"DepositEmailSentCount":{"type":"number"},"DepositEmailSentFlag":{"type":"boolean"},"DepositPercentage":{"type":"string","nullable":true},"DepositRefundedAmount":{"type":"number"},"DepositRemainingAmount":{"type":"number"},"DepositRequiredAmount":{"type":"number","nullable":true},"DepositRequiredFlag":{"type":"boolean"},"DepositRequiredType":{"type":"string","nullable":true},"DepositRequiredTypeName":{"type":"string","nullable":true},"DiscountAmount":{"type":"number"},"DocumentUrl":{"type":"string"},"DutyPaymentTerms":{"type":"string","nullable":true},"DutyPaymentTermsCode":{"type":"string","nullable":true},"DutyPaymentTermsId":{"type":"number","nullable":true},"EIN":{"type":"string","nullable":true},"EdiDocRespMessage":{"type":"string","nullable":true},"EdiDocStatus":{"type":"string","nullable":true},"EdiNextActionId":{"type":"number","nullable":true},"EdiNextActionName":{"type":"string","nullable":true},"Email":{"type":"string","nullable":true},"EntityUseCode":{"type":"string","nullable":true},"EstimateFollowUpDate":{"type":"string","nullable":true},"EstimateToSoFlag":{"type":"boolean"},"EstimateValidUntilDate":{"type":"string","nullable":true},"ExceptionFlag":{"type":"boolean"},"ExchangeRate":{"type":"number"},"ExchangeRateFormula":{"type":"string","nullable":true},"ExpirationMonth":{"type":"string","nullable":true},"ExpirationYear":{"type":"string","nullable":true},"FillRateFailedFlag":{"type":"boolean"},"FobId":{"type":"number","nullable":true},"FobName":{"type":"string"},"FullfillmentPercentage":{"type":"number"},"HasRestrictionFlag":{"type":"boolean"},"HtmlBody":{"type":"string","nullable":true},"ImageList":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true},"InCompleteTaskCount":{"type":"number"},"IntAccntId":{"type":"number","nullable":true},"InvoiceCounter":{"type":"number"},"InvoiceCreditMemo":{"type":"string","nullable":true},"InvoiceNumberStatusName":{"type":"string","nullable":true},"IsAccount3plApiRequest":{"type":"boolean"},"IsAutoPaymentFlag":{"type":"boolean"},"IsBcPstTaxExempt":{"type":"boolean"},"IsClosed":{"type":"boolean"},"IsCreatedBySalesRepFlag":{"type":"boolean"},"IsCreatedFromB2BFlag":{"type":"boolean"},"IsCustomerTaxExempt":{"type":"boolean"},"IsDropshipFlag":{"type":"boolean"},"IsEdiAckRequiredFlag":{"type":"boolean"},"IsEdiConfirmationSentFlag":{"type":"boolean"},"IsEdiFlag":{"type":"boolean"},"IsEstimateModule":{"type":"boolean"},"IsLeadOrder":{"type":"boolean"},"IsMbPstTaxExempt":{"type":"boolean"},"IsOrderTaxExempt":{"type":"boolean"},"IsPackAndHold":{"type":"boolean"},"IsPackAndHoldReleased":{"type":"boolean"},"IsQbPstTaxExempt":{"type":"boolean"},"IsSkPstTaxExempt":{"type":"boolean"},"IsTaxableFlag":{"type":"number"},"IsVASCompleted":{"type":"boolean"},"IsVASRequired":{"type":"boolean"},"IsVoidTransaction":{"type":"boolean"},"ItemQualityCode":{"type":"string","nullable":true},"ItemQualityId":{"type":"number","nullable":true},"ItemQualityName":{"type":"string","nullable":true},"LastDateToBeShipped":{"type":"string","nullable":true},"LastDepositEmailSentDttm":{"type":"string","nullable":true},"LastDepositEmailSentSource":{"type":"string"},"LiabilityAccountName":{"type":"string","nullable":true},"LineCount":{"type":"number"},"LinkCreditAmount":{"type":"number"},"LinkedCreditMemo":{"type":"string","nullable":true},"LinkedMO":{"type":"string","nullable":true},"LinkedMOId":{"type":"number","nullable":true},"LinkedMONumber":{"type":"number","nullable":true},"LinkedMOStatus":{"type":"string","nullable":true},"LinkedOrderRefNumber":{"type":"number","nullable":true},"LockFlag":{"type":"boolean"},"MappedCreditMemos":{"type":"string","nullable":true},"Memo":{"type":"string"},"MerchantResponseData":{"type":"string","nullable":true},"MerchantReturnRefNumber":{"type":"number","nullable":true},"MerchantTypeId":{"type":"number","nullable":true},"MinimumATSPercent":{"type":"number"},"MoNumberStatusName":{"type":"string","nullable":true},"ModifyDttm":{"type":"string","nullable":true},"ModifySource":{"type":"string"},"NameOnCard":{"type":"string","nullable":true},"NoTaxCompareFlag":{"type":"boolean"},"NoTaxServiceRequestFlag":{"type":"boolean","nullable":true},"OrderClassCode":{"type":"string"},"OrderClassName":{"type":"string"},"OrderDate":{"type":"string"},"OrderNumber":{"type":"string"},"OrderRefId":{"type":"number","nullable":true},"OrderRefNumber":{"type":"number","nullable":true},"OrderTxnTypeId":{"type":"number","nullable":true},"OrderTypeCode":{"type":"string","nullable":true},"OrderTypeName":{"type":"string","nullable":true},"PONumbers":{"type":"string","nullable":true},"PackedDttm":{"type":"string","nullable":true},"PackingSlipNumbers":{"type":"string","nullable":true},"PaymentAmount":{"type":"number"},"PaymentCurrencyId":{"type":"number"},"PaymentMethodName":{"type":"string","nullable":true},"PaymentProcessed":{"type":"boolean"},"PaymentReceipt":{"type":"string","nullable":true},"PaymentRefNumber":{"type":"number","nullable":true},"PaymentServiceAccountId":{"type":"number"},"PaymentTermsId":{"type":"number"},"PaymentTermsName":{"type":"string"},"PresentationCode":{"type":"string","nullable":true},"PresentationId":{"type":"number","nullable":true},"PresentationName":{"type":"string","nullable":true},"PriorityCode":{"type":"string","nullable":true},"PriorityId":{"type":"number","nullable":true},"PriorityName":{"type":"string"},"ProcessACHPayment":{"type":"boolean"},"ProcessCreditCard":{"type":"boolean"},"ProcessedTxnLogElemId":{"type":"number","nullable":true},"ProjectClassId":{"type":"number","nullable":true},"ProjectClassName":{"type":"string"},"PromiseDate":{"type":"string","nullable":true},"QtyToAllocateAfter":{"type":"number"},"QtyToAllocateBefore":{"type":"number"},"ReCalcShippingTaxesFlag":{"type":"boolean"},"ReCalcTaxesFlag":{"type":"boolean"},"ReadyToShipDttm":{"type":"string","nullable":true},"RecalculateTaxes":{"type":"boolean"},"RefId":{"type":"number","nullable":true},"RefNo":{"type":"string"},"ReportDataObj":{"properties":{"EntityAccntId":{"type":"string"},"EntityName":{"type":"string"},"EntityObj":{"type":"object","additionalProperties":true,"nullable":true},"ReportEntityId":{"type":"number"},"TxnRefId":{"type":"number"},"TxnRefNumber":{"type":"string"},"TxnTypeId":{"type":"number"},"linkedTxnRefId":{"type":"number","nullable":true}},"type":"object"},"RequirePackAndHold":{"type":"boolean"},"ResidentialFlag":{"type":"boolean"},"RevisionCounter":{"type":"string","nullable":true},"RevisionSoFlag":{"type":"boolean"},"RiskAnalysis":{"type":"string","nullable":true},"SaleStoreId":{"type":"number"},"SaleStoreName":{"type":"string"},"SalesRepFullName":{"type":"string"},"SalesRepId":{"type":"string"},"SaveCardError":{"type":"string","nullable":true},"SaveCreditCardInfo":{"type":"boolean"},"ShipAll":{"type":"boolean"},"ShipFromAddr":{"type":"string"},"ShipFromAddr2":{"type":"string"},"ShipFromAddrName":{"type":"string"},"ShipFromCity":{"type":"string"},"ShipFromCompanyName":{"type":"string"},"ShipFromCountry":{"type":"string"},"ShipFromCountryISO2":{"type":"string"},"ShipFromEmail":{"type":"string"},"ShipFromFirstName":{"type":"string"},"ShipFromLastName":{"type":"string"},"ShipFromName":{"type":"string"},"ShipFromPhoneNumber":{"type":"string"},"ShipFromState":{"type":"string"},"ShipFromStateAbbr":{"type":"string"},"ShipFromZpCode":{"type":"string"},"ShipMethodId":{"type":"number"},"ShipMethodName":{"type":"string"},"ShipPackageTypeId":{"type":"number","nullable":true},"ShipServiceCode":{"type":"string"},"ShipServiceId":{"type":"number"},"ShipServiceName":{"type":"string"},"ShipToAddr":{"type":"string"},"ShipToAddr2":{"type":"string"},"ShipToAddrHashCode":{"type":"number"},"ShipToAddrName":{"type":"string"},"ShipToCity":{"type":"string"},"ShipToCompanyName":{"type":"string"},"ShipToCountry":{"type":"string"},"ShipToCountryISO2":{"type":"string","nullable":true},"ShipToEmail":{"type":"string"},"ShipToFirstName":{"type":"string"},"ShipToLastName":{"type":"string"},"ShipToName":{"type":"string"},"ShipToPhoneNumber":{"type":"string"},"ShipToState":{"type":"string"},"ShipToStateAbbr":{"type":"string","nullable":true},"ShipToZip":{"type":"string","nullable":true},"ShipToZpCode":{"type":"string"},"ShipmentService":{"type":"string","nullable":true},"ShippingAccountNumber":{"type":"string"},"ShippingAmount":{"type":"number"},"ShippingCost":{"type":"number","nullable":true},"ShippingCostInvoiced":{"type":"string","nullable":true},"ShippingCostMarkupOrderTypeName":{"type":"string","nullable":true},"ShippingCostMarkupValue":{"type":"string","nullable":true},"ShippingCostRemaining":{"type":"number"},"ShippingExpenseAccntId":{"type":"number","nullable":true},"ShippingNotes":{"type":"string"},"ShippingTaxCodeId":{"type":"number","nullable":true},"ShippingTaxCodeName":{"type":"string"},"ShippingTaxData":{"properties":{"taxItems":{"items":{},"type":"array"},"totalAmount":{"type":"number"}},"type":"object"},"ShippingTaxItems":{"items":{},"type":"array"},"ShippingTermsId":{"type":"number"},"ShippingTermsName":{"type":"string"},"ShippingTypeId":{"type":"number","nullable":true},"ShippingTypeName":{"type":"string"},"SoBatchId":{"type":"number","nullable":true},"SoBatchNumber":{"type":"number","nullable":true},"SoSubTypeId":{"type":"number","nullable":true},"SoSubTypeName":{"type":"string"},"StagedDttm":{"type":"string","nullable":true},"StatusId":{"type":"number"},"StatusName":{"type":"string"},"StoreId":{"type":"number"},"StoreName":{"type":"string"},"SubTotal":{"type":"number"},"SubTotalExclDiscount":{"type":"number"},"Tags":{"type":"string"},"TaxCalcByAddress":{"type":"boolean"},"TaxCalcByAddressDisable":{"type":"boolean"},"TaxCalcCode":{"type":"string","nullable":true},"TaxCalcType":{"type":"string","nullable":true},"TaxOperationCountryCode":{"type":"string","nullable":true},"TaxServiceHashCode":{"type":"number"},"TaxServiceHashCodeOld":{"type":"number"},"TaxSummaryDataText":{"type":"string","nullable":true},"TemplateId":{"type":"number","nullable":true},"ThirdPartyDefaultSKU":{"type":"string","nullable":true},"ThirdPartyDisplayName":{"type":"string"},"ThirdPartyFulfillmentAccount":{"type":"number","nullable":true},"ThirdPartyFulfillmentRefId":{"type":"number","nullable":true},"ThirdPartyFulfillmentStatus":{"type":"string","nullable":true},"ThirdPartyIconUrl":{"type":"string"},"ThirdPartyNotes":{"type":"string"},"ThirdPartyOrderAlreadyExists":{"type":"boolean"},"ThirdPartyOrderDttm":{"type":"string","nullable":true},"ThirdPartyPaymentGatewayName":{"type":"string"},"ThirdPartyRefName":{"type":"string"},"ThirdPartyRefNo":{"type":"string"},"ThirdPartyShipConfirmationFlag":{"type":"boolean"},"ThirdPartyShippingAppId":{"type":"string"},"ThirdPartyShippingRefNo":{"type":"string"},"ThirdPartySource":{"type":"string"},"ThirdPartyTotalAmount":{"type":"number","nullable":true},"ThirdPartyTotalTaxAmount":{"type":"number"},"ToBeEmailedFlag":{"type":"boolean","nullable":true},"ToBeMailedFlag":{"type":"boolean","nullable":true},"ToBePrintedFlag":{"type":"boolean","nullable":true},"ToStoreDefaultLocationId":{"type":"number","nullable":true},"ToStoreDefaultLocationName":{"type":"string","nullable":true},"TotalAmount":{"type":"number"},"TotalCancelQty":{"type":"number"},"TotalDeposit":{"type":"number"},"TotalDepositAmount":{"type":"number"},"TotalQty":{"type":"number"},"TotalTaskCount":{"type":"number"},"TotalTaxAmount":{"type":"number"},"TotalWaveCount":{"type":"number"},"TotalWeight":{"type":"number"},"TrackingNumber":{"type":"number","nullable":true},"TrackingNumbers":{"type":"string","nullable":true},"TransactionComplete":{"type":"boolean"},"TransferFromStoreId":{"type":"number","nullable":true},"TransferFromStoreName":{"type":"string","nullable":true},"TransferPoId":{"type":"number","nullable":true},"TransferPoNumber":{"type":"string"},"TransferProcessedFlag":{"type":"boolean"},"TransferToStoreId":{"type":"number","nullable":true},"TransferToStoreName":{"type":"string"},"TxnId":{"type":"number","nullable":true},"TxnNumber":{"type":"number"},"TxnTypeId":{"type":"number","nullable":true},"TypeId":{"type":"number"},"TypeName":{"type":"string"},"UpdateEnable":{"type":"boolean"},"UpdateExchangeRateFlag":{"type":"boolean"},"UseDefaultSKUWhenError":{"type":"boolean"},"UseDifferentPaymentServiceAccount":{"type":"boolean"},"VASInstruction":{"type":"string","nullable":true},"VendorPO":{"type":"string"},"WaveId":{"type":"number"},"WaveNumber":{"type":"number","nullable":true},"WeightUomCode":{"type":"string","nullable":true},"WeightUomId":{"type":"number"},"WeightUomName":{"type":"string","nullable":true},"cardLast4Digits":{"type":"string","nullable":true}},"type":"object"},"SoEstimateItemLineArr":{"items":{"properties":{"Account3plId":{"type":"number"},"AllowedSellUOMList":{"type":"boolean","nullable":true},"AlternativeItemNumber1":{"type":"string"},"AlternativeItemNumber2":{"type":"string"},"AlternativeItemNumber3":{"type":"string"},"AmountAllocatedBefore":{"type":"number"},"AmountAllocatedPreview":{"type":"number"},"AuthorizationDetailList":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true},"AutoVoidWaveLine":{"type":"boolean"},"BackOrderQty":{"type":"number","nullable":true},"BasePartNumber":{"type":"string"},"BaseQtyAllocated":{"type":"string","nullable":true},"BaseQtyOrdered":{"type":"number"},"BaseQtyRemainingToShip":{"type":"number"},"BaseQtyShipped":{"type":"number"},"BaseUomCode":{"type":"string"},"BaseUomId":{"type":"number"},"BaseUomName":{"type":"string"},"CancelQty":{"type":"number"},"CancelledFlag":{"type":"boolean"},"CategoryId":{"type":"number","nullable":true},"CloseFlag":{"type":"boolean","nullable":true},"CreateDttm":{"type":"string"},"CreateSource":{"type":"string","nullable":true},"CurrencySymbol":{"type":"string","nullable":true},"CustomFieldD1":{"type":"string"},"CustomFieldD10":{"type":"string"},"CustomFieldD11":{"type":"string"},"CustomFieldD12":{"type":"string"},"CustomFieldD13":{"type":"string"},"CustomFieldD14":{"type":"string"},"CustomFieldD15":{"type":"string"},"CustomFieldD16":{"type":"string"},"CustomFieldD17":{"type":"string"},"CustomFieldD18":{"type":"string"},"CustomFieldD19":{"type":"string"},"CustomFieldD2":{"type":"string"},"CustomFieldD20":{"type":"string"},"CustomFieldD21":{"type":"string"},"CustomFieldD22":{"type":"string"},"CustomFieldD23":{"type":"string"},"CustomFieldD24":{"type":"string"},"CustomFieldD25":{"type":"string"},"CustomFieldD26":{"type":"string"},"CustomFieldD27":{"type":"string"},"CustomFieldD28":{"type":"string"},"CustomFieldD29":{"type":"string"},"CustomFieldD3":{"type":"string"},"CustomFieldD30":{"type":"string"},"CustomFieldD31":{"type":"string"},"CustomFieldD32":{"type":"string"},"CustomFieldD33":{"type":"string"},"CustomFieldD34":{"type":"string"},"CustomFieldD35":{"type":"string"},"CustomFieldD36":{"type":"string"},"CustomFieldD37":{"type":"string"},"CustomFieldD38":{"type":"string"},"CustomFieldD39":{"type":"string"},"CustomFieldD4":{"type":"string"},"CustomFieldD40":{"type":"string"},"CustomFieldD41":{"type":"string"},"CustomFieldD42":{"type":"string"},"CustomFieldD43":{"type":"string"},"CustomFieldD44":{"type":"string"},"CustomFieldD45":{"type":"string"},"CustomFieldD46":{"type":"string"},"CustomFieldD47":{"type":"string"},"CustomFieldD48":{"type":"string"},"CustomFieldD49":{"type":"string"},"CustomFieldD5":{"type":"string"},"CustomFieldD50":{"type":"string"},"CustomFieldD6":{"type":"string"},"CustomFieldD7":{"type":"string"},"CustomFieldD8":{"type":"string"},"CustomFieldD9":{"type":"string"},"CustomerItemNumber":{"type":"string"},"DateFirstShip":{"type":"string","nullable":true},"DateFulfilled":{"type":"string","nullable":true},"DateLastShip":{"type":"string","nullable":true},"DateRelease":{"type":"string","nullable":true},"DateToBeShipped":{"type":"string"},"DefaultSellUomId":{"type":"number"},"DefaultVendorId":{"type":"number","nullable":true},"DefaultVendorName":{"type":"string"},"DeleteFlag":{"type":"boolean"},"Description":{"type":"string"},"Discount":{"type":"number"},"DiscountPerQty":{"type":"number"},"DiscountPerQtyType":{"type":"number"},"DiscountPercentage":{"type":"number"},"DiscountTypeId":{"type":"number"},"DiscountTypeName":{"type":"string","nullable":true},"DropShipItemFlag":{"type":"boolean"},"DropshipPoId":{"type":"number","nullable":true},"DropshipPoLineId":{"type":"number","nullable":true},"DropshipPoNumber":{"type":"number","nullable":true},"DropshipPoStatusId":{"type":"number","nullable":true},"DropshipQty":{"type":"number","nullable":true},"DropshippedQty":{"type":"number","nullable":true},"DynamicMONumber":{"type":"number","nullable":true},"DynamicMOStatus":{"type":"string","nullable":true},"EdiStatusId":{"type":"number"},"EdiStatusName":{"type":"string","nullable":true},"EditState":{"type":"boolean"},"EffectiveUnitPrice":{"type":"number"},"ExternalItemNumber":{"type":"string"},"ForceSalesTaxCode":{"type":"boolean"},"HSCode":{"type":"string","nullable":true},"HasRestriction":{"type":"boolean"},"HeaderAllocationStatusId":{"type":"number"},"Id":{"type":"number"},"ImageList":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true},"ImagePath":{"type":"string"},"IsBomItemFlag":{"type":"boolean"},"IsFixedPrice":{"type":"boolean"},"IsKitHeader":{"type":"boolean"},"IsKitItem":{"type":"boolean"},"IsTaxableFlag":{"type":"boolean"},"IsoCode2":{"type":"string"},"IsoCountryName":{"type":"string"},"ItemBarcode":{"type":"string","nullable":true},"ItemCategoryName":{"type":"string"},"ItemDropShipVendorList":{"items":{},"type":"array"},"ItemForceSalesTaxCodeId":{"type":"number"},"ItemForceSalesTaxCodeName":{"type":"string"},"ItemId":{"type":"number"},"ItemIdentifierCode":{"type":"string","nullable":true},"ItemNotes":{"type":"string","nullable":true},"ItemNumber":{"type":"string"},"ItemQualityCode":{"type":"string","nullable":true},"ItemQualityId":{"type":"number","nullable":true},"ItemQualityName":{"type":"string","nullable":true},"ItemSalesTaxProvinceMapList":{"items":{},"type":"array"},"ItemSubCategoryName":{"type":"string","nullable":true},"ItemTypeId":{"type":"number"},"ItemTypeName":{"type":"string"},"ItemUpc":{"type":"string"},"KitDescConcatenateFlag":{"type":"boolean"},"KitItemFactor":{"type":"number"},"KitUnitPrice":{"type":"number","nullable":true},"LastDateToBeShipped":{"type":"string","nullable":true},"LineAllocationPercentage":{"type":"number"},"LineAllocationStatusId":{"type":"number","nullable":true},"LineNumber":{"type":"number"},"MasterKitId":{"type":"number","nullable":true},"MasterKitKey":{"type":"string"},"MatchFlag":{"type":"boolean"},"MoRefNumbers":{"type":"string"},"ModifyDttm":{"type":"string","nullable":true},"ModifySource":{"type":"string","nullable":true},"Notes":{"type":"string"},"OpenFLag":{"type":"boolean","nullable":true},"Option1Name":{"type":"string"},"Option1Seq":{"type":"number"},"Option1Value":{"type":"string"},"Option1ValueCode":{"type":"string"},"Option2Name":{"type":"string"},"Option2Seq":{"type":"number"},"Option2Value":{"type":"string"},"Option2ValueCode":{"type":"string"},"Option3Seq":{"type":"number","nullable":true},"OrderLineClassCode":{"type":"string","nullable":true},"OrderLineClassName":{"type":"string","nullable":true},"OrderNumber":{"type":"number","nullable":true},"PoLineId":{"type":"number","nullable":true},"ProductHeaderId":{"type":"number"},"ProjectClassId":{"type":"number","nullable":true},"ProjectClassName":{"type":"string"},"Qty":{"type":"number"},"QtyAllocated":{"type":"number"},"QtyAllocatedPreview":{"type":"string","nullable":true},"QtyDecimalFlag":{"type":"boolean"},"QtyOrdered":{"type":"number"},"QtyRemainingToAllocate":{"type":"number"},"QtyRemainingToShip":{"type":"number"},"QtyShipped":{"type":"number"},"ReCalcPricing":{"type":"boolean"},"RefId":{"type":"number","nullable":true},"RestrictionOverrideFlag":{"type":"boolean","nullable":true},"RestrictionOverridePrice":{"type":"number","nullable":true},"RestrictionOverrideUser":{"type":"string"},"SellPkgQty":{"type":"number","nullable":true},"SellUomCode":{"type":"string"},"SellUomId":{"type":"number"},"SellUomName":{"type":"string"},"ShipStoreId":{"type":"number"},"ShipStoreName":{"type":"string"},"SoId":{"type":"number"},"StatusId":{"type":"number"},"StatusName":{"type":"string"},"TaxAmount":{"type":"number"},"TaxCategoryCode":{"type":"string","nullable":true},"TaxCodeId":{"type":"number"},"TaxCodeName":{"type":"string"},"TaxData":{"properties":{"taxItems":{"items":{},"type":"array"},"totalAmount":{"type":"number"}},"type":"object"},"TaxItems":{"items":{},"type":"array"},"ThirdPartyProperties":{"type":"string","nullable":true},"ThirdPartyRefNo":{"type":"string"},"ThirdPartyRefNo2":{"type":"string"},"ThirdPartySourceHeader":{"type":"string","nullable":true},"Title":{"type":"string"},"TotalAmount":{"type":"number"},"TxnTypeId":{"type":"number","nullable":true},"UnitPrice":{"type":"number"},"UomFactor":{"type":"number"},"VASDiscountableFlag":{"type":"boolean"},"VASItemCost":{"type":"number","nullable":true},"VASItemCostTotal":{"type":"number"},"VASItemId":{"type":"number","nullable":true},"VASItemName":{"type":"string"},"VASTaxableFlag":{"type":"boolean"},"VariantInfo":{"type":"string"},"VariantInfoColored":{"type":"string"},"WaveLineId":{"type":"number"},"Weight":{"type":"string","nullable":true},"WeightUomId":{"type":"number"}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"},"IsForwardRequest":{"type":"boolean"},"Message":{"type":"string"},"MessageTitle":{"type":"string","nullable":true},"Result":{"type":"boolean"}},"type":"object"}}},"description":"OK","headers":{}}},"tags":["Third-Party Logistics (3PL)"],"description":"The API retrieves a list of sales orders based on the provided 3PL account token from the data source. The API response supports paging, facilitating efficient navigation through the returned data.","operationId":"get_account3pl_getsalesorder","summary":"List Sales Orders"}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.xorosoft.com/developers-api/third-party-logistics-3pl/list-sales-orders.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.