준비해야 할 값
- 우체국 고객번호와 계약승인번호
- 우체국 일련번호와 인터넷우체국 ID
- 소포신청 인증키와 보안키
- 종추적키와 기본 발송처 정보
WHATTA 실무 가이드
우체국 계약소포 택배 API 연동 방법
우체국 계약소포 API는 계약 식별값과 OpenAPI 인증값이 정확해야 접수, C형 라벨 출력, 배송조회가 안정적으로 이어집니다.
이 가이드에서 확인할 내용
가이드 목록
우체국 계약소포를 WHATTA에 연결할 때 필요한 값과 접수 전 점검 항목을 정리한 가이드입니다.
계약승인번호, 고객번호, 인증키, 보안키는 운영 계약 기준으로 확인해야 하며 저장 후 원문을 다시 노출하지 않는 것이 안전합니다.
계약소포 접수 흐름
- 마이페이지에 계약 식별값과 OpenAPI 인증정보를 저장합니다.
- 기본 발송처, 요금 납부구분, 중량, 크기, 포장값을 확인합니다.
- 배송 접수 후 우체국 접수 응답을 확인합니다.
- 접수 완료 건은 C형 라벨로 출력하고 배송조회로 상태를 확인합니다.
ResInfo와 StoppedZip 오류
- ResInfo 조회가 실패하면 계약정보 또는 DB 조회 환경을 먼저 확인합니다.
- StoppedZip 대상 우편번호는 접수 전 차단해야 합니다.
- 우편번호와 주소가 맞지 않으면 접수 또는 라벨 출력이 지연될 수 있습니다.
- DB 접속 문제와 API 응답 문제는 원인을 분리해서 봐야 합니다.
WHATTA에서 처리되는 범위
- 우체국 계약정보와 인증정보 저장
- 계약소포 접수 입력값 검증
- C형 라벨 출력 연결
- ResInfo, StoppedZip 기반 사전 확인
