Skip to content
HALOWERK

Datenwerk

payment terms parse

Splits the text into clauses and recognises discount tiers (percent plus period or fixed date, in either order, also the US 2/10 net 30 notation), net terms (netto/net/ohne Abzug/zahlbar/payable/due, sofort/immediately = 0 days), the base date (invoice date or receipt of invoice) and the day type (calendar days, Werktage = Monday-Saturday, business days = Monday-Friday, excluding public holidays when a holiday region is given). Periods count from the day after the base date (§§ 187 Abs. 1,.

POST https://daten.halowerk.com/v1/payment-terms-parse

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringYesPayment terms as printed on the invoice or in the contract.
invoice_datestringYesInvoice date (YYYY-MM-DD).
receipt_datestringNoDate the invoice was received, used if the terms count from receipt.
amountstringNoGross invoice amount, e.g. 1190.00.
roll_to_business_daybooleanNoApply § 193 BGB to every deadline.
holidaysobjectNoPublic holidays (date-holidays data, type public).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "text",
    "invoice_date"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 3,
      "maxLength": 1000,
      "description": "Payment terms as printed on the invoice or in the contract."
    },
    "invoice_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Invoice date (YYYY-MM-DD)."
    },
    "receipt_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date the invoice was received, used if the terms count from receipt."
    },
    "amount": {
      "type": "string",
      "pattern": "^\\d{1,12}(\\.\\d{1,2})?$",
      "description": "Gross invoice amount, e.g. 1190.00."
    },
    "roll_to_business_day": {
      "type": "boolean",
      "default": false,
      "description": "Apply § 193 BGB to every deadline."
    },
    "holidays": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "country"
      ],
      "description": "Public holidays (date-holidays data, type public).",
      "properties": {
        "country": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$"
        },
        "state": {
          "type": "string",
          "maxLength": 6,
          "description": "e.g. NW, BY"
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "text": "2 % Skonto bei Zahlung innerhalb 10 Tagen, netto 30 Tage",
  "invoice_date": "2026-11-02",
  "amount": "1190.00"
}

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 →