# 롯데온 마켓 계정 연동

> 💡 이 문서를 마치면 롯데ON 스토어센터에서 Spresso 서버 IP를 등록해 OpenAPI Key를 발급받고, 롯데ON 판매자 계정을 Spresso에 연결할 수 있습니다. (⏱️ 약 15분)
>
> 📍 메뉴 위치: 롯데ON 스토어센터 **판매자정보 > OpenAPI관리** → Spresso **마켓 관리 > 마켓 계정 관리**\
> ✅ 미리 준비: 롯데ON 판매자 가입이 끝난 상태, Spresso 계정 팝업의 [내 IP](glossary.md)

## 이게 뭔가요?

Spresso가 롯데온에 상품을 올리려면 [롯데ON 스토어센터](glossary.md)(롯데온 판매자센터)에서 발급한 **OpenAPI Key**(인증키) 하나가 필요합니다. 롯데ON은 미리 등록한 IP에서 오는 요청만 받으므로, 스토어센터에 Spresso 전용 서버 IP도 등록해야 합니다. 순서는 셋입니다.

1. 스토어센터에 출고지·회수지(반품지)와 [배송비 정책](glossary.md)을 등록합니다. Spresso 마켓 정책에서 이것을 고르므로 먼저 해 둡니다.
2. 스토어센터에서 허용 IP를 넣고 OpenAPI Key를 발급받습니다.
3. Spresso에 키를 넣고 테스트한 뒤 저장합니다.

> 💡 롯데온은 아직 상품 등록·품절·삭제만 됩니다. 주문·문의는 가져오지 않습니다(아래 "롯데온에서 지금 되는 것").

## 🚚 롯데ON 출고지·회수지·배송비 정책 등록하기

Spresso 롯데온 마켓 정책에서는 배송비를 금액으로 넣지 않습니다. 스토어센터에 등록한 배송비 정책과 출고지·회수지를 목록에서 고릅니다([마켓 정책](policy-market.md)).

