Cuando la cuenta tiene multiorigen no se debe usar available_quantity en el endpoint /items. El stock se gestiona por depósitos y hay endpoints específicos de User Products para eso: /user-products/{user_product_id}/stock/type/{seller_warehouse} (para depósitos del seller) o los endpoints de stock multiorigen. Actualizar available_quantity en /items será ignorado o devolverá error; hay que actualizar por ubicación (stores/warehouses) con los endpoints de User Products.

Para actualizar el stock por depósito use el endpoint PUT /user-products/{user_product_id}/stock/type/seller_warehouse:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"quantity": 10}' \
  https://api.mercadolibre.com/user-products/{user_product_id}/stock/type/seller_warehouse

Ese error aparece cuando el User Product no tiene stock inicializado o no tiene locations creadas; el recurso de stock no existe hasta que se crea el stock en las ubicaciones. La solución es crear las stock locations correspondientes mediante los endpoints de escritura de stock (usar seller_warehouse) antes de consultar.

Para consultar el stock de un User Product use el endpoint GET /user-products/{user_product_id}/stock:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
  https://api.mercadolibre.com/user-products/{user_product_id}/stock

El endpoint selling_address (/user-products/{id}/stock/type/selling_address) está habilitado solo para sitios como MLA y MLC. En sitios como MLM no está disponible; en esos casos debe usarse la gestión por seller_warehouse o el flujo multiorigen soportado para ese mercado. No existe el mismo flujo de selling_address para todas las regiones.

El endpoint PUT /user-products/{user_product_id}/stock/type/selling_address solo está disponible para MLA y MLC:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"quantity": 10}' \
  https://api.mercadolibre.com/user-products/{user_product_id}/stock/type/selling_address

Si la cuenta tiene multiorigen o stock por depósitos, /items PUT con available_quantity puede devolver 200 pero no actualizar el stock real. En cuentas con warehouse_management el stock se debe actualizar vía User Products (endpoint de stock por seller_warehouse); el API /items no modifica el stock en modo multiorigen.

Este es el endpoint PUT /items/{item_id} que devuelve 200 pero no actualiza el stock en cuentas multiorigen:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"available_quantity": 10}' \
  https://api.mercadolibre.com/items/{item_id}

La documentación indica que la creación/actualización de stock para multiwarehouse requiere crear stock locations asociadas al user_product mediante el endpoint de stock. Si faltan network_node_id o stock-locations, la operación falla; la creación de locations y su asociación debe realizarse antes de actualizar stock.

Para crear y asociar una stock location a un User Product use el endpoint POST /user-products/{user_product_id}/stock/type/seller_warehouse:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"store_id": "{store_id}", "network_node_id": "{network_node_id}", "quantity": 10}' \
  https://api.mercadolibre.com/user-products/{user_product_id}/stock/type/seller_warehouse

Ese mensaje indica que está usando un endpoint de selling_address no soportado para ese sitio. La capacidad de modificar selling_address existe solo en sitios como MLA/MLC; en otros sitios (ej. MLB) debe usar seller_warehouse o el endpoint de stock que corresponda al mercado.

En lugar del endpoint bloqueado de selling_address, use PUT /user-products/{user_product_id}/stock/type/seller_warehouse:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"quantity": 10}' \
  https://api.mercadolibre.com/user-products/{user_product_id}/stock/type/seller_warehouse

Verifique si el item tiene stock_locations o un user_product_id; luego consulte /user-products/{user_product_id}/stock. Si las locations muestran type:seller_warehouse entonces está en multiorigen y hay que actualizar por ubicación (seller_warehouse). No use available_quantity en /items si la cuenta está en multiorigen.

Para verificar si un User Product tiene stock locations y detectar el modelo de gestión use GET /user-products/{user_product_id}/stock:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
  https://api.mercadolibre.com/user-products/{user_product_id}/stock

La publicación fallará con errores (ej. validation error o stock-locations not found). Debe proveer stock_locations válidas (store_id, network_node_id) y asegurarse de que las tiendas/depósitos estén configurados para el seller antes de crear o actualizar items multiwarehouse.

Para publicar un item multiwarehouse con stock_locations correctamente incluidas use POST /user-products/{user_product_id}/stock/type/seller_warehouse:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "stock_locations": [
      {"store_id": "{store_id}", "network_node_id": "{network_node_id}", "quantity": 10}
    ]
  }' \
  https://api.mercadolibre.com/user-products/{user_product_id}/stock/type/seller_warehouse

Un 409 suele indicar conflictos por modificaciones concurrentes o colisiones en recursos (por ejemplo SKU o GTIN ya asociado a otro user_product) o intentos de crear recursos que ya existen. También puede deberse a cambios simultáneos sobre la misma clave.

El error 409 puede ocurrir al intentar crear un User Product con POST /user-products usando un SKU o GTIN ya existente:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"sku": "{sku}", "gtin": "{gtin}"}' \
  https://api.mercadolibre.com/user-products

En algunos sitios la actualización de stock por selling_address para Flex no está habilitada; en ML Brasil la opción suele estar bloqueada y el stock de Full suele ser gestionado por Mercado Libre, por lo que no es modificable por la API del seller.

Para sitios donde selling_address no está habilitado en MLB, use PUT /user-products/{user_product_id}/stock/type/seller_warehouse:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"quantity": 10}' \
  https://api.mercadolibre.com/user-products/{user_product_id}/stock/type/seller_warehouse

Durante la sincronización multialmacén el marketplace puede pausar anuncios mientras procesa las locations y stock; este proceso es asíncrono y puede tardar más de un día en algunos casos, tras lo cual los anuncios se reactivan automáticamente si hay stock.

Para monitorear el estado del anuncio y verificar si sigue pausado use GET /items/{item_id}:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
  https://api.mercadolibre.com/items/{item_id}