Transaction definitions

A transaction definition is the template for a sales transaction. It contains the accounting rules, workflow settings, and other configuration settings that determine a transaction's behavior.

See About transaction definitions - Order Entry in the Sage Intacct Help Center for more information.

List transaction definitions

get/objects/order-entry/txn-definition

Returns a collection with a key, ID, and link for each transaction definition. This operation is mostly for use in testing; use query to find objects that meet certain criteria and to specify properties that are returned.

Permissions and other requirements
SubscriptionOrder Entry
User typeBusiness, Employee, Project Manager, Warehouse
PermissionsList, View, transaction definitions
SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples 
Response samples 
application/json
{
  • "ia::result": [
    • {
      • "key": "35",
      • "id": "Sales Return",
      • "href": "/objects/order-entry/txn-definition/35"
      },
    • {
      • "key": "37",
      • "id": "Sales Invoice",
      • "href": "/objects/order-entry/txn-definition/37"
      },
    • {
      • "key": "40",
      • "id": "Shipper",
      • "href": "/objects/order-entry/txn-definition/40"
      }
    ],
  • "ia::meta": {
    • "totalCount": 3,
    • "start": 1,
    • "pageSize": 100
    }
}
Create a transaction definition
post/objects/order-entry/txn-definition
Creates a new Order Entry transaction definition. Advanced workflows must be enabled to add new transaction definitions. See Transaction definitions - Order Entry in the Sage Intacct Help Center for more information.



Permissions and other requirements



SubscriptionOrder Entry


User typeBusiness, Employee, Project Manager, Warehouse


PermissionsList, View, Add transaction definitions







SecurityOAuth2 
Request 
Request Body schema: application/json
id
required
string
The name for the transaction definition.


 
 Example:  "Sales Quote"
docClass
string
 Default:  "quote"
Order Entry transaction template type, which determines whether certain fields appear on a transaction.


 Enum: "adjustment" "invoice" "list" "order" "other" "quote"  
 Example:  "quote"
workflowCategory
string
 Default:  "quote"
The workflow category associates the transaction with the applicable transaction menu grouping in the Order Entry menu.


 Enum: "invoice" "order" "quote" "return" "shipping"  
 Example:  "quote"
description
string
A meaningful description of the transaction definition.


 
 Example:  "Sales Return RevRec Document"
editPolicy
string
 Default:  "all"
Sets the edit permission for this transaction type.


    

  • noEdit - The user cannot edit the transaction after it is created.
    • 

  • beforePrinting - The user can edit the transaction until it has been printed to PDF. After it has been printed, the transaction cannot be edited.
    • 

  • editInDraftOnly- The user can edit the transaction until it has been posted. After it has been posted, the transaction cannot be edited.
all - The user can edit the transaction as allowed by the transaction's condition. See Editing a sales transaction for editing restrictions.
    • 



 Enum: "all" "beforePrinting" "editInDraftOnly" "noEdit"  
 Example:  "noEdit"
deletePolicy
string
 Default:  "noDelete"
Sets the delete permission for this transaction type. By default, a user cannot delete a transaction after it is created.


    

  • noDelete - The user cannot delete the transaction after it is created.
    • 

  • beforePrinting - The user can delete the transaction until it has been printed to PDF. After it has been printed, the transaction cannot be deleted.
    • 

  • all - The user can delete the transaction as allowed by the transaction's condition. See Editing a sales transaction for editing restrictions.
    • 



 Enum: "all" "beforePrinting" "noDelete"  
 Example:  "all"
enableNumberingSequence
boolean
 Default:  false
Set to true to enable numbering sequences to be set for transactions.


 
 Example:  false
preserveNumberingSequence
boolean
 Default:  false
Set to true to ensure that numbers in a sequence are never skipped. Enabling this option can affect performance when a large volume of transactions is entered at the same time.


 
 Example:  false
inheritDocumentNumber
boolean
 Default:  false
Set to true if transactions should inherit source document numbers. For example, a transaction could inherit a sales invoice number.


 
 Example:  false
inventoryUpdateType
string
 Default:  "no"
Specify if inventory will be affected by the transaction and, if so, whether to track the quantity, value, or both.


 Enum: "no" "quantity" "quantityAndValue" "value"  
 Example:  "no"
increaseOrDecreaseInventory
string
 Default:  "increase"
Specify whether the inventory running total is increased or decreased by the transaction.


 Enum: "decrease" "increase"  
 Example:  "increase"
txnPostingMethod
string
 Default:  "noPosting"
Specify whether the transaction post process creates a GL entry and, if so, whether it will post directly to the GL or to the AR subledger.


 Enum: "noPosting" "toAR" "toGL"  
 Example:  "toGL"
disableTax
boolean
 Default:  false
Set to true to disable tax capture for the transaction.


 
 Example:  false
enableFulfillment
boolean
 Default:  false
Set to true to enable the transaction definition for fulfillment.


 
 Example:  false
enableReservingAndPicking
boolean
 Default:  false
Set to true to enable inventory items for reserving and picking.


 
 Example:  false
partialConvertMethod
string
 Default:  "closeTransaction"
Specify how the system processes transactions that are partially complete.


    

  • leaveTransactionOpen - When the user converts the transaction to another transaction type, the system leaves the original transaction open until all items are completed.
    • 

  • closeOriginalAndCreateBackOrder - When the user converts the transaction to another transaction type and enters an item quantity that's less than the original transaction quantity, the system closes the original transaction and creates a new transaction for the remaining item quantity.
    • 

  • closeTransaction - When the user converts the transaction to another transaction type, the system closes the original transaction regardless of whether the transaction is complete.
See Convert part of a transaction in the Sage Intacct Help Center for more information.
    • 



 Enum: "closeOriginalAndCreateBackOrder" "closeTransaction" "leaveTransactionOpen"  
 Example:  "closeTransaction"
affectsCost
boolean
 Default:  false
If true the transaction will affect the costing of order entry.


 
 Example:  false
overrideExchangeRateType
boolean
 Default:  true
Indicates whether users can edit the Exchange rate and/or Exchange rate type fields of the transaction.


 
 Example:  false
showBaseCurrency
boolean
 Default:  false
Specifies whether the transaction amounts are displayed in both base currency and transaction currency. The following fields display amounts in the currency selected as the transaction currency on a transaction: Price, Extended price, Transaction value, and Transaction total.
If showBaseCurrency is set to true, the transaction currency amount fields appear and the following fields also appear: Base price, Extended base price, Base value, and Base total. These additional fields display the amounts in the company's base currency. 


 
 Example:  false
overridePrice
boolean
 Default:  true
Set to true to allow users to override line item prices on the transaction.


 
 Example:  false
