Lectful Central icon

Lectful Central

Interact with the Lectful Central API for admin operations

Actions63

Overview

The "Update Invoice" operation in the Lectful Central node allows users to modify existing invoice details within the Lectful Central API. This operation is useful for administrators or automated workflows that need to adjust invoice information such as invoice number, amount, currency, due date, status, or description after an invoice has been created.

Common scenarios include:

  • Correcting invoice amounts or due dates.
  • Updating invoice status (e.g., from draft to sent).
  • Adding or modifying descriptions for clarity or record-keeping.

Practical example:

  • An accounting automation workflow detects a change in billing terms and uses this operation to update the due date and amount on an existing invoice accordingly.

Properties

Name Meaning
Authentication Mode Choose how to authenticate with the Lectful Central API: "Use Stored Credentials" or "Manual Configuration".
Credentials Note Informational note shown when using Manual Configuration mode about credential usage.
Base URL Override Optional base URL to override the stored credential's base URL (without /api/v1).
API Key Override Optional API key to override the stored credential's API key.
Invoice ID The unique numeric identifier of the invoice to update (required).
Invoice Number New invoice number string to update (optional).
Amount New invoice amount as a number (optional, must be > 0 to apply).
Currency Currency code string (e.g., USD, EUR) to update (optional).
Due Date New due date string in YYYY-MM-DD format (optional).
Status New invoice status; options include Draft, Sent, Paid, Overdue, Cancelled (optional).
Description New description text for the invoice (optional).

Output

The node outputs an array of JSON objects corresponding to each input item processed. For the "Update Invoice" operation, the output JSON contains the updated invoice data returned by the Lectful Central API after the successful update.

Example output structure (simplified):

{
  "id": 123,
  "invoice_number": "INV-001",
  "amount": 1000,
  "currency": "USD",
  "due_date": "2024-07-01",
  "status": "sent",
  "description": "Updated invoice description",
  ...
}

No binary data output is produced by this operation.

Dependencies

  • Requires access to the Lectful Central API.
  • Requires either stored credentials configured in n8n or manual entry of Base URL and API key.
  • The API key must have permissions to update invoices.
  • Network connectivity to the Lectful Central API endpoint.

Troubleshooting

  • Missing or invalid credentials: If neither stored credentials nor manual overrides are provided correctly, the node will throw an error indicating missing or invalid credentials. Ensure credentials are properly configured or manual parameters are set.
  • Invalid Invoice ID: Providing an incorrect or non-existent invoice ID will result in an API error. Verify the invoice ID before running the node.
  • Invalid field values: Fields like amount must be positive numbers, and dates must follow the YYYY-MM-DD format. Invalid formats may cause API errors.
  • API connectivity issues: Network problems or incorrect base URL can cause request failures. Check connectivity and base URL correctness.
  • Permission errors: Insufficient API permissions will cause authorization errors. Confirm the API key has rights to update invoices.

Links and References

Discussion