Zum Inhalt
HALOWERK

Finopswerk

tiered charge boundary transcript

From original quantity and ordered tariff tiers, compute volume or graduated band allocations, flat fees and total; quantity zero bills the first flat fee. Verify supplied totals and each tier claim. Supplied-data reconstruction only; no actual invoice/account validity assertion. A schema-valid unknown is a successful result at the same fixed price. Invalid input raises native HTTP400 before settlement. Serialized input limit 16384 bytes; whole data response limit 32768 bytes.

POST https://finops.halowerk.com/v1/tiered-charge-boundary-transcript

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
quantitySiehe SchemaJa
modeSiehe SchemaJa
tiersarrayJa
reportobjectJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "properties": {
    "quantity": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 10000
        },
        {
          "type": "null"
        }
      ]
    },
    "mode": {
      "enum": [
        "volume",
        "graduated"
      ]
    },
    "tiers": {
      "type": "array",
      "minItems": 2,
      "maxItems": 8,
      "items": {
        "type": "object",
        "properties": {
          "up_to": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 1,
                "maximum": 10000
              },
              {
                "type": "null"
              }
            ]
          },
          "unit_minor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000
          },
          "flat_minor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000
          }
        },
        "required": [
          "up_to",
          "unit_minor",
          "flat_minor"
        ],
        "additionalProperties": false
      }
    },
    "report": {
      "type": "object",
      "properties": {
        "total_minor": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -1000000000000,
              "maximum": 1000000000000
            },
            {
              "type": "null"
            }
          ]
        },
        "rows": {
          "anyOf": [
            {
              "type": "array",
              "minItems": 2,
              "maxItems": 8,
              "items": {
                "type": "object",
                "properties": {
                  "quantity": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10000
                  },
                  "charge_minor": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10001000000
                  }
                },
                "required": [
                  "quantity",
                  "charge_minor"
                ],
                "additionalProperties": false
              }
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "total_minor",
        "rows"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "quantity",
    "mode",
    "tiers",
    "report"
  ],
  "additionalProperties": false
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "quantity": 5,
  "mode": "volume",
  "tiers": [
    {
      "up_to": 5,
      "unit_minor": 700,
      "flat_minor": 1000
    },
    {
      "up_to": 10,
      "unit_minor": 650,
      "flat_minor": 2000
    },
    {
      "up_to": null,
      "unit_minor": 600,
      "flat_minor": 3000
    }
  ],
  "report": {
    "total_minor": 4500,
    "rows": [
      {
        "quantity": 5,
        "charge_minor": 4500
      },
      {
        "quantity": 0,
        "charge_minor": 0
      },
      {
        "quantity": 0,
        "charge_minor": 0
      }
    ]
  }
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-07, 02:42 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →