Letter Xpress icon

Letter Xpress

Letter Xpress API Integration

Overview

This node integrates with the Letter Xpress API to manage postal letter services and related account data. It supports multiple operations such as sending letters, retrieving account balance, fetching print jobs, email jobs, transactions, invoices, and a specific invoice by ID.

The "Rechnung Abrufen" (Get Invoice) operation allows users to retrieve detailed information about a single invoice by specifying its invoice ID. This is useful for automating invoice management workflows, such as fetching invoice details for accounting or record-keeping purposes.

Practical examples:

  • Automatically fetch an invoice's details after a transaction completes.
  • Integrate invoice retrieval into financial reporting workflows.
  • Use invoice data to trigger further processing or notifications.

Properties

Name Meaning
Rechnungs-ID ID of the invoice to retrieve.

Note: The property "Rechnungs-ID" is required for the "Rechnung Abrufen" operation and expects a number representing the invoice's unique identifier.

Output

The node outputs JSON data representing the requested invoice's details as returned by the Letter Xpress API. The structure typically includes all relevant invoice fields such as invoice number, date, amount, status, and other metadata provided by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Letter Xpress API.
  • The node makes HTTP requests to https://api.letterxpress.de endpoints.
  • Proper configuration of the API authentication credentials in n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing invoice ID will cause the API request to fail.
    • Incorrect or expired API credentials will result in authentication errors.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • "Operation "getInvoice" not supported": Indicates an unsupported operation was selected; ensure the correct operation is chosen.
    • API errors are wrapped and thrown as node API errors; check the error message for details such as invalid invoice ID or authentication failure.
  • Resolutions:

    • Verify that the invoice ID is correct and exists in the Letter Xpress system.
    • Confirm that the API key credential is valid and has necessary permissions.
    • Check network access and proxy settings if applicable.

Links and References

Discussion