Accounts Payable Operations properties
Summarize
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 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.
| 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. | |
| 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. | |
| 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. | |
| Invoice ingestion API Properties | ||
| 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. | |
| Exception management properties | ||
| 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. | |
| 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. | |
| 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. | |
| 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. | |
| 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. | |
| 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. | |
| 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. | |
| 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. | |
| 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. | |
| Exception management properties | ||
| 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. | |
| 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. | |
| 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. | |
| 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. |