openapi: 3.1.0
info:
    title: FLYERALARM V2 Client API
    description: 'A REST API to browse the FLYERALARM product catalog, order and track items'
    contact:
        name: FLYERALARM CorporateSolutions
        email: CorporateSolutions@flyeralarm.com
    version: 3.0.0
servers:
    - url: 'https://rest.flyeralarm-esolutions.com'
webhooks:
    DummyV1:
        post:
            summary: Test event for validation
            operationId: DummyV1 Event
            description: Test Event for validating if the webhook link receives our events or to be used for correctly configuring the signing key validation
            requestBody:
                description: Random message
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/EventDummyV1__schemas'
            responses:
                '200':
                    description: Return a 200 status to indicate that the data was received successfully
    OrderStatusV1:
        post:
            summary: Order status changed event
            operationId: OrderStatusV1 Event
            description: Event triggered whenever order status id is changed for each order in the system
            requestBody:
                description: Status updates about your order
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/EventOrderStatusV1__schemas'
            responses:
                '200':
                    $ref: '#/AcceptedResponse'
    CheckPrintDataStatusV1:
        post:
            summary: Pre-order print data response event
            operationId: CheckPrintDataStatusV1 Event
            description: Event triggered when a pre-order "print data check" process has a new status
            requestBody:
                description: Status updates about print data check, also contains reason why the check failed
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/EventCheckPrintDataStatusV1__schemas'
            responses:
                '200':
                    $ref: '#/AcceptedResponse'
    PrintDataStatusV1:
        post:
            summary: Post-order print data response event
            operationId: PrintDataStatusV1 Event
            description: Event triggered when a post-order "print data check" process has a new status
            requestBody:
                description: Status updates about print data check, also contains reason why the check failed
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/EventPrintDataStatusV1__schemas'
            responses:
                '200':
                    $ref: '#/AcceptedResponse'
    TrackingLinksV1:
        post:
            summary: Tracking links available event
            operationId: TrackingLinksV1 Event
            description: Event triggered whenever order's tracking links arrive
            requestBody:
                description: Event triggered when a post-order status process has a new tracking link(s)
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/TrackingLinksV1__schemas'
            responses:
                '200':
                    $ref: '#/AcceptedResponse'
