Logistics Integration API

기업의 물류 업무를 연결하는
Homepick3.0 API

배송 가능 여부 확인부터 요금 조회, 주문 접수, 배송 상태 추적, 송장 출력까지. 운영 중인 쇼핑몰·ERP·WMS에 한 번 연결하면 택배·오늘픽업·오늘도착·퀵·화물 배송을 시스템 안에서 그대로 처리할 수 있습니다.

About

배송사마다 다른 방식을
하나의 규격으로

상품을 보내는 기업은 배송사마다 다른 접수 방식, 서로 다른 요금 기준, 제각각인 상태값을 매번 따로 맞춰야 합니다. Homepick3.0 API는 이 과정을 하나의 규격으로 통일해, 고객사 시스템이 “어디로 보낼 수 있고, 얼마이며, 지금 어디까지 왔는지”를 API 호출만으로 확인하고 처리할 수 있게 합니다.

  • 적합한 기업
    자사몰·ERP·OMS·WMS에서 배송 접수를 처리해야 하는 기업, 여러 판매 채널의 주문을 한 곳에서 출고하는 사업자, 고객에게 배송 현황을 직접 보여줘야 하는 서비스
  • 연결되는 것
    고객사의 주문 데이터가 홈픽으로 전달되어 배송이 접수되고, 이후의 픽업·이동·배송완료 상태가 다시 고객사 시스템으로 조회됩니다. 송장 출력 데이터도 API로 받습니다.
  • 도입 효과
    배송사 사이트를 오가며 하던 수작업 접수와 상태 확인이 사라집니다. 주문 정보를 다시 입력하며 생기던 오류가 줄고, 배송 문의 응대에 필요한 정보를 담당자가 사내 화면에서 바로 확인합니다.
Features

주요 기능

Homepick3.0 API가 제공하는 기능을 실제 업무 흐름 순서대로 정리했습니다.

기준정보(코드) 조회

배송유형, 박스타입, 배송사, 주문상태, 취소유형 등 연동에 필요한 코드 목록을 API로 내려받습니다.

활용 시나리오
관리자 화면의 배송유형·박스 선택 항목을 API 응답으로 채워 항상 최신 상태로 유지
도입 효과
코드값을 하드코딩하지 않아 정책이 바뀌어도 수정 배포가 필요 없습니다.

배송 가능 여부 확인

출발지·도착지 우편번호로 이용 가능한 배송 종류와 픽업 가능 일시를 미리 확인합니다. 오늘도착 가능 지역 여부도 판단할 수 있습니다.

활용 시나리오
주문서에서 구매 고객에게 선택 가능한 배송 옵션만 노출하고, 불가 지역은 사전에 안내
도입 효과
접수 후 취소로 이어지던 배송 불가 주문을 주문 단계에서 걸러냅니다.

요금 조회

배송 유형과 박스 규격, 출·도착지 기준의 요금을 조회합니다. 도선료가 포함된 총 요금과 퀵서비스 요금도 제공합니다.

활용 시나리오
주문 확정 전 배송비를 자동 산출해 결제 금액에 반영하거나, 사내 물류비를 사전 집계
도입 효과
배송비를 수기로 계산하며 생기던 차액과 정산 분쟁을 줄입니다.

주문 접수

일반 배송, 퀵서비스, 오늘도착 주문을 각각의 접수 API로 등록하고, 접수 결과로 운송장 번호를 바로 받습니다.

활용 시나리오
쇼핑몰·ERP에서 출고 확정 시점에 배송 접수를 자동 호출
도입 효과
하루 수십·수백 건의 반복 접수 업무와 주소 재입력 오류가 사라집니다.

주문 취소

운송장 번호 또는 주문번호를 기준으로 접수된 주문을 취소합니다. 취소 사유는 코드 조회 API의 취소유형을 사용합니다.

