Vendus icon

Vendus

Interact with Vendus API for invoicing and business management. Developed by Pixel Infinito (https://pixel.ao)

Actions39

Client → Create Client

AI-generated

Overview

The "Create Client" operation in this Vendus node allows users to add a new client record into the Vendus invoicing and business management system via its API. This operation is useful for automating client onboarding, integrating CRM data, or syncing customer information from other platforms directly into Vendus.

Typical use cases include:

  • Automatically creating clients when a new lead is qualified in a CRM.
  • Syncing client data from e-commerce platforms or marketing tools.
  • Bulk importing client details from external databases or spreadsheets.

By using this node, businesses can streamline client data entry, reduce manual errors, and keep their invoicing system up-to-date with minimal effort.

Properties

Name Meaning
Client Name The full name of the client to be created. (Required)
Contact Information A collection of contact details including: Email address, Fiscal ID, Mobile number, Phone number, and Website URL.
Address Information A collection of address details including: Street address, City, Country (selectable from Angola, France, Portugal, Spain), and Postal Code.
Business Settings Business-related settings for the client, including: Default payment due period (options: 1, 7, 15, 30, 45, 60, 90 days, or Now), IRS retention status (Yes/No), Price Group (selectable from available price groups), and whether to send invoices by email (Yes/No).
Additional Options Extra client options such as External Reference (string), Notes about the client, and Status (Active/Inactive). Note: Status is only shown for update operations, not create.
Custom JSON A raw JSON object allowing custom client data to be specified beyond predefined fields.
Options Additional operational options, currently supporting enabling detailed debug logging for troubleshooting API calls (boolean).

Output

The node outputs an array of items where each item contains a json field representing the response from the Vendus API after creating the client. This JSON typically includes the newly created client's data as returned by the API, such as client ID, name, contact info, and any other relevant metadata.

No binary data output is produced by this operation.

Example output snippet (simplified):

{
  "json": {
    "id": 123,
    "name": "Client Name",
    "email": "client@example.com",
    "fiscal_id": "123456789",
    "status": "active",
    ...
  }
}

Dependencies

  • Requires an API key credential configured in n8n to authenticate with the Vendus API.
  • The node uses the base URL provided in the credentials to make HTTP requests.
  • The Vendus API must be accessible and the user’s API key must have permissions to create clients.

Troubleshooting

  • Missing Required Parameters: If required parameters like "Client Name" are not provided, the node will throw an error indicating the missing parameter.
  • API Authentication Errors: Invalid or missing API credentials will cause authentication failures. Ensure the API key credential is correctly set up.
  • Network or API Errors: Network issues or API downtime may cause request failures. Enabling debug logging can help diagnose these problems by providing detailed logs.
  • Invalid Field Values: Providing invalid values for fields such as country codes or price group IDs may result in API validation errors.
  • Debug Logging: Enable the "Enable Debug Logging" option to get detailed logs of the request and response cycle, which helps in identifying issues.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion