Actions20
- Claim (Case Management API) Actions
- Debtor (Case Management API) Actions
- Info (Case Management API) Actions
- Company (Partner API) Actions
- User (Partner API) Actions
- User Invite (Partner API) Actions
Overview
This node integrates with the Paywise Partner API to update company information. It allows users to modify details of an existing company record by specifying the company ID and providing updated data either through structured form fields or a raw JSON object.
Common scenarios include:
- Updating contact information such as phone number or address.
- Changing legal or tax-related attributes like VAT number, legal form, or tax deduction eligibility.
- Modifying payout account details (IBAN).
- Adjusting notification preferences for status updates or client requests.
Practical example:
A user wants to update a company's phone number and add a new notification email channel. They can select the "Form Fields" input method, specify the company ID, fill in the new phone number, and configure the notification channels accordingly. Alternatively, they can provide the entire updated company object as JSON.
Properties
| Name | Meaning |
|---|---|
| Input Method | Method to use for updating the company: - Form Fields: Configure company using individual form fields. - JSON: Provide the entire company data as a JSON object. |
| Company ID | The unique identifier of the company to update. |
| Company JSON | (Shown if Input Method is JSON) The full company data as a JSON object. Example structure includes name, phone, address, VAT number, default claim type, legal form, tax deduction eligibility, notification channels, IBAN, etc. |
| Update Fields | (Shown if Input Method is Form Fields) Collection of individual fields to update: - Name: Name of the company. - Phone: Phone number (max 50 characters). - VAT Number: German VAT ID. - Legal Form: Legal form of the company. - Tax Deduction Eligibility: Company's input tax deduction eligibility with options: - Eligible (J) - Not Eligible (N) - Reverse-Charge-Verfahren (K) - Nicht steuerbare Umsätze - Drittlandunternehmer (A) - Default Claim Type: Default claim type with multiple predefined options (e.g., Dienstleistungsvertrag, Warenlieferung/-en, Miete, etc.). - IBAN: Payout account IBAN. - Address: Nested collection including street, ZIP code, city, country (ISO 3166-1 alpha-2). - Legal Representatives: Multiple entries each with type and name. - Notification Channels: Multiple entries each with: - Channel Type (currently only EMAIL supported) - Value (email address) - Notification Types (Status Updates, Requests to Client, Statements) |
Output
The node outputs an array of JSON objects representing the updated company data returned from the Paywise API after the update operation. Each item corresponds to one input item processed.
If binary data were involved, it would be summarized here; however, this node deals exclusively with JSON data.
Dependencies
- Requires an API key credential for authenticating with the Paywise API.
- The node depends on the Paywise Partner API being accessible and properly configured.
- No additional external dependencies are indicated.
Troubleshooting
- Error: Resource or Operation not implemented — This occurs if an unsupported resource or operation is selected. Ensure that "Company" resource and "Update" operation are chosen.
- Invalid Company ID — If the provided company ID does not exist or is malformed, the API will return an error. Verify the company ID before running the node.
- Malformed JSON — When using the JSON input method, ensure the JSON is valid and matches the expected schema.
- Validation errors on fields — For example, VAT number must follow the German schema; phone numbers have length limits; country codes must be ISO 3166-1 alpha-2.
- API authentication errors — Check that the API key credential is correctly set up and has sufficient permissions.
- Unsupported notification channel types — Currently, only EMAIL is supported. Using other types may cause errors.