Obtener estado de importación#

El endpoint de estado devuelve el trabajo de importación actual o más reciente para la tienda.

http

GET https://sdkapi.ideal.house/product-import/products/status?shopId=<SHOP_ID>

Parámetros de consulta#

Campo	Tipo	Obligatorio	Restricciones	Descripción
`shopId`	string	Sí	Máximo 64 caracteres	Shop ID utilizado cuando se envió el lote.

Ejemplo cURL#

bash

curl --request GET \
  'https://sdkapi.ideal.house/product-import/products/status?shopId=shop_123' \
  --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
  --header 'X-Client-Secret: <YOUR_CLIENT_SECRET>'

Campos de respuesta#

Campo	Tipo	Descripción
`jobId`	string	Identificador del trabajo de importación.
`shopId`	string	Tienda asociada con el trabajo.
`status`	string	Uno de `pending`, `running`, `completed` o `failed`.
`totalCount`	number	Número total de productos enviados.
`processedCount`	number	Número de productos procesados hasta ahora.
`successCount`	number	Número de productos creados o actualizados exitosamente.
`failedCount`	number	Número de productos que fallaron durante el procesamiento a nivel de ítem.
`failures`	array	Fallos a nivel de ítem. Vacío cuando no han ocurrido fallos a nivel de ítem.
`createdAt`	string	Hora de creación del trabajo en formato ISO 8601.
`startedAt`	string or null	Hora de inicio del procesamiento en formato ISO 8601.
`updatedAt`	string	Hora de la última actualización del trabajo en formato ISO 8601.
`completedAt`	string or null	Hora de finalización en formato ISO 8601.
`error`	string or null	Error a nivel de trabajo. Normalmente solo se rellena cuando `status` es `failed`.

processedCount es igual a successCount + failedCount.

successCount confirma que el producto fue creado o actualizado en el catálogo. Esto no necesariamente significa que el procesamiento de imágenes haya tenido éxito o que el producto esté inmediatamente disponible para su visualización.

Cada objeto en failures contiene:

Campo	Tipo	Descripción
`index`	number	Posición basada en cero del producto en el array original `products`.
`sku`	string	SKU del producto fallido.
`message`	string	Descripción del fallo. No construya lógica de aplicación que dependa del texto exacto del mensaje.

Estados del trabajo#

Estado	Significado	Acción recomendada
`pending`	La solicitud fue aceptada y está esperando para comenzar.	Continuar haciendo polling.
`running`	Los productos se están procesando.	Continuar haciendo polling y usar los campos de conteo para mostrar el progreso.
`completed`	El lote terminó de procesarse. Algunos productos pueden haber fallado.	Verificar `failedCount` y `failures`.
`failed`	Un error a nivel de trabajo impidió que el lote se completara normalmente.	Revisar `error`, luego reintentar como se describe a continuación.

Trabajo completado con un fallo a nivel de ítem#

json

{
  "jobId": "1930000000000000000",
  "shopId": "shop_123",
  "status": "completed",
  "totalCount": 2,
  "processedCount": 2,
  "successCount": 1,
  "failedCount": 1,
  "failures": [
    {
      "index": 1,
      "sku": "SKU-10002",
      "message": "Unable to import the remote image"
    }
  ],
  "createdAt": "2026-07-21T06:30:00.000Z",
  "startedAt": "2026-07-21T06:30:00.010Z",
  "updatedAt": "2026-07-21T06:30:08.000Z",
  "completedAt": "2026-07-21T06:30:08.000Z",
  "error": null
}

Un estado completed significa que el flujo de trabajo del lote terminó; no significa que cada producto haya tenido éxito. Los fallos a nivel de ítem no detienen a otros productos en el mismo lote.