굿스플로 (Goodsflow) 연동

⚠️ 현재 미제공 (예정): 굿스플로 연동은 아직 하나로 화면에서 쓸 수 없어요. 아래 내용은 열리게 되면 어떻게 쓰게 될지 미리 적어 둔 것이고, 지금은 사용할 수 없어요.

한 줄 요약 — 지금은 쓸 수 없어요. 굿스플로 가입과 키 입력 화면은 아직 열려 있지 않아요. 굿스플로 없이도 [택배 자동접수]와 마켓 동기화로 송장번호를 채우는 평소 흐름은 그대로 돼요.

한눈에 보기 (활성화되면)

  1. 굿스플로 가입택배사와 화주 계약이 먼저 필요해요
  2. API key 발급굿스플로 마이페이지에서 받아요
  3. 하나로에 입력연결 확인을 해요 (화면은 준비 중)
  4. 송장 발행 → 마켓 전송한 번에 처리하도록 설계됐어요

이 흐름을 보여 줄 화면 그림은 아직 없어요. 해당 화면이 아직 열려 있지 않아 찍을 수 없어요.

자세히 보기 — 가입 절차 · 키 입력 · 동작 흐름 · 자주 묻는 질문 · 확정되지 않은 부분 (모두 예정)

하나로의 송장 직접 발행 기능은 굿스플로(Goodsflow)를 쓰도록 준비 중이에요. 열리게 되면 굿스플로에 가입해 키를 받고, 하나로에 입력한 뒤, 송장 발행과 마켓 등록을 한 번에 처리하게 돼요.

주문(F2) → 송장 발행 실행 → 굿스플로 송장 발행 → 마켓 송장번호 전송 → 발송 마킹

1. 굿스플로 가입 절차

⚠ 굿스플로 가입은 택배사와의 화주 계약이 먼저 필요해요. 가입 신청 때 “배송사 계약코드”를 입력해야 하므로, 쓰려는 택배사(예: 로젠)와 먼저 계약해야 해요.

순서 단계 비고
1 goodsflow.io 접속 영업 가입 신청
2 사업자등록증 + 통장 사본 제출 셀러 본인 명의
3 배송사 계약코드 입력 로젠/CJ/한진/롯데/우체국/일양 — 택배사와 사전 계약 필요
4 우체국 가입 승인 (사용 시) 우체국만 별도 승인 절차
5 굿스플로 마이페이지 → API key 발급 하나로에 입력할 키예요
6 (선택) Seller ID 확인 일부 기능에서 필요할 수 있어요

굿스플로 요금제와 정확한 사양은 영업 가입 뒤 가입자 페이지에 공개돼요. 가격과 사양은 영업 미팅에서 확인해야 해요.


2. 하나로에 키 입력 (예정)

키를 입력하는 설정 화면은 아직 열려 있지 않아요. 열리면 키를 넣고 연결 확인을 하고, 확인이 통과해야 [저장]이 켜지도록 만들 예정이에요.

결과 표시
성공 “연결 성공” 표시
실패 “API key 확인 / 권한 부족 / 네트워크 오류” 중 하나로 표시

3. 동작 흐름 (예정)

  1. 주문을 골라 송장 발행을 실행해요.
  2. 굿스플로에서 송장번호를 발행받아 주문에 채워요.
  3. 그 송장번호를 마켓(스마트스토어·쿠팡·카페24)에 등록해요.

발행이 실패한 주문은 마켓에 보내지 않고, 이유를 화면에 알려 줘요.


4. 자주 묻는 질문

Q. 굿스플로 가입 안 하면 어떻게 되나요?

A. 지금과 똑같이 쓰면 돼요. 하나로가 송장을 직접 발행하지 않고, [택배 자동접수]와 마켓 동기화로 송장번호를 채우는 평소 흐름이 그대로 동작해요.

Q. 굿스플로 말고 다른 발행 방법은요?

A. 앞으로 다음 방법을 추가할 계획이에요(모두 예정).

  • 로젠과 직접 전산 연동 계약 — 이 방식에는 한계가 있어요.
  • 내 시스템과 직접 연결 — 자체 시스템이 있는 셀러용이에요.

Q. 비용은 누가 내나요?

A. 굿스플로 호출은 무료가 아니고, 송장당 수수료가 생길 수 있어요(가격은 비공개 — 영업 미팅에서 확정). 하나로는 이 수수료를 대신 내지 않고, 셀러가 굿스플로에 직접 결제해요.

Q. 발행에 실패하면 자동으로 다시 시도하나요?

A. 일시적인 네트워크 오류는 자동으로 3번까지 다시 시도해요. 택배사가 지원하지 않거나 키가 잘못된 경우처럼 사람이 고쳐야 하는 오류는 바로 알려 드려요.

Q. 발행한 송장을 취소할 수 있나요?

A. 가능해요. 다만 굿스플로 정책상 일정 시간이 지나거나 택배사에 넘어간 뒤에는 취소가 안 될 수 있어요.


5. 아직 확정되지 않은 부분

굿스플로의 정확한 사양은 영업 가입 뒤에야 확인할 수 있어서, 지금 정리한 흐름은 추정을 바탕으로 해요. 실제 사양이 다르면 열리기 전에 맞춰 고칠 거예요. 그래서 이 문서의 내용은 달라질 수 있어요.


참고 링크