Zum Inhalt
HALOWERK

Finopswerk

billed basis proration transcript

From the original billed flat price and chronological unbilled price changes, reconstruct flexible credit basis, exact rational unused credit, new-price debit and net; verify supplied claims. Quantity one, seconds, no tax/discount/real invoice validity or Stripe-cent rounding 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/billed-basis-proration-transcript

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
period_startintegerJa
period_endintegerJa
change_atintegerJa
original_billed_price_minorSiehe SchemaJa
unbilled_price_changesarrayJa
new_price_minorintegerJa
reportobjectJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "properties": {
    "period_start": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000000
    },
    "period_end": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000000
    },
    "change_at": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000000
    },
    "original_billed_price_minor": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 1000000
        },
        {
          "type": "null"
        }
      ]
    },
    "unbilled_price_changes": {
      "type": "array",
      "maxItems": 8,
      "items": {
        "type": "object",
        "properties": {
          "at": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          },
          "price_minor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000
          }
        },
        "required": [
          "at",
          "price_minor"
        ],
        "additionalProperties": false
      }
    },
    "new_price_minor": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "report": {
      "type": "object",
      "properties": {
        "basis_minor": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            },
            {
              "type": "null"
            }
          ]
        },
        "current_minor": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000
            },
            {
              "type": "null"
            }
          ]
        },
        "credit": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "n": {
                  "type": "string",
                  "pattern": "^-?(0|[1-9][0-9]{0,23})$",
                  "maxLength": 25
                },
                "d": {
                  "type": "string",
                  "pattern": "^[1-9][0-9]{0,23}$",
                  "maxLength": 24
                }
              },
              "required": [
                "n",
                "d"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "debit": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "n": {
                  "type": "string",
                  "pattern": "^-?(0|[1-9][0-9]{0,23})$",
                  "maxLength": 25
                },
                "d": {
                  "type": "string",
                  "pattern": "^[1-9][0-9]{0,23}$",
                  "maxLength": 24
                }
              },
              "required": [
                "n",
                "d"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "net": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "n": {
                  "type": "string",
                  "pattern": "^-?(0|[1-9][0-9]{0,23})$",
                  "maxLength": 25
                },
                "d": {
                  "type": "string",
                  "pattern": "^[1-9][0-9]{0,23}$",
                  "maxLength": 24
                }
              },
              "required": [
                "n",
                "d"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "basis_minor",
        "current_minor",
        "credit",
        "debit",
        "net"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "period_start",
    "period_end",
    "change_at",
    "original_billed_price_minor",
    "unbilled_price_changes",
    "new_price_minor",
    "report"
  ],
  "additionalProperties": false
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "period_start": 0,
  "period_end": 30,
  "change_at": 20,
  "original_billed_price_minor": 2000,
  "unbilled_price_changes": [
    {
      "at": 5,
      "price_minor": 3000
    }
  ],
  "new_price_minor": 1000,
  "report": {
    "basis_minor": 2000,
    "current_minor": 3000,
    "credit": {
      "n": "-2000",
      "d": "3"
    },
    "debit": {
      "n": "1000",
      "d": "3"
    },
    "net": {
      "n": "-1000",
      "d": "3"
    }
  }
}

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 →