Skip to content
HALOWERK

Rechenwerk

b2b late fee

Evaluates each claim: the fee arises when a debtor who is not a consumer is in default with a payment claim (also instalments, § 288(5) sentences 1-2), for obligations arising after 28 July 2014 (Art. 229 § 34 EGBGB), not for claims from employment (BAG 8 AZR 26/18, § 12a ArbGG). Default is assumed from the day after the due date unless default_from is given; payments on or after that day still trigger the fee. The fee is credited against damages for legal pursuit costs (§ 288(5) sentence.

POST https://rechen.halowerk.com/v1/b2b-late-fee

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
claimsarrayYes
debtor_is_consumerbooleanYestrue if the debtor is a consumer (§ 13 BGB).
as_ofstringYesReference date for open claims.
employment_relationshipbooleanNoClaims arise from an employment relationship (e.g. wages).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "claims",
    "debtor_is_consumer",
    "as_of"
  ],
  "properties": {
    "claims": {
      "type": "array",
      "minItems": 1,
      "maxItems": 500,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "amount",
          "due_date"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Invoice or claim reference."
          },
          "amount": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 1000000000000,
            "description": "Claim amount in EUR."
          },
          "due_date": {
            "type": "string",
            "format": "date",
            "description": "Calendar due date."
          },
          "default_from": {
            "type": "string",
            "format": "date",
            "description": "First day of default if it differs from the day after due_date (e.g. after a reminder)."
          },
          "paid_date": {
            "type": "string",
            "format": "date",
            "description": "Date the payment was credited, if paid."
          },
          "obligation_date": {
            "type": "string",
            "format": "date",
            "description": "Date the obligation arose (contract), for the 29 July 2014 transition."
          },
          "kind": {
            "type": "string",
            "enum": [
              "payment_for_goods_or_services",
              "instalment",
              "other"
            ],
            "default": "payment_for_goods_or_services",
            "description": "Only claims for remuneration (and instalments of them) qualify."
          },
          "legal_costs": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000000,
            "description": "Legal pursuit costs claimed as damages for this claim (e.g. collection or lawyer fees)."
          }
        }
      }
    },
    "debtor_is_consumer": {
      "type": "boolean",
      "description": "true if the debtor is a consumer (§ 13 BGB)."
    },
    "as_of": {
      "type": "string",
      "format": "date",
      "description": "Reference date for open claims."
    },
    "employment_relationship": {
      "type": "boolean",
      "default": false,
      "description": "Claims arise from an employment relationship (e.g. wages)."
    }
  }
}

Open original schema

Published input example

{
  "claims": [
    {
      "id": "RE-2026-101",
      "amount": 1200,
      "due_date": "2026-09-30"
    }
  ],
  "debtor_is_consumer": false,
  "as_of": "2026-10-31"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →