Index
ㆍ파트너가 세금계산서 관리 목적으로 할당하는 문서번호의 사용여부를 확인합니다.
ㆍ이미 사용 중인 문서번호는 중복 사용이 불가하고, 세금계산서가 삭제된 경우에만 문서번호의 재사용이 가능합니다.
function CheckMgtKeyInUse(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey : String) : boolean
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 확인할 문서번호 |
Return
boolean - true : (사용중) / false : (미사용중)
Throws
ㆍ작성된 세금계산서 데이터를 팝빌에 저장과 동시에 발행(전자서명)하여 "발행완료" 상태로 처리합니다. [참고] 팝빌 국세청 전송 정책
ㆍ"발행완료"된 전자세금계산서는 국세청 전송 이전에 [1.6 CancelIssue – 발행취소] 함수로 국세청 신고 대상에서 제외할 수 있습니다.
※ [1.3. Register - 임시저장]와 [1.5. Issue - 발행] 함수 기능을 한 번의 프로세스로 처리합니다.
function RegistIssue(CorpNum : String; Taxinvoice : TTaxinvoice; writeSpecification : boolean = false; forceIssue : boolean = false; memo : String = ''; emailSubject : String = ''; dealInvoiceMgtKey : String = ''; UserID : String = '') : TIssueResponse
ㆍ세금계산서 발행을 위해서 공급자의 인증서가 팝빌 인증서버에 사전등록 되어야 합니다.
※ 위수탁발행의 경우, 수탁자의 인증서 등록이 필요합니다.
ㆍ세금계산서 발행시 포인트가 과금되며, 공급받는자에게 발행 메일이 발송됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | Taxinvoice | TTaxinvoice | - | O | 세금계산서 객체정보 |
3 | writeSpecification | boolean | - | - | 거래명세서 동시작성 여부 : true (사용) / false (미사용) 중 택 1 |
4 | forceIssue | boolean | - | - | 지연발행 가능여부 : true (가능) / false (불가능) 중 택 1 |
5 | memo | String | 200 | - | 세금계산서 상태 이력을 관리하기 위한 메모 |
6 | emailSubject | String | 300 | - |
세금계산서 발행 안내메일 제목
※ 미입력시 팝빌에서 설정한 기본값 사용 |
7 | dealInvoiceMgtKey | String | 24 | - |
{@no 3. WriteSpecification} = true 경우, 거래명세서 문서번호 할당
※ 미입력시 기본값 세금계산서 문서번호와 동일하게 할당 |
8 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ작성된 세금계산서 데이터를 팝빌에 저장합니다.
ㆍ"임시저장" 상태의 세금계산서는 [1.5. Issue - 발행]함수를 호출하여 "발행완료" 처리한 경우에만 국세청으로 전송됩니다.
function Register(CorpNum : String; Taxinvoice : TTaxinvoice; UserID : String = ''; writeSpecification : boolean = false) : TResponse
ㆍ세금계산서 파일첨부 기능을 구현하는 경우, [1.3. Register – 임시저장] -> [4.3. AttachFile – 파일첨부] -> [1.5. Issue – 발행] 함수를 차례로 호출합니다.
ㆍ역발행 세금계산서를 저장하는 경우, 객체 'TTaxinvoice'의 변수 'chargeDirection' 값을 통해 과금 주체를 지정할 수 있습니다.
※ 정과금: 공급자 과금, 역과금: 공급받는자 과금
ㆍ임시저장된 세금계산서는 팝빌 사이트 '임시문서함'에서 확인 가능합니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | Taxinvoice | TTaxinvoice | - | O | 세금계산서 객체정보 |
3 | UserID | String | 50 | - | 팝빌회원 아이디 |
4 | writeSpecification | boolean | - | - | 거래명세서 동시작성 여부 : true (사용) / false (미사용) 중 택 1 |
Return
Throws
ㆍ"임시저장" 상태의 세금계산서를 수정합니다.
function Update(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey : String; Taxinvoice : TTaxinvoice; UserID : String = ''; writeSpecification : boolean = false) : TResponse
ㆍ[2.1. GetInfo – 상태 확인] 또는 [2.2. GetInfos – 다수건 상태확인] 함수를 호출하여 세금계산서의 상태를 확인 할 수 있습니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | Taxinvoice | TTaxinvoice | - | O | 수정사항이 반영된 세금계산서 객체정보 |
5 | UserID | String | 50 | - | 팝빌회원 아이디 |
6 | writeSpecification | boolean | - | - | 거래명세서 동시작성 여부 : true (사용) / false (미사용) 중 택 1 |
Return
Throws
ㆍ"임시저장" 또는 "(역)발행대기" 상태의 세금계산서를 발행(전자서명)하며, "발행완료" 상태로 처리합니다. [참고] 팝빌 국세청 전송 정책
ㆍ"발행완료"된 전자세금계산서는 국세청 전송 이전에 [1.6 CancelIssue – 발행취소] 함수로 국세청 신고 대상에서 제외할 수 있습니다.
function Issue(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey : String; Memo : String; EmailSubject : String; ForceIssue : Boolean; UserID : String = '') : TIssueResponse
ㆍ세금계산서 발행을 위해서 공급자의 인증서가 팝빌 인증서버에 사전등록 되어야 합니다.
※ 위수탁발행의 경우, 수탁자의 인증서 등록이 필요합니다.
ㆍ세금계산서 발행시 포인트가 과금되며, 공급받는자에게 발행 메일이 발송됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | Memo | String | 200 | - | 세금계산서 상태 이력을 관리하기 위한 메모 |
5 | EmailSubject | String | 300 | - |
세금계산서 발행 안내메일 제목
※ 미입력시 팝빌에서 설정한 기본값 사용 |
6 | ForceIssue | boolean | - | O | 지연발행 가능여부 : true (가능) / false (불가능) 중 택 1 |
7 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ국세청 전송 이전 "발행완료" 상태의 전자세금계산서를 "발행취소"하고, 해당 건은 국세청 신고 대상에서 제외됩니다.
function CancelIssue(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey : String; Memo : String; UserID : String = '') : TResponse
ㆍ[1.11. Delete – 삭제]함수를 호출하여 "발행취소" 상태의 전자세금계산서를 삭제하면, 문서번호 재사용이 가능합니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | Memo | String | 200 | - | 세금계산서 상태 이력을 관리하기 위한 메모 |
5 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ공급받는자가 작성한 세금계산서 데이터를 팝빌에 저장하고 공급자에게 송부하여 발행을 요청합니다.
ㆍ역발행 요청된 세금계산서는 "(역)발행대기" 상태이며, 공급자가 팝빌 사이트 또는 함수를 호출하여 발행한 경우에만 국세청으로 전송됩니다.
ㆍ공급자는 팝빌 사이트의 "매출 발행 대기함"에서 발행대기 상태의 역발행 세금계산서를 확인할 수 있습니다.
※ [1.3. Register – 임시저장]와 [1.8. Request – 역발행 요청]함수 기능을 한 번의 프로세스로 처리합니다.
function RegistRequest(CorpNum : String; Taxinvoice : TTaxinvoice; Memo : String =''; UserID : String = '') : TResponse
ㆍ역발행 요청시 공급자에게 역발행 요청 메일이 발송됩니다.
ㆍ공급자가 역발행 세금계산서 발행시 포인트가 과금되며, 객체 'TTaxinvoice'의 변수 'chargeDirection' 값에 따라 과금 주체를 변경할 수 있습니다.
※ 정과금 : 공급자 과금, 역과금 : 공급받는자 과금
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | Taxinvoice | TTaxinvoice | - | O | 세금계산서 객체정보 |
3 | Memo | String | 200 | - | 세금계산서 상태 이력을 관리하기 위한 메모 |
4 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ공급받는자가 저장된 역발행 세금계산서를 공급자에게 송부하여 발행 요청합니다.
ㆍ역발행 요청된 세금계산서는 "(역)발행대기" 상태이며, 공급자가 팝빌 사이트 또는 함수를 호출하여 발행한 경우에만 국세청으로 전송됩니다.
ㆍ공급자는 팝빌 사이트의 "매출 발행 대기함"에서 발행대기 상태의 역발행 세금계산서를 확인할 수 있습니다.
function Request(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey : String; Memo : String; UserID : String = '') : TResponse
ㆍ역발행 요청시 공급자에게 역발행 요청 메일이 발송됩니다.
ㆍ공급자가 역발행 세금계산서 발행시 포인트가 과금됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O | 세금계산서 유형 : BUY (매입) 입력 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | Memo | String | 200 | - | 세금계산서 상태 이력을 관리하기 위한 메모 |
5 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ공급자가 요청받은 역발행 세금계산서를 발행하기 전, 공급받는자가 역발행요청을 취소합니다.
ㆍ함수 호출시 상태 값이 "취소"로 변경되고, 해당 역발행 세금계산서는 공급자에 의해 발행 될 수 없습니다.
function CancelRequest(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey : String; Memo : String; UserID : String = '') : TResponse
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O | 세금계산서 유형 : BUY (매입) 입력 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | Memo | String | 200 | - | 세금계산서 상태 이력을 관리하기 위한 메모 |
5 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ공급자가 공급받는자에게 역발행 요청 받은 세금계산서의 발행을 거부합니다.
function Refuse(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey : String; Memo : String; UserID : String = '') : TResponse
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O | 세금계산서 유형 : SELL (매출) 입력 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | Memo | String | 200 | - | 세금계산서 상태 이력을 관리하기 위한 메모 |
5 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ국세청으로 전송되지 않은 세금계산서를 삭제합니다.
※ 삭제 가능한 상태: "임시저장", "발행취소", "역발행거부", "역발행취소", "전송실패"
function Delete(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey: String; UserID : String = '') : TResponse
ㆍ삭제처리된 세금계산서의 문서번호는 재사용이 가능합니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ공급자가 "발행완료" 상태의 전자세금계산서를 국세청에 즉시 전송하며, 함수 호출 후 최대 30분 이내에 전송 처리가 완료됩니다.
function SendToNTS(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey :String; UserID : String = '') : TResponse
ㆍ함수 [2.1. GetInfo – 상태확인]또는 커넥트 서비스를 통해 국세청 전송 결과를 확인 합니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / TRUSTEE 중 택 1
└ SELL = 매출, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ세금계산서 1건의 상태 및 요약정보를 확인합니다.
ㆍ리턴값 'TTaxinvoiceInfo'의 변수 'stateCode'를 통해 세금계산서의 상태코드를 확인합니다. [참고] 세금계산서 상태코드
function GetInfo(CorpNum : string; MgtKeyType:EnumMgtKeyType; MgtKey: string) : TTaxinvoiceInfo
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
Return
Throws
ㆍ다수건의 세금계산서의 상태 및 요약 정보를 확인합니다. (1회 호출 시 최대 1,000건 확인 가능)
ㆍ리턴값 'TTaxinvoiceInfo'의 변수 'stateCode'를 통해 세금계산서의 상태코드를 확인합니다. [참고] 세금계산서 상태코드
function GetInfos(CorpNum : string; MgtKeyType:EnumMgtKeyType; MgtKeyList: Array Of String) : TaxinvoiceInfoList
ㆍ문서번호를 통해 세금계산서 목록을 구현하는 경우 활용합니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKeyList | Array Of String | 1000 | O | [배열] 조회할 세금계산서 문서번호 (최대 1,000건) |
Return
TTaxinvoiceInfoList = Array of TTaxinvoiceInfo
Throws
ㆍ세금계산서 1건의 상세정보를 확인합니다.
function GetDetailInfo(CorpNum : string; MgtKeyType:EnumMgtKeyType; MgtKey: string) : TTaxinvoice
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
Return
Throws
ㆍ파트너가 지정한 검색조건에 해당하는 세금계산서를 조회합니다.
function search(CorpNum : string; MgtKeyType:EnumMgtKeyType; DType:String; SDate: String; EDate:String; State : Array Of String; TType:Array Of String; TaxType : Array Of String; IssueType : Array Of String; LateOnly : String; TaxRegIDType : String; TaxRegID: String; TaxRegIDYN : string; QString : String; Page : Integer; PerPage : Integer; Order : String; InterOPYN : String; UserID : String; RegType : Array Of String; CloseDownState : Array Of String; MgtKey : String) : TSearchList
ㆍ페이지 관련 항목(Page, PerPage, Order)을 활용하여 세금계산서 목록을 구현할 수 있습니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | DType | String | 1 | O |
조회 기준일자 유형: 'R' / 'W' / 'I' 중 택 1
└ R = 등록일자, W = 작성일자, I = 발행일자 |
4 | SDate | String | 8 | O | 조회 기간의 시작일자 (형식 : yyyyMMdd) |
5 | EDate | String | 8 | O | 조회 기간의 종료일자 (형식 : yyyyMMdd) |
6 | State | Array Of String | - | O |
[배열] 세금계산서 상태코드
└ 상태코드 2, 3번째 자리에 와일드카드(*) 사용가능. 예) '3**', '60*' [참고] 세금계산서 상태코드 ※ 미입력시 전체조회 |
7 | TType | Array Of String | - | O |
[배열] 세금계산서 문서유형 : 'N' / 'M' 중 선택 (다중 선택 가능)
└ N = 일반, M = 수정 세금계산서 ※ 미입력시 전체조회 |
8 | TaxType | Array Of String | - | O |
[배열] 과세형태 : 'T' / 'N' / 'Z' 중 선택 (다중 선택 가능)
└ T = 과세, N = 면세, Z = 영세 ※ 미입력시 전체조회 |
9 | IssueType | Array Of String | - | O |
[배열] 발행형태 : 'N' / 'R' / 'T' 중 선택 (다중 선택 가능)
└ N = 정발행, R = 역발행, T = 위수탁발행 ※ 미입력시 전체조회 |
10 | LateOnly | String | 1 | O |
지연발행 여부 : '' / '1' / '0' 중 택 1
└ '' = 전체, "1" = 지연발행, "0" = 정상발행 |
11 | TaxRegIDType | String | 1 | O |
종사업자번호의 주체 : 'S' / 'B' / 'T' 중 택 1
└ S = 공급자, B = 공급받는자, T = 수탁자 ※ 미입력시 전체조회 |
12 | TaxRegID | String | - | O |
종사업장번호
└ 다수건 검색시 콤마(",")로 구분. 예) 1234, 1000 ※ 미입력시 전체조회 |
13 | TaxRegIDYN | String | 1 | O |
종사업장번호 유무 : '' / '0' / '1' 중 택 1
└ '' = 전체, 0 = 없음, 1 = 있음 |
14 | QString | String | - | O |
거래처 상호 / 사업자번호 (사업자) / 주민등록번호 (개인) / "9999999999999" (외국인) 중 검색하고자 하는 정보 입력
└ 사업자번호 / 주민등록번호는 하이픈('-')을 제외한 숫자만 입력 ※ 미입력시 전체조회 |
15 | Page | Integer | - | O | 목록 페이지번호 |
16 | PerPage | Integer | - | O | 페이지당 표시할 목록 개수 (최대 1,000) |
17 | Order | String | 1 | O |
{@no.3 DType} 값을 기준으로 하는 목록 정렬 방향 : 'D' / 'A' 중 택 1
└ D = 내림차순(기본값), A = 오름차순 |
18 | InterOPYN | String | 1 | O |
연동문서 여부 : '' / '0' / '1' 중 택 1
└ '' = 전체, 0 = 일반문서, 1 = 연동문서 ※ 일반문서는 팝빌 사이트를 통해 저장 또는 발행한 세금계산서, 연동문서는 팝빌 API를 통해 저장 또는 발행한 세금계산서 |
19 | UserID | String | 50 | - | 팝빌회원 아이디 |
20 | RegType | Array Of String | - | - |
[배열] 전자세금계산서 등록 유형 : 'P' / 'H' 중 선택 (다중 선택 가능)
└ P = 팝빌에서 등록(발행), H = 홈택스 또는 ASP에서 등록(발행) ※ 미입력시 전체조회 |
21 | CloseDownState | Array Of String | - | - |
[배열] 휴폐업상태 : 'N' / '0' / '1' / '2' / '3' 중 선택 (다중 선택 가능)
└ N = 미확인, 0 = 미등록, 1 = 사업중, 2 = 폐업, 3 = 휴업 ※ 미입력시 전체조회 |
22 | MgtKey | String | - | - |
세금계산서의 문서번호 / 국세청 승인번호 중 검색하고자 하는 정보 입력
※ 미입력시 전체조회 |
Return
Throws
ㆍ세금계산서의 상태에 대한 변경이력을 확인합니다.
function GetLogs(CorpNum : string; MgtKeyType:EnumMgtKeyType; MgtKey: string) : TTaxinvoiceLogList
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
Return
TTaxinvoiceLogList = Array Of TTaxinvoiceLog
Throws
ㆍ로그인 상태로 팝빌 사이트의 전자세금계산서 문서함 메뉴에 접근할 수 있는 페이지의 팝업 URL을 반환합니다.
ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetURL(CorpNum : String; UserID : String; TOGO : String) : String
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | UserID | String | 50 | - | 팝빌회원 아이디 |
3 | TOGO | String | - | O |
접근 메뉴 : "TBOX" / "SBOX" / "PBOX" / "WRITE" 중 택 1
└ TBOX = 임시 문서함, SBOX = 매출 문서함, PBOX = 매입 문서함, WRITE = 매출 문서작성 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ팝빌 사이트와 동일한 세금계산서 1건의 상세 정보 페이지의 팝업 URL을 반환합니다.
ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetPopUpURL(CorpNum: string; MgtKeyType : EnumMgtKeyType; MgtKey : String; UserID: String = '') : string
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ팝빌 사이트와 동일한 세금계산서 1건의 상세정보 페이지(사이트 상단, 좌측 메뉴 및 버튼 제외)의 팝업 URL을 반환합니다.
ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetViewURL(CorpNum: string; MgtKeyType : EnumMgtKeyType; MgtKey : String; UserID: String = '') : string;
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ세금계산서 1건을 인쇄하기 위한 페이지의 팝업 URL을 반환하며, 페이지내에서 인쇄 설정값을 "공급자" / "공급받는자" / "공급자+공급받는자"용 중 하나로 지정할 수 있습니다.
ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetPrintURL(CorpNum: string; MgtKeyType : EnumMgtKeyType; MgtKey : String; UserID: String = '') : string
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ"공급받는자" 용 세금계산서 1건을 인쇄하기 위한 페이지의 팝업 URL을 반환합니다.
ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetEPrintURL(CorpNum: string; MgtKeyType : EnumMgtKeyType; MgtKey : String; UserID: String = '') : string
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ다수건의 세금계산서를 인쇄하기 위한 페이지의 팝업 URL을 반환합니다. (최대 100건)
ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetMassPrintURL(CorpNum: string; MgtKeyType : EnumMgtKeyType; MgtKeyList: Array Of String; UserID: String = '') : string
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKeyList | Array Of String | 100 | O | [배열] 인쇄할 세금계산서 문서번호 (최대 100건) |
4 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ안내메일과 관련된 전자세금계산서를 확인 할 수 있는 상세 페이지의 팝업 URL을 반환하며, 해당 URL은 메일 하단의 "전자세금계산서 보기" 버튼의 링크와 같습니다.
ㆍ함수 호출로 반환 받은 URL에는 유효시간이 없습니다.
function GetMailURL(CorpNum: string; MgtKeyType : EnumMgtKeyType; MgtKey : String; UserID: String = '') : string
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ전자세금계산서 PDF 파일을 다운 받을 수 있는 URL을 반환합니다.
ㆍ반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 이후 호출시 정상적으로 페이지가 호출되지 않습니다.
function GetPDFURL(CorpNum: string; MgtKeyType : EnumMgtKeyType; MgtKey : String; UserID: String = '') : string
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ팝빌 사이트에 로그인 상태로 접근할 수 있는 페이지의 팝업 URL을 반환합니다.
ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetAccessURL(CorpNum : String; UserID : String) : String
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ세금계산서에 첨부할 인감, 사업자등록증, 통장사본을 등록하는 페이지의 팝업 URL을 반환합니다.
ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetSealURL(CorpNum : String; UserID : String) : String
ㆍ인감을 등록한 이후 세금계산서를 발행하는 경우, 자동으로 등록된 인감이 첨부되어 세금계산서가 발행됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ"임시저장" 상태의 세금계산서에 1개의 파일을 첨부합니다. (최대 5개)
function AttachFile(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey : String; FilePath : String; UserID : String = '') : TResponse
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | FilePath | String | - | O | 첨부파일 경로 |
5 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ"임시저장" 상태의 세금계산서에 첨부된 1개의 파일을 삭제합니다.
ㆍ파일 식별을 위해 첨부시 부여되는 'FileID'는 함수 [4.5. GetFiles – 첨부파일 목록 확인] 를 호출하여 확인합니다.
function DeleteFile(CorpNum: string; MgtKeyType : EnumMgtKeyType; MgtKey : String; FileID : String; UserID : String = '') : TResponse
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | FileID | String | 255 | O |
팝빌이 첨부파일 관리를 위해 할당하는 식별번호
└ 함수 [4.5. GetFiles – 첨부파일 목록 확인]의 리턴값 'AttachedFile'의 변수 'attachedFile'를 통해 확인 가능 |
5 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ세금계산서에 첨부된 파일목록을 확인합니다.
function GetFiles(CorpNum: String; MgtKeyType : EnumMgtKeyType; MgtKey : String) : TAttachedFileList
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
Return
TAttachedFileList = Array of TAttachedFile
Throws
ㆍ세금계산서와 관련된 안내 메일을 재전송 합니다.
function SendEmail(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey :String; Receiver:String; UserID : String = '') : TResponse
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | Receiver | String | - | O | 수신자 이메일주소 |
5 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ세금계산서와 관련된 안내 SMS(단문) 문자를 재전송하는 함수로, 팝빌 사이트 [문자·팩스] > [문자] > [전송내역] 메뉴에서 전송결과를 확인 할 수 있습니다.
ㆍ메시지는 최대 90byte까지 입력 가능하고, 초과한 내용은 자동으로 삭제되어 전송합니다. (한글 최대 45자)
function SendSMS(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey :String; Sender:String; Receiver:String; Contents : String; UserID : String = '') : TResponse
ㆍ함수 호출시 포인트가 과금됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | Sender | String | - | O | 발신번호 |
5 | Receiver | String | - | O | 수신번호 |
6 | Contents | String | 90 | O |
메시지 내용
※ 최대 90 byte까지 입력 가능하고, 초과한 내용은 자동으로 삭제되어 전송 |
7 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ세금계산서를 팩스로 전송하는 함수로, 팝빌 사이트 [문자·팩스] > [팩스] > [전송내역] 메뉴에서 전송결과를 확인 할 수 있습니다.
function SendFAX(CorpNum : String; MgtKeyType:EnumMgtKeyType; MgtKey :String; Sender:String; Receiver:String; UserID : String = '') : TResponse
ㆍ함수 호출시 포인트가 과금됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | Sender | String | - | O | 발신번호 |
5 | Receiver | String | - | O | 수신번호 |
6 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ팝빌 전자명세서 API를 통해 발행한 전자명세서를 세금계산서에 첨부합니다.
function AttachStatement(CorpNum : String; MgtKeyType: EnumMgtKeyType; MgtKey : String; SubItemCode : Integer; SubMgtKey : String) : TResponse
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | SubItemCode | Integer | 3 | O |
첨부할 전자명세서의 유형 코드 : 121 / 122 / 123 / 124 / 125 / 126 중 택 1
└ 121 = 거래명세서, 122 = 청구서, 123 = 견적서, 124 = 발주서, 125 = 입금표, 126 = 영수증 ※ 전자명세서 발행시 입력한 값과 동일하게 작성 |
5 | SubMgtKey | String | 24 | O | 첨부할 전자명세서 문서번호 |
Return
Throws
ㆍ세금계산서에 첨부된 전자명세서를 해제합니다.
function DetachStatement(CorpNum : String; MgtKeyType: EnumMgtKeyType; MgtKey : String; SubItemCode : Integer; SubMgtKey : String) : TResponse
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
4 | SubItemCode | Integer | 3 | O |
첨부해제할 전자명세서의 유형 코드 : 121 / 122 / 123 / 124 / 125 / 126 중 택 1
└ 121 = 거래명세서, 122 = 청구서, 123 = 견적서, 124 = 발주서, 125 = 입금표, 126 = 영수증 ※ 전자명세서 발행시 입력한 값과 동일하게 작성 |
5 | SubMgtKey | String | 24 | O | 첨부해제할 전자명세서 문서번호 |
Return
Throws
ㆍ전자세금계산서 유통사업자의 메일 목록을 확인합니다.
function GetEmailPublicKeys(CorpNum : String) : TEmailPublicKeyList
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
Return
TEmailPublicKeyList = Array of TEmailPublicKey
Throws
ㆍ연동 시스템에서 세금계산서를 관리하기 위해 팝빌 사이트를 통해 생성한 세금계산서에 문서번호를 할당합니다.
function AssignMgtKey(CorpNum : String; MgtKeyType: EnumMgtKeyType; ItemKey : String; MgtKey : String; UserID: String = '') : TResponse
ㆍ팝빌 사이트를 통해 생성한 세금계산서에는 문서번호가 할당되어 있지 않습니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | MgtKeyType | EnumMgtKeyType | - | O |
세금계산서 유형 : SELL / BUY / TRUSTEE 중 택 1
└ SELL = 매출, BUY = 매입, TRUSTEE = 위수탁 |
3 | ItemKey | String | 18 | O |
팝빌에서 세금계산서 관리 목적으로 할당한 식별번호
└ 함수 [2.4. Search – 목록 조회]를 통하여 TTaxinvoiceInfo의 'itemKey'를 확인 |
4 | MgtKey | String | 24 | O | 파트너가 할당한 문서번호 |
5 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ세금계산서 관련 메일 항목에 대한 발송설정을 확인합니다.
function ListEmailConfig(CorpNum : String; UserID : String = '') : TEmailConfigList
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
TEmailConfigList = Array of TEmailConfig
Throws
ㆍ세금계산서 관련 메일 항목에 대한 발송설정을 수정합니다.
function UpdateEmailConfig(CorpNum : String; EmailType : String; SendYN : Boolean; UserID : String = '') : TResponse
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | EmailType | String | - | O |
* 발송 메일 유형
|
3 | SendYN | Boolean | - | O |
메일 전송 여부 : true / false 중 택 1
└ true = 전송, false = 미전송 |
4 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ전자세금계산서용 인증서를 팝빌 인증서버에 등록하기 위한 페이지의 팝업 URL을 반환합니다.
ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetTaxCertURL(CorpNum : String; UserID : String) : String
ㆍ인증서 갱신/재발급/비밀번호 변경한 경우, 변경된 인증서를 팝빌 인증서버에 재등록 해야합니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ팝빌 인증서버에 등록된 인증서의 만료일을 확인합니다.
function GetCertificateExpireDate(CorpNum : String) : string
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
Return
string - 인증서 만료일자
Throws
ㆍ팝빌 인증서버에 등록된 인증서의 유효성을 확인합니다.
function CheckCertValidation(CorpNum : String; UserID : String = '') : TResponse
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ연동회원의 잔여포인트를 확인합니다.
function GetBalance(CorpNum: string): Double;
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
Return
Double - 연동회원 잔여포인트
Throws
ㆍ연동회원 포인트 충전을 위한 페이지의 팝업 URL을 반환합니다.
ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetChargeURL(CorpNum: string; UserID: string): string;
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ파트너의 잔여포인트를 확인합니다.
function GetPartnerBalance(CorpNum: string): Double;
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
Return
Double - 파트너 잔여포인트
Throws
ㆍ파트너 포인트 충전을 위한 페이지의 팝업 URL을 반환합니다.
ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetPartnerURL(CorpNum: string; TOGO: string): string;
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | TOGO | String | - | O | CHRG : 파트너 포인트 충전 |
Return
String - 요청에 대한 응답 URL
Throws
ㆍ세금계산서 발행시 과금되는 포인트 단가를 확인합니다.
function GetUnitCost(CorpNum: string): Single
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
Return
Single - 세금계산서 발행단가
Throws
ㆍ팝빌 전자세금계산서 API 서비스 과금정보를 확인합니다.
function GetChargeInfo(CorpNum: string; UserID: string): TTaxinvoiceChargeInfo
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ사업자번호를 조회하여 연동회원 가입여부를 확인합니다.
function CheckIsMember(CorpNum: string; LinkID: string): TResponse;
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | LinkID | String | - | O | 링크아이디 |
Return
Throws
ㆍ사용하고자 하는 아이디의 중복여부를 확인합니다.
function CheckID(ID: string): TResponse;
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | ID | String | 20 | O | 중복여부를 확인할 아이디 |
Return
TResponse - code : 0 (미사용중) / code : 1 (사용중)
Throws
ㆍ사용자를 연동회원으로 가입처리합니다.
function JoinMember(JoinInfo: TJoinForm): TResponse;
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | JoinInfo | TJoinForm | - | O | 연동회원 객체정보 |
Return
Throws
ㆍ연동회원의 회사정보를 확인합니다.
function GetCorpInfo(CorpNum: string; UserID: string): TCorpInfo
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ연동회원의 회사정보를 수정합니다.
function UpdateCorpInfo(CorpNum: string; CorpInfo: TCorpInfo; UserID: string): TResponse
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | CorpInfo | TCorpInfo | - | O | 회사정보 객체 |
3 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ연동회원 사업자번호에 담당자(팝빌 로그인 계정)를 추가합니다.
function RegistContact(CorpNum: string; JoinInfo: TJoinContact; UserID: string): TResponse
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | JoinInfo | TJoinContact | - | O | 담당자 정보 객체 |
3 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
ㆍ연동회원 사업자번호에 등록된 담당자(팝빌 로그인 계정) 목록을 확인합니다.
function ListContact(CorpNum: string; UserID: string): TContactInfoList
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
TContactInfoList = Array Of TContactInfo
Throws
ㆍ연동회원 사업자번호에 등록된 담당자(팝빌 로그인 계정) 정보를 수정합니다.
function UpdateContact(CorpNum: string; CorpInfo: TContactInfo; UserID: string): TResponse;
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
1 | CorpNum | String | 10 | O | 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리) |
2 | CorpInfo | TContactInfo | - | O | 담당자 정보 객체 |
3 | UserID | String | 50 | - | 팝빌회원 아이디 |
Return
Throws
순번 | 변수명 | 항목명 | 타입 | 길이 | 비고 |
---|---|---|---|---|---|
1 | code | 코드 | LongInt | - | API 처리에 대한 응답코드 |
2 | message | 메시지 | string | - | API 처리에 대한 응답메시지 |
순번 | 변수명 | 항목명 | 타입 | 길이 | 비고 |
---|---|---|---|---|---|
1 | code | 코드 | LongInt | - | API 처리에 대한 응답코드 |
2 | message | 메시지 | string | - | API 처리에 대한 응답메시지 |
3 | ntsConfirmNum | 국세청 승인번호 | string | 24 | 세금계산서 발행 시점에 팝빌에서 자동으로 부여 |
순번 | 변수명 | 항목명 | 타입 | 길이 | 비고 |
---|---|---|---|---|---|
1 | code | 코드 | LongInt | - |
API 처리 실패에 대한 오류코드("-"로 시작하는 8자리 숫자값)
└ [참고] 오류코드 |
2 | message | 메시지 | string | - | API 처리 실패에 대한 오류메시지 |
순번 | 변수명 | 항목명 | 타입 | 길이 | 필수 | 비고 |
---|---|---|---|---|---|---|
1 | ntsconfirmNum | 국세청 승인번호 | string | 24 | X | 세금계산서 발행 시점에 팝빌에서 자동으로 부여 |
2 | issueType | 발행형태 | string | 3 | O | "정발행" / "역발행" / "위수탁" 중 택 1 |
3 | taxType | 과세형태 | string | 2 | O | "과세" / "영세" / "면세" 중 택 1 |
4 | chargeDirection | 과금방향 | string | 3 | O |
"정과금" / "역과금" 중 택 1
└ 정과금 = 공급자 과금 └ 역과금 = 공급받는자 과금 : {@no 2. issueType} = "역발행" 인 경우만 가능 |
5 | serialNum | 일련번호 | string | 30 | - | |
6 | kwon | 권 | string | 4 | - | 책번호 "권" 항목 |
7 | ho | 호 | string | 4 | - | 책번호 "호" 항목 |
8 | writeDate | 작성일자 | string | 8 | O | 형식 : yyyyMMdd |
9 | purposeType | 영수/청구 | string | 2 | O | "영수" / "청구" / "없음" 중 택 1 |
10 | supplyCostTotal | 공급가액 합계 | string | 18 | O |
정수만 입력 가능
※ 마이너스 금액 입력 가능, 소수점 아래 자동 절사 |
11 | taxTotal | 세액 합계 | string | 18 | O |
정수만 입력 가능
※ 마이너스 금액 입력 가능, 소수점 아래 자동 절사 |
12 | totalAmount | 합계금액 | string | 18 | O |
정수만 입력 가능
※ 마이너스 금액 입력 가능, 소수점 아래 자동 절사 |
13 | cash | 현금 | string | 18 | - | |
14 | chkBill | 수표 | string | 18 | - | |
15 | credit | 외상 | string | 18 | - | |
16 | note | 어음 | string | 18 | - | |
17 | remark1 | 비고1 | string | 150 | △ | {@no 35. invoiceeType} = "외국인" 인 경우 필수, 외국인 등록번호 또는 여권번호 입력 |
18 | remark2 | 비고2 | string | 150 | - | |
19 | remark3 | 비고3 | string | 150 | - | |
20 | invoicerMgtKey | 공급자 문서번호 | string | 24 | △ |
정발행시 필수, 공급자의 문서 관리를 위해 파트너가 할당하는 식별번호
└ 영문, 숫자, 하이픈(-') 사용하여 고유값 부여 |
21 | invoicerCorpNum | 공급자 사업자번호 | string | 10 | O | 하이픈('-') 제외 10자리 숫자값 |
22 | invoicerTaxRegID | 공급자 종사업장 식별번호 | string | 4 | - | 4자리 숫자값 |
23 | invoicerCorpName | 공급자 상호 | string | 200 | O | |
24 | invoicerCEOName | 공급자 대표자 성명 | string | 100 | O | |
25 | invoicerAddr | 공급자 주소 | string | 300 | - | |
26 | invoicerBizType | 공급자 업태 | string | 100 | - | |
27 | invoicerBizClass | 공급자 종목 | string | 100 | - | |
28 | invoicerContactName | 공급자 담당자 성명 | string | 100 | - | |
29 | invoicerDeptName | 공급자 담당자 부서명 | string | 100 | - | |
30 | invoicerTEL | 공급자 담당자 연락처 | string | 20 | - | |
31 | invoicerHP | 공급자 담당자 휴대폰 | string | 20 | - | |
32 | invoicerEmail | 공급자 담당자 이메일 | string | 100 | - | |
33 | invoicerSMSSendYN | 공급자 문자전송 여부 | Boolean | - | - |
{@no 2. issueType} 값이 "정발행" 인 경우, 세금계산서 발행시 알림문자 전송여부 : true / false 중 택 1
└ true = 전송, false = 미전송 └ 공급받는자 (주)담당자 휴대폰번호 {@no 48. invoiceeHP1} 값으로 문자 전송 └ 전송시 포인트 차감되며, 실패시 환불 처리 |
34 | invoiceeMgtKey | 공급받는자 문서번호 | string | 24 | △ |
역발행시 필수, 공급받는자의 문서 관리를 위해 파트너가 부여하는 식별번호
└ 영문, 숫자, 하이픈('-') 사용하여 고유값 부여 |
35 | invoiceeType | 공급받는자 구분 | string | - | O | "사업자" / "개인" / "외국인" 중 택 1 |
36 | invoiceeCorpNum | 공급받는자 사업자번호 | string | - | O |
{@no 35. invoiceeType} = "사업자" 인 경우, 사업자번호 (하이픈 ('-') 제외 10자리)
{@no 35. invoiceeType} = "개인" 인 경우, 주민등록번호 (하이픈 ('-') 제외 13자리) {@no 35. invoiceeType} = "외국인" 인 경우, "9999999999999" (하이픈 ('-') 제외 13자리) |
37 | invoiceeTaxRegID | 공급받는자 종사업장 식별번호 | string | 4 | - | 4자리 숫자값 |
38 | invoiceeCorpName | 공급받는자 상호 | string | 200 | O | |
39 | invoiceeCEOName | 공급받는자 대표자 성명 | string | 100 | O | |
40 | invoiceeAddr | 공급받는자 주소 | string | 300 | - | |
41 | invoiceeBizType | 공급받는자 업태 | string | 100 | - | |
42 | invoiceeBizClass | 공급받는자 종목 | string | 100 | - | |
43 | closeDownState | 공급받는자 휴폐업상태 | Integer | 1 | X |
세금계산서 발행시 팝빌에서 휴폐업조회를 하여 결과값 입력 : null / 0 / 1 / 2 / 3 중 반환
└ null = 미확인, 0 = 미등록, 1 = 사업중, 2 = 폐업, 3 = 휴업 |
44 | closeDownStateDate | 공급받는자 휴폐업일자 | string | 8 | X | {@no 43. closeDownState} 값이 2 or 3일 경우 존재, 휴폐업조회를 하여 결과값 입력 (형식 : yyyyMMdd) |
45 | invoiceeContactName1 | 공급받는자 주) 담당자 성명 | string | 100 | - | |
46 | invoiceeDeptName1 | 공급받는자 주) 담당자 부서명 | string | 100 | - | |
47 | invoiceeTEL1 | 공급받는자 주) 담당자 연락처 | string | 20 | - | |
48 | invoiceeHP1 | 공급받는자 주) 담당자 휴대폰 | string | 20 | - | |
49 | invoiceeEmail1 | 공급받는자 주) 담당자 이메일 | string | 100 | - | |
50 | invoiceeContactName2 | 공급받는자 부) 담당자 성명 | string | 30 | - | |
51 | invoiceeDeptName2 | 공급받는자 부) 담당자 부서명 | string | 40 | - | |
52 | invoiceeTEL2 | 공급받는자 부) 담당자 연락처 | string | 20 | - | |
53 | invoiceeHP2 | 공급받는자 부) 담당자 휴대폰 | string | 20 | - | |
54 | invoiceeEmail2 | 공급받는자 부) 담당자 이메일 | string | 70 | - | |
55 | invoiceeSMSSendYN | 공급받는자 문자전송 여부 | Boolean | - | - |
{@no 2. issueType} 값이 "역발행" 인 경우, 세금계산서 역발행 요청시 알림문자 전송여부: true / false 중 택 1
└ true = 전송, false = 미전송 └ 공급자 담당자 휴대폰번호 {@no 31. invoicerHP} 값으로 문자 전송 └ 전송시 포인트 차감되며, 실패시 환불 처리 |
56 | trusteeMgtKey | 수탁자 문서번호 | string | 24 | △ |
위수탁발행시 필수, 수탁자의 문서 관리를 위해 파트너가 부여하는 식별번호
└ 영문, 숫자, 하이픈('-') 사용하여 고유값 부여 |
57 | trusteeCorpNum | 수탁자 사업자번호 | string | 10 | △ | 위수탁발행시 필수, 하이픈('-') 제외 10자리 숫자값 |
58 | trusteeTaxRegID | 수탁자 종사업장 식별번호 | string | 4 | - | 4자리 숫자값 |
59 | trusteeCorpName | 수탁자 상호 | string | 200 | △ | 위수탁발행시 필수 |
60 | trusteeCEOName | 수탁자 대표자 성명 | string | 100 | △ | 위수탁발행시 필수 |
61 | trusteeAddr | 수탁자 주소 | string | 300 | - | |
62 | trusteeBizType | 수탁자 업태 | string | 100 | - | |
63 | trusteeBizClass | 수탁자 종목 | string | 100 | - | |
64 | trusteeContactName | 수탁자 담당자 성명 | string | 100 | - | |
65 | trusteeDeptName | 수탁자 담당자 부서명 | string | 100 | - | |
66 | trusteeTEL | 수탁자 담당자 연락처 | string | 20 | - | |
67 | trusteeHP | 수탁자 담당자 휴대폰 | string | 20 | - | |
68 | trusteeEmail | 수탁자 담당자 이메일 | string | 100 | - | |
69 | trusteeSMSSendYN | 수탁자 문자전송 여부 | Boolean | - | - |
{@no 2. issueType} 값이 "위수탁" 인 경우, 세금계산서 발행시 알림문자 전송여부: true / false 중 택 1
└ true = 전송, false = 미전송(기본값) └ 공급받는자 (주)담당자 휴대폰번호 {@no 48. invoiceeHP1} 값으로 문자 전송 └ 전송시 포인트 차감되며, 실패시 환불 처리 |
70 | modifyCode | 수정 사유코드 | Short | 1 | △ |
수정세금계산서 작성시 필수
└ [참고] 수정세금계산서 |
71 | orgNTSConfirmNum | 원본 세금계산서 국세청 승인번호 |
string | 24 | △ | 수정세금계산서 작성시 필수 |
72 | businessLicenseYN | 사업자등록증 첨부 | Boolean | - | - |
팝빌에 등록된 사업자등록증 첨부 여부 : true / false 중 택 1
└ true = 첨부, false = 미첨부(기본값) ※ 팝빌 사이트 또는 [4.2. GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록 |
73 | bankBookYN | 통장사본 첨부 | Boolean | - | - |
팝빌에 등록된 통장사본 첨부 여부 : true / false 중 택 1
└ true = 첨부, false = 미첨부(기본값) ※ 팝빌 사이트 또는 [4.2. GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록 |
74 | detailList | 상세항목 | TDetailList | - | [배열] 거래 물품 상세 정보 (최대 99건) | |
75 | addContactList | 추가담당자 | TContactList | - |
[배열] 공급받는자 담당자 정보 (최대 5명)
※ 여러 담당자에게 세금계산서 안내 메일을 보내야할 경우 사용 |
순번 | 변수명 | 항목명 | 타입 | 길이 | 필수 | 비고 |
---|---|---|---|---|---|---|
1 | serialNum | 일련번호 | Short | - | O | 1부터 순차적으로 입력 (최대 99) |
2 | purchaseDT | 거래일자 | string | 8 | - | 형식 : yyyyMMdd |
3 | itemName | 품명 | string | 100 | - | |
4 | spec | 규격 | string | 60 | - | |
5 | qty | 수량 | string | 12 | - |
소수점 아래 2번째 자리까지 입력 가능
※ 마이너스 입력 가능 |
6 | unitCost | 단가 | string | 18 | - |
소수점 아래 2번째 자리까지 입력 가능
※ 마이너스 금액 입력 가능 |
7 | supplyCost | 공급가액 | string | 18 | - |
정수만 입력 가능
※ 마이너스 금액 입력 가능, 소수점 아래 자동 절사 |
8 | tax | 세액 | string | 18 | - |
정수만 입력 가능
※ 마이너스 금액 입력 가능, 소수점 아래 자동 절사 |
9 | remark | 비고 | string | 100 | - |
순번 | 변수명 | 항목명 | 타입 | 길이 | 필수 | 비고 |
---|---|---|---|---|---|---|
1 | serialNum | 일련번호 | Integer | - | O | 1부터 순차적으로 입력 (최대 5) |
2 | contactName | 담당자 성명 | string | 100 | O | |
3 | 이메일 | string | 100 | O |
순번 | 변수명 | 항목명 | 타입 | 길이 | 비고 |
---|---|---|---|---|---|
1 | code | 코드 | Integer | - | API 처리에 대한 응답코드 |
2 | message | 메시지 | string | - | API 처리에 대한 응답메시지 |
3 | total | 총 검색결과 건수 | Integer | - | |
4 | perPage | 페이지당 검색개수 | Integer | - | |
5 | pageNum | 페이지 번호 | Integer | - | |
6 | pageCount | 페이지 개수 | Integer | - | |
7 | list | 세금계산서 상태/요약정보 | TTaxinvoiceInfoList |
[배열] 최대 1,000건
└ 함수 [2.1. GetInfo – 상태 확인]의 리턴값 구성과 동일 |
순번 | 변수명 | 항목명 | 타입 | 길이 | 비고 |
---|---|---|---|---|---|
1 | itemKey | 팝빌번호 | string | 18 | 팝빌에서 세금계산서 관리 목적으로 할당한 식별번호 |
2 | taxType | 과세형태 | string | 2 | "과세" / "영세" / "면세" 중 반환 |
3 | writeDate | 작성일자 | string | 8 | 형식 : yyyyMMdd |
4 | regDT | 임시저장 일자 | string | 8 | 형식 : yyyyMMdd |
5 | issueType | 발행형태 | string | 3 | "정발행" / "역발행" / "위수탁" 중 반환 |
6 | supplyCostTotal | 공급가액 합계 | string | 18 | |
7 | taxTotal | 세액 합계 | string | 18 | |
8 | purposeType | 영수/청구 | string | 2 | "영수" / "청구" / "없음" 중 반환 |
9 | issueDT | 발행일시 | string | 14 | 형식 : yyyyMMddHHmmss |
10 | lateIssueYN | 지연발행 여부 | boolean | - | true : (지연발행) / false : (정상발행) 중 반환 |
11 | preIssueDT | 발행예정일시 | string | 14 | 형식 : yyyyMMddHHmmss |
12 | openYN | 개봉 여부 | boolean | - |
true : (개봉) / false : (미개봉) 중 반환
└ {@no.5 issueType} 값이 "정발행" or "위수탁" 인 경우, 공급받는자가 전자세금계산서 보기 버튼을 클릭한 경우 개봉 처리 └ {@no.5 issueType} 값이 "역발행" 인 경우, 공급자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리 |
13 | openDT | 개봉일시 | string | 14 | 형식 : yyyyMMddHHmmss |
14 | stateMemo | 상태메모 | string | 200 | |
15 | stateCode | 상태코드 | Integer | 3 | [참고] 세금계산서 상태코드 |
16 | stateDT | 상태 변경일시 | string | 14 | 형식 : yyyyMMddHHmmss |
17 | ntsconfirmNum | 국세청 승인번호 | string | 24 | |
17 | ntsresult | 국세청 전송결과 | String | 6 | |
19 | ntssendDT | 국세청 전송일시 | string | 14 | 형식 : yyyyMMddHHmmss |
20 | ntsresultDT | 국세청 결과 수신일시 | string | 14 | 형식 : yyyyMMddHHmmss |
21 | ntssendErrCode | 전송실패 사유코드 | string | 8 | [참고] 국세청전송 결과코드 |
22 | modifyCode | 수정 사유코드 | string | 1 |
수정세금계산서 발행시 입력한 사유코드
└ [참고] 수정세금계산서 |
23 | interOPYN | 연동문서 여부 | boolean | - | true : (API를 통해 발행한 연동문서) / false : (팝빌 사이트를 통해 발행한 문서) 중 반환 |
24 | invoicerCorpName | 공급자 상호 | string | 200 | |
25 | invoicerCorpNum | 공급자 사업자번호 | string | 10 | |
26 | invoicerMgtKey | 공급자 문서번호 | string | 24 | 파트너가 팝빌에 세금계산서를 임시저장 또는 발행시 할당한 문서번호 |
27 | invoicerPrintYN | 공급자 인쇄여부 | boolean | - | true : (인쇄) / false : (미인쇄) 중 반환 |
28 | invoiceeCorpName | 공급받는자 상호 | string | 200 | |
29 | invoiceeCorpNum | 공급받는자 사업자번호 | string | 10 | |
30 | invoiceeMgtKey | 공급받는자 문서번호 | string | 24 | 파트너가 할당한 문서번호 |
31 | invoiceePrintYN | 공급받는자 인쇄여부 | boolean | - | true : (인쇄) / false : (미인쇄) 중 반환 |
32 | closeDownState | 공급받는자 휴폐업상태 | Integer | 1 | null : (미확인) / 0 : (미등록) / 1 : (사업중) / 2 : (폐업) / 3 : (휴업) 중 반환 |
33 | closeDownStateDate | 공급받는자 휴폐업일자 | string | 8 | 형식 : yyyyMMdd |
34 | trusteeCorpName | 수탁자 상호 | string | 200 | |
35 | trusteeCorpNum | 수탁자 사업자번호 | string | 10 | |
36 | trusteeMgtKey | 수탁자 문서번호 | string | 24 | 파트너가 할당한 문서번호 |
37 | trusteePrintYN | 수탁자 인쇄여부 | boolean | - | true : (인쇄) / false : (미인쇄) 중 반환 |
순번 | 변수명 | 항목명 | 타입 | 길이 | 비고 |
---|---|---|---|---|---|
1 | docLogType | 로그타입 | Integer | 3 |
100 : (임시저장) / 101 : (수정) / 102 : (개봉) / 103 : (수신확인)
111 : (메일 재전송) / 112 : (문자 재전송) / 113 : (팩스 재전송) / 122 : (문자 전송결과) 123 : (팩스 전송결과) / 124 : (휴폐업 확인) / 125 : (관리번호 할당) 220 : (역발행요청) / 221 : (역발행요청 거부) / 222 : (역발행요청 취소) / 230 : (발행) / 240 : (발행취소) 250 : (국세청전송 요청) / 251 : (국세청전송 대기중) / 252 : (국세청전송 진행중) 253 : (국세청전송 접수) / 254 : (국세청전송 성공) / 255 : (국세청전송 실패) 중 반환 |
2 | log | 이력정보 | string | 2000 | |
3 | procType | 처리형태 | string | 3 | "연동" : (API로 처리함) / "일반" : (팝빌 사이트에서 처리함) / "시스템" : (팝빌이 처리함) 중 반환 |
4 | procCorpName | 처리회사명 | string | 70 | |
5 | procContactName | 처리담당자 | string | 30 | |
6 | procMemo | 처리메모 | string | 200 | |
7 | regDT | 등록일시 | string | 14 | 형식 : yyyyMMddHHmmss |
8 | ip | 아이피 | string | 39 |
순번 | 변수명 | 항목명 | 타입 | 길이 | 비고 |
---|---|---|---|---|---|
1 | serialNum | 첨부파일 일련번호 | Integer | 1 | |
2 | attachedFile | 파일아이디 | string | 255 |
팝빌이 첨부파일 관리를 위해 할당한 식별번호
└ 함수 [4.4. DeleteFile – 첨부파일 삭제]호출을 위한 필수값 |
3 | displayName | 첨부파일명 | string | 255 | |
4 | regDT | 첨부일시 | string | 14 |
순번 | 변수명 | 항목명 | 타입 | 길이 | 비고 |
---|---|---|---|---|---|
1 | emailType | 메일전송유형 | string | - |
|
2 | sendYN | 전송여부 | Boolean | - | true : (전송) / false : (미전송) 중 반환 |
순번 | 변수명 | 항목명 | 타입 | 길이 | 비고 |
---|---|---|---|---|---|
1 | unitCost | 발행단가 | string | - | |
2 | chargeMethod | 과금유형 | string | - | "연동" / "파트너" 중 반환 |
3 | rateSystem | 과금제도 | string | - | "종량제" 반환 |
순번 | 변수명 | 항목명 | 타입 | 길이 | 필수 | 비고 |
---|---|---|---|---|---|---|
1 | ID | 아이디 | string | 50 | O | 6자 이상 50자 미만 |
2 | PWD | 비밀번호 | string | 20 | O | 6자 이상 20자 미만 |
3 | LinkID | 파트너 링크아이디 | string | 20 | O | 연동신청시 팝빌에서 발급받은 링크아이디 |
4 | CorpNum | 사업자번호 | string | 10 | O | 하이픈 '-' 제외 10자리 숫자값 |
5 | CEOName | 대표자 성명 | string | 200 | O | |
6 | CorpName | 회사명 | string | 200 | O | |
7 | Addr | 사업장 주소 | string | 300 | O | |
8 | BizType | 업태 | string | 100 | O | |
9 | BizClass | 종목 | string | 100 | O | |
10 | ContactName | 담당자 성명 | string | 100 | O | |
11 | ContactEmail | 담당자 이메일 | string | 100 | O | |
12 | ContactTEL | 담당자 연락처(전화번호) | string | 20 | O | |
13 | ContactHP | 담당자 휴대폰번호 | string | 20 | - | |
14 | ContactFAX | 담당자 팩스번호 | string | 20 | - |
순번 | 변수명 | 항목명 | 타입 | 길이 | 필수 | 비고 |
---|---|---|---|---|---|---|
1 | ceoname | 대표자 성명 | string | 100 | O | |
2 | corpName | 회사명 | string | 200 | O | |
3 | addr | 주소 | string | 300 | O | |
4 | bizType | 업태 | string | 100 | O | |
5 | bizClass | 종목 | string | 100 | O |
순번 | 변수명 | 항목명 | 타입 | 길이 | 필수 | 비고 |
---|---|---|---|---|---|---|
1 | id | 아이디 | string | 50 | O | 6자 이상 50자 미만 |
2 | pwd | 비밀번호 | string | 20 | △ | 담당자 추가시 필수, 6자 이상 20자 미만 |
3 | personName | 담당자 성명 | string | 100 | O | |
4 | tel | 담당자 연락처(전화번호) | string | 20 | O | |
5 | hp | 담당자 휴대폰번호 | string | 20 | - | |
6 | fax | 담당자 팩스번호 | string | 20 | - | |
7 | 담당자 이메일 | string | 100 | O | ||
8 | searchAllAllowYN | 담당자 조회권한 설정 | Boolean | - | O | true : (회사권한 - 모든 전자문서 관리가능) / false : (개인권한 - 해당 계정으로 작성한 전자문서만 관리가능) 중 입력 |
9 | mgrYN | 관리자 여부 | Boolean | - | O | true : (관리자) / false : (일반사용자) |
순번 | 변수명 | 항목명 | 타입 | 길이 | 필수 | 비고 |
---|---|---|---|---|---|---|
1 | id | 아이디 | string | 50 | O | 6자 이상 50자 미만 |
2 | personName | 담당자 성명 | string | 100 | O | |
3 | tel | 담당자 연락처(전화번호) | string | 20 | O | |
4 | hp | 담당자 휴대폰번호 | string | 20 | - | |
5 | fax | 담당자 팩스번호 | string | 20 | - | |
6 | 담당자 이메일 | string | 100 | O | ||
7 | regDT | 등록일시 | string | 14 | X | |
8 | searchAllAllowYN | 담당자 조회권한 설정 | Boolean | - | O | true : (회사권한 - 모든 전자문서 관리가능) / false : (개인권한 - 해당 계정으로 작성한 전자문서만 관리가능) 중 반환 |
9 | mgrYN | 관리자 여부 | Boolean | - | O |
true : (관리자) / false : (비관리자) 중 반환
※ 팝빌 사이트 [마이페이지] > [회사정보] > [담당자 관리]에서 수정 가능 |
10 | state | 상태 | integer | 1 | X | 0 : (승인대기 - 관리자의 승인 후 이용가능) / 1 : (사용중) 중 반환 |