openapi: 3.0.2
info:
  title: Article Requirements AnnouncedReturns prices API
  version: 1.0.0
  x-audience: external-merchant
  x-api-id: e655a9cb-4cda-466d-a552-13a50c4b02ae
  description: 'This API provides endpoints to retrieve UAF article requirement outlines, attribute types, and attribute values for a given business partner. This API is in pilot phase and only available to a limited set of partners.

    '
tags:
- name: prices
paths:
  /merchants/{merchant-id}/prices:
    post:
      tags:
      - prices
      summary: Sets the Prices for a list of Products.
      security:
      - merchant_platform:
        - products/price/write
      parameters:
      - name: merchant-id
        description: The ID of the Merchant.
        in: path
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        description: The request for processing a list of Product Price Updates.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PriceUpdateRequest'
      responses:
        207:
          description: 'The requested Product Price changes have been processed. Please consult the response body for status information.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PriceUpdateResponse'
        default:
          description: Error occurred. See status code and problem object for more information.
          content:
            application/problem+json:
              schema:
                $ref: https://opensource.zalando.com/problem/schema.yaml#/Problem
components:
  schemas:
    PriceUpdateRequest:
      type: object
      description: The request for processing a list of Product Price Updates.
      required:
      - product_prices
      properties:
        product_prices:
          type: array
          items:
            $ref: '#/components/schemas/ProductPrice'
    IgnoreWarnings:
      type: boolean
      description: When this flag is true, the price update will be applied ignoring the warnings (but not the errors) generated from the validation engine.
      example: false
    PriceUpdateResponse:
      type: object
      description: The result of processing a list of Product Price Updates.
      properties:
        results:
          type: array
          items:
            type: object
            description: The result of processing a Product Price Update.
            properties:
              product_price:
                $ref: '#/components/schemas/ProductPriceResult'
              status:
                $ref: '#/components/schemas/BasePriceStatus'
              code:
                $ref: '#/components/schemas/BasePriceCode'
              description:
                $ref: '#/components/schemas/Description'
            required:
            - product_price
            - status
            - code
      required:
      - results
    ScheduleCode:
      type: integer
      format: int32
      x-extensible-enum:
      - 0
      - 101
      - 102
      - 106
      - 107
      - 108
      description: 'Machine readable status code.

        -   0: Update Successful

        - 101: Validation failed

        - 102: Submission failed due to internal errors

        - 106: Update failed because some prices were less than minimum threshold

        - 107: Update failed becaues some prices were more than maximum threshold

        - 108: Update failed because discount exceeded max discount

        '
    ProductPriceResult:
      type: object
      description: The result of the Product Price.
      properties:
        ean:
          type: string
          format: gtin13
          description: Global Trade Item Number (GTIN-13)
          example: '5901234123457'
        sales_channel_id:
          type: string
          format: uuid
          example: fc0aba96-7802-11e5-9e27-10ddb1ee7671
        regular_price:
          $ref: '#/components/schemas/RegularPrice'
        promotional_price:
          $ref: '#/components/schemas/PromotionalPrice'
        scheduled_prices:
          type: array
          items:
            $ref: '#/components/schemas/ScheduledPriceResult'
        ignore_warnings:
          $ref: '#/components/schemas/IgnoreWarnings'
      required:
      - ean
      - sales_channel_id
      - regular_price
      - ignore_warnings
    ScheduledPrice:
      type: object
      description: Represents a scheduled price update for a given EAN and Sales Channel Id.
      properties:
        regular_price:
          $ref: '#/components/schemas/RegularPrice'
        promotional_price:
          $ref: '#/components/schemas/PromotionalPrice'
        start_time:
          $ref: '#/components/schemas/ScheduledPriceStartTime'
        end_time:
          $ref: '#/components/schemas/ScheduledPriceEndTime'
      required:
      - regular_price
      - start_time
    ProductPrice:
      type: object
      description: A Product Price object.
      properties:
        ean:
          type: string
          format: gtin13
          description: Global Trade Item Number (GTIN-13)
          example: '5901234123457'
        sales_channel_id:
          type: string
          format: uuid
          example: fc0aba96-7802-11e5-9e27-10ddb1ee7671
        regular_price:
          $ref: '#/components/schemas/RegularPrice'
        promotional_price:
          $ref: '#/components/schemas/PromotionalPrice'
        scheduled_prices:
          type: array
          items:
            $ref: '#/components/schemas/ScheduledPrice'
      required:
      - ean
      - sales_channel_id
      - regular_price
    BasePriceStatus:
      type: string
      x-extensible-enum:
      - ACCEPTED
      - PARTIALLY_ACCEPTED
      - REJECTED
      - FAILED
      description: 'Indicates result of the Product Price Update.

        - ACCEPTED indicates a successful submission of the base price and all the scheduled prices (if provided).

        - PARTIALLY_ACCEPTED indicates a successful submission of the base price, but the scheduled_prices field must be checked since there are schedules that were REJECTED or FAILED.

        - REJECTED indicates validation errors for the base price, where a detailed description can be found in the `description` field. All scheduled prices (if provided) will be ignored and marked as REJECTED.

        - FAILED indicates a failed submission for the base price due to internal errors. All scheduled prices (if provided) will be ignored and marked as FAILED.

        In case an unlisted status is received it must be treated as `FAILED`.

        '
    ScheduleStatus:
      type: string
      x-extensible-enum:
      - ACCEPTED
      - REJECTED
      - FAILED
      description: 'Indicates result of the Schedule.

        - ACCEPTED indicates a successful submission of the schedule.

        - REJECTED indicates validation errors for the schedule. If one schedule is REJECTED due to validation errors, all schedules for this EAN and Sales Channel Id will be rejected.

        - FAILED indicates a failed submission of the schedule due to internal errors.

        In case an unlisted status is received it must be treated as `FAILED`.

        '
    Description:
      type: string
      description: Detailed error message regarding the status.
    Timestamp:
      type: string
      format: date-time
      example: '2020-05-30T00:00:00.00Z'
      description: 'Timestamp in ISO-8601 extended date-time format with an offset from UTC, as defined by https://tools.ietf.org/html/rfc3339#section-5.6.

        Supports resolution up to a microsecond.


        See:

        * https://tools.ietf.org/html/rfc3339#section-5.6

        * https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations

        * https://en.wikipedia.org/wiki/ISO_8601#Time_offsets_from_UTC

        '
    Money:
      type: object
      description: Used to represent Regular Price & Promotional Price
      properties:
        amount:
          type: number
          description: Amount expressed as a decimal number of major currency units
          format: decimal
          minimum: 0.01
          example: 89.95
        currency:
          type: string
          description: 3 letter currency code as defined by ISO-4217
          format: iso-4217
          example: EUR
      required:
      - amount
      - currency
    ScheduledPriceStartTime:
      allOf:
      - $ref: '#/components/schemas/Timestamp'
      - description: 'Timestamp (in format defined by https://tools.ietf.org/html/rfc3339#section-5.6) indicating when the scheduled price should start.

          '
    PromotionalPrice:
      allOf:
      - $ref: '#/components/schemas/Money'
      - description: Promotional price, described as decimal number. Must be less than regular price.
    ScheduledPriceEndTime:
      allOf:
      - $ref: '#/components/schemas/Timestamp'
      - description: 'Timestamp (in format defined by https://tools.ietf.org/html/rfc3339#section-5.6) indicating when the scheduled price should end.

          If this field is not provided, then the scheduled price will remain active until it is replaced by another price update or overwritten by another schedule.

          '
    BasePriceCode:
      type: integer
      format: int32
      x-extensible-enum:
      - 0
      - 101
      - 102
      - 103
      - 104
      - 105
      - 106
      - 107
      - 108
      description: 'Machine readable status code.

        -   0: Update Successful

        - 101: Validation failed

        - 102: Submission failed due to internal errors

        - 103: Merchant is not active in this Sales Channel

        - 104: Update pending - waiting for the EAN to be onboarded

        - 105: Update Partially Successful - Base Price accepted, check the `scheduled_prices` field for the results of the scheduled price updates

        - 106: Update failed because some prices were less than minimum threshold

        - 107: Update failed becaues some prices were more than maximum threshold

        - 108: Update failed because discount exceeded max discount

        '
    RegularPrice:
      allOf:
      - $ref: '#/components/schemas/Money'
      - description: Regular, non-promotional price, described as decimal number.
    ScheduledPriceResult:
      type: object
      description: The result of a scheduled price update for a given EAN and Sales Channel Id.
      properties:
        scheduled_price:
          $ref: '#/components/schemas/ScheduledPrice'
        status:
          $ref: '#/components/schemas/ScheduleStatus'
        code:
          $ref: '#/components/schemas/ScheduleCode'
        description:
          $ref: '#/components/schemas/Description'
      required:
      - scheduled_price
      - status
      - code