---
sourceDocument: Brazil Sales Customer Relationship Management
sourceDocumentLink: https://www.servicenow.com/docs/r/order-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Sales Customer Relationship Management

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# Configure invoice quantity validation

# Configure the invoice quantity validation extension point {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read  
Implement the invoice quantity check extension point to enable the invoice dispute intake assistant AI agent to validate a customer's quantity dispute claim by reconciling it with delivered quantity data from your Enterprise
Resource Planning (ERP) or inventory system.

## Before you begin

The application scope must be set to Manage Invoice Operations. You can change the application scope using the application picker in the Unified Navigation bar.

Role required: admin

## About this task

The demo data for the Manage Invoice Operations application includes a sample implementation called invoiceQuantityCheckDemo as part of the sn_inv_ops_aias.invoiceQuantityCheckEP
extension point. To enable real-world validation of quantity disputes against your external ERP system or inventory delivery records, replace the demo implementation with your own custom logic.

The demo implementation also illustrates a fallback pattern. When sold product information is unavailable on an invoice line, the function validates the disputed quantity against the corresponding
sales order line quantity instead. You can mirror this pattern in your custom implementation when applicable.

## Procedure

1. Log in to the ServiceNow instance.
2. Navigate to AllSystem Extension PointsScripted Extension Points.
3. Search for the sn_inv_ops_aias.invoiceQuantityCheckEP scripted extension point in the API Name field.
4. View the sample script included in the demo data by selecting sn_inv_ops_aias.invoiceQuantityCheckEP.
5. Create your own implementation of the extension point by selecting the Create implementation related link.
6. On the Script Include form, fill in the fields.  
   For a description of the Script Include form fields, see [Script includes](https://www.servicenow.com/docs/access?context=c_ScriptIncludes&version=brazil&pubname=brazil-api-reference&ft:locale=en-US).
7. Override the functions in the script to implement your logic for validating the customer's quantity dispute claim.  

   checkInvoiceQuantityWithInvoiceCase
   :   Placeholder function meant to be overridden. Use this placeholder to implement the logic to validate quantity disputes across multiple invoice lines associated with an invoice case.
   :
       Input:

           {
               "invoiceNumber": <Invoice number of the customer invoice record>,
               "verifiedInvoiceLineDetails": <Array of invoice line details>


       Output:

           {
           "invoiceLineNumber": <Invoice line number against which the dispute was raised>,
           "disputedQuantity": <Disputed quantity claimed by the customer, as available in the invoice case line>
           }


   checkInvoiceQuantity
   :   Placeholder function meant to be overridden. Use this placeholder to implement the logic to validate a quantity dispute by reconciling the customer's claimed quantity against your ERP or inventory delivery
       records.
   :
       Input:

           {
               "invoiceNumber": <Invoice number of the customer invoice record>,
               "invoiceLineNumber": <Invoice line number of the customer invoice line record against which the dispute was raised>,
               "userEnteredQty": <Disputed quantity claimed by the customer>
           }


       Output:

           {
               "invoiceLineNumber": <Invoice line number against which the dispute was raised>,
               "invoiceQty": <Actual quantity on the invoice line record>,
               "deliveredQty": <Integer representing the disputed quantity claimed
                                 by the customer>,
               "qtyMatch": <Boolean; true if the customer's dispute claim is valid, false if the invoiced and claimed quantities match>,
               "isError": <Boolean; true if the API call failed, false if the API call was successful>,
               "errorMessage": <Error message string to handle failure scenarios>
           }


8. Select Update.
9. **Optional:** Validate your implementation by submitting an invoice dispute from the Business Portal using the ServiceNow Otto Virtual Agent.  
   For more information, see [Dispute invoice issues using ServiceNow Otto Virtual Agent](https://www.servicenow.com/docs/9AiWEdKJ8LzoGb9AgNpltg "Dispute invoice issues such as quantity discrepancies in a guided conversational flow using ServiceNow Otto Virtual Agent from the Business Portal, without needing to contact support.").
**Related topics**   

* [Using extension points to extend application functionality](https://www.servicenow.com/docs/access?context=extension-points&version=brazil&pubname=brazil-api-reference&ft:locale=en-US)
* [Creating and adding a scripted extension point](https://www.servicenow.com/docs/access?context=impl-scripted-ext-pts-base-code&version=brazil&pubname=brazil-api-reference&ft:locale=en-US)

*[\>]: and then