Transporter의 주문 CSV 열 설명

주문 CSV 파일의 열에 대한 설명입니다.

플러스 : 트랜스포터 앱은 Shopify 플러스 판매자를 위한 Shopify 앱 스토어에서만 사용할 수 있습니다.

Transporter 앱을 사용하여 Shopify로 가져오려면, 이 레코드 유형만 포함된 CSV 파일이 필요합니다.

CSV 샘플 파일

다음의 orders.csv에서 샘플 주문 CSV 파일을 다운로드합니다.

트랜스포터 명령 줄 도구를 사용하여 CSV 파일을 생성하거나 아래 설명된 형식에 따라 해당 파일을 직접 생성할 수 있습니다.

열 설명

다음 표는 CSV 파일에 대한 열 머리글을 설명합니다.

주문 CSV 열 헤더
칼럼 설명
Name (Required)
Shopify 관리자에서 표시되는 주문의 식별자입니다. 고객은 인보이스에서 이를 볼 수 있습니다. 이 식별자는 스토어 내에서 고유한 값이어야 합니다(예: #1001, 1001-A, SH1001). 이 열은 필수 항목입니다.
Email 고객의 이메일 주소입니다.
Financial Status 주문과 관련된 결제 상태입니다. 유효한 값은 다음과 같습니다.
  • pending - 결제가 보류 중입니다. 이 경우 결제가 실패할 수 있습니다. 결제가 성공적으로 완료되었는지 다시 확인합니다.
  • authorized - 결제가 승인되었습니다.
  • partially_paid - 주문이 일부 결제되었습니다.
  • paid - 결제가 완료되었습니다.
  • partially_refunded - 결제가 일부 환불되었습니다.
  • refunded - 결제가 환불 처리되었습니다.
  • voided - 결제가 무효 처리되었습니다.
값은 대소문자를 구분합니다.
Fulfillment Status 주문 처리된 품목을 기준으로 한 주문의 상태입니다. 유효한 값은 다음과 같습니다.
  • fulfilled - 모든 품목이 처리되었습니다.
  • partial - 한 개 이상의 품목이 처리되었습니다.
  • restocked - 모든 품목이 재입고되었으며 주문이 취소되었습니다.
  • 이 열을 공란으로 두면 주문 미처리 상태가 됩니다.
값은 대소문자를 구분합니다. 주문 처리 상태는 개별 품목 상태가 기준이어야 합니다. 자세한 내용은 아래의 주문 처리 상태를 참조하십시오.
Currency 결제에 쓰이는 통화는 3자 코드(ISO 4217 형식)입니다(예: USD, EUR).
Buyer Accepts Marketing 고객이 마케팅을 옵트인하기로 결정했는지 여부입니다. 유효한 값:
  • TRUE - 고객이 마케팅 수신에 옵트인되었습니다.
  • FALSE - 고객이 마케팅 수신에 옵트아웃되었습니다.
Cancel Reason 주문이 취소된 이유입니다. 유효한 값은 다음과 같습니다.
  • customer - 고객이 주문을 취소했습니다.
  • fraud - 사기성 주문입니다.
  • inventory - 주문 품목이 재고가 없습니다.
  • declined - 결제가 거부 되었습니다.
  • other - 이 목록에 없는 이유입니다.
값은 대소문자를 구분합니다.
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 관리자의 주문에 표시되며 판매 보고서에서 사용되는 날짜입니다. 기본값은 주문을 불러온 날짜와 시간입니다.

재정 및 결제 분석에 영향을 미치는 값은 Transaction Processed At을 참조하십시오.

Source name 주문이 시작된 위치(예: 플랫폼 이름)입니다. 이 값은 가져온 후에 편집할 수 없습니다(예: Transporter).
Total weight 모든 품목 중량(정수로 형식화됨)을 그램으로 나타낸 합계입니다(예: 11).
Total Tax 주문에 적용되는 모든 세금(세금 1 가격, ..., 배송 1 세율)의 합계입니다(양수여야 함). 주문 일부에 세금이 부과되는 경우 이 열이 필요합니다(예를 들어 세금 가격 1열에 값이 있는 경우). 이 열에 값이 포함되지 않으면 주문 총 가격에 어떤 세금도 포함되지 않습니다.
Shipping Company 법인명, 배송 주소와 관련된 경우입니다.
Shipping Name 배송 주소와 연관된 사람의 전체 이름입니다. 주소에는 연관된 이름이 있어야 합니다. Shipping Name을(를) 사용하거나 Shipping First NameShipping Last Name을(를) 사용하여 해당 작업을 수행할 수 있습니다.
Shipping Phone 배송 주소와 연결된 전화 번호(E.164 형식)입니다. 전화 번호는 다양한 형식으로 입력할 수 있지만 각 형식은 전 세계 어디에서나 걸 수 있는 숫자로 표시되어야 합니다. 다음 형식은 모두 유효합니다.
6135551212
+16135551212
(613)555-1212
+1 613-555-1212
Shipping First Name 배송 주소와 연관된 사람의 이름입니다. 주소에는 이름이 연결되어 있어야 합니다. Shipping First Name을(를) 사용하거나 Shipping Last NameShipping Name을(를) 사용하여 해당 작업을 수행할 수 있습니다.
Shipping Last Name 배송 주소와 연관된 사람의 성입니다. 주소에는 이름이 연결되어 있어야 합니다. Shipping First Name을(를) 사용하거나 Shipping Last NameShipping 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 코드는 다음과 같은 부분으로 구성되어 있습니다.
  • 2자리 문자 국가 코드 - 이 부분은 포함하지 않습니다.
  • 코드를 두 부분으로 나누는 하이픈(-) - 하이픈은 포함하지 않습니다.
  • 1~3자리 문자 구역 코드- - 이 부분만 포함합니다.
구역 코드
ISO 3166-2 구역 코드 지역 코드
MX-MEX(멕시코, 멕시코 시티) MEX
NY-US(미국, 뉴욕) NY
Ar-B(아르헨티나, 부에노스 아이레스) B
FR-21(프랑스, 코트 도르) 21
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 NameBilling Last Name을(를) 사용하여 해당 작업을 수행할 수 있습니다.
Billing Phone 청구 주소와 연결된 전화 번호(E.164 형식)입니다. 전화 번호는 다양한 형식으로 입력할 수 있지만 각 형식은 전 세계 어디에서나 걸 수 있는 숫자로 표시되어야 합니다. 다음 형식은 모두 유효합니다.
6135551212
+16135551212
(613)555-1212
+1 613-555-1212
Billing First Name 결제 방법에 연결된 사람의 이름입니다. 주소에는 관련된 이름이 있어야 합니다. Billing First Name을(를) 사용하거나 Billing Last NameBilling Name을(를) 사용하여 해당 작업을 수행할 수 있습니다.
Billing Last Name 결제 방법과 관련 있는 사람의 성입니다. 주소에는 관련된 이름이 있어야 합니다. Billing First Name을(를) 사용하거나 Billing Last NameBilling 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 코드는 다음과 같은 부분으로 구성되어 있습니다.
  • 2자리 문자 국가 코드 - 이 부분은 포함하지 않습니다.
  • 코드를 두 부분으로 나누는 하이픈(-) - 하이픈은 포함하지 않습니다.
  • 1~3자리 문자 구역 코드- - 이 부분만 포함합니다.
구역 코드
ISO 3166-2 구역 코드 지역 코드
MX-MEX(멕시코, 멕시코 시티) MEX
US-NY(미국, 뉴욕) NY
AR-B(아르헨티나, 부에노스 아이레스) B
FR-21(프랑스, 코트 도르) 21
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 제품 이형 상품의 배송이 필요한지 여부입니다. 유효한 값은 다음과 같습니다.
  • true - 이 품목은 배송이 필요합니다.
  • false - 이 품목은 배송이 필요하지 않습니다.
값은 대소문자를 구분합니다.
Lineitem taxable 제품 이형 상품이 과세 대상인지 여부입니다. 유효한 값은 다음과 같습니다.
  • true - 품목이 과세 대상입니다.
  • false - 품목이 과세 대상이 아닙니다.
값은 대소문자를 구분합니다.
Lineitem fulfillment status 주문에 포함된 개별 품목의 주문 처리 상태입니다. 유효한 값:
  • fulfilled - 품목별 제품을 모두 주문 처리했습니다.
  • 이 열을 공란으로 두면 주문 미처리 품목 상태가 됩니다.
값은 대소문자를 구분합니다. 개별 품목의 주문 처리 상태는 주문 상태를 결정하는 데 전반적으로 사용되어야 합니다. 자세한 내용은 아래의 주문 처리 상태를 참조하십시오.
Taxes Included 세금이 주문에 포함되었는지 여부입니다. 유효한 값은 다음과 같습니다.
  • true - 소계에 세금이 포함됩니다. 이 값을 true로 설정하면 품목 세금 및 배송료에 대한 세금을 포함하여 모든 세금이 가격에 포함됩니다.
  • false - 소계에 세금이 포함되지 않습니다. 이 값은 기본값입니다.
값은 대소문자를 구분합니다.
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 거래 유형입니다. 이 열은 거래 열이 하나라도 포함된 경우 필요합니다. 유효한 값은 다음과 같습니다.
  • authorization - 고객이 결제하기로 동의한 금액이 승인되었지만, 아직 매입되지 않았습니다. 권한 부여 기간은 결제 서비스에 따라 7일에서 30일 사이가 될 수 있으며 스토어는 결제가 매입될 때까지 대기합니다.
  • capture - 승인 중 예약된 송금입니다.
  • sale - 단일 단계에서 진행된 결제의 승인 및 매입입니다.
  • void - 보류 중인 승인 또는 매입의 취소입니다.
  • refund - 고객에게 매입된 금액의 일부 또는 전체 반품입니다.
값은 대소문자를 구분합니다.
Transaction Status 거래 상태입니다. 유효한 값은 다음과 같습니다.
  • success - 거래가 전자결제 대행사에서 성공적으로 완료되었습니다. 이 값은 기본값입니다.
  • pending - 게이트웨이에서 거래 정보를 받았지만 완료하는데 시간이 더 필요하다는 응답을 보냈습니다.
  • failure - 게이트웨이에서 거래가 실패했다는 응답을 보냈습니다(예: 카드가 거부 되었거나 스토어 전자결제 대행사 설정이 올바르지 않기 때문).
  • error - 통신 오류가 발생했습니다(예: 게이트웨이의 응답이 수신되지 않았거나 게이트웨이가 요청을 받지 못함).
값은 대소문자를 구분합니다.
Transaction Processed At

다른 플랫폼에서 수행된 원래 거래의 날짜 및 시간(ISO 8601 형식)입니다. 이 값은 Shopify 관리자의 주문에 표시되며 재정 보고서에서 사용되는 날짜입니다. 기본값은 주문을 불러온 날짜와 시간입니다.

주문이 생성된 시점의 결제를 받은 경우 Transaction Processed AtProcessed At의 값이 같아야 합니다.

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 Price 배송 품목에 청구될 세금의 금액(ISO 4217 형식)입니다. 이 열에 대한 값이 있는 경우 Total Tax 열도 포함해야 합니다(예: 1.50).
Discount Code 할인 코드입니다. Discount type 열을 포함하는 경우 이 열은 필수 항목입니다.
Discount Amount

주문에서 차감된 할인의 값(스토어의 통화)입니다 Discount type 열을 포함하는 경우, 이 열은 필수 항목입니다.

입력한 값이 Discount type과 일치하는지 확인하십시오. 유형이 percentage라면 할인의 백분율 값을 입력합니다. 유형이 fixed_amount라면 할인의 총 달러 값을 입력합니다.

Discount Type

할인 유형. 유효한 값은 다음과 같습니다.

  • fixed_amount - 특정 금액에 대한 할인 코드입니다. 이 값은 기본값입니다.
  • percentage - 백분율 금액에 대한 할인 코드입니다.
  • shipping - 배송비가 amount에 설정된 값 이하인 경우 할인이 적용되면 무료 배송이 됩니다. 예를 들어, Discount amount가 $30이고 배송비가 $30면 할인은 $30입니다. 예를 들어, Discount amount이(가) 30이고 배송비가 $100이면 할인되지 않습니다.

값은 대소문자를 구분합니다. 주문 내의 특정 품목에는 할인을 적용할 수 없습니다. 자세한 내용은 할인 가져오기를 참조하십시오.

Metafield Namespace 메타 필드 세트에 대한 컨테이너입니다. 메타 필드를 가져오려면 4개의 메타 필드 열(Metafield Namespace, Metafield Key, Metafield Value, Metafield Value Type) 모두에 값을 포함해야 합니다. 메타 필드에 대한 사용자 지정 네임스페이스를 지정하여 앱과 Shopify에서 사용하는 네임스페이스와 구별해야 합니다(기본값 global 포함). 최대 길이는 20자입니다.
Metafield Key 메타 필드의 이름입니다. 최대 길이: 30자. 다른 메타 필드 열을 포함하는 경우 이 열은 필수 항목입니다.
Metafield Value 메타데이터로 저장되어야 하는 정보입니다. 이 열은 다른 메타 필드 열이 포함된 경우 필요합니다.
Metafield Value Type 메타 필드 정보 유형입니다. 올바른 값은 다음과 같습니다.
  • string
  • integer
  • json_string
값은 대소문자를 구분합니다. 다른 메타 필드 열을 포함하는 경우 이 열은 필수 항목입니다.

파일 이름

CSV 파일의 이름에는 order(포함된 개체 유형의 이름) 단어가 포함되어야 합니다. 예를 들어, myorders.csv. 파일은 UTF-8 형식이어야 합니다.

주소

주문의 배송 주소가 고객의 기본 주소가 됩니다. 고객과 관련된 주문을 가져오면 Transporter 앱은 Shopify 스토어에서 고객을 확인합니다.

  • Transporter가 고객을 찾으면 주문이 고객과 연결되고 주문의 배송 주소가 고객의 기본 주소로 설정됩니다.
  • Transporter가 고객을 찾지 못하면 고객이 추가되고 주문이 고객에게 연결됩니다.

여러 거래

각 거래에 별도의 행을 생성하여 주문에 거래를 추가할 수 있습니다. 거래를 주문에 연결하려면 Order name을(를) 각 행에 포함해야 합니다.

주문 처리 상태

주문 처리 상태는 해당 주문을 구성하는 품목의 주문 처리 상태를 기준으로 결정되어야 합니다.

  • 모든 품목이 주문 미처리 상태인 경우에는 주문 처리 상태를 공란으로 두어 주문이 미처리 상태임을 표시해야 합니다.
  • 품목의 상태가 조합된 경우(fulfilled 또는 unfulfilled) 주문 처리 상태는 partial이(가) 되어야 합니다.
  • 모든 품목을 주문 처리하는 경우에는 주문 처리 상태가 fulfilled이(가) 되어야 합니다.

할인 가져오기

할인은 주문 단계에서만 적용할 수 있으며 주문 내의 특정 품목에는 적용되지 않습니다. 특정 품목에 할인이 적용된 주문이 있는 경우 총 할인 금액을 결정한 다음 전체 주문에 적용합니다. 이를 통해 판매 보고를 정확하게 유지할 수 있습니다.

자세히 알아보기

Shopify와 함께 사업을 시작할 준비가 되셨습니까?

무료 체험