Exchange
Provides an exchange service for products ordered by customers. It supports the exchange process for products whose orders have been completed, and also provides the ability to cancel an exchange while it is in progress. Once an exchange request is completed through this API, a notification about the exchange processing is sent to the customer.
Key Features
Exchange-Eligible Product Inquiry
Looks up products eligible for exchange among ordered/exchanged products, based on the order progress status (shipping completed or delivery completed).
Exchange Request Eligibility Check
Determines whether the selected single item option is eligible for exchange when filing an exchange request.
Withdrawal-Eligible Product Inquiry
Looks up products eligible for withdrawal, based on the exchange request progress status (payment pending, requested, or pickup instructed).
Exchange Information Provision
Provides the information needed when filing or withdrawing an exchange request.
Additional Cost and Payment/Refund Information Provision
Provides the recalculated additional cost, benefit, and expected payment/refund exchange delivery cost information when filing or withdrawing an exchange request.
Exchange Delivery Fee Management
If an exchange delivery fee is incurred when filing an exchange request, the status changes to payment pending and the customer is later asked to pay the delivery fee.
When an exchange is canceled, the paid exchange delivery fee is refunded.
Stock Processing
When an exchange request is filed, stock for the exchanged product is deducted; upon cancellation, the stock is restored.
Notification Delivery
Sends a notification to the customer after the exchange request is completed. (Email/AlimTalk/notification inbox)
Process Definition — Exchange Request Filing and List Inquiry
Process Definition — Exchange Withdrawal
API Function List
Exchange Request Withdrawal
Withdraws an exchange request. Refunds the amount paid at the time of the exchange request. Adjusts (restores) the stock that was deducted at the time of the exchange request.
BO
POST
Calls the Exchange Request Withdrawal (BO) API (/api/order/v1/claim/exchange/withdrawalExchange)
Exchange Claim Option Change Target Check
When filing an exchange request, looks up whether the single item option to be exchanged is eligible for exchange.
BO
POST
Calls the Exchange Target Product Option Change Eligibility Check API (/api/order/v1/claim/exchange/isExistsExchangeGoodsItm)
Return/Exchange Withdrawal Target Inquiry
Looks up return and exchange requests that are eligible for withdrawal.
BO
POST
Calls the Return/Exchange Withdrawal Target Inquiry API (/api/order/v1/claim/common/getReturnExchangeCancelTargetInfo)
Exchange Order List Inquiry
Looks up exchange request history matching the conditions.
BO
POST
Order Exchange Target Inquiry
Looks up products eligible for exchange among ordered products. Looks up the order information and common codes needed to proceed with filing an exchange request.
BO
POST
Calls the Exchange Target Inquiry (BO) API (/api/order/v1/claim/exchange/getExchageTargetInfo)
Exchange Request
Proceeds with filing an exchange request for the selected product. Depending on the exchange reason, an exchange delivery fee may be charged; if a cost is incurred, the request is saved in payment-pending status, and the customer is later asked to pay the delivery fee. Stock for the exchanged product is deducted, and a notification is sent to the customer once the exchange request is completed.
BO
POST
Calls the Exchange Request (BO) API (/api/order/v1/claim/exchange/acceptExchange)
Claim Cost Calculation Inquiry
Provides additional cost, benefit information, expected additional payment/refund amount, and coupon usage/restoration information for each claim task.
BO
POST
Delivery Number Assignment Processing
Assigns the new delivery number required when processing claim tasks.
BO
POST
Other Notes
Exchange requests can only be filed within the same delivery group.
When filing or canceling an exchange request, the processable order history status and order history classification values are checked. This information is managed as a common code. → ST007 (FO system claim-processable status) reference value 1 = order history status code → ST007 (FO system claim-processable status) reference value 2 = order history classification code
Exchange reasons are managed as a common code, and include information such as the fault classification and the applicable order history classification for each reason.
For products that include a gift, partial-quantity exchange is not possible.
If a payment method that does not allow partial cancellation was used at the time of order, only a full exchange is possible.
Exchange is only possible for general products (reserved products are not eligible) that are on sale at the same price.
Exchange is not possible if the product is out of stock.
If the exchange reason is attributable to the customer, an exchange delivery fee is charged.
If an exchange delivery fee is incurred, the order status is registered as payment pending, and the request proceeds once the customer pays the delivery fee directly.
When an exchange request is canceled, the paid exchange delivery fee is refunded.
When an exchange request is filed, stock for the exchanged product is deducted, and it is restored upon cancellation.
When canceling an exchange in the pickup-instructed status, the delivery instruction cancellation quantity is updated.
When viewing the exchange list, partner-access administrators only see the requests submitted by their own partner company.