sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to manage credit notes, specifically enabling the operation "Send By Printing" for a credit note. The primary function of this operation is to send a specified credit note to a printer or printing service, facilitating physical document handling.

Common scenarios where this node is beneficial include:

  • Automatically sending credit notes to a printer after creation or update.
  • Integrating sevDesk credit note printing into automated workflows, such as invoicing or accounting processes.
  • Streamlining document management by triggering print jobs directly from n8n without manual intervention.

Example use case: After generating a credit note in sevDesk, this node can be used to send that credit note to a network printer for physical dispatch or record keeping.

Properties

Name Meaning
Credit Note ID The unique identifier of the credit note to be sent by printing. This is required.
Send Type A collection specifying the type of sending method. It contains:
- Type The specific type of sending method (e.g., could represent different printing options).

Output

The node outputs an array of JSON objects representing the response from the sevDesk API after attempting to send the credit note by printing. Each output item corresponds to one input item processed.

  • The json field contains the API response data related to the send-by-printing operation.
  • If an error occurs and the node is configured to continue on failure, the output will contain an object with an error property describing the issue.
  • The node does not explicitly handle binary data output.

Dependencies

  • Requires an active connection to the sevDesk API via an API key credential.
  • The node depends on the SevDeskResourceManager class to perform API operations.
  • Environment configuration validation is performed before execution.
  • No additional external services are required beyond sevDesk.

Troubleshooting

  • Common issues:

    • Invalid or missing Credit Note ID will cause the operation to fail.
    • Network or authentication errors when connecting to the sevDesk API.
    • Incorrect "Send Type" values may result in unexpected behavior or API errors.
  • Error messages:

    • Errors returned from the API are captured and can be output if "Continue On Fail" is enabled.
    • Typical errors include authorization failures, resource not found, or invalid parameters.
  • Resolutions:

    • Ensure the Credit Note ID is correct and exists in sevDesk.
    • Verify API credentials and permissions.
    • Confirm that the "Send Type" parameter matches supported printing methods in sevDesk.

Links and References

Discussion