계약 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 파일에 추가해야 하며, 별도로 명시하지 않는 한 모든 필드가 필수입니다.
| 칼럼 | 설명 |
|---|---|
| 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 파일로 기존 계약을 편집하거나 덮어쓸 수는 없습니다. 기존의 중복 계약은 가져오기 중에 무시됩니다.
타사 가입 앱에서 계약 가져오기
타사 가입 앱에서 계약을 가져올 수 있습니다. 타사 앱에서 가져오는 경우 다음 동작을 고려하세요.
- 타사 가입 앱이 Shopify Checkout과 통합되지 않은 경우 계약을 가져올 수 없습니다.
- 타사 앱에서는 데이터를 직접 가져올 수 없습니다. 타사 앱의 계약 데이터를 Shopify Subscriptions 앱과 호환되는 CSV에 가져오기 위한 올바른 형식으로 추가해야 합니다.
- 타사 가입 앱에 내보내기 기능이 없거나 내보낸 데이터에 모든 필수 데이터가 포함되어 있지 않은 경우 앱 개발자에게 문의하여 지원을 요청하세요.
단계:
- Shopify 관리자에서 가입 > 계약으로 이동합니다.
- 가져오기를 클릭합니다.
- 파일 추가를 클릭한 다음, 가져올 CSV 파일을 선택합니다.
- 파일 업로드를 클릭합니다.
CSV 파일을 업로드하면 Shopify 스토어를 설정하는 데 사용한 이메일 계정으로 확인 이메일을 받을 수 있습니다. 일반적인 가져오기 오류의 해결 방법을 확인해 보십시오.
CSV 파일을 사용하여 계약 내보내기
기록을 위해 또는 Shopify Subscriptions 앱이 설치된 다른 Shopify 스토어로 가져오기 위해 계약을 내보낼 수 있습니다.
단계:
- Shopify 관리자에서 가입 > 계약으로 이동합니다.
- 내보내기를 클릭합니다.