POST
{micro_service_base_url}
/
orders
/
{order_id}
/
issues
{
  "success": true,
  "message": "<string>",
  "issue_id": "<string>",
  "issue_number": "<string>",
  "status": "<string>",
  "created_at": "<string>",
  "assigned_to": "<string>"
}
This endpoint allows you to create detailed issue reports for orders when problems occur. Issues can range from missing items and wrong products to delivery problems and customer complaints. Each issue is tracked with priority levels, attachments, and resolution workflows.
Issue tracking helps maintain service quality, resolve customer problems efficiently, and identify patterns that can improve operations.

​
Path Parameters

​
order_id
string
required
The unique identifier of the order where the issue occurred

​
Request Body

​
storeId
string
required
The unique identifier of the store where the issue occurred
​
reportedBy
string
required
Employee ID or user ID of the person reporting the issue
​
issue
object
required
Detailed issue information

​
Response

​
success
boolean
Indicates whether the issue was successfully created
​
message
string
Confirmation message or error details
​
issue_id
string
Unique identifier for the created issue
​
issue_number
string
Human-readable issue number for reference
​
status
string
Initial issue status (typically “open” or “investigating”)
​
created_at
string
Timestamp when the issue was created
​
assigned_to
string
Employee or team assigned to handle the issue

​
Request Example

{
  "storeId": "449235c1-3d04-4519-998b-40d2a621e5e0",
  "reportedBy": "b1e46bf5-0e29-4c7e-8ca1-0d7407c67169",
  "issue": {
    "order_item_id": "d2fe3e81-fb54-4d90-9c45-b0f3ed9ed1f1",
    "issue_type": "wrong_items",
    "description": "I ordered the DARK chocolate Muddy Bites and the 10oz bag of Peach Rings, but received milk chocolate and gummy bears instead",
    "priority": "medium",
    "attachments": [
      "https://lula-inventory-service-staging.s3.amazonaws.com/images/dad46dc1-6d6f-4a8f-9602-29f2f5c1231d/Candy/29b4ef50-eeb3-40cb-a04f-112e187fd06a_1732713277583.webp"
    ],
    "customer_contacted": true,
    "expected_resolution_time": "2024-01-15T18:00:00Z"
  }
}

​
Response Example

{
  "success": true,
  "message": "Issue successfully created and assigned for resolution",
  "issue_id": "issue_123456789",
  "issue_number": "ISS-2024-001234",
  "status": "open",
  "created_at": "2024-01-15T14:30:00Z",
  "assigned_to": "customer_service_team"
}
Automatic Assignment: Issues are automatically assigned to appropriate teams based on issue type and priority. High and critical priority issues trigger immediate notifications.
Evidence Collection: Always include attachments when possible. Photos and documentation help resolve issues faster and provide valuable feedback for process improvement.

​
Issue Creation Workflow

​
Use Cases

​
Error Responses

Critical Issues: For critical priority issues involving safety or major financial impact, consider following up with immediate phone or direct communication in addition to creating the issue record.