Editing a Product

Updates a product and its components. Only the fields you pass are changed, the rest stay as they were.

v1/products/edit.php

Parameters

Product components

The components are defined per batch (batch_size units) and passed as the arrays materials, products (subassemblies) and resources.

materials and products lines

If at least one of the materials and products arrays is passed, materials and subassemblies are replaced as a whole, and the array that is not passed is treated as empty. For example, if you pass only materials, the subassemblies are removed from the components.

position sets the order of component lines in the Controlata interface, shared by materials and products. Lines without it go last, in the order passed. Controlata renumbers positions from 0, so in Retrieving a Product they may differ from the ones you passed.

resources lines

Each resource line contains the resource id. Whether amount_per_batch and unit are needed depends on the resource type (see Creating a Resource):

Example request

A new sale price and material components. No subassemblies are passed, so they are removed from the components; resources stay the same.

{
    "product_id": 3120,
    "price": 47000,
    "materials": [
        {
            "id": 2051,
            "amount_per_batch": 0.6,
            "unit": "cu m",
            "loss_percent": 5
        },
        {
            "id": 2060,
            "amount_per_batch": 400,
            "unit": "pcs"
        }
    ]
}

Change only the minimum stock:

{
    "product_id": 3120,
    "minimum": 3,
    "storage_id": 3999
}

Example response

{
    "success": true
}

Errors

Errors in component lines

In the error text, instead of 2051 there is the item ID, and instead of 0 the line number in the array (from 0).