Recurring documents

A recurring document contains the transaction header, line item details, and schedule information that Sage Intacct uses to create recurring transactions. For more information about recurring transactions, see About recurring transactions - Order Entry in the Sage Intacct Help Center.

List recurring documents

get/objects/order-entry/recurring-document

Returns a collection with a key, ID, and link for each recurring document. 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.

SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": [
    • {
      • "key": "2",
      • "id": "2",
      • "href": "/objects/order-entry/recurring-document::Sales%20Invoice/2"
      },
    • {
      • "key": "6",
      • "id": "6",
      • "href": "/objects/order-entry/recurring-document::Sales%20Invoice/6"
      },
    • {
      • "key": "14",
      • "id": "14",
      • "href": "/objects/order-entry/recurring-document::Sales%20Order/14"
      }
    ],
  • "ia::meta": {
    • "totalCount": 3,
    • "start": 1,
    • "pageSize": 100,
    • "next": null,
    • "previous": null
    }
}

Get a recurring document

get/objects/order-entry/recurring-document/{key}

Returns detailed information for a specified recurring document.

SecurityOAuth2
Request
path Parameters
key
required
string

System-assigned unique key for the recurring document.

Example: 14
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": {
    • "id": "14",
    • "key": "14",
    • "txnDefinition": {
      • "key": "86",
      • "id": "Sales Invoice",
      • "href": "/objects/order-entry/txn-definition::Sales%20Invoice/86"
      },
    • "status": "active",
    • "contacts": {
      • "primary": {
        },
      • "shipTo": {
        },
      • "billTo": {
        }
      },
    • "referenceNumber": "1012",
    • "paymentTerm": {
      • "key": "5",
      • "id": "N15",
      • "href": "/objects/accounts-receivable/term/5"
      },
    • "shippingMethod": {
      • "id": "Air",
      • "key": "2",
      • "href": "/objects/accounts-receivable/shipping-method/2"
      },
    • "memo": "Recurring subscription",
    • "contractId": null,
    • "contractDescription": null,
    • "notes": null,
    • "subtotal": "11001.32000000000000",
    • "total": "11611.21000000000000",
    • "recurringSchedule": {
      • "id": "15",
      • "key": "15",
      • "href": "/objects/core/schedule/15"
      },
    • "documentType": "Sales Invoice",
    • "schedule": {
      • "startDate": "2025-01-18",
      • "endDate": null,
      • "nextExecutionDate": "2025-01-18",
      • "lastExecutionDate": null,
      • "recurringDueDate": "2025-01-18",
      • "frequency": "weeks",
      • "executionCount": "0",
      • "repeatCount": null,
      • "repeatBy": "weeks",
      • "repeatInterval": "4"
      },
    • "customer": {
      • "key": "22",
      • "id": "CAR",
      • "name": "Bernley Technology Inc",
      • "href": "/objects/accounts-receivable/customer/22"
      },
    • "baseCurrency": "USD",
    • "txnCurrency": "USD",
    • "exchangeRate": {
      • "date": "2025-08-08",
      • "typeName": null,
      • "rate": "1.0000000000",
      • "typeId": null
      },
    • "subtotalInTxnCurrency": "11001.32000000000000",
    • "totalInTxnCurrency": "11611.21000000000000",
    • "state": "active",
    • "audit": {
      • "createdDateTime": "2024-08-08T09:19:34Z",
      • "modifiedDateTime": "2024-08-08T10:46:15Z",
      • "createdByUser": {
        },
      • "createdBy": "1",
      • "modifiedByUser": {
        },
      • "modifiedBy": "1",
      • "customerPONumber": null,
      • "entity": {
        }
      },
    • "lines": [
      • {
        },
      • {
        }
      ],
    • "subtotals": [
      • {
        },
      • {
        }
      ],
    • "href": "/objects/order-entry/recurring-document::Sales%20Invoice/14"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}

List named recurring documents

get/objects/order-entry/recurring-document::{documentName}

