Search

주문 여러건 접수

API
/v1/orders
DESCRIPTION
여러건의 주문을 링크포트로 생성
METHOD
POST
Search
Linkport
Linkport
IOrder 자료구조
IOrder 자료구조
배송타입
배송타입
주문/CS 상태
주문/CS 상태
주문 단건 접수
주문 단건 접수
주문 여러건 접수
주문 여러건 접수
주문 단건 조회
주문 단건 조회
주문 여러건 조회
주문 여러건 조회
주문 정보 단건 수정
주문 정보 단건 수정
주문 상태 단건 변경
주문 상태 단건 변경
주문 상태 여러건 변경
주문 상태 여러건 변경
주문 합치기
주문 합치기
주문 나누기
주문 나누기
배송추적 조회 V1
배송추적 조회 V1
배송추적 조회 V2
배송추적 조회 V2
수출신고 조회
수출신고 조회
배송추적 Push
배송추적 Push
•
1회 요청 시 최대 100건 접수 가능

API

/v1/orders

METHOD

POST\color{red}\colorbox{oldlace}{\scriptsize\textsf{POST}}

REQUEST

header

인증

필수\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}

body

Search
필드명
필수
타입
설명
orders
JSON array
주문자료 구조배열
Open
no_info1
필수
VARCHAR (50)
주문번호 #1
Open
no_info2
선택
VARCHAR (50)
주문번호 #2
Open
country
필수
VARCHAR (20)
배송국가코드
Open
type_code
필수
VARCHAR (20)
배송타입코드 (사전에 협의한 알파벳 코드 값)
Open
currency
필수
VARCHAR (20)
주문정보의 통화
Open
sender
JSON
발송인 정보
Open
name1
필수
string
발송인명 (현지언어 또는 영문 입력,운송사별로 상이)
Open
name2
선택
string
발송인명 (영문, 현지언어)
Open
phone
필수
string
전화번호
Open
mobile
선택
string
핸드폰번호 (전화번호가 있으면 옵션 항목)
Open
zipcode
필수
string
우편번호
Open
addr_state
선택
string
주소 (성 / STATE) 특정국가(CN) 제외 필수 입력
Open
addr_city
선택
string
주소 (시 / CITY) 특정국가(CN) 제외 필수 입력
Open
addr_gu
선택
string
주소 (구) 없는 경우 공백
Open
addr2
필수
string
전체 주소 반드시 영문으로 입력
Open
email
선택
string
이메일 주소
Open
purchaser
JSON
구매자 정보
Open
name1
선택
string
구매자명 (영문으로 입력)
Open
name2
선택
string
구매자명 (현지 언어 등)
Open
phone
선택
string
전화번호
Open
mobile
선택
string
핸드폰번호 (전화번호가 있으면 옵션 항목)
Open
zipcode
선택
string
우편번호
Open
addr_state
선택
string
주소 (성 / STATE)
Open
addr_city
선택
string
주소 (시 / CITY)
Open
addr_gu
선택
string
주소 (구)
Open
addr2
선택
string
전체 주소 반드시 영문으로 입력
Open
email
선택
string
이메일 주소
Open
recipient
JSON
수신자 정보
Open
id_no
선택
string
신분번호
Open
name1
필수
string
수취인명 (현지언어 또는 영문 입력, 운송사별로 상이)
Open
name2
선택
string
수취인명 (영문, 현지 언어)
Open
phone
필수
string
전화번호
Open
mobile
선택
string
핸드폰번호 (전화번호가 있으면 옵션 항목)
Open
zipcode
필수
string
우편번호
Open
country
필수
string
배송국가
Open
addr_state
필수
string
주소 (성 / STATE) 중국(CN) 제외 필수 입력, 미국(US) 캐나다(CA)는 약어 2자리 입력 (ex. Newyork → NY)
Open
addr_city
필수
string
주소 (시 / CITY) 중국(CN) 제외 필수 입력
Open
addr_gu
선택
string
주소 (구) 없는 경우 공백
Open
addr2
필수
string
전체 주소 일본(JP),중국(CN) 제외 영문 필수 입력 일본(JP),중국(CN) 중 EMS 이용 시 영문 필수 입력
Open
email
선택
string
이메일 주소
Open
tax_no
선택
VARCHAR (30)
세금식별번호 (수출신고 시 필수)
Open
incoterms
선택
VARCHAR (10)
DDU, DAP : 수취인이 세금 납부 / DDP : 발송인이 세금 납부 FEDEX - DAP or DDP / UPS - DDU or DDP
Open
export_no
선택
VARCHAR (15)
수출신고번호
Open
extra
JSON
사용자 데이터
Open
data1
선택
string
사용자 데이터1
Open
data2
선택
string
사용자 데이터2
Open
data3
선택
string
사용자 데이터3
Open
payment
JSON
구매자 결제 데이터
Open
delivery
선택
string
고객결제배송비
Open
purchaser
선택
string
구매자결제금액
Open
memo
선택
VARCHAR (1000)
배송 메모
Open
parcels
JSON array
주문의 상품 상세 정보
Open
name
필수
VARCHAR (200)
상품명 (영문)
Open
quantity
필수
INTEGER
상품 수량
Open
box_count
선택
INTEGER
박스 갯수
Open
weight
필수
DECIMAL (20, 5)
상품 무게(kg) 상품무게 정보가 없을 경우, 0.1 고정값 입력
Open
price
필수
DECIMAL (30, 5)
상품 단위 금액
Open
currency
필수
VARCHAR (20)
화폐단위
Open
sku
선택
VARCHAR (50)
SKU
Open
hscode
선택
VARCHAR (20)
HSCODE (수출신고 시 필수)
Open
brand
필수
VARCHAR (50)
브랜드명
Open
material
선택
VARCHAR (100)
상품재질
Open
customs_code
선택
VARCHAR (50)
세관등록 코드 (중국의 경우 무역법상 통관 이전 사전에 상품정보를 세관에 등록이 필요)
Open
url
선택
VARCHAR (100)
상품정보 URL
Open
goods_type
선택
VARCHAR (50)
상품 타입 (NORMAL, RANDOM, SET)
Open
origin_goods_code
선택
VARCHAR (50)
BOM 상위 goodsCode
Open
is_freebie
선택
TINYINT(1)
사은품 여부 설정
Open

