Skip to main content
POST
/
api
/
v1
/
products
Crear Producto
curl --request POST \
  --url https://api.zenflow.com.ar/api/v1/products \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "<string>",
  "barcode": "<string>",
  "sku": "<string>",
  "category": "<string>",
  "description": "<string>",
  "price": 123,
  "weight": 123,
  "width": 123,
  "height": 123,
  "depth": 123,
  "weighable": true,
  "photo_url": "<string>"
}
'

​
Crear Producto

Crea un nuevo producto en tu catálogo.
Requiere scope write:products.

​
Solicitud

POST /api/v1/products

​
Parámetros del Body

​
name
string
required
Nombre del producto
​
barcode
string
required
Código de barras del producto (debe ser único)
​
sku
string
SKU / ID externo
​
category
string
Categoría del producto
​
description
string
Descripción del producto
​
price
number
Precio unitario
​
weight
number
Peso en kg
​
width
number
Ancho en cm
​
height
number
Alto en cm
​
depth
number
Profundidad en cm
​
weighable
boolean
default:"false"
Si el producto se vende por peso
​
photo_url
string
URL de la imagen del producto

​
Ejemplo

curl -X POST "https://api.zenflow.com.ar/api/v1/products" \
  -H "X-API-Key: zenflow_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Widget A",
    "barcode": "7891234567890",
    "sku": "SKU-001",
    "category": "Electrónica",
    "price": 29.99,
    "weight": 0.5
  }'

​
Respuesta

{
  "success": true,
  "data": {
    "id": 100,
    "barcode": "7891234567890",
    "external_id": "SKU-001",
    "name": "Widget A",
    "category": "Electrónica",
    "price": 29.99,
    "weight": 0.5,
    "is_active": true,
    "created_at": "2024-01-14T10:30:00Z"
  }
}

​
Respuestas de Error

​
400 Error de Validación

{
  "success": false,
  "error": {
    "code": "validation_error",
    "message": "Nombre y código de barras son requeridos"
  }
}

​
409 Ya Existe

{
  "success": false,
  "error": {
    "code": "already_exists",
    "message": "Ya existe un producto con este código de barras"
  }
}