{
    "openapi": "3.1.0",
    "info": {
        "title": "ConnectUs 3PL REST API docs (V2)",
        "description": "ConnectUs 3PL REST API docs (V2)",
        "version": "2.0.1"
    },
    "servers": [
        {
            "url": "https://workspace.connectuscorp.com",
            "description": "Production"
        },
        {
            "url": "https://workspace-stage.connectuscorp.com",
            "description": "Staging / Sandbox"
        },
        {
            "url": "http://localhost",
            "description": "Localhost"
        }
    ],
    "paths": {
        "/api/v2/client/sales_order": {
            "post": {
                "tags": [
                    "Sales Orders"
                ],
                "summary": "Create Sales Order",
                "description": "Create a new Sales Order",
                "operationId": "createSalesOrder",
                "requestBody": {
                    "description": "Sales Order Data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateSalesOrderRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Sales Order created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_Response_SalesOrderCreatedResponseDTO"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "message": {
                                            "type": "string",
                                            "example": "Validation failed"
                                        },
                                        "errors": {
                                            "type": "object",
                                            "example": {
                                                "customer_po_no": [
                                                    "Customer PO No. is required."
                                                ],
                                                "items": [
                                                    "At least one item is required."
                                                ],
                                                "ship_address.country": [
                                                    "Country must be a 2-letter ISO code."
                                                ]
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Internal Server Error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "message": {
                                            "type": "string",
                                            "example": "An error occurred"
                                        },
                                        "errors": {
                                            "type": "object",
                                            "example": {
                                                "sales_order": [
                                                    "Couldn't create Sales Order. Please try again later."
                                                ]
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/X-Request-ID"
                    }
                ]
            }
        },
        "/api/v2/client/available_devices": {
            "get": {
                "tags": [
                    "Sales Orders"
                ],
                "summary": "Get available devices for a client",
                "operationId": "05d800d7ca550ef196200cbcfa775e03",
                "responses": {
                    "200": {
                        "description": "Available devices retrieved successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/App_Http_Resources_Api_V2_Client_AvailableDevicesListResource"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/X-Request-ID"
                    }
                ]
            }
        },
        "/api/v2/client/available_shipping_methods": {
            "get": {
                "tags": [
                    "Sales Orders"
                ],
                "summary": "Get available shipping methods",
                "description": "Retrieve a list of available shipping methods from OrderTime service",
                "operationId": "availableShippingMethods",
                "responses": {
                    "200": {
                        "description": "Shipping methods successfully retrieved",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_Response_AvailableShippingMethodsResponseDTO"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/X-Request-ID"
                    }
                ]
            }
        },
        "/api/v2/client/sales_order/{sales_order_id}": {
            "get": {
                "tags": [
                    "Sales Orders"
                ],
                "operationId": "getSalesOrder",
                "parameters": [
                    {
                        "name": "sales_order_id",
                        "in": "path",
                        "description": "Sales Order ID",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "$ref": "#/components/parameters/X-Request-ID"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Sales order details",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SalesOrderDetailedResponseDTO"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/v2/client/sales_order_statuses": {
            "get": {
                "tags": [
                    "Sales Orders"
                ],
                "summary": "Get sales order statuses",
                "description": "Retrieve a list of active sales order statuses",
                "operationId": "getSalesOrderStatuses",
                "responses": {
                    "200": {
                        "description": "Statuses successfully retrieved",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/App_Http_Resources_Universal_SalesOrderStatusesCollection"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "External Service Error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "message": {
                                            "type": "string"
                                        },
                                        "errors": {
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/X-Request-ID"
                    }
                ]
            }
        },
        "/api/v2/client/kits/{kit_id}/assembled": {
            "get": {
                "tags": [
                    "Assembled Kits"
                ],
                "summary": "Get list of assembled kits for a kit",
                "operationId": "676db377171361afd87b11a2337c7f06",
                "parameters": [
                    {
                        "name": "kit_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page number",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "description": "Items per page",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 15
                        }
                    },
                    {
                        "$ref": "#/components/parameters/X-Request-ID"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Assembled kits retrieved successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/App_Http_Resources_Api_V2_Client_AssembledKitListResource"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kit not found or not owned by customer"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/v2/client/projects/{project_id}/kits": {
            "get": {
                "tags": [
                    "3PL Projects"
                ],
                "summary": "Get list of kits for a project",
                "operationId": "9aa5e16310ebb17c51f3e1f65d1b8a73",
                "parameters": [
                    {
                        "name": "project_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page number",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "description": "Items per page",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 15
                        }
                    },
                    {
                        "$ref": "#/components/parameters/X-Request-ID"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Kits retrieved successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/App_Http_Resources_Api_V2_Client_KitListResource"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Project not found or not owned by customer"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/v2/client/projects": {
            "get": {
                "tags": [
                    "3PL Projects"
                ],
                "summary": "Get list of projects for the customer",
                "operationId": "34712fcd4a600d407240f211c14d6279",
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page number",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "description": "Items per page",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 15
                        }
                    },
                    {
                        "$ref": "#/components/parameters/X-Request-ID"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Projects retrieved successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/App_Http_Resources_Api_V2_Client_ProjectListResource"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/v2/client/search_sales_orders": {
            "post": {
                "tags": [
                    "Sales Orders"
                ],
                "summary": "Search sales orders",
                "description": "Search sales orders by Customer PO number or by Sales Order statuses",
                "operationId": "searchSalesOrders",
                "parameters": [
                    {
                        "name": "customer_po_no",
                        "in": "query",
                        "description": "Customer PO number",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "so_status",
                        "in": "query",
                        "description": "Sales order status IDs",
                        "required": false,
                        "schema": {
                            "type": "array",
                            "items": {
                                "type": "integer"
                            }
                        }
                    },
                    {
                        "$ref": "#/components/parameters/X-Request-ID"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Sales orders successfully retrieved",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_Response_SearchSalesOrdersResponseDTO"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Validation or External Service Error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "message": {
                                            "type": "string"
                                        },
                                        "errors": {
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        }
    },
    "components": {
        "schemas": {
            "PaginationMeta": {
                "title": "Pagination Meta",
                "description": "Standard pagination metadata object",
                "properties": {
                    "current_page": {
                        "type": "integer",
                        "example": 1
                    },
                    "last_page": {
                        "type": "integer",
                        "example": 5
                    },
                    "per_page": {
                        "type": "integer",
                        "example": 15
                    },
                    "total": {
                        "type": "integer",
                        "example": 70
                    }
                },
                "type": "object"
            },
            "App_DTO_V2_SalesOrder_CustomFieldsDTO": {
                "title": "Custom Fields",
                "required": [
                    "project_name"
                ],
                "properties": {
                    "email1": {
                        "type": "string",
                        "format": "email",
                        "example": "contact1@company.com"
                    },
                    "email2": {
                        "type": "string",
                        "format": "email",
                        "example": "contact2@company.com"
                    },
                    "shipping_insurance": {
                        "type": "boolean",
                        "example": true
                    },
                    "project_name": {
                        "type": "string",
                        "example": "Project Alpha"
                    },
                    "kit_name": {
                        "type": "string",
                        "example": "Starter Kit"
                    }
                },
                "type": "object"
            },
            "App_DTO_V2_SalesOrder_OrderItemDTO": {
                "title": "Order Item",
                "required": [
                    "sku",
                    "quantity"
                ],
                "properties": {
                    "sku": {
                        "description": "Item SKU",
                        "type": "string",
                        "example": "STR-12345"
                    },
                    "quantity": {
                        "description": "Quantity",
                        "type": "integer",
                        "example": 5,
                        "minimum": 1
                    }
                },
                "type": "object"
            },
            "App_DTO_V2_SalesOrder_Response_AvailableShippingMethodsResponseDTO": {
                "title": "Available Shipping Methods Response",
                "description": "List of available shipping methods",
                "properties": {
                    "message": {
                        "type": "string",
                        "example": "Shipping methods successfully retrieved"
                    },
                    "shippingMethods": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_ShippingMethodDTO"
                        }
                    }
                },
                "type": "object"
            },
            "App_DTO_V2_SalesOrder_Response_SalesOrderCreatedResponseDTO": {
                "title": "Sales Order created response",
                "properties": {
                    "message": {
                        "description": "Message",
                        "type": "string",
                        "example": "Sales Order Created Successfully"
                    },
                    "sales_order_number": {
                        "description": "Sales Order Number",
                        "type": "string",
                        "example": "SO-00001"
                    },
                    "customer_po_no": {
                        "description": "Customer PO No",
                        "type": "string",
                        "example": "CPO-00001"
                    }
                },
                "type": "object"
            },
            "SalesOrderDetailedResponseDTO": {
                "title": "Detailed Sales Order Response",
                "description": "Full information about sales order with shipping details and custom fields",
                "properties": {
                    "message": {
                        "type": "string",
                        "example": "Sales order successfully retrieved"
                    },
                    "id": {
                        "type": "integer",
                        "example": 12345
                    },
                    "status_id": {
                        "type": "integer",
                        "example": 20
                    },
                    "status_type": {
                        "type": "string",
                        "example": "Open"
                    },
                    "status": {
                        "type": "string",
                        "example": "Processing"
                    },
                    "customer_po_no": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "example": "PO-2025-789"
                    },
                    "shipping_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "delivery_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "shipping_method": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "shipping_instructions": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "ship_address": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_ShipAddressDTO",
                                "description": "Shipping Address"
                            },
                            {
                                "type": "null"
                            }
                        ],
                        "description": "Shipping Address"
                    },
                    "custom_fields": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_CustomFieldsDTO",
                                "description": "Custom Fields"
                            },
                            {
                                "type": "null"
                            }
                        ],
                        "description": "Custom Fields"
                    },
                    "ship_doc": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_ShipDocDTO"
                            },
                            {
                                "type": "null"
                            }
                        ],
                        "type": "object"
                    }
                },
                "type": "object"
            },
            "App_DTO_V2_SalesOrder_Response_SearchSalesOrdersResponseDTO": {
                "title": "Search Sales Orders Response",
                "description": "List of sales orders with optional shipping documents",
                "properties": {
                    "message": {
                        "type": "string",
                        "example": "Sales orders successfully retrieved"
                    },
                    "sales_orders": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_SalesOrderListItemDTO"
                        }
                    }
                },
                "type": "object"
            },
            "App_DTO_V2_SalesOrder_SalesOrderListItemDTO": {
                "title": "Sales Order List Item",
                "description": "Summary of a sales order",
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": 12345
                    },
                    "statusId": {
                        "type": "integer",
                        "example": 20
                    },
                    "statusType": {
                        "type": "string",
                        "example": "Open"
                    },
                    "status": {
                        "type": "string",
                        "example": "Processing"
                    },
                    "customerPoNo": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "example": "PO-998877"
                    },
                    "shipDoc": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_ShipDocDTO",
                                "description": "Shipping document details or empty array if none"
                            },
                            {
                                "type": "null"
                            }
                        ],
                        "description": "Shipping document details or empty array if none"
                    }
                },
                "type": "object"
            },
            "App_DTO_V2_SalesOrder_ShipAddressDTO": {
                "title": "Shipping Address",
                "description": "Shipping Address",
                "properties": {
                    "name_company": {
                        "type": "string",
                        "example": "My Company"
                    },
                    "street": {
                        "type": "string",
                        "example": "123 S 400"
                    },
                    "floor_suite": {
                        "type": "string",
                        "example": "Suite D"
                    },
                    "care_of": {
                        "type": "string",
                        "example": "Care Of Field"
                    },
                    "city": {
                        "type": "string",
                        "example": "Chicago"
                    },
                    "state": {
                        "type": "string",
                        "example": "IL"
                    },
                    "zip": {
                        "type": "string",
                        "example": "60007"
                    },
                    "country": {
                        "type": "string",
                        "example": "US"
                    },
                    "phone": {
                        "type": "string",
                        "example": "555-6666-777"
                    },
                    "alt_phone": {
                        "type": "string",
                        "example": "555-6666-888"
                    },
                    "email": {
                        "type": "string",
                        "format": "email",
                        "example": "test@connectuscorp.com"
                    },
                    "contact": {
                        "type": "string",
                        "example": "Main User"
                    },
                    "alt_contact": {
                        "type": "string",
                        "example": "Alt User"
                    },
                    "fax": {
                        "type": "string",
                        "example": "555-6666-777"
                    },
                    "website": {
                        "type": "string",
                        "example": "https://www.connectuscorp.com"
                    }
                },
                "type": "object"
            },
            "App_DTO_V2_SalesOrder_ShipDocDTO": {
                "title": "Ship Document Details",
                "description": "Ship Document Details",
                "properties": {
                    "trackingNo": {
                        "description": "Tracking number",
                        "type": [
                            "string",
                            "null"
                        ],
                        "example": "1Z9999999999999999"
                    },
                    "shippingMethod": {
                        "description": "Shipping method",
                        "type": [
                            "string",
                            "null"
                        ],
                        "example": "FedEx Ground"
                    },
                    "status": {
                        "description": "Status",
                        "type": [
                            "string",
                            "null"
                        ],
                        "example": "Shipped"
                    },
                    "shipDocId": {
                        "description": "Id of the ship document",
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 987654
                    },
                    "date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "example": "2026-02-10T14:30:00Z"
                    },
                    "items": {
                        "description": "Shipping doc items",
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_ShipDocItemDTO"
                        }
                    }
                },
                "type": [
                    "object",
                    "null"
                ]
            },
            "App_DTO_V2_SalesOrder_ShipDocItemDTO": {
                "title": "Ship Document Item",
                "description": "Ship Document Item",
                "properties": {
                    "sku": {
                        "type": "string",
                        "example": "SKU-DEV-001"
                    },
                    "group": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "example": "Devices"
                    },
                    "quantity": {
                        "type": "integer",
                        "example": 5
                    },
                    "iccid": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "example": "89452012345678901234"
                    },
                    "lotOrSerialNo": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "example": "LOT-2026-001"
                    },
                    "serialNo": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "example": "SN-987654321"
                    },
                    "linkedDocument": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "example": "DOC-REF-456"
                    }
                },
                "type": "object"
            },
            "App_DTO_V2_SalesOrder_ShippingMethodDTO": {
                "title": "Shipping Method Item",
                "description": "Shipping method details",
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": 12
                    },
                    "name": {
                        "type": "string",
                        "example": "FedEx Ground"
                    }
                },
                "type": "object"
            },
            "CreateSalesOrderRequest": {
                "title": "Create Sales Order Request",
                "description": "Create Sales Order Request",
                "required": [
                    "customer_po_no",
                    "items"
                ],
                "properties": {
                    "customer_po_no": {
                        "description": "Customer Purchase Order No.",
                        "type": "string",
                        "example": "PO-2024-001"
                    },
                    "items": {
                        "description": "Array of items",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_OrderItemDTO"
                        },
                        "minItems": 1
                    },
                    "ship_address": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_ShipAddressDTO"
                            },
                            {
                                "type": "null"
                            }
                        ]
                    },
                    "shipping_method": {
                        "description": "Shipping Method",
                        "type": [
                            "string",
                            "null"
                        ],
                        "example": "FedEx Ground Home Delivery - RPHD"
                    },
                    "shipping_instructions": {
                        "description": "Shipping Instructions",
                        "type": [
                            "string",
                            "null"
                        ],
                        "example": "Left at the door"
                    },
                    "custom_fields": {
                        "$ref": "#/components/schemas/App_DTO_V2_SalesOrder_CustomFieldsDTO"
                    }
                },
                "type": "object"
            },
            "App_Http_Resources_Api_V2_Client_AssembledKitListResource": {
                "title": "Assembled Kit List Response",
                "description": "List of assembled kits with pagination metadata",
                "properties": {
                    "data": {
                        "description": "List of assembled kits",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/App_Http_Resources_Api_V2_Client_AssembledKitResource"
                        }
                    },
                    "meta": {
                        "$ref": "#/components/schemas/PaginationMeta"
                    }
                },
                "type": "object"
            },
            "App_Http_Resources_Api_V2_Client_AssembledKitResource": {
                "title": "Assembled Kit Resource",
                "description": "TPL Assembled Kit information",
                "properties": {
                    "id": {
                        "description": "Assembled Kit ID",
                        "type": "integer"
                    },
                    "scanned_code": {
                        "description": "Scanned Code",
                        "type": "string"
                    },
                    "validated": {
                        "description": "Is validated",
                        "type": "boolean"
                    },
                    "activation_required": {
                        "description": "Is activation required",
                        "type": "boolean"
                    },
                    "status": {
                        "description": "Calculated status (active/pending/inactive)",
                        "type": "string"
                    },
                    "created_at": {
                        "description": "Created at",
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "type": "object"
            },
            "App_Http_Resources_Api_V2_Client_AvailableDeviceResource": {
                "title": "Available Device",
                "description": "Available device item",
                "properties": {
                    "sku": {
                        "description": "SKU",
                        "type": "string"
                    },
                    "description": {
                        "description": "Description",
                        "type": "string"
                    },
                    "available": {
                        "description": "Available quantity",
                        "type": [
                            "integer",
                            "null"
                        ],
                        "format": "int32"
                    },
                    "is_active": {
                        "description": "Is active",
                        "type": "boolean"
                    }
                },
                "type": "object"
            },
            "App_Http_Resources_Api_V2_Client_AvailableDevicesListResource": {
                "title": "Available Devices List Response",
                "description": "List of available devices",
                "properties": {
                    "data": {
                        "description": "Container with available entities",
                        "properties": {
                            "devices": {
                                "description": "Available devices",
                                "type": "array",
                                "items": {
                                    "$ref": "#/components/schemas/App_Http_Resources_Api_V2_Client_AvailableDeviceResource"
                                }
                            },
                            "projects": {
                                "description": "Available projects",
                                "type": "array",
                                "items": {
                                    "$ref": "#/components/schemas/App_Http_Resources_Api_V2_Client_AvailableProjectResource"
                                }
                            },
                            "kits": {
                                "description": "Available kits",
                                "type": "array",
                                "items": {
                                    "$ref": "#/components/schemas/App_Http_Resources_Api_V2_Client_AvailableKitResource"
                                }
                            }
                        },
                        "type": "object"
                    }
                },
                "type": "object"
            },
            "App_Http_Resources_Api_V2_Client_AvailableKitResource": {
                "title": "Available Kit",
                "description": "Available 3PL Kit for the customer",
                "properties": {
                    "name": {
                        "description": "SKU",
                        "type": "string"
                    },
                    "code": {
                        "description": "Description",
                        "type": "string"
                    }
                },
                "type": "object"
            },
            "App_Http_Resources_Api_V2_Client_AvailableProjectResource": {
                "title": "Available Project",
                "description": "Available 3PL Project for the customer",
                "properties": {
                    "name": {
                        "description": "SKU",
                        "type": "string"
                    }
                },
                "type": "object"
            },
            "App_Http_Resources_Api_V2_Client_KitListResource": {
                "title": "Kit List Response",
                "description": "List of kits with pagination metadata",
                "properties": {
                    "data": {
                        "description": "List of kits",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/App_Http_Resources_Api_V2_Client_KitResource"
                        }
                    },
                    "meta": {
                        "$ref": "#/components/schemas/PaginationMeta"
                    }
                },
                "type": "object"
            },
            "App_Http_Resources_Api_V2_Client_KitResource": {
                "title": "Kit Resource",
                "description": "TPL Kit information",
                "properties": {
                    "id": {
                        "description": "Kit ID",
                        "type": "integer"
                    },
                    "name": {
                        "description": "Kit Name",
                        "type": "string"
                    },
                    "code": {
                        "description": "Kit Code",
                        "type": "string"
                    },
                    "is_archived": {
                        "description": "Is Kit archived",
                        "type": "boolean"
                    }
                },
                "type": "object"
            },
            "App_Http_Resources_Api_V2_Client_ProjectListResource": {
                "title": "Project List Response",
                "description": "List of projects with pagination metadata",
                "properties": {
                    "data": {
                        "description": "List of projects",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/App_Http_Resources_Api_V2_Client_ProjectResource"
                        }
                    },
                    "meta": {
                        "$ref": "#/components/schemas/PaginationMeta"
                    }
                },
                "type": "object"
            },
            "App_Http_Resources_Api_V2_Client_ProjectResource": {
                "title": "Project Resource",
                "description": "TPL Project information",
                "properties": {
                    "id": {
                        "description": "Project ID",
                        "type": "integer"
                    },
                    "name": {
                        "description": "Project Name",
                        "type": "string"
                    },
                    "description": {
                        "description": "Project Description",
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "status": {
                        "description": "Project Status",
                        "type": "string"
                    },
                    "default_kit_id": {
                        "description": "Default Kit ID",
                        "type": [
                            "integer",
                            "null"
                        ]
                    }
                },
                "type": "object"
            },
            "App_Http_Resources_Universal_SalesOrderStatusesCollection": {
                "title": "Sales Order Statuses Collection",
                "description": "A collection of sales order statuses",
                "properties": {
                    "data": {
                        "description": "Class SalesOrderStatusesCollection",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/App_Http_Resources_Universal_SalesOrderStatusesResource"
                        }
                    },
                    "message": {
                        "type": "string",
                        "example": "Sales Order Statuses retrieved successfully."
                    }
                },
                "type": "object"
            },
            "App_Http_Resources_Universal_SalesOrderStatusesResource": {
                "title": "Sales Order Statuses Resource",
                "description": "A resource representing a sales order status",
                "properties": {
                    "id": {
                        "description": "The ID of the sales order status",
                        "type": "integer",
                        "example": 1
                    },
                    "name": {
                        "description": "The name of the sales order status",
                        "type": "string"
                    }
                },
                "type": "object"
            }
        },
        "parameters": {
            "X-Request-ID": {
                "name": "X-Request-ID",
                "in": "header",
                "description": "Idempotency / request tracing identifier",
                "required": false,
                "schema": {
                    "type": "string",
                    "example": "550e8400-e29b-41d4-a716-446655440000"
                }
            }
        },
        "securitySchemes": {
            "bearerAuth": {
                "type": "http",
                "description": "Bearer token authentication. Enter your customer token.",
                "scheme": "bearer"
            }
        }
    },
    "tags": [
        {
            "name": "Sales Orders",
            "description": "Sales Orders"
        },
        {
            "name": "Assembled Kits",
            "description": "Assembled Kits"
        },
        {
            "name": "3PL Projects",
            "description": "3PL Projects"
        }
    ]
}