Search

IOrder 자료구조

3 more properties
Search
Linkport
Linkport
IOrder 자료구조
IOrder 자료구조
주문/CS 상태
주문/CS 상태
배송타입
배송타입
주문 단건 접수
주문 단건 접수
주문 여러건 접수
주문 여러건 접수
주문 단건 조회
주문 단건 조회
주문 여러건 조회
주문 여러건 조회
주문 정보 단건 수정
주문 정보 단건 수정
주문 상태 단건 변경
주문 상태 단건 변경
주문 상태 여러건 변경
주문 상태 여러건 변경
주문 합치기
주문 합치기
주문 나누기
주문 나누기
배송추적 조회 V1
배송추적 조회 V1
배송추적 조회 V2
배송추적 조회 V2
수출신고 조회
수출신고 조회
배송추적 Push
배송추적 Push

※ 주요 변경이력

변경일
변경내역
2024-07-26
• 쓰기 기능을 생성/수정으로 세분화
2024-07-23
• 주문정보의 currency(통화) field 필수 처리
☞ Disclaimer
•
자료구조 타입은 MySQL 8.x 기준 입니다.
•
자료구조에 명시하지 않은 field는 시스템 내부 사용 목적으로 예고 없이 변경될 수 있습니다.

IOrder

•
읽기 = 주문 조회에 사용 가능한 field
◦
필수 field 는 주문 조회 시에 반드시 존재
◦
선택 field 는 주문 조회 시에 존재하지 않을 수도 있음
•
쓰기 = 주문 접수 및 주문 수정에 사용 가능한 field
◦
주문 접수 시에는 필수 field 는 반드시 있어야 함
◦
주문 수정 시에는 쓰기 가능한 타입의 수정할 field 만 있으면 됨
Search
필드명
필수
읽기/쓰기
타입
설명
_id
필수
읽기
BIGINT
시스템에서 관리하는 고유 ID 값
Open
no_info1
필수
읽기
생성
VARCHAR (50)
주문번호 #1
Open
no_info2
선택
읽기
생성
VARCHAR (50)
주문번호 #2
Open
state
필수
읽기
VARCHAR (20)
주문정보 처리 상태
Open
cs
선택
읽기
VARCHAR (20)
CS 상태
Open
receipt_no
선택
읽기
VARCHAR (50)
주문 접수 번호 (가송장 번호)
Open
waybill_no
선택
읽기
VARCHAR (50)
주문 송장 번호
Open
waybill_no1
선택
읽기
VARCHAR (50)
재배송 송장 번호 1
Open
waybill_no2
선택
읽기
VARCHAR (50)
재배송 송장 번호 2
Open
country
필수
읽기
생성
수정
VARCHAR (20)
배송국가코드(대문자)
Open
type_code
필수
읽기
생성
VARCHAR (20)
배송타입코드 (사전에 협의한 알파벳 코드 값)
Open
courier
필수
읽기
VARCHAR (100)
배송사/운송사 정보
Open
sender
필수
읽기
생성
수정
발송인 정보
Open
purchaser
선택
읽기
생성
수정
구매자 정보
Open
recipient
필수
읽기
생성
수정
수신자 정보
Open
tax_no
선택
읽기
생성
수정
VARCHAR (30)
세금식별번호 (EU국가 : ioss번호 / GB : EORI 번호 / BR, ID : 세금식별번호 / 이외 국가 : TAX NUMBER)
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
weight
선택
읽기
DECIMAL (20, 5)
합포장 상품(parcels)의 총 무게 합
Open
price
선택
읽기
DECIMAL (30, 5)
합포장 상품(parcels)의 총 가격
Open
count
필수
읽기
INTEGER
합포장 상품(parcels)의 갯수
Open
currency
필수
읽기
생성
VARCHAR (20)
주문정보의 통화
Open
memo
선택
읽기
생성
VARCHAR (1000)
배송 메모
Open
volume
JSON
주문 실제 무게, 부피 무게, 적용 무게 등 정보
Open
width
선택
읽기
생성
수정
float
넓이 (cm)
Open
height
선택
읽기
생성
수정
float
높이 (cm)
Open
length
선택
읽기
생성
수정
float
길이 (cm)
Open
weight
선택
읽기
생성
수정
float
실제 무게 (kg)
Open
volume
선택
읽기
생성
수정
float
부피 무게 (kg)
Open
chargeable
선택
읽기
생성
수정
float
시스템에 요청하는 적용 무게(kg)시스템에서 실제로 사용하는 값은 아님요청하는 값을 사용할지 여부는 시스템이 판단함시스템에서는 weights의 chargeable 값을 사용함
Open
weights
JSON
물류센터 입고완료 후 측정한 무게 관련 정보
Open
net
선택
읽기
생성
수정
float
순중량, 상품정보에 있는 무게 총합(kg)
Open
gross
선택
읽기
생성
수정
float
총중량, 물류센터에서 측정한 실제 무게(kg)
Open
volume
선택
읽기
생성
수정
float
부피무게, 물류센터에서 즉정한 주문 박스의 부피 무게(kg)
Open
chargeable
선택
읽기
생성
수정
float
적용무게, 실제무게와 부피무게 중에서 큰 값(kg)
Open
parcels
JSON array
주문의 상품 상세 정보
Open
_id
필수
읽기
BIGINT
시스템에서 관리하는 고유 ID 값
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 (1000)
상품정보 URL
Open
goods_type
선택
읽기
생성
VARCHAR (50)
상품 타입 (NORMAL, RANDOM, SET)
Open
origin_goods_code
선택
읽기
생성
VARCHAR (50)
BOM 상위 goodsCode
Open
is_freebie
선택
읽기
TINYINT(1)
사은품 여부 설정
Open
order_id
선택
읽기
BIGINT
주문정보 고유 _id
Open
created_at
선택
읽기
DATETIME
상품정보 생성 일시
Open
trackings
선택
읽기
JSON array
주문 배송 추적 정보
Open
changed_at
선택
읽기
DATETIME
OMS 현재 상태 변경 일시
Open

