WibiClick icon

WibiClick

Interact with WibiClick API
Join our community

Actions92

Overview

This node integrates with the WibiClick API to manage line items within a website's system. Specifically, for the "Line Item" resource and the "Add or Update Line Item" operation, it allows users to add new line items or update existing ones associated with invoices or estimates on a specified website.

Common scenarios where this node is beneficial include:

  • Automating the addition of billing or invoice line items in an accounting or invoicing workflow.
  • Updating quantities, descriptions, or amounts of existing line items programmatically.
  • Integrating with other systems that generate or modify line item data, ensuring synchronization with WibiClick's backend.

Practical example:

  • After generating an invoice in another system, use this node to add detailed line items (e.g., product name, quantity, price) to the invoice in WibiClick automatically.
  • When a customer modifies an order, update the corresponding line item details such as quantity or description via this node.

Properties

Name Meaning
Website ID The unique identifier of the website where the line item will be added or updated.
Line Item Data Collection of fields describing the line item to add or update:
- Amount Numeric value representing the amount for the line item.
- Description Textual description of the line item.
- Estimate ID Identifier of the associated estimate (optional).
- ID Identifier of the line item to update; if empty, a new line item will be created.
- Invoice ID Identifier of the associated invoice (optional).
- Name Name/title of the line item.
- Quantity Number representing the quantity of the line item (default is 1).

Output

The node outputs JSON data representing the response from the WibiClick API after adding or updating a line item. This typically includes details of the created or updated line item such as its ID, name, description, amount, quantity, and associations with invoices or estimates.

If the operation is successful, the output JSON contains the line item object with its properties as stored in WibiClick. If there is an error, the node throws an error unless configured to continue on failure, in which case the output JSON will contain success status as false and an error message.

The node does not output binary data.

Dependencies

  • Requires an active connection to the WibiClick API.
  • Needs an API key credential for authentication with WibiClick.
  • The node expects the API URL and API key to be provided via credentials configured in n8n.
  • No additional external dependencies are required beyond the HTTP request capabilities built into n8n.

Troubleshooting

  • Missing or invalid Website ID: Ensure the Website ID is correct and corresponds to an existing website in WibiClick.
  • Invalid Line Item ID for updates: When updating, the Line Item ID must be valid; otherwise, the API may return an error.
  • API Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Network or connectivity issues: Check network access to the WibiClick API endpoint.
  • Validation errors from API: For example, missing required fields like amount or name may cause the API to reject the request.
  • If the node is set to continue on fail, errors will be returned in the output JSON with success: false and an error message.

Links and References

Discussion