Commercial Price Rounding

Overview

You send an amount, its currency, and the rules your pricing policy uses, and we apply them in the order you gave, returning the final price plus every step that got there. Four different ideas stay separate on purpose: rounding to the currency's own decimals, rounding to a ladder step such as 0.50, rounding to the coin you name as the smallest one your till can give, and forcing a charm ending such as 99. We never reorder or optimise your chain — a ladder then a charm ending and a charm ending then a ladder are both legitimate policies and give different answers, so the order is yours. The number of decimals a currency has comes from the platform's single currency source, never from a table in this skill — and neither does the coin: we keep no denomination table, so CASH_ROUNDING always needs the increment from you. Any property other than amount, currency and rules is refused rather than ignored, at the top level of the request as much as inside a rule. This is not display formatting and not minor-unit conversion.

Pricing rules are simple one at a time and treacherous together: rounding to cents, snapping to a ladder, landing on a coin and forcing a 99 ending are four different decisions that teams routinely collapse into one helper, and the helper then disagrees with the till. Keeping them apart, applying them in the order you chose, and reporting each step makes the answer reviewable instead of surprising.

When to use it

Scope

Non-goals

• Does not format a price for display — finance.format_currency does that
• Does not convert between major and minor units, which is finance.convert_minor_units
• Does not convert between currencies and does not fetch a rate
• Does not compute tax; apply tax with finance.calculate_vat on the result
• Does not choose a pricing strategy, reorder your chain, or optimise it
• Does not keep a currency table of its own

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"commerce.price_rounding","input":{"amount":"19.427","currency":"CHF","rules":[{"type":"MINOR_UNITS"},{"type":"CASH_ROUNDING","increment":"0.05"}]}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("commerce.price_rounding", {"currency":"CHF","rules":[{"type":"MINOR_UNITS"},{"type":"CASH_ROUNDING","increment":"0.05"}],"amount":"19.427"});

Errors

Other limits

Limitations

• Does not format a price for display — finance.format_currency does that
• Does not convert between major and minor units, which is finance.convert_minor_units
• Does not convert between currencies and does not fetch a rate
• Does not compute tax; apply tax with finance.calculate_vat on the result
• Does not choose a pricing strategy, reorder your chain, or optimise it
• Does not keep a currency table of its own
• Formatting a price with a symbol and thousands separators
• Converting between euros and cents
• Adding VAT, which is a separate skill and a separate decision

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "commerce.price_rounding",
  "input": {
    "currency": "CHF",
    "rules": [
      {
        "type": "MINOR_UNITS"
      },
      {
        "type": "CASH_ROUNDING",
        "increment": "0.05"
      }
    ],
    "amount": "19.427"
  }
}

Examples

{
  "currency": "CHF",
  "rules": [
    {
      "type": "MINOR_UNITS"
    },
    {
      "type": "CASH_ROUNDING",
      "increment": "0.05"
    }
  ],
  "amount": "19.427"
}

{
  "steps": [
    {
      "type": "MINOR_UNITS",
      "before": "19.427",
      "after": "19.43"
    },
    {
      "type": "CASH_ROUNDING",
      "before": "19.43",
      "after": "19.45"
    }
  ],
  "exponent": 2,
  "price": "19.45",
  "currency": "CHF",
  "changed": true,
  "original": "19.427"
}

{
  "currency": "EUR",
  "rules": [
    {
      "type": "INCREMENT",
      "increment": "0.50"
    },
    {
      "endingDirection": "NEAREST",
      "type": "ENDING",
      "ending": "99"
    }
  ],
  "amount": "17.34"
}

{
  "steps": [
    {
      "type": "INCREMENT",
      "before": "17.34",
      "after": "17.50"
    },
    {
      "type": "ENDING",
      "before": "17.50",
      "after": "17.99"
    }
  ],
  "exponent": 2,
  "price": "17.99",
  "currency": "EUR",
  "changed": true,
  "original": "17.34"
}

{
  "currency": "JPY",
  "rules": [
    {
      "type": "MINOR_UNITS"
    }
  ],
  "amount": "1234.56"
}

{
  "steps": [
    {
      "type": "MINOR_UNITS",
      "before": "1234.56",
      "after": "1235"
    }
  ],
  "exponent": 0,
  "price": "1235",
  "currency": "JPY",
  "changed": true,
  "original": "1234.56"
}

Recommended use cases

• Land a calculated price on the 5-centime coin a Swiss till can actually give
• Snap a cost-plus price onto a 0.50 ladder, then force a 99 ending
• Round to a currency's real decimals without hard-coding that 0 means JPY

Avoid for

• Formatting a price with a symbol and thousands separators
• Converting between euros and cents
• Adding VAT, which is a separate skill and a separate decision

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags