우편 발송 API 접수 테스트

API 접수 테스트 전, 발송 IP와 API_Key를 확인합니다.

API 접수테스트
API 키    접수테스트
발송정보  
첨부파일  
결과  
코드샘플 : Java JavaScript C# PHP    우편 API 연동 규격서

Json 생성

발송 형태에 따른 발송정보 json을 생성합니다

Json 생성 (*는 필수값)
m
a
s
t
e
r		 *버전    - 고정값
*테스트여부    - API접수테스트는 '테스트여부' 값이 'Y' 만 가능합니다. 실제 발송시 'N'으로 변경
*서비스    - PST:우편, SMS:문자, KKO:카카오알림톡
*연계식별키    - 사용자가 지정하는 unique 값. 중복 불가, 최대 40byte
*봉투    - 소봉투/대봉투는 A4(210*297) 기준
*봉투창    - 소봉투(이중창/무창), 대봉투(단창/무창), 접착식(공백), 엽서(공백)
*흑백칼라    
*단면양면    - 접착식 경우 페이지수가 2매인 경우는 양면인쇄
*배달    
템플릿코드    - 협의 후 포스토피아에서 템플릿 설정, 발급
템플릿출력여부    - 템플릿코드 존재시 'Y'
수취인수    - 미입력시 주소록개수 참조. 입력시 주소록개수 일치시 발송
여백생성유무    - 'Y'는 첨부파일 내용문을 자동으로 축소. 소봉투는 봉입바코드 추가위해 왼쪽 여백 필요
주소페이지유무    - 주소페이지 포함시 'Y', 주소페이지 생성 필요시 'N'
맞춤자제유무    
메일머지유무    - 'Y'인 경우 템플릿코드 필수
동봉물유무    
동봉물페이지수    - 동봉물 존재시 동봉물의 페이지수 기재
반송여부    - 반송불필요: 'N', 반송필요: 'Y' (반송요금 별도 협의후 이용)
스테이플러유무    - 협의 후 사용 가능
로고파일    - 협의 후 사용 가능
*발송인명    
*발송인우편번호    
*발송인주소    
*발송인상세주소    
발송인전화번호    - 준등기/등기/익일특급/선택등기/배달증명 발송시 필요
d
e
t
a
i
l		 *순번    - '1' 부터 시작
*이름    - 수취인명
*우편번호    - 수취인 우편번호
*주소    - 수취인 주소
상세주소    - 주소에 포함된 경우 상세주소는 공백
전화번호    - 수취인 전화번호. 준등기/등기/익일특급/선택등기/배달증명 발송시 필요
첨부파일    - 첨부파일 이름
Json 생성

API접수 결과코드