trackDiscountAndSurcharge
boolean
 Default:  false
Indicates whether users can discount transaction line items.


 
 Example:  false
allowDiscountOnExtendedPrice
boolean
 Default:  false
Indicates whether the transaction definition can be used for contract invoices. This field is only applicable if the company is subscribed to Contracts.


 
 Example:  false
requireMemoForDiscount
boolean
 Default:  false
Indicates whether users must provide notes for line items being discounted before saving a transaction.


 
 Example:  false
displayDraftsOnRevenueTxnEntriesPage
boolean
 Default:  false
Indicates whether the transaction can be displayed on the Revenue transaction entries page when in a draft state.


 
 Example:  false
freezeRecallValue
boolean
 Default:  false
Set to true to freeze recalled values.


 
 Example:  false
enableSubtotals
boolean
 Default:  false
Set to true to specify standard subtotals, such as tax or a discount, for the transaction.


 
 Example:  false
showExpandedTaxDetails
boolean
 Default:  false
Set to true to show expanded tax details in the transaction user interface and in printed output. This field applies only to companies that use Avalara AvaTax or Sage Intacct Advanced Tax.


 
 Example:  false
enableOverrideTax
boolean
 Default:  false
Indicates whether users can override whether a line item is taxable.


 
 Example:  false
revrecEnablementType
string
 Default:  "none"
Specifies whether revenue recognition applies to transactions created from this definition and, if so, whether to post the revenue recognition or only display it. This field applies only to companies subscribed to Revenue Management and is applicable only to Order Entry revenue recognition.


 Enum: "displayOnly" "none" "post"  
 Example:  "post"
renewalEnablementType
string
 Default:  "none"
Specifies whether contract renewals apply to the transaction type and, if so, whether the renewal is set up to generate when the transaction posts or the renewal fields are displayed in the transaction so users can select a renewal transaction set.


 Enum: "displayOnly" "generate" "none"  
 Example:  "displayOnly"
enableLineItemConversion
boolean
 Default:  false
Set to true to allow users to convert a sales transaction by line item into a scheduled recurring transaction.


 
 Example:  false
allowRenewConvertedLineOnly
boolean
 Default:  false
This field is only applicable if renewalEnablementType is set to generate. Set this field to true if the system should only renew line items that were converted in the original sales transaction. Set to false if all indicated line items should be renewed, regardless of conversion status.


 
 Example:  false
allowLocationOverride
boolean
 Default:  false
Set to 'true' to allow users to override the location set for the transaction.


 
 Example:  false
allowDepartmentOverride
boolean
 Default:  false
Set to true to allow users to override the department set for the transaction.


 
 Example:  false
xslTemplate
string
Document template to use for printed output (PDFs).


 
 Example:  "sales"
fixedMessage
string
This message is displayed in the Print/Email document.


 
 Example:  "For any inquiries or assistance, please contact our customer service."
contactOneTitle
string
 Default:  "Bill to"
Use this field to change the Bill-to labels on the transaction and on the printed document.


 
 Example:  "Bill to"
contactTwoTitle
string
 Default:  "Ship to"
Use this field to change the Ship-to labels on the transaction and on the printed document.


 
 Example:  "Ship to"
printBillToContact
boolean
 Default:  false
Set to true to show the Bill-to contact in the printed document.


 
 Example:  false
printShipToContact
boolean
 Default:  false
Set to true to show the Ship-to contact in the printed document.


 
 Example:  false
allowEditingBillToContact
boolean
 Default:  false
Set to true to allow users to change the Bill-to contact during transaction entry.


 
 Example:  false
allowEditingShipToContact
boolean
 Default:  false
Set to true to allow users to change the Ship-to contact during transaction entry.


 
 Example:  false
enableWarnOnLowQuantity
boolean
 Default:  true
Set to true to alert the user when the quantity needed is greater than the ONHAND total in the selected warehouse. The warning also shows the ONORDER and ONHOLD totals.


 
 Example:  false
enableCreditLimitCheck
boolean
 Default:  false
Specifies whether to enforce customer credit limit restrictions in transactions created from this definition.


 
 Example:  false
warehouseSelectionMethod
string
 Default:  "sortByID"
Specifies how warehouses are presented to the user in the warehouse list in the transaction.


 Enum: "sortByID" "sortByName" "useTheDefaultWarehouse" "warehouseWithAvailableInventory"  
 Example:  "sortByID"
enablePayments
boolean
 Default:  false
Set to true to enable users to apply payments to an invoice in Order Entry and to set a recurring template to automatically charge a credit card when an invoice is generated (if the company is subscribed to Payment Services).


 
 Example:  false
postToGL
boolean
 Default:  false
Set to true to enable additional posting to the General Ledger.


 
 Example:  false
requireSupplyOfPrices
boolean
 Default:  false
Set to true if a price must be supplied.


 
 Example:  false
enableCosting
boolean
 Default:  false
Set to true to enable costing for non-inventoried items.


 
 Example:  false
documentConversionPolicy
string or null
 Default:  null
Document conversion policy.


    

  • newDocumentOnly - The user can create the transaction as a standalone transaction (by selecting Add from a transaction list, or the plus icon next to the transaction definition in the Sage Intacct menu, or by copying an existing transaction, and so on).
    • 

  • newDocumentOrConvert - The user can create the transaction as a standalone transaction or the user can create the transaction by converting the previous transaction in the workflow.
    • 

  • convertOnly - The user can only create the transaction by converting the previous transaction in the workflow. For example, the user can only create a sales invoice by converting an existing sales order.
    • 



 Enum: "convertOnly" "newDocumentOnly" "newDocumentOrConvert" null  
 Example:  "convertOnly"
multiEntityRuleForTransaction
string
 Default:  "topLevelOrEntity"
Sets the context for where users can create transactions from this transaction definition within a multi-entity, shared environment.


 Enum: "entityOnly" "topLevelOnly" "topLevelOrEntity"  
 Example:  "topLevelOnly"
enableProjectActualBillings
boolean
 Default:  false
Set to true to enable display of actual billings on printed or emailed invoices.


 
 Example:  false
lineLevelSimpleTax
boolean
 Default:  false
Set to true to allow the tax rate to be overridden at the line level when using Simple Tax. This option appears only if enableSubtotals is set to true.


 
 Example:  false
customerVendorEditRule
string or null
 Default:  null
Allow users to change the customer in Draft or Pending transactions if the transaction has not been converted to another transaction, the transaction date is in an open period, and the transaction's payment status is not Paid or Partially paid.
This field follows any editing restrictions imposed by the editPolicy field and is only applicable if the edit policy is set to all or beforePrinting. 


    

  • always - The user can edit the customer in all applicable scenarios.
    • 

  • exceptConvertedDocuments - The user can edit the customer in the first transaction in a workflow but not in transactions created by conversion.
    • 

  • never - The user cannot edit the customer.
    • 



 Enum: "always" "exceptConvertedDocuments" "never" null  
 Example:  "always"