RESPONSE

※ 다건 주문 중에서 한건이라도 오류가 있으면 전체 오류 처리 합니다.

응답 규격

필드
필수
설명
code
필수\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}
API 논리적 응답 코드
message
필수\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}
human readable 응답 메시지 header의 accept-language 언어 설정별 메시지 출력 (’en’, ‘ko’)
result
필수\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}
API 응답의 실제 데이터
orders
필수\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}
생성한 주문 정보 배열
errors
선택\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}
주문 생성 중 오류 발생 결과 목록
host
필수\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}
API 를 처리한 서버 정보
timestamp
필수\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}
API 응답 시간
tid
필수\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}
API 호출 추적용 고유 trace id UUID 값

errors 필드 값

필드
설명
order
오류가 발생한 주문 정보
message
주문 생성 중 오류 발생 결과 메시지

공통 오류

오류 코드
유형
설명
4000
BAD_REQUEST
API 요청에 사용한 값 오류
4010
UNAUTHORIZED
아래 기재된 실패 사유 이외의 로그인 실패
4011
TOKEN_EXPIRED
Token 유효기간 만료
4012
ACCOUNT_LOCKED
비밀번호 입력을 여러번 실패하여 계정 잠김
4013
TOKEN_INVALID
유효하지 않은 Token 오류
4030
FORBIDDEN
권한이 없는 리소스 접근 시도 오류
4040
NOT_FOUND
존재하지 않는 리소스 접근 시도 오류
4090
CONFLICT
이미 존재하는 리소스 고유 번호로 중복 생성 시도

EXAMPLE

Cmd/Ctrl + Option/Alt + T : 전체 열기/닫기

Request

요청

Response

SUCCESS

결과

Fail

필수 항목이 없는 경우
다건 주문 중에서 중복 데이터와 오류 데이터를 포함하는 경우