Tax Registration Blocked
Understanding the Event
The tax-registration.blocked event is automatically triggered when a tax registration cannot proceed, either because a submission to ELSTER failed or because our internal team blocked the case. The reason field explains what stopped it. One of our case managers then reviews the case and follows up, so no action is required on your side.
Payload Fields
webhook_idstringA unique identifier for this webhook in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000
eventstringThe name of the event that triggered this webhook.
Value: tax-registration.blocked
messagestringProvides a human-readable message indicating the result of the webhook event.
Value: The tax registration has been blocked. Our team will review the case and follow up.
tax_registration_idstringThe unique identifier for the tax registration in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000
statusstringThe status of the tax registration.
Value: blocked
package_typestringThe package selected for the tax registration.
Possible values: self or guided
reasonstringThe reason the tax registration was blocked.
Example: The business address could not be matched to a tax office.
urlstringThe URL of the tax registration.
Example: https://app.beglaubigt.de/register/tax/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000
client_referencestringYour custom reference string provided when the tax registration was created.
Example: REF-2025-001
timestampstringThe exact date and time when the webhook was triggered, formatted as an ISO 8601 string in UTC.
Example: 2025-06-01T08:00:00.443Z
{
"webhook_id": "123e4567-e89b-12d3-a456-426614174000",
"event": "tax-registration.blocked",
"message": "The tax registration has been blocked. Our team will review the case and follow up.",
"tax_registration_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "blocked",
"package_type": "guided",
"reason": "The business address could not be matched to a tax office.",
"url": "https://app.beglaubigt.de/register/tax/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000",
"client_reference": "REF-2025-001",
"timestamp": "2025-10-18T12:00:00Z"
}