Returns a collection with a key, ID, and link for each recurring document with the specified name. For example, to list all recurring documents that are based on the Sales Invoice transaction definition, specify Sales Invoice as the documentName in the request URL.

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.

SecurityOAuth2
Request
path Parameters
documentName
required
string

Document Name

Example: Sales Invoice
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": [
    • {
      • "key": "171",
      • "id": "171",
      • "href": "/objects/order-entry/recurring-document::Sales%20Invoice/171"
      },
    • {
      • "key": "172",
      • "id": "172",
      • "href": "/objects/order-entry/recurring-document::Sales%20Invoice/172"
      },
    • {
      • "key": "155",
      • "id": "155",
      • "href": "/objects/order-entry/recurring-document::Sales%20Invoice/155"
      }
    ],
  • "ia::meta": {
    • "totalCount": 3,
    • "start": 1,
    • "pageSize": 100
    }
}

Create a recurring document

post/objects/order-entry/recurring-document::{documentName}

Creates a new recurring document. To create a new recurring document, specify the transaction definition that is the template for the new document as documentName in the request URL.

To access a list of available transaction definitions, use the list transaction definitions operation. For example, to create a new recurring document that uses the Sales Invoice transaction definition as a template, specify Sales Invoice for the documentName in the request URL.

SecurityOAuth2
Request
path Parameters
documentName
required
string

Document Name

Example: Sales Invoice
Request Body schema: application/json
required
required
object

Customer associated with the recurring document.

key
string

Unique key for the customer.

Example: "15"
id
string

Unique ID for the customer.

Example: "CR1001"
name
string

Name of the customer.

Example: "Berkeley Technology Inc"
state
string
Default: "active"

State of the recurring document.

Enum: "active" "ended" "inactive"
Example: "active"
object

Contacts associated with the recurring document.

object

Primary contact for the recurring document.

id
string

Unique ID for the primary contact.

Example: "Power Aerospace Materials(C1)"
object

Contact to ship to.

id
string

Unique ID for the contact to ship to.

Example: "Power Aerospace Materials(C2)"
object

Contact to bill to.

id
string

Unique ID for the contact to bill to.

Example: "Power Aerospace Materials(C3)"
object

Shipping method for the document.

key
string

Unique key for the shipping method.

Example: "77"
id
string

Unique ID for the shipping method.

Example: "Air"
href
string

URL endpoint for the shipping method.

Example: "/objects/accounts-receivable/shipping-method/77"
referenceNumber
string

Reference to another document, as needed.

Example: "SALES-100"
contractId
string

Sales contract ID associated with the transaction.

Example: "CN100123"
contractDescription
string

Sales contract description.

Example: "Sales & Service"
baseCurrency
string

Base currency for the transaction.

Example: "USD"
txnCurrency
string

Currency used for the transaction.

Example: "USD"
object

Exchange rate details used to calculate the base amount.

date
string <date>

Exchange rate date for this transaction. Can be the current date, the date the transaction was issued, or the date the transaction will be paid.

Example: "2024-01-23"
rate
string <decimal-precision-10>

Exchange rate used to calculate the base amount from the transaction amount.

Example: "1.0789"
typeId
string

Exchange rate type used to calculate the base amount from the transaction amount.

Example: "1"
typeName
string

The name of the exchange rate type.

Example: "Intacct Daily Rate"
object

Accounts Receivable (AR) term, which determines the expiration date for quotes and the due date for invoices.

key
string

Unique key for the AR term.

Example: "75"
id
string

Name or other unique ID for the AR term.

Example: "10 Days"
notes
string

Notes about the recurring document.

Example: "Fast order"
memo
string

Text to appear on the printed document.

Example: "Lowry solutions"
customerPONumber
string

Customer PO number associated with the transaction.

Example: "ABOTT-1001"
object

Define the scheduling details for the recurring document.

Example: "{ \"startDate\": \"2024-07-01\", \"repeatBy\": \"weeks\", \"repeatInterval\": \"1\" }"
startDate
required
string <date>

