Informative Invoices

Use Informative invoices to create invoices where no calculations are done.

Informative invoices use the information that you specify directly on the invoice. No tax is calculated by the service. You specify this in the inbound request instead.

You can also use this with Refunds to create credit notes.

Passing Through Tax Information

For example, you may want to use this to specify local taxes that are calculated elsewhere. You can use any of the fields listed in the Tax Components Schema to specify these.

Example Request

Here is an example request that specifies a country and country subdivision tax:

        "transaction_lines": [
            {
                "custom_id": "customID_1",
                "informative": true,
                "amount": 120,
                "tax-name": "GST+PST",
                "tax_components": [
                    {
                        "tax_name": "GST-informative",
                        "jurisdiction_type": "COUNTRY",
                        "tax_rate": 11,
                        "tax_amount": 6.00
                    },
                    {
                        "tax_name": "PST-informative",
                        "jurisdiction_type": "PROVINCE",
                        "tax_rate": 7.5,
                        "tax_amount": 8.40
                    }
                ]

            }
        ],

Example Response

This returns the following response:

    "transaction_lines": [
            {
                "amount": 120.00,
                "informative": true,
                "unit_price": 120.00,
                "tax_amount": 22.20,
                "tax_deducted": false,
                "tax_region": "CA",
                "tax_rate": 18.5,
                "tax_country_code": "CA",
                "line_key": "xDlm7KnzNnz8LNL_",
                "custom_id": "customID_1",
                "tax_name": "GST+PST",
                "tax_rate_checks": [
                    "domestic.IN.HR",
                    "domestic.IN",
                    "CA-GST-enabled",
                    "CA-BC-PST-enabled",
                    "CA-SK-PST-enabled",
                    "CA-QC-QST-enabled",
                    "CA-MB-RST-enabled"
                ],
                "line_num": 1,
                "deducted_tax_amount": 0.00,
                "quantity": 1.000000000000,
                "total_amount": 142.20,
                "tax_components": [
                    {
                        "tax_name": "GST-informative",
                        "jurisdiction_type": "COUNTRY",
                        "tax_rate": 11,
                        "tax_amount": 6.0
                    },
                    {
                        "tax_name": "PST-informative",
                        "jurisdiction_type": "PROVINCE",
                        "tax_rate": 7.5,
                        "tax_amount": 8.4
                    }
                ],
                "deducted_tax_rate": 0,
                "tax_entity_name": "British Columbia",
                "tax_supported": true
            }
        ],