paywise icon

paywise

Consume paywise API
Join our community

Actions20

Overview

This node integrates with the Partner API of a service called Paywise to create new company records. It allows users to add detailed company information either by filling out form fields or by providing a JSON object directly. This is useful in scenarios where you need to automate the onboarding or registration of companies into the Paywise system, such as in financial services, case management, or partner management workflows.

Practical examples include:

  • Automatically creating company profiles when new partners sign up on your platform.
  • Syncing company data from external CRMs or databases into Paywise.
  • Bulk importing company details using JSON data for batch processing.

Properties

Name Meaning
Input Method Method to use for company creation: "Form Fields" (configure company using individual form fields) or "JSON" (provide full company data as a JSON object).
Company JSON The complete company data as a JSON object. Must include at minimum: name, phone, address, legal_form, and tax_deduction_eligibility. Example provided in the property hint.
Name Name of the company (required when using form fields).
Phone Phone number of the company, max 50 characters (required when using form fields).
Legal Form Legal form of the company, e.g., GmbH, AG (required when using form fields).
Tax Deduction Eligibility Tax deduction eligibility status of the company. Options are: Eligible (J), Not Eligible (N), Reverse Charge (K), Third Country Business (A) (required when using form fields).
Address Details Address of the company including street and number, ZIP code, city, and country (Germany, Austria, Switzerland). All fields required when using form fields.
Additional Fields Optional additional company details: VAT Number (mandatory if tax deduction eligibility is "K"), Default Claim Type (various predefined options), IBAN (company payout account), Data Submission Completed (boolean).
Legal Representatives List of legal representatives with their type/role (e.g., Geschäftsführer, Gesellschafter) and full name. Multiple entries allowed.
Notification Channels Notification channels for the company, specifying channel type (Email or SMS), contact value (email address or phone number), and types of notifications to receive (Claim Created, Claim Paid, Claim Status Changed). Multiple entries allowed.

Output

The node outputs an array of JSON objects representing the created company data as returned by the Paywise Partner API. Each item corresponds to one input item processed.

If the node supports binary data output, it is not indicated here; thus, only JSON output is expected.

Dependencies

  • Requires an API key credential for authenticating with the Paywise Partner API.
  • The node depends on the Paywise API being accessible and properly configured.
  • No other external dependencies are indicated.

Troubleshooting

  • Missing Required Fields: If required fields like name, phone, legal form, or address components are missing, the API will likely return validation errors. Ensure all mandatory fields are filled.
  • Invalid JSON Format: When using the JSON input method, malformed JSON or missing required properties will cause errors. Validate JSON before submission.
  • VAT Number Requirement: If tax deduction eligibility is set to "Reverse Charge (K)", VAT number must be provided; otherwise, the API may reject the request.
  • API Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Country Codes: Only Germany (DE), Austria (AT), and Switzerland (CH) are supported for the address country field. Using unsupported codes may cause errors.
  • Notification Channel Validation: Email addresses and phone numbers should be valid formats to avoid notification setup failures.

Links and References

  • Paywise API Documentation - Official documentation for the Paywise API.
  • JSON example for company creation (from property hint):
{
  "name": "Example GmbH",
  "phone": "+49 123 456789",
  "legal_form": "GmbH",
  "tax_deduction_eligibility": "J",
  "address": {
    "street": "Example Street 123",
    "zip": "12345",
    "city": "Berlin",
    "country": "DE"
  }
}

Discussion