Specify the initial date for generating the recurring document. This field remains editable until the first document is processed.

Example: "2025-01-01"
repeatBy
required
string or null
Default: null

Specifies the regular interval at which the recurring document should repeat. This field works in conjunction with the repeatInterval field, where you specify the number of intervals. For example, if you set repeatBy to months and set the repeatInterval to 3, the schedule will run every 3 months.

Enum: "days" "endOfMonth" "months" "none" null "weeks" "years"
Example: "days"
repeatInterval
required
string
Default: "1"

Specifies the interval at which the bill repeats. This field works in conjunction with the repeatBy field, where you specify the regular interval at which the recurring bill should repeat. For example, if you set repeatBy to months and set the repeatInterval to 3, the schedule will run every 3 months.

Example: "3"
endDate
string <date>

Specify the end date for generating the recurring document. A repeatCount can be specified instead of an endDate, but if both are specified, the endDate takes precedence.

Example: "2026-01-01"
recurringDueDate
string <date>

Shows the recurring due date for the scheduled execution of the recurring bill.

Example: "2025-06-01"
frequency
string or null
Deprecated
Default: null

This field has been deprecated. Use the repeatBy field instead.

Enum: "days" "endOfMonth" "months" "none" null "weeks" "years"
repeatCount
string

Specifies the number of times the recurring document should be generated. If an endDate is provided for the schedule, it takes precedence over the repeatCount.

Example: "10"
object

Transaction definition that is associated with this recurring document.

key
string

Unique key for the transaction definition.

Example: "11"
id
string

Name of the transaction definition.

Example: "Sales Invoice"
Array of objects

Lines of the recurring document.

Array
unit
required
string

Unit of measure associated with the recurring document line item.

Example: "Each"
unitQuantity
required
string <decimal-precision-10>

Unit quantity associated with the document line item.

Example: "10.10"
unitPrice
required
string <decimal-precision-10>

Unit price associated with the line item.

Example: "10.50"
object

Item associated with the recurring document line.

memo
string

Memo about the recurring document line item.

Example: "Payment ACH"
object
Example: "{ \"item\": { \"id\": \"1\" }, \"warehouse\": { \"id\": \"1\" }, \"location\": { \"id\": \"1\" }}"
discountPercent
string <decimal-precision-10>

Discount percentage to apply to the document line item.

Example: "10.50"
discountMemo
string

Memo about any discounts taken.

Example: "Festival discount"
revenueRecognitionStartDate
string <date>

The date on which either the revenue recognition schedule and/or the renewal schedule are started.

Example: "2023-04-04"
revenueRecognitionEndDate
string <date>

The date on which either the revenue recognition schedule and/or the renewal schedule are ended.

Example: "2023-04-04"
isPriceProrated
boolean
Default: true

Indicates whether the line item price is prorated.

Example: true
isBillable
boolean
Default: true

Indicates whether the line item is billable.

Example: true
enableTax
boolean
Default: false

Indicates whether the line item is taxable.

Example: false
conversionType
string
Default: "quantity"

Conversion type used for the transaction.

Enum: "price" "quantity"
Example: "quantity"
object

Alternative name for the item for a specific customer.

recurringStatus
string
Default: "active"

Recurrence status for the line item.

Enum: "active" "ended" "inactive"
Example: "active"
status
string
Default: "active"

Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced.

Enum: "active" "inactive"
Example: "active"
object

Header lever details for the document line item.

Array of objects

Lines of the recurring document subtotal.

Array
description
string

Description about the subtotal.

Example: "Tax"
absoluteValue
string <decimal-precision-2>

Non negative base amount calculated across all other lines of the document.

Example: "40.50"
percentValue
string <decimal-precision-10>

Percentage value that is calculated on the total of all line items of the recurring document.

Example: "10.50"
txnAbsoluteValue
string <decimal-precision-2>

Non negative transaction amount calculated across all other lines of the recurring document.

