> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riqra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualización masiva de stock

> Permite actualizar el stock de múltiples variantes para un almacén específico en una sola petición.

> Este endpoint está en fase **ALPHA**, así que podría cambiar drásticamente en el futuro. Usar con precaución.



## OpenAPI

````yaml /api/openapi.json post /logistics/warehouses/{warehouseId}/stock/bulk
openapi: 3.1.0
info:
  title: Riqra API
  version: '1.0'
  contact:
    email: soporte@riqra.com
    url: https://www.riqra.com/
    name: Riqra Support
  description: >-
    Usando nuestra API puedes integrar tu ERP o tu sistema actual de
    administración con [Riqra](https://www.riqra.com/).
servers:
  - url: https://sandbox.api.riqra.com
    description: Sandbox
  - description: Producción
    url: https://api.riqra.com
security:
  - API Key: []
tags:
  - name: Almacenes
  - name: Banners
  - name: Categorías
  - name: Clientes
  - name: Clientes - Direcciones
  - name: Cobertura
  - name: Comercio
  - name: Cupones
  - name: Inventario
  - name: Líneas de Crédito
  - name: Lista de Precios
  - name: Lista de Precios - Precios
  - name: Marcas
  - name: Pedidos
  - name: Productos
  - name: Productos Sugeridos
  - name: Promociones
  - name: Stock
  - name: Subcategorías
  - name: Variantes
paths:
  /logistics/warehouses/{warehouseId}/stock/bulk:
    parameters:
      - schema:
          type: integer
        name: warehouseId
        in: path
        required: true
        description: El ID único del almacén donde se actualizará el stock.
    post:
      tags:
        - Stock
      summary: Actualización masiva de stock
      description: >-
        Permite actualizar el stock de múltiples variantes para un almacén
        específico en una sola petición.


        > Este endpoint está en fase **ALPHA**, así que podría cambiar
        drásticamente en el futuro. Usar con precaución.
      operationId: post-logistics-warehouse-warehouseId-stock-bulk
      requestBody:
        content:
          application/json:
            schema:
              type: array
              minItems: 1
              maxItems: 100
              items:
                $ref: '#/components/schemas/BulkUpdateVariantStockItem'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/BulkUpdateVariantStockResponseItem'
              examples:
                Éxito total:
                  value:
                    data:
                      - status: 204
                      - status: 204
                Éxito parcial:
                  value:
                    data:
                      - status: 204
                      - status: 400
                        message: Variant with id 101 not found
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest'
              examples:
                Almacén no encontrado:
                  value:
                    errors:
                      - message: Warehouse with id 2111 not found
                        code: 404
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest'
              examples:
                Estructura inválida:
                  value:
                    errors:
                      - message: 'Validation Error: "value" must be an array'
                        code: 422
                Mas de 100 items:
                  value:
                    errors:
                      - message: >-
                          Validation Error: "value" must contain less than or
                          equal to 100 items
                        code: 422
components:
  schemas:
    BulkUpdateVariantStockItem:
      type: object
      required:
        - variantId
        - quantity
      properties:
        variantId:
          type: integer
          description: ID de la variante del producto.
        quantity:
          type: integer
          description: La cantidad de stock a establecer.
    BulkUpdateVariantStockResponseItem:
      type: object
      required:
        - status
      properties:
        status:
          type: integer
          description: Código de estado HTTP del resultado para este ítem.
        message:
          type: string
          description: Mensaje informativo o de error.
    BadRequest:
      title: BadRequest
      type: object
      x-examples: {}
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              code:
                type:
                  - integer
                  - string
                deprecated: true
                description: Código referencial del error. No usar.
      description: ''
  securitySchemes:
    API Key:
      name: api-key
      type: apiKey
      in: header
      description: >-
        Todas las llamadas al API tienen que contener este header junto a la
        clave para poder autenticar y autorizar al cliente.

````