POST ApBill/PostApBill
Creates a new AP Bill.
Request Information
URI Parameters
Body Parameters
The AP Bill object used to create a new AP Bill.
clsApBillAddName | Description | Type | Additional Information |
---|---|---|---|
Vendor |
The Vendor ID the AP Bill is for. The combination of Vendor, Invoice, and Bill Date are what uniquely identify an AP Bill. |
string |
Required Max length: 10 |
InvoiceNumber |
The number of the Invoice the AP Bill paid. One of the values returned by the GetApBill method of the API. |
string |
Required Max length: 25 |
Description |
User entered description or short note about the AP Bill. |
string |
Max length: 40 |
BillDate |
The date of the bill. |
string |
Data type: DateTime Format must be MM/dd/yyyy |
DueDate |
The date the bill is due. |
string |
Data type: DateTime Format must be MM/dd/yyyy |
PONumber |
The Purchase Order Number for the bill. |
string |
Max length: 10 |
OnHoldYN |
'True' or 'False' value indicating whether the bill is on hold or not. |
boolean |
Must be 0, 1, True, or False |
PaidByDate1 |
The date to pay the bill by in order to receive discount1. |
string |
Data type: DateTime Format must be MM/dd/yyyy |
PaidByDate2 |
The date to pay the bill by in order to receive discount2. |
string |
Data type: DateTime Format must be MM/dd/yyyy |
PaidByDate3 |
The date to pay the bill by in order to receive discount3. |
string |
Data type: DateTime Format must be MM/dd/yyyy |
PaidByDate4 |
The date to pay the bill by in order to receive discount4. |
string |
Data type: DateTime Format must be MM/dd/yyyy |
PaidByDate5 |
The date to pay the bill by in order to receive discount5. |
string |
Data type: DateTime Format must be MM/dd/yyyy |
DeductionPercent1 |
The Discount percentage given if the bill is paid by PaidBy1 date. |
decimal number |
Max of 2 decimal places Must be numeric |
DeductionPercent2 |
The Discount percentage given if the bill is paid by PaidBy2 date. |
decimal number |
Max of 2 decimal places Must be numeric |
DeductionPercent3 |
The Discount percentage given if the bill is paid by PaidBy3 date. |
decimal number |
Max of 2 decimal places Must be numeric |
DeductionPercent4 |
The Discount percentage given if the bill is paid by PaidBy4 date. |
decimal number |
Max of 2 decimal places Must be numeric |
DeductionPercent5 |
The Discount percentage given if the bill is paid by PaidBy5 date. |
decimal number |
Max of 2 decimal places Must be numeric |
DiscountAmount1 |
The Discount amount for the bill if paid by PaidBy1. |
decimal number |
Max of 2 decimal places Must be numeric |
DiscountAmount2 |
The Discount amount for the bill if paid by PaidBy2. |
decimal number |
Max of 2 decimal places Must be numeric |
DiscountAmount3 |
The Discount amount for the bill if paid by PaidBy3. |
decimal number |
Max of 2 decimal places Must be numeric |
DiscountAmount4 |
The Discount amount for the bill if paid by PaidBy4. |
decimal number |
Max of 2 decimal places Must be numeric |
DiscountAmount5 |
The Discount amount for the bill if paid by PaidBy5. |
decimal number |
Max of 2 decimal places Must be numeric |
DiscountGL |
The General Ledger account to post the bill discount to. |
string |
Max length: 10 |
Amount1099 |
The Amount of the AP Bill that needs reported on the 1099 tax form. |
decimal number |
Max of 2 decimal places Must be numeric Range: inclusive between -1000000000000.00 and 1000000000000.00 |
PostToPriorMonth |
'True' or 'False' value indicating if the bill should post to the prior fiscal month or not. |
boolean |
Must be 0, 1, True, or False |
UsePrepayYN |
'True' or 'False' value indicating if the bill was for prepay or not. |
boolean |
Must be 0, 1, True, or False |
PayByEFTYN |
'True' or 'False' value indicating if bill was paid by Electronic Fund Transfer. |
boolean |
Must be 0, 1, True, or False |
Notes |
User entered notes on the bill. |
string |
Max length: 255 |
POInvoice |
Invoice of imported APPO (if present) |
string |
Max length: 25 |
BillDetailAdd |
A list that displays the amounts paid and discounts applied on the bill. |
Collection of clsAPBillDtAdd |
List cannot be empty |
Request Formats
application/json, text/json
{ "Vendor": "sample string 1", "InvoiceNumber": "sample string 2", "Description": "sample string 3", "BillDate": "sample string 4", "DueDate": "sample string 5", "PONumber": "sample string 8", "OnHoldYN": true, "PaidByDate1": "sample string 10", "PaidByDate2": "sample string 11", "PaidByDate3": "sample string 12", "PaidByDate4": "sample string 13", "PaidByDate5": "sample string 14", "DeductionPercent1": 15.1, "DeductionPercent2": 16.1, "DeductionPercent3": 17.1, "DeductionPercent4": 18.1, "DeductionPercent5": 19.1, "DiscountAmount1": 20.1, "DiscountAmount2": 21.1, "DiscountAmount3": 22.1, "DiscountAmount4": 23.1, "DiscountAmount5": 24.1, "DiscountGL": "sample string 25", "Amount1099": 26.1, "PostToPriorMonth": true, "UsePrepayYN": true, "PayByEFTYN": true, "Notes": "sample string 30", "POInvoice": "sample string 31", "BillDetailAdd": [ { "GLAccount": "sample string 2", "Amount": 3.1, "Comment": "sample string 4", "Quantity": 5.1, "VehicleID": "sample string 6" }, { "GLAccount": "sample string 2", "Amount": 3.1, "Comment": "sample string 4", "Quantity": 5.1, "VehicleID": "sample string 6" } ] }
application/xml, text/xml
<APBillAdd xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SSI.AP"> <Amount1099>26.1</Amount1099> <BillDate>sample string 4</BillDate> <BillDetailAdd> <BillDetailAdd> <Amount>3.1</Amount> <Comment>sample string 4</Comment> <GLAccount>sample string 2</GLAccount> <Quantity>5.1</Quantity> <VehicleID>sample string 6</VehicleID> </BillDetailAdd> <BillDetailAdd> <Amount>3.1</Amount> <Comment>sample string 4</Comment> <GLAccount>sample string 2</GLAccount> <Quantity>5.1</Quantity> <VehicleID>sample string 6</VehicleID> </BillDetailAdd> </BillDetailAdd> <DeductionPercent1>15.1</DeductionPercent1> <DeductionPercent2>16.1</DeductionPercent2> <DeductionPercent3>17.1</DeductionPercent3> <DeductionPercent4>18.1</DeductionPercent4> <DeductionPercent5>19.1</DeductionPercent5> <Description>sample string 3</Description> <DiscountAmount1>20.1</DiscountAmount1> <DiscountAmount2>21.1</DiscountAmount2> <DiscountAmount3>22.1</DiscountAmount3> <DiscountAmount4>23.1</DiscountAmount4> <DiscountAmount5>24.1</DiscountAmount5> <DiscountGL>sample string 25</DiscountGL> <DueDate>sample string 5</DueDate> <InvoiceNumber>sample string 2</InvoiceNumber> <Notes>sample string 30</Notes> <OnHoldYN>true</OnHoldYN> <POInvoice>sample string 31</POInvoice> <PONumber>sample string 8</PONumber> <PaidByDate1>sample string 10</PaidByDate1> <PaidByDate2>sample string 11</PaidByDate2> <PaidByDate3>sample string 12</PaidByDate3> <PaidByDate4>sample string 13</PaidByDate4> <PaidByDate5>sample string 14</PaidByDate5> <PayByEFTYN>true</PayByEFTYN> <PostToPriorMonth>true</PostToPriorMonth> <UsePrepayYN>true</UsePrepayYN> <Vendor>sample string 1</Vendor> </APBillAdd>
application/x-www-form-urlencoded
Response Information
Resource Description
Creates a new AP Bill.
AgvApBillName | Description | Type | Additional Information |
---|---|---|---|
Status |
Status of the API call. |
string | |
Message |
Message of the API call. |
string | |
Count |
Count of how many AP Bills. |
string | |
ApBillRecords |
JSON dictionary of APBillRecords. |
Collection of clsApBill |
Response Formats
application/json, text/json
{ "Status": "sample string 1", "Message": "sample string 2", "Count": "2", "ApBillRecords": [ { "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": "852c8bde-dd20-4c63-a4b6-8f2f5ec63832", "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": "852c8bde-dd20-4c63-a4b6-8f2f5ec63832", "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
<AgvApBill xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AgvWebAPICSharp.Models.Vendor"> <ApBillRecords 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>852c8bde-dd20-4c63-a4b6-8f2f5ec63832</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>852c8bde-dd20-4c63-a4b6-8f2f5ec63832</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> </ApBillRecords> <Message>sample string 2</Message> <Status>sample string 1</Status> </AgvApBill>