Example: "44.78"
object
status
string
Default: "active"

Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced.

Enum: "active" "inactive"
Example: "active"
Responses
201

Created

400

Bad Request

Request samples
application/json
{
  • "referenceNumber": "RMF-001",
  • "memo": "Discounted order",
  • "txnCurrency": "USD",
  • "baseCurrency": "USD",
  • "shippingMethod": {
    • "id": "Air"
    },
  • "paymentTerm": {
    • "id": "N15"
    },
  • "customer": {
    • "id": "22"
    },
  • "schedule": {
    • "startDate": "2024-07-01",
    • "repeatBy": "weeks",
    • "repeatInterval": "2",
    • "endDate": "2025-12-01'"
    },
  • "lines": [
    • {
      • "unit": "10 Pack",
      • "unitQuantity": "1",
      • "unitPrice": "1000.12",
      • "dimensions": {
        }
      }
    ]
}
Response samples
application/json
{
  • "ia::result": {
    • "key": "13977",
    • "id": "13977",
    • "documentType": "Sales Invoice",
    • "href": "/objects/order-entry/recurring-document::Sales%20Invoice/13977"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}

Get a named recurring document

get/objects/order-entry/recurring-document::{documentName}/{key}

Returns detailed information for a specified recurring document. For example, to return details about an order entry document that uses the Sales Invoice transaction definition as a template, specify Sales Invoice for the documentName in the request URL.

SecurityOAuth2
Request
path Parameters
documentName
required
string

Document Name

Example: Sales Invoice
key
required
string

System-assigned key for the order entry recurring document.

Example: 41
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": {
    • "id": "14",
    • "key": "14",
    • "txnDefinition": {
      • "key": "86",
      • "id": "Sales Invoice",
      • "href": "/objects/order-entry/txn-definition::Sales%20Invoice/86"
      },
    • "status": "active",
    • "contacts": {
      • "primary": {
        },
      • "shipTo": {
        },
      • "billTo": {
        }
      },
    • "referenceNumber": "1012",
    • "paymentTerm": {
      • "key": "5",
      • "id": "N15",
      • "href": "/objects/accounts-receivable/term/5"
      },
    • "shippingMethod": {
      • "id": "Air",
      • "key": "2",
      • "href": "/objects/accounts-receivable/shipping-method/2"
      },
    • "memo": "Recurring subscription",
    • "contractId": null,
    • "contractDescription": null,
    • "notes": null,
    • "subtotal": "11001.32000000000000",
    • "total": "11611.21000000000000",
    • "recurringSchedule": {
      • "id": "15",
      • "key": "15",
      • "href": "/objects/core/schedule/15"
      },
    • "documentType": "Sales Invoice",
    • "schedule": {
      • "startDate": "2025-01-18",
      • "endDate": null,
      • "nextExecutionDate": "2025-01-18",
      • "lastExecutionDate": null,
      • "recurringDueDate": "2025-01-18",
      • "frequency": "weeks",
      • "executionCount": "0",
      • "repeatCount": null,
      • "repeatBy": "weeks",
      • "repeatInterval": "4"
      },
    • "customer": {
      • "key": "22",
      • "id": "CAR",
      • "name": "Bernley Technology Inc",
      • "href": "/objects/accounts-receivable/customer/22"
      },
    • "baseCurrency": "USD",
    • "txnCurrency": "USD",
    • "exchangeRate": {
      • "date": "2025-08-08",
      • "typeName": null,
      • "rate": "1.0000000000",
      • "typeId": null
      },
    • "subtotalInTxnCurrency": "11001.32000000000000",
    • "totalInTxnCurrency": "11611.21000000000000",
    • "state": "active",
    • "audit": {
      • "createdDateTime": "2024-08-08T09:19:34Z",
      • "modifiedDateTime": "2024-08-08T10:46:15Z",
      • "createdByUser": {
        },
      • "createdBy": "1",
      • "modifiedByUser": {
        },
      • "modifiedBy": "1",
      • "customerPONumber": null,
      • "entity": {
        }
      },
    • "lines": [
      • {
        },
      • {
        }
      ],
    • "subtotals": [
      • {
        },
      • {
        }
      ],
    • "href": "/objects/order-entry/recurring-document::Sales%20Invoice/14"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}

