Skip to main content

reportOrderIssue

Reports an operational issue against an order. Tags the order with an "OPS - {Label}" internal tag, appends a note, and optionally alerts the company's ops Slack channel and requests a reshipment.

Business Rules​

  • Available in any order status (no editable-status restriction)
  • Works for both V1 and V2 orders; the note's notable_type is set accordingly

Side Effects​

  • Internal tag OPS - {Label} added (idempotent: unarchives if archived, no-op if already active)
  • Note attached to the order with the issue label or reporter notes
  • Slack alert sent to the company's ops channel when sendSlackAlert: true and the company has the ops_issue_alerts setting enabled with a webhook configured (best-effort; failures are logged and the mutation still succeeds)
  • When reshipOrder: true, a warning is logged with the order id (duplicate-order workflow not yet implemented)

Error Scenarios​

  • **NOT_FOUND**: when orderId does not resolve to an order
  • **FORBIDDEN**: when caller lacks orders:report_issue

Permissions Required​

  • orders:report_issue
reportOrderIssue(
  input: ReportOrderIssueInput!
): Order!

Arguments​

reportOrderIssue.input ● ReportOrderIssueInput! non-null input common​

Parameters for ReportOrderIssue

Type​

Order object orders​

The order type. This type represents an order in the system.