Testing the API Integration
After you complete the configuration, you need to test it.
The test cases here are grouped together so you can test the features that you use. You may not need all of these or you may need more, depending on your implementation.
Caution
These test cases are suggested tests based on a typical installation. You also need to consider your own needs and create test cases to suit.
Connections
Name | Description |
---|---|
Connection and Authentication in the Sandbox | To confirm that the connection to the Sandbox environment is correct, verify that the correct |
Connection and Authentication in Production | To confirm that connection to the Production environment is correct, verify that the correct For more information, see API Authentication. |
Transactions
After you create and confirm transactions using the API, you can view these in the dashboard in the Transaction List. To view it, go to TRANSACTIONS -> LIST.
If you click on a transaction, you can drill down to the details page where you can view the fields that are included in the transaction.
Name | Description |
---|---|
EU Tax Liability | Test that transactions for each EU country where you expect Taxamo to have the liability use the expected VAT rate. |
Confirmed and Stored Transactions | Test that the transactions are stored and confirmed in the Taxamo system. |
Business-to-Business (B2B) Sales | If you process Business-to-Business (B2B) sales, check that the buyer's VAT number is passed through to the Taxamo system and reverse charge is applied if applicable. |
IOSS | For transactions that are confirmed with Taxamo and where Taxamo has the liability, the |
Shipping Locations | Test that the correct Ship to and Ship from country is provided in the transaction to Taxamo. |
Price Inclusivity and Exclusivity | Test price inclusivity or exclusivity. You may include the VAT in the displayed amount on page on your site or not. Test one or both of the following as required:
|
Custom IDs | Add your |
Multiple Line Orders - Tax Liability Note: Multiple-line orders means an order with more than one transaction line. | Check an order with multiple lines that the VAT is added correctly. |
Multiple Line Orders - Transaction | Check an order with multiple lines is stored and confirmed in the Taxamo system. |
Multiple Line Orders - Invoices | Check the order with multiple lines creates an email with invoice to your test buyer. |
Multiple Site Currencies | If your site allows sales in more than one currency, check that the appropriate currency code is sent in the transaction for each code. For more information, see Supported Countries and Currencies. |
Currency Codes | Check the price in another currency to ensure the correct currency code is passed. |
Invoices and Credit Notes
In the case of refunds, a credit note is issued against the original invoice.
Name | Description |
---|---|
Invoices or Credit Notes (Test Buyer) | Test that the invoices or credit notes are sent to the test buyer. |
Tax Liability
Information
You also test the tax liability for transactions in the Transactions test cases section.
Name | Description |
---|---|
Unsupported Countries | Test a country that Taxamo does not support. For example, create a transaction that is shipped to a country outside the EU. Ensure that your system handles these transactions and they are not sent to Taxamo. |
Taxamo is not Liable | Create an order where Taxamo is not liable. For example, a consignment of 160 EUR sent to Ireland. |
Shipping (Postage)
Name | Description |
---|---|
Shipping | Test an order that includes shipping, ensure shipping is added as |
Shipping - Order Confirmation and Storage | Check the order with shipping is stored and confirmed in Taxamo system. |
Shipping - Line Item Descriptions | Check that the Taxamo invoice includes shipping and the line item description displays as expected. |
Product Classification
Name | Description |
---|---|
Product Classification Codes | You use the Product Classification utility to generate codes that you can add to your requests to the Taxamo API. For more information about classifying products, see Product Classification. To test that this is working, add the The codes that you used in your requests are available in the Audit report. For more information, see Audit Report. |
Refunds
Taxamo classifies refunds as one of the following types:
- Partial: Where only some of the lines in a transaction are refunded.
- Full: Where all of the lines in a transaction are refunded.
For more information, see Configuring Refunds.
Name | Description |
---|---|
Partial Refund | Create a partial refund. Ensure the refund is confirmed in the Taxamo system and a credit note is generated and received by your test buyer. |
Full Refund | Create a full refund. Ensure the refund is confirmed in the Taxamo system and a credit note is generated and received by your test buyer. |
Error Testing
For more information, see Handling Errors.
Name | Description |
---|---|
Error Messages | Create an error to ensure that error messages are handled correctly. |
Billing
For more information about how to configure Billing, see Configuring Billing Information.
Name | Description |
---|---|
Sandbox Credit Card | Confirm that a Test Credit card has been selected on the billing page on the sandbox. |
Production Credit Card | Confirm that you have added your actual credit card details on the billing page in your production account. |
Updated 8 months ago