▶ 팝빌 현금영수증 커넥트 서비스 개요
현금영수증 커넥트는 팝빌을 통해 발급한 현금영수증의 발행 / 국세청 전송 신고 / 국세청전송 결과 정보를 실시간 연결하여 자동으로 확인할 수 있는 웹훅 수신(Webhook Incoming) 기술을 적용한 서비스 입니다. 현금영수증 상태를 별도의 API 함수를 호출하지 않아도 지정한 콜백 URL을 통해 변경실시간으로 현금영수증 상태변경 이벤트 메시지를 수신할 수 있습니다.
▶ 실시간으로 제공하는 커넥트 이벤트 목록
1) 현금영수증 발행 / 발행취소 알림
2) 국세청 전송시작 알림
3) 국세청 전송결과(전송성공 또는 전송실패) 알림
▶ 현금영수증 커넥트 설정 방법
1) [팝빌 사이트 로그인] > [현금영수증] 메뉴 선택 > 왼쪽 메뉴탭 하단의 [환경설정 - 커넥트 관리] 메뉴 선택
2) 커넥트 유형 'Rest' 선택
3) 콜백 URL 입력 후 저장
※ 해당 동영상은 테스트베드인 팝빌 개발용(https://test.popbill.com) 사이트를 기반으로 제작되었음을 알려드립니다.
▶ 현금영수증 커넥트 적용 예시
아래의 영상은 Request Body를 콘솔에 출력하는 예제입니다. 이벤트 메시지 Body는 Json 형식으로 구성되며, 상태코드(stateCode) 항목을 통해 현금영수증 상태를 확인할 수 있습니다. 영상은 현금영수증 발행 / 발행취소 발생하는 이벤트 메시지에 대한 예시 영상입니다.
※ 해당 동영상은 테스트베드인 팝빌 개발용(https://test.popbill.com) 사이트를 기반으로 제작되었음을 알려드립니다.
▶ 현금영수증 커넥트 이벤트 메시지 구성
1) 이벤트 메시지 Header 구성
2) 이벤트 메시지 Body 구성
▶ 커넥트 응답 메시지 구성
이벤트 메시지 수신에 대한 응답을 성공으로 처리하기 위해서는 응답 메시지 Body를 아래와 같이 두가지 타입중 한가지를 반환하도록 처리하면 됩니다.
▶ 커넥트 이벤트 메시지 재실행
콜백 URL을 설정한 서버 네트워크 오류로 메시지 정상적으로 처리하지 못한 경우 발생했던 메시지 이벤트를 재실행할 수 있습니다.
1) [팝빌 사이트 로그인] > [현금영수증] 메뉴 선택 > 왼쪽 메뉴 하단의 [환경설정 - 커넥트 관리] 메뉴 선택 > [실행내역] 탭 선택
2) 재실행 할 메시지 확인 후 재실행
지금까지 팝빌 현금영수증 커넥트 서비스에 대한 소개와 적용방법을 안내해드렸습니다. 귀사의 시스템에 현금영수증 서비스 도입을 고민하고 계시다면 현금영수증 발행에서부터 국세청 신고 후 결과까지 쉽고 빠르게 연동할 수 있는 팝빌의 현금영수증 API 서비스를 경험해 보시기 바랍니다.
고객사의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락주시기 바랍니다.
기술지원센터 / T. 1600-9854 / E. code@linkhub.co.kr
