Skip to main content
May 20, 2025
Solved

Inconsistent monetary information for Japan via Billing v2 API

  • May 20, 2025
  • 2 replies
  • 0 views

Hi,

we have a presence in different Equinix data centers and retrieve billing information via the Billing v2 API. We observed that the information we obtain for the Japan invoice (and that one only) has inconsistent (dare I say wrong?) tax amount values across time:

  • For invoices from 2024-02 (oldest I have) until 2024-05 (which is not downloadable anymore due to the 12 month limit but I have a local copy) the Japanese line items behave exactly like all others we can observe, namely: non-zero taxAmount (10% of recurringAmount) and recurringAmount + taxAmount = totalAmount.
  • For invoices from 2024-06 until 2024-08 (both in the snapshot I had from a few months ago and the one I just took now) the Japanese line items now still has a non-zero taxAmount (10% of recurringAmount) but totalAmount = recurringAmount. Checking a few entries we saw that the netAmount is the same as in previous entries which makes me assume that the totalAmount does not include any tax amount.
  • For invoices from 2024-09 onward the Japanese line items now all have taxAmount = 0 and totalAmount = recurringAmount. This means that we are unable to obtain any tax information from the invoice other than assuming that the 10% applies to all line items. Furthermore, this data is inconsistent with the reality that there is tax to be paid.

Could you explain why the data is so inconsistent, changing multiple times withing a few months?
Could you also explain why the data for invoices since 2024-06 is inconsistent with the reality?

Is there any resource where changes in the API are documented and where I could have learned about these changes?
What can we expect moving forward? Should we expect the data to change again, hopefully to be correct again as it was pre 2024-06?

Thanks
Jonas

Best answer by Marques

You can find more information and direction about the Billing API changes in the ECP Release Notes at https://docs.equinix.com/en-us/Content/KnowledgeCenter/ECP/ReleaseNotes/2024.htm

Changes to the Japanese tax calculation are mentioned there.

2 replies

Community Manager
May 20, 2025

Thanks @Jonas we've shared your concerns with our team to look into this on the API side and respond regarding any changes.

Regarding the tax amounts, we recommend reaching out to Customer Support to review and discuss the invoices to ensure everything is in order. 

MarquesAnswer
Employee
May 21, 2025

You can find more information and direction about the Billing API changes in the ECP Release Notes at https://docs.equinix.com/en-us/Content/KnowledgeCenter/ECP/ReleaseNotes/2024.htm

Changes to the Japanese tax calculation are mentioned there.

JonasAuthor
May 21, 2025

Thank you for pointing me to that link, it seems that I was unable to find that before. This doesn't really explain the brief change of behavior for June, July, and August but I'm mostly interested in invoices moving forward so that's fine.