Skip to main content
POST
/
api
/
v1
/
products
/
bulk
Upsert Masivo de Productos
curl --request POST \
  --url https://api.zenflow.com.ar/api/v1/products/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "products": [
    {
      "barcode": "<string>",
      "name": "<string>",
      "sku": "<string>",
      "category": "<string>",
      "price": 123,
      "weight": 123
    }
  ]
}
'

​
Upsert Masivo de Productos

Crea nuevos productos o actualiza existentes en una sola solicitud. Los productos se identifican por código de barras.
Requiere scope write:products.

​
Solicitud

POST /api/v1/products/bulk

​
Parámetros del Body

​
products
array
required
Array de productos a crear o actualizar

​
Ejemplo

curl -X POST "https://api.zenflow.com.ar/api/v1/products/bulk" \
  -H "X-API-Key: zenflow_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      {
        "barcode": "7891234567890",
        "name": "Widget A",
        "sku": "SKU-001",
        "price": 29.99
      },
      {
        "barcode": "7891234567891",
        "name": "Widget B",
        "sku": "SKU-002",
        "price": 49.99
      },
      {
        "barcode": "7891234567892",
        "name": "Widget C",
        "sku": "SKU-003",
        "price": 19.99
      }
    ]
  }'

​
Respuesta

{
  "success": true,
  "data": {
    "created": 2,
    "updated": 1,
    "errors": []
  }
}

​
Respuesta con Errores

{
  "success": true,
  "data": {
    "created": 2,
    "updated": 0,
    "errors": [
      {
        "barcode": "INVALIDO",
        "error": "Código de barras es requerido"
      }
    ]
  }
}

​
Mejores Prácticas

  • Usa este endpoint para sincronización inicial del catálogo
  • Agrupa productos en lotes de 100 para rendimiento óptimo
  • El endpoint es idempotente - seguro para reintentar en caso de fallo