Update a recurring document

patch/objects/order-entry/recurring-document::{documentName}/{key}

Updates an existing recurring document by setting field values. Any fields not provided remain unchanged.

SecurityOAuth2
Request
path Parameters
documentName
required
string

Document Name

Example: Sales Invoice
key
required
string

System-assigned key for the order entry recurring document.

Example: 41
Request Body schema: application/json
state
string
Default: "active"

State of the recurring document.

Enum: "active" "ended" "inactive"
Example: "active"
object

Contacts associated with the recurring document.

object

Primary contact for the recurring document.

id
string

Unique ID for the primary contact.

Example: "Power Aerospace Materials(C1)"
object

Contact to ship to.

id
string

Unique ID for the contact to ship to.

Example: "Power Aerospace Materials(C2)"
object

Contact to bill to.

id
string

Unique ID for the contact to bill to.

Example: "Power Aerospace Materials(C3)"
object

Shipping method for the document.

key
string

Unique key for the shipping method.

Example: "77"
id
string

Unique ID for the shipping method.

Example: "Air"
href
string

URL endpoint for the shipping method.

Example: "/objects/accounts-receivable/shipping-method/77"
referenceNumber
string

Reference to another document, as needed.

Example: "SALES-100"
contractId
string

Sales contract ID associated with the transaction.

Example: "CN100123"
contractDescription
string

Sales contract description.

Example: "Sales & Service"
baseCurrency
string

Base currency for the transaction.

Example: "USD"
txnCurrency
string

Currency used for the transaction.

Example: "USD"
object

Exchange rate details used to calculate the base amount.

date
string <date>

Exchange rate date for this transaction. Can be the current date, the date the transaction was issued, or the date the transaction will be paid.

Example: "2024-01-23"
rate
string <decimal-precision-10>

Exchange rate used to calculate the base amount from the transaction amount.

Example: "1.0789"
typeId
string

Exchange rate type used to calculate the base amount from the transaction amount.

Example: "1"
typeName
string

The name of the exchange rate type.

Example: "Intacct Daily Rate"
object

Accounts Receivable (AR) term, which determines the expiration date for quotes and the due date for invoices.

key
string

Unique key for the AR term.

Example: "75"
id
string

Name or other unique ID for the AR term.

Example: "10 Days"
notes
string

Notes about the recurring document.

Example: "Fast order"
memo
string

Text to appear on the printed document.

Example: "Lowry solutions"
customerPONumber
string

Customer PO number associated with the transaction.

Example: "ABOTT-1001"
object

Customer associated with the recurring document.

key
string

Unique key for the customer.

Example: "15"
id
string

Unique ID for the customer.

Example: "CR1001"
name
string

Name of the customer.

Example: "Berkeley Technology Inc"
object

Define the scheduling details for the recurring document.

startDate
string <date>

Specify the initial date for generating the recurring document. This field remains editable until the first document is processed.

Example: "2025-01-01"
endDate
string <date>

Specify the end date for generating the recurring document. A repeatCount can be specified instead of an endDate, but if both are specified, the endDate takes precedence.

Example: "2026-01-01"
recurringDueDate
string <date>

Shows the recurring due date for the scheduled execution of the recurring bill.

Example: "2025-06-01"
frequency
string or null
Deprecated
Default: null

This field has been deprecated. Use the repeatBy field instead.

Enum: "days" "endOfMonth" "months" "none" null "weeks" "years"
repeatCount
string

Specifies the number of times the recurring document should be generated. If an endDate is provided for the schedule, it takes precedence over the repeatCount.

Example: "10"
repeatBy
string or null
Default: null

