openapi: 3.2.0
info:
  title: ShopBase Internal Product API
  termsOfService: http://swagger.io/terms/
  version: 1.0.0
  contact:
    url: /
    email: support@shopbase.com
  license:
    name: ShopBase Dev 1.0
    url: https://www.shopbase.net
  x-logo:
    url: https://admin-cdn.shopbase.com/img/Compact.ac400184.svg
  description: The Product resource lets you update and create products in a merchant's store. You can use product variants with the Product resource to create or update different versions of the same product. You can also add or update product images. </br></br>You can add products to collections with the CustomCollection resource and the SmartCollection resource
servers:
- url: https://shop-name.onshopbase.com
tags:
- description: The Product resource lets you update and create products in a merchant's store. You can use product variants with the Product resource to create or update different versions of the same product. You can also add or update product images. </br></br>You can add products to collections with the CustomCollection resource and the SmartCollection resource
  name: Product
paths:
  /admin/products.json:
    get:
      summary: Retrieves a list of products.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductsSwaggerResponse'
      parameters:
      - name: ids
        description: Return only certain products, specified by a comma-separated list of product IDs.
        in: query
        required: false
        schema:
          type: string
      - name: limit
        description: 'Return up to this many results per page. (default: 50, maximum: 250).'
        in: query
        required: false
        schema:
          type: integer
      - name: since_id
        description: Restrict results to after the specified ID.
        in: query
        required: false
        schema:
          type: integer
      - name: title
        description: Filter results by product title.
        in: query
        required: false
        schema:
          type: string
      - name: vendor
        description: Filter results by vendor.
        in: query
        required: false
        schema:
          type: string
      - name: handle
        description: Filter results by handle.
        in: query
        required: false
        schema:
          type: string
      - name: product_type
        description: Filter results by product type.
        in: query
        required: false
        schema:
          type: string
      - name: collection_id
        description: Filter results by product collection ID.
        in: query
        required: false
        schema:
          type: integer
      - name: created_at_min
        description: 'Show products created after date. (format: 2014-04-25T16:15:47-04:00)'
        in: query
        required: false
        schema:
          type: string
      - name: created_at_max
        description: 'Show products created before date. (format: 2014-04-25T16:15:47-04:00)'
        in: query
        required: false
        schema:
          type: string
      - name: updated_at_min
        description: 'Show products last updated after date. (format: 2014-04-25T16:15:47-04:00)'
        in: query
        required: false
        schema:
          type: string
      - name: updated_at_max
        description: 'Show products last updated before date. (format: 2014-04-25T16:15:47-04:00)'
        in: query
        required: false
        schema:
          type: string
      - name: published_at_min
        description: 'Show products published after date. (format: 2014-04-25T16:15:47-04:00)'
        in: query
        required: false
        schema:
          type: string
      - name: published_at_max
        description: 'Show products published before date. (format: 2014-04-25T16:15:47-04:00)'
        in: query
        required: false
        schema:
          type: string
      - name: published_status
        description: 'Return products by their published status. (default: any), published: Show only published products. unpublished: Show only unpublished products. any: Show all products.'
        in: query
        required: false
        schema:
          type: string
      - name: fields
        description: Show only certain fields, specified by a comma-separated list of field names.
        in: query
        required: false
        schema:
          type: string
      - name: presentment_currencies
        description: Return presentment prices in only certain currencies, specified by a comma-separated list of ISO 4217 currency codes.
        in: query
        required: false
        schema:
          type: string
      - name: sort_field
        description: Sort result-set in ascending or descending order by that field.
        in: query
        required: false
        schema:
          type: string
      - name: sort_mode
        description: 'Ascending or descending order. (default: asc)'
        in: query
        required: false
        schema:
          type: string
      tags:
      - Product
      operationId: get-all-products
      security:
      - APP_ACCESS_TOKEN:
        - read_products
    delete:
      summary: Delete multi product.
      description: Delete multi product along with all its variants and images by ids
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductDeleteMultiSwaggerResponse'
      parameters:
      - name: ids
        description: Product id
        in: path
        required: true
        schema:
          type: integer
      tags:
      - Product
      operationId: delete-multi-products
      security:
      - APP_ACCESS_TOKEN:
        - write_products
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductDeleteMultiSwaggerRequest'
              description: Product delete multi struct
        description: Product delete multi struct
        required: true
    post:
      summary: Create a new product.
      description: Create a new product.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductSwaggerResponse'
      tags:
      - Product
      operationId: create-a-product
      security:
      - APP_ACCESS_TOKEN:
        - write_products
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductSwaggerRequest'
              description: Product request
        description: Product request
        required: true
    patch:
      summary: Patch multiple product.
      description: Patch multi product by options
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatchProductResponseSwagger'
      tags:
      - Product
      operationId: patch-multiple-product
      security:
      - APP_ACCESS_TOKEN:
        - write_products
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductPatchRequest'
              description: Patch request
        description: Patch request
        required: true
  /admin/products/collections.json:
    get:
      summary: Retrieves a list of products of a collection.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductsByCollectionSwaggerResponse'
      tags:
      - Product
      operationId: get-products-by-collection-id
      security:
      - APP_ACCESS_TOKEN:
        - read_products
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/handlers.ProductRequest'
              description: Product request
        description: Product request
  /admin/products/count.json:
    get:
      summary: Retrieves a count of products.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CountResponse'
      parameters:
      - name: vendor
        description: Filter results by product vendor.
        in: query
        required: false
        schema:
          type: string
      - name: product_type
        description: Filter results by product type.
        in: query
        required: false
        schema:
          type: string
      - name: collection_id
        description: Filter results by collection ID.
        in: query
        required: false
        schema:
          type: integer
      - name: created_at_min
        description: 'Show products created after date. (format: 2014-04-25T16:15:47-04:00)'
        in: query
        required: false
        schema:
          type: string
      - name: created_at_max
        description: 'Show products created before date. (format: 2014-04-25T16:15:47-04:00)'
        in: query
        required: false
        schema:
          type: string
      - name: updated_at_min
        description: 'Show products last updated after date. (format: 2014-04-25T16:15:47-04:00)'
        in: query
        required: false
        schema:
          type: string
      - name: updated_at_max
        description: 'Show products last updated before date. (format: 2014-04-25T16:15:47-04:00)'
        in: query
        required: false
        schema:
          type: string
      - name: published_at_min
        description: 'Show products published after date. (format: 2014-04-25T16:15:47-04:00)'
        in: query
        required: false
        schema:
          type: string
      - name: published_at_max
        description: 'Show products published before date. (format: 2014-04-25T16:15:47-04:00)'
        in: query
        required: false
        schema:
          type: string
      - name: published_status
        description: Return products by their published status
        in: query
        required: false
        schema:
          type: string
      tags:
      - Product
      operationId: get-count-of-all-products
      security:
      - APP_ACCESS_TOKEN:
        - read_products
  /admin/products/tags.json:
    get:
      summary: Get tags from products
      description: Get tags from products
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseProductTagsDto'
      parameters:
      - name: limit
        description: returns the number of tags want to display.
        in: query
        required: false
        schema:
          type: integer
      tags:
      - Product
      operationId: get-all-tag-of-product-in-shop
      security:
      - APP_ACCESS_TOKEN:
        - read_products
  /admin/products/types.json:
    get:
      summary: Get all types from all products
      description: Get all types from all products
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductGetTypesSwaggerResponse'
      parameters:
      - name: limit
        description: returns the up to this many results
        in: query
        required: false
        schema:
          type: integer
      tags:
      - Product
      operationId: get-all-types-of-products-in-shop
      security:
      - APP_ACCESS_TOKEN:
        - read_products
  /admin/products/vendors.json:
    get:
      summary: Get all vendors from all products
      description: Get all vendors from all products
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductGetVendorsSwaggerResponse'
      parameters:
      - name: limit
        description: returns the up to this many results
        in: query
        required: false
        schema:
          type: integer
      tags:
      - Product
      operationId: get-all-vendors-of-products-in-shop
      security:
      - APP_ACCESS_TOKEN:
        - read_products
  /admin/products/{product_id:(?:\\d+)}.json:
    get:
      summary: Retrieves a single product.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseProductDto'
      parameters:
      - name: product_id
        description: Product ID.
        in: path
        required: true
        schema:
          type: integer
      - name: fields
        description: A comma-separated list of fields to include in the response.
        in: query
        required: false
        schema:
          type: string
      tags:
      - Product
      operationId: get-detail-of-a-product
      security:
      - APP_ACCESS_TOKEN:
        - read_products
  /admin/products/{product_id:[0-9]+}/remove_mapping.json:
    delete:
      summary: Remove mapping of single product from a fulfillment service.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductRemoveMappingResponse'
      parameters:
      - name: app_code
        description: 'App code, eg: alidropcon, phub...'
        in: query
        required: true
        schema:
          type: string
      tags:
      - Product
      operationId: remove-product-mapping-with-fulfillment-services
      security:
      - APP_ACCESS_TOKEN:
        - write_products
  /admin/products/{product_id:[0-9]+}/reorder-options.json:
    put:
      summary: Reorder product variants
      description: Reorder product variants.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductSwaggerResponse'
      tags:
      - Product
      operationId: reorder-variant-of-product
      security:
      - APP_ACCESS_TOKEN:
        - write_products
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductReorderRequest'
              description: Product struct
        description: Product struct
        required: true
  /admin/products/{product_id}.json:
    delete:
      summary: Deletes a product.
      description: Delete a product along with all its variants and images
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SwaggerDeleteResponse'
      parameters:
      - name: product_id
        description: Product ID
        in: path
        required: true
        schema:
          type: integer
      tags:
      - Product
      operationId: delete-a-product
      security:
      - APP_ACCESS_TOKEN:
        - write_products
    put:
      summary: Updates a product.
      description: Updates a product and its variants and images.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductSwaggerResponse'
      parameters:
      - name: product_id
        description: Product ID
        in: path
        required: true
        schema:
          type: integer
      tags:
      - Product
      operationId: update-a-product
      security:
      - APP_ACCESS_TOKEN:
        - write_products
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductUpdateRequestSwagger'
              description: Product update request struct
        description: Product update request struct
        required: true
  /admin/products/{product_id}/variants/duplicate.json:
    post:
      summary: Duplicate product variants
      description: Duplicate product variants
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductVariantDuplicateResponseSwagger'
      tags:
      - Product
      operationId: duplicate--variants-of-a-product
      security:
      - APP_ACCESS_TOKEN:
        - write_products
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductVariantDuplicateRequest'
              description: Product variant duplicate request
        description: Product variant duplicate request
        required: true
