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

# Create a new catalogue item



## OpenAPI

````yaml openapi.json post /catalogue-items
openapi: 3.1.0
info:
  title: Pink Platform
  version: 0.0.1
servers:
  - url: http://localhost/api
security: []
paths:
  /catalogue-items:
    post:
      tags:
        - CatalogueItem
      summary: Create a new catalogue item
      operationId: catalogue-items.create
      requestBody:
        description: '`CatalogueItem`'
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CatalogueItem'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Catalogue item created successfully
                  '':
                    type: string
                  transmission_id:
                    type: string
                required:
                  - message
                  - null
                  - transmission_id
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          $ref: '#/components/responses/AuthenticationException'
        '422':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Invalid request data
                  errors:
                    type: string
                required:
                  - error
                  - errors
components:
  schemas:
    CatalogueItem:
      type: object
      properties:
        identification:
          $ref: '#/components/schemas/CatalogueItemIdentification'
        product_name:
          type: string
        available:
          type: boolean
        units:
          type: array
          items:
            $ref: '#/components/schemas/CatalogueItemUnit'
        food_information:
          $ref: '#/components/schemas/FoodInformation'
          description: Food information data according to EU regulation 1169/2011
      required:
        - identification
        - product_name
        - units
      title: CatalogueItem
    CatalogueItemIdentification:
      type: object
      properties:
        pink_id:
          type:
            - string
            - 'null'
        seller_catalogue_item_id:
          type:
            - string
            - 'null'
        seller:
          $ref: '#/components/schemas/PartnerIdentification'
        gtin:
          type:
            - integer
            - 'null'
      required:
        - seller
      title: CatalogueItemIdentification
    CatalogueItemUnit:
      type: object
      properties:
        order_unit:
          $ref: '#/components/schemas/Unit'
          description: |-
            The unique identifier for the unit.
            This is used to reference the unit in other parts of the system
        price_unit:
          $ref: '#/components/schemas/Unit'
          description: >-
            The unit in which the price is expressed.

            This is typically the same as the order unit, but can differ in some
            cases (e.g. bulk items)
        factor:
          type: number
          description: >-
            Ratio of the order unit to the price unit. (e.g. 1.5 means 1.5 order
            units per price unit)
          default: 1
        factor_is_estimated:
          type: boolean
          description: >-
            If true, the factor is an estimate and may not be completely
            accurate
          default: false
        prices:
          type: array
          items:
            $ref: '#/components/schemas/CatalogueItemUnitPrice'
      required:
        - order_unit
        - price_unit
        - factor
        - factor_is_estimated
        - prices
      title: CatalogueItemUnit
    FoodInformation:
      type: object
      properties:
        product_name:
          type: string
          description: Product name according to EU food information regulations
        ingredients:
          type: array
          description: List of ingredients
          items:
            type: string
        allergens:
          type: array
          description: Allergens present in the product
          items:
            type: string
        nutrition_values:
          type: object
          description: Nutritional values per 100g/ml
          additionalProperties:
            type: number
        net_quantity:
          type: string
          description: Net quantity of the food
        durability_date:
          type: string
          description: Date of minimum durability or 'use by' date
        storage_conditions:
          type: string
          description: Special storage conditions and/or conditions of use
        origin:
          type: string
          description: Country of origin or place of provenance
        usage_instructions:
          type: string
          description: Instructions for use
        alcohol_content:
          type: number
          description: Alcoholic strength by volume for beverages containing more than 1.2%
      title: FoodInformation
    PartnerIdentification:
      type: object
      properties:
        pink_id:
          type: string
          description: Internal platform UUID
        gln:
          type: string
          description: Global Location Number (GLN)
      title: PartnerIdentification
    Unit:
      type: string
      enum:
        - pc
        - box
        - ctn
        - plt
        - pack
        - bundle
        - kg
        - g
        - mg
        - t
        - l
        - ml
        - m3
      title: Unit
    CatalogueItemUnitPrice:
      type: object
      properties:
        price:
          $ref: '#/components/schemas/Price'
        discounted:
          type: boolean
          default: false
      required:
        - price
        - discounted
      title: CatalogueItemUnitPrice
    Price:
      type: object
      properties:
        amount:
          type: integer
          description: Amount in the smallest currency unit (e.g., cents for EUR)
        currency:
          $ref: '#/components/schemas/Currency'
      required:
        - amount
        - currency
      title: Price
    Currency:
      type: string
      enum:
        - EUR
        - USD
        - GBP
      title: Currency
  responses:
    AuthenticationException:
      description: Unauthenticated
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message

````