활용 시나리오
고객 주문 취소나 출고 보류가 생겼을 때 고객사 시스템에서 즉시 접수 취소
도입 효과
취소 요청을 별도 채널로 전달하는 과정 없이 처리해 불필요한 픽업을 막습니다.

배송 상태 조회

운송장 번호, 배송사 운송장 번호, 제휴사 주문번호, 주문번호로 상태를 조회합니다. 접수일·픽업요청일 기준 기간 조회도 지원합니다.

활용 시나리오
자체 배송 조회 화면을 구성하거나, 기간 조회로 당일 출고 건을 일괄 점검
도입 효과
배송 문의가 들어왔을 때 담당자가 사내 화면에서 바로 답변할 수 있습니다.

송장 출력

송장 출력 페이지 URL(ID)을 받아 바로 띄우거나, 출력에 필요한 데이터를 받아 고객사 양식에 맞춰 직접 출력합니다.

활용 시나리오
출고 작업 화면에서 접수된 건의 송장을 모아 한 번에 출력
도입 효과
출력 때문에 별도 프로그램을 띄우거나 파일을 옮길 필요가 없습니다.

API Key 인증

발급받은 API 키를 Authorization 헤더에 담아 호출합니다. 필요 시 호출 IP를 등록해 지정된 환경에서만 사용하도록 제한할 수 있습니다.

활용 시나리오
운영 서버의 고정 IP를 등록해 외부에서의 무단 호출을 차단
도입 효과
복잡한 인증 구현 없이 헤더 한 줄로 연동을 시작합니다.

연동 문서 제공

연동이 승인된 고객사에는 요청·응답 규격이 정리된 API 문서를 제공합니다. 문서에서 실제 호출을 테스트하며 개발할 수 있습니다.

활용 시나리오
개발 담당자가 문서에서 직접 호출해 보며 연동 코드를 작성하고 응답 형식을 확인
도입 효과
문의와 회신을 주고받는 시간 없이 개발 기간을 단축합니다.
Coverage

연동 한 번으로 이용하는 배송 서비스

보내는 물건과 상황에 맞는 배송 유형을 같은 API 규격으로 선택할 수 있습니다.

일반택배전국 택배 배송
편의점택배편의점 접수 기반 배송
오늘픽업당일 방문 픽업
퀵서비스지정 시간 단건 이동
화물대형·중량 화물 운송
오늘도착 (픽업)당일 픽업 구간
오늘도착 (배송)당일 배송 구간
오늘도착 (픽업&배송)당일 픽업 + 배송

연동 배송사

우체국소포
한진택배
CJ대한통운
롯데택배
로젠택배
CU 편의점택배
홈픽 오늘도착
퀵서비스
화물

※ 실제 이용 가능한 배송 유형과 배송사는 고객사 계약 조건 및 지역에 따라 달라지며, 배송 가능 여부 조회 API로 확인할 수 있습니다.

How to start

API 연동 방법

홈픽 사이트에서 직접 신청하고, 승인 후 API 키를 발급받아 바로 개발을 시작할 수 있습니다.

연동 신청

홈픽 로그인 후 API 연동 신청 페이지에서 월 예상 물량과 사용할 서비스를 입력합니다.

신청 검토

담당자가 신청 내용을 검토합니다. 결과는 메일과 문자로 안내드립니다.

승인

승인되면 홈픽 사이트의 API 연동 메뉴에서 키와 문서를 확인할 수 있습니다.

API 키 발급

필요한 만큼 키를 직접 발급합니다. 키 이름과 허용 IP를 지정하고 언제든 수정·폐기할 수 있습니다.

개발 및 테스트

함께 제공되는 개발 서버 키와 개발 API 문서로 연동을 개발하고 검증합니다.

운영 적용

검증이 끝나면 운영 키로 전환해 운영 환경에 적용합니다.

인증 방식 — 모든 API 호출 시 발급받은 API 키를 Authorization 헤더에 포함합니다. 호출 IP 등록, 테스트 환경 이용 조건 등 세부 사항은 연동 협의 단계에서 안내해 드립니다.
FAQ

