onOffice

Consume onOffice API

Actions10

Overview

This node integrates with the onOffice API to update address/contact information. It is useful for workflows that need to modify existing contact details in an onOffice system, such as updating customer records, correcting contact information, or maintaining up-to-date address books.

A practical example would be a real estate agency automating updates to client contact details after receiving new information, ensuring their CRM data stays current without manual entry.

Properties

Name Meaning
Address ID The unique identifier of the address/contact record to update.
Fields A collection of address fields to update. Includes:
- Salutation Options: Mr, Ms, Company — the salutation for the contact.
- First Name The first name of the contact.
- Last Name The last name of the contact.
- Email The email address of the contact.
- Phone The phone number of the contact.
- Street The street name of the contact's address.
- Postal Code The postal code of the contact's address.
- City The city where the contact is located.
- Country The country where the contact is located (default: Deutschland).
- User The user responsible for this contact.

Output

The node outputs JSON data representing the updated address/contact record(s) returned by the onOffice API. The structure typically includes fields like customer number, salutation, name, phone, email, and address details.

If the update is successful, the output contains the updated record data. If there are errors, the output may include an error message describing the issue.

The node does not output binary data.

Dependencies

  • Requires an active onOffice API credential with an API token and secret.
  • The node uses HMAC SHA256 signing for request authentication.
  • HTTP POST requests are made to the onOffice stable API endpoint (https://api.onoffice.de/api/stable/api.php).
  • Proper configuration of the API credentials within n8n is necessary.

Troubleshooting

  • No credentials provided: The node will throw an error if the required API credentials are missing. Ensure the API key and secret are configured correctly.
  • Invalid resource or operation: This error occurs if the selected resource or operation is unsupported. Verify that "Address" resource and "Update" operation are chosen.
  • API Error with status code: If the API returns an error status, the node throws an error with the message from the API. Check the API token validity, permissions, and the correctness of the input parameters.
  • Empty or malformed response: If the API response lacks expected data, verify the address ID exists and the fields to update are valid.
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output JSON.

Links and References

Discussion