SmartAcc DynaMod Web API v2024.4 Build 0000 - Local

<back to all web services

CustomerSalesOrdersSimple

Customer Module - Transaction

Customer Sales Order API

Requires Authentication
Required permission:CustomerSalesOrder-Transaction.GET
The following routes are available for this service:
GET/CustomerSalesOrders/simple
GET/CustomerSalesOrders/simple/page/{Page}Get records by given a page numberEach page consists of 20 records
GET/CustomerSalesOrders/simple/SalesOrder/{AcCusSalesOrderMID}Get a record by given a Document NumberHeader and Detail record would be return if found.
GET/CustomerSalesOrders/simple/EditDate/{fromEditDate}/{toEditDate}Get records by given Edit Date rangeDate format yyyy-MM-dd
CustomerSalesOrdersSimple Parameters:
NameParameterData TypeRequiredDescription
Pagepathint?No
AcCusSalesOrderMIDpathstringNo
fromEditDatepathstringNo
toEditDatepathstringNo
CustomerSalesOrdersSimpleResponse Parameters:
NameParameterData TypeRequiredDescription
SalesOrdersformList<CustomerSalesOrderSimple>No
ResponseStatusformResponseStatusNo
CustomerSalesOrderSimple Parameters:
NameParameterData TypeRequiredDescription
DocumentHeaderformAcCusSalesOrderMSimpleNo
DocumentDetailsformList<AcCusSalesOrderDSimple>No
AcCusSalesOrderMSimple Parameters:
NameParameterData TypeRequiredDescription
AcCusSalesOrderMIDformNVARCHAR(20)YesSales Order Number
AcCustomerIDformNVARCHAR(20)YesCustomer ID
AcTermIDformNVARCHAR(20)YesTerm ID
AcSalesmanIDformNVARCHAR(20)NoSalesman ID. Default to customer's salesman if not specified
AcLocationIDformNVARCHAR(20)YesLocation ID
DocumentDateformDATEYesDocument Date
DeliveryDateformDATEYesExpected Delivery Date
DocumentNetAmountformNUMERIC(18,2)YesNet Amount. Before Round Cent Adjustment
DocumentCentBalanceformNUMERIC(18,2)YesRound Cent Adjustment Amount
DocumentFinalAmountformNUMERIC(18,2)YesFinal Amount. After Round Cent Adjustment
RefDocumentNoformNVARCHAR(50)NoReference Number
DocumentRemarkformNVARCHAR(100)NoDocument Remark
ExtraRemark1formNVARCHAR(100)NoExtra Remark 1
ExtraRemark2formNVARCHAR(100)NoExtra Remark 2
ExtraRemark3formNVARCHAR(100)NoExtra Remark 3
ExtraRemark4formNVARCHAR(100)NoExtra Remark 4
DocumentYourReferenceformNVARCHAR(100)NoYour Reference
ShipToRemarkformNVARCHAR(100)NoShip To: Remark
ShipToShipViaformNVARCHAR(20)NoShip To: Ship Via
ShipToAddress1formNVARCHAR(MAX)NoShip To: Address 1
ShipToAddress2formNVARCHAR(100)NoShip To: Address 2
ShipToAddress3formNVARCHAR(100)NoShip To: Address 3
ShipToAddress4formNVARCHAR(100)NoShip To: Address 4
ShipToPhone1formNVARCHAR(100)NoShip To: Phone 1
ShipToPhone2formNVARCHAR(100)NoShip To: Phone 1
ShipToFaxformNVARCHAR(100)NoShip To: Fax
ShipToContact1formNVARCHAR(100)NoShip To: Contact 1
ShipToContact2formNVARCHAR(100)NoShip To: Contact 2
ShipToAttentionformNVARCHAR(100)NoShip To: Attention
AcAccountDepartmentIDformNVARCHAR(20)NoAccount Department ID
EditDateformDATETIMEYesEdit Date
AcCusSalesOrderDSimple Parameters:
NameParameterData TypeRequiredDescription
AcCusSalesOrderDIDformNVARCHAR(40)YesRecord ID. Recommend use GUID
AcCusSalesOrderMIDformNVARCHAR(20)YesSales Order Number
ItemNoformINTYesItem Number. Unique in a document.
AcStockIDformNVARCHAR(20)YesStock ID
AcStockUOMIDformNVARCHAR(20)YesStock UOM ID
ItemUnitPriceformNUMERIC(18,4)YesItem Unit Price
ItemQuantityformNUMERIC(18,4)YesItem Quantity
ItemGrossTotalformNUMERIC(18,2)YesItem Gross Total. [Item Unit Price] x [ Item Quantity ]
ItemDiscountAmountformNUMERIC(18,2)YesItem Discount Amount
ItemTotalPriceformNUMERIC(18,2)YesItem Total Price. [(Unit Price x Quantity) - Discount Amount]
ItemRemark1formNVARCHAR(MAX)YesItem Remark 1
AccountNoItemformNVARCHAR(20)NoAccount No Item
AcAccountDepartmentIDformNVARCHAR(20)NoAccount Department ID

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /CustomerSalesOrders/simple HTTP/1.1 
Host: snr2u.com 
Accept: application/xml
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<CustomerSalesOrdersSimpleResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SmartDynaModWebAPI.ServiceModel">
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
  <SalesOrders xmlns:d2p1="http://schemas.datacontract.org/2004/07/SmartDynaModWebAPI.ServiceModel.Types">
    <d2p1:CustomerSalesOrderSimple>
      <d2p1:DocumentDetails>
        <d2p1:AcCusSalesOrderDSimple>
          <d2p1:AcAccountDepartmentID>String</d2p1:AcAccountDepartmentID>
          <d2p1:AcCusSalesOrderDID>String</d2p1:AcCusSalesOrderDID>
          <d2p1:AcCusSalesOrderMID>String</d2p1:AcCusSalesOrderMID>
          <d2p1:AcStockID>String</d2p1:AcStockID>
          <d2p1:AcStockUOMID>String</d2p1:AcStockUOMID>
          <d2p1:AccountNoItem>String</d2p1:AccountNoItem>
          <d2p1:ItemDiscountAmount>0</d2p1:ItemDiscountAmount>
          <d2p1:ItemGrossTotal>0</d2p1:ItemGrossTotal>
          <d2p1:ItemNo>0</d2p1:ItemNo>
          <d2p1:ItemQuantity>0</d2p1:ItemQuantity>
          <d2p1:ItemRemark1>String</d2p1:ItemRemark1>
          <d2p1:ItemTotalPrice>0</d2p1:ItemTotalPrice>
          <d2p1:ItemUnitPrice>0</d2p1:ItemUnitPrice>
        </d2p1:AcCusSalesOrderDSimple>
      </d2p1:DocumentDetails>
      <d2p1:DocumentHeader>
        <d2p1:AcAccountDepartmentID>String</d2p1:AcAccountDepartmentID>
        <d2p1:AcCusSalesOrderMID>String</d2p1:AcCusSalesOrderMID>
        <d2p1:AcCustomerID>String</d2p1:AcCustomerID>
        <d2p1:AcLocationID>String</d2p1:AcLocationID>
        <d2p1:AcSalesmanID>String</d2p1:AcSalesmanID>
        <d2p1:AcTermID>String</d2p1:AcTermID>
        <d2p1:DeliveryDate>0001-01-01T00:00:00</d2p1:DeliveryDate>
        <d2p1:DocumentCentBalance>0</d2p1:DocumentCentBalance>
        <d2p1:DocumentDate>0001-01-01T00:00:00</d2p1:DocumentDate>
        <d2p1:DocumentFinalAmount>0</d2p1:DocumentFinalAmount>
        <d2p1:DocumentNetAmount>0</d2p1:DocumentNetAmount>
        <d2p1:DocumentRemark>String</d2p1:DocumentRemark>
        <d2p1:DocumentYourReference>String</d2p1:DocumentYourReference>
        <d2p1:EditDate>0001-01-01T00:00:00</d2p1:EditDate>
        <d2p1:ExtraRemark1>String</d2p1:ExtraRemark1>
        <d2p1:ExtraRemark2>String</d2p1:ExtraRemark2>
        <d2p1:ExtraRemark3>String</d2p1:ExtraRemark3>
        <d2p1:ExtraRemark4>String</d2p1:ExtraRemark4>
        <d2p1:RefDocumentNo>String</d2p1:RefDocumentNo>
        <d2p1:ShipToAddress1>String</d2p1:ShipToAddress1>
        <d2p1:ShipToAddress2>String</d2p1:ShipToAddress2>
        <d2p1:ShipToAddress3>String</d2p1:ShipToAddress3>
        <d2p1:ShipToAddress4>String</d2p1:ShipToAddress4>
        <d2p1:ShipToAttention>String</d2p1:ShipToAttention>
        <d2p1:ShipToContact1>String</d2p1:ShipToContact1>
        <d2p1:ShipToContact2>String</d2p1:ShipToContact2>
        <d2p1:ShipToFax>String</d2p1:ShipToFax>
        <d2p1:ShipToPhone1>String</d2p1:ShipToPhone1>
        <d2p1:ShipToPhone2>String</d2p1:ShipToPhone2>
        <d2p1:ShipToRemark>String</d2p1:ShipToRemark>
        <d2p1:ShipToShipVia>String</d2p1:ShipToShipVia>
      </d2p1:DocumentHeader>
    </d2p1:CustomerSalesOrderSimple>
  </SalesOrders>
</CustomerSalesOrdersSimpleResponse>