> 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).

# 주문 컬럼

언제 무엇이 얼마에 팔렸는지를 담는 데이터입니다. 대시보드 매출 지표 대부분이 여기에서 계산됩니다. **스프레드시트 업로드와 API 직접 전송 모두 가능합니다.**

{% hint style="info" %}
**API로 직접 보낼 때** `주문번호`와 `상품 주문번호`를 식별 키로 사용합니다. 스프레드시트에서는 두 항목을 비워도 연결은 저장되지만, 주문 단위 지표를 보시려면 채워 주시는 것이 좋습니다.
{% endhint %}

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

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

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

| 보내는 방식      | 반드시 채워야 하는 항목                                     |
| ----------- | ------------------------------------------------- |
| 스프레드시트로 올리기 | 5개: `결제 날짜/시간` · `판매처` · `브랜드` · `판매 채널` · `결제금액` |
| API로 직접 보내기 | 7개: 위 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" %}
**위 표의 `필수` 와 `상수 입력` 은 API로 직접 보낼 때 기준입니다.** 스프레드시트로 올리실 때는 두 열이 다릅니다.

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

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