Criar um novo produto

Developing

POST

/api/v1/products

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "sku": "SUPER-CAFE-123",
    "name": "Café Gourmet (Cx 12x500g)",
    "description": "Caixa com 12 pacotes de café gourmet torrado e moído",
    "unit_cost": 239.9,
    "unit": "cx",
    "barcode": "",
    "is_active": true,
    "dimensions": {
        "height": 400,
        "width": 300,
        "length": 200,
        "weight": 6
    },
    "characteristics": {
        "is_dangerous": false,
        "is_fragile": false,
        "has_serial_number": false,
        "has_batch_control": true,
        "has_ean": false
    },
    "stock_control": {
        "restock_priority": 3,
        "min_stock_quantity": 5,
        "ideal_stock_quantity": 15
    },
    "expiration_control": {
        "has_expiration_date": true,
        "shelf_life_days": 180,
        "min_remaining_shelf_life": 30,
        "expiration_alert_days": 45
    },
    "temperature_control": {
        "is_refrigerated": true,
        "storage_temp_min": 0.1,
        "storage_temp_max": 12
    }
}

Responses

🟢201Criado

application/json

Body

Example

{
    "success": true,
    "message": "Produto criado com sucesso",
    "data": {
        "sku": "SUPER-CAFE-123",
        "name": "Café Gourmet (Cx 12x500g)",
        "description": "Caixa com 12 pacotes de café gourmet torrado e moído",
        "unit_cost": 239.9,
        "unit": "cx",
        "barcode": "SUPER-CAFE-123-850764",
        "is_active": true,
        "dimensions": {
            "height": 400,
            "width": 300,
            "length": 200,
            "weight": 6
        },
        "characteristics": {
            "is_dangerous": false,
            "is_fragile": false,
            "has_serial_number": false,
            "has_batch_control": true,
            "has_ean": false
        },
        "stock_control": {
            "restock_priority": 3,
            "restock_priority_description": "Alta",
            "min_stock_quantity": 5,
            "ideal_stock_quantity": 15
        },
        "expiration_control": {
            "has_expiration_date": true,
            "shelf_life_days": 180,
            "min_remaining_shelf_life": 30,
            "expiration_alert_days": 45
        },
        "temperature_control": {
            "is_refrigerated": true,
            "storage_temp_min": 0.1,
            "storage_temp_max": 12
        },
        "fiscal_codes": [],
        "stock": {
            "warehouses": []
        },
        "created_at": "2025-07-18T14:59:24.000000Z",
        "updated_at": "2025-07-18T14:59:24.000000Z"
    }
}

🟠422Erro de validação

Coleção de produtos

Detalhes do produto