paths:
    '/{country}/v2/catalog/groups':
        get:
            summary: Get Groups
            operationId: getProductGroupList
            description: Returns all orderable product groups based on country.
            tags:
                - Product Catalog
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/has_variants'
                - $ref: '#/components/parameters/simple_product'
                - $ref: '#/components/parameters/catalog_type'
                - $ref: '#/components/parameters/go_live_date_from'
                - $ref: '#/components/parameters/go_live_date_to'
                - $ref: '#/components/parameters/last_change_date_from'
                - $ref: '#/components/parameters/last_change_date_to'
                - $ref: '#/components/parameters/sort'
                - $ref: '#/components/parameters/page'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: A list of all Product Groups.
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ProductGroups'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '500':
                    description: Internal Server Error
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '500':
                                    $ref: '#/components/examples/500InternalServerError'
    '/{country}/v2/catalog/groups/{product_group_id}':
        get:
            summary: Get Group
            operationId: getProductGroupById
            description: Returns a detailed description of a Product Group
            tags:
                - Product Catalog
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/product_group_id'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: A detailed description of a Product Group.
                    content:
                        application/json:
                            schema:
                                oneOf:
                                    - $ref: '#/components/schemas/ProductGroup'
                                    - $ref: '#/components/schemas/New_ProductGroup'
                                discriminator:
                                    propertyName: new_catalog
                                    mapping:
                                        'false': '#/components/schemas/ProductGroup'
                                        'true': '#/components/schemas/New_ProductGroup'
                            examples:
                                OldCatalog:
                                    $ref: '#/components/examples/OldCatalog'
                                NewCatalog:
                                    $ref: '#/components/examples/NewCatalog'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
                '500':
                    description: Internal Server Error
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '500':
                                    $ref: '#/components/examples/500InternalServerError'
    '/{country}/v2/catalog/groups/{product_group_id}/variants':
        get:
            summary: Get Product Variants
            operationId: getProductVariantsbyGroupId
            description: Returns a paginated list of variants based on the group id
            tags:
                - Product Catalog
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/product_group_id'
                - $ref: '#/components/parameters/has_quantities'
                - $ref: '#/components/parameters/with_quantities'
                - $ref: '#/components/parameters/page'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: A detailed description of a Product Variant.
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Variants'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
                '500':
                    description: Internal Server Error
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '500':
                                    $ref: '#/components/examples/500InternalServerError'
    '/{country}/v2/catalog/groups/{product_group_id}/configurator':
        post:
            summary: Configurator
            operationId: getProductAttributesByGroup
            description: Returns all possible attribute combinations for a given product group and total count of variations. Can be filtered/narrowed down by selecting attributes. If only 1 possible variant is left, the response will contain the <strong>VariantId in the response.</strong>
            tags:
                - Product Catalog
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/product_group_id'
            security:
                - bearerAuth: []
            requestBody:
                description: Provide a list of attributes and their values in order to find a suitable Variant Id
                content:
                    application/json:
                        schema:
                            type: object
                            additionalProperties:
                                type: string
                        examples:
                            EmptyAttributes:
                                $ref: '#/components/examples/EmptyAttributes'
                            SelectedAttributes:
                                $ref: '#/components/examples/SelectedAttributes'
                required: true
            responses:
                '200':
                    description: Possible configuration attributes which can be further narrowed down in order to get 1 Variant Id.
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/AttributeDetails'
                            examples:
                                '1':
                                    $ref: '#/components/examples/AttributeDetailsMultiple'
                                '2':
                                    $ref: '#/components/examples/AttributeDetailsSingle'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
                '500':
                    description: Internal Server Error
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '500':
                                    $ref: '#/components/examples/500InternalServerError'
    '/{country}/v2/catalog/variants/{variant_id}':
        get:
            summary: Get a Product Variant with Quantities
            operationId: getProductVariantById
            description: Returns a detailed description of a Product Variant.
            tags:
                - Product Catalog
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/variant_id'
                - $ref: '#/components/parameters/has_quantities'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: A detailed description of a Product Variant.
                    content:
                        application/json:
                            schema:
                                oneOf:
                                    - $ref: '#/components/schemas/Variant'
                                    - $ref: '#/components/schemas/New_Variant'
                                discriminator:
                                    propertyName: new_catalog
                                    mapping:
                                        'false': '#/components/schemas/Variant'
                                        'true': '#/components/schemas/New_Variant'
                            examples:
                                OldVariant:
                                    $ref: '#/components/examples/Variant'
                                NewVariant:
                                    $ref: '#/components/examples/New_Variant'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
                '500':
                    description: Internal Server Error
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '500':
                                    $ref: '#/components/examples/500InternalServerError'
    '/{country}/v2/catalog/variants/{variant_id}/print_data/allowed_format':
        get:
            summary: Variant Print Data allowed format
            operationId: getVariantPrintDataAllowedFormat
            description: Returns information about what type of files and formats can be uploaded for a specific product variant
            tags:
                - Product - Print Data
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/variant_id'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: The current upload allowed status of a product variant.
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/VariantPrintDataAllowedFormat'
                            examples:
                                NoUploads:
                                    summary: No uploads required for this type of product variant
                                    description: No uploads required for this type of product variant
                                    value:
                                        status: false
                                SingleUploads:
                                    summary: Only single upload available
                                    description: Only single upload available
                                    value:
                                        status: true
                                        singleUploadMessage: "Single upload is available in PDF format. Example 1 with front and back printing: a product like bundled business cards needs a PDF with 2 pages. Example 2 with front and empty back pages: a product like bundled business cards needs 2 pages, empty pages must be blank and not be omitted."
                                MultipleUploads:
                                    summary: Multiple upload and single file upload available
                                    description: Multiple upload and single file upload available
                                    value:
                                        status: true
                                        singleUploadMessage: "Single upload is available in PDF format. Example 1 with front and back printing: a product like bundled business cards needs a PDF with 2 pages. Example 2 with front and empty back pages: a product like bundled business cards needs 2 pages, empty pages must be blank and not be omitted."
                                        multiUploadMessage: "Multiple files may be bundled into a ZIP archive. The archive may contain PDF, JPEG or TIFF files. Files from the archive must follow this format: 4 digits plus file extension. Example with front and back printing: a product like bundled business cards needs 4 files for upload: 0001.pdf, 0002.jpeg, 0003.tif, 0004.tiff."
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
    '/{country}/v2/catalog/variants/quantity/{quantity_id}':
        get:
            summary: Find a ProductVariant via a QuantityId
            operationId: getProductVariantByQuantityId
            description: Returns a detailed description of a ProductVariant.
            tags:
                - Product Catalog
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/quantity_id'
                - $ref: '#/components/parameters/has_quantities'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: A detailed description of a ProductVariant.
                    content:
                        application/json:
                            schema:
                                oneOf:
                                    - $ref: '#/components/schemas/Variant'
                                    - $ref: '#/components/schemas/New_Variant'
                                discriminator:
                                    propertyName: new_catalog
                                    mapping:
                                        'false': '#/components/schemas/Variant'
                                        'true': '#/components/schemas/New_Variant'
                            examples:
                                OldVariant:
                                    $ref: '#/components/examples/Variant'
                                NewVariant:
                                    $ref: '#/components/examples/New_Variant'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
                '500':
                    description: Internal Server Error
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '500':
                                    $ref: '#/components/examples/500InternalServerError'
    '/{country}/v2/catalog/variants/{variant_id}/amount/{amount}':
        get:
            summary: Find a ProductVariant via Id and Amount
            operationId: getProductVariantByAmount
            description: Returns a detailed description of a ProductVariant.
            tags:
                - Product Catalog
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/variant_id'
                - $ref: '#/components/parameters/amount'
                - $ref: '#/components/parameters/has_quantities'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: A detailed description of a ProductVariant.
                    content:
                        application/json:
                            schema:
                                oneOf:
                                    - $ref: '#/components/schemas/Variant'
                                    - $ref: '#/components/schemas/New_Variant'
                                discriminator:
                                    propertyName: new_catalog
                                    mapping:
                                        'false': '#/components/schemas/Variant'
                                        'true': '#/components/schemas/New_Variant'
                            examples:
                                OldVariant:
                                    $ref: '#/components/examples/Variant'
                                NewVariant:
                                    $ref: '#/components/examples/New_Variant'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
                '500':
                    description: Internal Server Error
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '500':
                                    $ref: '#/components/examples/500InternalServerError'
    '/{country}/v2/catalog/quantities/{quantity_id}/shipping/{shipping_type_id}':
        get:
            summary: Get Product Options by quantityId and shipping
            operationId: getProductOptionsByQuantityAndShipping
            description: Get Product Options for specific Shipping Id. These options can be passed when ordering a quantity
            tags:
                - Product - Options
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/quantity_id'
                - $ref: '#/components/parameters/shipping_type_id'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: Get Product Options for specific Shipping Id.
                    content:
                        application/json:
                            schema:
                                type: object
                                additionalProperties:
                                    type: object
                                    properties:
                                        name:
                                            type: string
                                            description: Name of the product option category
                                        taxRate:
                                            type: string
                                            description: Tax rate identifier
                                        defaultOptionId:
                                            type: integer
                                            description: Default option ID for this category
                                        options:
                                            type: object
                                            additionalProperties:
                                                type: object
                                                properties:
                                                    name:
                                                        type: string
                                                    description:
                                                        type: string
                                                    nettoPrice:
                                                        type: string
                                                    bruttoPrice:
                                                        type: string
                                                    rawNettoPrice:
                                                        type: number
                                                    rawBruttoPrice:
                                                        type: number
                                                    msrpNettoPrice:
                                                        type: string
                                                    msrpBruttoPrice:
                                                        type: string
                                                    msrpRawNettoPrice:
                                                        type: number
                                                    msrpRawBruttoPrice:
                                                        type: number
                                        textileSizes:
                                            type: array
                                            description: Available textile sizes (optional)
                                            items:
                                                type: object
                                                properties:
                                                    id:
                                                        type: string
                                                    translated:
                                                        type: string
                                                    grossSurcharge:
                                                        type: number
                                                    msrpGrossSurcharge:
                                                        type: number
                                                    netSurcharge:
                                                        type: number
                                                    msrpNetSurcharge:
                                                        type: number
                                                    currency:
                                                        type: string
                            examples:
                                basicProductOptions:
                                    summary: Product Options
                                    description: Product Options for the specified Shipping Id
                                    value:
                                        "3":
                                            name: "Datencheck"
                                            taxRate: "de_std"
                                            defaultOptionId: 3001
                                            options:
                                                "3001":
                                                    name: "Basis-Datencheck"
                                                    description: "Datencheck: Basis-Datencheck"
                                                    nettoPrice: "0,00 €"
                                                    bruttoPrice: "0,00 €"
                                                    rawNettoPrice: 0
                                                    rawBruttoPrice: 0
                                                    msrpNettoPrice: "0,00 €"
                                                    msrpBruttoPrice: "0,00 €"
                                                    msrpRawNettoPrice: 0
                                                    msrpRawBruttoPrice: 0
                                                "3002":
                                                    name: "Profi-Datencheck"
                                                    description: "Datencheck: Profi-Datencheck"
                                                    nettoPrice: "10,00 €"
                                                    bruttoPrice: "11,90 €"
                                                    rawNettoPrice: 10.00
                                                    rawBruttoPrice: 11.9
                                                    msrpNettoPrice: "10,00 €"
                                                    msrpBruttoPrice: "11,90 €"
                                                    msrpRawNettoPrice: 10.00
                                                    msrpRawBruttoPrice: 11.9
                                textileProductOptions:
                                    summary: Product Options for textiles
                                    description: Product Options for the specified Shipping Id
                                    value:
                                        "3":
                                            name: "Datencheck"
                                            taxRate: "de_std"
                                            defaultOptionId: 3001
                                            options:
                                                "3001":
                                                    name: "Basis-Datencheck"
                                                    description: "Datencheck: Basis-Datencheck"
                                                    nettoPrice: "0,00 €"
                                                    bruttoPrice: "0,00 €"
                                                    rawNettoPrice: 0
                                                    rawBruttoPrice: 0
                                                    msrpNettoPrice: "0,00 €"
                                                    msrpBruttoPrice: "0,00 €"
                                                    msrpRawNettoPrice: 0
                                                    msrpRawBruttoPrice: 0
                                                "3002":
                                                    name: "Profi-Datencheck"
                                                    description: "Datencheck: Profi-Datencheck"
                                                    nettoPrice: "10,00 €"
                                                    bruttoPrice: "11,90 €"
                                                    rawNettoPrice: 10.00
                                                    rawBruttoPrice: 11.9
                                                    msrpNettoPrice: "10,00 €"
                                                    msrpBruttoPrice: "11,90 €"
                                                    msrpRawNettoPrice: 10.00
                                                    msrpRawBruttoPrice: 11.9
                                        "112":
                                            name: "Größenauswahl"
                                            taxRate: "de_std"
                                            defaultOptionId: 810018
                                            options:
                                                "810018":
                                                    name: "Größenauswahl"
                                                    description: "Größenauswahl: Größenauswahl"
                                                    nettoPrice: "0,00 €"
                                                    bruttoPrice: "0,00 €"
                                                    rawNettoPrice: 0
                                                    rawBruttoPrice: 0
                                                    msrpNettoPrice: "0,00 €"
                                                    msrpBruttoPrice: "0,00 €"
                                                    msrpRawNettoPrice: 0
                                                    msrpRawBruttoPrice: 0
                                            textileSizes:
                                                - id: "size_xs"
                                                  translated: "Größe XS"
                                                  grossSurcharge: 0
                                                  msrpGrossSurcharge: 0
                                                  netSurcharge: 0
                                                  msrpNetSurcharge: 0
                                                  currency: "EUR"
                                                - id: "size_s"
                                                  translated: "Größe S"
                                                  grossSurcharge: 0
                                                  msrpGrossSurcharge: 0
                                                  netSurcharge: 0
                                                  msrpNetSurcharge: 0
                                                  currency: "EUR"
                                                - id: "size_m"
                                                  translated: "Größe M"
                                                  grossSurcharge: 0
                                                  msrpGrossSurcharge: 0
                                                  netSurcharge: 0
                                                  msrpNetSurcharge: 0
                                                  currency: "EUR"
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
    '/{country}/v2/catalog/options/variant/{variant_id}/amount/{amount}/shipping/{shipping_type_id}':
        get:
            summary: Get Product Options by variant, amount and shipping
            operationId: getProductOptionsByVariantAmountShipping
            description: Get Product Options for specific Shipping Id. These options can be passed when ordering a variant with amount
            tags:
                - Product - Options
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/variant_id'
                - $ref: '#/components/parameters/amount'
                - $ref: '#/components/parameters/shipping_type_id'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: Get Product Options for specific Shipping Id.
                    content:
                        application/json:
                            schema:
                                type: object
                                additionalProperties:
                                    type: object
                                    properties:
                                        name:
                                            type: string
                                            description: Name of the product option category
                                        options:
                                            type: object
                                            additionalProperties:
                                                type: object
                                                properties:
                                                    name:
                                                        type: string
                                                    description:
                                                        type: string
                                                    nettoPrice:
                                                        type: string
                                                    bruttoPrice:
                                                        type: string
                                                    rawNettoPrice:
                                                        type: number
                                                    rawBruttoPrice:
                                                        type: number
                                                    msrpNettoPrice:
                                                        type: string
                                                    msrpBruttoPrice:
                                                        type: string
                                                    msrpRawNettoPrice:
                                                        type: number
                                                    msrpRawBruttoPrice:
                                                        type: number
                            examples:
                                basicProductOptions:
                                    summary: Product Options
                                    description: Product Options for the specified Shipping Id
                                    value:
                                        "SG-526126":
                                            name: "Datencheck"
                                            options:
                                                "PV-IVNQPW2TXFJG6P":
                                                    name: "Basis-Datencheck"
                                                    description: "Datencheck: Basis-Datencheck"
                                                    nettoPrice: "0,00 €"
                                                    bruttoPrice: "0,00 €"
                                                    rawNettoPrice: 0
                                                    rawBruttoPrice: 0
                                                    msrpNettoPrice: "0,00 €"
                                                    msrpBruttoPrice: "0,00 €"
                                                    msrpRawNettoPrice: 0
                                                    msrpRawBruttoPrice: 0
                                                "PV-DTY0Q2H4290D66":
                                                    name: "Profi-Datencheck"
                                                    description: "Datencheck: Profi-Datencheck"
                                                    nettoPrice: "10,00 €"
                                                    bruttoPrice: "11,90 €"
                                                    rawNettoPrice: 10.00
                                                    rawBruttoPrice: 11.9
                                                    msrpNettoPrice: "10,00 €"
                                                    msrpBruttoPrice: "11,90 €"
                                                    msrpRawNettoPrice: 10.00
                                                    msrpRawBruttoPrice: 11.9
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
    '/{country}/v2/catalog/variants/{custom_size_variant_id}/amount/{amount}/prices':
        post:
            operationId: getCustomSizePricesForVariantAndAmount
            summary: Get Custom Size product prices for a specific amount of a variant ID
            description: Get Custom Size product prices based on width and height by variant id
            tags:
                - Product - Custom Sizes
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/custom_size_variant_id'
                - $ref: '#/components/parameters/amount'
            requestBody:
                description: Provide width and height to get specific variant prices
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/CustomSizePrices'
                        examples:
                            '200':
                                $ref: '#/components/examples/CustomSizePrices'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: >-
                        Custom size product prices by variant id
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/CustomSizeVariant'
                            examples:
                                '200':
                                    $ref: '#/components/examples/CustomSizeVariantMultiple'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
    '/{country}/v2/catalog/variants/{custom_size_variant_id}/prices':
        post:
            operationId: getCustomSizePricesForVariant
            summary: Get Custom Size product prices for all quantities of a variant ID
            description: Get Custom Size product prices based on width and height by variant id
            tags:
                - Product - Custom Sizes
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/custom_size_variant_id'
            requestBody:
                description: Provide width and height to get specific variant prices
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/CustomSizePrices'
                        examples:
                            '200':
                                $ref: '#/components/examples/CustomSizePrices'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: >-
                        Custom size product prices by variant id
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/CustomSizeVariant'
                            examples:
                                '200':
                                    $ref: '#/components/examples/CustomSizeVariantMultiple'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
    '/{country}/v2/catalog/quantity/{custom_size_quantity_id}/prices':
        post:
            operationId: getCustomSizePricesQuantityID
            summary: Get Custom Size product prices for a specific quantity ID
            description: Get Custom Size product prices based on width and height by quantity id
            tags:
                - Product - Custom Sizes
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/custom_size_quantity_id'
            requestBody:
                description: Provide width and height to get specific quantity prices
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/CustomSizePrices'
                        examples:
                            '200':
                                $ref: '#/components/examples/CustomSizePrices'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: >-
                        Custom size product prices by quantity id
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/CustomSizeVariant'
                            examples:
                                '200':
                                    $ref: '#/components/examples/CustomSizeVariant'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
    '/{country}/v2/catalog/convert':
        post:
            summary: Convert catalog ids between catalogs
            operationId: convertIds
            description: >-
                Converts old catalogs ids to their corespondents in the new catalog and vice versa.
            tags:
                - Product Catalog
            parameters:
                - $ref: '#/components/parameters/country'
            security:
                - bearerAuth: []
            requestBody:
                description: Provide a list of ids, their type and from which catalog they are
                required: true
                content:
                    application/x-www-form-urlencoded:
                        schema:
                            type: object
                            required:
                                - catalog_type
                                - id_type
                                - ids[]
                            properties:
                                catalog_type:
                                    type: string
                                    description: From catalog type
                                    enum:
                                        - old
                                        - new
                                id_type:
                                    type: string
                                    description: Type for ids[] list
                                    enum:
                                        - group
                                        - variant
                                        - quantity
                                ids[]:
                                    type: array
                                    description: List of ids to convert
                                    items:
                                        type: string
                        encoding:
                            ids[]:
                                explode: true
            responses:
                '200':
                    description: A list conversions between catalogs
                    content:
                        application/json:
                            schema:
                                type: object
                                additionalProperties:
                                    type: string
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '500':
                    description: Internal Server Error
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '500':
                                    $ref: '#/components/examples/500InternalServerError'
    '/{country}/v2/orders':
        get:
            operationId: getOrders
            summary: List of orders
            description: |
                Provides a paginated list of orders.
                Provides a way to filter orders
            tags:
                - Orders
            parameters:
                - $ref: '#/components/parameters/country'
                - name: order_id
                  in: query
                  description: Filter by order ID
                  schema:
                    type: string
                - name: order_reference
                  in: query
                  description: Filter by order reference
                  schema:
                    type: string
                - name: product_type
                  in: query
                  description: Filter by product type
                  schema:
                    type: string
                    enum:
                        - standard
                        - custom_sizes
                        - textile_with_sizes
                    example:
                - name: product_group_name
                  in: query
                  description: Filter by product group name
                  schema:
                    type: string
                - name: group_id
                  in: query
                  description: Filter by product group ID
                  schema:
                    type: string
                - name: variant_id
                  in: query
                  description: Filter by variant ID
                  schema:
                    type: string
                - name: shipment_types[]
                  in: query
                  description: Filter by shipment type
                  schema:
                    type: array
                    items:
                        type: string
                        enum:
                            - standard
                            - express
                            - overnight
                  examples:
                    "null":
                        value:
                        summary: All shipments
                    standard:
                        summary: Standard shipment type
                        value:
                            - standard
                    express:
                        summary: Express shipment type
                        value:
                            - express
                    overnight:
                        summary: Overnight shipment type
                        value:
                            - overnight
                - name: price_from
                  in: query
                  description: Filter by price
                  schema:
                    type: number
                    format: float
                - name: price_to
                  in: query
                  description: Filter by price
                  schema:
                    type: number
                    format: float
                - name: created_at_from
                  in: query
                  description: Filter by creation date
                  schema:
                    type: string
                    format: date|date-time
                - name: created_at_to
                  in: query
                  description: Filter by creation date
                  schema:
                    type: string
                    format: date|date-time
                - name: statuses[]
                  in: query
                  description: Filter by order status
                  schema:
                    type: array
                    items:
                        enum:
                            - 10
                            - 12
                            - 13
                            - 14
                            - 21
                            - 22
                            - 42
                            - 90
                  examples:
                    "null":
                        value:
                        summary: All statuses
                    order_accepted:
                        value: [10]
                        summary: Order accepted (10)
                    printing_data_accepted:
                        value: [12]
                        summary: Printing data accepted (12)
                    in_production:
                        value: [13]
                        summary: In Production (13)
                    shipping:
                        value: [14]
                        summary: Shipping (14)
                    printing_data_missing:
                        value: [21]
                        summary: Printing data missing (21)
                    printing_data_invalid:
                        value: [22]
                        summary: Printing data invalid (22)
                    payment_pending:
                        value: [42]
                        summary: Payment pending (42)
                    contact_support:
                        value: [90]
                        summary: Contact support (90)
                - name: page
                  in: query
                  description: Page
                  schema:
                    type: number
                - name: limit
                  in: query
                  description: Limit. If the value is more than 200 it will default to 50.
                  schema:
                    type: number
                - name: order_by
                  in: query
                  description: Order by specified field
                  schema:
                    type: string
                    enum:
                        - order_id.asc
                        - order_id.desc
                        - created_at.asc
                        - created_at.desc
                        - final_price.asc
                        - final_price.desc
                        - product_group_name.asc
                        - product_group_name.desc
                - name: is_archived
                  in: query
                  description: Returns archived orders instead of active ones. To list archived orders, set the query parameter is_archive=1. By default (is_archive=0), only active orders are returned.
                  schema:
                    type: number
                    enum:
                        - 1
                        - 0
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: A list of orders.
                    content:
                        application/json:
                            schema:
                                type: array
                                items:
                                    $ref: '#/components/schemas/OrdersSummary'
        post:
            operationId: postOrder
            summary: Places an Order
            description: |
                Creates an order in our system.
                - **If you do not transmit a sender address, a default FLYERALARM address will be set automatically. The sender address is printed on the shipping label.**
                - **The FLYERALARM REST API may override option values and therefore may differ from the FLYERALARM web shop system.**
                - Exceptions for the order (invoice) address fields request body (extra mandatory fields):
                  - Country Italy (IT)
                      - `customer_type` is mandatory - possible values (1 for 'private', 2 for 'individualBusiness', 3 for 'company', 4 for 'association')
                      - `tax_number` is mandatory
                      - `vat_number` is mandatory
                      - `recipient_code` is mandatory
                  - Country Spain (ES)
                      - `customer_type` is mandatory - possible values (1 for 'private', 3 for 'company')
                      - `tax_number` is mandatory
                  - Country Belgium (BE)
                      - `customer_type`  is mandatory (for companies)
                      - `vat_number` is mandatory  (must contain: BE0 + 9 numbers)
            tags:
                - Orders
            parameters:
                - $ref: '#/components/parameters/country'
            security:
                - bearerAuth: []
            requestBody:
                description: Provide an order definition.
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/Order'
                        examples:
                            '1':
                                $ref: '#/components/examples/AtomicOrder'
                            '2':
                                $ref: '#/components/examples/AtomicOrderIT'
                            '3':
                                $ref: '#/components/examples/AtomicOrderES'
                            '4':
                                $ref: '#/components/examples/AtomicOrderBE'
                            '5':
                                $ref: '#/components/examples/SimpleOrder'
                            '6':
                                $ref: '#/components/examples/ExtendedOrder'
                            '7':
                                $ref: '#/components/examples/OrderWithQuantitySpecificOptions'
                            '8':
                                $ref: '#/components/examples/OrderWithMultipleDeliveryAddresses'
                            '9':
                                $ref: '#/components/examples/OrderWithNumbering'
                            '10':
                                $ref: '#/components/examples/OrderWithCustomSize'
                            '11':
                                $ref: '#/components/examples/OrderWithTextileSizes'
                            '12':
                                $ref: '#/components/examples/New_OrderWithQuantityId'
                            '13':
                                $ref: '#/components/examples/New_OrderWithVariantIdAndAmount'
                required: true
            responses:
                '200':
                    description: Order Id.
                    content:
                        application/json:
                            schema:
                                type: object
                                properties:
                                    order_id:
                                        type: string
                                        description: Order Number
                            examples:
                                '1':
                                    summary: Order accepted
                                    description: Order has been issued.
                                    value:
                                        order_id: "DE993333333333"
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '500':
                    description: Internal Server Error
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '500':
                                    $ref: '#/components/examples/500InternalServerError'
    '/{country}/v2/orders/{order_id}/address_change':
        post:
            operationId: changeAddress
            summary: Changes addresses of an Order
            description: |
                Changes the one or more addresses of an Order.
                - Exceptions for the order (invoice) address fields request body (extra mandatory fields):
                  - Country Italy (IT)
                      - `customer_type` is mandatory - possible values (1 for 'private', 2 for 'individualBusiness', 3 for 'company', 4 for 'association')
                      - `tax_number` is mandatory
                      - `vat_number` is mandatory
                      - `recipient_code` is mandatory
                  - Country Spain (ES)
                      - `customer_type` is mandatory - possible values (1 for 'private', 3 for 'company')
                      - `tax_number` is mandatory
                  - Country Belgium (BE)
                      - `customer_type`  is mandatory (for companies)
                      - `vat_number` is mandatory  (must contain: BE0 + 9 numbers)
            tags:
                - Orders
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/order_id'
            security:
                - bearerAuth: []
            requestBody:
                description: Provide addresses payload.
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/ChangeAddresses'
                        examples:
                            '1':
                                $ref: '#/components/examples/ChangeAllAddressesDE'
                required: true
            responses:
                '200':
                    description: >-
                        Change addresses success
                    content:
                        application/json:
                            schema:
                                description: A Message to inform about having the addresses changed.
                                type: object
                                required:
                                    - message
                                properties:
                                    message:
                                        type: string
                                        description: Message Text
                            examples:
                                '200':
                                    summary: Address was changed
                                    description: Address was changed.
                                    value:
                                        message: "Address was changed"
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '500':
                    description: Internal Server Error
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '500':
                                    summary: Failed to change address
                                    description: Failed to change address.
                                    value: {"error": "Failed to change address"}
    '/{country}/v2/orders/{order_id}/status':
        get:
            summary: Order Status (Deprecated)
            operationId: getOrderStatus
            description: Returns the status of an Order.
            deprecated: true
            tags:
                - Orders
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/order_id'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: The current status of an order.
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderStatus'
                            examples:
                                '10':
                                    summary: Order accepted
                                    description: Order has been issued. Waiting for print data to upload.
                                    value:
                                        order_id: DE1231231234
                                        order_status_id: 10
                                        order_status: Order accepted
                                        dispatch_date: 01.01.2025
                                        quick_uploader: https://www.flyeralarm.com/[country]/uploader/quick/[hashId]
                                        print_data_overview: https://www.flyeralarm.com/[country]/print-data-acquisition/print-data-overview/[hashId]
                                '12':
                                    summary: Printing data accepted
                                    description: >-
                                        The provided print data meets specification and was accepted.
                                    value:
                                        order_id: DE1231231234
                                        order_status_id: 12
                                        order_status: Printing data accepted
                                        dispatch_date: 01.01.2025
                                        quick_uploader: https://www.flyeralarm.com/[country]/uploader/quick/[hashId]
                                        print_data_overview: https://www.flyeralarm.com/[country]/print-data-acquisition/print-data-overview/[hashId]
                                '13':
                                    summary: In Production
                                    description: We are currently printing and producing the order
                                    value:
                                        order_id: DE1231231234
                                        order_status_id: 13
                                        order_status: In Production
                                        dispatch_date: 01.01.2025
                                        quick_uploader: https://www.flyeralarm.com/[country]/uploader/quick/[hashId]
                                        print_data_overview: https://www.flyeralarm.com/[country]/print-data-acquisition/print-data-overview/[hashId]
                                '14':
                                    summary: Shipping
                                    description: >-
                                        The order has left production and is currently shipping or has arrived. Please check carrier for further information.
                                    value:
                                        order_id: DE1231231234
                                        order_status_id: 14
                                        order_status: Shipping
                                        dispatch_date: 01.01.2025
                                        quick_uploader: https://www.flyeralarm.com/[country]/uploader/quick/[hashId]
                                        print_data_overview: https://www.flyeralarm.com/[country]/print-data-acquisition/print-data-overview/[hashId]
                                        carrier: UPS
                                        parcel_amount: 1
                                        tracking_numbers: ["1Z1234567891234567"]
                                        tracking_urls: {"1Z1234567891234567": "https://www.ups.com/track?loc=de_DE&tracknum=1Z1234567891234567"}
                                '21':
                                    summary: Printing data missing
                                    description: No print data was found. Please upload again.
                                    value:
                                        order_id: DE1231231234
                                        order_status_id: 21
                                        order_status: Printing data missing
                                        dispatch_date: 01.01.2025
                                        quick_uploader: https://www.flyeralarm.com/[country]/uploader/quick/[hashId]
                                        print_data_overview: https://www.flyeralarm.com/[country]/print-data-acquisition/print-data-overview/[hashId]
                                '22':
                                    summary: Printing data invalid
                                    description: >-
                                        The provided printing data was not compatible. Please correct and upload again.
                                    value:
                                        order_id: DE1231231234
                                        order_status_id: 22
                                        order_status: Printing data invalid
                                        dispatch_date: 01.01.2025
                                        quick_uploader: https://www.flyeralarm.com/[country]/uploader/quick/[hashId]
                                        print_data_overview: https://www.flyeralarm.com/[country]/print-data-acquisition/print-data-overview/[hashId]
                                '23':
                                    summary: Payment pending
                                    description: >-
                                        This is a prepayment order and the payment was not received yet.
                                    value:
                                        order_id: DE1231231234
                                        order_status_id: 23
                                        order_status: Payment pending
                                '42':
                                    summary: Contact support
                                    description: Infinite Improbability Error has been encountered.
                                    value:
                                        order_id: DE1231231234
                                        order_status_id: 42
                                        order_status: Please contact support
                                '90':
                                    summary: Order canceled
                                    description: This order has been cancelled.
                                    value:
                                        order_id: DE1231231234
                                        order_status_id: 90
                                        order_status: Order canceled
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
    '/{country}/v2/orders/{order_id}/status_info':
        get:
            summary: Order Status New
            operationId: getOrderStatusNew
            description: Returns the status of an Order (New Mapping).
            tags:
                - Orders
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/order_id'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: The current status of an order.
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderStatusNew'
                            examples:
                                '10':
                                    summary: Order accepted
                                    description: Order has been issued. Waiting for print data to upload.
                                    value:
                                        order_status_id: 10
                                        order_status: "Order accepted"
                                        dispatch_date:
                                            from: "2025-01-01T00:00:00+02:00"
                                            to: "2025-01-01T00:00:00+02:00"
                                '30':
                                    summary: Print data uploaded
                                    description: >-
                                        The provided print data meets was uploaded.
                                    value:
                                        order_status_id: 30
                                        order_status: "Print data uploaded"
                                        dispatch_date:
                                            from: "2025-01-01T00:00:00+02:00"
                                            to: "2025-01-01T00:00:00+02:00"
                                '31':
                                    summary: Data check in progress
                                    description: >-
                                        The provided print data is being checked.
                                    value:
                                        order_status_id: 31
                                        order_status: "Data check in progress"
                                        dispatch_date:
                                            from: "2025-01-01T00:00:00+02:00"
                                            to: "2025-01-01T00:00:00+02:00"
                                '12':
                                    summary: Printing data accepted
                                    description: >-
                                        The provided print data meets specification and was accepted.
                                    value:
                                        order_status_id: 12
                                        order_status: "Printing data accepted"
                                        dispatch_date:
                                            from: "2025-01-01T00:00:00+02:00"
                                            to: "2025-01-01T00:00:00+02:00"
                                '21':
                                    summary: Printing data missing
                                    description: No print data was found. Please upload again.
                                    value:
                                        order_status_id: 21
                                        order_status: "Printing data missing"
                                        dispatch_date:
                                            from: "2025-01-01T00:00:00+02:00"
                                            to: "2025-01-01T00:00:00+02:00"
                                '22':
                                    summary: Printing data invalid
                                    description: >-
                                        The provided printing data was not compatible. Please correct and upload again.
                                    value:
                                        order_status_id: 22
                                        order_status: "Printing data invalid"
                                        dispatch_date:
                                            from: "2025-01-01T00:00:00+02:00"
                                            to: "2025-01-01T00:00:00+02:00"
                                '70':
                                    summary: Print approval missing
                                    description: Print approval is missing
                                    value:
                                        order_status_id: 70
                                        order_status: "Print approval missing"
                                        dispatch_date:
                                            from: "2025-01-01T00:00:00+02:00"
                                            to: "2025-01-01T00:00:00+02:00"
                                '71':
                                    summary: Print approval given
                                    description: Print approval was given
                                    value:
                                        order_status_id: 71
                                        order_status: "Print approval given"
                                        dispatch_date:
                                            from: "2025-01-01T00:00:00+02:00"
                                            to: "2025-01-01T00:00:00+02:00"
                                '13':
                                    summary: In Production
                                    description: We are currently printing and producing the order
                                    value:
                                        order_status_id: 13
                                        order_status: In Production
                                        dispatch_date:
                                            from: "2025-01-01T00:00:00+02:00"
                                            to: "2025-01-01T00:00:00+02:00"
                                '14':
                                    summary: Shipping
                                    description: >-
                                        The order has left production and is currently shipping or has arrived. Please check carrier for further information.
                                    value:
                                        order_status_id: 14
                                        order_status: "Shipping"
                                        dispatch_date:
                                            from: "2025-01-01T00:00:00+02:00"
                                            to: "2025-01-01T00:00:00+02:00"
                                        shipment_data:
                                            - id: "Parcel1"
                                              url: "https://ups.com/?loc=de_DE&ref=Parcel1"
                                              carrier: "UPS"
                                              created: null
                                            - id: "Parcel2"
                                              url: "https://dhl.com/?loc=de_DE&ref=Parcel2"
                                              carrier: "DHL"
                                              created: "2025-01-01T00:00:00+02:00"
                                            - id: "Parcel3"
                                              url: "https://dhl.com/?loc=de_DE&ref=Parcel3"
                                              carrier: "DHL"
                                              created: "2025-01-01T00:00:00+02:00"
                                '42':
                                    summary: Contact support
                                    description: Infinite Improbability Error has been encountered.
                                    value:
                                        order_status_id: 42
                                        order_status: Please contact support.
                                '90':
                                    summary: Order canceled
                                    description: This order has been canceled.
                                    value:
                                        order_status_id: 90
                                        order_status: Order canceled
                                '91':
                                    summary: Refunded
                                    description: This order has been refunded.
                                    value:
                                        order_status_id: 91
                                        order_status: Refunded
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
    '/{country}/v2/orders/statuses':
        get:
            summary: New Order Statuses List
            operationId: getOrderStatuses
            description: Returns a list of order statuses (New Mapping).
            tags:
                - Orders
            parameters:
                - $ref: '#/components/parameters/country'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: List of statuses
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderStatuses'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
    '/{country}/v2/orders/{order_id}/cancel':
        post:
            summary: Cancel Order
            operationId: cancelOrder
            description: Cancels of an Order.
            tags:
                - Orders
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/order_id'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: >-
                        Cancellation success
                    content:
                        application/json:
                            schema:
                                description: A Message to inform about having the order cancelled.
                                type: object
                                required:
                                    - message
                                properties:
                                    message:
                                        type: string
                                        description: Message Text
                            examples:
                                '200':
                                    summary: Order was cancelled
                                    description: Order was cancelled.
                                    value: {"message": "Order was cancelled"}
                '500':
                    description: Internal Server Error
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '500':
                                    summary: Order could not be cancelled
                                    description: Order could not be cancelled.
                                    value: {"error": "Order could not be cancelled"}
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
    '/{country}/v2/orders/{order_id}/print_data':
        post:
            operationId: postOrderPrintDataCheck
            summary: Upload print data
            description: Attaches print data given as [file/ftp url/http url] to a new order.
            tags:
                - Orders - Print Data
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/order_id'
            requestBody:
                description: Provide print data source
                content:
                    application/x-www-form-urlencoded:
                        schema:
                            type: object
                            properties:
                                print_data_url:
                                    type: string
                    multipart/form-data:
                        schema:
                            type: object
                            properties:
                                print_data:
                                    type: string
                                    format: binary
                    application/json:
                        schema:
                            $ref: '#/components/schemas/PrintDataUrl'
                        examples:
                            '200':
                                $ref: '#/components/examples/PrintDataUrl'
            security:
                - bearerAuth: []
            responses:
                '202':
                    description: >-
                        Print data accepted. Further checks will be done and communicated through the status.
                    content:
                        application/json:
                            schema:
                                description: A Message to inform about having Data received.
                                type: object
                                required:
                                    - message
                                properties:
                                    message:
                                        type: string
                                        description: Message Text
                            examples:
                                '202':
                                    $ref: '#/components/examples/202DataReceived'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
    '/{country}/v2/orders/{order_id}/print_data/status':
        get:
            summary: Order Print Data Status
            operationId: getOrderPrintDataStatus
            description: Returns the status of the last uploaded PrintData.
            tags:
                - Orders - Print Data
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/order_id'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: The current status of print data.
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderPrintDataStatus'
                            examples:
                                PrintDataProcessing:
                                    summary: Processing
                                    description: Print data check is in progress.
                                    value:
                                        order_upload_status: Processing
                                PrintDataAccepted:
                                    summary: Print Data Check accepted
                                    description: The uploaded print data was accepted.
                                    value:
                                        order_upload_status: Data accepted
                                PrintDataRejected:
                                    summary: Print Data Check rejected
                                    description: The uploaded print data was rejected.
                                    value:
                                        order_upload_status: Data rejected
                                        reasons:
                                            - "Page1: [[ reason for rejection ]]"
                                            - "Page2: [[ reason for rejection ]]"
                                            - "Page99: [[ reason for rejection ]]"
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
    '/{country}/v2/orders/{order_id}/invoice/email':
        post:
            operationId: postOrderChangeInvoiceEmail
            summary: Change Invoice Email Address
            description: Changes the email address of the invoice for an existing order.
            tags:
                - Orders
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/order_id'
            requestBody:
                description: Provide new email address
                content:
                    application/x-www-form-urlencoded:
                        schema:
                            type: object
                            properties:
                                email_address:
                                    type: string
                    application/json:
                        schema:
                            $ref: '#/components/schemas/InvoiceEmailAddress'
                        examples:
                            '200':
                                $ref: '#/components/examples/InvoiceEmailAddress'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: >-
                        Order invoice email address was changed
                    content:
                        application/json:
                            schema:
                                description: A Message to infom about having invoice email address changed.
                                type: object
                                required:
                                    - message
                                properties:
                                    message:
                                        type: string
                                        description: Message Text
                            examples:
                                '200':
                                    summary: Order invoice email address was changed
                                    description: Order invoice email address was changed.
                                    value: {"message": "Order invoice email address was changed"}
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
    '/{country}/v2/orders/{order_id}/invoice/order_reference':
        post:
            operationId: postOrderChangeCustomerOrderReference
            summary: Add additional reference text to the invoice (Deprecated)
            description: Adds additional reference text to the customers invoice. Only possible for single invoicing.
            deprecated: true
            tags:
                - Orders
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/order_id'
            requestBody:
                description: Provide new order reference
                content:
                    application/x-www-form-urlencoded:
                        schema:
                            type: object
                            properties:
                                customer_order_reference:
                                    type: string
                    application/json:
                        schema:
                            $ref: '#/components/schemas/CustomerOrderReference'
                        examples:
                            '200':
                                $ref: '#/components/examples/CustomerOrderReference'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: >-
                        Customer Order Reference Text was added
                    content:
                        application/json:
                            schema:
                                description: A Message to infom about having customer order reference text changed.
                                type: object
                                required:
                                    - message
                                properties:
                                    message:
                                        type: string
                                        description: Message Text
                            examples:
                                '200':
                                    summary: Customer Order Reference Text was added
                                    description: Customer Order Reference Text was added.
                                    value: {"message": "Customer Order Reference Text was added"}
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
    '/{country}/v2/orders/{order_id}/print_data/allowed_format':
        get:
            summary: Order Print Data allowed format
            operationId: getOrderPrintDataAllowedFormat
            description: Returns information about what type of files and formats can be uploaded for a specific order.
            tags:
                - Orders - Print Data
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/order_id'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: The current upload allowed status of an order.
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderPrintDataAllowedFormat'
                            examples:
                                '0':
                                    summary: Upload is no longer available
                                    description: Upload is no longer available
                                    value:
                                        status: false
                                '1':
                                    summary: Only single upload available
                                    description: Only single upload available
                                    value:
                                        status: true
                                        singleUploadMessage: "Single upload is available in PDF format. The PDF must contain 2 pages. Example 1 with front and back printing: a product like bundled business cards needs a PDF with 2 pages. Example 2 with front and empty back pages: a product like bundled business cards needs 2 pages, empty pages must be blank and not be omitted."
                                        numberOfPages: 2
                                '2':
                                    summary: Multiupload and single file upload available
                                    description: Multiupload and single file upload available
                                    value:
                                        status: true
                                        singleUploadMessage: "Single upload is available in PDF format. The PDF must contain 2 pages. Example 1 with front and back printing: a product like bundled business cards needs a PDF with 2 pages. Example 2 with front and empty back pages: a product like bundled business cards needs 2 pages, empty pages must be blank and not be omitted."
                                        numberOfPages: 2
                                        multiUploadMessage: "Multiple files may be bundled into a ZIP archive. The archive may contain PDF, JPEG or TIFF files, and exactly 2 files. Files from the archive must follow this format: 4 digits plus file extension. Example with front and back printing: a product like bundled business cards needs 4 files for upload: 0001.pdf, 0002.jpeg, 0003.tif, 0004.tiff."
                                        numberOfFiles: 2
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
    '/{country}/v2/orders/{order_id}/delivery_note':
        get:
            summary: Download delivery note
            operationId: getOrdersDeliveryNote
            description: Downloads delivery note to an existing order
            tags:
                - Delivery Notes
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/order_id'
            security:
                - bearerAuth: []
            responses:
                '202':
                    description: >-
                        Download delivery note as PDF.
                    content:
                        application/pdf:
                            schema:
                                type: string
                                format: binary
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Delivery note is missing
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404DeliveryNoteNotFound'
        post:
            summary: Upload delivery note
            operationId: postOrdersDeliveryNote
            description: 'Attaches delivery note to an existing order. (INFO: A custom delivery note can only be uploaded within the first 10 minutes after order creation. Delivery notes uploaded after this timeframe will be disregarded)'
            tags:
                - Delivery Notes
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/order_id'
            requestBody:
                description: Provide PDF
                content:
                    application/x-www-form-urlencoded:
                        schema:
                            type: object
                            properties:
                                delivery_note_url:
                                    type: string
                    multipart/form-data:
                        schema:
                            type: object
                            properties:
                                delivery_note:
                                    type: string
                                    format: binary
                    application/json:
                        schema:
                            description: A URL to fetch the delivery note.
                            type: object
                            properties:
                                delivery_note_url:
                                    type: string
                        examples:
                            '401':
                                $ref: '#/components/examples/DeliveryNoteUrl'
            security:
                - bearerAuth: []
            responses:
                '202':
                    description: >-
                        Delivery note data accepted.
                    content:
                        application/json:
                            schema:
                                description: A Message to infom about having Data received.
                                type: object
                                required:
                                    - message
                                properties:
                                    message:
                                        type: string
                                        description: Message Text
                            examples:
                                '202':
                                    $ref: '#/components/examples/202DataReceived'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
    '/{country}/v2/orders/check_print_data':
        post:
            summary: Push print data for checking
            description: |-
                Creates a print data check for a given quantity id in order to validate if printing is possible. This operation must be done before submitting an order.

                - When submitting for Old Catalog Product data use only the `quantity_id` field and the `print_data` file/url/binary
                - For New Catalog please use one of the following fields
                    - use `quantity_id` with the format `SG-XXXXXX_PV-XXXXXXXXXXXX_10`
                    - or use `variant_id` with the format `SG-XXXXXX_PV-XXXXXXXXXXXX` and `amount` field
                    - and the `print_data` file/url/binary
            tags:
                - Print Data Check
            parameters:
                - $ref: '#/components/parameters/country'
            operationId: postOrdersCheckPrintData
            requestBody:
                description: Provide print data url and configuration
                content:
                    application/x-www-form-urlencoded:
                        schema:
                            type: object
                            properties:
                                print_data_url:
                                    type: string
                                quantity_id:
                                    description: (Old Catalog) Defines the product variant and amount on which to test print data information
                                    type: string
                                    example: 8309386 or SG-525038_PV-M98E5DXJH8K5R4_10
                                variant_id:
                                    description: Defines the product variant on which to test print data information
                                    type: string
                                    example: 130331 or SG-525038_PV-M98E5DXJH8K5R4
                                amount:
                                    description: Defines the amount
                                    type: number
                                    example: 10
                    application/json:
                        schema:
                            $ref: '#/components/schemas/CheckPrintDataUrl'
                        examples:
                            OldCatalog:
                                $ref: '#/components/examples/CheckPrintDataUrl'
                            NewCatalog:
                                $ref: '#/components/examples/New_CheckPrintDataUrl'
                    multipart/form-data:
                        schema:
                            type: object
                            properties:
                                print_data:
                                    type: string
                                    format: binary
                                quantity_id:
                                    description: (Old Catalog) Defines the product variant and amount on which to test print data information
                                    type: string
                                    example: 8309386 or SG-525038_PV-M98E5DXJH8K5R4_10
                                variant_id:
                                    description: Defines the product variant on which to test print data information
                                    type: string
                                    example: 130331 or SG-525038_PV-M98E5DXJH8K5R4
                                amount:
                                    description: Defines the amount
                                    type: number
                                    example: 10
            security:
                - bearerAuth: []
            responses:
                '202':
                    description: Print data check created.Further checks will be done and communicated through the status
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/PrintDataCreatedMessage'
                            examples:
                                '202':
                                    summary: Print Data Check Created
                                    description: Print data check was created.
                                    value:
                                        data_check_id: "B3KEnO99gx68"
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
    '/{country}/v2/orders/print_data_checks/{print_data_check_id}':
        get:
            summary: Get print data status
            operationId: getOrderPrintDataCheck
            description: Returns the status of a Print data check.
            tags:
                - Print Data Check
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/print_data_check_id'
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: The current status of a print data check.
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/PrintDataCheckStatus'
                            examples:
                                PrintDataProcessing:
                                    summary: Processing
                                    description: Print data check is in progress.
                                    value:
                                        order_status_id: 0
                                        order_status: Processing
                                PrintDataAccepted:
                                    summary: Print Data Check accepted
                                    description: The uploaded print data was accepted.
                                    value:
                                        order_status_id: 1
                                        order_status: Data accepted
                                PrintDataRejected:
                                    summary: Print Data Check rejected
                                    description: The uploaded print data was rejected.
                                    value:
                                        order_status_id: 2
                                        order_status: Data rejected
                                        reasons:
                                            - "Page1: [[ reason for rejection ]]"
                                            - "Page2: [[ reason for rejection ]]"
                                            - "Page99: [[ reason for rejection ]]"
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '400':
                                    $ref: '#/components/examples/400BadRequest'
                '401':
                    description: Unauthorized
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '401':
                                    $ref: '#/components/examples/401TokenMissing'
                '403':
                    description: Forbidden
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '403':
                                    $ref: '#/components/examples/403InvalidCredentials'
                '404':
                    description: Not Found
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/Error'
                            examples:
                                '404':
                                    $ref: '#/components/examples/404NotFound'
    '/{country}/v2/webhooks':
        get:
            summary: Get webhook list
            operationId: getWebhooks
            description: Returns a list of webhooks for the specified country.
            tags:
                - Webhooks
            parameters:
                - $ref: '#/components/parameters/country'
            security:
                - bearerAuth: []
            responses:
                '200':
                    content:
                        application/json:
                            schema:
                                type: array
                                items:
                                    $ref: '#/components/schemas/WebhookEvent'
                            examples:
                                'List of webhooks': {}
                    description: ""
        post:
            summary: Create webhook
            operationId: createWebhooks
            description: Creates a new webhook for the specified country.
            tags:
                - Webhooks
            parameters:
                - $ref: '#/components/parameters/country'
            security:
                - bearerAuth: []
            requestBody:
                description: Provide webhook information
                content:
                    application/x-www-form-urlencoded:
                        schema:
                            type: object
                            required:
                                - url
                            properties:
                                url:
                                    type: string
                    application/json:
                        schema:
                            type: object
                            properties:
                                url:
                                    type: string
            responses:
                '200':
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/WebhookEvent'
                            examples:
                                'Created response':
                                    $ref: '#/components/examples/WebhookEvent'
                    description: ""
                '400':
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/CodeError'
                            examples:
                                'Url already exists':
                                    value:
                                        code: 400
                                        error: "A webhook entry with this URL already exists."
                                'Incorrect Url':
                                    value:
                                        code: 400
                                        error: "Please provide a valid URL starting with HTTPS."
                                'Max Webhooks per token':
                                    summary: Url already exists
                                    value:
                                        code: 400
                                        error: "You have reached the limit of webhooks per token."
                                'Url length':
                                    value:
                                        code: 400
                                        error: "Url max length is 256 characters."
                    description: ""
    '/{country}/v2/webhooks/{webhook_id}':
        delete:
            summary: Deactivate webhook
            operationId: deactivateWebhooks
            description: Deactivate a webhook for the specified country.
            tags:
                - Webhooks
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/webhook_id'
            security:
                - bearerAuth: []
            responses:
                '200':
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/WebhookEvent'
                            examples:
                                '200':
                                    $ref: '#/components/examples/WebhookEvent'
                    description: ""
                '404':
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/CodeError'
                            examples:
                                '404':
                                    summary: Webhook not found
                                    value:
                                        code: 404
                                        error: "Webhook not found"
                    description: ""
        patch:
            summary: Reactivate webhook
            operationId: reactivateWebhooks
            description: Reactivate a webhook for the specified country.
            tags:
                - Webhooks
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/webhook_id'
            security:
                - bearerAuth: []
            responses:
                '200':
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/WebhookEvent'
                            examples:
                                '200':
                                    $ref: '#/components/examples/WebhookEvent'
                    description: ""
                '404':
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/CodeError'
                            examples:
                                '404':
                                    summary: Webhook not found
                                    value:
                                        code: 404
                                        error: "Webhook not found"
                    description: ""
    '/{country}/v2/webhooks/{webhook_id}/test':
        post:
            summary: Send a test for a specific webhook type
            operationId: postWebhooksTest
            description: Sends a test event to the configured webhook endpoint for the specified webhook ID. This operation is intended to validate the configuration and ensure that the endpoint is capable of receiving and processing webhook events as expected.
            tags:
                - Webhooks
            parameters:
                - $ref: '#/components/parameters/country'
                - $ref: '#/components/parameters/webhook_id'
            security:
                - bearerAuth: []
            requestBody:
                description: Provide test data
                content:
                    application/x-www-form-urlencoded:
                        schema:
                            type: object
                            required:
                                - type
                            properties:
                                type:
                                    type: string
                                    enum:
                                        - 'DummyV1'
                                        - 'CheckPrintDataStatusV1'
                                        - 'OrderStatusV1'
                                        - 'PrintDataStatusV1'
                                        - 'TrackingLinksV1'
                    application/json:
                        schema:
                            type: object
                            properties:
                                type:
                                    type: string
                                    enum:
                                        - 'DummyV1'
                                        - 'CheckPrintDataStatusV1'
                                        - 'OrderStatusV1'
                                        - 'PrintDataStatusV1'
                                        - 'TrackingLinksV1'
            responses:
                '201':
                    description: Event was scheduled for sending.
                    content:
                        application/json:
                            schema:
                                type: object
                                properties:
                                    message:
                                        type: string
                                        description: Success message
                            examples:
                                'Event scheduled':
                                    value:
                                        message: "Event scheduled."
                '400':
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/CodeError'
                            examples:
                                'Event type incorrect':
                                    value:
                                        code: 404
                                        error: "Event type must be one of: ..."
                    description: ""
                '404':
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/CodeError'
                            examples:
                                'Webhook could not be found':
                                    value:
                                        code: 404
                                        error: "Webhook could not be found."
                    description: ""
