Batch update articles

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://restapi.wyzio.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Wyzio MCP server": {
    "url": "https://restapi.wyzio.com/mcp"
  }
}

POST /api-v1/article/batch

Modifies batch of articles

Headers

WEAL-TOKEN Required

API token (can be retrieved from account settings)
TARGET-ORGANIZATION-ID

ID of organization, for which the operation must be performed

application/json

Body Required

id integer

Entity ID. If negative value, a new entity will be created
type string Required

Article type

Values are PRODUCT, SERVICE, or BUNDLE.
articleId string Required

Article code / external identifier
name object

Multilingual name of the article.
Hide name attributes Show name attributes object
- id integer
  
  Entity ID. If negative value, a new entity will be created
- en string
- fr string
- de string
- it string
description object

Multilingual description of the article.
Hide description attributes Show description attributes object
- id integer
  
  Entity ID. If negative value, a new entity will be created
- en string
- fr string
- de string
- it string
imageId integer

Image document ID
categoryId integer

Article category ID
measurement string

Unit of measurement. Not applicable for BUNDLE type

Values are UNIT, ML, DL, L, HL, G, KG, T, H, M, M_2, M_3, KM, or DAY.
unitCost string

Unit cost as string. Not applicable for BUNDLE type
unitPrice string

Unit price as string
vatRateId integer

VAT rate ID
saleAccountId integer

Chart of accounts sale account ID
currency object

Currency. Only id is required when sending. Null for BUNDLE type
Hide currency attribute Show currency attribute object
- id integer Required
  
  Currency ID
ean string

EAN barcode
isManufactured boolean

Whether the article is manufactured. Only relevant for PRODUCT type
archived boolean

Whether the article is archived
quantity number

Quantity in stock (informational, managed by stock movements)
startDate string

Validity start date (ISO 8601)
endDate string

Validity end date (ISO 8601)
margin number

Margin value
weightKg number

Weight in kg, up to 3 decimal places
items array[object]

Bundle items. Only applicable for BUNDLE type
Hide items attributes Show items attributes object
- id integer
  
  Entity ID. If negative value, a new entity will be created
- articleId integer Required
  
  ID of the article included in this bundle
- price string
  
  Unit price of the item as string
- amount string Required
  
  Quantity of the item as string
- discount string
  
  Discount percentage as string. Defaults to 0 if null
- totalPrice string Required
  
  Total price of the item as string

Responses

200 application/json

OK
Hide response attribute Show response attribute object
- items array[object]
  
  Hide items attributes Show items attributes object
  
  errorCode object
  
  Hide errorCode attributes Show errorCode attributes object
  
  errorCode string
  
  Values are NO_ERROR, NOT_IMPLEMENTED_YET, CONTACT_NOT_FOUND, FIELD_REQUIRED, VALIDATION_ERROR, DUPLICATION_ERROR, UNIQUE_CONSTRAINT_VIOLATION, WRONG_PASSWORD_FORMAT, WRONG_PASSWORD, ACTION_DENIED, NOT_FOUND, EXPECTED_ONE_FILE, UNIQUE_VIOLATION, CONTENT_EMPTY, INVALID_TYPE, CONVERSION_ERROR, FILE_PARSE_EXCEPTION, or IN_USE.
  
  errorDetailValues array[object]
  
  Hide errorDetailValues attributes Show errorDetailValues attributes object
  
  errorCode string
  
  fieldName string
  
  data string
  
  isSevere boolean
  
  freshData
  
  Refreshed domain data
  
  freshRow
  
  Refreshed table row data
  
  possibleWorkflows array[object]
  
  Hide possibleWorkflows attributes Show possibleWorkflows attributes object
  
  id integer(int64)
  
  name string
  
  error boolean
  
  severeError boolean
400

400 Bad Request
401

401 Unauthorized
403

403 Access Denied
404

404 Not Found
500

500 Internal Server Error

POST /api-v1/article/batch

curl \
 --request POST 'https://wyzio.app/api-v1/article/batch' \
 --header "Content-Type: application/json" \
 --data '[{"id":12345678,"type":"PRODUCT","articleId":"ART-001","name":{"id":12345678,"en":"English translation","fr":"Traduction française","de":"Deutsche Übersetzung","it":"Traduzione in italiano"},"description":{"id":12345678,"en":"English translation","fr":"Traduction française","de":"Deutsche Übersetzung","it":"Traduzione in italiano"},"imageId":12345678,"categoryId":12345678,"measurement":"UNIT","unitCost":100.0,"unitPrice":150.0,"vatRateId":12345678,"saleAccountId":12345678,"currency":{"id":12345678},"ean":4006381333931,"isManufactured":true,"archived":false,"quantity":10.0,"startDate":"2024-01-01","endDate":"2024-12-31","margin":25.0,"weightKg":1.255,"items":[{"id":12345678,"articleId":12345678,"price":50.0,"amount":2,"discount":10.0,"totalPrice":90.0}]}]'

Request examples

# Headers

# Payload
[
  {
    "id": 12345678,
    "type": "PRODUCT",
    "articleId": "ART-001",
    "name": {
      "id": 12345678,
      "en": "English translation",
      "fr": "Traduction française",
      "de": "Deutsche Übersetzung",
      "it": "Traduzione in italiano"
    },
    "description": {
      "id": 12345678,
      "en": "English translation",
      "fr": "Traduction française",
      "de": "Deutsche Übersetzung",
      "it": "Traduzione in italiano"
    },
    "imageId": 12345678,
    "categoryId": 12345678,
    "measurement": "UNIT",
    "unitCost": 100.0,
    "unitPrice": 150.0,
    "vatRateId": 12345678,
    "saleAccountId": 12345678,
    "currency": {
      "id": 12345678
    },
    "ean": 4006381333931,
    "isManufactured": true,
    "archived": false,
    "quantity": 10.0,
    "startDate": "2024-01-01",
    "endDate": "2024-12-31",
    "margin": 25.0,
    "weightKg": 1.255,
    "items": [
      {
        "id": 12345678,
        "articleId": 12345678,
        "price": 50.0,
        "amount": 2,
        "discount": 10.0,
        "totalPrice": 90.0
      }
    ]
  }
]

Response examples (200)

{
  "items": [
    {
      "errorCode": {
        "errorCode": "NO_ERROR",
        "errorDetailValues": [
          {
            "errorCode": "string",
            "fieldName": "string",
            "data": "string",
            "isSevere": true
          }
        ]
      },
      "possibleWorkflows": [
        {
          "id": 42,
          "name": "string"
        }
      ],
      "error": true,
      "severeError": true
    }
  ]
}