enableRetainage
boolean
 Default:  false
For companies subscribed to Construction, set to 'true' to enable retainage.


 
 Example:  false
enableAdditionalInformationScope
boolean
 Default:  false
For companies subscribed to Construction, set to 'true' to enable identification of work that is included and excluded, the reason why, and the terms.


 
 Example:  false
enableAdditionalInformationSchedule
boolean
 Default:  false
For companies subscribed to Construction, set to 'true' to enable identification of dates for work milestones.


 
 Example:  false
enableInternalReference
boolean
 Default:  false
For companies subscribed to Construction, set to 'true' to enable identification of who authorized work internally and when they authorized the work.


 
 Example:  false
enableExternalReference
boolean
 Default:  false
For companies subscribed to Construction, set to 'true' to enable identification of who authorized work externally and when they authorized the work.


 
 Example:  false
enableBond
boolean
 Default:  false
For companies subscribed to Construction, set to 'true' to identify information about performance and payment bonds.


 
 Example:  false
documentChangeType
string
 Default:  "noChange"
Indicates whether to enable changes to the transaction definition and, if so, how to handle changes.


 Enum: "changeOrder" "enableChange" "noChange"  
 Example:  "enableChange"
reportingCategory
string or null
 Default:  null
Establishes a reporting category that best reflects the purpose of the transaction definition so that similar documents can be grouped when building reports. This field is applicable for use with Interactive Custom Report Writer or Interactive Visual Explorer subscriptions only.


 Enum: "conferencesAndGatherings" "contractBids" "contractChangeOrders" "contractInvoicePreview" "contractInvoices" "contracts" "eventConfirmations" "eventInvoices" "eventReservations" "forecastRevenue" "giftsAndDonations" "grantApplications" "grantAwardInvoices" "invoicePreview" "invoices" "membershipInvoices" "membershipRegistrations" null "pledgeAndGiftInvoices" "pledges" "pointOfSale" "projectInvoices" "reservations" "revRecActivation" "salesClearingShippers" "salesCredits" "salesDebits" "salesOrderChangeOrders" "salesOrderInvoices" "salesOrders" "salesQuotes" "salesReturns" "salesShippers" "sponsorshipInvoices" "sponsorships" "subscriptionInvoices" "subscriptions" "tuitionInvoices" "tuitionRegistrations"  
 Example:  "salesQuotes"
enableContractBilling
boolean
 Default:  false
Set to true to display the project contract billing for transactions. This option also displays project contract billing details on Order Entry Contract invoices.


 
 Example:  false
arPostingMethod
string or null
 Default:  null
Update method for project contract totals.


 Enum: "addition" "none" null  
 Example:  "addition"
object
Specify the document numbering sequence to use to automatically number transactions. Omit a numbering sequence if transactions are to be numbered manually or if they will inherit the source document number (inheritDocumentNumber is set to true).


 
key
string
Unique key for the document numbering sequence.


 
 Example:  "10"
id
string
ID of the document numbering sequence.


 
 Example:  "Adjustment Decrease"
object
The first price list the system will evaluate when determining a suggested transaction price.


 
key
string
Unique key for the price list.


 
 Example:  "6"
id
string
ID for the price list.


 
 Example:  "Initial Price List"
object
The price list that will be updated when a user saves a transaction.


 
key
string
Unique key for the price list.


 
 Example:  "35"
id
string
The name of the price list.


 
 Example:  "OE Price List"
object
If using layered price lists, this indicates a special price list (for example, a discounted price list or seasonal price list). The special price list takes precedence over the initial price list.


 
key
string
Unique key for the price list.


 
 Example:  "15"
id
string
ID for the price list.


 
 Example:  "Special price list"
object
Specify the default warehouse. Applies only if the warehouseSelectionMethod is set to useTheDefaultWarehouse.


 
key
string
Unique key for the warehouse.


 
 Example:  "21"
id
string
Unique name or other ID for the warehouse.


 
 Example:  "Warehouse-001"
object
The default for how goods in the transaction are shipped to the customer. If a shipping method is specified for a customer, the customer shipping method takes precedence as the default in the transaction.


 
key
string
Unique key for the shipping method.


 
 Example:  "11"
id
string
Name of the shipping method.


 
 Example:  "FedEx"
object
Specifies the template for populating the transaction subtotals table.


 
key
string
Unique key for the subtotal template.


 
 Example:  "22"
id
string
Name of the subtotal template.


 
 Example:  "Subtotal template"
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:  "41"
id
string
The name of AR term.


 
 Example:  "10 Days"
object
Specify a custom exchange rate type if transactions should not default to the Sage Intacct Daily Rate.


 
key
string
Unique key for the exchange rate type.


 
 Example:  "-1"
id
string
The name of exchange rate type.


 
 Example:  "Intacct Daily Rate"
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"
Array of objects
Specify the COGS GL accounts to debit and credit. For companies that do not use Inventory Control, these accounts are required when the enableCosting field is set to true and the txnPostingMethod field is set to toAR.


 
 Array 
isOffset
boolean
 Default:  false
If true, then the line will be marked as offset.


 
 Example:  true
txnType
string
Debit or credit type.


 Enum: "credit" "debit"  
 Example:  "debit"
moduleType
string
Module type.


 Enum: "additional" "inventory" "subledger"  
 Example:  "subledger"
lineNumber
integer  <= 8 characters 
Line no.


 
 Example:  1
object
 
object
 
object
 
object
 
object
 
object
Customer GL Group


 
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"
Array of objects
When the txnPostingMethod field is set to toAR or toGL, specify the AR or GL accounts to debit and credit.


 
 Array 
isOffset
boolean
 Default:  false
If true then the line is marked as Offset.


 
 Example:  true
txnType
string
Debit or credit type.


 Enum: "credit" "debit"  
 Example:  "debit"
moduleType
string
Module type.


 Enum: "additional" "inventory" "subledger"  
 Example:  "subledger"
lineNumber
integer  <= 8 characters 
Line no.


 
 Example:  1
object
 
object
 
object
 
object
 
object
 
object
Customer GL Group


 
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"
Array of objects
When the txnPostingMethod field is set to toAR and the postToGL field is set to true, specify the GL account details for additional GL account posting. These accounts are used to reverse the previous transaction in the workflow.


 
 Array 
isOffset
boolean
 Default:  false
If true then the line is marked as offset.


 
 Example:  true
txnType
string
Debit or credit type.


 Enum: "credit" "debit"  
 Example:  "debit"
