플러스프로젝트 배경
1) 문제점 카페24 공식 PCCC 앱은 주문서에 통관부호 입력 필드를 제공하지만, 관세청에 실제로 검증 요청을 보내지는 않습니다. 잘못된 번호, 이름 불일치, 전화번호 불일치, 우편번호 불일치 상태로 주문이 접수되고, 문제는 며칠 뒤 통관 단계에서 드러납니다. 2026년 2월 관세청 정책 강화로 우편번호 불일치 시 통관이 사실상 차단되면서 배송 지연 CS가 급증하는 상황이었습니다. 2) 프
프로젝트 성과
테스트 케이스 26개 전부 통과
정상/불일치/시스템오류/우편번호 오류 등 전 케이스를 pytest + respx 목(mock)으로 검증해 배포 안정성 확보
두 번째 클라이언트 적용 시간 1/3 수준으로 단축
첫 클라이언트 12~18시간 → 두 번째 클라이언트 4~7시간. CORS 도메인 추가 + selector 실측 + QA만으로 완료
통관 단계 CS 사전 차단 가능
주문 시점에 통관부호 오류를 잡아냄으로써 배송 지연 및 고객 불만 발생 전 개입 가능한 구조 완성
핵심 기능
유니패스 API 프록시 서버
세청 CORS 제한과 API 키 노출 문제를 해결하기 위해 FastAPI 중간 서버를 운영
브라우저는 이 서버에만 요청하고, 서버가 API 키를 환경변수로 관리하며 관세청과 통신
브라우저는 이 서버에만 요청하고, 서버가 API 키를 환경변수로 관리하며 관세청과 통신
진행 단계
분석 및 아키텍처 설계
2026.04.
유니패스 OpenAPI v3.9 스펙 분석
CORS 정책 및 XML 응답 구조 확인
FastAPI 프록시 + Cloudflare Tunnel 아키텍처 확정
카페24 주문서 DOM 구조 실측 및 공식 PCCC 앱
CORS 정책 및 XML 응답 구조 확인
FastAPI 프록시 + Cloudflare Tunnel 아키텍처 확정
카페24 주문서 DOM 구조 실측 및 공식 PCCC 앱
프로젝트 상세
1) 포트폴리오 소개 카페24 해외 구매대행 쇼핑몰에 관세청 유니패스 API를 연동해, 주문 시점에 개인통관고유부호(PCCC)를 실시간으로 검증하는 시스템을 단독으로 설계·구축했습니다. 카페24 해외 구매대행 쇼핑몰 운영자를 메인 타깃으로, 주문 확정 전에 통관부호·이름·전화번호·우편번호 불일치를 관세청과 직접 대조해 통관 실패를 사전 차단합니다. 두 번째 클라이언트 이후부터는 동일 프록시 서버를
