> 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/order.md).

# 주문 컬럼

라플라스 대시보드 매출 지표의 기준이 되는 주문 데이터의 컬럼 매핑 안내입니다. 주문번호 식별 키, 금액·할인·부가세 기준, 취소·환불 처리와 42개 항목을 정리했습니다.

언제 무엇이 얼마에 팔렸는지를 담는 데이터입니다. 대시보드 매출 지표 대부분이 여기에서 계산됩니다.

{% hint style="info" %}
`주문번호`와 `상품 주문번호`는 비워도 연결은 저장되지만, 주문 단위 지표를 보시려면 채워 주시는 것이 좋습니다.
{% endhint %}

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

`주문번호` + `상품 주문번호`

한 주문에 상품이 여러 개면 **상품 주문번호 기준으로 행이 나뉩니다.** 한 주문에서 특정 상품만 취소된 경우를 담으려면 이 단위가 필요합니다.

| 보내는 방식      | 반드시 채워야 하는 항목                                     |
| ----------- | ------------------------------------------------- |
| 스프레드시트로 올리기 | 5개: `결제 날짜/시간` · `판매처` · `브랜드` · `판매 채널` · `결제금액` |

## 금액 컬럼의 기준

각 금액 항목에 어떤 값을 넣어야 하는지는 아래 계산식을 기준으로 합니다.

```
결제금액      = (상품 가격 + 옵션 가격) x 수량 - 쿠폰 - 할인 + 배송비
실 결제금액    = 결제금액 - 적립금 - 예치금
상품 구매 금액  = (상품 가격 + 옵션 가격) x 수량
순매출        = 결제금액 - 환불/취소 금액
```

아래 항목들은 금액 계산에 사용하는 입력값입니다.

| 화면 표기    | 무엇을 넣나요                                                    |
| -------- | ---------------------------------------------------------- |
| 상품 가격    | 상품 **1개** 가격. 수량을 곱하기 전 단가입니다                              |
| 옵션 가격    | 옵션으로 붙는 **1개당** 추가 금액. 이것도 단가입니다                           |
| 상품 가격 할인 | 상품 **1개**에 깎아 준 할인액. 할인 후 금액이 아니라 **깎아 준 금액**이고, 이것도 단가입니다 |
| 결제금액     | 위 산식으로 계산이 끝난 **최종 결제 금액**. 단가가 아니라 합계입니다                  |
| 수량       | 주문 수량                                                      |
| 쿠폰       | 쿠폰 할인액                                                     |
| 할인       | 쿠폰 외 판매처 할인액. 주문 전체 금액만 있다면 **상품 주문 행별로 배분한 금액**을 넣어 주세요   |
| 배송비      | 고객이 부담한 배송비                                                |
| 적립금      | 사용한 적립금                                                    |
| 예치금      | 사용한 예치금                                                    |

{% hint style="warning" %}
**1개당 가격과 합계를 섞지 마세요.** `상품 가격` · `옵션 가격` · `상품 가격 할인` 세 항목은 모두 **1개당 금액**입니다. `결제금액`은 최종 합계이고, 주문 단위 `할인`은 상품 주문 행별로 나누어 입력해야 합니다.

`상품 가격` 칸에 이미 수량이 곱해진 값을 넣으시면 `상품 구매 금액` 지표가 수량만큼 부풀려집니다. 수량이 3이면 3배로 나옵니다.

`할인`의 주문 전체 금액을 같은 주문의 여러 행에 그대로 반복해서 넣지 마세요. 주문 전체 할인액만 있다면 상품 주문 행별로 배분한 뒤 입력해야 주문 단위 합계가 중복되지 않습니다.

`상품 가격 할인`이 포함된 주문 전체 할인액을 원본에서 제공한다면, 그 금액도 상품 주문 행별로 배분해 `할인`에 반영합니다. `상품 가격 할인`은 상품별 개당 기준이고 `할인`은 주문 전체 할인액을 행별로 나눈 값입니다. 같은 원본 금액을 모든 행에 반복하거나 별도의 추가 할인으로 중복 입력하지 마세요.