결과코드 결과메시지 비고
OK  SUCCESS  연동 성공
E_11000  ERROR [전체 서비스 사용중지]  해당 기업의 서비스 사용 중지
E_11030  ERROR [우편 서비스 사용중지]  해당 기업의 우편서비스 사용 중지
E_11050  ERROR ["IP주소" 허용된 IP 아님]  접속IP가 등록된 IP 아님
E_11051  ERROR [pstFile에 json(master/detail) 파일이 존재하지 않습니다]  연계정보 파일 누락
E_11053  ERROR [pstFile의 json(master/detail) 파일 읽기를 실패했습니다. 지원 되지 않는 json 파일입니다]  연계정보 파일 json 파싱 오류
E_11060  apiKey ERROR  apiKey 인증 실패
E_11060  ERROR [apiKey 미존재]  apiKey 누락
E_11100  master ERROR [master 항목 누락]  연계정보 'master' 항목 누락
E_11105  master ERROR [상세설명]  연계정보 'master' 항목 오류, 상세설명 참조
E_11110  detail ERROR [detail 항목 누락]  연계정보 'detail' 항목 누락
E_11115  detail ERROR [상세설명]  연계정보 'detail' 항목 오류, 상세설명 참조
E_11120  master cols ERROR [master cols 누락]  연계정보 'master cols' 항목 누락
E_11125  master cols ERROR [상세설명]  연계정보 'master cols' 항목 오류, 상세설명 참조
E_11130  master rows ERROR [master rows 누락]  연계정보 'master rows' 항목 누락
E_11135  master rows ERROR [상세설명]  연계정보 'master rows' 항목 오류, 상세설명 참조
E_11140  detail cols ERROR [detail cols 누락]  연계정보 'detail cols' 항목 누락
E_11145  detail cols ERROR [상세설명]  연계정보 'detail cols' 항목 오류, 상세설명 참조
E_11150  detail rows ERROR [detail rows 누락]  연계정보 'detail rows' 항목 누락
E_11155  detail rows ERROR [상세설명]  연계정보 'detail rows' 항목 오류, 상세설명 참조
E_12000  수신정보(detail)에 버전이 없습니다. 수신정보(detail) 레이아웃을 확인해 주세요.  연계정보 '버전' 항목 누락
E_12000  발송정보(master)에 버전이 없습니다. 발송정보(master) 레이아웃을 확인해 주세요.  연계정보 '버전' 항목 누락
E_12005  ERROR [서비스(PST/SMS/KKO) 항목이 없습니다]  연계정보 '서비스' 항목 누락
E_12015  ERROR [연계식별키 항목이 없습니다]  연계정보 '연계식별키' 항목 누락
E_12029  ERROR ["첨부파일명" 첨부파일이 없습니다]  연계정보 '첨부파일' 항목 누락
E_12040  master ERROR [템플릿코드("템플릿코드명")에 해당하는 템플릿이 없습니다]  연계정보 '템플릿코드' 항목 오류
E_12055  수신정보(detail) 순번은 필수 항목입니다.  연계정보 '순번' 항목 누락
E_12060  수신정보(detail) 순번("순번")이 맞지 않습니다.  연계정보 '순번' 항목 오류
E_12061  수신정보(detail) ("행번호")행의 column 갯수와 row 개수가 맞지 않습니다.  연계정보 'detail rows' 항목 오류
E_12070  ERROR 연계식별키 미존재 1  해당 연계식별키로 조회시 일치건수 0
E_12115  수신정보(detail) 이름은 필수 항목입니다.  연계정보 '수신정보(detail) 이름' 항목 누락
E_12120  수신정보(detail) 우편번호는 필수 항목입니다.  연계정보 '수신정보(detail) 우편번호' 항목 누락
E_12125  수신정보(detail) 주소는 필수 항목입니다.  연계정보 '수신정보(detail) 주소' 항목 누락
E_12130  수신정보(detail) "라인번호"라인의 column 갯수와 row 갯수가 다릅니다.  연계정보 'detail rows' 항목 오류
E_12130  수신정보(detail) 항목 갯수는 "항목갯수"개 이상 이어야 됩니다.  수신정보 오류
E_12135  수신정보(detail) 항목 갯수는 "항목 갯수"개 이상 이어야 됩니다.  수신정보 오류
E_13000  ERROR [수취인수("수취인수")와 수신정보(detail)의 rows개수("rows개수")가 다릅니다.]  연계정보 '수취인수' 항목 오류
E_13005  ERROR [발송 등록된 건입니다. 연계식별키:"연계식별키"]  연계정보 '연계식별키' 항목 중복
E_14000  ERROR 예치금 잔액 부족 : 잔액["예치금 잔액"]원  예치금으로 결제시 잔액 부족
E_14100  master ERROR [봉투창 코드 "봉투창코드"는 존재하지 않는 코드입니다]  연계정보 '봉투창' 항목 오류
E_14100  master ERROR [봉투코드 "봉투코드"는 존재하지 않는 코드입니다]  연계정보 '봉투' 항목 오류
E_14100  master ERROR [흑백칼라코드 "흑백칼라코드"는 존재하지 않는 코드입니다]  연계정보 '흑백칼라' 항목 오류
E_14100  master ERROR [단면양면코드 "단면양면코드"는 존재하지 않는 코드입니다]  연계정보 '단면양면' 항목 오류
E_14100  master ERROR [배달코드 "배달코드"는 존재하지 않는 코드입니다]  연계정보 '배달' 항목 오류
E_14103  master ERROR [템플릿을 사용하지 않는 "봉투코드"은/는 주소페이지가 첨부파일에 포함되어야 됩니다.]  연계정보 '주소페이지' 항목 오류
E_14105  master ERROR [템플릿코드가 필요 합니다.]  연계정보 '템플릿코드' 항목 누락
E_14110  ERROR [봉투 항목이 없습니다]  연계정보 '봉투' 항목 누락
E_14112  ERROR [봉투창 항목이 없습니다]  연계정보 '봉투창' 항목 누락
E_14112  ERROR [배달 항목이 없습니다]  연계정보 '배달' 항목 누락
E_14114  ERROR [흑백칼라 항목이 없습니다]  연계정보 '흑백칼라' 항목 누락
E_14116  ERROR [단면양면 항목이 없습니다]  연계정보 '단면양면' 항목 누락
E_14130  ERROR [pstFile에 첨부파일이 존재하지 않습니다.]  연계정보 '첨부파일' 항목 누락
E_14131  ERROR ["파일명" 파일을 읽을수 없습니다.]  연계정보 파일 식별 오류
E_14212  ERROR [발송인명 항목이 없습니다]  연계정보 '발송인명' 항목 누락
E_14214  ERROR [발송인우편번호 항목이 없습니다]  연계정보 '발송인우편번호' 항목 누락
E_14216  ERROR [발송인주소 항목이 없습니다]  연계정보 '발송인주소' 항목 누락
E_14310  master ERROR [템플릿의 메일머지(GMC,PPP) 종류가 잘못 설정되었습니다]  템플릿 설정 오류
E_14311  첨부파일이 존재하지 않습니다.]  첨부파일 누락
E_14412  소봉투는 최대 6매(주소페이지1매+내용문5매)까지 발송할수 있습니다.  소봉투 내용문 매수 오류
E_14414  대봉투는 최대 100매(주소페이지1매+내용문99매)까지 발송할수 있습니다.  대봉투 내용문 매수 오류
E_14416  출력한 페이지가 너무 많습니다. 엽서는 앞면+뒷면 출력만 가능합니다.  엽서 내용문 매수 오류
E_14418  출력한 페이지가 너무 많습니다. 접착식은 양면 1장만 출력만 가능합니다.  접착식 내용문 매수 오류