Skip to main content

Test Tax App


Test Tax App


Before testing the Tax app, you must ensure that you have installed and set up the Tax app. See Getting Started with Tax for more information.

Test Tax App

After the Zuora Tax app is configured, take the following steps to test the app:

  1. Configure Debug Logging.
    1. Log into your Connect tenant, navigate to My Connect > Tenants.
    2. Hover over the tenant and click Apps to enter the Apps page.
    3. Click the Apps tab, hover over the created Tax app instance, and click  to launch the instance. 
    4. In the Testing tab, select the number of hours to capture logs in the dropdown list next to the Start Logging button.
    5. Click Start Logging.
  2. Create a test product in your product catalog. See Create a Product in Product Catalog for more information on creating a product. 
  3. Create a subscription on an account with only the test product. See Create Subscriptions for more information.
  4. Define billing rules. Navigate to Settings > Billing > Define Billing Rules > edit in your Zuora tenant. 
  5. Create a bill run for the test account and generate an invoice. See Creating Bill Runs for more information.
  6. Post the invoice. If the tax value is displayed on your invoice, your template was configured correctly and can be used for future bill runs. 
  7. If no tax is displayed on the invoice, take the following steps to troubleshoot:
    1. Navigate back to your Connect tenant and enter the Tax instance. 
    2. In the Testing tab, click the  icon to enable the columns to be displayed. Zuora recommends you enable the Exception and Status columns. Testing

      Each request should contain two lines: the request and the response. If there is no return payload in the response, check the API transaction for the corresponding request. The error message may provide additional information.  

    3. If both the request and response are present, check the values in the Status column. 
      • If the value is Success, review the transaction response of the Tax instance and check for the error in the response. Use the error message as a guide in your tax template and resubmit the request after resolving the issue. 
      • If the value of Error, review the message in the Exception column. Common causes of the errors include the incorrect selection of your authentication type and invalid credentials. 

Alternatively, you can use the CURL requests to test your configurations.