PUT ApPurchaseOrder/PutApPurchaseOrder
Updates an AP Purchase Order.
Request Information
URI Parameters
Body Parameters
The AP Purchase Order object used to update an AP Purchase Order.
ClsApPoUpdateName | Description | Type | Additional Information |
---|---|---|---|
Vendor |
The Vendor ID the AP Purchase Order is for. The combination of Vendor, Invoice, and Bill Date are what uniquely identify an AP Purchase Order. |
string |
Max length: 10 |
InvoiceNumber |
The number of the Invoice the AP Purchase Order paid. One of the values returned by the GetApBill method of the API. |
string |
Max length: 25 |
Description |
User entered descript or short note about the AP Purchase Order. |
string |
Max length: 40 |
BillDate |
The date of the purchase order. |
string |
Required Data type: DateTime Format must be MM/dd/yyyy |
PONumber |
The Purchase Order Number for the purchase order. |
string |
Max length: 10 |
PaidByDate1 |
The date to pay the purchase order by in order to receive discount1. |
string |
Data type: DateTime Format must be MM/dd/yyyy |
PaidByDate2 |
The date to pay the purchase order by in order to receive discount2. |
string |
Data type: DateTime Format must be MM/dd/yyyy |
PaidByDate3 |
The date to pay the purchase order by in order to receive discount3. |
string |
Data type: DateTime Format must be MM/dd/yyyy |
PaidByDate4 |
The date to pay the purchase order by in order to receive discount4. |
string |
Data type: DateTime Format must be MM/dd/yyyy |
PaidByDate5 |
The date to pay the purchase order by in order to receive discount5. |
string |
Data type: DateTime Format must be MM/dd/yyyy |
DeductionPercent1 |
The Discount percentage given if the purchase order is paid by PaidBy1 date. |
decimal number |
Max of 2 decimal places Must be numeric |
DeductionPercent2 |
The Discount percentage given if the purchase order is paid by PaidBy2 date. |
decimal number |
Max of 2 decimal places Must be numeric |
DeductionPercent3 |
The Discount percentage given if the purchase order is paid by PaidBy3 date. |
decimal number |
Max of 2 decimal places Must be numeric |
DeductionPercent4 |
The Discount percentage given if the purchase order is paid by PaidBy4 date. |
decimal number |
Max of 2 decimal places Must be numeric |
DeductionPercent5 |
The Discount percentage given if the purchase order is paid by PaidBy5 date. |
decimal number |
Max of 2 decimal places Must be numeric |
DiscountAmount1 |
The Discount amount for the purchase order if paid by PaidBy1. |
decimal number |
Max of 2 decimal places Must be numeric |
DiscountAmount2 |
The Discount amount for the purchase order if paid by PaidBy2. |
decimal number |
Max of 2 decimal places Must be numeric |
DiscountAmount3 |
The Discount amount for the purchase order if paid by PaidBy3. |
decimal number |
Max of 2 decimal places Must be numeric |
DiscountAmount4 |
The Discount amount for the purchase order if paid by PaidBy4. |
decimal number |
Max of 2 decimal places Must be numeric |
DiscountAmount5 |
The Discount amount for the purchase order if paid by PaidBy5. |
decimal number |
Max of 2 decimal places Must be numeric |
DiscountGL |
The General Ledger account to post the purchase order discount to. |
string |
Max length: 10 |
PayByEFTYN |
'True' or 'False' value indicating if purchase order was paid by Electronic Fund Transfer. |
boolean |
Must be 0, 1, True, or False |
Notes | string |
Max length: 255 |
|
APPOGUID |
Unique Identifier of the AP Purchase Order |
globally unique identifier | |
PODetailsUpdate |
A list that displays the amounts to be paid and supporting information on the Purchase Order. |
Collection of ClsApPoDtUpdate |
Request Formats
application/json, text/json
{ "Vendor": "sample string 1", "InvoiceNumber": "sample string 2", "Description": "sample string 3", "BillDate": "sample string 4", "PONumber": "sample string 6", "PaidByDate1": "sample string 7", "PaidByDate2": "sample string 8", "PaidByDate3": "sample string 9", "PaidByDate4": "sample string 10", "PaidByDate5": "sample string 11", "DeductionPercent1": 12.1, "DeductionPercent2": 13.1, "DeductionPercent3": 14.1, "DeductionPercent4": 15.1, "DeductionPercent5": 16.1, "DiscountAmount1": 17.1, "DiscountAmount2": 18.1, "DiscountAmount3": 19.1, "DiscountAmount4": 20.1, "DiscountAmount5": 21.1, "DiscountGL": "sample string 22", "PayByEFTYN": true, "Notes": "sample string 24", "APPOGUID": "bb22046d-9e7f-40d1-8207-04903cde6594", "PODetailsUpdate": [ { "GLAccount": "sample string 1", "Amount": 2.1, "Comment": "sample string 3", "PartNumber": "sample string 4", "UnitPrice": 5.1, "Quantity": 6.1, "VehicleID": "sample string 7", "LineItem": 8 }, { "GLAccount": "sample string 1", "Amount": 2.1, "Comment": "sample string 3", "PartNumber": "sample string 4", "UnitPrice": 5.1, "Quantity": 6.1, "VehicleID": "sample string 7", "LineItem": 8 } ] }
application/xml, text/xml
<APPurchaseOrderUpdate xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SSI.AP"> <APPOGUID>bb22046d-9e7f-40d1-8207-04903cde6594</APPOGUID> <BillDate>sample string 4</BillDate> <DeductionPercent1>12.1</DeductionPercent1> <DeductionPercent2>13.1</DeductionPercent2> <DeductionPercent3>14.1</DeductionPercent3> <DeductionPercent4>15.1</DeductionPercent4> <DeductionPercent5>16.1</DeductionPercent5> <Description>sample string 3</Description> <DiscountAmount1>17.1</DiscountAmount1> <DiscountAmount2>18.1</DiscountAmount2> <DiscountAmount3>19.1</DiscountAmount3> <DiscountAmount4>20.1</DiscountAmount4> <DiscountAmount5>21.1</DiscountAmount5> <DiscountGL>sample string 22</DiscountGL> <InvoiceNumber>sample string 2</InvoiceNumber> <Notes>sample string 24</Notes> <PODetailsUpdate> <PODetailUpdate> <Amount>2.1</Amount> <Comment>sample string 3</Comment> <GLAccount>sample string 1</GLAccount> <LineItem>8</LineItem> <PartNumber>sample string 4</PartNumber> <Quantity>6.1</Quantity> <UnitPrice>5.1</UnitPrice> <VehicleID>sample string 7</VehicleID> </PODetailUpdate> <PODetailUpdate> <Amount>2.1</Amount> <Comment>sample string 3</Comment> <GLAccount>sample string 1</GLAccount> <LineItem>8</LineItem> <PartNumber>sample string 4</PartNumber> <Quantity>6.1</Quantity> <UnitPrice>5.1</UnitPrice> <VehicleID>sample string 7</VehicleID> </PODetailUpdate> </PODetailsUpdate> <PONumber>sample string 6</PONumber> <PaidByDate1>sample string 7</PaidByDate1> <PaidByDate2>sample string 8</PaidByDate2> <PaidByDate3>sample string 9</PaidByDate3> <PaidByDate4>sample string 10</PaidByDate4> <PaidByDate5>sample string 11</PaidByDate5> <PayByEFTYN>true</PayByEFTYN> <Vendor>sample string 1</Vendor> </APPurchaseOrderUpdate>
application/x-www-form-urlencoded
Response Information
Resource Description
Updates an AP Purchase Order.
AgvApPoName | Description | Type | Additional 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 | |
WarningList |
List of warning messages of the API call. |
Collection of string | |
Count |
Number of results returned. |
string | |
Data |
List of Properties and Values returned for each AP Purchase Order that matches request |
Collection of clsApBill |
Response Formats
application/json, text/json
{ "Status": "sample string 1", "Message": "sample string 2", "ErrorList": [ "sample string 1", "sample string 2" ], "WarningList": [ "sample string 1", "sample string 2" ], "Count": "2", "Data": [ { "Vendor": "sample string 1", "InvoiceNumber": "sample string 2", "Description": "sample string 3", "EntryDate": "sample string 4", "BillDate": "sample string 5", "DueDate": "sample string 6", "Source": "sample string 7", "UserName": "sample string 8", "PONumber": "sample string 9", "OnHoldYN": true, "PaidByDate1": "sample string 11", "PaidByDate2": "sample string 12", "PaidByDate3": "sample string 13", "PaidByDate4": "sample string 14", "PaidByDate5": "sample string 15", "DeductionPercent1": 16.1, "DeductionPercent2": 17.1, "DeductionPercent3": 18.1, "DeductionPercent4": 19.1, "DeductionPercent5": 20.1, "DiscountAmount1": 21.1, "DiscountAmount2": 22.1, "DiscountAmount3": 23.1, "DiscountAmount4": 24.1, "DiscountAmount5": 25.1, "DiscountGL": "sample string 26", "Gross": 27.1, "Discount": 28.1, "Net": 29.1, "DatePaid": "sample string 30", "AmountPaid": 31.1, "PaidYN": true, "VoidedYN": true, "ReversedYN": true, "Amount1099": 35.1, "CheckNumber": "sample string 36", "FiscalMonth": 37, "UsePrepayYN": true, "Transferred": true, "LocationID": "sample string 40", "SpecialHandling": "sample string 41", "PayByEFTYN": true, "Notes": "sample string 43", "POInvoice": "sample string 44", "APPurchaseOrder": true, "UserID": "sample string 46", "ApBillGuid": "0e9a9bff-e615-411f-b103-9843a7fdd708", "BillDetail": [ { "Vendor": "sample string 1", "Invoice": "sample string 2", "LineItem": 3, "GLAccount": "sample string 4", "Amount": 5.1, "Comment": "sample string 6", "Quantity": 8.1, "UnitPrice": 9.1, "VehicleID": "sample string 10", "GLAccountDescription": "sample string 11" }, { "Vendor": "sample string 1", "Invoice": "sample string 2", "LineItem": 3, "GLAccount": "sample string 4", "Amount": 5.1, "Comment": "sample string 6", "Quantity": 8.1, "UnitPrice": 9.1, "VehicleID": "sample string 10", "GLAccountDescription": "sample string 11" } ] }, { "Vendor": "sample string 1", "InvoiceNumber": "sample string 2", "Description": "sample string 3", "EntryDate": "sample string 4", "BillDate": "sample string 5", "DueDate": "sample string 6", "Source": "sample string 7", "UserName": "sample string 8", "PONumber": "sample string 9", "OnHoldYN": true, "PaidByDate1": "sample string 11", "PaidByDate2": "sample string 12", "PaidByDate3": "sample string 13", "PaidByDate4": "sample string 14", "PaidByDate5": "sample string 15", "DeductionPercent1": 16.1, "DeductionPercent2": 17.1, "DeductionPercent3": 18.1, "DeductionPercent4": 19.1, "DeductionPercent5": 20.1, "DiscountAmount1": 21.1, "DiscountAmount2": 22.1, "DiscountAmount3": 23.1, "DiscountAmount4": 24.1, "DiscountAmount5": 25.1, "DiscountGL": "sample string 26", "Gross": 27.1, "Discount": 28.1, "Net": 29.1, "DatePaid": "sample string 30", "AmountPaid": 31.1, "PaidYN": true, "VoidedYN": true, "ReversedYN": true, "Amount1099": 35.1, "CheckNumber": "sample string 36", "FiscalMonth": 37, "UsePrepayYN": true, "Transferred": true, "LocationID": "sample string 40", "SpecialHandling": "sample string 41", "PayByEFTYN": true, "Notes": "sample string 43", "POInvoice": "sample string 44", "APPurchaseOrder": true, "UserID": "sample string 46", "ApBillGuid": "0e9a9bff-e615-411f-b103-9843a7fdd708", "BillDetail": [ { "Vendor": "sample string 1", "Invoice": "sample string 2", "LineItem": 3, "GLAccount": "sample string 4", "Amount": 5.1, "Comment": "sample string 6", "Quantity": 8.1, "UnitPrice": 9.1, "VehicleID": "sample string 10", "GLAccountDescription": "sample string 11" }, { "Vendor": "sample string 1", "Invoice": "sample string 2", "LineItem": 3, "GLAccount": "sample string 4", "Amount": 5.1, "Comment": "sample string 6", "Quantity": 8.1, "UnitPrice": 9.1, "VehicleID": "sample string 10", "GLAccountDescription": "sample string 11" } ] } ] }
application/xml, text/xml
<AgvApPo xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AgvWebAPICSharp.Models.Vendor"> <Data xmlns:d2p1="http://schemas.datacontract.org/2004/07/SSI.AP"> <d2p1:APBill> <d2p1:APPurchaseOrder>true</d2p1:APPurchaseOrder> <d2p1:Amount1099>35.1</d2p1:Amount1099> <d2p1:AmountPaid>31.1</d2p1:AmountPaid> <d2p1:ApBillGuid>0e9a9bff-e615-411f-b103-9843a7fdd708</d2p1:ApBillGuid> <d2p1:BillDate>sample string 5</d2p1:BillDate> <d2p1:BillDetail> <d2p1:BillDetail> <d2p1:Amount>5.1</d2p1:Amount> <d2p1:Comment>sample string 6</d2p1:Comment> <d2p1:GLAccount>sample string 4</d2p1:GLAccount> <d2p1:GLAccountDescription>sample string 11</d2p1:GLAccountDescription> <d2p1:Invoice>sample string 2</d2p1:Invoice> <d2p1:LineItem>3</d2p1:LineItem> <d2p1:Quantity>8.1</d2p1:Quantity> <d2p1:UnitPrice>9.1</d2p1:UnitPrice> <d2p1:VehicleID>sample string 10</d2p1:VehicleID> <d2p1:Vendor>sample string 1</d2p1:Vendor> </d2p1:BillDetail> <d2p1:BillDetail> <d2p1:Amount>5.1</d2p1:Amount> <d2p1:Comment>sample string 6</d2p1:Comment> <d2p1:GLAccount>sample string 4</d2p1:GLAccount> <d2p1:GLAccountDescription>sample string 11</d2p1:GLAccountDescription> <d2p1:Invoice>sample string 2</d2p1:Invoice> <d2p1:LineItem>3</d2p1:LineItem> <d2p1:Quantity>8.1</d2p1:Quantity> <d2p1:UnitPrice>9.1</d2p1:UnitPrice> <d2p1:VehicleID>sample string 10</d2p1:VehicleID> <d2p1:Vendor>sample string 1</d2p1:Vendor> </d2p1:BillDetail> </d2p1:BillDetail> <d2p1:CheckNumber>sample string 36</d2p1:CheckNumber> <d2p1:DatePaid>sample string 30</d2p1:DatePaid> <d2p1:DeductionPercent1>16.1</d2p1:DeductionPercent1> <d2p1:DeductionPercent2>17.1</d2p1:DeductionPercent2> <d2p1:DeductionPercent3>18.1</d2p1:DeductionPercent3> <d2p1:DeductionPercent4>19.1</d2p1:DeductionPercent4> <d2p1:DeductionPercent5>20.1</d2p1:DeductionPercent5> <d2p1:Description>sample string 3</d2p1:Description> <d2p1:Discount>28.1</d2p1:Discount> <d2p1:DiscountAmount1>21.1</d2p1:DiscountAmount1> <d2p1:DiscountAmount2>22.1</d2p1:DiscountAmount2> <d2p1:DiscountAmount3>23.1</d2p1:DiscountAmount3> <d2p1:DiscountAmount4>24.1</d2p1:DiscountAmount4> <d2p1:DiscountAmount5>25.1</d2p1:DiscountAmount5> <d2p1:DiscountGL>sample string 26</d2p1:DiscountGL> <d2p1:DueDate>sample string 6</d2p1:DueDate> <d2p1:EntryDate>sample string 4</d2p1:EntryDate> <d2p1:FiscalMonth>37</d2p1:FiscalMonth> <d2p1:Gross>27.1</d2p1:Gross> <d2p1:InvoiceNumber>sample string 2</d2p1:InvoiceNumber> <d2p1:LocationID>sample string 40</d2p1:LocationID> <d2p1:Net>29.1</d2p1:Net> <d2p1:Notes>sample string 43</d2p1:Notes> <d2p1:OnHoldYN>true</d2p1:OnHoldYN> <d2p1:POInvoice>sample string 44</d2p1:POInvoice> <d2p1:PONumber>sample string 9</d2p1:PONumber> <d2p1:PaidByDate1>sample string 11</d2p1:PaidByDate1> <d2p1:PaidByDate2>sample string 12</d2p1:PaidByDate2> <d2p1:PaidByDate3>sample string 13</d2p1:PaidByDate3> <d2p1:PaidByDate4>sample string 14</d2p1:PaidByDate4> <d2p1:PaidByDate5>sample string 15</d2p1:PaidByDate5> <d2p1:PaidYN>true</d2p1:PaidYN> <d2p1:PayByEFTYN>true</d2p1:PayByEFTYN> <d2p1:ReversedYN>true</d2p1:ReversedYN> <d2p1:Source>sample string 7</d2p1:Source> <d2p1:SpecialHandling>sample string 41</d2p1:SpecialHandling> <d2p1:Transferred>true</d2p1:Transferred> <d2p1:UsePrepayYN>true</d2p1:UsePrepayYN> <d2p1:UserID>sample string 46</d2p1:UserID> <d2p1:UserName>sample string 8</d2p1:UserName> <d2p1:Vendor>sample string 1</d2p1:Vendor> <d2p1:VoidedYN>true</d2p1:VoidedYN> </d2p1:APBill> <d2p1:APBill> <d2p1:APPurchaseOrder>true</d2p1:APPurchaseOrder> <d2p1:Amount1099>35.1</d2p1:Amount1099> <d2p1:AmountPaid>31.1</d2p1:AmountPaid> <d2p1:ApBillGuid>0e9a9bff-e615-411f-b103-9843a7fdd708</d2p1:ApBillGuid> <d2p1:BillDate>sample string 5</d2p1:BillDate> <d2p1:BillDetail> <d2p1:BillDetail> <d2p1:Amount>5.1</d2p1:Amount> <d2p1:Comment>sample string 6</d2p1:Comment> <d2p1:GLAccount>sample string 4</d2p1:GLAccount> <d2p1:GLAccountDescription>sample string 11</d2p1:GLAccountDescription> <d2p1:Invoice>sample string 2</d2p1:Invoice> <d2p1:LineItem>3</d2p1:LineItem> <d2p1:Quantity>8.1</d2p1:Quantity> <d2p1:UnitPrice>9.1</d2p1:UnitPrice> <d2p1:VehicleID>sample string 10</d2p1:VehicleID> <d2p1:Vendor>sample string 1</d2p1:Vendor> </d2p1:BillDetail> <d2p1:BillDetail> <d2p1:Amount>5.1</d2p1:Amount> <d2p1:Comment>sample string 6</d2p1:Comment> <d2p1:GLAccount>sample string 4</d2p1:GLAccount> <d2p1:GLAccountDescription>sample string 11</d2p1:GLAccountDescription> <d2p1:Invoice>sample string 2</d2p1:Invoice> <d2p1:LineItem>3</d2p1:LineItem> <d2p1:Quantity>8.1</d2p1:Quantity> <d2p1:UnitPrice>9.1</d2p1:UnitPrice> <d2p1:VehicleID>sample string 10</d2p1:VehicleID> <d2p1:Vendor>sample string 1</d2p1:Vendor> </d2p1:BillDetail> </d2p1:BillDetail> <d2p1:CheckNumber>sample string 36</d2p1:CheckNumber> <d2p1:DatePaid>sample string 30</d2p1:DatePaid> <d2p1:DeductionPercent1>16.1</d2p1:DeductionPercent1> <d2p1:DeductionPercent2>17.1</d2p1:DeductionPercent2> <d2p1:DeductionPercent3>18.1</d2p1:DeductionPercent3> <d2p1:DeductionPercent4>19.1</d2p1:DeductionPercent4> <d2p1:DeductionPercent5>20.1</d2p1:DeductionPercent5> <d2p1:Description>sample string 3</d2p1:Description> <d2p1:Discount>28.1</d2p1:Discount> <d2p1:DiscountAmount1>21.1</d2p1:DiscountAmount1> <d2p1:DiscountAmount2>22.1</d2p1:DiscountAmount2> <d2p1:DiscountAmount3>23.1</d2p1:DiscountAmount3> <d2p1:DiscountAmount4>24.1</d2p1:DiscountAmount4> <d2p1:DiscountAmount5>25.1</d2p1:DiscountAmount5> <d2p1:DiscountGL>sample string 26</d2p1:DiscountGL> <d2p1:DueDate>sample string 6</d2p1:DueDate> <d2p1:EntryDate>sample string 4</d2p1:EntryDate> <d2p1:FiscalMonth>37</d2p1:FiscalMonth> <d2p1:Gross>27.1</d2p1:Gross> <d2p1:InvoiceNumber>sample string 2</d2p1:InvoiceNumber> <d2p1:LocationID>sample string 40</d2p1:LocationID> <d2p1:Net>29.1</d2p1:Net> <d2p1:Notes>sample string 43</d2p1:Notes> <d2p1:OnHoldYN>true</d2p1:OnHoldYN> <d2p1:POInvoice>sample string 44</d2p1:POInvoice> <d2p1:PONumber>sample string 9</d2p1:PONumber> <d2p1:PaidByDate1>sample string 11</d2p1:PaidByDate1> <d2p1:PaidByDate2>sample string 12</d2p1:PaidByDate2> <d2p1:PaidByDate3>sample string 13</d2p1:PaidByDate3> <d2p1:PaidByDate4>sample string 14</d2p1:PaidByDate4> <d2p1:PaidByDate5>sample string 15</d2p1:PaidByDate5> <d2p1:PaidYN>true</d2p1:PaidYN> <d2p1:PayByEFTYN>true</d2p1:PayByEFTYN> <d2p1:ReversedYN>true</d2p1:ReversedYN> <d2p1:Source>sample string 7</d2p1:Source> <d2p1:SpecialHandling>sample string 41</d2p1:SpecialHandling> <d2p1:Transferred>true</d2p1:Transferred> <d2p1:UsePrepayYN>true</d2p1:UsePrepayYN> <d2p1:UserID>sample string 46</d2p1:UserID> <d2p1:UserName>sample string 8</d2p1:UserName> <d2p1:Vendor>sample string 1</d2p1:Vendor> <d2p1:VoidedYN>true</d2p1:VoidedYN> </d2p1:APBill> </Data> <ErrorList xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d2p1:string>sample string 1</d2p1:string> <d2p1:string>sample string 2</d2p1:string> </ErrorList> <Message>sample string 2</Message> <Status>sample string 1</Status> <WarningList xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d2p1:string>sample string 1</d2p1:string> <d2p1:string>sample string 2</d2p1:string> </WarningList> </AgvApPo>