components:
  schemas:
    APIResponseProductDto:
      properties:
        product:
          $ref: '#/components/schemas/ProductDto'
      type: object
    dto.Condition:
      properties:
        relation:
          type: string
          description: Condition relation
          example: equals
        value:
          type: string
          description: Condition value
          example: Hair
      type: object
    ProductDto:
      properties:
        body_html:
          type: string
          description: A description of the product. Supports HTML formatting.
          example: '<p>It''s the small iPod with a big idea: Video.<p>'
        can_preview:
          type: boolean
          description: This product can be previewed by personalize tool or not
        collection_ids:
          items:
            type: integer
          type: array
        created_at:
          type: integer
          description: Created at time
        custom_options:
          items:
            $ref: '#/components/schemas/dto.CustomOption'
          type: array
        display_options:
          $ref: '#/components/schemas/DisplayOptions'
        fulfillment_services:
          items:
            $ref: '#/components/schemas/FulfillmentService'
          type: array
        handle:
          type: string
          description: A unique human-friendly string for the product. Automatically generated from the product's `title`. Used by the Liquid templating language to refer to objects.
          example: ipod-nano-8gb
        id:
          type: integer
          description: A unique numeric identifier for the product. Each id is unique across the ShopBase system. No two products will have the same id, even if they're from different shops.
          example: 632910392
        image:
          $ref: '#/components/schemas/gitlab.ProductImage'
        images:
          items:
            $ref: '#/components/schemas/gitlab.ProductImage'
          type: array
        metafields_global_description_tag:
          type: string
          description: A description of the product used for SEO purposes. Generally added to the <meta name='description'> tag.
          example: 'It''s the small iPod with a big idea: Video.'
        metafields_global_title_tag:
          type: string
          description: The name of the product used for SEO purposes. Generally added to the  <meta name='title'> tag.
          example: IPod Nano - White, 8GB
        options:
          items:
            $ref: '#/components/schemas/dto.ProductOption'
          type: array
        product_availability:
          type: integer
          description: '1. Available in all channels

            2. Hide from the sitemap.txt

            3. Hide from online store listing pages (homepage, collection pages, search page,...)

            0. Hide from all channels'
          example: 7
        product_type:
          type: string
          description: A categorization for the product used for filtering and searching products.
          example: Cult Products
        published:
          type: boolean
          description: Published or not
          example: true
        published_at:
          type: integer
          description: The date and time (ISO 8601 format) when the product was published. Can be set to null to unpublish the product from the Online Store channel.
        tags:
          type: string
          description: A string of comma-separated tags that are used for filtering and search. A product can have up to 250 tags. Each tag can have up to 255 characters.
          example: Emotive, Flash Memory, MP3, Music
        title:
          type: string
          description: The name of the product.
          example: IPod Nano - 8GB
        updated_at:
          type: integer
          description: Updated at time
        variants:
          items:
            $ref: '#/components/schemas/ProductVariantRequestWithOptionValueDto'
          type: array
        vendor:
          type: string
          description: The name of the product's vendor.
          example: Apple
      type: object
    ProductSwaggerResponse:
      properties:
        product:
          $ref: '#/components/schemas/ProductDto'
      type: object
    dto.CustomOption:
      properties:
        active:
          type: boolean
          description: Check whether option is active or not
          example: true
        default_value:
          type: string
          description: Prefill on storefront
          example: default value
        default_value_index:
          type: integer
          description: Index of default value in list values
          example: 1
        font_family:
          type: string
          description: Custom font family style
          example: arial
        font_path:
          type: string
          description: Path to font resource
          example: https://example.com/font_path.tff
        help_text:
          type: string
          description: Custom help text
          example: example
        id:
          type: string
          description: Custom option ID
          example: '123443'
        label:
          type: string
          description: Custom label, displayed on storefront
          example: example label
        layer_name:
          type: string
          description: Layer name
        name:
          type: string
          description: Custom name
          example: example name
        placeholder:
          type: string
          description: Custom placeholder
          example: example
        rules:
          items:
            $ref: '#/components/schemas/dto.Rule'
          type: array
          description: This fields is in progress...
        type:
          type: string
          description: 'Custom type

            </br>**text**: Text field type

            </br>**textarea**: Text area type

            </br>**file**: File type

            </br>**radio**: Radio type

            </br>**select**: Select type

            </br>**checkbox**: Checkbox type

            </br>**picture**: Picture type'
          example: text
        validations:
          $ref: '#/components/schemas/dto.CustomOptionValidations'
          description: List validations
        values:
          items:
            $ref: '#/components/schemas/dto.CustomOptionValue'
          type: array
          description: List option value
      type: object
    ProductVariantRequestWithOptionValueDto:
      properties:
        barcode:
          type: string
          description: The code of variant for easy managing
          example: 9 788073 400972
        body_html:
          type: string
        compare_at_price:
          type: number
          description: The price compare with
          example: 200
        cost_per_item:
          type: number
        fulfillment_service:
          type: string
          description: The name of fulfillment
          example: Shop base fulfillment
        id:
          type: integer
          description: A unique numeric identifier for the product variant. Each id is unique across the ShopBase system. No two products variant will have the same id, even if they're from different shops.
          example: 632910392
        image_id:
          type: integer
          description: The unique numeric identifier for a product's image. The image must be associated to the same product as the variant.
          example: 434522
        image_ids:
          type: string
        inventory_management:
          type: string
          description: The name of inventory management
          example: shopbase
        inventory_policy:
          type: string
          description: 'Whether customers are allowed to place an order for the product variant when it''s out of stock. Valid values

            * **deny**:  Customers are not allowed to place orders for the product variant if it''s out of stock

            * **continue**:  Customers are allowed to place orders for the product variant if it''s out of stock.'
        inventory_quantity:
          type: integer
          description: The quantity in inventory.
          example: 100
        is_default:
          type: boolean
          description: Option to decide that this variant is default or not
          example: true
        metafields:
          items:
            $ref: '#/components/schemas/MetaField'
          type: array
        option1:
          type: string
          description: A unique identifier for the product variant in the shop. Required in order to connect to a FulfillmentService
          example: IPOD2008PINK
        position:
          type: integer
          description: The position of variant.
          example: 1
        price:
          type: number
          description: The price of variant.
          example: 100
        product_id:
          type: integer
          description: A unique numeric identifier for the product. Each id is unique across the ShopBase system. No two products will have the same id, even if they're from different shops.
          example: 632910392
        requires_shipping:
          type: boolean
          description: Whether a customer needs to provide a shipping address when placing an order for the product variant.
          example: true
        sku:
          type: string
          description: The Metafield resource allows you to add additional information to other Admin API resources. Present, we don't use this field. We use table metafield instead.
          example: 'null'
        sync_cache_time:
          type: integer
        taxable:
          type: boolean
          description: Whether a tax is charged when the product variant is sold.
          example: true
        title:
          type: string
          description: The name of the product.
          example: IPod Nano - 8GB
        updated_at:
          type: integer
        weight:
          type: number
          description: Weight of product
          example: 12
        weight_unit:
          type: string
          description: unit of weight
          example: '12'
      type: object
    ProductReorderOptionItem:
      properties:
        id:
          type: integer
          description: Id of product option set
          example: 100
        values:
          items:
            type: string
          type: array
          description: List of product option value.
          example:
          - Red
          - ' Blue'
          - ' Green'
      type: object
    dto.ProductOption:
      properties:
        id:
          type: integer
          description: Id of product option set
          example: 1002
        name:
          type: string
          description: Name of product option set
          example: color
        position:
          type: integer
          description: The order of the product image in the list. The first product image is at position 1 and is the main image for the product.
          example: 1
        product_id:
          type: integer
          description: The id of the product associated with the image.
          example: 632910392
        values:
          items:
            type: string
          type: array
          description: List of product option
          example:
          - red
          - ' blue'
          - ' green'
      type: object
    APIResponseProductTagsDto:
      properties:
        success:
          type: boolean
          description: This field is request api success
          example: true
        tags:
          items:
            type: string
          type: array
          description: This field is request api success
          example:
          - tag1
          - tag2
          - tag3
      type: object
    ProductsSwaggerResponse:
      properties:
        products:
          items:
            $ref: '#/components/schemas/ProductDto'
          type: array
      type: object
    ProductVariantDuplicateResponseSwagger:
      properties:
        fail:
          items:
            type: integer
          type: array
          description: List of variant id duplicate failure
          example:
          - 100013905
        status:
          type: boolean
          description: 'Status of duplicate process: true or false'
          example: true
        success:
          items:
            type: integer
          type: array
          description: List of variant id duplicate successful
          example:
          - 100013903
          - 100013904
      type: object
    dto.CustomOptionValidations:
      properties:
        allowed_characters:
          items:
            type: string
          type: array
          description: 'List character is allowed

            </br>**characters**: Characters

            </br>**numbers**: Numbers

            </br>**symbol**: Special characters

            </br>**emoji**: Emoji'
          example:
          - symbol
        max_length:
          type: integer
          description: Maximum length
          example: 50
        min_size:
          type: number
          description: Maximum size
          example: 50
        required:
          type: boolean
          description: Check whether value is required or not
          example: true
      type: object
    ProductPatchRequest:
      properties:
        count_retry:
          type: integer
        data:
          $ref: '#/components/schemas/ProductPatchFields'
        dest_shop_id:
          type: integer
        exclude_ids:
          items:
            type: integer
          type: array
        has_custom_option:
          type: string
        has_image:
          type: string
        ids:
          items:
            type: integer
          type: array
        keep_current_product_id:
          type: boolean
        page:
          type: integer
        published_status:
          type: string
        shop_id:
          type: integer
        title:
          type: string
        title_mode:
          type: string
        type:
          type: string
      type: object
    ProductPatchFields:
      properties:
        add_collections:
          items:
            type: integer
          type: array
        add_tags:
          items:
            type: string
          type: array
        import_progress:
          items:
            type: string
          type: array
        published:
          type: boolean
        remove_collections:
          items:
            type: integer
          type: array
        remove_tags:
          items:
            type: string
          type: array
      type: object
    ProductDtoSwagger:
      properties:
        body_html:
          type: string
          description: A description of the product. Supports HTML formatting.
          example: '<p>It''s the small iPod with a big idea: Video.<p>'
        custom_options:
          items:
            $ref: '#/components/schemas/dto.CustomOption'
          type: array
          description: List of custom options
        display_options:
          $ref: '#/components/schemas/DisplayOptions'
          description: List of display options
        handle:
          type: string
          description: A unique human-friendly string for the product. Automatically generated from the product's `title`. Used by the Liquid templating language to refer to objects.
          example: ipod-nano-8gb
        images:
          items:
            $ref: '#/components/schemas/dto.ImageRequest'
          type: array
          description: List of images
        metafields_global_description_tag:
          type: string
          description: A description of the product used for SEO purposes. Generally added to the <meta name='description'> tag.
          example: 'It''s the small iPod with a big idea: Video.'
        metafields_global_title_tag:
          type: string
          description: The name of the product used for SEO purposes. Generally added to the  <meta name='title'> tag.
          example: IPod Nano - White, 8GB
        options:
          items:
            $ref: '#/components/schemas/dto.ProductOption'
          type: array
          description: List of options
        product_availability:
          type: integer
          description: '1. Available in all channels

            2. Hide from the sitemap.txt

            3. Hide from online store listing pages (homepage, collection pages, search page,...)

            0. Hide from all channels'
          example: 7
        product_type:
          type: string
          description: A categorization for the product used for filtering and searching products.
          example: Cult Products
        published:
          type: boolean
          description: Published or not
          example: true
        published_at:
          type: integer
          description: The date and time (ISO 8601 format) when the product was published. Can be set to null to unpublish the product from the Online Store channel.
        tags:
          type: string
          description: A string of comma-separated tags that are used for filtering and search. A product can have up to 250 tags. Each tag can have up to 255 characters.
          example: Emotive, Flash Memory, MP3, Music
        title:
          type: string
          description: The name of the product.
          example: IPod Nano - 8GB
        variants:
          items:
            $ref: '#/components/schemas/ProductVariantRequestWithOptionValueDtoSwagger'
          type: array
          description: List of variants
        vendor:
          type: string
          description: The name of the product's vendor.
          example: Apple
      type: object
    ProductDeleteMultiSwaggerRequest:
      properties:
        exclude_ids:
          items:
            type: integer
          type: array
          description: This field will exclude ids of product that want to keep.
          example:
          - 1
          - 2
          - 3
        type:
          type: string
          description: Use type for want delete all product with value default is all.
          example: all
      type: object
    ProductImageWithAttachment:
      properties:
        alt_text:
          type: string
          description: The text in alt property of image
          example: ipod-nano-xin
        attachment:
          type: string
          description: Base64 string of image
          example: R0lGODlhbgCMAPf/APbr48VySrxTO7IgKt2qmKQdJeK8lsFjROG5p/nz7Zg3\nMNmnd7Q1MLNVS9GId71hSJMZIuzTu4UtKbeEeakhKMl8U8WYjfr18YQaIbAf\nKKwhKdKzqpQtLebFortOOejKrOjZ1Mt7aMNpVbAqLLV7bsNqR+3WwMqEWenN\nsZYxL/Ddy/Pm2e7ZxLlUQrIjNPXp3bU5MbhENbEtLtqhj5ZQTfHh0bMxL7Ip\nNsNyUYkZIrZJPcqGdYIUHb5aPKkeJnoUHd2yiJkiLKYiKLRFOsyJXKVDO8up\nosFaS+TBnK4kKti5sNaYg/z49aqYl5kqLrljUtORfMOlo/36+H4ZH8yDYq0f\nKKFYTaU9MrY8MrZBNXwXHpgaIdGVYu/byLZNP9SaZLIyOuXCtHkpJst+Wpcm\nLMyCa8BfP9GMb9KQdPDd1PPk1sd5VP79/L5dQZ0bI9+ymqssK9WcfIoXHdzG\nxdWWfteib79lSr1YP86MYurQxKdcUKdMQr5ZSfPs6YEZH8uhl4oWIenMuurQ\nttmejaqoqsqBVaAcJLlJN5kvMLlZRMNsSL5fRak0LbdQQMVvSPjw6cJnRpkf\nKtmjhvfu5cJtT7IuOMVvWLY/M/37+o0YH9ibhtSYdObErc6HarM9NnYSGNGR\navLi09unje3WyeO8rsVrT7tdRtK3uffu6NWeaL9pTJIjJrM4NPbx8cdyX7M7\nPYYVHu7j4KgoNJAYIKtkV5o9MsOcldicis+RYNutfrhFOZ0hJbqinZ8bI8h5\nUObFuOfItJsfJrJfUOfIqc+PXqQtK8RnSbA4Mcd3Tm0SGbpXQ8aqp7RLNs+s\novHfzpVhV9iggMd1TLtbRKUdKXEQFsd4XrZRPLIgMZUeJ+jKvrAlK6AhJ65A\nMpMpKuC3j5obIsRwS7hAN8l/YtvDvnYXHbAoLI47SIUsOMenorF4gO/m4+fH\npo4vLZ8oKMukqp0cJbhVSMV2UuPR0bAfMLIrLrg/OcJwT8h+Vt+wn8eurLlh\nQrIfKHQOHHQOHf///////yH5BAEAAP8ALAAAAABuAIwAAAj/AP8JHDhQXjpz\n/PopXNiPn0OHDRMmbKhQIsOJFS1SxAhxI8SHFzVeDBnx48iNBAeeOkcxokeX\nFRdOnAlSokaaLXNujJkxo8iYHRkKtWkzZSsaOXkAWsoUECynsHgoqEW1qtVa\n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\nGg4lOnRGDKRZsoS7pMPSA6YXNWLsKJLkSZOVwKhMGSTTrJf9ZNKcomXKTrQY\nevr02cSIvKJxi6aJkaVuXaZMs1ziO5UqPawnuXK9AWEW2Jhja9pMuzMd27YW\nLNga10fuZYUPkdZdqpTv575YbJQbkCHw1sEpb9wQMstwWLFkbfppjJPc/wTI\nhHhJ5r0BBGbMRzfb7ez5MwwbpTMsx5pa9eob2CBM5yETpmzGtTE8hrybN29b\nc1oBn6trc9K7nhmUy6BcOUrn0KHLcr0FQvWYMxdnb3w7t/fvwFMiFvKG0uw8\n4kRLYjkGG0RtMPlWc+GGdyCwbwtYrOsHu7K0a+K/AEO04K0CF8InBvPOg2GE\nKpZTrsHSUotwwgnnmW4LHGGBKbb9bMqhsSly082CW0QMkDLLSvQHFQFiOESX\nLGzQpkUY22swA8Lko9EFLqfBEcdvMhRrwx610OLHtJ5Rc01ahHnCzTeFkXNO\nOfWQkwQ6NNFzTz2X0GQJQAMVdJEYsBhBAyrbK/9tgBcbrCTCG7bkkstvvvwm\nzPzI7JEcNLXDCYICQhXVkAIMMdWQd0x1Y9VdiuHGA1hjhfWQQzyg9dZDYmBg\nyioSVfRKFwfYZ8ZIJ3XhGhe83OLSSwEZU78ea+pUO2wK8MFaUUMl9dReDOll\n1VXbuYIZWWOl1dZDLpGhV3YZXLTR9vZhUMJijUX2mmveYRZcQDLlsCZOp21s\nCx+uLTjbbE/11ttv3diFkSHKRReGcthtN1hgrdxH2Awk5fJefK+ZZ9lvVvXW\n2cT+ZSwHgdHCpmCYDb4WYVNL7baXbsN9FdYYbKDA4otddBdYeffZx9iPjw35\nmmlKNtnUfmXSNNqAW9b/6eWYY8YWYW0V7tYQhxWAwwege61y6OXkbdDoSUFe\nWuR3wP3akKhjUtlHlqklG+YqsjaY620VNgQDMcQQouwrX3zR6KKFZfttyKtw\n+utQnRUL2mjLYjnvtLDpu9e9/ZYZ8FK3maLwwn8OmlF3lWNc7df3gfzteaZZ\n+NTKx5y6RxJ69/333mvBwHOLQ/fhiR2SV34HS47hmnAafJ9gh3AaDMcB7LE/\nIoPY441dhOzDz94VN3DPNmoeM5drAyfK7lWH34baYetVCidBIT6C5UMhB4r2\nn3FheSANRVGCwhBmObtlbgqXyYYNyuYFAMQFCtPwQf3spxAraGBRR+Af91wX\n/zsPoCIuCCAV13yAMsWo7zIOaJHFSHEZHZABdWK4X0JoIAENLIeDCXFA2rgX\nuwG8MC6kKGGoZuaDTEhtd/vBTBoyYLYqeAEzFpihGCagEBqIQQJVGMAOEdLD\n2L0uHJdBAMIOhsTELHExwLnS/i6zAQlIQItWxKIccejGL/4wjPvw4kHSQApA\nBhKQUDCiEWE2C93dTSEW2EMjaWABhbgnA3g8SAj4cElK+kMJWoyjBK6YECtw\nUgKZ7N8ejdZHfzjgGgNY5SpnZsisJXFHikwICTLBskzUECFtxJ/FFKKETmrx\nkwixQiclYAX+mfKUCpnBEZzpzHpkS2Yxm0ViMNcjhf+QABs5uKUuD9KoTOaP\nQb80picxaExk8lCZfIxLNuBhrWnurZpjoiVCbAkBbnrTH2pbTjgZVAVyGnOY\nBylmJ9P5xXWOUS6WEB3ZqgmTazLxMk40WntQub3lbIOc7OjkQP1RUI4e9CCl\nfJ3jjCbEogDAE6KrAiKlVs+4gJF7GUDlDLLnUWCyg6Ps8GgxdyrSVK5zH/WI\noARjZjFEQhSmRCEFg9SGSqIoQadT7alOJcAOoJJUmeFA6VBIETqk+ssPKizK\nDorxwx9CdShSvapOqzpVoO7ApMocgAdcIb74HeSroEOqEn8w1mgVRR0KyEEw\nKqoctTZEquzggFsVooepskP/DwqZAAfmakpGvc4HXSXF54CWVLthALASRYhB\nFpmDd4QxsQxRQmNd61HITnWyCVHC9MTnCsY9U7dH4AM8spGQvVrsiRB4Fg/8\ncFxsJmQDHvUHLQyhWsy01rXs2MFj2ZGC6862KKRgHGY6K9zlEPdyP8AJcteo\n3ClsQCHq0AF0QdkN+HbjlxygL31hO13tMrW7lwkB0BiUoR3x4EfmrYlCNjAF\nCRAoIWmwQexQqQcyxHe+9eXAfVOQAg7k16v7jQsAHGi2Bv0gUzyQQ05Ga+Cy\n0MBEDsZgN8gQ4QnXt7oJ0QOGOZACDTeEu0aTCwC80EKhDcAHMDGHWATMsuMC\nFsVl/9GnP0Jg0kw24MUv/qUTOGDlCj8WETfGsVx2vI+UzsATIFZUaTIRk3QY\n+ZYlFq0Ce5QJHBXgdU+MRCSwEYlVBCHPQZhyn7vhhD9fWdAc2DKhKXxhRCc6\n0Yi4LOPcl6hGVUFqc4gJLGaxufKO1s2VkrOj63znOkciCKMedZ+n7ARUp1rQ\niLAyIlyNYURcONaInrWs9ci4JyJOaFYawDzP8Q+ZwAICLckbgd08i290eh9V\nCIadQw3qO5Oa1H1GNRlSjeorO2HLruZ2rLudAm+Dm9Gxcx/GXmSIMbnjH5W2\nzy2RbOzM+cENBRAWs0N9b3zXWdp8pra1r61tbXdb4N/2Nv8i5gzeIJd5Gjui\nwT+AzQ9YVGrYnNO0Agm27GBkvNnNzje+921qf/+b1QEfuMDFPe5lk/lspUG3\nWKbQCofLBBBuwNEs3C3aikcrB2TTeM81HgmOd3zf/PZ3yFPNaqSXfODF0EDK\nE9e6liZmCvJwOLD7AQhU2efSbG6zm7VgiG1ofBc+//nGgZ7vbYw67aVux4v/\nfXSSK53by/HVrzIwDZTBBANUrzpMeAAIWASeB4P/AQ9+cHjEJx7xWgDE5nLQ\neMdHXvKbg/zkMZ23H/1oFRjYPOc9v3nQ58Aw0xn9LACvO7HQAOZVf/jl0ii1\nHcXe9bPX3euftaPL5R71tIf97nsy7/o0WlP2r4/JOU7B+r5nqva7jz1EdZ97\n4qNe+bonfvCfVXvly1762beOOdLBd+Q7PCAAOw==\n
        filename:
          type: string
          description: Name of file
          example: mylogo.jpg
        height:
          type: integer
          description: Height dimension of the image which is determined on upload.
          example: 480
        id:
          type: integer
          description: A unique numeric identifier for the product image.
          example: 850703190
        position:
          type: integer
          description: The order of the product image in the list. The first product image is at position 1 and is the main image for the product.
          example: 1
        product_id:
          type: integer
          description: The id of the product associated with the image.
          example: 632910392
        src:
          type: string
          description: Specifies the location of the product image. This parameter supports URL filters that you can use to retrieve modified copies of the image. For example, add _small, to the filename to retrieve a scaled copy of the image at 100 x 100 px (for example, ipod-nano_small.png), or add _2048x2048 to retrieve a copy of the image constrained at 2048 x 2048 px resolution (for example, ipod-nano_2048x2048.png).
          example: https://img.btdmp.com/products/ipod-nano.png
        updated_at:
          type: integer
        width:
          type: integer
          description: Width dimension of the image which is determined on upload.
          example: 640
      type: object
    MetaField:
      properties:
        description:
          type: string
          description: Description
        key:
          type: string
          description: Key
        namespace:
          type: string
          description: Namespace
        value:
          type: string
          description: Value
        value_type:
          type: string
          description: Value type
      type: object
    FulfillmentService:
      properties:
        can_remove_mapping:
          type: boolean
          description: Can remove mapping or not
          example: true
        is_mapped:
          type: boolean
          description: Whether is mapped or not
          example: true
        service_name:
          type: string
          description: Service name
          example: Service name
      type: object
    dto.ProductVariantRequestWithOptionValue:
      properties:
        barcode:
          type: string
          description: The code of variant for easy managing
          example: 9 788073 400972
        compare_at_price:
          type: number
          description: The price compare with
          example: 200
        cost_per_item:
          type: number
        fulfillment_service:
          type: string
          description: The name of fulfillment
          example: shopbase
        id:
          type: integer
          description: A unique numeric identifier for the product variant. Each id is unique across the ShopBase system. No two products variant will have the same id, even if they're from different shops.
          example: 632910392
        image_id:
          type: integer
          description: The unique numeric identifier for a product's image. The image must be associated to the same product as the variant.
          example: 434522
        inventory_management:
          type: string
          description: The name of inventory management
          example: shopbase
        inventory_policy:
          type: string
          description: 'Whether customers are allowed to place an order for the product variant when it''s out of stock. Valid values

            </br>**deny**:  Customers are not allowed to place orders for the product variant if it''s out of stock

            </br>**continue**:  Customers are allowed to place orders for the product variant if it''s out of stock.'
        inventory_quantity:
          type: integer
          description: The quantity in inventory.
          example: 100
        is_default:
          type: boolean
          description: Option to decide that this variant is default or not
          example: true
        option1:
          type: string
          description: A unique identifier for the product variant in the shop. Required in order to connect to a FulfillmentService
          example: IPOD2008PINK
        price:
          type: number
          description: The price of variant.
          example: 100
        product_id:
          type: integer
          description: A unique numeric identifier for the product. Each id is unique across the ShopBase system. No two products will have the same id, even if they're from different shops.
          example: 632910392
        requires_shipping:
          type: boolean
          description: Whether a customer needs to provide a shipping address when placing an order for the product variant.
          example: true
        sku:
          type: string
          description: The Metafield resource allows you to add additional information to other Admin API resources. Present, we don't use this field. We use table metafield instead.
        taxable:
          type: boolean
          description: Whether a tax is charged when the product variant is sold.
          example: true
        title:
          type: string
          description: The name of the product.
          example: IPod Nano - 8GB
        weight:
          type: number
          description: Weight of product
          example: 12
        weight_unit:
          type: string
          description: unit of weight
          example: '12'
      type: object
    gitlab.ProductImage:
      properties:
        alt_text:
          type: string
          description: The text in alt property of image
          example: ipod-nano-xin
        height:
          type: integer
          description: Height dimension of the image which is determined on upload.
          example: 480
        id:
          type: integer
          description: A unique numeric identifier for the product image.
          example: 850703190
        position:
          type: integer
          description: The order of the product image in the list. The first product image is at position 1 and is the main image for the product.
          example: 1
        product_id:
          type: integer
          description: The id of the product associated with the image.
          example: 632910392
        src:
          type: string
          description: Specifies the location of the product image. This parameter supports URL filters that you can use to retrieve modified copies of the image. For example, add _small, to the filename to retrieve a scaled copy of the image at 100 x 100 px (for example, ipod-nano_small.png), or add _2048x2048 to retrieve a copy of the image constrained at 2048 x 2048 px resolution (for example, ipod-nano_2048x2048.png).
          example: https://img.btdmp.com/products/ipod-nano.png
        updated_at:
          type: integer
        width:
          type: integer
          description: Width dimension of the image which is determined on upload.
          example: 640
      type: object
    ProductSwaggerRequest:
      properties:
        product:
          $ref: '#/components/schemas/ProductDtoSwagger'
      type: object
    ProductVariantDuplicateRequest:
      properties:
        new_value:
          type: string
          description: Value of option want to duplicate
          example: Pink
        option_id:
          type: integer
          description: Option set id that want to duplicate
          example: 274948
        variants:
          items:
            type: integer
          type: array
          description: List of form variant ids want to duplicate
          example:
          - 274942
          - 274948
      type: object
    gitlab.Product:
      properties:
        body_html:
          type: string
          description: A description of the product. Supports HTML formatting.
          example: '<p>It''s the small iPod with a big idea: Video.<p>'
        can_preview:
          type: boolean
          description: This product can be previewed by personalize tool or not
        created_at:
          type: integer
          description: Created at time
        custom_options:
          type: string
          description: The schema to generate custom option form fields
        handle:
          type: string
          description: A unique human-friendly string for the product. Automatically generated from the product's `title`. Used by the Liquid templating language to refer to objects.
          example: ipod-nano-8gb
        id:
          type: integer
          description: A unique numeric identifier for the product. Each id is unique across the ShopBase system. No two products will have the same id, even if they're from different shops.
          example: 632910392
        metafields_global_description_tag:
          type: string
          description: A description of the product used for SEO purposes. Generally added to the <meta name='description'> tag.
          example: 'It''s the small iPod with a big idea: Video.'
        metafields_global_title_tag:
          type: string
          description: The name of the product used for SEO purposes. Generally added to the  <meta name='title'> tag.
          example: IPod Nano - White, 8GB
        product_availability:
          type: integer
          description: '1. Available in all channels

            2. Hide from the sitemap.txt

            3. Hide from online store listing pages (homepage, collection pages, search page,...)

            0. Hide from all channels'
          example: 7
        product_type:
          type: string
          description: A categorization for the product used for filtering and searching products.
          example: Cult Products
        published:
          type: boolean
          description: Published or not
          example: true
        published_at:
          type: integer
          description: The date and time (ISO 8601 format) when the product was published. Can be set to null to unpublish the product from the Online Store channel.
        tags:
          type: string
          description: A string of comma-separated tags that are used for filtering and search. A product can have up to 250 tags. Each tag can have up to 255 characters.
          example: Emotive, Flash Memory, MP3, Music
        title:
          type: string
          description: The name of the product.
          example: IPod Nano - 8GB
        updated_at:
          type: integer
          description: Updated at time
        vendor:
          type: string
          description: The name of the product's vendor.
          example: Apple
      type: object
    ProductUpdateRequestSwagger:
      properties:
        is_create_redirect:
          type: boolean
          description: Option for create redirect or not when update product. If true, create a redirect from old handle to new handle
          example: true
        product:
          $ref: '#/components/schemas/ProductDtoTransformRequestUpdateProduct'
          description: Data of product to update
      type: object
    ProductGetVendorsSwaggerResponse:
      properties:
        vendors:
          items:
            type: string
          type: array
      type: object
    ProductGetTypesSwaggerResponse:
      properties:
        types:
          items:
            type: string
          type: array
      type: object
    dto.ImageRequest:
      properties:
        position:
          type: integer
          description: Position of list image
          example: 1
        src:
          type: string
          description: url of image
          example: https://theme.hstatic.net/1000003443/1000386436/14/partner-shopbase.jpg?v=3381
      type: object
    dto.Rule:
      properties:
        conditions:
          items:
            $ref: '#/components/schemas/dto.Condition'
          type: array
        show_option_ids:
          items:
            type: string
          type: array
          description: List ids will be shown
          example:
          - '1123123'
          - '3453567'
      type: object
    ProductsByCollectionSwaggerResponse:
      properties:
        products:
          items:
            $ref: '#/components/schemas/gitlab.Product'
          type: array
        total:
          type: integer
          example: 1
      type: object
    ProductRemoveMappingResponse:
      properties:
        success:
          type: boolean
      type: object
    dto.CustomOptionValue:
      properties:
        text:
          type: string
          description: Option's text, unique
          example: Option text
        thumbnail:
          type: string
          description: Option's thumbnail if custom option is picture choice. If thumbnail is empty, picture will be displayed by url from value
        value:
          type: string
          description: Option's value
          example: Option value
      type: object
    PatchProductResponseSwagger:
      properties:
        is_process_background:
          type: boolean
        status:
          type: boolean
      type: object
    ProductVariantRequestWithOptionValueDtoSwagger:
      properties:
        barcode:
          type: string
          description: The code of variant for easy managing
          example: 9 788073 400972
        compare_at_price:
          type: number
          description: The price compare with
          example: 200
        cost_per_item:
          type: number
        fulfillment_service:
          type: string
          description: The name of fulfillment
          example: shopbase
        id:
          type: integer
          description: A unique numeric identifier for the product variant. Each id is unique across the ShopBase system. No two products variant will have the same id, even if they're from different shops.
          example: 632910392
        image_id:
          type: integer
          description: The unique numeric identifier for a product's image. The image must be associated to the same product as the variant.
          example: 434522
        inventory_management:
          type: string
          description: The name of inventory management
          example: shopbase
        inventory_policy:
          type: string
          description: 'Whether customers are allowed to place an order for the product variant when it''s out of stock. Valid values

            </br>**deny**:  Customers are not allowed to place orders for the product variant if it''s out of stock

            </br>**continue**:  Customers are allowed to place orders for the product variant if it''s out of stock.'
        inventory_quantity:
          type: integer
          description: The quantity in inventory.
          example: 100
        is_default:
          type: boolean
          description: Option to decide that this variant is default or not
          example: true
        option1:
          type: string
          description: A unique identifier for the product variant in the shop. Required in order to connect to a FulfillmentService
          example: IPOD2008PINK
        price:
          type: number
          description: The price of variant.
          example: 100
        product_id:
          type: integer
          description: A unique numeric identifier for the product. Each id is unique across the ShopBase system. No two products will have the same id, even if they're from different shops.
          example: 632910392
        requires_shipping:
          type: boolean
          description: Whether a customer needs to provide a shipping address when placing an order for the product variant.
          example: true
        sku:
          type: string
          description: The Metafield resource allows you to add additional information to other Admin API resources. Present, we don't use this field. We use table metafield instead.
        taxable:
          type: boolean
          description: Whether a tax is charged when the product variant is sold.
          example: true
        title:
          type: string
          description: The name of the product.
          example: IPod Nano - 8GB
        weight:
          type: number
          description: Weight of product
          example: 12
        weight_unit:
          type: string
          description: unit of weight
          example: '12'
      type: object
    handlers.ProductRequest:
      properties:
        collection_id:
          type: integer
          description: Filter results by product collection ID.
          example: 123456
        created_at_max:
          type: string
          description: 'Show products created before date. (format: 2014-04-25T16:15:47-04:00)'
          example: '2014-04-25T16:15:47-04:00'
        created_at_min:
          type: string
          description: 'Show products created after date. (format: 2014-04-25T16:15:47-04:00)'
          example: '2014-04-25T16:15:47-04:00'
        limit:
          type: integer
          description: 'Return up to this many results per page. (default: 50, maximum: 250).'
          example: 10
        page:
          type: integer
          description: 'Using for pagination. (default: 1).'
          example: 1
        published_at_min:
          type: string
          description: 'Show products published after date. (format: 2014-04-25T16:15:47-04:00)'
          example: '2014-04-25T16:15:47-04:00'
        published_status:
          type: string
          description: 'Return products by their published status. (default: any), published: Show only published products. unpublished: Show only unpublished products. any: Show all products.'
          example: any
        since_id:
          type: integer
          description: Restrict results to after the specified ID.
          example: 3456789
        sort_order:
          type: string
          description: 'Order which is used to arranging items. (valid orders: alpha-asc, alpha-desc, created-asc, created-desc, price-asc, price-desc)'
          example: alpha-asc
        title:
          type: string
          description: Filter product by title
          example: product
        updated_at_max:
          type: string
          description: 'Show products last updated before date. (format: 2014-04-25T16:15:47-04:00)'
          example: '2014-04-25T16:15:47-04:00'
        updated_at_min:
          type: string
          description: 'Show products last updated after date. (format: 2014-04-25T16:15:47-04:00)'
          example: '2014-04-25T16:15:47-04:00'
      type: object
    CountResponse:
      properties:
        count:
          type: integer
      type: object
    ProductDtoTransformRequestUpdateProduct:
      properties:
        body_html:
          type: string
          description: A description of the product. Supports HTML formatting.
          example: '<p>It''s the small iPod with a big idea: Video.<p>'
        can_preview:
          type: boolean
          description: This product can be previewed by personalize tool or not
        created_at:
          type: integer
          description: Created at time
        custom_options:
          items:
            $ref: '#/components/schemas/dto.CustomOption'
          type: array
          description: List of custom options
        delete_image_ids:
          items:
            type: integer
          type: array
          description: List image you want to delete
          example:
          - 123123
          - 434343
        display_options:
          $ref: '#/components/schemas/DisplayOptions'
          description: List of display options
        handle:
          type: string
          description: A unique human-friendly string for the product. Automatically generated from the product's `title`. Used by the Liquid templating language to refer to objects.
          example: ipod-nano-8gb
        id:
          type: integer
          description: A unique numeric identifier for the product. Each id is unique across the ShopBase system. No two products will have the same id, even if they're from different shops.
          example: 632910392
        image:
          $ref: '#/components/schemas/ProductImageWithAttachment'
          description: An image we want to insert/update
        images:
          items:
            $ref: '#/components/schemas/ProductImageWithAttachment'
          type: array
          description: A list of image we want to insert/update
        metafields_global_description_tag:
          type: string
          description: A description of the product used for SEO purposes. Generally added to the <meta name='description'> tag.
          example: 'It''s the small iPod with a big idea: Video.'
        metafields_global_title_tag:
          type: string
          description: The name of the product used for SEO purposes. Generally added to the  <meta name='title'> tag.
          example: IPod Nano - White, 8GB
        options:
          items:
            $ref: '#/components/schemas/dto.ProductOption'
          type: array
          description: List of product option set with options
        product_availability:
          type: integer
          description: '1. Available in all channels

            2. Hide from the sitemap.txt

            3. Hide from online store listing pages (homepage, collection pages, search page,...)

            0. Hide from all channels'
          example: 7
        product_type:
          type: string
          description: A categorization for the product used for filtering and searching products.
          example: Cult Products
        published:
          type: boolean
          description: Published or not
          example: true
        published_at:
          type: integer
          description: The date and time (ISO 8601 format) when the product was published. Can be set to null to unpublish the product from the Online Store channel.
        tags:
          type: string
          description: A string of comma-separated tags that are used for filtering and search. A product can have up to 250 tags. Each tag can have up to 255 characters.
          example: Emotive, Flash Memory, MP3, Music
        title:
          type: string
          description: The name of the product.
          example: IPod Nano - 8GB
        updated_at:
          type: integer
          description: Updated at time
        variants:
          items:
            $ref: '#/components/schemas/dto.ProductVariantRequestWithOptionValue'
          type: array
          description: A list of variant with option that we want to update
        vendor:
          type: string
          description: The name of the product's vendor.
          example: Apple
      type: object
    ProductReorderRequest:
      properties:
        options:
          items:
            $ref: '#/components/schemas/ProductReorderOptionItem'
          type: array
          description: List of option want to reorder
        product_id:
          type: integer
          description: A unique numeric identifier for the product. Each id is unique across the ShopBase system. No two products will have the same id, even if they're from different shops.
          example: 632910392
      type: object
    SwaggerDeleteResponse:
      type: object
    DisplayOptions:
      properties:
        group_options_by:
          type: integer
          description: Group option by specific field
          example: 1
      type: object
    ProductDeleteMultiSwaggerResponse:
      properties:
        status:
          type: string
          description: Message for delete success.
          example: delete success
      type: object
  securitySchemes:
    APP_ACCESS_TOKEN:
      type: apiKey
      name: APP_ACCESS_TOKEN
      in: header
    SHOP_ACCESS_TOKEN:
      type: apiKey
      name: SHOP_ACCESS_TOKEN
      in: header
    USER_ACCESS_TOKEN:
      type: apiKey
      name: USER_ACCESS_TOKEN
      in: header
x-tagGroups:
- name: PhubOrderApi
  tags:
  - PhubOrderApi
- name: Customer
  tags:
  - Customer
  - Customer Address
- name: Product
  tags:
  - Custom Collection
  - Collect
  - Product
  - Product Image
  - Product Variant
  - SmartCollection
- name: Discount
  tags:
  - DiscountCode
  - PriceRule
- name: Events
  tags:
  - Webhook
- name: Orders
  tags:
  - Order
  - DraftOrder
  - Transaction
  - Refund
  - Abandoned Checkout
- name: Fulfillment
  tags:
  - Fulfillment
  - FulfillmentService
- name: Metafield
  tags:
  - Metafield
- name: OnlineStore
  tags:
  - Page
  - Redirect
  - ScriptTag
- name: Payment
  tags:
  - PaymentMethod
  - Payment Simulator
- name: Shop
  tags:
  - Shop
- name: Domain
  tags:
  - Domain