Skip to content
HALOWERK

Formatwerk

bwa simple

Aggregates bookings by category (given per booking or derived from your own account ranges in account_map) into the items of the total cost method of § 275 Abs. 2 HGB: revenue, inventory change, own work capitalised, other operating income, material and purchased services, wages and social costs, depreciation, other operating expenses (optionally by cost type), financial items, income taxes and other taxes. Computes total output, gross profit (output minus material), Rohergebnis as allowed.

POST https://format.halowerk.com/v1/bwa-simple

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
bookingsarrayYesBookings; positive amounts increase the item, negative amounts reduce it.
account_maparrayNoYour own account ranges mapped to items.
period_fromstringNoStart of the period (optional).
period_tostringNoEnd of the period (optional).
comparison_bookingsarrayNoBookings of a comparison period (same structure; the period filter does not apply to them).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "bookings"
  ],
  "properties": {
    "bookings": {
      "type": "array",
      "minItems": 1,
      "maxItems": 100000,
      "description": "Bookings; positive amounts increase the item, negative amounts reduce it.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "date",
          "amount"
        ],
        "properties": {
          "date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Booking date."
          },
          "amount": {
            "type": [
              "number",
              "string"
            ],
            "description": "Amount."
          },
          "category": {
            "type": "string",
            "enum": [
              "revenue",
              "inventory_change",
              "own_work_capitalised",
              "other_operating_income",
              "material_expense",
              "purchased_services",
              "wages_and_salaries",
              "social_security_and_pensions",
              "depreciation_fixed_assets",
              "writedowns_current_assets",
              "other_operating_expenses",
              "income_from_investments",
              "income_from_securities_and_loans",
              "other_interest_income",
              "writedowns_financial_assets",
              "interest_expense",
              "income_taxes",
              "other_taxes"
            ],
            "description": "Item of § 275 Abs. 2 HGB."
          },
          "account": {
            "type": [
              "string",
              "integer"
            ],
            "description": "Account number (mapped via account_map when category is missing)."
          },
          "cost_type": {
            "type": "string",
            "maxLength": 40,
            "description": "Sub-group for other operating expenses, e.g. rent."
          }
        }
      }
    },
    "account_map": {
      "type": "array",
      "maxItems": 500,
      "description": "Your own account ranges mapped to items.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "from",
          "to",
          "category"
        ],
        "properties": {
          "from": {
            "type": "string",
            "pattern": "^\\d{1,12}$",
            "description": "First account of the range."
          },
          "to": {
            "type": "string",
            "pattern": "^\\d{1,12}$",
            "description": "Last account of the range."
          },
          "category": {
            "type": "string",
            "enum": [
              "revenue",
              "inventory_change",
              "own_work_capitalised",
              "other_operating_income",
              "material_expense",
              "purchased_services",
              "wages_and_salaries",
              "social_security_and_pensions",
              "depreciation_fixed_assets",
              "writedowns_current_assets",
              "other_operating_expenses",
              "income_from_investments",
              "income_from_securities_and_loans",
              "other_interest_income",
              "writedowns_financial_assets",
              "interest_expense",
              "income_taxes",
              "other_taxes"
            ],
            "description": "Item."
          },
          "cost_type": {
            "type": "string",
            "maxLength": 40,
            "description": "Cost type for other operating expenses."
          }
        }
      }
    },
    "period_from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start of the period (optional)."
    },
    "period_to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End of the period (optional)."
    },
    "comparison_bookings": {
      "type": "array",
      "maxItems": 100000,
      "description": "Bookings of a comparison period (same structure; the period filter does not apply to them).",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "date",
          "amount"
        ],
        "properties": {
          "date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Booking date."
          },
          "amount": {
            "type": [
              "number",
              "string"
            ],
            "description": "Amount."
          },
          "category": {
            "type": "string",
            "enum": [
              "revenue",
              "inventory_change",
              "own_work_capitalised",
              "other_operating_income",
              "material_expense",
              "purchased_services",
              "wages_and_salaries",
              "social_security_and_pensions",
              "depreciation_fixed_assets",
              "writedowns_current_assets",
              "other_operating_expenses",
              "income_from_investments",
              "income_from_securities_and_loans",
              "other_interest_income",
              "writedowns_financial_assets",
              "interest_expense",
              "income_taxes",
              "other_taxes"
            ],
            "description": "Item of § 275 Abs. 2 HGB."
          },
          "account": {
            "type": [
              "string",
              "integer"
            ],
            "description": "Account number (mapped via account_map when category is missing)."
          },
          "cost_type": {
            "type": "string",
            "maxLength": 40,
            "description": "Sub-group for other operating expenses, e.g. rent."
          }
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "bookings": [
    {
      "date": "2026-10-05",
      "amount": "10000.00",
      "category": "revenue"
    },
    {
      "date": "2026-10-20",
      "amount": "4000.00",
      "category": "material_expense"
    }
  ]
}

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 →