# 주문을 CSV로 내보내기 또는 다운로드 이 가이드는 주문 기록을 보고서 작성, 정산, 재무 분석, 주문 처리, 제품 성과 추적을 위해 CSV 파일로 내보내는 방법을 설명합니다. ## 개요 주문 CSV 내보내기 기능을 사용하면 `Payments(결제) → Orders(주문)` 대시보드에서 상세한 주문 기록을 다운로드할 수 있습니다. 다음과 같이 내보낼 수 있습니다: * 전체 주문, 또는 * 필터/검색 조건에 맞는 주문만 내보낸 파일은 보안 다운로드 링크로 이메일을 통해 전송됩니다. 목차 * [주문 내보내기 방법](#주문-내보내기-방법) * [CSV 형식 이해하기](#csv-형식-이해하기) * [컬럼 참조 가이드(예시 포함)](#컬럼-참조-가이드예시-포함) * [다중 행 주문 작동 방식(중요)](#다중-행-주문-작동-방식중요) * [자주 묻는 질문](#자주-묻는-질문) ## 주문 내보내기 방법 * `Payments(결제) → Orders(주문)`으로 이동 * (선택사항) 다음과 같은 필터 적용: * 주문 상태 * 날짜 범위 * 소스 유형(Funnel, Payment Link, Store Checkout 등) * 상품 유형(일회성 vs 정기결제) * `Download(다운로드)` 클릭 * 다운로드 링크가 포함된 이메일 확인 보안 알림: 내보내기 링크는 7일 후 만료됩니다. 만료된 경우 새로운 내보내기를 시작하세요. ## CSV 형식 이해하기 주문에는 다음이 여러 개 포함될 수 있습니다: * 상품 * 세금 따라서 하나의 주문이 파일에서 여러 행에 걸쳐 나타날 수 있습니다. 이는 장부 작성과 분석에 필요한 상품 수준의 가격과 세금 명확성을 표시하는 데 도움이 됩니다. ## **데이터 일관성 보장(내보내기 업그레이드)** 주문 내보내기는 상품, 세금, 결제 필드에서 신뢰할 수 있는 정산과 보고를 위해 형식이 지정됩니다. 0 vs 빈 값 * 0은 필드가 적용되고 값이 실제로 0일 때만 나타납니다. * 빈 값은 필드가 적용되지 않을 때만 나타납니다(예: 미결제 주문의 결제 방법). 보고를 위한 안정적인 구조 * 컬럼 순서는 피벗, 가져오기, BI 파이프라인을 지원하기 위해 일관됩니다. * 상품과 세금 항목이 있을 때 다중 행 주문이 예상됩니다. 총계를 그룹화할 때 **Internal order id**를 사용하세요. ## 컬럼 참조 가이드(예시 포함) | 컬럼명 | 설명 | 예시 | | ------------------------------------- | --------------------------- | ----------------------------------- | | Internal order id | 하이퍼클래스 내부 주문 식별자 | 69369a9968f735180bfeb6ed | | Location id | 하위 계정 식별자 | NyGCsdhgRZ8Ffa8Ssagfhd | | Customer id | 주문한 고객의 ID | jbtyjkzMjvd8cLi9HUC | | Customer name | 고객 표시명 | Jordan Lane | | Customer email | 결제 시 수집된 이메일 | | | Customer phone | 결제 시 수집된 전화번호 | +44 7700 900111 | | Payment method | 결제 시 수집된 방법; 미결제 주문인 경우 빈 값 | Credit Card, Cash, Instant Transfer | | Currency | 상품 가격 통화 | USD | | Sub total | 할인 및 별도 세금 전 항목 총 가치 | 120.00 | | Discount | 주문에 적용된 할인 | -20.00 | | Total tax amount (excluded in prices) | 소계에 추가되는 세금 | 8.40 | | Total tax amount (included in prices) | 이미 항목 가격에 포함된 세금 | 0.00 | | Total amount | 할인 + 세금 + 기타 요금 후 총 결제 금액 | 108.40 | | Coupon code | 결제 시 사용된 코드(있는 경우) | SPRING20 | | Status | 주문의 결제 상태 | Completed, Pending | | Live mode | 테스트 vs 실제 환경 확인 | Yes, No | | Total products | 주문의 총 상품 수 | 3 | | One-time products | 주문의 일회성 상품 수 | 2 | | Recurring products | 주문의 구독 상품 수 | 1 | | Source type | 주문이 생성된 진입점 | Store Checkout, Form, Funnel | | Source id | 소스의 내부 ID | afalfgn4ag12neogh | | Source name | 소스의 표시명 | Gift Card Store | | Order date | 주문 완료 날짜 | Dec 10, 2025 | | Order time | 주문 완료 시간 | 10:45 AM | | Timezone | 주문 기록의 시간대 | America/Chicago | | Line item name | 상품명 | Premium Coaching Plan | | Line item quantity | 이 상품의 구매 수량 | 1 | | Line item price | 상품의 단위당 가격 | 100.00 | | Line item discount | 이 라인에 할당된 할인 | 20.00 | | Line item subtotal | 상품 라인의 소계 | 80.00 | | Line item product id | 상품의 시스템 식별자 | prod\_52ZS | | Line item price id | 가격 또는 변형의 식별자 | price\_00382 | | Tax name | 적용된 세금 유형 | Sales Tax | | Tax amount | 이 라인의 세금 금액 | 5.60 | | Address line 1 | 배송/청구 주소(수집된 경우) | 123 Main St | | City | 도시 | Austin | | State | 주/지역 | TX | | Country | 국가 | US | | Postal code | 우편번호 | 73301 | | Processing charge name | 기타 요금명 | Handling Fee | | Processing charge amount | 기타 요금 금액 | 2.80 | ## 다중 행 주문 작동 방식(중요) **예시 1:** 다음을 포함하는 단일 주문: * 상품 3개 * 세금 2개 - 둘 다 별도 세금 CSV는 총 **6행**을 생성할 수 있습니다: * 각 상품에 대해 2행 * 세금에 대해 6행, 여기서 각 상품의 각 세금명에 대한 세금 금액이 새로운 행 → 모두 동일한 주문 ID를 공유 **예시 2:** 다음을 포함하는 단일 주문: * 상품 3개 * 세금 2개 - 상품 1에는 둘 다 별도 세금, 상품 2에는 둘 다 포함 세금, 상품 3에는 세금 없음 CSV는 총 **5행**을 생성할 수 있습니다: * 2개 상품에 대해 2행, 3번째 상품에 대해 1행 * 세금에 대해 4행, 즉 처음 2개 세금은 <세금명 1>과 <세금명 2> 형식이고 다음 2개 세금은 <세금명 1 (가격에 포함)>과 <세금명 2 (가격에 포함)> 형식; 5번째 행은 세금 컬럼에 값이 없음 → 모두 동일한 주문 ID를 공유 ## 자주 묻는 질문 ### 1. 같은 주문에 대해 여러 행이 보이는 이유는 무엇인가요? 각 상품과 상품 세금은 정확한 보고를 위해 별도의 회계 라인이 필요하기 때문입니다. ### 2. 일부 주문에서 결제 방법이 비어있는 이유는 무엇인가요? 주문은 거래가 발생한 경우에만 결제 방법을 표시합니다. ### 3. 미결제 또는 포기된 주문도 포함되나요? 네 — 필터링하지 않는 한 포함됩니다. ### 4. 이 내보내기에서 구독 청구 세부 정보를 확인할 수 있나요? 이 내보내기는 주문 수준의 구독 존재(수량)만 보여주며, 구독 청구 기록은 보여주지 않습니다. 이에 대해서는 구독 CSV 내보내기를 사용하세요. ### 5. 과거 주문을 다시 내보낼 수 있나요? 네 — 내보내기는 항상 새롭게 생성됩니다. ### 6. 누가 주문 내보내기를 다운로드할 수 있나요? 다음 권한을 가진 사용자: ✔ 주문 보기 ✔ 주문 내보내기 *** *원문 최종 수정: 2026-02-03* *Hyperclass 사용 가이드 — hyperclass.ai* --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://hyperclass.gitbook.io/hyperclass-docs/payments/using-apple-pay-and-google-pay-in-order-forms/export-or-download-orders-as-csv.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.