계약 CSV 가져오기 및 내보내기

CSV(쉼표로 구분된 값) 파일을 사용하여 타사 구독 앱의 계약을 Shopify Subscriptions 앱으로 가져오거나 Shopify Subscriptions 앱에서 계약을 내보낼 수 있습니다.

CSV 파일을 사용하는 방법에 대해 자세히 알아보려면 CSV 파일 열기 및 편집을 참조하십시오.

샘플 CSV 파일 다운로드

샘플 계약 CSV 파일을 다운로드하여 템플릿으로 사용할 수 있습니다.

계약 CSV 파일 관련 고려 사항

계약 CSV 파일을 사용하여 계약을 가져오기 전에 다음 고려 사항을 검토하십시오.

CSV 파일 형식 지정

계약 CSV 파일을 올바르게 가져오려면 다음 기준을 충족해야 합니다.

  • 계약 CSV 파일의 첫 줄에는 계약 CSV 설명 표에 지정된 열 헤더가 와야 합니다.
  • 각 열은 comma로 구분해야 합니다.
  • CSV 파일의 최대 크기는 10MB입니다.

핸들 열 이해

핸들은 각 계약을 고유하게 식별하는 데 사용됩니다. 핸들은 다음 방식으로 데이터를 관리하는 데 사용됩니다.

  • 여러 품목이 포함된 계약: 여러 품목이 포함된 계약은 공유된 핸들로 그룹화됩니다.
  • 중복 계약 방지: 계약 중복은 가져올 때 무시됩니다. 같은 핸들이 있는 행을 이전에 가져오는 데 성공하면 새 가져오기 프로세스에서 해당 행을 건너뜁니다. 이 메커니즘을 사용하면 데이터 중복을 방지할 수 있습니다.

여러 품목이 포함된 계약

여러 품목이 포함된 계약에는 각 품목이 별도의 행을 필요로 하며 핸들 열과 함께 그룹화됩니다.

예를 들어 계약에 품목이 3개인 경우 각 품목을 별도의 행으로 추가해야 합니다. 첫 번째 행은 모든 계약 정보를 포함하며 다음 두 행은 다음 열의 값만 포함합니다.

  • handle
  • line_variant_id
  • line_quantity
  • line_current_price
  • 선택 사항: line_selling_plan_id
  • 선택 사항: line_selling_plan_name

핸들은 3개 열에서 모두 같아야 합니다. 2행과 3행의 다른 모든 열은 비어 있어야 합니다. 샘플 CSV 템플릿을 다운로드하여 여러 품목 계약의 예를 검토할 수 있습니다.

CSV 파일에 대한 설명

계약 CSV에 사용되는 정보의 범주: * 계약의 이름 * 고객 및 청구 정보 * 배송 방법 및 정보 * 구독에 포함된 품목

올바르게 가져오려면 모든 열을 CSV 파일에 추가해야 하며, 별도로 명시하지 않는 한 모든 필드가 필수입니다.

계약 CSV 파일의 열에 대한 설명입니다.
칼럼 설명
Handle 핸들은 각 계약의 고유 식별자입니다. 예를 들면 red-shirt입니다. 핸들에는 문자와 숫자가 포함될 수 있으며 일반적으로 글자, 숫자 또는 둘 다 결합된 문자열입니다. 각 계약에는 고유한 핸들이 있어야 합니다.
upcoming_billing_date 계약의 예정된 청구 날짜입니다.
시간은 UTC(협정세계시)이며 YYYY-MM-DDTHH:MM:SSZ 형식으로 지정해야 합니다.
예를 들어 UTC(협정세계시) 표준 시간대의 2019년 9월 7일 오후 3시 50분은 2019-09-07T15:50:00Z로 표시됩니다.
다음 청구 날짜 값은 CSV 파일을 가져온 날짜 및 시간 이후 최소 24시간 후의 날짜와 시간으로 설정해야 합니다.
customer_id 고객 ID입니다. ID는 Shopify 관리자의 기존 고객의 ID와 일치해야 하며 숫자의 문자열이어야 합니다. (예: 6320530986896)
currency_code 계약의 통화 코드입니다. 통화 코드는 스토어에서 활성화된 통화와 일치해야 합니다.
status 계약 상태입니다. 계약 상태에는 다음 중 하나를 사용할 수 있습니다.
  • 활성
  • 일시 중지됨
cadence_interval 구독의 배송 빈도입니다. 계약에는 다음 주기 간격 중 하나를 사용할 수 있습니다.
cadence_interval_count 전체 시간 간격 내에서 구독의 배송 빈도입니다. 예를 들어 매월 주기 간격 수는 1이고 매 2주 주기 간격은 2입니다.
customer_payment_method_id 고객이 계약에 사용한 결제 방법의 ID입니다. ID는 고유 영숫자 코드입니다. (예: 24e8c839c47ef47d30ad28346d130e74)
delivery_price 올바른 통화 형식의 배송 비용입니다.
delivery_method_type 구독의 배송 방법입니다. 배송 방법은 다음 유형 중 하나여야 합니다.
  • 배송
  • 지역 배송
  • 픽업
  • 없음
