---
sourceDocument: Yokohama Finance and Supply Chain
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/source-to-pay-operations

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Finance and Supply Chain

ft:clusterId :

    - stpop

bundleId :

    - stpop

workflow :

    - Employee


---

# Accounts Payable Operations properties

# Accounts Payable Operations properties {#ariaid-title1}

* Release version: Yokohama
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes to read

Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Accounts Payable Operations properties

The Accounts Payable Operations properties form in ServiceNow allows administrators and AP specialists to configure key parameters that control invoice line mapping, invoice ingestion via API, exception management, and tax validation processes.
These settings help streamline invoice processing, improve accuracy, and integrate external tax validation efficiently.
Show full answer Show less  

## Invoice Line Mapping

* **Rules-based engine for invoice line mapping:** Admins and AP admins can enable or disable this engine, which maps invoice lines to purchase order lines automatically.
* **Review of mapping suggestions:** Options exist to allow AP specialists to manually review and confirm invoice line mappings generated either by the rules-based engine or by Now Assist, enhancing verification control.

## Invoice Ingestion API

Integrators can configure the maximum number of invoices processed per batch through the accounts payable invoice create API. The default batch size is 100 invoices, which helps optimize API performance and throughput during invoice ingestion.

## Exception Management

* **Parallel worker threads:** Defines how many threads the exception engine scheduler uses to process invoice exceptions concurrently, with a default of 4 threads.
* **Scheduler wait time:** Sets the interval (default 240 minutes) before the exception engine rechecks invoices for exceptions, balancing processing frequency and system load.
* **Formatter fields:** Configurable filters determine which invoice exception and tolerance-related fields appear in activities, enabling tailored exception monitoring views.

## Tax Management

* **Tax recalculation triggers:** Lists specific invoice and invoice line fields that, when modified, automatically trigger tax recalculation to ensure accurate tax compliance.
* **External tax integration:** Controls whether invoices are sent to an external tax engine for validation, with default enabled.
* **Validation wait time and concurrency:** Specifies maximum wait time for tax validation responses and the number of parallel worker threads for processing tax validations efficiently.
* **Batch size for tax validation:** Sets the maximum number of invoices sent per batch to the external tax system, defaulting to 1000 invoices per batch.
* **Cooldown period:** Defines delay intervals between consecutive tax validation scheduler runs to manage system load.

## Practical Benefits for ServiceNow Customers