Specifies the regular interval at which the recurring document should repeat. This field works in conjunction with the repeatInterval field, where you specify the number of intervals. For example, if you set repeatBy to months and set the repeatInterval to 3, the schedule will run every 3 months.

Enum: "days" "endOfMonth" "months" "none" null "weeks" "years"
Example: "days"
repeatInterval
string
Default: "1"

Specifies the interval at which the bill repeats. This field works in conjunction with the repeatBy field, where you specify the regular interval at which the recurring bill should repeat. For example, if you set repeatBy to months and set the repeatInterval to 3, the schedule will run every 3 months.

Example: "3"
object

Transaction definition that is associated with this recurring document.

key
string

Unique key for the transaction definition.

Example: "11"
id
string

Name of the transaction definition.

Example: "Sales Invoice"
Array of objects

Lines of the recurring document.

Array
object

Item associated with the recurring document line.

memo
string

Memo about the recurring document line item.

Example: "Payment ACH"
unit
string

Unit of measure associated with the recurring document line item.

Example: "Each"
unitQuantity
string <decimal-precision-10>

Unit quantity associated with the document line item.

Example: "10.10"
unitPrice
string <decimal-precision-10>

Unit price associated with the line item.

Example: "10.50"
object
discountPercent
string <decimal-precision-10>

Discount percentage to apply to the document line item.

Example: "10.50"
discountMemo
string

Memo about any discounts taken.

Example: "Festival discount"
revenueRecognitionStartDate
string <date>

The date on which either the revenue recognition schedule and/or the renewal schedule are started.

Example: "2023-04-04"
revenueRecognitionEndDate
string <date>

The date on which either the revenue recognition schedule and/or the renewal schedule are ended.

Example: "2023-04-04"
isPriceProrated
boolean
Default: true

Indicates whether the line item price is prorated.

Example: true
isBillable
boolean
Default: true

Indicates whether the line item is billable.

Example: true
enableTax
boolean
Default: false

Indicates whether the line item is taxable.

Example: false
conversionType
string
Default: "quantity"

Conversion type used for the transaction.

Enum: "price" "quantity"
Example: "quantity"
object

Alternative name for the item for a specific customer.

recurringStatus
string
Default: "active"

Recurrence status for the line item.

Enum: "active" "ended" "inactive"
Example: "active"
status
string
Default: "active"

Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced.

Enum: "active" "inactive"
Example: "active"
object

Header lever details for the document line item.

Array of objects

Lines of the recurring document subtotal.

Array
description
string

Description about the subtotal.

Example: "Tax"
absoluteValue
string <decimal-precision-2>

Non negative base amount calculated across all other lines of the document.

Example: "40.50"
percentValue
string <decimal-precision-10>

Percentage value that is calculated on the total of all line items of the recurring document.

Example: "10.50"
txnAbsoluteValue
string <decimal-precision-2>

Non negative transaction amount calculated across all other lines of the recurring document.

Example: "44.78"
object
status
string
Default: "active"

Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced.

Enum: "active" "inactive"
Example: "active"
Responses
200

OK

400

Bad Request

Request samples
application/json
{
  • "value": {
    • "referenceNumber": "Recur-1012",
    • "lines": [
      • {
        }
      ]
    }
}
Response samples
application/json
{
  • "ia::result": {
    • "key": "52",
    • "id": "52",
    • "documentType": "Sales Invoice",
    • "href": "/objects/order-entry/recurring-document::Sales%20Invoice/52"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}

Delete a recurring document

delete/objects/order-entry/recurring-document::{documentName}/{key}

Deletes a recurring document.

SecurityOAuth2
Request
path Parameters
documentName
required
string

Document Name

Example: Sales Invoice
key
required
string

System-assigned key for the order entry recurring document.

Example: 41
Responses
204

No Content

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": {
    • "ia::error": {
      • "code": "invalidRequest",
      • "message": "A POST request requires a payload",
      • "errorId": "REST-1028",
      • "additionalInfo": {
        },
      • "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 0,
    • "totalError": 1
    }
}