`상품 가격 할인`은 더 조심해 주세요. 한 상품 주문 행에 여러 기초상품이 매칭되면 라플라스가 이 할인액을 **각 기초상품 몫으로 나누어** 상품별 판매금액과 마진을 계산합니다. 그래서 여기에 합계를 넣으시면 해당 행의 상품별 지표뿐 아니라 **그 행에 매칭된 다른 기초상품의 지표까지 함께 틀립니다.**
{% endhint %}

### 상품 가격 할인에는 무엇을 넣나요

**깎아 준 금액**을 넣습니다. 할인이 적용된 뒤의 판매가가 아닙니다.

1개 22,900원짜리 상품을 3,000원 할인해 19,900원에 파셨다면 `3000`을 넣습니다. `19900`이 아닙니다.

```
상품 거래액(GMV)  = (상품 가격 + 옵션 가격) x 수량
상품 판매금액      = 상품 거래액 - (상품 가격 할인 x 수량)
```

### 부가세는 어떻게 하나요

주문 금액 항목은 부가세를 분리하지 않습니다. **고객이 실제 결제한 금액을 부가세 포함 그대로** 보내 주세요.

마진율·공헌이익률에 `결제금액(VAT 제외)`이 따로 있는 것도 같은 이유입니다. `결제금액`이 부가세를 포함한 값이라고 보고, 거기서 부가세를 빼서 계산합니다.

광고 쪽 `광고비 (VAT 포함)`도 마찬가지로 부가세가 포함된 기준입니다.

## 화면에는 있는데 항목 목록에 없는 항목

{% hint style="info" %}
스프레드시트 연결 화면에는 아래 항목 목록에 없는 **`상품 거래액(GMV)`** 이 보입니다.

매핑하면 해당 값이 상품별 주문 금액으로 그대로 사용되고, 비워 두면 `(상품 가격 + 옵션 가격) x 수량` 으로 라플라스가 계산합니다. **자사몰에서 계산한 값이 더 정확하다면 매핑해 주세요.**
{% endhint %}

## 지역별 분석은 어떻게 하나요

시·도, 시·군·구를 직접 담는 항목은 없습니다. `기본주소` · `상세주소` · `전체주소` 는 있지만 지역 분석에는 쓰이지 않습니다. 라플라스는 주소 문장을 쪼개서 지역을 만들지 않습니다. 대신 **국내 매핑 테이블과 일치하는 `우편번호`를 보내 주시면 지역 분석이 됩니다.** 라플라스가 매칭되는 우편번호를 기준으로 광역시·도 · 시·군·구 · 읍·면·동 을 자동으로 채웁니다.

그래서 지역별 매출을 보실 계획이라면 `우편번호`를 매핑해 주세요. 주소만 채우고 우편번호를 비워 두시면 지역값이 채워지지 않습니다. 국내 매핑 테이블에 없는 값일 때도 마찬가지로 지도 차트에서 지역을 확인할 수 없습니다.

{% hint style="info" %}
`우편번호` 와 `기본주소` · `상세주소` · `전체주소` 는 라플라스에서 개인정보로 분류되어 차트의 기준(차원)이나 필터로 직접 노출되지 않습니다. 지역은 위의 지역 단위로만 조회하실 수 있습니다.
{% endhint %}

## 주소 항목은 어디에 쓰나요

차트에 직접 뜨지 않는데도 매핑할 이유가 하나 있습니다. `전체주소`는 **같은 고객을 알아보는 데** 쓰입니다. 연락처나 이름이 조금씩 다르게 들어온 주문이라도 주소가 같으면 한 사람으로 묶여, 재구매·고객 단위 지표가 더 정확해집니다.

`전체주소`를 따로 주지 않으셔도 `기본주소` 와 `상세주소` 를 채워 주시면 라플라스가 둘을 이어 붙여 사용합니다. 판매처가 주소를 한 칸으로만 준다면 `전체주소` 에 연결해 주세요.

## 취소·환불·교환은 어떻게 보내나요

취소·환불·반품·교환은 **별도 상태 컬럼이 아니라 완료 날짜를 채워서** 표현합니다. 값이 비어 있으면 아직 발생하지 않은 것으로 봅니다.

| 상황       | 보내는 방법                                      |
| -------- | ------------------------------------------- |
| 주문 전체 취소 | `취소 완료 날짜/시간`을 채워 해당 주문의 행을 같은 식별 키로 다시 보내기 |
| 주문 부분 취소 | 취소된 **상품 주문번호에 해당하는 행만** 위와 같이 다시 보내기       |
| 환불       | `환불 날짜/시간`을 채우기                             |
| 반품       | `반품 완료 날짜/시간`을 채우기                          |
| 교환       | `교환 완료 날짜/시간`을 채우기                          |

