This article explains some of the Copaco Cloud Platform logic which the data is extracted from. This information can be useful to correctly interpret the API data.
Calculating the line item
The formula to calculate the line item:
((<Quantity> *<UnitPrice>) - <Discount>)*<Duration> = <ExtendedPrice>
Calculating the invoice totals
Total excluding VAT
The formula to calculate the total excluding VAT:
Total of <ExtendedPrice> = <TotalExcludingVAT>
The formula to calculate the total VAT:
<TotalVAT> is the sum of all line items where <VAT> amount is calculated, for all Services for which VAT is applicable.
Total including VAT
<TotalIncludingVAT> = <TotalExcludingVAT> + <TotalVAT>
VAT is applicable to all Services excluding Telecommunication Services such as Internet Connectivity and SIP Trunk. These services are subject to VAT Reverse-charged (Btw verlegd) when sold via the Partner to a Customer. If the Partner consumes these services within the own organization VAT is applicable.
Please note that: Copaco is responsible for selecting the tax zone and for generating a correct invoice for Telecommunication Services to the Partner and Customers regarding these services. The Partner is responsible to register a Customer under the Partner account when he wants to use these services for his own benefit.
When the invoice crosses a border
VAT Reverse Charge (Btw verlegd) is applicable to all services when the invoice crosses a border. For instance, when your office is registered in Belgium and you sell services to Customers in Luxembourg.
Please note that: The Partner is responsible for selecting the correct country of the Customer and for selecting the tax zone which influences the calculation of VAT on the invoice for all Services where VAT is applicable.
Delegations/representatives of a state or embassy
Delegations/representatives of a state such as a king or prince, or an embassy, are also exempt from VAT (this has not been shifted but is actually 0%). These only concern countries that are members of NATO.
Please note that: The Partner is responsible for selecting the correct country of the Customer and for selecting the tax zone which influences the calculation of VAT on the invoice.
Resource Rate vs Resource Rate Period pricing
All products in our platform have prices set for a resource (a resource represents a billable item in your subscription like a license or a GB of storage). A generic resource price that is the same for all subscription periods is called a Resource Rate (PlanRate).
Some product resources have different prices depending on the subscription period you choose. In such a case Resource Rate Period (RatePeriod) prices are added to a resource. In case both Resource Rate and Resource Rate Period prices are configured, Resource Rate Period Prices take precedence, as they are more specific than Resource Rate Prices.
Our Billing API is capable of providing you with the unique ID’s of either the Resource Rate or Resource Rate Period (depending on which one is applied to the line item of the invoice) so you can look up your own pricing in your ERP system.