By configuring these properties, ServiceNow customers can optimize invoice processing workflows, improve the accuracy of invoice line matching, efficiently handle exceptions, and ensure tax calculations are validated promptly and correctly. These settings provide flexibility to tailor the Accounts Payable Operations module to specific organizational needs, enhancing both automation and manual review capabilities.  
On the Accounts Payable Operations properties form, you can set the parameters that control the invoice line mapping, invoice ingestion for API and exception management.
{#acc-pay-properties__table_qxn_bjk_w2c__entry__3}

| Property | Description | Role |
|-|-|-|
| Invoice line-mapping properties || Admin |
| Enable rules-based engine for invoice line mapping? (Default:Yes) \[sn_ap_apm.mapping.enable_rule_based_mapping\] | Select the property if you want the rule-based engine to perform the mapping of invoice line with the purchase order lines. Deselect the property, if you don't want the rules-based engine to perform the invoice line mapping. For more information on invoice line mapping with purchase order line, see [Rules based engine](https://servicenow-prod.fluidtopics.net/bOrfSF542WcPhdcggpVb_w "The rule based engine maps the invoice line with purchase order line using fields such as unit price, delivered unit price, exact description, exact amount and amount round off."). | Admin |
| Review invoice line mappings predicted by rules-based engine? (Default:No) \[sn_ap_apm.mapping.review_rule_based_mapping_suggestions\] | By default, the property is deselected, and does not allow the AP specialist to review the mapping results generated by rules based engine. Select the property if you want the AP specialist to manually review the mapping results generated by rules based engine, confirm the mapping and change the state to mapping complete. | Admin |
| Review invoice line mappings predicted by Now Assist? (Default:Yes) | By default, the property is selected and allows the AP specialist to review the mapping results generated by Now Assist. After reviewing the mapping results, AP specialist confirms the mapping and changes the state to mapping complete. Deselect the property if you don't want the AP specialist to review the invoice line-mapping results generated by Now Assist. | Admin |
| Invoice ingestion API Properties || Admin |
| Maximum number of invoices according to batch in accounts payable invoice create API \[sn_spend_intg.ap.invoice.create.api.record_limit\] | Maximum number of invoices that can be processed in a batch using accounts payable invoice create API. Default value is 100. | Admin |
| Exception management properties |   | Admin |
| Number of parallel worker threads for exception engine scheduler? \[sn_ap_apm.exception.engine.max_parallel_thread_count\] | Defines the number of parallel threads used by the exception engine scheduler to process invoice exceptions. Default value is 4. | Admin |
| Wait time (minutes) before exception engine scheduler rechecks an invoice for exceptions \[sn_ap_apm.exception.engine.scheduler_cool_off_period\] | Defines the time interval in minutes after which the invoice is picked for processing. Default value is 240. | Admin |
| Formatter fields for invoice exception activity \[glide.ui.sn_ap_apm_exception_activity.fields\] | Filter that lets you select which of the available fields to show in the invoice exceptions. | Admin |
| Formatter fields for invoice exception line activity \[glide.ui.sn_ap_apm_line_exception_activity.fields\] | Filter that lets you select which of the available fields to show in the invoice line exceptions. | Admin |
| Formatter fields for invoice tolerance rule activity \[glide.ui.sn_ap_apm_invoice_tolerance_rule_activity.fields\] | Filter that lets you select which of the available fields to show in the tolerance rules. | Admin |
| Formatter fields for invoice tolerance type activity \[glide.ui.sn_ap_apm_invoice_tolerance_type_activity.fields\] | Filter that lets you select which of the available fields to show in the tolerance type. | Admin |
[Table 1. Accounts Payable Operations properties as an admin]

{#acc-pay-properties__table_qxn_bjk_w2c} {#acc-pay-properties__table_hhr_tfl_w2c__entry__3}

| Property | Description | Role |
|-|-|-|
| Invoice line-mapping properties || AP admin |
| Enable rules-based engine for invoice line mapping? (Default:Yes) \[sn_ap_apm.mapping.enable_rule_based_mapping\] | Select the property if you want the rule-based engine to perform the mapping of invoice line with the purchase order lines. Deselect the property, if you don't want the rules-based engine to perform the invoice line mapping. For more information on invoice line mapping with purchase order line, see [Rules based engine](https://servicenow-prod.fluidtopics.net/bOrfSF542WcPhdcggpVb_w "The rule based engine maps the invoice line with purchase order line using fields such as unit price, delivered unit price, exact description, exact amount and amount round off."). | AP admin |
| Review invoice line mappings predicted by rules-based engine? (Default:No) \[sn_ap_apm.mapping.review_rule_based_mapping_suggestions\] | By default, the property is deselected, and does not allow the AP specialist to review the mapping results generated by rules based engine. Select the property if you want the AP specialist to manually review the mapping results generated by rules based engine, confirm the mapping and change the state to mapping complete. | AP admin |
| Review invoice line mappings predicted by Now Assist? (Default:Yes) | By default, the property is selected and allows the AP specialist to review the mapping results generated by Now Assist. After reviewing the mapping results, AP specialist confirms the mapping and changes the state to mapping complete. Deselect the property if you don't want the AP specialist to review the invoice line-mapping results generated by Now Assist. | AP admin |
| Exception management properties || AP admin |
| Number of parallel worker threads for exception engine scheduler? \[sn_ap_apm.exception.engine.max_parallel_thread_count\] | Defines the number of parallel threads used by the exception engine scheduler to process invoice exceptions. Default value is 4. | AP admin |
| Wait time (minutes) before exception engine scheduler rechecks an invoice for exceptions \[sn_ap_apm.exception.engine.scheduler_cool_off_period\] | Defines the time interval in minutes after which the invoice is picked for processing. Default value is 240. | AP admin |
[Table 2. Accounts Payable Operations properties as an AP admin]

{#acc-pay-properties__table_hhr_tfl_w2c} {#acc-pay-properties__table_i5z_3gl_w2c__entry__3}

| Property | Description | Role |
|-|-|-|
| Invoice ingestion API Properties || Integrator |
| Maximum number of invoices according to batch in accounts payable invoice create API \[sn_spend_intg.ap.invoice.create.api.record_limit\] | Maximum number of invoices that can be processed in a batch using accounts payable invoice create API. Default value is 100. | Integrator |
[Table 3. Accounts Payable Operations properties as an integrator]

{#acc-pay-properties__table_i5z_3gl_w2c} {#acc-pay-properties__table_rz4_tjx_j3c__entry__2}

| Property | Description |
|-|-|
| Tax management properties ||
| List of Invoice fields that, when modified, are eligible for triggering tax recalculation. (Ensure all fields provided are comma-separated and do not have spaces) \[sn_ap_apm.invoice_attributes_for_tax_revalidation\] supplier_invoice_number,invoice_date,supplier,legal_entity,subtotal,amount_invoiced_without_tax_transaction_currency,ship_to_street,ship_to_city,ship_to_state_or_province,ship_to_country,ship_to_zip_or_postal_code,ship_from_street,ship_from_city,ship_from_state_or_province,ship_from_country,ship_from_zip_or_postal_code | The mandatory invoice fields needed for tax engine to automatically trigger re-calculation when invoice data is modified. |
| Maximum time to wait for tax validation from the external tax integration (minutes) \[sn_ap_apm.maximum_wait_time_for_tax_validation\] | The maximum time in seconds that Accounts Payable Operations will wait for a response from tax engine while performing tax validation on an invoice. |
| Enable integration with external tax system\[sn_ap_apm.enable_integration_with_external_tax_system\] | Controls whether invoices are sent to external tax engine for automated tax validation. Default value is Yes. |
| List of Invoice line fields that, when modified, are eligible for triggering tax recalculation. (Ensure all fields provided are comma-separated and do not have spaces) \[sn_ap_apm.invoice_line_attributes-for-tax-revalidation\] sub_total,line_description | Determines which line-level field changes are significant enough to require re-sending the invoice line data to tax engine for fresh tax calculation. |
| Number of invoices processed in parallel \[sn_ap_apm.external_tax.scheduler.parallel_worker_threads\] | Defines the number of parallel worker threads that the tax validation scheduler uses to process invoice tax validations concurrently when sending requests to the external tax engine. |
| Time to wait before revalidating tax on an invoice (minutes) \[sn_ap_apm.external_tax.scheduler_cool_off_period\] | Defines the waiting period (in seconds) between consecutive executions of the tax validation scheduler job. Default value is 60. |
| Maximum number of invoices sent per batch \[sn_ap_apm.external_tax_max_invoices_per_batch\] | Maximum number of invoices that can be sent to the external tax engine in a single batch request during tax validation processing. Default value is 1000. |
[Table 4. Accounts Payable Operations properties as an AP admin]

{#acc-pay-properties__table_rz4_tjx_j3c}
**Related concepts**   

* [Accounts Payable Operations glossary](https://servicenow-prod.fluidtopics.net/uVcefHb3IQtulDeCafgXXQ#apo-glossary "Learn about the terms and concepts used in Accounts Payable Operations (APO).")  
**Related reference**   

* [Create New Invoice Line form](https://servicenow-prod.fluidtopics.net/Nn1Jni7chbjuUZif8K0H8Q "Use the Create New Invoice Line form to provide details about an invoice line.")
* [Create invoice cost allocation form](https://servicenow-prod.fluidtopics.net/wZ9mxepl0upxObb4_mdzsA "Allocate invoice line cost across multiple cost centers.")
* [Outbound cost allocation staging table](https://servicenow-prod.fluidtopics.net/me7SU_XgL9N1WuXJN1KDPA "The outbound cost allocation [sn_spend_intg_outbound_invoice_cost_allocation] staging table stores important data about cost allocation information so that an ERP integrator can export this data to a third-party ERP system.")
* [Distribution set form](https://servicenow-prod.fluidtopics.net/eUckwer9sN6t4ftdEu7w8w "Create a distribution set to split cost allocations automatically for invoice lines.")
* [Create New Invoice case form](https://servicenow-prod.fluidtopics.net/oaUsSAqZNxyVTAoeeYqTOQ "Use the Create New Invoice case form to provide details about the Invoice case.")
* [Create New Invoice task form](https://servicenow-prod.fluidtopics.net/_rInspM0Mzs2stbEy9DDPA "Use the Create New Invoice task form to provide details about the Invoice task.")
* [Invoice processing case form](https://servicenow-prod.fluidtopics.net/_IpQvQtafFHOHzDmNR5~dA "Use the Invoice processing case form to view the case details that store invoice information that an Accounts Payable Specialist can use to perform related tasks.")
* [Tax lines](https://servicenow-prod.fluidtopics.net/svGPBHQx1KWVeRkkmQeueQ "The Tax lines tab lists the tax line associated with the invoice line.")
* [Invoice exception form](https://servicenow-prod.fluidtopics.net/7JIGYZMNoPVjPnJLStXmsg "Use the invoice exception form to view the case details that store invoice exception information that an Accounts Payable Specialist can use to perform related tasks.")
* [Request Help form](https://servicenow-prod.fluidtopics.net/0FmOUgUaISt_0ndL6hR1NA "Suppliers use the Request Help form to report an inquiry related issue or request.")
* [Data required for invoice processing](https://servicenow-prod.fluidtopics.net/bdFC5eXGnr4d6CzC4g3tIw "Reference information for the key tables and required data used to process invoices in Accounts Payable Operations.")
* [Invoice exception definition form](https://servicenow-prod.fluidtopics.net/m3MoDBYBOMM_JwCOFZr4iA "Use the Invoice exception definition form to provide details about the new invoice exception definition.")
* [Approval Rule form](https://servicenow-prod.fluidtopics.net/Wh_S3lVbmm4p9CAf_IDd9Q "Use the Approval Rule form to provide details about the new approval rule.")
* [Approval Plan form](https://servicenow-prod.fluidtopics.net/yZ~Lyu53TsRSNBMDZNAt1A "Use the Approval Plan form to view details of the overall invoice approval process.")