> For the complete documentation index, see [llms.txt](https://www.analytics-docs.laplacetec.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/columns/cogs.md).

# 기초 상품 (원가) 컬럼

마진율·공헌이익·POAS는 판매 금액만으로 계산할 수 없고 **상품별 원가**가 있어야 산출됩니다. 이 페이지는 그 원가 데이터를 올리는 방법을 안내합니다. **스프레드시트 업로드와 API 직접 전송 모두 가능합니다.** 항목 구성은 앞의 여섯 카테고리와 다릅니다.

{% hint style="info" %}
**원가를 올리는 방법은 세 가지입니다.** 화면의 \*\*\[데이터 관리] → \[마진율] → \[기초 상품 관리]\*\*에서 템플릿 파일을 업로드하거나, [스프레드시트 연결](/guide/startguide/connect/spreadsheet/cogs.md)을 쓰거나, 이 페이지의 항목에 맞춰 **API로 직접 보낼** 수 있습니다.
{% endhint %}

## 행을 구분하는 기준 (식별 키)

`브랜드` + `기초 상품번호` + `기초 상품명` + `적용 시작 일자`

**네 개가 모두 키입니다.** 원가는 시점마다 값이 달라지므로 날짜까지 키에 들어갑니다. 앞의 세 항목이 같아도 `적용 시작 일자`가 다르면 **다른 행으로 남아 원가 이력이 됩니다.** 네 항목이 모두 같은 값을 API로 다시 보내시면 나중에 보낸 값이 그 시점의 원가가 됩니다.

{% hint style="info" %}
이 "나중에 보낸 값이 이긴다"는 **같은 입력 경로 안에서만** 적용됩니다. 같은 키를 API와 스프레드시트처럼 서로 다른 경로로 넣으시면 보낸 순서와 무관하게 [경로별 우선순위](/guide/datamanage/matching.md#priority)가 최종값을 정합니다.
{% endhint %}

{% hint style="warning" %}
`브랜드`와 `기초 상품번호`가 같은데 `기초 상품명`만 다르게 보내시면 **다른 상품으로 갈라집니다.** 상품명을 바꾸실 때는 기존 이력의 상품명도 함께 맞춰 주세요.
{% endhint %}

## 항목 목록 (5개)

다섯 개 모두 필수입니다.

| 화면 표기    | 타입 | 무엇을 넣나요                                                                                            |
| -------- | -- | -------------------------------------------------------------------------------------------------- |
| 기초 상품번호  | 문자 | 원가를 매기는 단위의 코드입니다. 주문 데이터의 `자체 상품 코드` 또는 `상품번호`와 같은 값을 써 주세요                                       |
| 기초 상품명   | 문자 | 위 코드에 해당하는 상품 이름                                                                                   |
| 브랜드      | 문자 | 주문 데이터의 `브랜드`와 같은 값을 써 주세요                                                                         |
| 원가       | 정수 | 상품 **1개** 원가입니다. 수량을 곱하기 전 단가입니다                                                                   |
| 적용 시작 일자 | 일시 | 해당 원가가 적용되기 시작하는 시점입니다. 원가가 바뀌면 새 시점으로 행을 추가해 주세요. API로 직접 보낼 때의 컬럼명은 `apply_start_datetime_id`입니다 |

{% hint style="warning" %}
**`기초 상품번호`가 주문 데이터 상품 코드와 연결되지 않으면 해당 상품의 원가가 비어 마진·공헌이익·POAS가 계산되지 않습니다.** 원가를 올리기 전에 두 곳의 코드 체계가 같은지 먼저 확인해 주세요.
{% endhint %}