주문 등록
주문 등록 전, 먼저 주문 유효성 검사 API를 통해 주문을 등록할 수 있는지 확인 뒤 등록 API를 사용하길 권장드립니다.
POST
/
open-api
/
v1
/
orders
curl --request POST \
--url https://auth-staging.delivered.co.kr/global-ship/open-api/v1/orders \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"data": [
{
"warehouseId": 1,
"sender": {
"name": "홍길동",
"contact": "01012345678"
},
"recipient": {
"country": "US",
"name": "test kim",
"contact": "1235551234",
"email": "test@domain.co.kr",
"address": "Centum jungang-ro, Haeundae-gu",
"addressDetail": "20F, 90",
"city": "Busan",
"state": "Busan",
"zipCode": "48059",
"personalCustomsClearanceCode": "1234567890"
},
"orderInfo": {
"mallOrderNumber": "ORDER202501010001",
"carrier": "FEDEX",
"incoterms": "DAP",
"domesticShippingNumber": "65434235223",
"isExportDeclaration": true,
"exportPurpose": "SAMPLE"
},
"packageInfo": {
"width": 11.76,
"length": 11.76,
"height": 11.76,
"actualWeight": 3.26,
"quantity": 1,
"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"
}
]
}
]
}'{
"isSuccess": true,
"orderSuccesses": [
{
"orderId": 1,
"mallOrderNumber": "ORD202501010001"
}
]
}Authorizations
발급받은 시크릿 키
Body
application/json
주문 정보 리스트
주문 정보 리스트
입고지 ID
받는 분 정보
받는분 국가
Available options:
GH, GA, GY, GM, GT, GD, GR, GN, GW, NA, NR, NG, SS, ZA, NL, NP, NO, NZ, NU, NE, NI, DK, DO, DM, DE, TL, LA, LR, LV, RU, LB, LS, RO, LU, RW, LY, LT, LI, MG, MH, FM, MW, MY, ML, MX, MC, MA, MU, MR, MZ, ME, MD, MV, MT, MN, US, MM, VU, BH, BB, VA, BS, BD, BJ, VE, VN, BE, BY, BZ, BA, BW, BO, BI, BF, BT, MK, BG, BR, BN, WS, SA, CY, SM, ST, SN, RS, SC, LC, VC, KN, SO, SB, SD, SR, LK, SE, CH, ES, SK, SI, SY, SL, SG, AE, AM, AR, IS, HT, IE, AZ, AF, AD, AL, DZ, AO, AG, ER, SZ, EE, EC, ET, SV, GB, YE, OM, AT, HN, JO, UG, UY, UZ, UA, IQ, IR, IL, EG, IT, IN, ID, JP, JM, ZM, GQ, GE, CN, CF, DJ, ZW, TD, CZ, CL, CM, CV, KZ, QA, KH, CA, KE, KM, XK, CR, CI, CO, CG, CD, CU, KW, CK, HR, KG, KI, TJ, TZ, TH, TR, TG, TO, TM, TV, TN, TT, PA, PY, PK, PG, PW, PS, PE, PT, PL, FR, FJ, FI, PH, HU, AU, TW, GG, JE, GI, KV, AS, AI, AW, BM, KY, FK, FO, GF, GL, GP, GU, KP, MP, MQ, YT, MS, NC, PR, RE, SH, PF, VG, VI, HK, MO, TC, NF, BQ, CW, WF, MF, BL, SX 이름
Maximum length:
50연락처
Maximum length:
50주소
Maximum length:
300상세 주소
Maximum length:
300도시
Maximum length:
100주
Maximum length:
100우편번호
Maximum length:
30이메일
Maximum length:
100개인통관고유부호
Maximum length:
100주문 정보
쇼핑몰 주문 번호
Maximum length:
100운송사
Available options:
DHL, UPS, FEDEX, PARXL, YSL, ARAMEX, EMS, EMS_PREMIUM, KPACKET, ASAP, GTS, ALEM_TAT, EFS, NOMEX, H3, DELIVERED_STANDARD, LOTOS incoterms
Available options:
DAP, DDP 수출신고 유무
수출목적
Available options:
SAMPLE, COMMERCIAL 국내택배 운송장 번호
Maximum length:
50화물 정보
실제 무게
박수 개수
Required range:
x < 2147483647가로(너비)
세로(길이)
높이
서비스 타입(러시아에서 사용)
Available options:
POD 상품 정보
상품 정보
상품명
Maximum length:
500상품 가격
통화
Available options:
KRW, USD, JPY, RUB 상품 개수
Required range:
x < 2147483647실제 무게
hscode
Maximum length:
100상품 URL
Maximum length:
3000상품 코드
Maximum length:
50Response
200 - */*
OK
성공 유무
주문 등록이 성공하면 true가 반환되며, 성공한 주문 정보는 orderSuccesses 필드에 포함됩니다.
주문 등록이 실패하면 false가 반환되며, orderSuccesses 필드는 비어있습니다.
실패 사유를 확인하고 싶다면, 별도로 제공되는 주문 유효성 검사 API를 통해 자세한 정보를 확인할 수 있습니다.
curl --request POST \
--url https://auth-staging.delivered.co.kr/global-ship/open-api/v1/orders \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"data": [
{
"warehouseId": 1,
"sender": {
"name": "홍길동",
"contact": "01012345678"
},
"recipient": {
"country": "US",
"name": "test kim",
"contact": "1235551234",
"email": "test@domain.co.kr",
"address": "Centum jungang-ro, Haeundae-gu",
"addressDetail": "20F, 90",
"city": "Busan",
"state": "Busan",
"zipCode": "48059",
"personalCustomsClearanceCode": "1234567890"
},
"orderInfo": {
"mallOrderNumber": "ORDER202501010001",
"carrier": "FEDEX",
"incoterms": "DAP",
"domesticShippingNumber": "65434235223",
"isExportDeclaration": true,
"exportPurpose": "SAMPLE"
},
"packageInfo": {
"width": 11.76,
"length": 11.76,
"height": 11.76,
"actualWeight": 3.26,
"quantity": 1,
"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"
}
]
}
]
}'{
"isSuccess": true,
"orderSuccesses": [
{
"orderId": 1,
"mallOrderNumber": "ORD202501010001"
}
]
}