Article

Create a new article

post/core/latest/articles

Request

Base URL: https://api.klara.ch
URL: https://api.klara.ch/core/latest/articles
Auth: one of:
- API key in header X-API-KEY
- HTTP bearer

Request body

idstring

Id of the article. Does not need to be included when creating article

nameDEstring required

Name of the article in German

nameENstring

Name of the article in English

nameFRstring

Name of the article in French

nameITstring

Name of the article in Italian

descriptionDEstring

Description of the article in German

descriptionENstring

Description of the article in English

descriptionFRstring

Description of the article in French

descriptionITstring

Description of the article in Italian

extendedDescriptionDEstring

Extended description of the article in German

extendedDescriptionENstring

Extended description of the article in English

extendedDescriptionFRstring

Extended description of the article in French

extendedDescriptionITstring

Extended description of the article in Italian

unitDEstring required

Unit of the article in German

unitENstring

Unit of the article in English

unitFRstring

Unit of the article in French

unitITstring

Unit of the article in Italian

barcodestring

Barcode of the article

usePosboolean

Decides if this article is used for POS or not

imageHrefsstring[]

Reference uris for the images of this article if present.

isArticleSetboolean

Decides if this article is an article set

articleSetNamestring

Name of the article set. Does not need to be included if article is not an article set.

defaultQuantitynumber

The default quantity of the article

accountingTagsstring[] required

Tags used for accounting. Articles with the same tag, same VAT case and same VAT rate are grouped together in the posting

articleNumberstring required

Article number

hasVariantboolean

Specify if the article has variants or not

includedInArticleSetsstring[]

Names of the article sets that the article is included in.<br />If the article have some variants, then only the variants will show the article set name they belong to, not the parent article (null value is shown).

sellInOnlineShopboolean

Specify if the article is able to be sold on the Online shop or not

isAdultArticleboolean

Specify if the article is only used for adult or not

The product type of the article

searchTagsstring[]

Search tags make it easier for your customer to find your product in the online shop

numberType'NO_NUMBER' | 'BATCH_NUMBER' | 'SERIAL_NUMBER'

Inventory Number Type<br />Use either NO_NUMBER or SERIAL_NUMBER

Example request

{
  "id": "1",
  "options": [
    {
      "name": "color"
    }
  ],
  "imageHrefs": [
    "https://api.klara.ch/core/latest/articles/1/images/1"
  ],
  "articleNumber": "ABC123",
  "posCategories": [
    {
      "id": "1",
      "category_href": "https://api.klara.ch/core/latest/article-categories/1",
      "nameDE": "shop",
      "nameEN": "shop",
      "nameFR": "shop",
      "nameIT": "shop"
    }
  ],
  "posFilters": [
    {
      "id": "1",
      "filter_href": "https://api.klara.ch/core/latest/article-filters/1",
      "nameDE": "shop",
      "nameEN": "shop",
      "nameFR": "shop",
      "nameIT": "shop"
    }
  ],
  "onlineShopCategories": [
    {
      "id": "1",
      "category_href": "https://api.klara.ch/core/latest/article-categories/1",
      "nameDE": "shop",
      "nameEN": "shop",
      "nameFR": "shop",
      "nameIT": "shop"
    }
  ],
  "onlineShopFilters": [
    {
      "id": "1",
      "filter_href": "https://api.klara.ch/core/latest/article-filters/1",
      "nameDE": "shop",
      "nameEN": "shop",
      "nameFR": "shop",
      "nameIT": "shop"
    }
  ],
  "bookingCategories": [
    {
      "id": "1",
      "category_href": "https://api.klara.ch/core/latest/article-categories/1",
      "nameDE": "shop",
      "nameEN": "shop",
      "nameFR": "shop",
      "nameIT": "shop"
    }
  ],
  "vats": [
    {
      "vatType": "NORMAL",
      "vatCase": "TAXABLE_SUPPLY",
      "vatCode": "1"
    }
  ]
}

Response

Article created