Actualizar productos (masivo)

curl --request POST \
  --url https://sandbox.external.cashea.app/v2/inventory/products/bulk-update/async \
  --header 'Authorization: ApiKey TU_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "products": [
      { "sku": "TEST-SKU-00112", "price": 459.90, "stock": 30 },
      { "sku": "TEST-SKU-00113", "bestInstallmentPlan": 12, "clearDiscount": true }
    ]
  }'

{
  "data": {
    "jobId": "b2f6e8a0-c5d3-4f0a-9c8d-1e2f3a4b5c6d",
    "status": "PENDING"
  }
}

POST

https://sandbox.external.cashea.app

inventory

products

bulk-update

async

curl --request POST \
  --url https://sandbox.external.cashea.app/v2/inventory/products/bulk-update/async \
  --header 'Authorization: ApiKey TU_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "products": [
      { "sku": "TEST-SKU-00112", "price": 459.90, "stock": 30 },
      { "sku": "TEST-SKU-00113", "bestInstallmentPlan": 12, "clearDiscount": true }
    ]
  }'

{
  "data": {
    "jobId": "b2f6e8a0-c5d3-4f0a-9c8d-1e2f3a4b5c6d",
    "status": "PENDING"
  }
}

Actualiza uno o varios productos de forma asíncrona, identificándolos por sku. Encola un job y responde 202 con un jobId; el resultado se consulta con GET /v2/inventory/jobs/{jobId}. Es una actualización parcial: solo se aplican los campos presentes en cada ítem, el resto queda intacto. El único campo obligatorio es sku.

Campos que no se pueden actualizar por esta vía: categoryUuid, brand, model y commercialBrands. Se definen al crear el producto; enviarlos devuelve 400.

Límites: entre 1 y 1.000 productos por request, sin sku repetidos dentro del mismo body.

Authorization

string

requerido

Formato: ApiKey TU_API_KEY

Body Parameters

object[]

requerido

Lista de productos a actualizar.

Ocultar producto

string

requerido

Identifica el producto a actualizar (1–64 caracteres).

string

Título (máx. 256 caracteres).

string

Descripción (máx. 5000 caracteres).

number

Precio.

string

Valores permitidos: NEW (nuevo), USED (usado), REFURBISHED (reacondicionado).

boolean

Si es digital, shippable debe ser false.

boolean

Si es enviable.

number

Peso en kilogramos (kg).

number

Altura en metros.

number

Ancho en metros.

number

Largo en metros.

integer

Garantía en días.

integer

Unidades disponibles.

integer

Máximo de cuotas: 3, 6, 9 o 12.

boolean

true: el producto aparece en el buscador del marketplace. false: queda cargado, pero no aparece en el buscador.

number

Precio con descuento (menor a price).

string

Formato ISO 8601. Vigencia del descuento.

string

Formato ISO 8601. Debe ser posterior a discountStartDate.

boolean

true elimina el descuento vigente. No combinable con priceAfterDiscount ni con las fechas de descuento.

string[]

1 a 5 URLs válidas y únicas. Una lista no vacía reemplaza las imágenes actuales; una lista vacía u omitida no cambia nada.

object[]

Pares attributeId / valueId de la categoría del producto. Una lista no vacía reemplaza los atributos; una lista vacía u omitida no cambia nada.

Response

object

Ocultar job

string

ID del job. Se usa para consultar el resultado con GET /v2/inventory/jobs/{jobId}.

string

Estado inicial del job: PENDING.

Errors

La respuesta 202 solo confirma que el job se encoló. Los fallos por producto no llegan como error HTTP: se consultan con GET /v2/inventory/jobs/{jobId}.

Código	Descripción
`400`	Body inválido. Por ejemplo, enviar `categoryUuid`, `brand`, `model` o `commercialBrands`, que no se pueden actualizar.

curl --request POST \
  --url https://sandbox.external.cashea.app/v2/inventory/products/bulk-update/async \
  --header 'Authorization: ApiKey TU_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "products": [
      { "sku": "TEST-SKU-00112", "price": 459.90, "stock": 30 },
      { "sku": "TEST-SKU-00113", "bestInstallmentPlan": 12, "clearDiscount": true }
    ]
  }'

{
  "data": {
    "jobId": "b2f6e8a0-c5d3-4f0a-9c8d-1e2f3a4b5c6d",
    "status": "PENDING"
  }
}

Primeros pasos

APIs

Authorization

Body Parameters

Response

Errors

​Authorization

​Body Parameters

​Response

​Errors

Authorization

Body Parameters

Response

Errors