Return request denied

Webhook: return-request-rejected — OMS API · Webhooks

Sent when the return package is completely denied (seller denial or automatic denial process). packageStatusName is ReturnRequestDenied; the reason fields in the line carry the denial reason.

Delivery: OMS sends a POST to the address defined in the subscription. Responses other than 2xx are considered failures and retried up to the number of attempts in the subscription; the same event may occur multiple times, make processing safely repeatable (idempotent).

Field names: The body is serialized in PascalCase (HookName, PackageId) without authentication or with Basic Auth subscriptions, skipping null fields; with Bearer/API key subscriptions, it is serialized in camelCase. Read the body case-insensitively.

İstek gövdesi

• items (object[]): Lines in the return package. In confirmation events, lines come with Returned or ReturnRequestDenied.
  • items.orderItemLineId (string): The sourceOrderItemLineId value you sent for the line.
  • items.packageItemStatusId (integer<int32>): Line status ID.
  • items.packageItemStatusName (string): Line status name.
  • items.packageItemStatusReasonId (integer<int64>): Return reason ID on approval, denial reason ID on rejection.
  • items.packageItemStatusReasonDesc (string): Reason description.
  • items.packageItemStatusReasonName (string): Reason name.
• orderId (string): The orderId value you sent for the order.
• hookName (string): Event name.
• packageId (string): The sourcePackageId value of the package.
• packageType (string): Package type.
• packageStatusId (integer<int32>): Package status ID.
• parentPackageId (string): If the package is from splitting/partial cancellation, the source package ID; otherwise, the package's own ID.
• packageStatusName (string): Package status name (see OrderPackageStatus).
• packageStatusUser (string): Name of the user who changed the status.

Yanıtlar

• 200: Confirm receipt of the notification with a 2xx; the body is not read.
• 500: Any response other than 2xx is considered a failure and retried.