sevDesk icon

sevDesk

Consume the sevDesk API
Join our community

Actions41

Overview

This node integrates with the sevDesk API to update details of a specific Part resource. It allows users to modify various attributes of an existing part, such as its name, stock quantity, pricing, tax rate, category, and status. This is useful in inventory management scenarios where parts need to be kept up-to-date with current information for sales, purchasing, or stock tracking.

Practical examples include:

  • Updating the stock level of a part after receiving new inventory.
  • Changing the price or purchase price of a part based on supplier changes.
  • Activating or deactivating a part depending on availability.
  • Adding internal comments or descriptive text for better part identification.

Properties

Name Meaning
Part ID The unique identifier of the part to update (required).
Additional Fields A collection of optional fields to update on the part:
- Name The name of the part.
- Part Number The part number identifier.
- Stock Current stock quantity available.
- Unit ID Identifier of the unit associated with the part (e.g., pieces, kilograms).
- Tax Rate Tax rate percentage applied to the part.
- Category ID Identifier of the category the part belongs to.
- Internal Comment An internal comment about the part, not shown on invoices or orders.
- Price Selling price of the part.
- Purchase Price Purchase cost of the part.
- Gross Price Gross selling price of the part.
- Net Price Net selling price of the part.
- Status Status of the part; options are "Inactive (50)" or "Active (100)".
- Stock Enabled Boolean indicating if stock tracking is enabled for this part.
- Text Descriptive text about the part.

Output

The node outputs JSON data representing the updated part object as returned by the sevDesk API. This typically includes all the updated fields along with metadata such as IDs and timestamps.

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 updates.

Dependencies

  • Requires an active sevDesk account with API access.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for API requests is https://my.sevdesk.de/api/v1/.

Troubleshooting

  • Missing or invalid Part ID: Ensure the Part ID is provided and corresponds to an existing part in sevDesk.
  • Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Invalid field values: Check that numeric fields like stock, prices, and tax rates are valid numbers and within acceptable ranges.
  • Status value issues: Use only the allowed status options (50 for Inactive, 100 for Active).
  • API rate limits or downtime: If requests fail repeatedly, check sevDesk service status and consider retry logic.

Common error messages may include unauthorized access, resource not found, or validation errors on input fields. Resolving these usually involves correcting credentials, verifying IDs, and ensuring proper data formats.

Links and References

Discussion