delivery_address_first_name 배송 주소의 수신자의 이름입니다. 이 필드는 배송지역 배송 방법에만 필요합니다.
delivery_address_last_name 배송 주소에 기재되는 수취인의 성입니다.
이 필드는 배송지역 배송 방법에서만 필수 항목입니다.
delivery_address_address1 배송 주소의 첫 번째 줄입니다.
이 필드는 배송지역 배송 방법에서만 필수 항목입니다.
delivery_address_address2 배송 주소의 두 번째 줄입니다.
이 필드는 주소에 두 번째 필드가 있고 배송 방법이 배송지역 배송인 경우에만 필요합니다.
delivery_address_city 배송 주소의 도시명입니다.
이 필드는 배송지역 배송 방법에서만 필수 항목입니다.
delivery_address_province_code 배송 주소의 주/도 ISO 코드입니다.
이 필드는 배송지역 배송 방법에서만 필수 항목입니다.
delivery_address_country_code 배송 주소의 국가 ISO 코드입니다.
이 필드는 배송지역 배송 방법에서만 필수 항목입니다.
delivery_address_company 배송 주소의 회사 이름입니다.
이 필드는 주문이 비즈니스용이고 배송 방법이 배송지역 배송인 경우에만 필요합니다.
delivery_address_zip 배송 주소의 우편 번호입니다.
이 필드는 배송지역 배송 방법에서만 필수 항목입니다.
delivery_address_phone 배송 주소의 전화 번호입니다. (예: +1 (613) 555-5555)
이 필드는 배송지역 배송 방법에서만 필수 항목입니다.
delivery_local_delivery_phone 배송 주소의 전화 번호입니다.
이 필드는 지역 배송 방법을 사용하는 구독에만 필요합니다.
delivery_local_delivery_instructions 지역 배송 지침입니다.
이 필드는 지역 배송 방법을 사용하는 구독에 지침이 제공되는 경우에만 포함해야 합니다.
delivery_pickup_method_location_id 픽업 방법의 위치 ID입니다.
이 필드는 지역 픽업 방법을 사용하는 구독에만 필요합니다.
line_variant_id 구독에 포함된 각 품목의 ID(예: 53154087005812)입니다.
구독에 여러 품목이 포함된 경우 각 품목을 고유 이형 상품 ID가 있는 새 줄로 추가해야 합니다.
line_quantity 구독에 포함된 각 품목의 수량입니다.
구독에 여러 품목이 포함된 경우 추가된 수량은 포함된 모든 항목의 총 수량이 아니라 해당 특정 항목의 수량입니다.
line_current_price 올바른 통화 형식의 구독 품목 가격입니다.
line_selling_plan_id 구독 플랜 ID입니다. (예: 3607724288)
이 필드는 선택 사항입니다.
line_selling_plan_name 가입 요금의 이름입니다.
이 필드는 선택 사항입니다.

CSV 파일을 사용하여 계약 가져오기

CSV 파일을 사용하여 Shopify 앱스토어의 적격 타사 가입 앱 또는 다른 스토어에 있는 Shopify Subscriptions 앱에서 기존 계약을 가져올 수 있습니다.

CSV 파일로 기존 계약을 편집하거나 덮어쓸 수는 없습니다. 기존의 중복 계약은 가져오기 중에 무시됩니다.

타사 가입 앱에서 계약 가져오기

타사 가입 앱에서 계약을 가져올 수 있습니다. 타사 앱에서 가져오는 경우 다음 동작을 고려하세요.

단계:

  1. Shopify 관리자에서 가입 > 계약으로 이동합니다.
  2. 가져오기를 클릭합니다.
  3. 파일 추가를 클릭한 다음, 가져올 CSV 파일을 선택합니다.
  4. 파일 업로드를 클릭합니다.

CSV 파일을 업로드하면 Shopify 스토어를 설정하는 데 사용한 이메일 계정으로 확인 이메일을 받을 수 있습니다. 일반적인 가져오기 오류의 해결 방법을 확인해 보십시오.

CSV 파일을 사용하여 계약 내보내기

기록을 위해 또는 Shopify Subscriptions 앱이 설치된 다른 Shopify 스토어로 가져오기 위해 계약을 내보낼 수 있습니다.

단계:

  1. Shopify 관리자에서 가입 > 계약으로 이동합니다.
  2. 내보내기를 클릭합니다.

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

무료 체험