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.
clsApBillAdd| Name | 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.
AgvApBill| Name | 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": "715e0bc4-a7fb-469c-be9c-ca7f04ff843c",
"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": "715e0bc4-a7fb-469c-be9c-ca7f04ff843c",
"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>715e0bc4-a7fb-469c-be9c-ca7f04ff843c</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>715e0bc4-a7fb-469c-be9c-ca7f04ff843c</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>