Skip to content
HALOWERK

Textwerk

objection draft

Computes the date of notification from posting or electronic dispatch with the four-day fiction (§ 122 Abs. 2, 2a AO; § 41 Abs. 2 VwVfG; § 37 Abs. 2 SGB X; one month for tax notices posted abroad) or from an actual receipt date, then the one-month objection period (§ 355 AO, § 70 VwGO, § 84 SGG; three months for SGG notices abroad) or one year without correct instructions on remedies (§ 356 Abs. 2 AO, § 58 Abs. 2 VwGO, § 66 Abs. 2 SGG), with § 188 Abs. 3 BGB for short months and the move to.

POST https://text.halowerk.com/v1/objection-draft

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
procedurestringYestax_ao: Einspruch against a tax notice; administrative_vwgo: Widerspruch against an administrative act; social_sgg: Widerspruch in social security matters.
noticeobjectYes
deliveryobjectYes
remedy_instructionsbooleanNoThe notice contained correct instructions on remedies (Rechtsbehelfsbelehrung).
senderobjectYes
groundsarrayNoYour grounds; without grounds the letter announces that they will follow.
request_suspensionbooleanNoAdd an application to suspend enforcement (§ 361 AO, § 80 Abs. 4 VwGO, § 86a Abs. 3 SGG).
letter_datestringNo
placestringNo
statestringNoGerman federal state whose public holidays apply to the deadline (e.g. NW, BY). Without it only nationwide holidays are used.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "procedure",
    "notice",
    "delivery",
    "sender"
  ],
  "properties": {
    "procedure": {
      "type": "string",
      "enum": [
        "tax_ao",
        "administrative_vwgo",
        "social_sgg"
      ],
      "description": "tax_ao: Einspruch against a tax notice; administrative_vwgo: Widerspruch against an administrative act; social_sgg: Widerspruch in social security matters."
    },
    "notice": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "authority",
        "date",
        "subject"
      ],
      "properties": {
        "authority": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "name",
            "street",
            "postcode",
            "city"
          ],
          "properties": {
            "name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 120,
              "description": "Name or company."
            },
            "addition": {
              "type": "string",
              "maxLength": 120,
              "description": "Optional second address line (department, c/o)."
            },
            "street": {
              "type": "string",
              "minLength": 1,
              "maxLength": 120,
              "description": "Street and house number."
            },
            "postcode": {
              "type": "string",
              "pattern": "^[0-9A-Z -]{3,10}$",
              "description": "Postcode."
            },
            "city": {
              "type": "string",
              "minLength": 1,
              "maxLength": 80,
              "description": "City."
            },
            "country": {
              "type": "string",
              "maxLength": 60,
              "description": "Country, only for addresses abroad."
            }
          }
        },
        "date": {
          "type": "string",
          "format": "date",
          "description": "Date printed on the notice."
        },
        "subject": {
          "type": "string",
          "minLength": 3,
          "maxLength": 200,
          "description": "What the notice is about, e.g. \"Einkommensteuerbescheid 2025\"."
        },
        "reference": {
          "type": "string",
          "maxLength": 80,
          "description": "File number, tax number or customer number."
        }
      }
    },
    "delivery": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "method"
      ],
      "properties": {
        "method": {
          "type": "string",
          "enum": [
            "post",
            "electronic",
            "received"
          ],
          "description": "post: posted by mail; electronic: sent electronically; received: actual receipt date known (e.g. personal delivery)."
        },
        "posted_date": {
          "type": "string",
          "format": "date",
          "description": "post/electronic: day of posting or dispatch (usually the date on the notice)."
        },
        "received_date": {
          "type": "string",
          "format": "date",
          "description": "received: day of actual receipt."
        },
        "abroad": {
          "type": "boolean",
          "default": false,
          "description": "Notice delivered abroad."
        }
      }
    },
    "remedy_instructions": {
      "type": "boolean",
      "default": true,
      "description": "The notice contained correct instructions on remedies (Rechtsbehelfsbelehrung)."
    },
    "sender": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "name",
        "street",
        "postcode",
        "city"
      ],
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120,
          "description": "Name or company."
        },
        "addition": {
          "type": "string",
          "maxLength": 120,
          "description": "Optional second address line (department, c/o)."
        },
        "street": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120,
          "description": "Street and house number."
        },
        "postcode": {
          "type": "string",
          "pattern": "^[0-9A-Z -]{3,10}$",
          "description": "Postcode."
        },
        "city": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "description": "City."
        },
        "country": {
          "type": "string",
          "maxLength": 60,
          "description": "Country, only for addresses abroad."
        }
      }
    },
    "grounds": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500
      },
      "description": "Your grounds; without grounds the letter announces that they will follow."
    },
    "request_suspension": {
      "type": "boolean",
      "default": false,
      "description": "Add an application to suspend enforcement (§ 361 AO, § 80 Abs. 4 VwGO, § 86a Abs. 3 SGG)."
    },
    "letter_date": {
      "type": "string",
      "format": "date"
    },
    "place": {
      "type": "string",
      "maxLength": 60
    },
    "state": {
      "type": "string",
      "enum": [
        "BB",
        "BE",
        "BW",
        "BY",
        "HB",
        "HE",
        "HH",
        "MV",
        "NI",
        "NW",
        "RP",
        "SH",
        "SL",
        "SN",
        "ST",
        "TH"
      ],
      "description": "German federal state whose public holidays apply to the deadline (e.g. NW, BY). Without it only nationwide holidays are used."
    }
  }
}

Open original schema

Published input example

{
  "procedure": "tax_ao",
  "notice": {
    "authority": {
      "name": "Finanzamt Ahaus",
      "street": "Vredener Dyk 2",
      "postcode": "48683",
      "city": "Ahaus"
    },
    "date": "2026-10-23",
    "subject": "Einkommensteuerbescheid 2025",
    "reference": "301/5000/1234"
  },
  "delivery": {
    "method": "post",
    "posted_date": "2026-10-23"
  },
  "sender": {
    "name": "Mietpartei Nord",
    "street": "Hallenweg 1",
    "postcode": "48599",
    "city": "Gronau"
  },
  "state": "NW"
}

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 →