moduleType
string
Module type.


 Value: "additional"  
 Example:  "additional"
lineNumber
integer  <= 8 characters 
Line no.


 
 Example:  1
object
 
object
 
object
 
object
 
object
 
object
Customer GL Group


 
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"
Array of objects
Specifies the inventory running total that will be affected by the transaction and how the total will be affected.


 
 Array 
maintainType
string
Maintain type.


 Enum: "quantity" "quantityAndValue" "value"  
 Example:  "value"
operation
string
Add or subtract.


 Enum: "add" "subtract"  
 Example:  "add"
object
Inventory total


 
Array of objects
Provides details about the type of subtotals that are supported for the transaction.


 
 Array 
subtotalType
string or null
 Default:  null
Subtotal type.


 Enum: "charge" "discount" null  
 Example:  "discount"
lineNumber
integer  <= 8 characters 
Line number.


 
 Example:  1
description
string
Description.


 
 Example:  "Discount"
valueType
string or null
 Default:  null
Value type.


 Enum: "amount" null "percent"  
 Example:  "amount"
subtotalValue
string <decimal-precision-2>   <= 12 characters 
Provide a default value for the subtotal. If Value type is Amount, enter the amount of the subtotal. For example, enter 250. If Value type is Percent, enter a percentage as a whole number. For example, enter 10 for 10%. Users can override the default subtotal value in the transaction.


 
 Example:  "10.23"
isApportioned
boolean
 Default:  false
If true, then the discount subtotal will be apportioned across all line items in the transaction.


 
 Example:  true
object
Select the GL account to which the subtotal will post.


 
object
Select the offset GL account to which the subtotal will post


 
txnType
string or null
 Default:  null
Transaction type - debit or credit.


 Enum: "credit" "debit" null  
 Example:  "debit"
appliedToLineNumber
integer  <= 8 characters 
Specify the subtotal line number to which the subtotal will apply. Sage Intacct treats the initial subtotal line as line number 0. The first defined subtotal from the transaction definition is line number 1, the second defined subtotal is line number 2, and so on. The value of Applied to line is implicitly assumed to be 0. Taxes, all other charges, and discounts are computed at the line level. This fields does not apply if is set to line-level Simple Tax.


 
 Example:  1
isTax
boolean
 Default:  false
Flags the subtotal as a tax. When the transaction posts, the tax will post separately based on the items in the transaction.


 
 Example:  true
object
Select a default department for the subtotal


 
enableAvalaraTax
boolean
 Default:  false
If set to true then the subtotal line item applies to AvaTax.


 
 Example:  true
Array of objects
Provides document conversion details for the transaction.


 
 Array 
object
Specify the transaction definitions from which this transaction can be converted. For example, a sales invoice can be converted from a sales order and a shipper.


 
isDefault
boolean
 Default:  false
Default for bulk conversion.


 
 Example:  true
Array of objects
Provides details about the entities that can create transactions, and also includes settings for each entity, such as numbering sequences and document templates.


 
 Array 
enableNumberingSequence
boolean
 Default:  false
If true then enable sequence numbering.


 
 Example:  false
preserveNumberingSequence
boolean
 Default:  false
If true then preserve sequence numbering.


 
 Example:  false
canInheritSourceDocumentNumber
boolean
 Default:  false
Inherit source document number.


 
 Example:  false
object
Provide printed document template to use as the default for printed output (PDFs) for the corresponding entity. Order entry transaction definition document template is used if you not provide this field.


 
enableCreateTransactionRule
boolean
 Default:  false
Create transactions in.


 
 Example:  false
object
Specifies the template for populating the transaction subtotals table.


 
showExpandedTaxDetail
boolean
 Default:  false
Show expanded tax details.


 
 Example:  false
enableOverrideTax
boolean
 Default:  false
Line-item tax.


 
 Example:  false
enableLineLevelSimpleTax
boolean
 Default:  false
Enable line-level Simple Tax.


 
 Example:  false
object
 
object
 
Responses 
201
Created


400
Bad Request


