주문 데이터 작성 규칙

주문 데이터 작성

각 항목별 입력 값은 정해진 규칙에 따라 작성이 되어야 이전 가능합니다.

'*(필수)' 표기 항목은 반드시 필요한 값입니다. 해당 값이 없으면 데이터 이전이 불가합니다.

주문 데이터의 필수 항목은 주문번호와 주문일시 두 가지입니다. 나머지는 모두 선택 항목이라 값이 없어도 주문은 이전됩니다.

 

 

Info

  • 선택 항목의 값이 공란인 경우, 아래와 같이 저장되고 주문은 정상적으로 이전됩니다.
  • 주문자 명, 수령인 : 하이픈(-)으로 저장됩니다.
  • 주문자 전화번호, 주문자 핸드폰 : 공란 그대로 저장됩니다.
  • 주문자 이메일 : 공란으로 저장되며, 쇼핑몰 관리자 화면에서는 하이픈(-)으로 표시됩니다.
  • 값이 있더라도 항목별 글자 수를 초과하면 해당 항목의 값만 이전되지 않습니다. 주문 자체는 이전됩니다.
  • 이전 후 회원등급 자동변경 기능을 사용할 예정이라면, 선택 항목이더라도 결제구분 값을 반드시 함께 이전해 주세요.

 

항목별 데이터 규칙

주문번호 *

규칙

영문, 숫자로 구성되어야 하며, 32자 이하만 가능

특수 문자는 하이픈(-)과 언더 바(_)만 허용

예시 12345678-90123456, 20120913205025, 1315448577040
 

Caution

  • 주문번호가 동일한 경우, 묶여서 1건의 묶음 주문으로 이전 됩니다.
  • 1건의 주문에 여러 상품이 있는 경우, 상품당 1개 행으로 나눠 기재해 주세요.

 

품목코드

규칙

영문, 숫자로 구성되어야 하며, 50자 이하만 가능

특수 문자는 하이픈(-)과 언더 바(_)만 허용

예시 20120913205025-01, 20120913205025-02, 20120913205025-03
 

Caution

  • 품목코드를 이전해야 이전 후 품목별로 결제상태/주문상태의 수정이 가능합니다.

 

주문일시 *

데이터 작성 공통 규칙 날짜와 동일하게 적용 됩니다. 데이터 작성 공통 규칙

규칙 YYYY-MM-DD HH:MM:SS
(년-월-일 시:분:초)

 

주문자 명

규칙

1자 이상 32자 이하로 구성 (한글·영문 모두 글자 수 기준)

특수문자, 공백, 괄호 사용 가능

32자를 초과하거나 값이 공란인 경우, 주문은 이전되지만 주문자명이 - 로 저장됩니다

예시 홍길동 / 홍길동 (대표) / Lee Young Hee
 

Caution

  • 주문자 명과 수령인에 이모지(그림문자)가 포함된 경우, 해당 문자는 ?? 로 저장됩니다.

 

주문자 전화번호

규칙

16자 이하로 구성

형식 제한이 없어 해외 전화번호(예: +86-10-1234-5678)도 입력된 값 그대로 이전됩니다

값이 공란인 경우, 주문은 이전되며 전화번호는 공란으로 저장됩니다

예시 02-123-4567 / 051/548/3575 / +86-10-1234-5678

 

주문자 핸드폰

규칙

16자 이하로 구성

형식 제한이 없어 해외 전화번호도 입력된 값 그대로 이전됩니다

값이 공란인 경우, 주문은 이전되며 핸드폰 번호는 공란으로 저장됩니다

예시 010-1234-5678 / 01012345678

 

수령인

규칙

1자 이상 20자 이하로 작성해 주세요 (한글·영문 모두 글자 수 기준)

특수문자, 공백, 괄호 사용 가능

20자를 초과하거나 값이 공란인 경우, 주문은 이전되지만 수령인이 - 로 저장됩니다

예시 홍길동 / 홍길동 (대표) / Lee Young Hee

 

주문자 아이디

데이터 작성 공통 규칙 아이디와 동일하게 적용 됩니다. 데이터 작성 공통 규칙

규칙

영문 소문자 4자 이상 ~ 16자 이하

(SNS 계정은 예외적으로 @문자 허용)

 

Caution

  • SNS 계정은 이전 시 카페24 형식으로 변경 됩니다. (숫자@n, 숫자@k, 숫자@f)
  • 주문자 아이디가 공란(비회원)이거나 아이디 일부가 마스킹 처리(예: cafe***)된 경우에는 이전이 불가합니다.
  • 주문자아이디 미기재 시, 고객은 [쇼핑몰] 마이쇼핑 > 주문내역 조회 > 이전 몰 주문 에서 과거 주문을 확인할 수 없어요.

 

주문자 이메일

데이터 작성 공통 규칙 이메일과 동일하게 적용됩니다. 데이터 작성 공통 규칙

규칙

40자 이하로 구성되어야 하며, ‘하이픈(-)’ 및 ‘@’ 외에 특수 문자 및 공백은 허용 불가

