An AP recurring bill provides the ability to schedule and automate the process of creating AP bills. It is commonly used for regularly-recurring, fixed-amount bills. For more information, refer to Recurring bills in the Sage Intacct Help Center.
Returns a collection with a key, ID, and link for each recurring bill. This operation is mostly for use in testing; use the query service to find objects that meet certain criteria and to specify properties that are returned.
OK
Bad Request
{- "ia::result": [
- {
- "key": "1",
- "id": "Adjustment Increase",
- "href": "/objects/accounts-payable/recurring-bill/1"
}, - {
- "key": "2",
- "id": "Adjustment Increase",
- "href": "/objects/accounts-payable/recurring-bill/2"
}, - {
- "key": "3",
- "id": "Bill",
- "href": "/objects/accounts-payable/recurring-bill/3"
}
], - "ia::meta": {
- "totalCount": 3,
- "start": 1,
- "pageSize": 100,
- "next": null,
- "previous": null
}
}
Creates a new recurring bill. Recurring bills automate the billing process for regularly-recurring, fixed-amount bills, such as monthly rent. Sage Intacct supports non-standard recurring transaction schedules and automatically enters and posts bills based on the defined schedule. The transaction and GL posting date for an automatically generated bill are the same, but you can change either.
If your organization uses multiple base currencies, create recurring bills at the entity level.
Recurring bills do not support custom fields or custom fields defined in a bill. If you need to use a custom field in a recurring bill, configure the custom field as not required.
description | string or null Additional information about the recurring bill. Example: "Recurring Bill for 2025-01-23 services" | ||||||||||||||||||||||||||||
referenceNumber | string or null A reference number, such as a purchase order or account number, used for searches and reports. This number appears on the General Ledger Details report and prints on checks and vendor stubs. Example: "RecurBill-100" | ||||||||||||||||||||||||||||
object Represents a contract associated with the recurring bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
billNumber | string Deprecated Each occurrence of the bill is numbered incrementally based on the sequence type defined in Company Setup - Document Sequence. Example: "AP-ADJ" | ||||||||||||||||||||||||||||
billSequenceNumber | string Specify the initial value for the bill number, which will be incremented for each bill based on the sequence type defined in Company Setup - Document Sequence. For example, if you specify AP-ADJ in this field, the number for each recurring bill will start with AP-ADJ and will be incremented based on the sequence type. For example, AP-ADJ001, APAP-ADJ002, APAP-ADJ003, etc. Example: "AP-ADJ" | ||||||||||||||||||||||||||||
object Currency details for this recurring bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
isTaxInclusive | boolean Default: false Set to Example: false | ||||||||||||||||||||||||||||
object Supporting document attached to the bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
object Tax solution details for the bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
object Contacts for the recurring bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
object Defines the scheduling details for the recurring bill, including start date, frequency, next execution date, and end conditions. The schedule provides a comprehensive view of when and how often the recurring bill will be generated. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
object Payment terms, which are used to calculate due date, discounts, and penalties associated with this bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
object Vendor associated with the recurring bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
Array of objects Line items of the recurring bill. | |||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||
status | string Default: "active" Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced. Example: "active" |
Created
Bad Request
{- "description": "DNO Recurring Bill 001",
- "schedule": {
- "startDate": "2025-03-21",
- "repeatBy": "days",
- "repeatInterval": "1",
- "endDate": "2025-03-29"
}, - "term": {
- "id": "N15"
}, - "referenceNumber": "DNO Recur bill",
- "status": "active",
- "contract": {
- "id": "128",
- "description": "DNO contract"
}, - "vendor": {
- "id": "1099 Int"
}, - "currency": {
- "baseCurrency": "USD",
- "txnCurrency": "USD",
- "exchangeRate": {
- "date": "2024-02-21",
- "typeId": "Intacct Daily Rate",
- "rate": 1.0679
}
}, - "lines": [
- {
- "memo": "DNO Recurring Bill line 01",
- "glAccount": {
- "id": "6000"
}, - "baseAmount": "120",
- "hasForm1099": "false",
- "currency": {
- "txnCurrency": "USD",
- "baseCurrency": "AUD"
}, - "txnAmount": "150"
}, - {
- "memo": "DNO Recurring Bill line 02",
- "glAccount": {
- "id": "6000"
}, - "baseAmount": "110",
- "hasForm1099": "false",
- "currency": {
- "txnCurrency": "USD",
- "baseCurrency": "AUD"
}, - "txnAmount": "130.00"
}
]
}
{- "ia::result": {
- "key": "5",
- "id": "5",
- "href": "/objects/accounts-payable/recurring-bill/5",
- "ia::meta": {
- "totalCount": 1
}
}
}
Returns detailed information for a specified recurring bill.
key required | string System-assigned unique key for the recurring bill. Example: 13 |
Get a recurring bill
Bad Request
{- "ia::result": {
- "key": "12",
- "description": "DNO Recurring Bill",
- "audit": {
- "createdDateTime": "2024-03-20T00:00:00Z",
- "modifiedDateTime": "2024-03-20T11:38:13Z",
- "createdBy": "1",
- "modifiedBy": "1"
}, - "term": {
- "key": "8",
- "id": "N15",
- "href": "/objects/accounts-payable/term/8"
}, - "id": "Invoice",
- "totalEntered": "337.02",
- "referenceNumber": "DNO Recurr bill",
- "moduleKey": "3.AP",
- "status": "active",
- "recurringSchedule": {
- "id": "1",
- "key": "1",
- "href": "/objects/core/schedule/1"
}, - "contract": {
- "id": "128",
- "description": "DNO contract"
}, - "vendor": {
- "id": "1099 Int",
- "name": "1099 Int",
- "key": "43",
- "href": "/objects/accounts-payable/vendor/43"
}, - "currency": {
- "txnCurrency": "USD",
- "baseCurrency": "AUD"
}, - "txnTotalEntered": "220.00",
- "lines": [
- {
- "id": "1",
- "key": "1",
- "recurringBill": {
- "id": "1",
- "key": "1",
- "href": "/objects/accounts-payable/recurring-bill/1"
}, - "memo": "DNO Recurring Bill",
- "glAccount": {
- "key": "246",
- "id": "6000",
- "name": "G&A Salaries",
- "href": "/objects/general-ledger/account/246"
}, - "baseAmount": "183.83",
- "dimensions": {
- "location": {
- "id": "1",
- "name": "United States of America"
}, - "department": {
- "id": "11",
- "name": "Accounting"
}, - "project": {
- "key": "8",
- "id": "8",
- "name": "Client Services - Power Aerospace Materials",
- "href": "/objects/projects/project/8"
}, - "customer": {
- "key": "1",
- "id": "1",
- "name": "Power Aerospace Materials",
- "href": "/objects/accounts-receivable/customer/1"
}, - "vendor": {
- "key": "43",
- "id": "1099 Int",
- "name": "1099 Int",
- "href": "/objects/accounts-payable/vendor/43"
}, - "employee": {
- "key": "1",
- "id": "1",
- "name": "Reser",
- "href": "/objects/company-config/employee/1"
}, - "item": {
- "key": "1",
- "id": "1",
- "name": "PC Computer",
- "href": "/objects/inventory-control/item/1"
}, - "class": {
- "key": "1",
- "id": "3",
- "name": "Health Care",
- "href": "/objects/company-config/class/1"
}
}, - "lineNumber": 0,
- "hasForm1099": "false",
- "accountLabel": {
- "id": null
}, - "currency": {
- "txnCurrency": "USD",
- "baseCurrency": "AUD"
}, - "txnAmount": "120.00",
- "audit": {
- "createdDateTime": "2024-03-20T11:38:13Z",
- "modifiedDateTime": "2024-03-20T11:38:13Z",
- "createdBy": "1",
- "modifiedBy": "1"
}, - "href": "/objects/accounts-payable/recurring-bill-line/1",
- "entity": {
- "key": "46",
- "id": "Western Region",
- "name": "Western Region",
- "href": "/objects/company-config/entity/46"
}
}, - {
- "id": "2",
- "key": "2",
- "recurringBill": {
- "id": "1",
- "key": "1",
- "href": "/objects/accounts-payable/recurring-bill/1"
}, - "memo": "DNO Recurring Bill",
- "glAccount": {
- "key": "246",
- "id": "6000",
- "name": "G&A Salaries",
- "href": "/objects/general-ledger/account/246"
}, - "baseAmount": "153.19",
- "dimensions": {
- "location": {
- "id": "1",
- "name": "United States of America"
}, - "department": {
- "id": "11",
- "name": "Accounting"
}, - "project": {
- "key": "8",
- "id": "8",
- "name": "Client Services - Power Aerospace Materials",
- "href": "/objects/projects/project/8"
}, - "customer": {
- "key": "1",
- "id": "1",
- "name": "Power Aerospace Materials",
- "href": "/objects/accounts-receivable/customer/1"
}, - "vendor": {
- "key": "43",
- "id": "1099 Int",
- "name": "1099 Int",
- "href": "/objects/accounts-payable/vendor/43"
}, - "employee": {
- "key": "1",
- "id": "1",
- "name": "Reser",
- "href": "/objects/company-config/employee/1"
}, - "item": {
- "key": "1",
- "id": "1",
- "name": "PC Computer",
- "href": "/objects/inventory-control/item/1"
}, - "class": {
- "key": "1",
- "id": "3",
- "name": "Heath Care",
- "href": "/objects/company-config/class/1"
}
}, - "lineNumber": 1,
- "hasForm1099": "false",
- "accountLabel": {
- "id": null
}, - "currency": {
- "txnCurrency": "USD",
- "baseCurrency": "AUD"
}, - "txnAmount": "100.00",
- "audit": {
- "createdDateTime": "2024-03-20T11:38:13Z",
- "modifiedDateTime": "2024-03-20T11:38:13Z",
- "createdBy": "1",
- "modifiedBy": "1"
}, - "href": "/objects/accounts-payable/recurring-bill-line/2",
- "entity": {
- "key": "46",
- "id": "Western Region",
- "name": "Western Region",
- "href": "/objects/company-config/entity/46"
}
}
], - "href": "/objects/accounts-payable/recurring-bill/12"
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 1,
- "totalError": 0
}
}
Updates an existing recurring bill by setting field values. Any fields not provided remain unchanged.
key required | string System-assigned unique key for the recurring bill. Example: 13 |
description | string or null Additional information about the recurring bill. Example: "Recurring Bill for 2025-01-23 services" | ||||||||||||||||||||||||||||
referenceNumber | string or null A reference number, such as a purchase order or account number, used for searches and reports. This number appears on the General Ledger Details report and prints on checks and vendor stubs. Example: "RecurBill-100" | ||||||||||||||||||||||||||||
object Represents a contract associated with the recurring bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
billNumber | string Deprecated Each occurrence of the bill is numbered incrementally based on the sequence type defined in Company Setup - Document Sequence. Example: "AP-ADJ" | ||||||||||||||||||||||||||||
billSequenceNumber | string Specify the initial value for the bill number, which will be incremented for each bill based on the sequence type defined in Company Setup - Document Sequence. For example, if you specify AP-ADJ in this field, the number for each recurring bill will start with AP-ADJ and will be incremented based on the sequence type. For example, AP-ADJ001, APAP-ADJ002, APAP-ADJ003, etc. Example: "AP-ADJ" | ||||||||||||||||||||||||||||
object Currency details for this recurring bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
isTaxInclusive | boolean Default: false Set to Example: false | ||||||||||||||||||||||||||||
object Supporting document attached to the bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
object Tax solution details for the bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
object Contacts for the recurring bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
object Defines the scheduling details for the recurring bill, including start date, frequency, next execution date, and end conditions. The schedule provides a comprehensive view of when and how often the recurring bill will be generated. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
object Payment terms, which are used to calculate due date, discounts, and penalties associated with this bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
object Vendor associated with the recurring bill. | |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
Array of objects Line items of the recurring bill. | |||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||
status | string Default: "active" Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced. Example: "active" |
OK
Bad Request
{- "description": "New payouts recurring bill"
}
{- "ia::result": {
- "key": "5",
- "id": "5",
- "href": "/objects/accounts-payable/recurring-bill/5",
- "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 1,
- "totalError": 0
}
}
}
Deletes a recurring bill specified by the given key.
key required | string System-assigned unique key for the recurring bill. Example: 13 |
No Content
Bad Request
{- "ia::result": {
- "ia::error": {
- "code": "invalidRequest",
- "message": "A POST request requires a payload",
- "errorId": "REST-1028",
- "additionalInfo": {
- "messageId": "IA.REQUEST_REQUIRES_A_PAYLOAD",
- "placeholders": {
- "OPERATION": "POST"
}, - "propertySet": { }
}, - "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
}
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 0,
- "totalError": 1
}
}