어느 경우에도 **행을 지우지 마세요.** 행을 보내지 않아도 이미 저장된 데이터는 그대로 남습니다.

## 항목 목록 (42개)

| 화면 표기       | 타입 | 필수        | 상수 입력 |
| ----------- | -- | --------- | ----- |
| 결제 날짜/시간    | 일시 | 필수        | 가능    |
| 판매처         | 문자 | 필수        | 가능    |
| 브랜드         | 문자 | 필수        | 가능    |
| 판매 채널       | 문자 | 필수        | 가능    |
| 결제금액        | 숫자 | 필수        | 가능    |
| 상품명         | 문자 | -         | 가능    |
| 상품번호        | 문자 | -         | 가능    |
| 주문번호        | 문자 | 필수 (식별 키) | 불가    |
| 상품 주문번호     | 문자 | 필수 (식별 키) | 불가    |
| 적립금         | 숫자 | -         | 가능    |
| 예치금         | 숫자 | -         | 가능    |
| 상품 가격       | 숫자 | -         | 가능    |
| 옵션 가격       | 숫자 | -         | 가능    |
| 옵션코드        | 문자 | -         | 가능    |
| 옵션정보        | 문자 | -         | 가능    |
| 수량          | 정수 | -         | 가능    |
| 상품 거래액(GMV) | 숫자 | -         | 가능    |
| 회원 ID       | 문자 | -         | 가능    |
| 주문자 전화번호    | 문자 | -         | 가능    |
| 주문자 이메일 주소  | 문자 | -         | 가능    |
| 주문자 이름      | 문자 | -         | 가능    |
| 우편번호        | 문자 | -         | 가능    |
| 기본주소        | 문자 | -         | 가능    |
| 상세주소        | 문자 | -         | 가능    |
| 전체주소        | 문자 | -         | 가능    |
| 상품 가격 할인    | 숫자 | -         | 가능    |
| 쿠폰          | 숫자 | -         | 가능    |
| 배송 그룹 번호    | 문자 | -         | 가능    |
| 수신자 전화번호    | 문자 | -         | 가능    |
| 수신자 이름      | 문자 | -         | 가능    |
| 배송비         | 숫자 | -         | 가능    |
| 할인          | 숫자 | -         | 가능    |
| 수수료         | 숫자 | -         | 가능    |
| 자체 상품 코드    | 문자 | -         | 가능    |
| 환불 날짜/시간    | 일시 | -         | 가능    |
| 구매 확정 날짜/시간 | 일시 | -         | 가능    |
| 취소 완료 날짜/시간 | 일시 | -         | 가능    |
| 교환 완료 날짜/시간 | 일시 | -         | 가능    |
| 반품 완료 날짜/시간 | 일시 | -         | 가능    |
| 배송 완료 날짜/시간 | 일시 | -         | 가능    |
| 배송 시작 날짜/시간 | 일시 | -         | 가능    |
| 주문 날짜/시간    | 일시 | -         | 가능    |

{% hint style="warning" %}
**스프레드시트로 올리실 때는 위 표의 `필수` 와 `상수 입력` 이 아래처럼 적용됩니다.**

* **필수**: 스프레드시트는 `결제 날짜/시간` · `판매처` · `브랜드` · `판매 채널` · `결제금액` 5개만 필수입니다. `주문번호` 와 `상품 주문번호` 는 필수가 아닙니다.
* **상수 입력**: 스프레드시트에서 상수로 채울 수 있는 항목은 `판매처` · `브랜드` · `판매 채널` 세 가지뿐입니다. 나머지는 시트의 열을 지정해야 합니다.
  {% endhint %}

{% hint style="info" %}
필수가 아닌 항목도 가능한 한 많이 채워 주는 것이 좋습니다. 값이 비어 있으면 해당 항목을 사용하는 차트가 표시되지 않습니다. 어떤 지표에 무엇이 필요한지는 [항목을 비우면 어떤 지표가 안 나오나요](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/columns.md#blank-fields)에 정리해 두었습니다.
{% endhint %}