components:
    securitySchemes:
        bearerAuth:
            type: http
            scheme: bearer
            bearerFormat: JWT
    parameters:
        quantity_id:
            name: quantity_id
            in: path
            description: Quantity Id
            required: true
            schema:
                type: string
        shipping_type_id:
            name: shipping_type_id
            in: path
            description: Shipping Type Id
            required: true
            schema:
                type: string
            examples:
                standard:
                    value: standard
                    summary: Standard
                express:
                    value: express
                    summary: Express
                overnight':
                    value: overnight
                    summary: Overnight
        webhook_id:
            name: webhook_id
            in: path
            description: Webhook Id (UUID)
            required: true
            schema:
                type: string
        country:
            name: country
            in: path
            description: Country code for which to operate in
            required: true
            schema:
                type: string
            examples:
                de:
                    value: de
                    summary: Germany
                at:
                    value: at
                    summary: Austria
                be:
                    value: be
                    summary: Belgium
                ch:
                    value: ch
                    summary: Switzerland
                dk:
                    value: dk
                    summary: Denmark
                es:
                    value: es
                    summary: Spain
                fi:
                    value: fi
                    summary: Finland
                fr:
                    value: fr
                    summary: France
                it:
                    value: it
                    summary: Italy
                nl:
                    value: nl
                    summary: Netherlands
                se:
                    value: se
                    summary: Sweden
                uk:
                    value: uk
                    summary: United Kingdom
                ae:
                    value: ae
                    summary: United Arab Emirates
                pt:
                    value: pt
                    summary: Portugal
                hr:
                    value: hr
                    summary: Croatia
                ro:
                    value: ro
                    summary: Romania
                lu:
                    value: lu
                    summary: Luxembourg
                ie:
                    value: ie
                    summary: Ireland
                hu:
                    value: hu
                    summary: Hungary
                pl:
                    value: pl
                    summary: Poland
                sk:
                    value: sk
                    summary: Slovakia
                cz:
                    value: cz
                    summary: Czech Republic
        order_id:
            name: order_id
            in: path
            description: Id of the Order
            required: true
            schema:
                type: string
            examples: {}
        product_group_id:
            name: product_group_id
            in: path
            description: Id of the requested ProductGroup
            required: true
            schema:
                type: string
            examples:
                '5758':
                    value: 5756
                    summary: Standard Flyers (Old Catalog)
                '7050':
                    value: 7050
                    summary: Standard business cards (Old Catalog)
                'SG-525038':
                    value: 'SG-525038'
                    summary: Bonuscards (New Catalog)
        amount:
            name: amount
            in: path
            required: true
            description: Number of items
            schema:
                type: number
        variant_id:
            name: variant_id
            in: path
            description: Id of the requested Product Variant
            required: true
            schema:
                type: string
            examples:
                '130331':
                    value: '130331'
                    summary: >-
                        Standard Flyers - 13 cm x 15 cm, 90gsm silk paper, 4/4 colour, no finish
                '363452':
                    value: '363452'
                    summary: >-
                        Standard business cards - 8.5 x 5.5cm, 300gsm silk paper, Double sided matt dispersion varnish, 4/0 colour, 1 design
                '253205':
                    value: '253205'
                    summary: >-
                        Adhäsionsfolie, weiß im Wunschformat
                'SG-525038_PV-0GSJ2SCNF3ZS6W':
                    value: SG-525038_PV-0GSJ2SCNF3ZS6W
                    summary: Bonuscards Variant
        custom_size_variant_id:
            name: custom_size_variant_id
            in: path
            description: Id of the requested Product Variant
            required: true
            schema:
                type: string
            examples:
                '253205':
                    value: '253205'
                    summary: >-
                        Adhäsionsfolie, weiß im Wunschformat
        custom_size_quantity_id:
            name: custom_size_quantity_id
            in: path
            description: Quantity id of a custom size product
            required: true
            schema:
                type: string
            examples:
                '253205':
                    value: '9388481'
                    summary: >-
                        Adhäsionsfolie, weiß im Wunschformat
        print_data_check_id:
            name: print_data_check_id
            in: path
            description: Print Data Check Id
            required: true
            schema:
                type: string
        simple_product:
            name: simple_product
            in: query
            description: Filter simple product groups (groups with a single variant)
            schema:
                type: string
            examples:
                "null":
                    value:
                    summary: All products (default)
                'true':
                    value: 'true'
                    summary: Show only simple products
                'false':
                    value: 'false'
                    summary: All except simple products
        catalog_type:
            name: catalog_type
            in: query
            description: Filter products response by catalog model type. The catalog model types are almost identical, usually only the IDs are now represented as string, or additional features.
            schema:
                type: string
            examples:
                'old':
                    value: 'old'
                    summary: Old catalog format (default)
                'new':
                    value: 'new'
                    summary: New catalog format
        go_live_date_from:
            name: go_live_date_from
            in: query
            description: "Filter by go_live_date field, example: 2024-01-01T10:10:00+00:00"
            schema:
                type: string
                format: date-time
        go_live_date_to:
            name: go_live_date_to
            in: query
            description: "Filter by go_live_date field, example: 2024-01-01T10:10:00+00:00"
            schema:
                type: string
                format: date-time
        last_change_date_from:
            name: last_change_date_from
            in: query
            description: "Filter by last_change_date field, example: 2024-01-01T10:10:00+00:00"
            schema:
                type: string
                format: date-time
        last_change_date_to:
            name: last_change_date_to
            in: query
            description: "Filter by last_change_date field, example: 2024-01-01T10:10:00+00:00"
            schema:
                type: string
                format: date-time
        has_variants:
            name: has_variants
            in: query
            description: Group is orderable or not (Filter on existance of variants)
            schema:
                type: string
            examples:
                "null":
                    value:
                    summary: Orderable groups (default)
                'false':
                    value: 'false'
                    summary: Not Orderable groups
        has_quantities:
            name: has_quantities
            in: query
            description: Filter on existance of quantites
            schema:
                type: string
            examples:
                "null":
                    value:
                    summary: Only variants with orderable quantites (default)
                'false':
                    value: 'false'
                    summary: Only variants with NO orderable quantites
        with_quantities:
            name: with_quantities
            in: query
            description: Attach quantities node for each variant
            schema:
                type: string
            examples:
                "null":
                    value:
                    summary: Remove quantities node (default)
                'true':
                    value: 'true'
                    summary: Attach quantities node for each variant
        sort:
            name: sort
            in: query
            description: Sorting
            schema:
                type: string
            examples:
                "null":
                    value:
                    summary: No sorting
                'id.asc':
                    value: 'id.asc'
                    summary: Sort by group id ascending
                'id.desc':
                    value: 'id.desc'
                    summary: Sort by group id descending
                'name.asc':
                    value: 'name.asc'
                    summary: Sort by group name ascending
                'name.desc':
                    value: 'name.desc'
                    summary: Sort by group name descending
        page:
            name: page
            in: query
            description: Page
            schema:
                type: number
    schemas:
        CodeError:
            description: An Error Description
            type: object
            properties:
                code:
                    type: number
                    description: Http Code
                error:
                    type: string
                    description: Error Message
        Error:
            description: An Error Description
            type: object
            properties:
                error:
                    type: string
                    description: Error Message
        CustomSizePrices:
            description: A URL to fetch the print data.
            type: object
            properties:
                width:
                    type: integer
                    description: Width
                height:
                    type: integer
                    description: Height
        CustomerOrderReference:
            description: A Customer Order Reference Text for the order.
            type: object
            properties:
                customer_order_reference:
                    type: string
                    description: A Customer Reference Text for the order.
        InvoiceEmailAddress:
            description: An Invoice Email Address for the order.
            type: object
            properties:
                invoice_email_address:
                    type: string
                    description: An Invoice Email Address for the order.
        ChangeAddresses:
            description: Addresses Description
            type: object
            required:
                - addresses
            properties:
                addresses:
                    $ref: '#/components/schemas/Addresses'
        OrderStatuses:
            description: The current status of an Order
            type: array
            items:
                type: object
                properties:
                    id:
                        type: integer
                    name:
                        type: string
        OrderStatus:
            description: The current status of an Order
            type: object
            required:
                - order_id
                - order_status_id
                - order_status
            properties:
                order_id:
                    type: string
                    description: Order number
                order_status_id:
                    type: integer
                    format: int32
                    description: Status Code
                order_status:
                    type: string
                    description: Status Message
                    enum:
                        - "Order accepted"
                        - "Printing data accepted"
                        - "In Production"
                        - "Shipping"
                        - "Printing data missing"
                        - "Printing data invalid"
                        - "Contact support"
                        - "Order canceled"
                tracking_numbers:
                    type: array
                    items:
                        type: string
                    description: Array of parcel tracking numbers
                tracking_urls:
                    type: object
                    additionalProperties:
                        type: string
                    description: Array of friendly parcel tracking urls
                carrier:
                    type: string
                    description: Status Message
                parcel_amount:
                    type: integer
                    description: Number of parcels
                quick_uploader:
                    type: string
                    description: URL for the visual quick uploader
                print_data_overview:
                    type: string
                    description: URL for the print data overview
                dispatch_date:
                    type: string
                    description: Dispatch date format d.m.Y
        OrderStatusNew:
            description: The current status of an Order (New Mapping)
            type: object
            required:
                - order_status_id
                - order_status
            properties:
                order_id:
                    type: string
                    description: Order number
                order_status_id:
                    type: integer
                    format: int32
                    description: Status Code
                order_status:
                    type: string
                    description: Status Message
                    enum:
                        - "Order accepted"
                        - "Printing data accepted"
                        - "In Production"
                        - "Shipping"
                        - "Printing data missing"
                        - "Printing data invalid"
                        - "Contact support"
                        - "Order canceled"
                        - "Ready for pickup"
                        - "Payment pending"
                        - "Payment accepted"
                        - "Print data uploaded"
                        - "Data check in progress"
                        - "Layout approval pending"
                        - "Layout approved"
                        - "Layout in progress"
                        - "Print approval missing"
                        - "Print approval given"
                        - "Refunded"
                        - "Order terminated"
                quick_uploader:
                    type: string
                    description: URL for the visual quick uploader
                print_data_overview:
                    type: string
                    description: URL for the print data overview
                dispatch_date:
                    type: object
                    properties:
                        from:
                            type: string
                            format: date-time
                            examples:
                                - '2025-01-01T00:00:00+02:00'
                        to:
                            type: string
                            format: date-time
                            examples:
                                - '2025-01-01T00:00:00+02:00'
                shipment_data:
                    type: array
                    description: Shipment Data
                    items:
                        type: object
                        properties:
                            id:
                                type: string
                                description: Parcel tracking ID
                            url:
                                type: string
                                description: Tracking URL
                            carrier:
                                type: string
                                description: Carrier name
                            created:
                                type:
                                    - string
                                    - 'null'
                                format: date-time
                                description: Creation timestamp
                        examples:
                            - id: "Parcel1"
                              url: "https://ups.com/?loc=de_DE&ref=Parcel1"
                              carrier: "UPS"
                              created: null
                            - id: "Parcel2"
                              url: "https://dhl.com/?loc=de_DE&ref=Parcel2"
                              carrier: "DHL"
                              created: "2025-01-01T00:00:00+02:00"
                            - id: "Parcel3"
                              url: "https://dhl.com/?loc=de_DE&ref=Parcel3"
                              carrier: "DHL"
                              created: "2025-01-01T00:00:00+02:00"
        ____________________________________________Print-Data-Section______________________________________________:
            type: object
        CheckPrintDataUrl:
            description: A URL to fetch the print data.
            type: object
            properties:
                quantity_id:
                    type: string
                    description: Quantity Id
                print_data_url:
                    type: string
                    description: A URL to fetch the print data
                variant_id:
                    description: Defines the product variant on which to test print data information
                    type: string
                    example: 130331 or SG-525038_PV-M98E5DXJH8K5R4
                amount:
                    description: Defines the amount
                    type: number
                    example: 10
        OrderPrintDataStatus:
            description: The current status of uploaded Print Data
            type: object
            required:
                - order_upload_status
            properties:
                order_upload_status:
                    type: string
                    description: Status Message
        PrintDataCheckStatus:
            description: The current status of an Print Data Check
            type: object
            required:
                - order_status_id
                - order_status
            properties:
                order_status_id:
                    type: integer
                    format: int32
                    description: Status Code
                order_status:
                    type: string
                    description: Status Message
                reasons:
                    type: array
                    description: List of reasons why the upload failed
                    examples:
                        - ["Page1: [[ reason for rejection ]]", "Page2: [[ reason for rejection ]]", "Page99: [[ reason for rejection ]]"]
        PrintDataCreatedMessage:
            description: A Message to infom about print data check created.
            type: object
            required:
                - data_check_id
            properties:
                data_check_id:
                    type: string
                    description: Message Text
        PrintDataUrl:
            description: A URL to fetch the print data.
            type: object
            properties:
                print_data_url:
                    type: string
                    description: A URL to fetch the print data
        '_____________________________________________Product-Data-Section____________________________________________':
            type: object
        ProductGroups:
            description: >-
                Retrieves a paginated list of groups
            type: object
            properties:
                data:
                    type: array
                    items:
                        anyOf:
                            - $ref: '#/components/schemas/ProductGroup'
                            - $ref: '#/components/schemas/New_ProductGroup'
                        discriminator:
                            propertyName: new_catalog
                            mapping:
                                'false': '#/components/schemas/ProductGroup'
                                'true': '#/components/schemas/New_ProductGroup'
                meta:
                    $ref: '#/components/schemas/meta'
        OrderSummary:
            description: >-
                Order summary
            type: object
            properties:
                order_id:
                    type: string
                    description: Identifying ID for an order
                country:
                    type: string
                    description: Country where the order was placed
                created_at:
                    type: string
                    format: date-time
                    description: Creation date
                reference_text:
                    type: string
                    description: Customer defined order id or internal reference
                shipment_type:
                    type: string
                    enum:
                        - standard
                        - express
                        - overnight
                addresses:
                    type: array
                    description: TODO
                dispatch_date:
                    type:
                        - 'array'
                        - 'null'
                product_type:
                    type: string
                    description: Product type
                    enum:
                        - standard
                        - custom_sizes
                        - textile_with_sizes
                status:
                    type: object
                    description: TODO
                product_information:
                    type: object
                    description: TODO
                final_price:
                    type: number
                    description: Final price (product price plus option prices)
                currency:
                    type: string
                    example: EUR
                currency_symbol:
                    type: string
        OrdersSummary:
            description: >-
                Retrieves a paginated list of orders
            type: object
            properties:
                data:
                    type: array
                    items:
                        $ref: '#/components/schemas/OrderSummary'
                meta:
                    $ref: '#/components/schemas/meta'
        ProductGroup:
            $ref: '#/components/schemas/ProductGroup'
        New_ProductGroup:
            $ref: '#/components/schemas/New_ProductGroup'
        Categories:
            $ref: '#/components/schemas/Categories__schemas'
        New_Categories:
            $ref: '#/components/schemas/New_Categories__schemas'
        Variants:
            description: >-
                Retrieves a paginated list of variants
            type: object
            properties:
                data:
                    type: array
                    items:
                        anyOf:
                            - $ref: '#/components/schemas/Variant'
                            - $ref: '#/components/schemas/New_Variant'
                        discriminator:
                            propertyName: new_catalog
                            mapping:
                                'false': '#/components/schemas/Variant'
                                'true': '#/components/schemas/New_Variant'
                meta:
                    $ref: '#/components/schemas/meta'
        Variant:
            $ref: '#/components/schemas/Variant'
        New_Variant:
            $ref: '#/components/schemas/New_Variant'
        Quantity:
            $ref: '#/components/schemas/Quantity__schemas'
        New_Quantity:
            $ref: '#/components/schemas/New_Quantity__schemas'
        Shipping:
            $ref: '#/components/schemas/Shipping__schemas'
        Attribute:
            $ref: '#/components/schemas/Attribute__schemas'
        New_Attribute:
            $ref: '#/components/schemas/New_Attribute__schemas'
        AttributeDetails:
            description: Configurator response
            type: object
            properties:
                attributes:
                    type: object
                    additionalProperties:
                        type: object
                        properties:
                            name:
                                type: string
                                description: Attribute name
                            values:
                                type: object
                                additionalProperties: true
                variants:
                    type: object
                    properties:
                        count:
                            type: integer
                            description: Number of combinations possible
                        result:
                            type:
                                - string
                                - number
                            description: Represents a Variant Id. Available only if count = 1 (only 1 combination is possible).
        meta:
            type: object
            properties:
                previous:
                    type:
                        - 'number'
                        - 'null'
                    description: Previous page
                next:
                    type:
                        - 'number'
                        - 'null'
                    description: Next page
                limit:
                    type: number
                    description: Pagination limit
                total:
                    type: number
                    description: Total number of items
                filters:
                    type: object
                    description: List of active filters
        '__________________________________________Print-Data-Format-Section__________________________________________':
            type: object
        OrderPrintDataAllowedFormat:
            description: The upload allowed status of an Order
            type: object
            required:
                - status
            properties:
                status:
                    type: boolean
                    description: Upload of print data is allowed for this order
                singleUploadMessage:
                    type: string
                    description: If single upload supported - Readable text with explanation and examples on how upload should be organized.
                numberOfPages:
                    type: integer
                    description: Number of pages needed in single upload PDF
                multiUploadMessage:
                    type: string
                    description: If zip upload supported - Readable text with explanation and examples on how upload should be organized.
                numberOfFiles:
                    type: integer
                    description: Number of files needed in multi upload ZIP
        VariantPrintDataAllowedFormat:
            description: The upload allowed status of a Product Variant
            type: object
            required:
                - status
            properties:
                status:
                    type: boolean
                    description: No uploads required for this type of product variant
                singleUploadMessage:
                    type: string
                    description: If single upload supported - Readable text with explanation and examples on how upload should be organized.
                multiUploadMessage:
                    type: string
                    description: If zip upload supported - Readable text with explanation and examples on how upload should be organized.
        '______________________________________________Webhooks-Section______________________________________________':
            type: object
        EventDummyV1:
            $ref: '#/components/schemas/EventDummyV1__schemas'
        EventCheckPrintDataStatusV1:
            $ref: '#/components/schemas/EventCheckPrintDataStatusV1__schemas'
        EventPrintDataStatusV1:
            $ref: '#/components/schemas/EventPrintDataStatusV1__schemas'
        EventOrderStatusV1:
            $ref: '#/components/schemas/EventOrderStatusV1__schemas'
        TrackingLinksV1:
            $ref: '#/components/schemas/TrackingLinksV1__schemas'
        EventDummyV1__schemas:
            properties:
                type:
                    type: string
                    description: Event name
                    examples:
                        - DummyV1
                submitted_at:
                    type: string
                    format: date-time
                    description: CEST date of event creation
                    examples:
                        - '2025-01-01T00:00:00+02:00'
                message:
                    type: string
                    description: Message
                    examples:
                        - 'Hello world'
        EventOrderStatusV1__schemas:
            properties:
                type:
                    type: string
                    description: Event name
                    example: OrderStatusV1
                submitted_at:
                    type: string
                    format: date-time
                    description: CEST date of event creation
                    examples:
                        - '2025-01-01T00:00:00+02:00'
                order_id:
                    type: string
                    description: Order Id
                    example: DE123456789
                order_status_id:
                    type: number
                    description: Status Id
                    example: 10
                order_status:
                    type: string
                    description: Status Name
                    enum:
                        - "Order accepted"
                        - "Printing data accepted"
                        - "In Production"
                        - "Shipping"
                        - "Printing data missing"
                        - "Printing data invalid"
                        - "Contact support"
                        - "Order canceled"
                        - "Ready for pickup"
                        - "Payment pending"
                        - "Payment accepted"
                        - "Print data uploaded"
                        - "Data check in progress"
                        - "Layout approval pending"
                        - "Layout approved"
                        - "Layout in progress"
                        - "Print approval missing"
                        - "Print approval given"
                        - "Refunded"
                        - "Order terminated"
                    example: Order accepted
        EventCheckPrintDataStatusV1__schemas:
            properties:
                type:
                    type: string
                    description: Event name
                    examples:
                        - CheckPrintDataStatusV1
                submitted_at:
                    type: string
                    format: date-time
                    description: CEST date of event creation
                    examples:
                        - '2025-01-01T00:00:00+02:00'
                data_check_id:
                    type: string
                    description: Unique identifies for the print data check
                    examples:
                        - B3KEnO99gx68
                order_upload_status_id:
                    type: number
                    enum:
                        - 0
                        - 1
                        - 2
                order_upload_status:
                    type: string
                    enum:
                        - "Processing"
                        - "Data accepted"
                        - "Data rejected"
                reasons:
                    type: array
                    description: List of reasons why the upload failed
                    examples:
                        - ["Page1: [[ reason for rejection ]]", "Page2: [[ reason for rejection ]]", "Page99: [[ reason for rejection ]]"]
        EventPrintDataStatusV1__schemas:
            properties:
                type:
                    type: string
                    description: Event name
                    example: PrintDataStatusV1
                submitted_at:
                    type: string
                    format: date-time
                    description: CEST date of event creation
                    examples:
                        - '2025-01-01T00:00:00+02:00'
                order_id:
                    type: string
                    description: Order Id
                    example: DE123456789
                order_upload_status_id:
                    type: number
                    enum:
                        - 0
                        - 1
                        - 2
                order_upload_status:
                    type: string
                    enum:
                        - "Processing"
                        - "Data accepted"
                        - "Data rejected"
                reasons:
                    type: array
                    description: List of reasons why the upload failed
                    examples:
                        - ["Page1: [[ reason for rejection ]]", "Page2: [[ reason for rejection ]]", "Page99: [[ reason for rejection ]]"]
        TrackingLinksV1__schemas:
            properties:
                type:
                    type: string
                    description: Event name
                    example: TrackingLinksV1
                submitted_at:
                    type: string
                    format: date-time
                    description: CEST date of event creation
                    example: '2025-01-01T00:00:00+02:00'
                order_id:
                    type: string
                    description: Order Id
                    example: DE123456789
                carrier:
                    type: string
                    description: Carrier Name
                    example: UPS
                shipment_data:
                    type: array
                    description: Shipment Data
                    items:
                        type: object
                        properties:
                            id:
                                type: string
                                description: Parcel tracking ID
                            url:
                                type: string
                                description: Tracking URL
                            carrier:
                                type: string
                                description: Carrier name
                            created:
                                type:
                                    - string
                                    - 'null'
                                format: date-time
                                description: Creation timestamp
                        examples:
                            - id: "Parcel1"
                              url: "https://ups.com/?loc=de_DE&ref=Parcel1"
                              carrier: "UPS"
                              created: null
                            - id: "Parcel2"
                              url: "https://dhl.com/?loc=de_DE&ref=Parcel2"
                              carrier: "DHL"
                              created: "2025-01-01T00:00:00+02:00"
                            - id: "Parcel3"
                              url: "https://dhl.com/?loc=de_DE&ref=Parcel3"
                              carrier: "DHL"
                              created: "2025-01-01T00:00:00+02:00"
        CustomSizeVariant:
            type: object
            properties:
                currency:
                    type: string
                    description: Currency Identifier for prices.
                currencySymbol:
                    type: string
                    description: Currency for prices.
                quantities:
                    type: array
                    items:
                        $ref: '#/components/schemas/CustomSizeQuantity'
        Order:
            description: An Order Description
            type: object
            required:
                - reference_text
                - shipping_type
                - payment
                - addresses
            properties:
                quantity_id:
                    type: string
                    description: A valid QuantityId
                    examples:
                        - "8309386"
                        - "SG-525038_PV-M98E5DXJH8K5R4_10"
                variant_id:
                    type: string
                    description: A valid VariantId
                    examples:
                        - "130331"
                        - "SG-525038_PV-M98E5DXJH8K5R4"
                amount:
                    type: number
                    description: Amount to order, to be used in combination with variant_id
                    examples:
                        - 100
                        - 25000
                shipping_type:
                    type: string
                    description: Choose shipping type.
                    enum:
                        - standard
                        - express
                        - overnight
                payment:
                    type: string
                    description: Choose payment type.
                    enum:
                        - prepayment
                        - invoice
                        - debit
                reference_text:
                    type: string
                    description: Reference Text to be linked to this order
                    maxLength: 255
                invoice_email_address:
                    type: string
                    description: An Invoice Email Address for the order.
                customer_order_reference:
                    type: string
                    description: A Customer Order Reference Text for the order.
                options:
                    type: object
                    additionalProperties:
                        type:
                            - string
                            - number
                    description: A list of configurable option ids see productOptions endpoint. If it's left empty we will prefill it based on quantity id and shipping type
                    examples:
                        - "112": 810018
                        - "SG-526126": "PV-DTY0Q2H4290D66"
                custom_size:
                    type: object
                    description: A list of custom sizes in mm format
                    properties:
                        width:
                            type: number
                        height:
                            type: number
                    examples:
                        - width: 1000
                          height: 1000
                        - width: 2000
                          height: 2000
                additionalOptionData:
                    type: object
                    properties:
                        numbering:
                            type: object
                            properties:
                                fromValue:
                                    type: string
                                    description: The starting value for numbering
                                    examples:
                                        - '100'
                        textileSizes:
                            type: object
                            additionalProperties:
                                type: number
                            description: A list of textile sizes and their amounts
                            examples:
                                - size_s: 1
                                - size_m: 1
                                - size_l: 1
                                - size_xl: 1
                        deliveryAddresses:
                            type: array
                            items:
                                $ref: '#/components/schemas/MultipleDeliveryAddress'
                addresses:
                    $ref: '#/components/schemas/Addresses'
        WebhookEvent:
            properties:
                id:
                    type: string
                    description: Uuid
                    examples:
                        - 8f949d7e-5c7d-45f3-8642-87092797e669
                url:
                    type: string
                    description: Url
                    examples:
                        - https://flyeralarm.webhook
                created_at:
                    type: string
                    description: Creation date time
                    format: date-time
                    examples:
                        - '2025-01-01T00:00:00+02:00'
                deactivated_at:
                    type:
                        - 'null'
                        - string
                    description: A null value indicates that the webhook is active
                    format: date-time
                    examples:
                        - '2025-01-01T00:00:00+02:00'
                signing_key:
                    type: string
                    description: A signing key used to verify the webhook signature
                    examples:
                        - a7f011f02a732f973ba1996afda29583677b9f9444021251cf78d4d39dd6d407
        Addresses:
            description: A set of addresses for an Order
            type: object
            required:
                - delivery
                - invoice
            properties:
                delivery:
                    $ref: '#/components/schemas/Address'
                invoice:
                    $ref: '#/components/schemas/Address'
                sender:
                    $ref: '#/components/schemas/Address'
        ProductGroup__schemas:
            description: >-
                The extended representation of one ProductGroup
            type: object
            title: ProductGroup
            allOf:
                - $ref: '#/components/schemas/BaseProductGroup'
                - type: object
                  properties:
                    id:
                        type: number
                        description: Identifying ID for a ProductGroup
                    categories:
                        type: array
                        items:
                            $ref: '#/components/schemas/Categories__schemas'
                    new_catalog:
                        type: boolean
                        description: >-
                            A flag that shows catalog type
        New_ProductGroup__schemas:
            description: >-
                The extended representation of one ProductGroup
            type: object
            title: New_ProductGroup
            allOf:
                - $ref: '#/components/schemas/BaseProductGroup'
                - type: object
                  properties:
                    id:
                        type: string
                        description: Identifying ID for a ProductGroup
                    categories:
                        type: array
                        items:
                            $ref: '#/components/schemas/New_Categories__schemas'
                    new_catalog:
                        type: boolean
                        description: >-
                            A flag that shows catalog type
        Categories__schemas:
            description: Categories can be used to sort the ProductGroups into a hierarchy.
            type: object
            properties:
                id:
                    type: number
                name:
                    type: string
        New_Categories__schemas:
            description: Categories can be used to sort the ProductGroups into a hierarchy.
            type: object
            properties:
                id:
                    type: string
                name:
                    type: string
        Variant__schemas:
            title: Variant
            description: >-
                A ProductVariant represents one distinct product with defined features / Attributes. (Detailed Version)
            type: object
            allOf:
                - $ref: '#/components/schemas/BaseVariant'
                - type: object
                  properties:
                    id:
                        type: number
                        description: Identifying ID for a ProductVariant
                    group_id:
                        type: number
                        description: Group ID for a ProductVariant
                    quantities:
                        type: array
                        items:
                            $ref: '#/components/schemas/Quantity__schemas'
                    attributes:
                        type: array
                        items:
                            $ref: '#/components/schemas/Attribute__schemas'
                    new_catalog:
                        type: boolean
                        description: >-
                            A flag that shows catalog type
        New_Variant__schemas:
            title: New_Variant
            description: >-
                A ProductVariant represents one distinct product with defined features / Attributes. (Detailed Version)
            type: object
            allOf:
                - $ref: '#/components/schemas/BaseVariant'
                - type: object
                  properties:
                    id:
                        type: string
                        description: Identifying ID for a ProductVariant
                    group_id:
                        type: string
                        description: Group ID for a ProductVariant
                    quantities:
                        type: array
                        items:
                            $ref: '#/components/schemas/New_Quantity__schemas'
                    attributes:
                        type: array
                        items:
                            $ref: '#/components/schemas/New_Attribute__schemas'
                    new_catalog:
                        type: boolean
                        description: >-
                            A flag that shows catalog type
        Quantity__schemas:
            allOf:
                - $ref: '#/components/schemas/BaseQuantity'
                - type: object
                  properties:
                    id:
                        type: number
                        description: Identifying ID for a ProductQuantity
        New_Quantity__schemas:
            allOf:
                - $ref: '#/components/schemas/BaseQuantity'
                - type: object
                  properties:
                    id:
                        type: string
                        description: Identifying ID for a ProductQuantity
                    weightUnit:
                        type: string
                        description: Weight unit.
                        example: kg
        Shipping__schemas:
            description: >-
                Describes the type of shipping and also contains price information and delivery times.
            type: object
            properties:
                type:
                    type: string
                    description: Shipping types
                from:
                    type: integer
                    format: int32
                    description: Minimum number of days to be processed
                to:
                    type: string
                    description: Maximum number of days to be processed
                deadline:
                    type: string
                    description: Hour deadline for data acceptance (print data uploaded, data check in order, print approval given, payment confirmed)
                price:
                    type: number
                    format: float
                    description: Net Price
                msrp_price:
                    type: number
                    format: float
                    description: Recommended retail price
        Attribute__schemas:
            title: Attribute
            description: A representation of physical features of the print product.
            type: object
            properties:
                attribute_name_id:
                    type: number
                    description: Identifying ID for an attribute name
                attribute_name:
                    type: string
                    description: Attribute name
                attribute_value_id:
                    type: number
                    description: Identifying ID for an attribute value
                attribute_value:
                    type: string
                    description: Attribute value
                is_custom_size:
                    type: boolean
                    description: Attribute value
                width:
                    type: object
                    description: Minimum and maximum dimensions are in millimetres
                    properties:
                        min:
                            type: integer
                        max:
                            type: integer
                height:
                    type: object
                    description: Minimum and maximum dimensions are in millimetres
                    properties:
                        min:
                            type: integer
                        max:
                            type: integer
        New_Attribute__schemas:
            title: New_Attribute
            description: A representation of physical features of the print product.
            type: object
            properties:
                attribute_name_id:
                    type: string
                    description: Identifying ID for an attribute name
                attribute_name:
                    type: string
                    description: Attribute name
                attribute_value_id:
                    type: string
                    description: Identifying ID for an attribute value
                attribute_value:
                    type: string
                    description: Attribute value
        BaseVariant:
            type: object
            properties:
                data_sheet:
                    type: string
                    description: URL to the Flyeralarm branded PDF data sheet
                data_sheet_wl:
                    type: string
                    description: URL to the Whitelabel PDF data sheet
                data_sheet_custom_format:
                    type: string
                    description: Template URL to the Flyeralarm branded PDF data sheet (available only for custom format products)
                print_data_upload_required:
                    type: boolean
                    description: \'true\' if data sheet is provided
                has_quantities:
                    type: boolean
                    description: >-
                        A flag to show if the ProductGroup has configurations that can be ordered.
                version:
                    type: string
                    description: >-
                        The current version identifier. If it changes, updating may be required.
                certificates:
                    type: array
                    items:
                        type: string
        CustomSizeQuantity:
            description: >-
                A Quantity represents one distinct product with defined features / Attributes plus the quantity that shall be delivered. (ID is required for ordering a print product.)
            type: object
            properties:
                id:
                    type: number
                    description: Identifying ID for a ProductQuantity
                quantity:
                    type: number
                    description: Amount of individual items
                weight:
                    type: number
                    format: float
                    description: Weight of the package.
                shippings:
                    type: array
                    description: List of available shipping options
                    items:
                        $ref: '#/components/schemas/CustomSizeShipping'
        Address:
            description: An Address
            type: object
            required:
                - first_name
                - last_name
                - address
                - postcode
                - city
                - phone_1
            properties:
                company:
                    type:
                        - 'string'
                        - 'null'
                    description: Company Name
                gender:
                    type:
                        - 'string'
                        - 'null'
                    description: Gender
                first_name:
                    type: string
                    description: First Name
                last_name:
                    type: string
                    description: First Name
                address:
                    type: string
                    description: Address
                address_add:
                    type:
                        - 'string'
                        - 'null'
                    description: Address added information
                postcode:
                    type: string
                    description: ZIP or Postcode
                city:
                    type: string
                    description: City name
                county:
                    type:
                        - 'string'
                        - 'null'
                    description: County
                locale:
                    type:
                        - 'string'
                        - 'null'
                    description: Country-code_Language-code
                phone_1:
                    type: string
                    description: Phone number
                customer_type:
                    type: string
                    description: Customer Type
                vat_number:
                    type:
                        - 'string'
                        - 'null'
                    description: VAT Number
                tax_number:
                    type:
                        - 'string'
                        - 'null'
                    description: Tax Number
                country:
                    type:
                        - 'string'
                        - 'null'
                    description: Country (defaults to the endpoint country)
        MultipleDeliveryAddress:
            title: Multiple Delivery Address
            description: Similar to an address object but with an additional field quantity
            type: object
            allOf:
                - $ref: '#/components/schemas/Address'
                - type: object
                  properties:
                    quantity:
                        type: number
                        default: 1
                        description: The partial amount that needs to be delivered to this address. If the order has 1000 items this field specifies how many of them should be delivered to this address.
        GPRSInformation:
            type: object
            properties:
                url:
                    type: string
                name:
                    type: string
        History:
            description: Node contains details about go live date or last change date (last change is calculated by comparing group hashes)
            type: object
            properties:
                go_live_date:
                    type: string
                    format: date-time
                last_change_date:
                    type: string
                    format: date-time
        BaseProductGroup:
            properties:
                name:
                    type: string
                    description: The ProductGroup's name
                description:
                    type: string
                    description: A text description. May contain HTML tags.
                description_html:
                    type: string
                    description: Description in HTML format
                categories:
                    type: array
                    items:
                        $ref: '#/components/schemas/Categories__schemas'
                gpsr_information:
                    type: array
                    items:
                        $ref: '#/components/schemas/GPRSInformation'
                    description: Information regarding the manufacturer and product and safety instructions
                type:
                    type: string
                    description: >
                        Product Type possible values:

                         * `standard` - Default type.
                         * `custom_sizes` - Products that can be configured with a custom size.
                         * `textile_with_sizes` - Products that are textiles with sizes.
                    enum:
                        - standard
                        - custom_sizes
                        - textile_with_sizes
                image:
                    type: string
                    description: A URL to an image.
                simple_product:
                    type: boolean
                    description: States if a group has only 1 ProductVariant
                version:
                    type: string
                    description: >-
                        The current version identifier. If it changes, updating may be required.
                history:
                    $ref: '#/components/schemas/History'
                has_variants:
                    type: boolean
                    description: >-
                        A flag to show if the ProductGroup has configurations that can be ordered.
        BaseQuantity:
            description: >-
                A Quantity represents one distinct product with defined features / Attributes plus the quantity that shall be delivered. (ID is required for ordering a print product.)
            type: object
            properties:
                quantity:
                    type: number
                    description: Amount of individual items
                currency:
                    type: string
                    description: Currency Identifier for prices.
                currencySymbol:
                    type: string
                    description: Currency for prices.
                weight:
                    type: number
                    format: float
                    description: Weight of the package.
                estimatedNumberOfPackages:
                    type: number
                    description: Estimated number of packages to be delivered.
                isDigitalPrint:
                    type: boolean
                    description: A flag to show if the Quantity is a digital print.
                shippings:
                    type: array
                    description: List of available shipping options
                    items:
                        $ref: '#/components/schemas/Shipping__schemas'
                vat:
                    type: number
                    format: float
                    description: VAT percentage
                has_shipping:
                    type: boolean
                    description: A flag to show if the Quantity has amounts that can be ordered.
        CustomSizeShipping:
            description: >-
                Describes the type of shipping and also contains price information.
            type: object
            properties:
                type:
                    type: string
                    description: Shipping types
                price:
                    type: number
                    format: float
                    description: Net Price
                msrp_price:
                    type: number
                    format: float
                    description: Recommended retail price
                vat:
                    type: number
                    format: float
                    description: VAT percentage
    examples:
        202DataReceived:
            summary: Data received
            description: The data was received and will be processed.
            value:
                message: "Data Received"
        400BadRequest:
            summary: Bad Request
            description: 'The request setup (headers, parameters or body) are not a valid query.'
            value:
                code: 400
                error: "Bad Request"
        401TokenMissing:
            summary: JWT Token missing
            description: The requested resource was not authorised with a valid JWT token.
            value:
                code: 401
                error: "JWT Token missing"
        403InvalidCredentials:
            summary: Invalid Credentials
            description: The requested resource was not authorised with a valid JWT token.
            value:
                code: 403
                error: "Invalid Credentials"
        404NotFound:
            summary: Not Found
            description: >-
                The requested resource was not found or the authorised user has no access.
            value:
                code: 404
                error: "Not Found"
        500InternalServerError:
            summary: Internal Server Error
            description: >-
                There was a problem with the request.
            value:
                code: 500
                error: "Internal Server Error"
        404DeliveryNoteNotFound:
            summary: Delivery note not uploaded
            description: >-
                Delivery note was not uploaded or missing.
            value:
                code: 404
                error: "Shipment with number [ORDER_ID] could not be found"
        ChangeAllAddressesDE:
            summary: Change all addresses - DE
            description: >-
                Changes delivery, invoice and sender addresses.
            value: |-
                {
                    "delivery": {
                        "company": "CHANGED FLYERALARM GmbH",
                        "first_name": "CHANGED Max",
                        "last_name": "CHANGED Musterfrau",
                        "address": "Alfred-Nobel-Straße 18",
                        "address_add": null,
                        "postcode": "97080",
                        "city": "Würzburg",
                        "country": "de",
                        "phone_1": "+49 123 456789"
                    },
                    "invoice": {
                        "company": "CHANGED FLYERALARM GmbH",
                        "first_name": "CHANGED Max",
                        "last_name": "Musterfrau",
                        "address": "CHANGED Alfred-Nobel-Straße 18",
                        "address_add": null,
                        "postcode": "97080",
                        "city": "Würzburg",
                        "county": null,
                        "locale": null,
                        "phone_1": "+49 123 456789",
                        "customer_type": 3,
                        "vat_number": null,
                        "tax_number": null
                    },
                    "sender": {
                        "company": "CHANGED FLYERALARM GmbH",
                        "first_name": "CHANGED Max",
                        "last_name": "CHANGED Musterfrau",
                        "address": "Alfred-Nobel-Straße 18",
                        "address_add": null,
                        "postcode": "97080",
                        "city": "Würzburg",
                        "country": "de",
                        "phone_1": "+49 123 456789"
                    }
                }
        Variant:
            $ref: '#/components/examples/Variant'
        New_Variant:
            $ref: '#/components/examples/New_Variant'
        EmptyAttributes:
            summary: Empty Selection
            description: No Attributes are selected. Start from fresh.
            value: '{}'
        SelectedAttributes:
            summary: Selected 2 Attributes
            description: No Attributes are selected. Start from fresh.
            value:
                '4184': "20816"
                '4185': "20817"
        DeliveryNoteUrl:
            summary: Delivery Note URL
            description: The URL at witch a delivery note can be downloaded.
            value:
                delivery_note_url: "https://flyeralarm.com/test.pdf"
        PrintDataUrl:
            summary: Print Data JSON
            description: The URL at witch print data can be downloaded.
            value:
                print_data_url: "https://flyeralarm.com/test.pdf"
        CheckPrintDataUrl:
            summary: Check Print Data via JSON
            description: The URL at witch print data can be downloaded.
            value:
                quantity_id: "123123123 or SG-525038_PV-M98E5DXJH8K5R4_10"
                print_data_url: "https://flyeralarm.com/test.pdf"
        New_CheckPrintDataUrl:
            summary: Check Print Data via JSON
            description: The URL at witch print data can be downloaded.
            value:
                variant_id: "130331 or SG-525038_PV-M98E5DXJH8K5R4"
                amount: 10
                print_data_url: "https://flyeralarm.com/test.pdf"
        AttributeDetailsMultiple:
            summary: Attribute Details with mutiple combinations.
            description: Attribute Details with mutiple combinations.
            value:
                attributes:
                    "9681":
                        name: Ausführung
                        values:
                            "45885": mit Boden
                            "45890": ohne Boden
                    "9682":
                        name: Geschlossenes Endformat
                        values:
                            "45901": DIN A6 (10,5 x 14,8 cm)
                            "45891": DIN lang (9,8 x 21 cm)
                            "45900": DIN A5 (14,8 x 21 cm)
                            "45886": 9,8 x 16,2 cm
                            "49474": 14,8 x 21 cm
                    "78":
                        name: Material
                        values:
                            "352": 230 g Silverstar®
                            "349": 250 g Perlmuttkarton
                            "353": 300 g Bilderdruck matt
                            "39151": 300 g Bilderdruck matt PEFC
                            "60279": 300 g Gmund Used 0
                            "60280": 300 g Gmund Used 0 FSC®
                            "47541": 300 g Naturpapier creme
                            "47543": 300 g Naturpapier creme FSC®
                            "47544": 300 g Recyclingpapier
                            "47545": 300 g Recyclingpapier FSC®
                            "45887": 400 g Bilderdruck matt
                            "45899": 400 g Bilderdruck matt PEFC
                    "79":
                        name: Veredelung
                        values:
                            "350": keine Veredelung
                            "81719": beidseitig wasserbasierter Schutzlack matt
                            "354": einseitig folienkaschiert matt
                            "45892": beidseitig folienkaschiert matt
                            "355": einseitiger UV-Lack glänzend
                            "45893": einseitiger partieller UV-Lack glänzend
                            "34321": Soft-Feel einseitig folienkaschiert matt
                            "45895": Soft-Feel beidseitig folienkaschiert matt
                            "45896": Heißfolie Gold
                            "45898": Heißfolie Silber
                    "80":
                        name: Farbigkeit
                        values:
                            "351": 4/0-farbig
                            "47542": 4+F/0-farbig
                            "51746": 4+L/0-farbig
                            "45889": 4/4-farbig
                            "45894": 4+L/4-farbig
                            "45897": 4+F/4-farbig
                variants:
                    count: 96
        AttributeDetailsSingle:
            summary: Attribute Details with a single combination.
            description: Attribute Details with a single combination.
            value:
                attributes:
                    "9681":
                        name: Ausführung
                        values:
                            "45890": ohne Boden
                    "9682":
                        name: Geschlossenes Endformat
                        values:
                            "45901": DIN A6 (10,5 x 14,8 cm)
                    "78":
                        name: Material
                        values:
                            "45899": 400 g Bilderdruck matt PEFC
                    "79":
                        name: Veredelung
                        values:
                            "45895": Soft-Feel beidseitig folienkaschiert matt
                    "80":
                        name: Farbigkeit
                        values:
                            "45889": 4/4-farbig
                variants:
                    count: 1
                    result: 731847
        InvoiceEmailAddress:
            summary: Invoice Email Address
            description: The Email Address of the invoice which will be added to the order.
            value:
                email_address: "test123@test.com"
        CustomerOrderReference:
            summary: Customer Order Reference Text
            description: The Customer Order Reference Text which will be added to the order.
            value:
                customer_order_reference: "Customer Order Reference Text Example"
        CustomSizePrices:
            summary: Custom size width and height
            description: Prices are being fetched based on width and height.
            value:
                width: 10002
                height: 10003
        OldCatalog:
            value:
                id: 5756
                name: Flyers
                description: Description of the product
                description_html: <p>Description of the product</p>
                categories:
                    - id: 1
                      name: Print Product
                image: https://cdn.flyeralarm.com/products/random.jpg
                type: standard
                has_variants: true
                history:
                    go_live_date: '2024-01-01 00:00:00'
                    last_change_date: '2024-01-01 00:00:00'
                new_catalog: false
                version: 60860b3ab78b24c979a3cf9b10760d9e44173861
        NewCatalog:
            value:
                id: SG-525038
                name: Bonus Cards
                description: Description of the product
                description_html: <p>Description of the product with html</p>
                categories:
                    - id: 1
                      name: Print Product
                image: https://cdn.flyeralarm.com/products/random.jpg
                type: standard
                has_variants: true
                history:
                    go_live_date: '2024-01-01 00:00:00'
                    last_change_date: '2024-01-01 00:00:00'
                new_catalog: true
                version: 60860b3ab78b24c979a3cf9b10760d9e44173861
        CustomSizeVariantMultiple:
            summary: Prices
            description: Prices
            value:
                currency: "EUR"
                currencySymbol: "€"
                quantities:
                    - id: 9388471
                      quantity: 1
                      weight: 0.2
                      shippings:
                        - type: standard
                          price: 51.90
                          msrp_price: 51.90
                          vat: 0
                    - id: 9388472
                      quantity: 2
                      weight: 0.4
                      shippings:
                        - type: standard
                          price: 103.80
                          msrp_price: 103.80
                          vat: 0
        CustomSizeVariant:
            summary: Prices
            description: Prices
            value:
                currency: "EUR"
                currencySymbol: "€"
                quantities:
                    - id: 9388471
                      quantity: 1
                      weight: 0.2
                      shippings:
                        - type: standard
                          price: 51.90
                          msrp_price: 51.90
                          vat: 0
        AtomicOrder:
            summary: Atomic Order - General
            description: >-
                The simplest order one may send for 100 x Standard Flyers - 13 cm x 15 cm, 90gsm silk paper, 4/4 colour, no finish.
            value:
                quantity_id: "8309386"
                shipping_type: "standard"
                payment: "prepayment"
                reference_text: "ORD-123456789"
                addresses:
                    delivery:
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        postcode: "97080"
                        city: "Würzburg"
                        phone_1: "+49 123 456789"
                    invoice:
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        postcode: "97080"
                        city: "Würzburg"
                        phone_1: "+49 123 456789"
        AtomicOrderIT:
            summary: Atomic Order - IT
            description: >-
                The simplest order one may send for 100 x Standard Flyers - 13 cm x 15 cm, 90gsm silk paper, 4/4 colour, no finish.
            value:
                quantity_id: "8309386"
                shipping_type: "standard"
                payment: "prepayment"
                reference_text: "ORD-123456789"
                addresses:
                    delivery:
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        postcode: "97080"
                        city: "Würzburg"
                        phone_1: "+49 123 456789"
                    invoice:
                        customer_type: "3"
                        tax_number: "45785458965"
                        vat_number: "02151254845"
                        recipient_code: "0000000"
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        postcode: "97080"
                        city: "Würzburg"
                        phone_1: "+49 123 456789"
        AtomicOrderES:
            summary: Atomic Order - ES
            description: >-
                The simplest order one may send for 100 x Standard Flyers - 13 cm x 15 cm, 90gsm silk paper, 4/4 colour, no finish.
            value:
                quantity_id: "8309386"
                shipping_type: "standard"
                payment: "prepayment"
                reference_text: "ORD-123456789"
                addresses:
                    delivery:
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        postcode: "97080"
                        city: "Würzburg"
                        phone_1: "+49 123 456789"
                    invoice:
                        customer_type: "1"
                        tax_number: "AAAAAA11A66A231A"
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        postcode: "97080"
                        city: "Würzburg"
                        phone_1: "+49 123 456789"
        AtomicOrderBE:
            summary: Atomic Order - BE
            description: >-
                The simplest order one may send for 100 x Standard Flyers - 13 cm x 15 cm, 90gsm silk paper, 4/4 colour, no finish.
            value:
                quantity_id: "8309386"
                shipping_type: "standard"
                payment: "prepayment"
                reference_text: "ORD-123456789"
                addresses:
                    delivery:
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        postcode: "1234"
                        city: "Würzburg"
                        phone_1: "+49 123 456789"
                    invoice:
                        vat_number: "BE0123456789"
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        postcode: "1234"
                        city: "Würzburg"
                        phone_1: "+49 123 456789"
        SimpleOrder:
            summary: Simple Order
            description: >-
                A simple order one may send for 100 x Standard Flyers - 13 cm x 15 cm, 90gsm silk paper, 4/4 colour, no finish.
            value:
                quantity_id: "8309386"
                shipping_type: "standard"
                payment: "prepayment"
                reference_text: "ORD-123456789"
                addresses:
                    delivery:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                    invoice:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                        customer_type: null
                        vat_number: null
                        tax_number: null
        ExtendedOrder:
            summary: ExtendedOrder
            description: >-
                Extended order v2 for 100 x Standard Flyers - 13 cm x 15 cm, 90gsm silk paper, 4/4 colour, no finish.
            value:
                quantity_id: "8309386"
                shipping_type: "standard"
                payment: "prepayment"
                reference_text: "ORD-123456789"
                addresses:
                    delivery:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                    invoice:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Julia"
                        last_name: "Mustermann"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                        customer_type: null
                        vat_number: null
                        tax_number: null
                    sender:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Peter"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
        OrderWithQuantitySpecificOptions:
            summary: Order with Quantity specific options
            description: >-
                Each quantity Id has multiple configurable options. If no options are specified the default with be auto prefilled. If only some options are sent, they will be merged with default ones. See <strong>"Get Product Options"</strong> request for available options per shipping type.
            value:
                quantity_id: "8309386"
                shipping_type: "standard"
                payment: "prepayment"
                options:
                    "24": 24002
                    "3": 3001
                    "125": 810027
                    "127": 810034
                    "141": 810070
                    "147": 1430012
                    "102": 102001
                reference_text: "ORD-123456789"
                addresses:
                    delivery:
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        postcode: "97080"
                        city: "Würzburg"
                        phone_1: "+49 123 456789"
                    invoice:
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        postcode: "97080"
                        city: "Würzburg"
                        phone_1: "+49 123 456789"
        OrderWithMultipleDeliveryAddresses:
            summary: Order with multiple delivery addresses
            description: >-
                Orders for some quantity ids can be delivered to multiple addresses. To be able to set the addresses, the "Multiple Delivery Addresses" with the according number of addresses option must be set.
            value:
                quantity_id: "13615802"
                shipping_type: "standard"
                payment: "prepayment"
                reference_text: "TEST_ORD"
                options:
                    "102": 102002
                additionalOptionData:
                    deliveryAddresses:
                        - company: "FLYERALARM GmbH"
                          gender: null
                          first_name: "Max"
                          last_name: "Musterfrau"
                          address: "Alfred-Nobel-Straße 18"
                          address_add: null
                          postcode: "97080"
                          city: "Würzburg"
                          county: null
                          locale: null
                          phone_1: "+49 123 456789"
                          quantity: 2000
                        - company: "FLYERALARM GmbH"
                          gender: null
                          first_name: "Max"
                          last_name: "Musterfrau"
                          address: "Alfred-Nobel-Straße 18"
                          address_add: null
                          postcode: "97080"
                          city: "Würzburg"
                          county: null
                          locale: null
                          phone_1: "+49 123 456789"
                          quantity: 500
                addresses:
                    delivery:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                    invoice:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                        customer_type: null
                        vat_number: null
                        tax_number: null
        OrderWithNumbering:
            summary: Order with numbering Option
            description: >-
                Orders for some quantity ids allow numbering. To be able to set the numbering, the "Numbering" with the according "fromValue" must be set.
            value:
                quantity_id: "13228340"
                shipping_type: "standard"
                payment: "prepayment"
                reference_text: "ORD_123456789"
                options:
                    "84": 84001
                    "85": 85002
                    "86": 86001
                additionalOptionData:
                    numbering:
                        fromValue: "100"
                addresses:
                    delivery:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                    invoice:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                        customer_type: null
                        vat_number: null
                        tax_number: null
        OrderWithCustomSize:
            summary: Order with custom size attributes
            description: >-
                Orders for some quantity IDs must contain custom sizes. To be able to set the size, the "Custom size" with the according width and height options must be set. The values "width" and "height" must be provided in mm.
            value:
                quantity_id: "9388471"
                shipping_type: "standard"
                payment: "prepayment"
                reference_text: "ORD-123456789"
                custom_size:
                    width: 1000
                    height: 1000
                addresses:
                    delivery:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                    invoice:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                        customer_type: null
                        vat_number: null
                        tax_number: null
        OrderWithTextileSizes:
            summary: Order with textile sizes
            description: >-
                Orders for some quantity IDs must contain textile sizes. To be able to set the sizes, the "Textile Sizes" with the according size and amount must be set. The textile size option must be set also.
            value:
                quantity_id: "18159780"
                shipping_type: "standard"
                payment: "prepayment"
                reference_text: "ORD_123456789"
                options:
                    "112": 810018
                additionalOptionData:
                    textileSizes:
                        size_s: 1
                addresses:
                    delivery:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                    invoice:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                        customer_type: null
                        vat_number: null
                        tax_number: null
        New_OrderWithQuantityId:
            summary: New Order with quantity Id
            value:
                quantity_id: "SG-525038_PV-M98E5DXJH8K5R4_10"
                shipping_type: "standard"
                payment: "prepayment"
                reference_text: "ORD-123456789"
                options:
                    "SG-526126": "PV-DTY0Q2H4290D66"
                addresses:
                    delivery:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                        customer_type: null
                        vat_number: null
                        tax_number: null
                    invoice:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                        customer_type: null
                        vat_number: null
                        tax_number: null
                    sender:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: ""
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                        customer_type: null
                        vat_number: null
                        tax_number: null
        New_OrderWithVariantIdAndAmount:
            summary: New Order with Variant Id and Amount
            value:
                variant_id: "SG-525038_PV-0GSJ2SCNF3ZS6W"
                amount: 10
                shipping_type: "standard"
                payment: "prepayment"
                reference_text: "ORD-123456789"
                options:
                    "SG-526126": "PV-DTY0Q2H4290D66"
                addresses:
                    delivery:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                        customer_type: null
                        vat_number: null
                        tax_number: null
                    invoice:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: "97080"
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                        customer_type: null
                        vat_number: null
                        tax_number: null
                    sender:
                        company: "FLYERALARM GmbH"
                        gender: null
                        first_name: "Max"
                        last_name: "Musterfrau"
                        address: "Alfred-Nobel-Straße 18"
                        address_add: null
                        postcode: ""
                        city: "Würzburg"
                        county: null
                        locale: null
                        phone_1: "+49 123 456789"
                        customer_type: null
                        vat_number: null
                        tax_number: null
        WebhookEvent:
            value:
                id: 8f949d7e-5c7d-45f3-8642-87092797e669
                url: https://flyeralarm.webhook
                created_at: '2025-01-01T00:00:00+02:00'
                deactivated_at: null
                signing_key: a7f011f02a732f973ba1996afda29583677b9f9444021251cf78d4d39dd6d407
        OldVariant:
            value:
                id: 130331
                group_id: 5756
                data_sheet: https://cdn.flyeralarm.com/datasheet/random.pdf
                data_sheet_wl: null
                data_sheet_custom_format: null
                print_data_upload_required: true
                has_quantities: true
                quantities:
                    - id: 8873464
                      quantity: 100
                      shippings:
                        - type: Standard
                          from: 4
                          to: 5
                          deadline: "12:00:00"
                          price: 10.99
                          msrp_price: 10.99
                      has_shipping: true
                      weight: 264.686
                      estimatedNumberOfPackages: 9
                      currency: "EUR"
                      currencySymbol: "€"
                      vat: 1.19
                new_catalog: false
                certificates: ['fsc', 'pefc']
                version: 619dd48c7c4644342888b62bbff48929be924c41
        NewVariant:
            value:
                id: "SG-525038_PV-0GSJ2SCNF3ZS6W"
                group_id: "SG-525038"
                data_sheet: https://cdn.flyeralarm.com/datasheet/random.pdf
                data_sheet_wl: null
                print_data_upload_required: true
                has_quantities: true
                quantities:
                    - id: "SG-525038_PV-0GSJ2SCNF3ZS6W_250000"
                      quantity: 250000
                      shippings:
                        - type: Standard
                          from: 4
                          to: 5
                          deadline: "12:00:00"
                          price: 100.99
                          msrp_price: 100.99
                      has_shipping: true
                      weight: 264.686
                      weightUnit: "kg"
                      estimatedNumberOfPackages: 9
                      currency: "EUR"
                      currencySymbol: "€"
                      vat: 1.19
                new_catalog: true
                certificates: ['fsc', 'pefc']
                version: 619dd48c7c4644342888b62bbff48929be924c41
security:
    - bearerAuth: []
tags:
    - name: Product Catalog
      description: Interfaces to browse the product catalog.
    - name: Product - Custom Sizes
      description: Additional interfaces related to products that support custom sizes
    - name: Product - Options
      description: Additional options related to product
    - name: Product - Print Data
      description: Allowed print data format at variant level
    - name: Orders
      description: Interfaces to ordering products.
    - name: Orders - Print Data
      description: Manage order print data.
    - name: Print Data Check
      description: Interfaces to check the print data before ordering.
    - name: Delivery Notes
      description: Interfaces to ordering products.
    - name: Webhooks
      description: Manages webhooks
