Shipment/Refund API – Open API

What do I do when uploading waybill number returns error: INVALID STATUS?

The following INVALID_STATUS error will be returned if you try to upload a waybill number to an order whose status is not processing (INSTRUCT). If the order is in payment complete(ACCEPT) status, ... See more

Is it possible to change the shipping address when the order is in the product in preparation status?

The shipping address can be changed by the customer at the stage of payment completion. After changing the status to Product in Preparation, YOU MUST look up and update individual orders to see if ... See more

The 'success' message was returned when calling the changing the status to product in preparation API, but in WING system continues to expose 'payment completed' status.

Due to a surge in incoming orders, some system delays may occur. Usually, even if there is a delay, it is processed within 30 minutes. If the status does not change after more than an hour of prepa... See more

I want to suspend shipment. What value do I enter for the "cancelCount" parameter?

The parameter “cancelCount” is the quantity to be suspended from shipment. Enter the count based on the registration # (receiptId). Ex) Q. My Customer asked me to suspend the shipment of 2 units of... See more

I see splitShipping and ableSplitShipping when collecting POs. I don't exactly know their difference.

- splitShipping: This shows whether the order has been split for shipping.- ableSplitShipping: This shows whether the order is eligible for split shipping.For more details about split shipping, see... See more

When I register a Direct Courier Delivery (DIRECT) waybill, it is not processed as Delivery Completed.

If you have entered Direct Courier Delivery (DIRECT) for your courier code, it will not be processed as Delivery Completed.This is a normal process, as the waybill cannot be tracked for this type.P... See more

Is partial cancellation reflected to a PO?

The shippingCount you can find when you query PO, is the initial purchase quantity where returned quantity is not reflected. You can find returned quantity from cancelCount. shippingCount = Pur... See more

When do I use "Shipment suspension API"?

Use it when you are not going to ship out a product as a customer requested before shipping out a product. (If you already dispatched a product, call [Shipment Complete API]) See more

An error message "Can not change the delivery status. Please check the order history" is exposed.

The error message is exposed when you have an order in the process of refund at entire or partial payment cancellation request. Please re-check the Purchase Order history. See more

When PO (Purchase Order) is collected, shipmentBoxId and orderId are exposed. I don't know the exact difference between the two.

When you create an order, an orderID (order number) is created.shipmentBoxId (bundled delivery number) is created per unit of bundled delivery of products in the order. See more

I don't know what salesPrice(per unit price), orderPrice(price to be paid), and discountPrice(discounted price) mean.

- salesPrice : per unit price of the product - orderPrice : salesPrice (per unit price) x shippingCount (order quantity)- discountPrice : discounted price after application of instant discount coup... See more

Can I suspend shipment by item instead of receiptId?

No, it is only by receiptId that you can suspend shipments or use the Process Already Shipped API. See more

'[INTERNAL_SERVER_ERROR] The cancellation/return quantity doesn't match cancelCount' occurred.

The quantity set for the cancellation request does not match that for shipment suspended.Please call the same quantity as requested. See more

Waybill upload failed. "Can't upload this waybill as its serial number is already registered in the system (it can be uploaded only if the recipient info is identical)."

Coupang runs a validity check on the waybill number to see if the same number has ever been registered over the recent six months. If your upload fails with an error message like this even when yo... See more

I want split a shipment.

I drafted an example for a split delivery. ex) Situation <When a customer purchased 2 different products for a bundled delivery but the products have to be shipped separately.> Let say, the product... See more

When I upload a waybill number into an order, a "500 internal exception" error was returned

This "500 internal exception" error is most likely caused by an invalid courier code. Please make sure you are using one of the courier code in the below page for the deliveryCompanyCode field. Co... See more

Is old address/new address system in ship-to-address not divided when you collect POs?

No, we do not separate old/new address system. See more

Cannot find return info in purchase order list.

Please use [Return Request Search list API] to view return details. If a return was issued for order A after it has been delivered, then return details will be recorded in both PO list and return r... See more

Is it possible to switch product delivery setting from split delivery to bundled delivery?

No, an order that has been processed as split delivery cannot be changed to bundled delivery. See more

An invalid delivery status error occurs.

Uploading a waybill whose delivery status is not "Product in Preparation (INSTRUCT)" will trigger this error. Please double-check if the status of your product in the waybill is "Product in Prepa... See more

I want to set conditional free shipping.

<Setting conditional free shipping>- You have to set the amount of basic delivery fee and return fee.- Make sure to set 0 won for initial shipping fee on return. - The delivery fee charged to a cus... See more

I cannot find the order that I just created.

Usually it takes around 10 minutes from payment for you to see the order in your order list.If you want to see it faster, you can search for the order one by one. See more

In case of custom-made products, the extraInfoMessage(guide message for custom-made products) has to be entered during the product creation stage. Can you also check this message in the purchase order?

Yes, you can find it in the etcInfoHeader parameter of purchase order. The etcInfoValues parameter shows the items entered in by the customer. See more

When do I use Process Already Shipped API?

You can use it when the cancellation status is RELEASE_STOP_UNCHECKED in the return request list. It is used when the product has already been shipped. The return process will begin once you proce... See more

What is the difference between date-based / time-based paging / shipmentBoxId / orderId in the PO list query API?

The data acquired is the same. The only difference is the query method. Please see below to understand the different methods and choose the method you prefer. ※ Guidelines on PO List Query API type... See more

The following error occurs in the midst of product integration. [code: VALIDATION , error: For general delivery products, the return shipping fee is limited to 100% to 150% of the initial shipping fee on return. Please change the return shipping fee.]

To return a free-shipping product, customers are charged "initial shipping fee on return + return shipping fee" for shipping.Charging the return shipping fee greater than the initial shipping fee o... See more

OPENAPI 관련 안내