> ## 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.

# Set prices for many SKUs

> Absolute SET of the price per (sku, price list). Each item sets either `price` (a flat unit price, or a manual override on a derived list) or `tiers` (the full quantity ladder); the one that is set replaces the other. Requires the `prices:write` scope. Prices reach shoppers through the commercial policy that selects the list. The request is 200 when structurally valid; each row carries its own status in the results array.



## OpenAPI

````yaml /desarrolladores/api/openapi.json post /prices/set
openapi: 3.1.0
info:
  title: Riqra Public API
  version: 1.0.0
  description: Programmatic access to a merchant's commerce data.
servers:
  - url: https://api-v2.riqra.com/public/v1
security: []
paths:
  /prices/set:
    post:
      tags:
        - Prices
      summary: Set prices for many SKUs
      description: >-
        Absolute SET of the price per (sku, price list). Each item sets either
        `price` (a flat unit price, or a manual override on a derived list) or
        `tiers` (the full quantity ladder); the one that is set replaces the
        other. Requires the `prices:write` scope. Prices reach shoppers through
        the commercial policy that selects the list. The request is 200 when
        structurally valid; each row carries its own status in the results
        array.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      sku:
                        type: string
                        minLength: 1
                        maxLength: 64
                        example: SKU-001
                        description: SKU of the product variant to price.
                      priceListId:
                        type: string
                        format: uuid
                        example: 0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b
                        description: >-
                          Price list to write to (UUID). List them via `GET
                          /prices/lists`.
                      price:
                        type: string
                        pattern: ^\d{1,15}(?:\.\d{1,4})?$
                        example: '12.50'
                        description: >-
                          Absolute unit price — a replacement value. On an
                          independent list it is the selling price; on a derived
                          list it is a manual override of the derived price.
                          Replaces any tier ladder stored for this SKU on the
                          list. Each item takes exactly one of `price` or
                          `tiers`.
                      tiers:
                        type: array
                        items:
                          type: object
                          properties:
                            minQty:
                              type: integer
                              minimum: 1
                              example: 1
                              description: First quantity of the tier (inclusive).
                            maxQty:
                              type:
                                - integer
                                - 'null'
                              minimum: 1
                              example: 11
                              description: >-
                                Last quantity of the tier (inclusive). `null`
                                only on the last tier, which is open-ended.
                            price:
                              type: string
                              pattern: ^\d{1,15}(?:\.\d{1,4})?$
                              example: '10.50'
                              description: >-
                                Unit price for quantities in this tier. Must be
                                greater than 0.
                          required:
                            - minQty
                            - maxQty
                            - price
                        minItems: 1
                        maxItems: 15
                        description: >-
                          Quantity tiers — the full ladder, replacing whatever
                          the SKU had on this list (including a flat price).
                          Starts at 1, contiguous, only the last tier
                          open-ended, at most 15 tiers. Each item takes exactly
                          one of `price` or `tiers`.
                    required:
                      - sku
                      - priceListId
                    oneOf:
                      - required:
                          - price
                      - required:
                          - tiers
                  minItems: 1
                  maxItems: 100
              required:
                - items
      responses:
        '200':
          description: Per-row results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PriceSetResponse'
        '400':
          description: Invalid request body.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Missing required scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - BearerAuth: []
components:
  schemas:
    PriceSetResponse:
      type: object
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/PriceSetResult'
          description: One result per requested item, in request order.
      required:
        - results
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            requestId:
              type: string
          required:
            - code
            - message
            - requestId
      required:
        - error
    PriceSetResult:
      type: object
      properties:
        sku:
          type: string
          description: Echoes the requested SKU.
        priceListId:
          type: string
          description: Echoes the requested price list, as a canonical lowercase UUID.
        status:
          type: integer
          description: >-
            Per-row HTTP-style status: `200` on success, otherwise `404` or
            `409`.
          example: 200
        code:
          type: string
          description: >-
            Error code (error rows only): `SKU_NOT_FOUND`,
            `PRICE_LIST_NOT_FOUND`, or `PRICE_LIST_INACTIVE`.
        message:
          type: string
          description: Human-readable error detail (error rows only).
      required:
        - sku
        - priceListId
        - status
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Public API key presented as `Authorization: Bearer rq_live_…`.'

````