Tax Registration Completed
Understanding the Event
The tax-registration.completed event is automatically triggered once the tax registration has been submitted to ELSTER and the case is closed.
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.completed
messagestringProvides a human-readable message indicating the result of the webhook event.
Value: The tax registration has been completed.
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: completed
package_typestringThe package selected for the tax registration.
Possible values: self or guided
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.completed",
"message": "The tax registration has been completed.",
"tax_registration_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "completed",
"package_type": "guided",
"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"
}