Cloodo Finance icon

Cloodo Finance

Get data from Cloodo Worksuite API
Join our community

Actions12

Overview

The node "Cloodo Finance" integrates with the Cloodo Worksuite API to manage financial data related to invoices, payments, and recurring transactions. Specifically, for the Invoice - Update operation, it allows users to update existing invoice records by specifying various invoice details such as project ID, client ID, currency, invoice number, exchange rate, and display options like showing the shipping address.

This node is beneficial in scenarios where automated workflows need to keep invoice data synchronized with external systems or when updating invoice details programmatically based on business logic or user input. For example, a company could use this node to update invoice information after receiving payment confirmation or adjusting billing details.

Properties

Name Meaning
ID The unique identifier of the invoice to update.
Project ID Identifier of the project associated with the invoice (required).
Client ID Identifier of the client linked to the invoice (required).
Currency ID Identifier of the currency used in the invoice (required).
Invoice Number The invoice's reference number, e.g., "INV#12345" (required).
Show Shipping Address Boolean flag indicating whether to display the shipping address on the invoice.
Exchange Rate Numeric value representing the exchange rate applied to the invoice amounts (default 1).

Output

The node outputs JSON data representing the updated invoice object as returned by the Cloodo Worksuite API. This typically includes all invoice fields reflecting the new state after the update operation.

If the node supports binary data output (not explicitly shown in the provided code), it would represent attachments or documents related to the invoice, but no such indication is present here.

Dependencies

  • Requires an active connection to the Cloodo Worksuite API.
  • Needs an API authentication token or key configured in n8n credentials (referred generically as "an API key credential").
  • The base URL for API requests is https://erp-amz.cloodo.com/v4.
  • The node expects JSON content type for requests and responses.

Troubleshooting

  • Common Issues:

    • Missing required properties such as Project ID, Client ID, Currency ID, or Invoice Number will cause the update to fail.
    • Providing an invalid or non-existent invoice ID will result in errors from the API indicating that the resource was not found.
    • Incorrect API credentials or expired tokens will lead to authentication errors.
    • Network connectivity issues can prevent successful communication with the API endpoint.

  • Error Messages:

    • "Invoice not found" — Verify the invoice ID is correct and exists.
    • "Unauthorized" or "Authentication failed" — Check that the API key credential is valid and properly configured.
    • "Validation error" — Ensure all required fields are provided and correctly formatted.

Resolving these usually involves verifying input parameters, checking API credentials, and ensuring network access to the API endpoint.

Links and References

Discussion