Article Management¶

The article management within the order module allows managing standard articles that are used as items in orders. Management is handled via the StandardArticleController in the Laravel API.

Concept¶

Standard articles are predefined services or products that are used repeatedly in orders. They form an article master from which selections can be made when creating order items.

List View¶

Column	Description
Article Number	Unique identifier of the article
Name	Name of the article
Description	Brief description
Unit	Unit of measure (piece, hour, flat rate)
Price	Standard price
Category	Assigned article category

CRUD Operations¶

Create Article¶

POST /api/v2/standard-articles

Field	Required	Description
Article Number	Yes	Unique identifier
Name	Yes	Name of the article
Description	No	Detailed description
Unit	Yes	Unit of measure
Price	No	Standard price (net)
VAT Rate	Yes	Value-added tax rate in percent
Category	No	Assignment to an article category

Edit Article¶

PUT /api/v2/standard-articles/{id}

Delete Article¶

DELETE /api/v2/standard-articles/{id}

Warning

Deleting a standard article does not affect existing order items that use this article. The items retain their data.

Link to Calibration Standards¶

Standard articles can be linked to calibration standards. This is useful when an article represents a specific calibration service and the associated measurement standard should be documented.

PUT /api/v2/standard-articles/{id}
Body: { "calibration_standard_id": 15 }

Calibration Standards

Linking to a calibration standard enables automatic assignment of the test equipment used during order processing.

Usage in Orders¶

When adding an item to an order, you can select from the article master:

Click the "Add Item" button in the order form
Find the article via the search function (autocomplete)
Enter the quantity
The price is populated from the article master (can be individually adjusted)

Pricing¶

The price stored in the standard article serves as a suggested value. It can be individually adjusted when inserting into an order. Price changes to the standard article do not affect existing order items.

Tip

For customer-specific prices, use price groups (see Price Groups). This allows you to set different prices per customer group.

Permissions¶

Managing standard articles requires the article_manage permission. Using articles in orders requires booking_manage.