Transporter의 주문 CSV 열 설명
주문 CSV 파일의 열에 대한 설명입니다.
Transporter 앱을 사용하여 Shopify로 가져오려면, 이 레코드 유형만 포함된 CSV 파일이 필요합니다.
CSV 샘플 파일
다음의 orders.csv에서 샘플 주문 CSV 파일을 다운로드합니다.
트랜스포터 명령 줄 도구를 사용하여 CSV 파일을 생성하거나 아래 설명된 형식에 따라 해당 파일을 직접 생성할 수 있습니다.
열 설명
다음 표는 CSV 파일에 대한 열 머리글을 설명합니다.
칼럼 | 설명 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Name (Required) |
Shopify 관리자에서 표시되는 주문의 식별자입니다. 고객은 인보이스에서 이를 볼 수 있습니다. 이 식별자는 스토어 내에서 고유한 값이어야 합니다(예: #1001 , 1001-A , SH1001 ). 이 열은 필수 항목입니다. |
||||||||||
고객의 이메일 주소입니다. | |||||||||||
Financial Status | 주문과 관련된 결제 상태입니다. 유효한 값은 다음과 같습니다.
|
||||||||||
Fulfillment Status | 주문 처리된 품목을 기준으로 한 주문의 상태입니다. 유효한 값은 다음과 같습니다.
|
||||||||||
Currency | 결제에 쓰이는 통화는 3자 코드(ISO 4217 형식)입니다(예: USD , EUR ). |
||||||||||
Buyer Accepts Marketing | 고객이 마케팅을 옵트인하기로 결정했는지 여부입니다. 유효한 값:
|
||||||||||
Cancel Reason | 주문이 취소된 이유입니다. 유효한 값은 다음과 같습니다.
|
||||||||||
Cancelled At | 주문이 취소된 날짜 및 시간(ISO 8601 형식)입니다. | ||||||||||
Closed At | 주문이 마감된 날짜 및 시간(ISO 8601 형식)입니다. | ||||||||||
Tags | 필터링 및 검색에 사용되는 쉼표로 구분된 태그의 문자열입니다. 쉼표로 구분된 각 태그는 최대 255자까지 사용할 수 있습니다(예: 'Reviewed, Packed, Delivered' ). |
||||||||||
Note | 주문에 첨부된 선택 사항 메모가 있습니다. 메모는 고객에게 표시될 수 있습니다(예: 'Customer changed their mind.' ). |
||||||||||
Phone | 고객의 고유 전화 번호(E.164 형식)입니다. 전화 번호는 다양한 형식을 사용하여 입력할 수 있지만 각 형식은 전세계 어디에서나 걸 수 있는 숫자로 표시되어야 합니다. 다음 형식은 모두 유효 합니다. 6135551212 +16135551212 (613)555-1212 +1 613-555-1212
|
||||||||||
Referring Site | 고객이 해당 스토어로 이동하기 위해 링크를 클릭한 웹사이트입니다. (예: "http://www.anexample.com" ) |
||||||||||
Processed At |
다른 플랫폼에서 생성된 원래 주문의 날짜 및 시간(ISO 8601 형식)입니다. 이 값은 Shopify 관리자의 주문에 표시되며 판매 보고서에서 사용되는 날짜입니다. 기본값은 주문을 불러온 날짜와 시간입니다. 재정 및 결제 분석에 영향을 미치는 값은 |
||||||||||
Source name | 주문이 시작된 위치(예: 플랫폼 이름)입니다. 이 값은 가져온 후에 편집할 수 없습니다(예: Transporter ). |
||||||||||
Total weight | 모든 품목 중량(정수로 형식화됨)을 그램으로 나타낸 합계입니다(예: 11 ). |
||||||||||
Total Tax | 주문에 적용되는 모든 세금(세금 1 가격, ..., 배송 1 세율)의 합계입니다(양수여야 함). 주문 일부에 세금이 부과되는 경우 이 열이 필요합니다(예를 들어 세금 가격 1열에 값이 있는 경우). 이 열에 값이 포함되지 않으면 주문 총 가격에 어떤 세금도 포함되지 않습니다. | ||||||||||
Shipping Company | 법인명, 배송 주소와 관련된 경우입니다. | ||||||||||
Shipping Name | 배송 주소와 연관된 사람의 전체 이름입니다. 주소에는 연관된 이름이 있어야 합니다. Shipping Name 을(를) 사용하거나 Shipping First Name 및 Shipping Last Name 을(를) 사용하여 해당 작업을 수행할 수 있습니다. |
||||||||||
Shipping Phone | 배송 주소와 연결된 전화 번호(E.164 형식)입니다. 전화 번호는 다양한 형식으로 입력할 수 있지만 각 형식은 전 세계 어디에서나 걸 수 있는 숫자로 표시되어야 합니다. 다음 형식은 모두 유효합니다. 6135551212 +16135551212 (613)555-1212 +1 613-555-1212
|
||||||||||
Shipping First Name | 배송 주소와 연관된 사람의 이름입니다. 주소에는 이름이 연결되어 있어야 합니다. Shipping First Name 을(를) 사용하거나 Shipping Last Name 및 Shipping Name 을(를) 사용하여 해당 작업을 수행할 수 있습니다. |
||||||||||
Shipping Last Name | 배송 주소와 연관된 사람의 성입니다. 주소에는 이름이 연결되어 있어야 합니다. Shipping First Name 을(를) 사용하거나 Shipping Last Name 및 Shipping Name 을(를) 사용하여 해당 작업을 수행할 수 있습니다. |
||||||||||
Shipping Address1 | 배송 주소의 첫 번째 주소 줄입니다. 이 열은 필수 주소입니다(예: 150 Elgin St ). |
||||||||||
Shipping Address2 | 배송 주소의 선택 주소 줄입니다(예: Unit 202 ). |
||||||||||
Shipping City | 배송 주소의 도시 이름입니다. 이 열은 필수 배송 주소입니다(예: Ottawa , Sydney ). |
||||||||||
Shipping Province | 고객이 위치한 지역 이름(예: 시, 도, 주, 현/지역)입니다. 이 열을 포함하는 경우, Shipping Province Code 열은 필수 항목입니다(예: Mexico city , Tasmania , New South Wales , New York ). |
||||||||||
Shipping Province Code | 국가의 주, 시, 도 또는 지역과 같이 지역에 할당된 구분 코드(ISO 3166-2)입니다. Shipping Province 열을 포함하는 경우 이 열은 필수 항목입니다. ISO3116-2 코드는 다음과 같은 부분으로 구성되어 있습니다.
|
||||||||||
Shipping Zip | 고객 주소의 우편 번호입니다. (예: K2P 1L4 , 90210 , 110 012 ) |
||||||||||
Shipping Country | 배송 주소의 국가 이름입니다. 이 열은 필수입니다(예: 캐나다, 인도, 오스트레일리아). | ||||||||||
Shipping Country Code | 고객 주소의 국가에 해당하는 두 글자(ISO 3166-1 alpha-2 코드)입니다. 예를 들어, 캐나다의 경우 CA . Shipping Country 을(를) 지정한 경우에도 Shipping Country code 을(를) 지정합니다. |
||||||||||
Billing Company | 청구 주소와 관련된 사람의 회사입니다. | ||||||||||
Billing Name | 결제와 연관된 사람의 전체 이름입니다. 주소에는 연관된 이름이 있어야 합니다. Billing Name 을(를) 사용하거나 Billing First Name 및 Billing Last Name 을(를) 사용하여 해당 작업을 수행할 수 있습니다. |
||||||||||
Billing Phone | 청구 주소와 연결된 전화 번호(E.164 형식)입니다. 전화 번호는 다양한 형식으로 입력할 수 있지만 각 형식은 전 세계 어디에서나 걸 수 있는 숫자로 표시되어야 합니다. 다음 형식은 모두 유효합니다. 6135551212 +16135551212 (613)555-1212 +1 613-555-1212
|
||||||||||
Billing First Name | 결제 방법에 연결된 사람의 이름입니다. 주소에는 관련된 이름이 있어야 합니다. Billing First Name 을(를) 사용하거나 Billing Last Name 및 Billing Name 을(를) 사용하여 해당 작업을 수행할 수 있습니다. |
||||||||||
Billing Last Name | 결제 방법과 관련 있는 사람의 성입니다. 주소에는 관련된 이름이 있어야 합니다. Billing First Name 을(를) 사용하거나 Billing Last Name 및 Billing Name 을(를) 사용하여 해당 작업을 수행할 수 있습니다. |
||||||||||
Billing Address1 | 청구 주소의 첫 번째 주소 줄입니다(예: 150 Elgin St ). 이 열은 청구 주소에 필요합니다. |
||||||||||
Billing Address2 | 청구 주소의 선택 주소 줄입니다(예: Unit 202 ). |
||||||||||
Billing City | 청구 주소의 도시의 이름입니다. 이 열은 청구 주소에 필요합니다(예: Ottawa , Delhi , Auckland ). |
||||||||||
Billing Province | 청구 주소가 있는 지역의 이름(예: 시, 도, 현/지역)입니다. 이 열을 포함하는 경우 Shipping Province Code 열은 필수 항목입니다. (예: Mexico city , New York , Nunavut , New South Wales ) |
||||||||||
Billing Province Code | 국가의 주, 시, 도 또는 지역과 같이 지역의 구분 코드(ISO 3166-2)입니다. Billing Province 열을 지정하는 경우 이 열은 필수 항목입니다. ISO3116-2 코드는 다음과 같은 부분으로 구성되어 있습니다.
|
||||||||||
Billing Zip | 청구 주소의 우편 번호입니다(예: K2P 1L4 ). |
||||||||||
Billing Country | 청구 주소의 국가 이름입니다. 이 열은 주소 청구에 필요합니다(예: Canada , India , Germany ). |
||||||||||
Billing Country Code | 청구 주소의 국가에 해당하는 두 글자(ISO 3166-1 alpha-2 코드) 입니다. 예를 들어, 캐나다의 경우 CA Country 을(를) 지정한 경우에도 Country code 을(를) 지정합니다. |
||||||||||
Lineitem name (Required) |
주문된 제품 이형 상품의 이름입니다. 예를 들면, Blue shirt 입니다. 이 열은 필수 항목입니다. |
||||||||||
Lineitem variant ID | 주문된 제품 이형 ID입니다. 이 열을 사용하여 이 주문의 품목을 스토어에 있는 제품 이형에 연결합니다(예: 7513594 ). 이 열에 있는 ID가 스토어의 제품 이형 ID와 일치하는지 확인해야 합니다. Transporter 앱이 이 열에 있는 ID와 일치하는 제품 이형을 스토어에서 찾지 못하는 경우에는 가져오기가 영향을 받지 않습니다. 제품은 주문에 여전히 추가되지만 분석용 스토어의 제품과 일치하지 않게 됩니다. |
||||||||||
Lineitem quantity | 주문된 제품 이형 상품의 수량입니다. 이 열에는 양의 정수만 허용됩니다. 기본값은 1입니다. (예: 3 ) |
||||||||||
Lineitem price (Required) |
할인이 적용되지 않은 제품 이형 상품의 가격입니다. (예: 10.50 , .25 , 30 ) 이 열은 필수 항목입니다. |
||||||||||
Lineitem variant title | 특정 제품 이형입니다. 예를 들어 스몰 입니다. |
||||||||||
Lineitem compare at price | 제품 이형 상품의 비교 또는 권장 가격입니다. (예: 15 ) |
||||||||||
Lineitem sku | 품목(제품 이형)의 SKU(재고 관리 코드)번호입니다. | ||||||||||
Lineitem requires shipping | 제품 이형 상품의 배송이 필요한지 여부입니다. 유효한 값은 다음과 같습니다.
|
||||||||||
Lineitem taxable | 제품 이형 상품이 과세 대상인지 여부입니다. 유효한 값은 다음과 같습니다.
|
||||||||||
Lineitem fulfillment status | 주문에 포함된 개별 품목의 주문 처리 상태입니다. 유효한 값:
|
||||||||||
Taxes Included | 세금이 주문에 포함되었는지 여부입니다. 유효한 값은 다음과 같습니다.
|
||||||||||
Tax 1 Title | 첫 번째 청구된 세금의 이름입니다(예: HST 또는 VAT ). |
||||||||||
Tax 1 Price | 품목에 청구된 세금의 금액(ISO 4217)입니다(예: 1.50 ). 이 열의 값이 있는 경우 Total Tax 열도 포함해야 합니다. |
||||||||||
Tax 1 Rate | 품목에 청구될 세금의 세율(소수)입니다. 예를 들어, .07 세율은 7%입니다. |
||||||||||
Tax 2 Title | 두 번째 청구된 세금의 이름입니다. | ||||||||||
Tax 2 Price | 청구된 세금의 금액(ISO 4217)입니다. 이 열의 값이 있는 경우 Total Tax 열도 포함해야 합니다. |
||||||||||
Tax 2 Rate | 품목에 청구된 세금 비율입니다. | ||||||||||
Tax 3 Title | 세 번째 청구된 세금의 이름입니다. | ||||||||||
Tax 3 Price | 품목에 청구된 세금의 금액(ISO 4217)입니다. 이 열의 값이 있는 경우 Total Tax 열도 포함해야 합니다. |
||||||||||
Tax 3 Rate | 품목에 청구된 세금 비율입니다. | ||||||||||
Transaction Amount | 거래에 대한 금액(소수)입니다(예: 50.00 ). 이 열은 부분 결제 또는 부분 환불을 수행하는 경우에 필요합니다. |
||||||||||
Transaction Kind | 거래 유형입니다. 이 열은 거래 열이 하나라도 포함된 경우 필요합니다. 유효한 값은 다음과 같습니다.
|
||||||||||
Transaction Status | 거래 상태입니다. 유효한 값은 다음과 같습니다.
|
||||||||||
Transaction Processed At |
다른 플랫폼에서 수행된 원래 거래의 날짜 및 시간(ISO 8601 형식)입니다. 이 값은 Shopify 관리자의 주문에 표시되며 재정 보고서에서 사용되는 날짜입니다. 기본값은 주문을 불러온 날짜와 시간입니다. 주문이 생성된 시점의 결제를 받은 경우 |
||||||||||
Transaction Gateway | 거래가 실행된 게이트웨이의 이름입니다. 게이트웨이 목록은 Shopify의 전자결제 대행사 페이지에서 확인할 수 있습니다. | ||||||||||
Transaction Location ID | 거래가 발생한 위치의 식별자입니다. 이 ID는 스토어에 설정된 위치 ID와 일치해야 합니다. 스토어의 거래 위치 ID와 일치하지 않는 값은 가져오지 않습니다. | ||||||||||
Transaction Source Name | 거래의 출발지입니다(예제 값: web , pos , iphone , android ). |
||||||||||
Shipping Line Code | 배송 방법에 대한 참조입니다. 기본값은 Shipping line title 입니다. |
||||||||||
Shipping Line Price | 배송 방법의 값입니다. Shipping line title 열이 포함된 경우 필요합니다. |
||||||||||
Shipping Line Source | 배송 출발지입니다. | ||||||||||
Shipping Line Title | 배송 방법의 제목입니다. Shipping line price 열이 포함된 경우 필요합니다. |
||||||||||
Shipping Line Carrier Identifier | 배송료를 제공하는 배송업체 서비스의 식별자입니다. 일반적으로 타사 배송 업체 서비스를 사용하는 경우 이 값이 필요합니다. | ||||||||||
Shipping Line Requested Fulfillment Service ID | 배송 방법을 요청하는 주문 처리 서비스의 식별자입니다. 이 값은 일반적으로 타사 주문 처리 서비스를 통한 배송 방법을 사용하는 경우에 필요합니다. | ||||||||||
Shipping Tax 1 Title | 배송 품목에 청구된 세금의 이름입니다(예: HST ). |
||||||||||
Shipping Tax 1 Rate | 배송 품목에 청구되는 세금 비율(소수)입니다. 예를 들어, 15% (퍼센트)의 배송료 세율은 0.15 입니다. |
||||||||||
Shipping Tax 1 Price | 배송 품목에 청구될 세금의 금액(ISO 4217 형식)입니다. 이 열에 대한 값이 있는 경우 Total Tax 열도 포함해야 합니다(예: 1.50 ). |
||||||||||
Discount Code | 할인 코드입니다. Discount type 열을 포함하는 경우 이 열은 필수 항목입니다. |
||||||||||
Discount Amount |
주문에서 차감된 할인의 값(스토어의 통화)입니다 입력한 값이 |
||||||||||
Discount Type |
할인 유형. 유효한 값은 다음과 같습니다.
값은 대소문자를 구분합니다. 주문 내의 특정 품목에는 할인을 적용할 수 없습니다. 자세한 내용은 할인 가져오기를 참조하십시오. |
||||||||||
Metafield Namespace |
메타 필드 세트에 대한 컨테이너입니다. 메타 필드를 가져오려면 4개의 메타 필드 열(Metafield Namespace , Metafield Key , Metafield Value , Metafield Type ) 모두에 값을 포함해야 합니다. 메타 필드에 대한 사용자 지정 네임스페이스를 지정하여 앱과 Shopify에서 사용하는 네임스페이스와 구별해야 합니다(기본값 global 포함). 최대 길이는 20자입니다. |
||||||||||
Metafield Key | 메타 필드의 이름입니다. 최대 길이: 30자. 다른 메타 필드 열을 포함하는 경우 이 열은 필수 항목입니다. | ||||||||||
Metafield Value | 메타데이터로 저장되어야 하는 정보입니다. 이 열은 다른 메타 필드 열이 포함된 경우 필요합니다. | ||||||||||
Metafield Type | 메타 필드 정보 유형입니다. 올바른 값은 다음과 같습니다.
|
파일 이름
CSV 파일의 이름에는 order
(포함된 개체 유형의 이름) 단어가 포함되어야 합니다. 예를 들어, myorders.csv. 파일은 UTF-8 형식이어야 합니다.
주소
주문의 배송 주소가 고객의 기본 주소가 됩니다. 고객과 관련된 주문을 가져오면 Transporter 앱은 Shopify 스토어에서 고객을 확인합니다.
- Transporter가 고객을 찾으면 주문이 고객과 연결되고 주문의 배송 주소가 고객의 기본 주소로 설정됩니다.
- Transporter가 고객을 찾지 못하면 고객이 추가되고 주문이 고객에게 연결됩니다.
여러 거래
각 거래에 별도의 행을 생성하여 주문에 거래를 추가할 수 있습니다. 거래를 주문에 연결하려면 Order name
을(를) 각 행에 포함해야 합니다.
주문 처리 상태
주문 처리 상태는 해당 주문을 구성하는 품목의 주문 처리 상태를 기준으로 결정되어야 합니다.
- 모든 품목이 주문 미처리 상태인 경우에는 주문 처리 상태를 공란으로 두어 주문이 미처리 상태임을 표시해야 합니다.
- 품목의 상태가 조합된 경우(
fulfilled
또는unfulfilled
) 주문 처리 상태는partial
이(가) 되어야 합니다. - 모든 품목을 주문 처리하는 경우에는 주문 처리 상태가
fulfilled
이(가) 되어야 합니다.
할인 가져오기
할인은 주문 단계에서만 적용할 수 있으며 주문 내의 특정 품목에는 적용되지 않습니다. 특정 품목에 할인이 적용된 주문이 있는 경우 총 할인 금액을 결정한 다음 전체 주문에 적용합니다. 이를 통해 판매 보고를 정확하게 유지할 수 있습니다.