NutraSoft food manufacturing ERP software
Esc
  • GuideGetting startedThree steps to your first call and your first order, then the two shapes every response takes.
  • GuideAuthentication and keysBearer keys, test and live environments, rotation without an outage, and what each scope grants.
  • GuideTest modeA second NutraSoft account of your own, seeded with realistic data, that you can safely break.
  • PageErrorsEvery error code the API returns, what it means, what to do about it and whether to retry.
  • PageConventionsThe rules every operation follows: money, time, paging, sorting, nulls, PATCH and identifiers.
Menu

Tax rates

Tax codes and their rates, one of which a customer can be assigned.

sales:readhttps://public-api.nutrasoft.ca/v1
Linked fromCustomerstax_rate_id

The Tax rate object

  • idinteger
  • codestringnullable
  • descriptionstringnullable
  • namestringnullable
  • tax_rate1numbernullable

    Tax 1 percentage, e.g. 5.0 for 5%.

  • tax_rate1_labelstringnullable
  • tax_rate2numbernullable

    Tax 2 percentage, e.g. 9.975 for 9.975%.

  • tax_rate2_labelstringnullable

Operations

List tax rates

get/tax-ratessales:read

The tax rates customers and documents are charged under.

Query parameters

  • searchstringnullable

    Free-text match on code, name or description.

  • namestringnullable

    Partial match on the name.

  • sortstringnullable

    Comma-separated field:direction pairs, e.g. id:desc. Sortable: code, id, name. id is always added last, so paging is stable.

  • limitinteger

    Rows to return. Maximum 200.

    • >= 1
    • <= 200
    • default 50
  • offsetinteger

    Rows to skip. Maximum 10000: to read further, narrow the filters or page with updated_since.

    • >= 0
    • <= 10000
    • default 0
Returns
200 A page of TaxRate objects in data, with pagination.
Errors
400 401 403 429 500 503
GET /tax-rates
curl "https://public-api.nutrasoft.ca/v1/tax-rates?limit=50" \
  -H "Authorization: Bearer $NUTRASOFT_API_KEY"
Response200
{
  "data": [
    {
      "id": 123,
      "code": "SAMPLE-01",
      "description": "string",
      "name": "Sample name",
      "tax_rate1": 12.5,
      "tax_rate1_label": "string",
      "tax_rate2": 12.5,
      "tax_rate2_label": "string"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 1,
    "has_more": false
  },
  "order": "id:asc"
}

Retrieve a tax rate

get/tax-rates/{tax_rate_id}sales:read

Path parameters

  • tax_rate_idintegerrequired

    The tax rate's id.

    • > 0
Returns
200 One TaxRate object in data.
Errors
400 401 403 404 429 500 503
GET /tax-rates/{tax_rate_id}
curl "https://public-api.nutrasoft.ca/v1/tax-rates/123" \
  -H "Authorization: Bearer $NUTRASOFT_API_KEY"
Response200
{
  "data": {
    "id": 123,
    "code": "SAMPLE-01",
    "description": "string",
    "name": "Sample name",
    "tax_rate1": 12.5,
    "tax_rate1_label": "string",
    "tax_rate2": 12.5,
    "tax_rate2_label": "string"
  }
}