Steuerboard icon

Steuerboard

Consume the Steuerboard API

Actions31

Overview

The node integrates with the Steuerboard API to update client information. It allows users to modify various details of an existing client, such as their address, legal name, type, and custom identifiers. This is useful in scenarios where client data needs to be kept current, for example, updating contact details after a move, correcting legal names, or changing client types based on new business structures.

Practical examples:

  • Updating a client's postal address after they relocate.
  • Changing the legal name of a company due to rebranding.
  • Assigning or modifying a custom ID used internally by accountants.

Properties

Name Meaning
Client ID The unique identifier of the client to update (required).
Update Fields A collection of fields that can be updated for the client:
  Address The client's address including line 1, line 2, city, postal code, and country code (ISO 3166-1 alpha-2).
  Custom ID A custom identifier defined by the accountant for the client.
  Legal Name The official legal name of the client.
  Name The updated display name of the client.
  Type The type of client, selectable from: Natural Person, Individual Enterprise, Legal Person.

Output

The node outputs JSON data representing the updated client object as returned by the Steuerboard API. This typically includes all client properties after the update has been applied.

If binary data were involved (not indicated here), it would represent files or attachments related to the client, but this node focuses solely on JSON client data.

Dependencies

  • Requires an active connection to the Steuerboard API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for the API must be set in the credential configuration.

Troubleshooting

  • Missing or invalid Client ID: The update operation requires a valid client ID. Ensure the ID exists and is correctly provided.
  • Invalid field values: For example, providing an incorrect country code or unsupported client type may cause API errors. Validate inputs against allowed formats and options.
  • Authentication errors: If the API key or token is missing or expired, the node will fail to authenticate. Verify credential setup.
  • Network issues: Connectivity problems to the Steuerboard API endpoint will prevent updates. Check network access and base URL correctness.

Common error messages might include:

  • "Client not found" — indicates the provided client ID does not exist.
  • "Unauthorized" or "Authentication failed" — check API credentials.
  • "Validation error" — input fields contain invalid data.

Resolving these usually involves verifying input parameters, ensuring correct credentials, and confirming API availability.

Links and References

Discussion