VendusInstall

Overview

This node integrates with the Vendus API, a platform for invoicing and business management. Specifically, the "Get Supplier by ID" operation under the "Supplier" resource retrieves detailed information about a supplier using their unique identifier or name.

Common scenarios where this node is beneficial include:

• Fetching supplier details to verify or display in workflows.
• Automating procurement processes by retrieving supplier data dynamically.
• Integrating supplier information into accounting or inventory systems.

For example, you might use this node to get the contact details of a supplier before creating a purchase order or to validate supplier data during an automated audit process.

Properties

Output

The node outputs JSON data representing the supplier's details as returned by the Vendus API. This typically includes all available fields describing the supplier, such as name, fiscal ID, contact information, and other metadata.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "id": "123",
  "name": "Supplier Name",
  "fiscal_id": "XYZ123456",
  "address": "123 Supplier St.",
  "phone": "+1234567890",
  "email": "contact@supplier.com",
  ...
}

Dependencies

• Requires an API key credential for authenticating with the Vendus API.
• The node expects the base URL of the Vendus API to be configured in the credentials.
• No additional external dependencies are required beyond the Vendus API access.

Troubleshooting

• Missing or invalid Supplier ID: If the "Supplier Name or ID" property is empty or incorrect, the node will throw an error indicating that the parameter is required or that the supplier was not found.
• API authentication errors: Ensure the API key credential is correctly set up and has sufficient permissions.
• Network or connectivity issues: Check network access to the Vendus API endpoint.
• Enable Debug Logging: Activating this option helps trace request URLs, parameters, and responses, which aids in diagnosing issues.
• Error messages may include:
  • Parameter 'supplierId' is required but not provided: Supply a valid supplier ID.
  • HTTP errors with response data: Review the API response for details (e.g., 404 if supplier not found).

If the node is set to continue on fail, errors will be output as JSON objects containing error message and details instead of stopping execution.

Links and References

• Vendus API Documentation (as referenced in the node description)
• n8n Expressions Documentation – for using expressions in input properties