Lectful Central icon

Lectful Central

Interact with the Lectful Central API for admin operations

Actions63

Overview

The "Lectful Central" node integrates with the Lectful Central API to perform various administrative operations. Specifically, the Payment Management - List Payments operation allows users to retrieve a paginated list of payments filtered by multiple criteria such as status, date range, invoice ID, payment method, tenant ID, and amount range.

This node is beneficial in scenarios where you need to automate financial workflows, generate reports on payments, or synchronize payment data with other systems. For example, an accounting automation workflow could use this node to fetch all completed payments within a specific month for reconciliation purposes.

Properties

Name Meaning
Authentication Mode Choose how to authenticate with the Lectful Central API:
- Use Stored Credentials (configured in n8n)
- Manual Configuration (provide Base URL and API key manually)
Base URL Override Optional base URL to override the credential setting (without /api/v1). Used only if Authentication Mode is Manual Configuration.
API Key Override Optional API key to override the credential setting. Used only if Authentication Mode is Manual Configuration.
Status Filter payments by their status (e.g., pending, completed, failed).
Date From Filter payments from this date (inclusive), format YYYY-MM-DD.
Date To Filter payments until this date (inclusive), format YYYY-MM-DD.
Search Search term to filter payments by matching text fields.
Invoice ID (for Payments) Filter payments by a specific invoice ID.
Payment Method ID Filter payments by a specific payment method ID.
Tenant ID (for Payments) Filter payments by a specific tenant ID.
Amount Min Filter payments with an amount greater than or equal to this minimum value.
Amount Max Filter payments with an amount less than or equal to this maximum value.

Output

The node outputs an array of JSON objects representing payments retrieved from the Lectful Central API. Each item corresponds to one payment record and contains all relevant payment details as returned by the API, such as:

  • Payment ID
  • Invoice ID
  • Payment method ID
  • Tenant ID
  • Amount
  • Currency
  • Status
  • Payment date
  • Reference numbers
  • Notes

If the API response is a string, the node attempts to parse it into JSON before outputting.

The node does not output binary data.

Dependencies

  • Requires access to the Lectful Central API.
  • Requires either stored credentials configured in n8n or manual entry of the Base URL and API key.
  • The API key must have sufficient permissions to list payments.
  • No additional external dependencies beyond standard HTTP requests.

Troubleshooting

  • Missing or invalid credentials:
    Error message: "Valid credentials are required when using 'Use Stored Credentials' mode."
    Resolution: Ensure that the API key and base URL are correctly configured in the credentials or provide them manually.

  • Base URL or API key missing in manual mode:
    Error message: "Base URL Override is required when using Manual Configuration mode" or "API Key Override is required when using Manual Configuration mode."
    Resolution: Provide both Base URL and API key overrides when using manual authentication.

  • Invalid date formats:
    If filtering by dates, ensure the date strings are in YYYY-MM-DD format to avoid API errors.

  • API request failures:
    Check network connectivity and API availability. Review error messages logged by the node for more details.

  • Parsing errors:
    If the API returns unexpected string responses, the node tries to parse them as JSON; failure to parse will keep the response as a string.

Links and References

Discussion