값이 공란인 경우, 주문은 이전되며 이메일은 공란으로 저장됩니다 (관리자 화면에서는 - 로 표시)

 

주문자 주소

규칙 255자 이하로 구성되어야 하며, 전체 주소 값으로 이전
(동/읍/면 + 나머지 주소가 합쳐진 주소)
예시 서울시 신대방동 15 전문건설회관 22층 카페24

 

수령인 전화번호

규칙

16자 이하로 구성

형식 제한이 없어 해외 전화번호도 입력된 값 그대로 이전됩니다

 

수령인 핸드폰

규칙

16자 이하로 구성

형식 제한이 없어 해외 전화번호도 입력된 값 그대로 이전됩니다

 

수령인 우편번호

규칙 7자 이하의 숫자로 구성 (하이픈(-) 포함 가능), 공백은 허용되지 않음
예시 123-546, 545452, 01245, 1054 (앞자리 0은 자동으로 보정)

 

수령인주소(전체)

규칙 255자 이하로 구성 되어야 하며, 전체 주소 값으로 이전
(동/읍/면 + 나머지 주소가 합쳐진 주소)
예시 서울시 신대방동 15 전문건설회관 22층 카페24

 

배송 메시지

규칙 255자 이하 문자열로 구성되어야 하며, 특별한 제한 없음

 

주문상품명

규칙

255자 이하로 구성

주문 상품명에 옵션이 포함되어 있는 경우, 옵션명을 분리하지 않고 상품명으로 그대로 이전

1건의 주문에 여러 상품이 있는 경우, 상품당 1개 행으로 나눠 기재

주문 데이터는 단순 조회용이므로 상품 데이터와 연동되지 않습니다

 

상품 옵션

규칙

255자 이하 문자열로 구성되어야 하며, 특별한 제한 없음

(입력된 문자열 그대로 이전)

 

수량

규칙 숫자로 입력, 미입력시 0으로 입력

 

상품고유번호

규칙

영문, 숫자 50자 이내 가능 (특수 문자는 ‘-’ 하이픈만 허용)

주문 데이터와 상품은 연동되지 않음

 

상품 자체코드

규칙 40자 이하로 구성

 

상품가격

규칙 상품별 판매가격을 입력, 값이 없는 경우 '0'원으로 이전

 

총 결제금액

규칙

주문 1건의 총 결제금액을 입력, 값이 없는 경우 '0'원으로 이전

여러 개 상품을 구매한 묶음 주문(주문번호가 동일한 행)인 경우, 제일 위 셀의 값이 해당 주문의 총 결제금액으로 이전됩니다

 

Info

  • [예시] 주문번호 20220919-0512261918 이 3개 행(상품가격 5,000원 / 2,500원 / 3,000원)으로 작성되어 있고, 제일 위 행의 '총결제금액'이 13,000원인 경우 해당 주문의 총 결제금액은 13,000원으로 이전됩니다.
  • 아래 행에 적은 총결제금액 값은 이전되지 않으므로, 묶음 주문의 합계 금액은 반드시 제일 위 행에 입력해 주세요.

 

사용 적립금

규칙 결제 시 사용된 적립금액을 입력, 값이 없거나 마이너스 금액은 '0'원으로 이전

 

사용 예치금

규칙 결제 시 사용된 예치금액을 입력, 값이 없거나 마이너스 금액은 '0'원으로 이전
 

Info

  • 금액 항목(상품가격, 총 결제금액, 사용 적립금, 사용 예치금)은 숫자 뒤에 '원'이 붙거나 앞에 화폐 단위($, ₩)가 있어도 이전됩니다. 자세한 내용은 데이터 작성 공통 규칙의 '금액' 항목을 참고해 주세요.

 

주문상태

규칙 255자 이하로 구성 되어야 하며, 문자열 구성으로 특별 제한 없음
예시 주문완료, 카드결제완료, 무통장입금 완료

 

결제구분

규칙

T/F 값으로 입력

결제완료: T , 미결제/미입금/결제취소/빈값: F

Y/N, 예/아니오 형식으로 입력해도 이전 가능합니다

 

Caution

  • 이전 후 회원등급 자동변경 기능을 사용할 예정이라면, 결제구분 값을 반드시 함께 이전해 주세요.
  • 결제구분은 이전한 주문의 금액을 회원등급에 반영할지 판별하는 기준입니다. 결제구분이 T(결제완료)인 주문의 총 결제금액만 등급 산정에 반영되고, F인 주문은 제외됩니다.
  • 결제구분을 이전하지 않으면 모든 주문이 F로 저장되어, 이전한 주문 금액이 회원등급에 전혀 반영되지 않습니다.

 

결제수단

규칙 결제수단명을 문자열로 입력하며, 입력된 값 그대로 이전
예시 카드, 무통장, 휴대폰결제

 

입금은행

규칙 64자 이하 문자로 구성 되어야 함

 

 


 

연관 콘텐츠

 

 

최종 업데이트: 2026-09-22