sevDesk icon

sevDesk

Consume the sevDesk API

Actions98

Part → Create

AI-generated

Overview

This node integrates with the sevDesk API to create a new "Part" resource. It allows users to add parts with detailed attributes such as pricing, stock information, category, and tax rates. This is useful in scenarios where inventory or product management needs to be automated within sevDesk, such as adding new items to a catalog or updating stock levels programmatically.

Practical examples include:

  • Automatically creating parts when new products are added in an e-commerce platform.
  • Syncing inventory data from external systems into sevDesk.
  • Managing pricing updates for parts based on external pricing feeds.

Properties

Name Meaning
Additional Fields A collection of optional fields to specify details about the part:
- Category JSON object specifying the category of the part (e.g., {"id": "", "objectName": "Category"})
- Internal Comment An internal comment for the part, not visible on invoices or orders
- Name The name of the part (required for creation)
- Part Number The unique part number identifier (required for creation)
- Price Net price at which the part is sold (required for creation)
- Price Gross Gross price at which the part is sold
- Price Net Net price at which the part is sold
- Price Purchase Purchase price of the part
- Status Status of the part; 50 means Inactive, 100 means Active
- Stock Current stock quantity of the part (required for creation)
- Stock Enabled Boolean indicating if stock tracking is enabled (required for creation)
- Tax Rate Tax rate applicable to the part (required for creation)
- Text Descriptive text about the part
- Unity JSON object specifying the unit of measurement for the part (e.g., {"id": "", "objectName": "Unity"})

Output

The node outputs an array of JSON objects representing the created parts. Each output item contains the full response from the sevDesk API for the created part, including all properties set during creation and any additional metadata returned by the API.

If errors occur and the node is configured to continue on failure, the output will include error messages associated with the respective input item.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the sevDesk API.
  • The node uses the base URL https://my.sevdesk.de/api/ combined with the API version specified in credentials.
  • Environment configuration validation is performed before execution.
  • No other external dependencies are required.

Troubleshooting

  • Common issues:

    • Missing required fields such as Name, Part Number, Price, Stock, Stock Enabled, Tax Rate, or Unity can cause the API to reject the request.
    • Incorrectly formatted JSON for Category or Unity fields may lead to validation errors.
    • Network or authentication failures due to invalid or missing API credentials.

  • Error messages:

    • Errors returned from the API will be included in the output if "Continue On Fail" is enabled.
    • Validation schema initialization errors are logged to the console but do not prevent node loading.

  • Resolutions:

    • Ensure all required fields are provided and correctly formatted.
    • Verify API credentials and network connectivity.
    • Use the "Continue On Fail" option to handle partial failures gracefully.

Links and References

Discussion