Sincronizar muchos productos

POST https://app.sendapp.ai/api/products/bulk

Hasta 1000 productos por llamada, con los mismos campos que el endpoint individual. La respuesta llega enseguida (202): las filas se comprueban al momento y se escriben poco después, por bloques, sin ralentizar la tienda. Para un catálogo grande haz varias llamadas seguidas.

Con la respuesta recibes un import_id para seguir el avance.

Una fila errónea no detiene las demás. Las filas no válidas se listan enseguida en errors, con su posición en tu lista (index), el SKU y el motivo.

Volver a enviar todo el catálogo es seguro y rápido: los productos iguales se cuentan como unchanged y no se reescriben.

import_key hace que la llamada se pueda repetir: si la reenvías tras un timeout con la misma clave (en 24 horas) recibes la misma importación, no una segunda.

Límites: 3 importaciones en curso por cuenta (a partir de ahí, respuesta 429 con Retry-After), 20 llamadas bulk por minuto, cuerpo de la petición de 8 MB como máximo, 20.000 productos por cuenta.

Parámetros

4 · 2 obligatorios

apikey obligatorio

Tu API Key (como alternativa: la cabecera X-API-Key).

token opcional

Token de la cuenta. Obligatorio si tienes más de una.

products obligatorio

Lista de productos, con los mismos campos que el endpoint individual. Máximo 1000 por llamada; cada SKU una sola vez.

import_key opcional

Tu identificador de la llamada (máx. 80 caracteres), para poder repetirla sin duplicados.

¿Necesitas ayuda con la integración? info@sendapp.live

Solicitud

curl -X POST 'https://app.sendapp.ai/api/products/bulk' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "token": "YOUR_ACCOUNT_TOKEN",
    "import_key": "feed-2026-09-18",
    "products": [
      { "sku": "MUG-01", "name": "Tazza", "price": 9, "stock": 120 },
      { "sku": "TSH-001", "price": 22.50 }
    ]
  }'

<?php
// Whole catalogue, 1000 products per call, then follow each import.
foreach (array_chunk($catalogue, 1000) as $i => $chunk) {
    $ch = curl_init('https://app.sendapp.ai/api/products/bulk');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'],
        CURLOPT_POSTFIELDS => json_encode([
            'token'      => 'YOUR_ACCOUNT_TOKEN',
            'import_key' => 'feed-' . date('Y-m-d') . '-' . $i,
            'products'   => $chunk,
        ]),
    ]);
    $res = json_decode(curl_exec($ch), true);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    if ($code === 429) { sleep(30); /* send this chunk again */ }
}

const res = await fetch('https://app.sendapp.ai/api/products/bulk', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    token: 'YOUR_ACCOUNT_TOKEN',
    products: catalogue.slice(0, 1000),
  }),
});
const { import_id } = await res.json();

Respuesta

{
  "status": "success",
  "accepted": 1,
  "rejected": 1,
  "import_id": "imp_eggsipzvalu6xlkqjfecphki",
  "state": "queued",
  "total": 1,
  "processed": 0,
  "created": 0,
  "updated": 0,
  "unchanged": 0,
  "failed": 1,
  "images": { "status": "none", "total": 0, "done": 0, "failed": 0 },
  "errors": [
    { "index": 1, "sku": "MUG-02", "error": "The price field must be a number." }
  ],
  "started_at": null,
  "finished_at": null,
  "created_at": "2026-09-18T09:02:11+00:00"
}

{
  "status": "error",
  "message": "There are already 3 imports in progress for this account: wait for one to finish (check GET /api/products/imports/{import_id})."
}