POPBill Developers
가이드

발행

발신자가 전자명세서를 작성하여 발행하고 수신자에게 이메일로 발송하는 프로세스로 "임시저장"과 "발행" 단계로 구분됩니다.

  • 즉시 발행(권장) – 프로그램 공급사의 트랜잭션 처리 편리성을 고려하여 임시저장과 발행을 동시에 처리 [RegistIssue - 즉시 발행]
  • 임시저장 후 발행 – 임시저장과 발행을 분리하여 단계적으로 처리 [Regist - 임시저장][Issue - 발행]
    ※ 전자명세서 파일첨부 기능은 "임시저장 후 발행" 유형으로만 구현 가능

문서번호 관리체계

문서번호란 전자명세서의 중복발행을 방지하고 내부 관리 목적으로 프로그램 공급사가 직접 구성하여 할당하는 고유번호 입니다.

관리주체 유형 변수명 길이 필수 설명
프로그램 공급사 공급자 문서번호 mgtKey 24 Y 영문, 숫자, '-', '_' 이용 가능
팝빌 팝빌 승인번호 invoiceNum 24 Y 팝빌 내부관리 목적으로 전자명세서 발행과 동시에 생성

상태확인

팝빌에서 처리된 전자명세서 상태 확인을 위해 아래 2가지 방법을 지원합니다.

  • API(Polling) : 프로그램 공급사가 직접 API를 호출하여 수동으로 상태 확인
  • Webhook(Push) : 사전에 등록한 콜백 URL로 상태변경 이벤트 발생 시점에 팝빌 전달한 실시간 메시지를 수신하여 확인 [Webhook]