1. **[롯데ON 스토어센터](https://store.lotteon.com/)**에 접속해 로그인합니다.
2. 판매 방식([해외 구매대행·위탁 판매·사입 판매](glossary.md))에 맞는 출고지와 회수지(반품지)를 등록합니다. 회수지는 실제 상품을 받을 수 있는 국내 사무실 주소로 넣습니다.
3. 배송비 정책을 등록합니다.

## 🔑 롯데ON OpenAPI Key 발급받기

1. **[롯데ON 스토어센터](https://store.lotteon.com/)**에 접속해 로그인합니다.
   - Spresso 입력 칸 옆 **발급가이드**를 선택하면 [롯데ON API 센터](https://api.lotteon.com/)가 열립니다. API 센터 위쪽 **API KEY 발급** 메뉴로도 스토어센터에 들어갈 수 있습니다.
2. **판매자정보 > OpenAPI관리**로 이동합니다.

3. **[키 발급]**을 선택하고 허용 IP에 Spresso 전용 서버 IP를 넣습니다.
   - IP는 Spresso 사이드바 맨 위 계정 영역을 선택하면 열리는 계정 팝업의 **내 IP** 옆 복사 아이콘으로 복사합니다([화면 둘러보기](app-basics.md)).
   - IP에 공백이 섞이거나 형식이 틀리면 롯데ON에서 "ip 정보가 잘못되었습니다" 알림이 나옵니다. 복사한 IP를 그대로 붙여 넣습니다.

4. 발급된 OpenAPI Key를 복사해 메모합니다.

> 💡 OpenAPI Key는 발급일부터 1년 동안 쓸 수 있고 판매자(롯데ON 거래처)마다 최대 3개까지 발급됩니다. 만료가 다가오면 롯데ON이 메일이나 문자로 알려 줍니다. 상품을 등록하기 전이면 같은 메뉴에서 새 키를 발급받아 [계정 수정](market-account.md)에서 넣고 다시 테스트합니다.

> ⚠️ 이 계정으로 롯데온에 상품을 등록한 뒤에는 Spresso에서 롯데온 API Key를 새로 넣고 저장해도 바뀌지 않습니다("변경사항을 저장하였습니다."가 나와도 예전 키가 남습니다). 키를 바꿔야 하면 [고객센터](support.md) 1:1 문의로 알립니다.

## Spresso에 롯데온 마켓 계정 추가하기

1. [Spresso](https://console.spresso.kr/)에 로그인한 뒤 **마켓 관리 > 마켓 계정 관리**로 이동합니다.
2. **롯데온** 탭을 선택하고 **[마켓 계정 추가]**를 선택합니다.
   - 롯데온 탭은 가입할 때 국내 판매를 고른 계정에 나옵니다. 탭이 없으면 [결제 관리](payment.md)에서 마켓 범위를 확인합니다.

![마켓 계정 관리의 롯데온 탭](../img/connect-lotteon-05.png)

3. **마켓 계정 추가** 칸에 아래 항목을 입력합니다.

   | 칸 | 넣을 값 |
   | --- | --- |
   | 아이디 | 롯데ON 아이디 |
   | 롯데온 API Key | 스토어센터에서 복사한 OpenAPI Key |

4. **[API Key 테스트]**를 선택합니다.
   - 안 되면: 아래 "자주 보는 메시지"를 봅니다.
5. "테스트 성공"이 나오면 (선택) 옵션을 정합니다.
   - 최대 등록 상품 개수: 이 계정에 등록할 최대 상품 수. 비워 두면 목록에 "제한 없음"으로 나옵니다.
   - 자주 사용하는 택배사: **주문 조회**에서 송장 택배사를 고를 때 여기서 고른 택배사만 나옵니다. 다만 롯데온 주문은 아직 가져오지 않습니다.
6. **[변경사항 저장]**을 선택합니다.

![롯데온 마켓 계정 추가 칸](../img/connect-lotteon-06.png)

## 결과 확인

"변경사항을 저장하였습니다."가 나오고 롯데온 탭 계정 목록에 아이디가 생기고 연동 상태가 "연결"(초록)이면 끝입니다.

## 자주 보는 메시지

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 롯데ON 이 접근을 거부했습니다. 스토어센터 [판매자정보 > OpenAPI관리]의 허용 IP 에 에스프레소 서버 IP 가 등록돼 있는지 확인해주세요. | 롯데ON이 Spresso 서버 IP를 모릅니다. 스토어센터 허용 IP에 **내 IP**를 공백 없이 넣었는지 확인한 뒤 다시 테스트합니다. |
| 등록되지 않은 롯데ON OpenAPI Key 입니다. 키를 확인해주세요. | 키가 롯데ON에 없습니다. 키를 빠짐없이 복사했는지 확인하고 스토어센터에서 키와 유효기간을 본 뒤 필요하면 새로 발급받습니다. |
| API Key를 입력해주세요 | 롯데온 API Key 칸이 비어 있습니다. 키를 넣고 테스트합니다. |
| 테스트 실패 + 그 밖의 사유 | 롯데ON이 알려 준 사유입니다. 키와 허용 IP를 확인한 뒤 다시 테스트합니다. |

중복 계정·계정 한도처럼 모든 마켓에 같은 문구는 [마켓 계정 관리](market-account.md)에 있습니다. 그래도 안 되면 [고객센터](support.md) 1:1 문의에 마켓 이름(롯데온), 연동 아이디, 화면에 나온 문구 그대로, 테스트한 시각을 적어 보냅니다. API Key는 적지 않습니다.

## 롯데온에서 지금 되는 것

롯데온 연결은 상품 등록부터 차례로 붙여 가는 중입니다. 지금은 아래와 같습니다.

- **상품 등록**: 됩니다.
- **품절**: Spresso에서 품절 처리하면 롯데온에서도 품절이 됩니다.
- **삭제**: 롯데온에는 상품 삭제 기능이 없어 Spresso에서 삭제하면 롯데온에서는 판매종료로 바뀝니다.
- **등록한 상품 수정**: 고친 내용을 아직 롯데온으로 보낼 수 없습니다.
- **주문·문의**: 아직 가져오지 않습니다. 송장 보내기와 문의 답변도 아직 롯데온으로 보내지 않습니다.

> 💡 연결한 롯데온 계정을 지우려면 이 계정으로 등록한 상품을 모두 삭제하고 이 계정을 쓰는 마켓 정책 연결도 풀어야 합니다. 그다음 **[계정 삭제]**를 선택합니다([마켓 계정 관리](market-account.md)).

## 다음 단계

- 다른 마켓도 연결한다면 [마켓 계정 연동하기](start-market.md)
- **STEP 4** [기본 정책 만들기](start-policy.md)

## 관련 문서

- [마켓 계정 관리](market-account.md) — 테스트 결과·계정 수정·삭제
- [마켓 정책](policy-market.md) — 롯데온 배송비 정책·출고지·회수지 고르기