​
Cents-based amounts

Numeral uses cents for all USD, CAD, EUR values in the API.

When submitting values for sales and prices, ensure that they are provided in cents, or the smallest possible denominated representation for the currency. This ensures accurate processing and representation across currencies and especially with respect to rounding.

When creating a calculation for a product that costs $10.00 USD, you’d want to report that value as 1000 cents in the amount field.

    "line_items": [
      {
        "reference_line_item_id": "line_123456789",
        "reference_product_id": "p-1233543",
        "amount": 1000,
        "quantity": 1
      }
    ]

In the same way, tax and accounting values returned are also in cents. The below response is for a calculation on a $2.00 item with a 7% tax rate. This leads to 14 cents in tax.

{
  "calculation_id": "calc_17364047950082c1fd8f0-f763-40f8-8c02-e8fc9ded0944",
  "object": "tax.calculation",
  "line_items": [
    {
      "line_item_id": "line_987654321",
      "reference_product_id": "temp-a4a427d4-42fc-47f1-9092-c74f935438a3",
      "reference_product_name": "temp-a4a427d4-42fc-47f1-9092-c74f935438a3",
      "product_tax_code": "GENERAL_MERCHANDISE",
      "tax_included_in_amount": false,
      "tax_jurisdictions": [
        {
          "tax_rate": 0.07,
          "rate_type": "REDUCED_RATE",
          "jurisdiction_name": "State"
        }
      ],
      "tax_amount": 14,
      "amount_excluding_tax": 200,
      "amount_including_tax": 214
    }
  ],
  "total_tax_amount": 14,
  "total_amount_excluding_tax": 200,
  "expires_at": 1714787673,
  "testmode": "false"
}

​
Exchange Rates

Once per day, we will reconcile all transactions that were created in the last 24 hours, and record the exchange rate(s) for that day. This allows us to present a single report in your functional currency on your dashboard, even if you are collecting and filing tax across multiple countries.

Product CategoriesFAQs