PortaBilling can assess charges using one of two methods:

  • Tax-exclusive. The prices defined in the system do not include tax, so the charges are also tax-exclusive. The tax is calculated later, separately from the charges.
  • Tax-inclusive. The prices defined in the system already include tax, so the charges are also tax-inclusive. The tax amount can be extracted from the charges and shown separately on the invoice.

PortaBilling adds taxes:

  • For the tax-exclusive method: when a regular invoice is generated (at the end of the billing period) and when an invoice is generated outside the regular billing period. Separate tax xDRs are created.
  • For prepaid customers, the tax-exclusive method also allows you to apply taxes at the time of payment or top-up. To do this, set the Apply taxes option to At time of payment in the customer class. Separate tax xDRs are created.
  • For the tax-inclusive method: when a charge for services is assessed. Separate tax xDRs are not created.

To calculate taxes, PortaBilling uses taxation plug-ins. Each taxation plug-in applies a specific set of tax rules, for example, a fixed VAT percentage or GST tax. You configure each plug-in on a dedicated page in the PortaBilling web interface.

Some plug-ins, such as VAT and Custom taxation, calculate taxes directly in PortaBilling. Others, such as SureTax and Compliance Solutions (CSI), use an external taxation service. In these cases, PortaBilling sends charge data, such as amounts, tax codes, and ZIP codes, to the external taxation service. The service calculates the taxes and returns the results to PortaBilling. PortaBilling saves them as tax xDRs. External services are used mainly for US and Canadian taxes and regulatory fees.

Most plug-ins use tax codes to identify the type of each charge and apply the relevant taxes. Because these codes differ from one plug-in to another, PortaBilling uses its own tax transaction codes. You assign a tax transaction code to an item, such as a service, subscription, or DID number, and then you map it to the matching code of the plug-in you use. If you switch to another plug-in, you only need to map the tax transaction codes to the codes used by the new plug-in.

Taxation management by resellers

Link copied to clipboard

Since your resellers are separate business entities, they may have different taxation parameters. To calculate taxes for their own customers, each reseller manages its taxation parameters separately.

Each reseller can choose a taxation plug-in (e.g., SureTax) on the Taxation page.

As a result, taxes for a reseller’s customers are calculated using the reseller’s taxation parameters rather than the service provider’s.

You can allow your resellers to use an external taxation provider (for example, SureTax or CSI) under your account. To do this, set the AllowTaxPluginCredentialsInheritance option to Yes in the Configuration server web interface. In this case, taxes for a reseller’s customers are calculated under your account with the taxation provider. Typically, this configuration is not suitable because the taxation provider may report your taxes together with the taxes of your resellers.

Docs for
What's new
Admin manuals
Handbooks
UI help
Developers documentation
Back to main menu
  • Loading…