IPerson

☞ 주문정보의 수신자/발송자/구매자 정보 상세 규격
Search
필드명
필수
읽기/쓰기
타입
설명
name1
필수
읽기
생성
수정
VARCHAR(100)
이름1 (현지언어 또는 영문으로 입력. 다만 운송사별로 상이)
Open
name2
선택
읽기
생성
수정
VARCHAR(100)
이름2 (영문, 현지언어)
Open
phone
필수
읽기
생성
수정
VARCHAR(100)
전화번호
Open
mobile
선택
읽기
생성
수정
VARCHAR(100)
핸드폰번호 (전화번호가 있으면 옵션 항목)
Open
country
선택
읽기
생성
수정
VARCHAR(20)
수신자/발송자/구매자의 국가 코드
Open
zipcode
필수
읽기
생성
수정
VARCHAR(100)
우편번호
Open
addr_state
선택
읽기
생성
수정
VARCHAR(100)
주소 (성 / STATE) 특정국가(CN) 제외 필수 입력
Open
addr_city
선택
읽기
생성
수정
VARCHAR(100)
주소 (시 / CITY) 특정국가(CN) 제외 필수 입력
Open
addr_gu
선택
읽기
생성
수정
VARCHAR(100)
주소 (구) 없는 경우 공백
Open
addr2
필수
읽기
생성
수정
VARCHAR(500)
전체 주소 반드시 영문으로 입력
Open
id_no
선택
읽기
생성
수정
VARCHAR(50)
신분증 번호
Open
code
선택
읽기
생성
수정
VARCHAR(100)
고객사가 관리하는 수신자/발송자/구매자 고유 코드
Open
email
선택
읽기
생성
수정
VARCHAR(50)
이메일 주소
Open
verified
선택
읽기
TINYINT(1)
주소 검증 여부 (true / false)
Open
valid
선택
읽기
TINYINT(1)
주소 검증 이후 주소 유효성 결과 (true / false)
Open
errors
선택
읽기
JSON
주소 검증 이후 오류 결과 JSON Array
Open

EXAMPLE

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

IAddressError

필드
필수
타입
설명
field
선택\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}
string
주소 검증 오류가 발생한 field
reason
선택\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}
string
주소 검증 오류 힌트 메시지
fix
선택\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}
string
주소 검증 오류 수정 추천
우편번호가 7자리가 아닌 경우
우편번호와 주소가 맞지 않는 경우