Request samples 
application/json
{
  • "id": "Sales Invoice",
  • "docClass": "invoice",
  • "workflowCategory": "invoice",
  • "description": "Sales Invoice",
  • "deletePolicy": "all",
  • "enableNumberingSequence": true,
  • "preserveNumberingSequence": true,
  • "inheritDocumentNumber": false,
  • "inventoryUpdateType": "value",
  • "increaseOrDecreaseInventory": "decrease",
  • "disableTax": true,
  • "enableFulfillment": true,
  • "enableReservingAndPicking": true,
  • "partialConvertMethod": "closeOriginalAndCreateBackOrder",
  • "affectsCost": true,
  • "overrideExchangeRateType": false,
  • "overridePrice": false,
  • "trackDiscountAndSurcharge": true,
  • "allowDiscountOnExtendedPrice": true,
  • "requireMemoForDiscount": true,
  • "showExpandedTaxDetails": true,
  • "enableOverrideTax": true,
  • "renewalEnablementType": "generate",
  • "enableLineItemConversion": true,
  • "allowRenewConvertedLineOnly": true,
  • "allowLocationOverride": true,
  • "allowDepartmentOverride": true,
  • "xslTemplate": "Sales Invoice",
  • "fixedMessage": "For assistance, please contact customer service.",
  • "printBillToContact": true,
  • "allowEditingBillToContact": true,
  • "printShipToContact": true,
  • "allowEditingShipToContact": true,
  • "enableWarnOnLowQuantity": false,
  • "enableCreditLimitCheck": true,
  • "warehouseSelectionMethod": "useTheDefaultWarehouse",
  • "displayDraftsOnRevenueTxnEntriesPage": true
}
Response samples 
application/json
{
  • "ia::result": {
    • "key": "53",
    • "id": "53",
    • "href": "/objects/order-entry/txn-definition/53"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Get a transaction definition
get/objects/order-entry/txn-definition/{key}
Returns detailed information for a specified transaction definition.



Permissions and other requirements



SubscriptionOrder Entry


User typeBusiness, Employee, Project Manager, Warehouse


PermissionsList, View, transaction definitions







SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned unique key for the transaction definition.


 
 Example:  37
Responses 
200
OK


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "key": "63",
    • "id": "Sales Invoice",
    • "docClass": "invoice",
    • "workflowCategory": "invoice",
    • "description": "Sales Invoice",
    • "enableUserOrGroupPermmission": false,
    • "editPolicy": "all",
    • "deletePolicy": "all",
    • "enableNumberingSequence": true,
    • "documentSequence": {
      • "id": "OE-Doc",
      • "printTitle": "Sales Invoice"
      },
    • "preserveNumberingSequence": true,
    • "inheritDocumentNumber": false,
    • "inventoryUpdateType": "no",
    • "increaseOrDecreaseInventory": "decrease",
    • "txnPostingMethod": "noPosting",
    • "disableTax": false,
    • "enableFulfillment": false,
    • "enableReservingAndPicking": false,
    • "partialConvertMethod": "closeOriginalAndCreateBackOrder",
    • "affectsCost": false,
    • "exchangeRateType": {
      • "id": "Intacct Daily Rate",
      • "key": "-1"
      },
    • "overrideExchangeRateType": true,
    • "showBaseCurrency": false,
    • "initialPriceList": {
      • "id": "Base Price List",
      • "key": "1",
      • "href": "/objects/order-entry-price-list/1"
      },
    • "overridePrice": true,
    • "trackDiscountAndSurcharge": false,
    • "allowDiscountOnExtendedPrice": false,
    • "requireMemoForDiscount": false,
    • "freezeRecallValue": false,
    • "enableSubtotals": false,
    • "showExpandedTaxDetails": false,
    • "enableOverrideTax": false,
    • "revrecEnablementType": "none",
    • "renewalEnablementType": "generate",
    • "enableLineItemConversion": true,
    • "allowRenewConvertedLineOnly": false,
    • "allowLocationOverride": true,
    • "allowDepartmentOverride": true,
    • "xslTemplate": "Sales Invoice",
    • "fixedMessage": "Sales Transaction",
    • "contactOneTitle": "Bill to",
    • "printBillToContact": true,
    • "allowEditingBillToContact": false,
    • "printShipToContact": true,
    • "contactTwoTitle": "Ship to",
    • "allowEditingShipToContact": false,
    • "enableWarnOnLowQuantity": false,
    • "enableCreditLimitCheck": false,
    • "warehouseSelectionMethod": "useTheDefaultWarehouse",
    • "warehouse": {
      • "id": "WH02"
      },
    • "status": "active",
    • "enablePayments": false,
    • "postToGL": false,
    • "requireSupplyOfPrices": false,
    • "enableCosting": false,
    • "audit": {
      • "createdDateTime": "2023-06-27T14:22:49Z",
      • "modifiedDateTime": "2023-06-27T14:22:49Z",
      • "createdBy": "1",
      • "modifiedBy": "1"
      },
    • "documentConversionPolicy": "newDocumentOrConvert",
    • "multiEntityRuleForTransaction": "topLevelOrEntity",
    • "enableProjectActualBillings": false,
    • "lineLevelSimpleTax": false,
    • "customerVendorEditRule": "never",
    • "enableRetainage": false,
    • "enableAdditionalInformationScope": false,
    • "enableAdditionalInformationSchedule": false,
    • "enableInternalReference": false,
    • "enableExternalReference": false,
    • "enableBond": false,
    • "documentChangeType": "noChange",
    • "reportingCategory": "salesOrderInvoices",
    • "enableContractBilling": false,
    • "arPostingMethod": "none",
    • "displayDraftsOnRevenueTxnEntriesPage": false,
    • "href": "/objects/order-entry/txn-definition/63"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Update a transaction definition
patch/objects/order-entry/txn-definition/{key}
Updates an existing transaction definition by setting field values. Any fields not provided remain unchanged. 


The changes you make to a transaction definition apply to transactions that are created after the changes are made. The changes do not apply to existing transactions unless you edit and save the transactions after changes are made to the transaction definition.



Permissions and other requirements



SubscriptionOrder Entry


User typeBusiness, Employee, Project Manager, Warehouse


PermissionsList, View, Edit transaction definitions







SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned unique key for the transaction definition.


 
 Example:  37
Request Body schema: application/json
docClass
string
 Default:  "quote"
Order Entry transaction template type, which determines whether certain fields appear on a transaction.


 Enum: "adjustment" "invoice" "list" "order" "other" "quote"  
 Example:  "quote"
workflowCategory
string
 Default:  "quote"
The workflow category associates the transaction with the applicable transaction menu grouping in the Order Entry menu.


 Enum: "invoice" "order" "quote" "return" "shipping"  
 Example:  "quote"
description
string
A meaningful description of the transaction definition.


 
 Example:  "Sales Return RevRec Document"
editPolicy
string
 Default:  "all"
Sets the edit permission for this transaction type.


    

  • noEdit - The user cannot edit the transaction after it is created.
    • 

  • beforePrinting - The user can edit the transaction until it has been printed to PDF. After it has been printed, the transaction cannot be edited.
    • 

  • editInDraftOnly- The user can edit the transaction until it has been posted. After it has been posted, the transaction cannot be edited.
all - The user can edit the transaction as allowed by the transaction's condition. See Editing a sales transaction for editing restrictions.
    • 



 Enum: "all" "beforePrinting" "editInDraftOnly" "noEdit"  
 Example:  "noEdit"
deletePolicy
string
 Default:  "noDelete"
Sets the delete permission for this transaction type. By default, a user cannot delete a transaction after it is created.


    

  • noDelete - The user cannot delete the transaction after it is created.
    • 

  • beforePrinting - The user can delete the transaction until it has been printed to PDF. After it has been printed, the transaction cannot be deleted.
    • 

  • all - The user can delete the transaction as allowed by the transaction's condition. See Editing a sales transaction for editing restrictions.
    • 



 Enum: "all" "beforePrinting" "noDelete"  
 Example:  "all"
enableNumberingSequence
boolean
 Default:  false
Set to true to enable numbering sequences to be set for transactions.


 
 Example:  false
preserveNumberingSequence
boolean
 Default:  false
Set to true to ensure that numbers in a sequence are never skipped. Enabling this option can affect performance when a large volume of transactions is entered at the same time.


 
 Example:  false
inheritDocumentNumber
boolean
 Default:  false
Set to true if transactions should inherit source document numbers. For example, a transaction could inherit a sales invoice number.


 
 Example:  false
inventoryUpdateType
string
 Default:  "no"
Specify if inventory will be affected by the transaction and, if so, whether to track the quantity, value, or both.


 Enum: "no" "quantity" "quantityAndValue" "value"  
 Example:  "no"
increaseOrDecreaseInventory
string
 Default:  "increase"
Specify whether the inventory running total is increased or decreased by the transaction.


 Enum: "decrease" "increase"  
 Example:  "increase"
txnPostingMethod
string
 Default:  "noPosting"
Specify whether the transaction post process creates a GL entry and, if so, whether it will post directly to the GL or to the AR subledger.


 Enum: "noPosting" "toAR" "toGL"  
 Example:  "toGL"
disableTax
boolean
 Default:  false
Set to true to disable tax capture for the transaction.


 
 Example:  false
enableFulfillment
boolean
 Default:  false
Set to true to enable the transaction definition for fulfillment.


 
 Example:  false
enableReservingAndPicking
boolean
 Default:  false
Set to true to enable inventory items for reserving and picking.


 
 Example:  false
partialConvertMethod
string
 Default:  "closeTransaction"
Specify how the system processes transactions that are partially complete.


    

  • leaveTransactionOpen - When the user converts the transaction to another transaction type, the system leaves the original transaction open until all items are completed.
    • 

  • closeOriginalAndCreateBackOrder - When the user converts the transaction to another transaction type and enters an item quantity that's less than the original transaction quantity, the system closes the original transaction and creates a new transaction for the remaining item quantity.
    • 

  • closeTransaction - When the user converts the transaction to another transaction type, the system closes the original transaction regardless of whether the transaction is complete.
See Convert part of a transaction in the Sage Intacct Help Center for more information.
    • 



 Enum: "closeOriginalAndCreateBackOrder" "closeTransaction" "leaveTransactionOpen"  
 Example:  "closeTransaction"
affectsCost
boolean
 Default:  false
If true the transaction will affect the costing of order entry.


 
 Example:  false
overrideExchangeRateType
boolean
 Default:  true
Indicates whether users can edit the Exchange rate and/or Exchange rate type fields of the transaction.


 
 Example:  false
showBaseCurrency
boolean
 Default:  false
Specifies whether the transaction amounts are displayed in both base currency and transaction currency. The following fields display amounts in the currency selected as the transaction currency on a transaction: Price, Extended price, Transaction value, and Transaction total.
If showBaseCurrency is set to true, the transaction currency amount fields appear and the following fields also appear: Base price, Extended base price, Base value, and Base total. These additional fields display the amounts in the company's base currency. 


 
 Example:  false
overridePrice
boolean
 Default:  true
Set to true to allow users to override line item prices on the transaction.


 
 Example:  false
trackDiscountAndSurcharge
boolean
 Default:  false
Indicates whether users can discount transaction line items.


 
 Example:  false
allowDiscountOnExtendedPrice
boolean
 Default:  false
Indicates whether the transaction definition can be used for contract invoices. This field is only applicable if the company is subscribed to Contracts.


 
 Example:  false
requireMemoForDiscount
boolean
 Default:  false
Indicates whether users must provide notes for line items being discounted before saving a transaction.


 
 Example:  false
displayDraftsOnRevenueTxnEntriesPage
boolean
 Default:  false
Indicates whether the transaction can be displayed on the Revenue transaction entries page when in a draft state.


 
 Example:  false
freezeRecallValue
boolean
 Default:  false
Set to true to freeze recalled values.


 
 Example:  false
enableSubtotals
boolean
 Default:  false
Set to true to specify standard subtotals, such as tax or a discount, for the transaction.


 
 Example:  false
showExpandedTaxDetails
boolean
 Default:  false
Set to true to show expanded tax details in the transaction user interface and in printed output. This field applies only to companies that use Avalara AvaTax or Sage Intacct Advanced Tax.


 
 Example:  false
enableOverrideTax
boolean
 Default:  false
Indicates whether users can override whether a line item is taxable.


 
 Example:  false
revrecEnablementType
string
 Default:  "none"
Specifies whether revenue recognition applies to transactions created from this definition and, if so, whether to post the revenue recognition or only display it. This field applies only to companies subscribed to Revenue Management and is applicable only to Order Entry revenue recognition.


 Enum: "displayOnly" "none" "post"  
 Example:  "post"
renewalEnablementType
string
 Default:  "none"
Specifies whether contract renewals apply to the transaction type and, if so, whether the renewal is set up to generate when the transaction posts or the renewal fields are displayed in the transaction so users can select a renewal transaction set.


 Enum: "displayOnly" "generate" "none"  
 Example:  "displayOnly"
enableLineItemConversion
boolean
 Default:  false
Set to true to allow users to convert a sales transaction by line item into a scheduled recurring transaction.


 
 Example:  false
allowRenewConvertedLineOnly
boolean
 Default:  false
This field is only applicable if renewalEnablementType is set to generate. Set this field to true if the system should only renew line items that were converted in the original sales transaction. Set to false if all indicated line items should be renewed, regardless of conversion status.


 
 Example:  false
allowLocationOverride
boolean
 Default:  false
Set to 'true' to allow users to override the location set for the transaction.


 
 Example:  false
allowDepartmentOverride
boolean
 Default:  false
Set to true to allow users to override the department set for the transaction.


 
 Example:  false
xslTemplate
string
Document template to use for printed output (PDFs).


 
 Example:  "sales"
fixedMessage
string
This message is displayed in the Print/Email document.


 
 Example:  "For any inquiries or assistance, please contact our customer service."
contactOneTitle
string
 Default:  "Bill to"
Use this field to change the Bill-to labels on the transaction and on the printed document.


 
 Example:  "Bill to"
contactTwoTitle
string
 Default:  "Ship to"
Use this field to change the Ship-to labels on the transaction and on the printed document.


 
 Example:  "Ship to"
printBillToContact
boolean
 Default:  false
Set to true to show the Bill-to contact in the printed document.


 
 Example:  false
printShipToContact
boolean
 Default:  false
Set to true to show the Ship-to contact in the printed document.


 
 Example:  false
allowEditingBillToContact
boolean
 Default:  false
Set to true to allow users to change the Bill-to contact during transaction entry.


 
 Example:  false
allowEditingShipToContact
boolean
 Default:  false
Set to true to allow users to change the Ship-to contact during transaction entry.


 
 Example:  false
enableWarnOnLowQuantity
boolean
 Default:  true
Set to true to alert the user when the quantity needed is greater than the ONHAND total in the selected warehouse. The warning also shows the ONORDER and ONHOLD totals.


 
 Example:  false
enableCreditLimitCheck
boolean
 Default:  false
Specifies whether to enforce customer credit limit restrictions in transactions created from this definition.


 
 Example:  false
warehouseSelectionMethod
string
 Default:  "sortByID"
Specifies how warehouses are presented to the user in the warehouse list in the transaction.


 Enum: "sortByID" "sortByName" "useTheDefaultWarehouse" "warehouseWithAvailableInventory"  
 Example:  "sortByID"
enablePayments
boolean
 Default:  false
Set to true to enable users to apply payments to an invoice in Order Entry and to set a recurring template to automatically charge a credit card when an invoice is generated (if the company is subscribed to Payment Services).


 
 Example:  false
postToGL
boolean
 Default:  false
Set to true to enable additional posting to the General Ledger.


 
 Example:  false
requireSupplyOfPrices
boolean
 Default:  false
Set to true if a price must be supplied.


 
 Example:  false
enableCosting
boolean
 Default:  false
Set to true to enable costing for non-inventoried items.


 
 Example:  false
documentConversionPolicy
string or null
 Default:  null
Document conversion policy.


    

  • newDocumentOnly - The user can create the transaction as a standalone transaction (by selecting Add from a transaction list, or the plus icon next to the transaction definition in the Sage Intacct menu, or by copying an existing transaction, and so on).
    • 

  • newDocumentOrConvert - The user can create the transaction as a standalone transaction or the user can create the transaction by converting the previous transaction in the workflow.
    • 

  • convertOnly - The user can only create the transaction by converting the previous transaction in the workflow. For example, the user can only create a sales invoice by converting an existing sales order.
    • 



 Enum: "convertOnly" "newDocumentOnly" "newDocumentOrConvert" null  
 Example:  "convertOnly"
multiEntityRuleForTransaction
string
 Default:  "topLevelOrEntity"
Sets the context for where users can create transactions from this transaction definition within a multi-entity, shared environment.


 Enum: "entityOnly" "topLevelOnly" "topLevelOrEntity"  
 Example:  "topLevelOnly"
enableProjectActualBillings
boolean
 Default:  false
Set to true to enable display of actual billings on printed or emailed invoices.


 
 Example:  false
lineLevelSimpleTax
boolean
 Default:  false
Set to true to allow the tax rate to be overridden at the line level when using Simple Tax. This option appears only if enableSubtotals is set to true.


 
 Example:  false
customerVendorEditRule
string or null
 Default:  null
Allow users to change the customer in Draft or Pending transactions if the transaction has not been converted to another transaction, the transaction date is in an open period, and the transaction's payment status is not Paid or Partially paid.
This field follows any editing restrictions imposed by the editPolicy field and is only applicable if the edit policy is set to all or beforePrinting. 


    

  • always - The user can edit the customer in all applicable scenarios.
    • 

  • exceptConvertedDocuments - The user can edit the customer in the first transaction in a workflow but not in transactions created by conversion.
    • 

  • never - The user cannot edit the customer.
    • 



 Enum: "always" "exceptConvertedDocuments" "never" null  
 Example:  "always"
enableRetainage
boolean
 Default:  false
For companies subscribed to Construction, set to 'true' to enable retainage.


 
 Example:  false
enableAdditionalInformationScope
boolean
 Default:  false
For companies subscribed to Construction, set to 'true' to enable identification of work that is included and excluded, the reason why, and the terms.


 
 Example:  false
enableAdditionalInformationSchedule
boolean
 Default:  false
For companies subscribed to Construction, set to 'true' to enable identification of dates for work milestones.


 
 Example:  false
enableInternalReference
boolean
 Default:  false
For companies subscribed to Construction, set to 'true' to enable identification of who authorized work internally and when they authorized the work.


 
 Example:  false
enableExternalReference
boolean
 Default:  false
For companies subscribed to Construction, set to 'true' to enable identification of who authorized work externally and when they authorized the work.


 
 Example:  false
enableBond
boolean
 Default:  false
For companies subscribed to Construction, set to 'true' to identify information about performance and payment bonds.


 
 Example:  false
documentChangeType
string
 Default:  "noChange"
Indicates whether to enable changes to the transaction definition and, if so, how to handle changes.


 Enum: "changeOrder" "enableChange" "noChange"  
 Example:  "enableChange"
reportingCategory
string or null
 Default:  null
Establishes a reporting category that best reflects the purpose of the transaction definition so that similar documents can be grouped when building reports. This field is applicable for use with Interactive Custom Report Writer or Interactive Visual Explorer subscriptions only.


 Enum: "conferencesAndGatherings" "contractBids" "contractChangeOrders" "contractInvoicePreview" "contractInvoices" "contracts" "eventConfirmations" "eventInvoices" "eventReservations" "forecastRevenue" "giftsAndDonations" "grantApplications" "grantAwardInvoices" "invoicePreview" "invoices" "membershipInvoices" "membershipRegistrations" null "pledgeAndGiftInvoices" "pledges" "pointOfSale" "projectInvoices" "reservations" "revRecActivation" "salesClearingShippers" "salesCredits" "salesDebits" "salesOrderChangeOrders" "salesOrderInvoices" "salesOrders" "salesQuotes" "salesReturns" "salesShippers" "sponsorshipInvoices" "sponsorships" "subscriptionInvoices" "subscriptions" "tuitionInvoices" "tuitionRegistrations"  
 Example:  "salesQuotes"
enableContractBilling
boolean
 Default:  false
Set to true to display the project contract billing for transactions. This option also displays project contract billing details on Order Entry Contract invoices.


 
 Example:  false
arPostingMethod
string or null
 Default:  null
Update method for project contract totals.


 Enum: "addition" "none" null  
 Example:  "addition"
object
Specify the document numbering sequence to use to automatically number transactions. Omit a numbering sequence if transactions are to be numbered manually or if they will inherit the source document number (inheritDocumentNumber is set to true).


 
key
string
Unique key for the document numbering sequence.


 
 Example:  "10"
id
string
ID of the document numbering sequence.


 
 Example:  "Adjustment Decrease"
object
The first price list the system will evaluate when determining a suggested transaction price.


 
key
string
Unique key for the price list.


 
 Example:  "6"
id
string
ID for the price list.


 
 Example:  "Initial Price List"
object
The price list that will be updated when a user saves a transaction.


 
key
string
Unique key for the price list.


 
 Example:  "35"
id
string
The name of the price list.


 
 Example:  "OE Price List"
object
If using layered price lists, this indicates a special price list (for example, a discounted price list or seasonal price list). The special price list takes precedence over the initial price list.


 
key
string
Unique key for the price list.


 
 Example:  "15"
id
string
ID for the price list.


 
 Example:  "Special price list"
object
Specify the default warehouse. Applies only if the warehouseSelectionMethod is set to useTheDefaultWarehouse.


 
key
string
Unique key for the warehouse.


 
 Example:  "21"
id
string
Unique name or other ID for the warehouse.


 
 Example:  "Warehouse-001"
object
The default for how goods in the transaction are shipped to the customer. If a shipping method is specified for a customer, the customer shipping method takes precedence as the default in the transaction.


 
key
string
Unique key for the shipping method.


 
 Example:  "11"
id
string
Name of the shipping method.


 
 Example:  "FedEx"
object
Specifies the template for populating the transaction subtotals table.


 
key
string
Unique key for the subtotal template.


 
 Example:  "22"
id
string
Name of the subtotal template.


 
 Example:  "Subtotal template"
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:  "41"
id
string
The name of AR term.


 
 Example:  "10 Days"
object
Specify a custom exchange rate type if transactions should not default to the Sage Intacct Daily Rate.


 
key
string
Unique key for the exchange rate type.


 
 Example:  "-1"
id
string
The name of exchange rate type.


 
 Example:  "Intacct Daily Rate"
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"
Array of objects
Specify the COGS GL accounts to debit and credit. For companies that do not use Inventory Control, these accounts are required when the enableCosting field is set to true and the txnPostingMethod field is set to toAR.


 
 Array 
isOffset
boolean
 Default:  false
If true, then the line will be marked as offset.


 
 Example:  true
txnType
string
Debit or credit type.


 Enum: "credit" "debit"  
 Example:  "debit"
moduleType
string
Module type.


 Enum: "additional" "inventory" "subledger"  
 Example:  "subledger"
lineNumber
integer  <= 8 characters 
Line no.


 
 Example:  1
object
 
object
 
object
 
object
 
object
 
object
Customer GL Group


 
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"
Array of objects
When the txnPostingMethod field is set to toAR or toGL, specify the AR or GL accounts to debit and credit.


 
 Array 
isOffset
boolean
 Default:  false
If true then the line is marked as Offset.


 
 Example:  true
txnType
string
Debit or credit type.


 Enum: "credit" "debit"  
 Example:  "debit"
moduleType
string
Module type.


 Enum: "additional" "inventory" "subledger"  
 Example:  "subledger"
lineNumber
integer  <= 8 characters 
Line no.


 
 Example:  1
object
 
object
 
object
 
object
 
object
 
object
Customer GL Group


 
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"
Array of objects
When the txnPostingMethod field is set to toAR and the postToGL field is set to true, specify the GL account details for additional GL account posting. These accounts are used to reverse the previous transaction in the workflow.


 
 Array 
isOffset
boolean
 Default:  false
If true then the line is marked as offset.


 
 Example:  true
txnType
string
Debit or credit type.


 Enum: "credit" "debit"  
 Example:  "debit"
moduleType
string
Module type.


 Value: "additional"  
 Example:  "additional"
lineNumber
integer  <= 8 characters 
Line no.


 
 Example:  1
object
 
object
 
object
 
object
 
object
 
object
Customer GL Group


 
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"
Array of objects
Specifies the inventory running total that will be affected by the transaction and how the total will be affected.


 
 Array 
maintainType
string
Maintain type.


 Enum: "quantity" "quantityAndValue" "value"  
 Example:  "value"
operation
string
Add or subtract.


 Enum: "add" "subtract"  
 Example:  "add"
object
Inventory total


 
Array of objects
Provides details about the type of subtotals that are supported for the transaction.


 
 Array 
subtotalType
string or null
 Default:  null
Subtotal type.


 Enum: "charge" "discount" null  
 Example:  "discount"
lineNumber
integer  <= 8 characters 
Line number.


 
 Example:  1
description
string
Description.


 
 Example:  "Discount"
valueType
string or null
 Default:  null
Value type.


 Enum: "amount" null "percent"  
 Example:  "amount"
subtotalValue
string <decimal-precision-2>   <= 12 characters 
Provide a default value for the subtotal. If Value type is Amount, enter the amount of the subtotal. For example, enter 250. If Value type is Percent, enter a percentage as a whole number. For example, enter 10 for 10%. Users can override the default subtotal value in the transaction.


 
 Example:  "10.23"
isApportioned
boolean
 Default:  false
If true, then the discount subtotal will be apportioned across all line items in the transaction.


 
 Example:  true
object
Select the GL account to which the subtotal will post.


 
object
Select the offset GL account to which the subtotal will post


 
txnType
string or null
 Default:  null
Transaction type - debit or credit.


 Enum: "credit" "debit" null  
 Example:  "debit"
appliedToLineNumber
integer  <= 8 characters 
Specify the subtotal line number to which the subtotal will apply. Sage Intacct treats the initial subtotal line as line number 0. The first defined subtotal from the transaction definition is line number 1, the second defined subtotal is line number 2, and so on. The value of Applied to line is implicitly assumed to be 0. Taxes, all other charges, and discounts are computed at the line level. This fields does not apply if is set to line-level Simple Tax.


 
 Example:  1
isTax
boolean
 Default:  false
Flags the subtotal as a tax. When the transaction posts, the tax will post separately based on the items in the transaction.


 
 Example:  true
object
Select a default department for the subtotal


 
enableAvalaraTax
boolean
 Default:  false
If set to true then the subtotal line item applies to AvaTax.


 
 Example:  true
Array of objects
Provides document conversion details for the transaction.


 
 Array 
object
Specify the transaction definitions from which this transaction can be converted. For example, a sales invoice can be converted from a sales order and a shipper.


 
isDefault
boolean
 Default:  false
Default for bulk conversion.


 
 Example:  true
Array of objects
Provides details about the entities that can create transactions, and also includes settings for each entity, such as numbering sequences and document templates.


 
 Array 
enableNumberingSequence
boolean
 Default:  false
If true then enable sequence numbering.


 
 Example:  false
preserveNumberingSequence
boolean
 Default:  false
If true then preserve sequence numbering.


 
 Example:  false
canInheritSourceDocumentNumber
boolean
 Default:  false
Inherit source document number.


 
 Example:  false
object
Provide printed document template to use as the default for printed output (PDFs) for the corresponding entity. Order entry transaction definition document template is used if you not provide this field.


 
enableCreateTransactionRule
boolean
 Default:  false
Create transactions in.


 
 Example:  false
object
Specifies the template for populating the transaction subtotals table.


 
showExpandedTaxDetail
boolean
 Default:  false
Show expanded tax details.


 
 Example:  false
enableOverrideTax
boolean
 Default:  false
Line-item tax.


 
 Example:  false
enableLineLevelSimpleTax
boolean
 Default:  false
Enable line-level Simple Tax.


 
 Example:  false
object
 
object
 
Responses 
200
OK


400
Bad Request


Request samples 
application/json
{
  • "description": "Sales Order RevRec Display Only",
  • "overridePrice": true
}
Response samples 
application/json
{
  • "ia::result": {
    • "key": "52",
    • "href": "/objects/order-entry/txn-definition/52"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Delete a transaction definition
delete/objects/order-entry/txn-definition/{key}
Deletes an order entry transaction definition.



Permissions and other requirements



SubscriptionOrder Entry


User typeBusiness, Employee, Project Manager, Warehouse


PermissionsList, View, Delete transaction definitions







SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned unique key for the transaction definition.


 
 Example:  37
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
    }
}
Query transaction definitions
post/services/core/query
Use the query service to find transaction definitions that meet certain criteria and to specify the properties that are returned.


SecurityOAuth2 
Responses 
200
OK


Request samples