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, including payments. Specifically, the Payment - Create operation allows users to create a new payment record in the system. This is useful for automating financial workflows such as recording customer payments, updating accounting records, or syncing payment data from other systems.

Practical examples:

  • Automatically creating payment entries when an invoice is paid.
  • Syncing payment information from an external CRM or e-commerce platform into Cloodo Worksuite.
  • Recording currency exchange details and payment statuses for multi-currency transactions.

Properties

Name Meaning
Format Date The date format used for date fields. Only option: Y-M-D (e.g. 2022-11-11)
Project ID Identifier of the project associated with the payment
Invoice ID Identifier of the invoice related to this payment
Currency ID Identifier of the currency used in the payment
Exchange Rate The exchange rate applied to the payment amount; must be between 0 and 100, precision 2 decimals
Paid On The date and time when the payment was made
Amount The payment amount; required, minimum 100, maximum 1000
Status The status of the payment; options are Compele (likely meant to be "Complete") or Pending
Category ID Identifier for categorizing the payment

Output

The node outputs JSON data representing the created payment record as returned by the Cloodo Worksuite API. This typically includes all relevant payment details such as IDs, amounts, dates, status, and any metadata provided by the API.

If binary data were involved (not indicated here), it would represent attachments or documents related to the payment, but this node focuses on JSON structured payment data only.

Dependencies

  • Requires an API key credential for authenticating with the Cloodo Worksuite API.
  • The base URL for API requests is https://erp-amz.cloodo.com/v4.
  • The node expects JSON content type and accepts JSON responses.

Troubleshooting

  • Invalid or missing API credentials: Ensure that a valid API authentication token is configured in n8n credentials.
  • Validation errors on input fields: For example, the Amount must be between 100 and 1000; Exchange Rate must be between 0 and 100 with up to two decimal places.
  • Incorrect status value: The status field only accepts compele or pending. Note that compele appears to be a typo and might cause issues if the API expects complete.
  • Date formatting issues: The node supports only one date format (Y-M-D). Providing dates in other formats may cause errors.
  • API connectivity problems: Check network access and API endpoint availability.

Links and References

Discussion