자주 묻는 질문

API 연동은 어떻게 신청하나요?
홈픽 사이트에 로그인한 뒤 API 연동 신청 페이지에서 월 예상 물량과 사용할 서비스(택배 / 퀵·화물)를 입력해 직접 신청할 수 있습니다. 신청 내용 검토 결과는 메일과 문자로 안내드리며, 반려된 경우 사유를 확인하고 다시 신청할 수 있습니다. 신청 전 문의는 영업1팀(tm.sales01@pimz.co.kr)으로 보내주세요.
API 키는 어떻게 발급받고, 어떻게 사용하나요?
연동이 승인되면 홈픽 사이트의 API 연동 메뉴에서 키를 직접 발급합니다. 키마다 이름과 허용 IP를 지정할 수 있고, 필요할 때 수정하거나 폐기할 수 있습니다. 발급된 키는 모든 API 호출의 Authorization 헤더에 포함해 사용하며, 키가 없거나 유효하지 않으면 호출이 거부됩니다.
상세 API 명세 문서는 어디서 볼 수 있나요?
요청·응답 규격이 포함된 상세 API 문서는 연동이 승인된 고객사에만 제공됩니다. 승인 후 홈픽 사이트의 API 연동 메뉴에서 운영 API 문서와 개발 API 문서 링크를 확인할 수 있고, API 문서에서 발급받은 API 키로 바로 열람할 수도 있습니다. 이 페이지에서는 제공 기능과 연동 절차만 안내하며, 엔드포인트와 파라미터 등 상세 명세는 공개하지 않습니다.
배송 상태가 바뀌면 알림을 받을 수 있나요?
현재 Homepick3.0 API는 고객사가 상태 조회 API를 호출해 배송 상태를 확인하는 방식으로 제공됩니다. 운송장 번호 단건 조회와 접수일·픽업요청일 기준 기간 조회를 함께 지원하므로, 주기적으로 조회해 사내 시스템에 반영하는 방식으로 구성합니다. 별도의 연동 방식이 필요한 경우 협의 단계에서 문의해 주세요.
개발과 테스트는 어떻게 진행하나요?
연동이 승인되면 운영 키와 함께 개발 서버 키가 제공됩니다. 개발 API 문서를 기준으로 개발 서버에서 연동을 개발·검증한 뒤, 운영 키로 전환해 운영 환경에 적용하면 됩니다.
이용 요금은 어떻게 책정되나요?
배송 요금은 배송 유형, 박스 규격, 출·도착지 조건에 따라 달라지며 고객사 계약 조건이 함께 적용됩니다. 연동 후에는 요금 조회 API로 실제 적용 요금을 확인할 수 있습니다. 계약 조건은 영업팀과 협의해 주세요.
요금 결제와 계약 조건은 어떻게 되나요?
Homepick3.0 API는 신용 회원사를 대상으로 제공되는 서비스입니다. 택배 요금과 API 서비스 이용료는 매달 초 세금계산서를 발행해 드리며, 지정된 계좌로 약정일 내에 입금해 주시면 됩니다. 이를 위해 계약 시 보증보험증권 발급이 필요합니다.
연동 중 기술적인 문제가 생기면 어디로 문의하나요?
개발·연동 관련 기술 문의는 개발팀(tm.tms@pimz.co.kr), 제휴 및 계약 관련 문의는 영업1팀(tm.sales01@pimz.co.kr)에서 담당합니다.
Contact

Homepick3.0 API 연동 시작하기

홈픽 사이트에서 바로 연동을 신청하세요. 승인 후 API 키를 직접 발급받아 개발을 시작할 수 있습니다.

API 연동 신청하기
제휴 · 연동 문의 tm.sales01@pimz.co.kr
개발 · 기술 문의 tm.tms@pimz.co.kr