Creates a new article
Request Information
URI Parameters :
None.
Body Parameters :
article| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
Primary Key |
globally unique identifier |
Required |
| article_category_id |
Foreign key to article category |
globally unique identifier | |
| article_category |
Embedded entity "article_category" when adding/updating article |
article_category | |
| article_category_code |
Embedded entity "article_category" using ERP PK when adding/updating article |
string | |
| article_group_1_id |
Foreign key to article_group_1 |
globally unique identifier | |
| article_group_1_code |
Embedded entity "article_group_1" using ERP PK when adding/updating article |
string | |
| article_group_1 |
Embedded entity "article_group_1" using ERP PK when adding/updating article |
article_group_1 | |
| article_group_2_id |
Foreign key to article_group_2 |
globally unique identifier | |
| article_group_2_code |
Embedded entity "article_group_2" using ERP PK when adding/updating article |
string | |
| article_group_2 |
Embedded entity "article_group_2" using ERP PK when adding/updating article |
article_group_2 | |
| article_group_3_id |
Foreign key to article_group_3 |
globally unique identifier | |
| article_group_3_code |
Embedded entity "article_group_3" using ERP PK when adding/updating article |
string | |
| article_group_3 |
Embedded entity "article_group_3" using ERP PK when adding/updating article |
article_group_3 | |
| article_group_4_id |
Foreign key to article_group_4 |
globally unique identifier | |
| article_group_4_code |
Embedded entity "article_group_4" using ERP PK when adding/updating article |
string | |
| article_group_4 |
Embedded entity "article_group_4" using ERP PK when adding/updating article |
article_group_4 | |
| article_group_5_id |
Foreign key to article_group_5 |
globally unique identifier | |
| article_group_5_code |
Embedded entity "article_group_5" using ERP PK when adding/updating article |
string | |
| article_group_5 |
Embedded entity "article_group_5" using ERP PK when adding/updating article |
article_group_5 | |
| article_group_6_id |
Foreign key to article_group_6 |
globally unique identifier | |
| article_group_6_code |
Embedded entity "article_group_6" using ERP PK when adding/updating article |
string | |
| article_group_6 |
Embedded entity "article_group_6" using ERP PK when adding/updating article |
article_group_6 | |
| physical_stock |
Physical stock from the ERP (used for Eco Stock) |
integer | |
| back_order_client |
Number of pieces reserved for clients (used for Eco Stock) |
integer | |
| back_order_supplier |
Number of pieces that should arrive from the supplier (used for Eco stock if expected delivery is in the past) |
integer | |
| expected_delivery_date_bo_supplier |
Date when the delivery from the supplier should arrive (used for Eco stock) |
date | |
| article_increment |
For Sales : Increment used to order (by 2, by 4 etc) |
integer | |
| min_article_quantity |
For Sales : Minimum amount to be ordered |
integer | |
| entered_price |
Standard article price |
decimal number | |
| cost_price | decimal number | ||
| no_stock |
For Sales : Disables the stock check |
boolean | |
| archived |
Archives an article (cannot be deleted) |
boolean | |
| is_travel_fee |
Indicate that this article will be used to compute the fee based on the car travel time |
boolean | |
| is_mileage_fee |
Indicate that this article will be used to compute the fee based on the distance. |
boolean | |
| code |
The Id/Ref of the back office. Used by Embedded entity |
string |
Max length: 50 |
| name |
Name of the article |
string |
Required Max length: 50 |
| description_short |
Description (if exists, otherwhise name will be used) |
string |
Max length: 100 |
| description_long |
Long description |
string | |
| barcode |
Barcode of the article (fast search) |
string |
Max length: 50 |
| notes |
Notes (remark, details) |
string |
Max length: 255 |
| date_create |
Creation date, auto filled by Now if no value received |
date | |
| date_update |
Update date, auto filled by Now if no value received |
date | |
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date | |
| article_color_id |
Foreign key to article_color |
globally unique identifier | |
| article_color_code |
Embedded entity "article_color" using ERP PK when adding/updating article |
string | |
| article_color |
Embedded entity "article_color" when adding/updating article |
article_color | |
| warranty_period_nb_months |
warranty_period_nb_months |
integer | |
| use_serial |
use_serial |
boolean | |
| _replace_id |
Foreign key to article that replace the current article |
globally unique identifier | |
| replace_article |
Embedded entity "article" of replace, when adding/updating article |
article | |
| replace_article_code |
Embedded code "article" of replace, when adding/updating article |
string | |
| db_unit_of_measure_id_selling |
Applicable db_unit_of_measure |
globally unique identifier | |
| db_unit_of_measure_code_selling |
Applicable db_unit_of_measure |
string | |
| translations |
List of translation of specific field name |
Collection of translation |
Request Formats :
application/json, text/json
{
"id": "1b781613-e85c-4e8d-993d-e5b41d2e934e",
"article_category_id": "de6da449-f3be-4c64-b9d8-e58dac2b1e41",
"article_category": {
"id": "e375482f-58bd-4275-b347-656867396ac2",
"parent_id": "c536868a-d3a3-4373-be37-2d72bf73cf0d",
"parent_code": "sample string 3",
"code": "sample string 4",
"name": "sample string 5",
"modified_dateutc": "2025-11-03T17:33:25.363238+00:00"
},
"article_category_code": "sample string 3",
"article_group_1_id": "a4ae0a41-a224-46e4-8642-d87fa23bc158",
"article_group_1_code": "sample string 5",
"article_group_2_id": "3def125d-5f8e-4541-834f-7d1afeb690a2",
"article_group_2_code": "sample string 7",
"article_group_3_id": "d63057db-b146-490e-bb59-abbda3d6557a",
"article_group_3_code": "sample string 9",
"article_group_4_id": "f82a288d-1734-486a-ad28-94572e2a7992",
"article_group_4_code": "sample string 11",
"article_group_5_id": "f696dda8-daf5-4fc4-8636-58780be6d0f9",
"article_group_5_code": "sample string 13",
"article_group_6_id": "973fbd6a-0f2c-4e02-bc41-d118888ad72f",
"article_group_6_code": "sample string 15",
"physical_stock": 16,
"back_order_client": 17,
"back_order_supplier": 18,
"expected_delivery_date_bo_supplier": "2025-11-03T17:33:25.363238+00:00",
"article_increment": 20,
"min_article_quantity": 21,
"entered_price": 22.0,
"cost_price": 23.1,
"no_stock": true,
"archived": true,
"is_travel_fee": true,
"is_mileage_fee": true,
"code": "sample string 28",
"name": "sample string 29",
"description_short": "sample string 30",
"description_long": "sample string 31",
"barcode": "sample string 32",
"notes": "sample string 33",
"date_create": "2025-11-03T17:33:25.363238+00:00",
"date_update": "2025-11-03T17:33:25.363238+00:00",
"modified_dateutc": "2025-11-03T17:33:25.363238+00:00",
"article_color_id": "f505d0d5-68e0-4d28-ba0c-43ba040a8d62",
"article_color_code": "sample string 38",
"article_color": {
"id": "f17ab078-638c-4584-a19c-0fde8ca497cb",
"name": "sample string 2",
"code": "sample string 3",
"modified_dateutc": "2025-11-03T17:33:25.363238+00:00"
},
"warranty_period_nb_months": 39,
"use_serial": true,
"_replace_id": "7be1a0eb-1110-4768-8ea3-82cd9c19a09a",
"replace_article_code": "sample string 42",
"db_unit_of_measure_id_selling": "93c83731-842c-40c8-b88e-10cca0922f6f",
"db_unit_of_measure_code_selling": "sample string 44",
"translations": [
{
"field_name": "sample string 1",
"language_code": "sample string 2",
"value_translated": "sample string 3"
},
{
"field_name": "sample string 1",
"language_code": "sample string 2",
"value_translated": "sample string 3"
}
]
}
Response Information
Resource Description :
IHttpActionResultNone.
Response Formats
application/json, text/json
Sample not available.