# 상품 원가 및 마진 추가 및 추적

모든 상품 가격이나 옵션에 원가와 마진 정보를 추가하여 상품의 수익성을 추적해보세요. 외부 스프레드시트나 수동 계산 없이도 각 판매에서 얼마나 수익을 얻는지 시스템 내에서 바로 파악할 수 있습니다.

***

**목차**

* [원가 및 마진 추적이란?](#원가-및-마진-추적이란)
* [원가와 마진 추적의 주요 이점](#원가와-마진-추적의-주요-이점)
* [사전 준비사항](#사전-준비사항)
* [상품의 마진 추적을 활성화하는 방법](#상품의-마진-추적을-활성화하는-방법)
* [상품 옵션의 마진 추적을 활성화하는 방법](#상품-옵션의-마진-추적을-활성화하는-방법)
* [원가와 마진이 동기화되는 방식](#원가와-마진이-동기화되는-방식)
* [인보이스와 캘린더에서 원가가 표시되는 방식](#인보이스와-캘린더에서-원가가-표시되는-방식)
* [거래 내역 CSV: 항목별 원가](#거래-내역-csv-항목별-원가)
* [자주 묻는 질문](#자주-묻는-질문)

***

## 원가 및 마진 추적이란?

상품 원가(Cost Price)와 마진(Margin)은 Hyperclass의 모든 상품이나 옵션에 활성화할 수 있는 선택적 필드입니다. 활성화하면 상품(Products) 모듈 내에서 각 상품의 수익성을 체계적이고 정확하게 볼 수 있습니다. 원가가 정의되면 거래 내역 CSV 내보내기에서도 전용 "항목별 원가" 컬럼으로 표시되어 거래 수준에서 수익성 분석이 가능합니다.

다음 용어들을 알면 팀이 상품 원가와 마진을 추적할 때 일관성을 유지하는 데 도움이 됩니다:

* **원가(Cost Price):** 해당 상품을 제공하거나 조달하는 데 드는 비즈니스 비용 (항상 ≥ 0).
* **마진(금액, Margin Amount):** 판매가와 원가의 차이 (판매가 − 원가). 마진 금액은 양수 또는 음수일 수 있습니다.
* **마진(퍼센트, Margin Percentage):** 그 차이를 원가의 퍼센트로 표현 ((판매가 − 원가) ÷ 원가 × 100). 원가가 0이면 마진 퍼센트는 100%로 처리됩니다.

***

## 원가와 마진 추적의 주요 이점

* **플랫폼 내장 수익성 추적**: 플랫폼을 떠나지 않고도 상품별 마진을 한눈에 파악할 수 있습니다.
* **자동 계산**: 원가나 마진(금액 또는 퍼센트) 중 하나를 입력하면 나머지는 자동으로 계산됩니다.
* **유연성**: 일회성 및 정기 결제 상품, 다양한 가격과 옵션에서 모두 작동합니다.
* **일관된 원가**: 인보이스나 캘린더 가격이 수동으로 변경되더라도 원가는 정확하게 유지됩니다.
* **내보내기 준비된 데이터**: 거래 수준의 원가 데이터를 CSV로 내보내어 재무 및 정산 워크플로우에 활용할 수 있습니다.

***

## 사전 준비사항

* 계정에서 **결제(Payments)** → **상품(Products)** 접근 권한이 있어야 합니다.
* 최소 하나의 상품이 생성되어 있어야 합니다(신규 또는 기존).
* **권한**: 사용자는 원가와 마진을 설정하려면 상품 생성/편집 권한이 필요합니다.

***

## 상품의 마진 추적을 활성화하는 방법

원가와 마진은 가격 수준(일반 상품의 경우) 또는 옵션 수준(옵션이 있는 상품의 경우)에서 설정됩니다. 이 필드들은 상품을 생성하거나 편집할 때 가격 설정(Pricing) 섹션 내에 표시됩니다.

상품 원가와 마진을 추적하려면 아래 단계를 따르세요.

#### **1단계:** 상품으로 이동

왼쪽 메뉴에서 \*\*결제(Payments)\*\*를 클릭합니다. 그런 다음 상단 리본에서 \*\*상품(Products)\*\*을 클릭하여 상품 페이지를 엽니다.

![상품 메뉴 이동](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066312095/original/QRHvMabHtkIQiXCMf2qvcvf3g7bcNK6wVg.png?1772731792)

#### **2단계:** 상품 생성

**+ 상품 생성(Create Product)** 버튼을 클릭하여 새 상품을 만들거나, 기존 상품을 클릭하여 편집합니다.

![상품 생성 버튼](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066312144/original/YwAAhd9z1I3AN19DKvm9jsPlooLjeQNcpQ.png?1772731840)

#### **3단계:** 가격 설정 섹션으로 이동

상품 생성 또는 편집 화면에서 **가격 설정(Pricing)** 섹션으로 스크롤합니다. 기존 상품의 경우, 설정하고자 하는 가격 옆의 \*\*편집(Edit)\*\*을 클릭합니다.

![가격 설정 섹션](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066312257/original/HUa0lCxjraGY5RsbENG4sz3_w82pq58Zlg.png?1772731934)

#### 4단계: 마진 추가 체크박스 활성화

가격 설정 섹션에서 **마진 추가(Add Margin)** 체크박스를 선택합니다. 그러면 원가와 마진 필드가 표시됩니다. 이 체크박스는 기본적으로 선택되어 있지 않으며, 활성화해도 기존 거래에는 영향을 주지 않습니다.

![마진 추가 체크박스](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066312360/original/qDwDri7DUyGDEgektLq5l6l4mUj3s-3U3g.png?1772732014)

#### 5단계: 원가 또는 마진 입력

마진을 금액 또는 퍼센트 중 어떤 방식으로 표현할지 선택합니다. 그런 다음 둘 중 하나의 값을 입력하면 판매가를 기준으로 나머지가 자동 계산됩니다:

* **원가(Cost Price):** 이 상품을 제공하기 위해 비즈니스에 드는 비용. 음수가 될 수 없습니다.
* **마진(Margin):** 원가를 초과하는 이익. 필드 옆의 토글을 사용하여 금액과 퍼센트 모드를 전환할 수 있습니다.

**참고:** '마진 추가'를 체크했지만 두 필드를 모두 비워두면, 시스템은 원가를 판매가와 동일하게 처리하고 마진을 0으로 유지하여 내보냅니다.

![원가와 마진 입력](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066313691/original/K1o1pI6PZ0Kv4JyvoPwh95HyG7-gd22N-Q.png?1772733275)

#### **6단계:** 상품 저장

\*\*저장(Save)\*\*을 클릭합니다. 이제 원가와 마진이 이 상품의 가격 수준에 저장되며 향후 내보내기에 반영됩니다.

![상품 저장](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066313766/original/IgeMZQSK3Ka6YR0XPItA8aPzO7gTlaTtCg.png?1772733326)

***

## 상품 옵션의 마진 추적을 활성화하는 방법

옵션이 있는 상품의 경우 원가와 마진은 옵션 수준에서 설정됩니다. 상품 옵션의 원가와 마진을 추적하려면 아래 단계를 따르세요.

**팁:** 마진 추적을 활성화하기 전에 먼저 상품의 옵션을 생성해야 합니다.

#### **1단계:** 옵션으로 이동

상품 편집 화면에서 **옵션(Variants)** 섹션으로 이동합니다.

![옵션 섹션](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066314293/original/tLy01Y204evYH0FxhS8g31c4GIl3wAueqQ.png?1772733722)

#### **2단계:** 옵션 편집

설정하고자 하는 옵션에서 \*\*편집(Edit)\*\*을 클릭합니다.

![옵션 편집](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066315987/original/XAIdNrWs-8KnDojbwRlNkYynQBTFgdN6jg.png?1772735346)

#### 3단계: 마진 추가 체크박스 활성화

옵션의 가격 설정 섹션에서 **마진 추가(Add Margin)** 체크박스를 선택합니다.

![옵션 마진 추가 체크박스](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066316031/original/Llb4283rATlPQbS0THVZRIu7HBAbEa0LuQ.png?1772735388)

#### 4단계: 원가 또는 마진 입력

마진을 금액 또는 퍼센트 중 어떤 방식으로 표현할지 선택합니다. 그런 다음 둘 중 하나의 값을 입력하면 판매가를 기준으로 나머지가 자동 계산됩니다:

* **원가(Cost Price):** 이 상품을 제공하기 위해 비즈니스에 드는 비용. 음수가 될 수 없습니다.
* **마진(Margin):** 원가를 초과하는 이익. 필드 옆의 토글을 사용하여 금액과 퍼센트 모드를 전환할 수 있습니다.

![옵션 원가와 마진 입력](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066316062/original/gzftWcMpqc3VwcDMvHcU_Py1z58P24nRcw.png?1772735441)

#### 5단계: 저장하고 반복

저장한 후 각 옵션에 대해 반복합니다.

**팁:** 각 가격대와 각 옵션 조합은 독립적인 원가와 마진을 가집니다. 즉, 가격대별(예: $25 옵션 vs $100 옵션) 또는 옵션별(예: 소형 vs 대형)로 다른 마진을 추적할 수 있습니다.

![옵션별 개별 설정](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066316115/original/KFq7oXlGWk7uo1WfpoQV-DQxHrVT3ms7Xg.png?1772735490)

***

## 원가와 마진이 동기화되는 방식

두 필드는 판매가를 기준으로 자동으로 동기화됩니다. 모드를 전환하거나 판매가를 변경하면 종속 필드가 즉시 재계산됩니다.

### **금액 모드**

* **마진** = 판매가 − 원가
* **원가** = 판매가 − 마진
* 원가는 0 이상이어야 함 (>= 0)
* 마진은 양수 또는 음수 가능

### **퍼센트 모드**

* **마진 %** = ((판매가 − 원가) ÷ 원가) × 100

**팁:** 마진 %는 100%를 초과할 수 없습니다. 이는 100%를 초과할 수 있는 마크업과 다릅니다. 마진은 원가로 나누어지므로 상한선 100%와 하한선 -100%로 제한됩니다.

### **판매가 변경 시**

상품의 판매가를 업데이트하면 시스템은 기존 원가를 기준으로 마진을 자동 재계산합니다. 마찬가지로 금액과 퍼센트 모드 간 전환 시에도 데이터 손실 없이 필드를 재계산합니다.

***

## 인보이스와 캘린더에서 원가가 표시되는 방식

인보이스(Invoices)와 캘린더(Calendars)에서는 항목별로 판매가를 수동으로 변경할 수 있습니다. 이런 경우 원가 동작은 다음과 같습니다:

* **원가는 항상 원본 상품 가격에서 가져옵니다**. 현재는 변경된 판매가를 기준으로 재계산되지 않습니다.
* 마진은 인보이스나 캘린더 수준에서 재계산되지 않습니다.
* 정기 결제 상품의 설정 수수료는 마진 로직에서 제외됩니다.
* 구독 상품의 경우 설정 수수료가 아닌 정기 결제 금액만 마진 계산에 사용됩니다.

***

## 거래 내역 CSV: 항목별 원가

거래 내역 CSV 내보내기에 새로운 "항목별 원가(Line Item Cost Price)" 컬럼이 추가되었습니다. 이를 통해 거래 및 항목 수준에서 수익성을 분석할 수 있습니다.

### **내보내기 접근 방법**

* **결제(Payments)** → \*\*거래 내역(Transactions)\*\*으로 이동합니다.
* \*\*CSV 내보내기(Export CSV)\*\*를 클릭합니다.
* 원가가 정의된 모든 상품에 대해 **항목별 원가(Line Item Cost Price)** 컬럼이 자동으로 표시됩니다.

![CSV 내보내기](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066214875/original/Y0KxlOGHp7_JMeTBru-vfwd8pwQJd4f-sw.png?1772645261)

### **컬럼 동작**

* 상품에 원가가 정의된 경우 → 원가 금액이 표시됩니다.
* 원가가 정의되지 않은 경우 → 컬럼이 비어있습니다.
* 인보이스나 캘린더에서 가격이 변경된 경우 → 원본 상품의 원가가 사용됩니다.
* 일회성 결제, 구독 결제, 부분 결제에 모두 적용됩니다.
* 부분 결제: 비례 배분된 금액이 아닌 전체 상품 원가가 표시됩니다.

**중요:** 원가 데이터는 소급 적용되지 않습니다. 상품에 원가를 설정한 후 생성된 거래만 이 컬럼이 채워집니다.

***

## 자주 묻는 질문

**Q: 기존 상품에 원가를 추가할 수 있나요?**

네. 기존 상품을 열어 가격이나 옵션을 편집하고 마진 추가 체크박스를 선택하면 됩니다. 이는 과거 거래에 영향을 주지 않으며 향후 거래만 원가 데이터를 포함합니다.

**Q: 마진 추가를 체크했지만 필드를 비워두면 어떻게 되나요?**

마진 추가 체크박스는 선택했지만 값을 입력하지 않으면, 시스템은 원가를 판매가와 동일하게 처리합니다. 이 값은 CSV 내보내기에 전달됩니다.

**Q: 고객에게 원가가 표시되나요?**

아니요. 원가는 내부 필드이며 결제 시, 영수증, 인보이스에서 고객에게 표시되지 않습니다.

**Q: 옵션별로 다른 원가를 설정할 수 있나요?**

네. 각 옵션 조합은 독립적인 원가와 마진 필드를 가지므로 옵션별로 다른 수익성을 추적할 수 있습니다.

**Q: 상품의 판매가를 변경하면 원가가 자동으로 업데이트되나요?**

아니요. 판매가가 변경되면 기존 원가를 기준으로 마진이 재계산되며, 원가 자체는 변경되지 않습니다. 이를 통해 입력한 값을 그대로 유지하면서 마진은 정확하게 유지됩니다.

**Q: 여러 상품의 원가를 일괄 편집할 수 있나요?**

이번 릴리즈에서는 불가능합니다. 일괄 원가 편집은 일괄 편집 기능의 일부로 향후 단계에서 계획되어 있습니다.

**Q: 정기 결제 상품의 설정 수수료가 마진 계산에 포함되나요?**

아니요. 설정 수수료는 마진 로직에서 제외됩니다. 구독 상품의 원가와 마진 계산 시에는 정기 결제 금액만 사용됩니다.

**Q: 상품에 원가를 추가할 때 과거 거래가 업데이트되나요?**

아니요. 원가 데이터는 소급 적용되지 않습니다. 상품에 원가를 설정한 후 생성된 거래만 내보내기에서 항목별 원가를 포함합니다.

***

*원문 최종 수정: Thu, 5 Mar, 2026 at 12:46 PM* *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/add-and-track-product-cost-price-margin.md?ask=<question>
```

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.
