주문 등록
curl --request POST \
--url https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"data": [
{
"warehouseId": 1,
"sender": {
"name": "홍길동",
"contact": "01012345678"
},
"recipient": {
"country": "US",
"name": "test kim",
"contact": "1235551234",
"address": "Centum jungang-ro, Haeundae-gu",
"addressDetail": "20F, 90",
"city": "Busan",
"state": "Busan",
"zipCode": "48059",
"email": "test@domain.co.kr",
"personalCustomsClearanceCode": "1234567890"
},
"orderInfo": {
"mallOrderNumber": "ORDER202501010001",
"carrier": "FEDEX",
"isExportDeclaration": true,
"domesticShippingNumber": "65434235223"
},
"packageInfo": {
"actualWeight": 3.26,
"quantity": 1,
"width": 11.76,
"length": 11.76,
"height": 11.76,
"serviceType": "POD"
},
"items": [
{
"name": "test item",
"price": 10000,
"currency": "KRW",
"quantity": 1,
"actualWeight": 3.22,
"hscode": "1234567890",
"itemUrl": "https://www.delivered.co.kr/en",
"itemCode": "1234567890"
}
]
}
]
}
'import requests
url = "https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders"
payload = { "data": [
{
"warehouseId": 1,
"sender": {
"name": "홍길동",
"contact": "01012345678"
},
"recipient": {
"country": "US",
"name": "test kim",
"contact": "1235551234",
"address": "Centum jungang-ro, Haeundae-gu",
"addressDetail": "20F, 90",
"city": "Busan",
"state": "Busan",
"zipCode": "48059",
"email": "test@domain.co.kr",
"personalCustomsClearanceCode": "1234567890"
},
"orderInfo": {
"mallOrderNumber": "ORDER202501010001",
"carrier": "FEDEX",
"isExportDeclaration": True,
"domesticShippingNumber": "65434235223"
},
"packageInfo": {
"actualWeight": 3.26,
"quantity": 1,
"width": 11.76,
"length": 11.76,
"height": 11.76,
"serviceType": "POD"
},
"items": [
{
"name": "test item",
"price": 10000,
"currency": "KRW",
"quantity": 1,
"actualWeight": 3.22,
"hscode": "1234567890",
"itemUrl": "https://www.delivered.co.kr/en",
"itemCode": "1234567890"
}
]
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
data: [
{
warehouseId: 1,
sender: {name: '홍길동', contact: '01012345678'},
recipient: {
country: 'US',
name: 'test kim',
contact: '1235551234',
address: 'Centum jungang-ro, Haeundae-gu',
addressDetail: '20F, 90',
city: 'Busan',
state: 'Busan',
zipCode: '48059',
email: 'test@domain.co.kr',
personalCustomsClearanceCode: '1234567890'
},
orderInfo: {
mallOrderNumber: 'ORDER202501010001',
carrier: 'FEDEX',
isExportDeclaration: true,
domesticShippingNumber: '65434235223'
},
packageInfo: {
actualWeight: 3.26,
quantity: 1,
width: 11.76,
length: 11.76,
height: 11.76,
serviceType: 'POD'
},
items: [
{
name: 'test item',
price: 10000,
currency: 'KRW',
quantity: 1,
actualWeight: 3.22,
hscode: '1234567890',
itemUrl: 'https://www.delivered.co.kr/en',
itemCode: '1234567890'
}
]
}
]
})
};
fetch('https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'data' => [
[
'warehouseId' => 1,
'sender' => [
'name' => '홍길동',
'contact' => '01012345678'
],
'recipient' => [
'country' => 'US',
'name' => 'test kim',
'contact' => '1235551234',
'address' => 'Centum jungang-ro, Haeundae-gu',
'addressDetail' => '20F, 90',
'city' => 'Busan',
'state' => 'Busan',
'zipCode' => '48059',
'email' => 'test@domain.co.kr',
'personalCustomsClearanceCode' => '1234567890'
],
'orderInfo' => [
'mallOrderNumber' => 'ORDER202501010001',
'carrier' => 'FEDEX',
'isExportDeclaration' => true,
'domesticShippingNumber' => '65434235223'
],
'packageInfo' => [
'actualWeight' => 3.26,
'quantity' => 1,
'width' => 11.76,
'length' => 11.76,
'height' => 11.76,
'serviceType' => 'POD'
],
'items' => [
[
'name' => 'test item',
'price' => 10000,
'currency' => 'KRW',
'quantity' => 1,
'actualWeight' => 3.22,
'hscode' => '1234567890',
'itemUrl' => 'https://www.delivered.co.kr/en',
'itemCode' => '1234567890'
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders"
payload := strings.NewReader("{\n \"data\": [\n {\n \"warehouseId\": 1,\n \"sender\": {\n \"name\": \"홍길동\",\n \"contact\": \"01012345678\"\n },\n \"recipient\": {\n \"country\": \"US\",\n \"name\": \"test kim\",\n \"contact\": \"1235551234\",\n \"address\": \"Centum jungang-ro, Haeundae-gu\",\n \"addressDetail\": \"20F, 90\",\n \"city\": \"Busan\",\n \"state\": \"Busan\",\n \"zipCode\": \"48059\",\n \"email\": \"test@domain.co.kr\",\n \"personalCustomsClearanceCode\": \"1234567890\"\n },\n \"orderInfo\": {\n \"mallOrderNumber\": \"ORDER202501010001\",\n \"carrier\": \"FEDEX\",\n \"isExportDeclaration\": true,\n \"domesticShippingNumber\": \"65434235223\"\n },\n \"packageInfo\": {\n \"actualWeight\": 3.26,\n \"quantity\": 1,\n \"width\": 11.76,\n \"length\": 11.76,\n \"height\": 11.76,\n \"serviceType\": \"POD\"\n },\n \"items\": [\n {\n \"name\": \"test item\",\n \"price\": 10000,\n \"currency\": \"KRW\",\n \"quantity\": 1,\n \"actualWeight\": 3.22,\n \"hscode\": \"1234567890\",\n \"itemUrl\": \"https://www.delivered.co.kr/en\",\n \"itemCode\": \"1234567890\"\n }\n ]\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"data\": [\n {\n \"warehouseId\": 1,\n \"sender\": {\n \"name\": \"홍길동\",\n \"contact\": \"01012345678\"\n },\n \"recipient\": {\n \"country\": \"US\",\n \"name\": \"test kim\",\n \"contact\": \"1235551234\",\n \"address\": \"Centum jungang-ro, Haeundae-gu\",\n \"addressDetail\": \"20F, 90\",\n \"city\": \"Busan\",\n \"state\": \"Busan\",\n \"zipCode\": \"48059\",\n \"email\": \"test@domain.co.kr\",\n \"personalCustomsClearanceCode\": \"1234567890\"\n },\n \"orderInfo\": {\n \"mallOrderNumber\": \"ORDER202501010001\",\n \"carrier\": \"FEDEX\",\n \"isExportDeclaration\": true,\n \"domesticShippingNumber\": \"65434235223\"\n },\n \"packageInfo\": {\n \"actualWeight\": 3.26,\n \"quantity\": 1,\n \"width\": 11.76,\n \"length\": 11.76,\n \"height\": 11.76,\n \"serviceType\": \"POD\"\n },\n \"items\": [\n {\n \"name\": \"test item\",\n \"price\": 10000,\n \"currency\": \"KRW\",\n \"quantity\": 1,\n \"actualWeight\": 3.22,\n \"hscode\": \"1234567890\",\n \"itemUrl\": \"https://www.delivered.co.kr/en\",\n \"itemCode\": \"1234567890\"\n }\n ]\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"data\": [\n {\n \"warehouseId\": 1,\n \"sender\": {\n \"name\": \"홍길동\",\n \"contact\": \"01012345678\"\n },\n \"recipient\": {\n \"country\": \"US\",\n \"name\": \"test kim\",\n \"contact\": \"1235551234\",\n \"address\": \"Centum jungang-ro, Haeundae-gu\",\n \"addressDetail\": \"20F, 90\",\n \"city\": \"Busan\",\n \"state\": \"Busan\",\n \"zipCode\": \"48059\",\n \"email\": \"test@domain.co.kr\",\n \"personalCustomsClearanceCode\": \"1234567890\"\n },\n \"orderInfo\": {\n \"mallOrderNumber\": \"ORDER202501010001\",\n \"carrier\": \"FEDEX\",\n \"isExportDeclaration\": true,\n \"domesticShippingNumber\": \"65434235223\"\n },\n \"packageInfo\": {\n \"actualWeight\": 3.26,\n \"quantity\": 1,\n \"width\": 11.76,\n \"length\": 11.76,\n \"height\": 11.76,\n \"serviceType\": \"POD\"\n },\n \"items\": [\n {\n \"name\": \"test item\",\n \"price\": 10000,\n \"currency\": \"KRW\",\n \"quantity\": 1,\n \"actualWeight\": 3.22,\n \"hscode\": \"1234567890\",\n \"itemUrl\": \"https://www.delivered.co.kr/en\",\n \"itemCode\": \"1234567890\"\n }\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"isSuccess": true,
"orderSuccesses": [
{
"orderId": 1,
"mallOrderNumber": "ORD202501010001"
}
]
}주문 API
주문 등록
주문 등록 전, 먼저 주문 유효성 검사 API를 통해 주문을 등록할 수 있는지 확인 뒤 등록 API를 사용하길 권장드립니다.
POST
/
open-api
/
v1
/
orders
주문 등록
curl --request POST \
--url https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"data": [
{
"warehouseId": 1,
"sender": {
"name": "홍길동",
"contact": "01012345678"
},
"recipient": {
"country": "US",
"name": "test kim",
"contact": "1235551234",
"address": "Centum jungang-ro, Haeundae-gu",
"addressDetail": "20F, 90",
"city": "Busan",
"state": "Busan",
"zipCode": "48059",
"email": "test@domain.co.kr",
"personalCustomsClearanceCode": "1234567890"
},
"orderInfo": {
"mallOrderNumber": "ORDER202501010001",
"carrier": "FEDEX",
"isExportDeclaration": true,
"domesticShippingNumber": "65434235223"
},
"packageInfo": {
"actualWeight": 3.26,
"quantity": 1,
"width": 11.76,
"length": 11.76,
"height": 11.76,
"serviceType": "POD"
},
"items": [
{
"name": "test item",
"price": 10000,
"currency": "KRW",
"quantity": 1,
"actualWeight": 3.22,
"hscode": "1234567890",
"itemUrl": "https://www.delivered.co.kr/en",
"itemCode": "1234567890"
}
]
}
]
}
'import requests
url = "https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders"
payload = { "data": [
{
"warehouseId": 1,
"sender": {
"name": "홍길동",
"contact": "01012345678"
},
"recipient": {
"country": "US",
"name": "test kim",
"contact": "1235551234",
"address": "Centum jungang-ro, Haeundae-gu",
"addressDetail": "20F, 90",
"city": "Busan",
"state": "Busan",
"zipCode": "48059",
"email": "test@domain.co.kr",
"personalCustomsClearanceCode": "1234567890"
},
"orderInfo": {
"mallOrderNumber": "ORDER202501010001",
"carrier": "FEDEX",
"isExportDeclaration": True,
"domesticShippingNumber": "65434235223"
},
"packageInfo": {
"actualWeight": 3.26,
"quantity": 1,
"width": 11.76,
"length": 11.76,
"height": 11.76,
"serviceType": "POD"
},
"items": [
{
"name": "test item",
"price": 10000,
"currency": "KRW",
"quantity": 1,
"actualWeight": 3.22,
"hscode": "1234567890",
"itemUrl": "https://www.delivered.co.kr/en",
"itemCode": "1234567890"
}
]
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
data: [
{
warehouseId: 1,
sender: {name: '홍길동', contact: '01012345678'},
recipient: {
country: 'US',
name: 'test kim',
contact: '1235551234',
address: 'Centum jungang-ro, Haeundae-gu',
addressDetail: '20F, 90',
city: 'Busan',
state: 'Busan',
zipCode: '48059',
email: 'test@domain.co.kr',
personalCustomsClearanceCode: '1234567890'
},
orderInfo: {
mallOrderNumber: 'ORDER202501010001',
carrier: 'FEDEX',
isExportDeclaration: true,
domesticShippingNumber: '65434235223'
},
packageInfo: {
actualWeight: 3.26,
quantity: 1,
width: 11.76,
length: 11.76,
height: 11.76,
serviceType: 'POD'
},
items: [
{
name: 'test item',
price: 10000,
currency: 'KRW',
quantity: 1,
actualWeight: 3.22,
hscode: '1234567890',
itemUrl: 'https://www.delivered.co.kr/en',
itemCode: '1234567890'
}
]
}
]
})
};
fetch('https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'data' => [
[
'warehouseId' => 1,
'sender' => [
'name' => '홍길동',
'contact' => '01012345678'
],
'recipient' => [
'country' => 'US',
'name' => 'test kim',
'contact' => '1235551234',
'address' => 'Centum jungang-ro, Haeundae-gu',
'addressDetail' => '20F, 90',
'city' => 'Busan',
'state' => 'Busan',
'zipCode' => '48059',
'email' => 'test@domain.co.kr',
'personalCustomsClearanceCode' => '1234567890'
],
'orderInfo' => [
'mallOrderNumber' => 'ORDER202501010001',
'carrier' => 'FEDEX',
'isExportDeclaration' => true,
'domesticShippingNumber' => '65434235223'
],
'packageInfo' => [
'actualWeight' => 3.26,
'quantity' => 1,
'width' => 11.76,
'length' => 11.76,
'height' => 11.76,
'serviceType' => 'POD'
],
'items' => [
[
'name' => 'test item',
'price' => 10000,
'currency' => 'KRW',
'quantity' => 1,
'actualWeight' => 3.22,
'hscode' => '1234567890',
'itemUrl' => 'https://www.delivered.co.kr/en',
'itemCode' => '1234567890'
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders"
payload := strings.NewReader("{\n \"data\": [\n {\n \"warehouseId\": 1,\n \"sender\": {\n \"name\": \"홍길동\",\n \"contact\": \"01012345678\"\n },\n \"recipient\": {\n \"country\": \"US\",\n \"name\": \"test kim\",\n \"contact\": \"1235551234\",\n \"address\": \"Centum jungang-ro, Haeundae-gu\",\n \"addressDetail\": \"20F, 90\",\n \"city\": \"Busan\",\n \"state\": \"Busan\",\n \"zipCode\": \"48059\",\n \"email\": \"test@domain.co.kr\",\n \"personalCustomsClearanceCode\": \"1234567890\"\n },\n \"orderInfo\": {\n \"mallOrderNumber\": \"ORDER202501010001\",\n \"carrier\": \"FEDEX\",\n \"isExportDeclaration\": true,\n \"domesticShippingNumber\": \"65434235223\"\n },\n \"packageInfo\": {\n \"actualWeight\": 3.26,\n \"quantity\": 1,\n \"width\": 11.76,\n \"length\": 11.76,\n \"height\": 11.76,\n \"serviceType\": \"POD\"\n },\n \"items\": [\n {\n \"name\": \"test item\",\n \"price\": 10000,\n \"currency\": \"KRW\",\n \"quantity\": 1,\n \"actualWeight\": 3.22,\n \"hscode\": \"1234567890\",\n \"itemUrl\": \"https://www.delivered.co.kr/en\",\n \"itemCode\": \"1234567890\"\n }\n ]\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"data\": [\n {\n \"warehouseId\": 1,\n \"sender\": {\n \"name\": \"홍길동\",\n \"contact\": \"01012345678\"\n },\n \"recipient\": {\n \"country\": \"US\",\n \"name\": \"test kim\",\n \"contact\": \"1235551234\",\n \"address\": \"Centum jungang-ro, Haeundae-gu\",\n \"addressDetail\": \"20F, 90\",\n \"city\": \"Busan\",\n \"state\": \"Busan\",\n \"zipCode\": \"48059\",\n \"email\": \"test@domain.co.kr\",\n \"personalCustomsClearanceCode\": \"1234567890\"\n },\n \"orderInfo\": {\n \"mallOrderNumber\": \"ORDER202501010001\",\n \"carrier\": \"FEDEX\",\n \"isExportDeclaration\": true,\n \"domesticShippingNumber\": \"65434235223\"\n },\n \"packageInfo\": {\n \"actualWeight\": 3.26,\n \"quantity\": 1,\n \"width\": 11.76,\n \"length\": 11.76,\n \"height\": 11.76,\n \"serviceType\": \"POD\"\n },\n \"items\": [\n {\n \"name\": \"test item\",\n \"price\": 10000,\n \"currency\": \"KRW\",\n \"quantity\": 1,\n \"actualWeight\": 3.22,\n \"hscode\": \"1234567890\",\n \"itemUrl\": \"https://www.delivered.co.kr/en\",\n \"itemCode\": \"1234567890\"\n }\n ]\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://gw-staging.delivered.co.kr/global-ship/open-api/v1/orders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"data\": [\n {\n \"warehouseId\": 1,\n \"sender\": {\n \"name\": \"홍길동\",\n \"contact\": \"01012345678\"\n },\n \"recipient\": {\n \"country\": \"US\",\n \"name\": \"test kim\",\n \"contact\": \"1235551234\",\n \"address\": \"Centum jungang-ro, Haeundae-gu\",\n \"addressDetail\": \"20F, 90\",\n \"city\": \"Busan\",\n \"state\": \"Busan\",\n \"zipCode\": \"48059\",\n \"email\": \"test@domain.co.kr\",\n \"personalCustomsClearanceCode\": \"1234567890\"\n },\n \"orderInfo\": {\n \"mallOrderNumber\": \"ORDER202501010001\",\n \"carrier\": \"FEDEX\",\n \"isExportDeclaration\": true,\n \"domesticShippingNumber\": \"65434235223\"\n },\n \"packageInfo\": {\n \"actualWeight\": 3.26,\n \"quantity\": 1,\n \"width\": 11.76,\n \"length\": 11.76,\n \"height\": 11.76,\n \"serviceType\": \"POD\"\n },\n \"items\": [\n {\n \"name\": \"test item\",\n \"price\": 10000,\n \"currency\": \"KRW\",\n \"quantity\": 1,\n \"actualWeight\": 3.22,\n \"hscode\": \"1234567890\",\n \"itemUrl\": \"https://www.delivered.co.kr/en\",\n \"itemCode\": \"1234567890\"\n }\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"isSuccess": true,
"orderSuccesses": [
{
"orderId": 1,
"mallOrderNumber": "ORD202501010001"
}
]
}Authorizations
accessTokenAuthorization
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
주문 정보 리스트
Required array length:
1 - 2147483647 elementsShow child attributes
Show child attributes
Response
200 - */*
OK
성공 유무
주문 등록이 성공하면 true가 반환되며, 성공한 주문 정보는 orderSuccesses 필드에 포함됩니다.
주문 등록이 실패하면 false가 반환되며, orderSuccesses 필드는 비어있습니다.
실패 사유를 확인하고 싶다면, 별도로 제공되는 주문 유효성 검사 API를 통해 자세한 정보를 확인할 수 있습니다.
Example:
true
성공 항목
Show child attributes
Show child attributes
⌘I