sevDesk icon

sevDesk

Consume the sevDesk API
Join our community

Actions41

Overview

This node integrates with the sevDesk API to create a new "Part" resource. It is designed to add inventory items or parts into the sevDesk system, which is useful for businesses managing product catalogs, stock levels, and pricing information. Typical use cases include automating the addition of new products or components in an inventory management workflow, syncing parts data from other systems, or batch-creating parts based on external inputs.

For example, a manufacturing company could use this node to automatically add newly designed parts into their sevDesk account whenever a design is finalized, including details like stock quantity, pricing, tax rates, and categorization.

Properties

Name Meaning
Name The name of the part to be created.
Part Number A unique identifier or code assigned to the part.
Stock The current stock quantity available for the part.
Unit ID The unit of measurement for the part (e.g., pieces, kilograms). This must reference an existing unit object by its ID.
Tax Rate The applicable tax rate percentage for the part.
Additional Fields A collection of optional fields to provide more detailed information about the part:
- Category ID The category under which the part falls. Must reference an existing category object by its ID.
- Internal Comment An internal note about the part that does not appear on invoices or orders.
- Price The selling price of the part.
- Purchase Price The purchase cost of the part.
- Gross Price The gross selling price of the part.
- Net Price The net selling price of the part.
- Status The status of the part, either Inactive (50) or Active (100).
- Stock Enabled Boolean indicating whether stock tracking is enabled for this part.
- Text A descriptive text about the part.

Output

The node outputs JSON data representing the newly created part as returned by the sevDesk API. This typically includes all the properties sent during creation along with additional metadata such as unique IDs assigned by sevDesk, timestamps, and possibly linked objects (like category or unit details).

If binary data were involved (not indicated here), it would represent file attachments or images related to the part, but this node focuses solely on JSON data.

Dependencies

  • Requires an active sevDesk API key credential configured in n8n to authenticate requests.
  • Relies on the sevDesk REST API endpoint at https://my.sevdesk.de/api/v1/.
  • The user must ensure referenced units and categories exist in sevDesk before creating parts that link to them.

Troubleshooting

  • Missing Required Fields: Errors will occur if mandatory fields like Name, Part Number, Stock, Unit ID, or Tax Rate are missing or invalid. Ensure these are provided and correctly formatted.
  • Invalid References: If the Unit ID or Category ID does not correspond to existing objects in sevDesk, the API will reject the request. Verify these IDs beforehand.
  • Authentication Failures: If the API key credential is incorrect or expired, authentication errors will arise. Check and update the API credentials in n8n.
  • Status Field Values: Only the values 50 (Inactive) and 100 (Active) are valid for the status field. Using other values may cause errors.
  • Stock Enabled Boolean: Ensure this is a boolean value; otherwise, the API might reject the input.

Links and References

Discussion