API 레퍼런스  >  세금계산서 발행

(세금)계산서 대량 발행

여러건의 (세금)계산서를 센드빌에 등록 및 발행 요청합니다.

대량발행은 한 번에 최대 100건의 세금계산서를 전송할 수 있습니다.

POST https://dev.sendbill.co.kr:444/api/agent/document/registBulkDirect

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 documents ArrayList Y (세금)계산서 파라미터
documents
No 변수명 타입 길이 필수 설명 비고
1 billseq String 19 Y (세금)계산서 고유번호
2 svenderno String 10 Y 공급자사업자번호. '-' 없이 입력
3 rvenderno String 13 Y 공급받는자 사업자번호(주민등록번호)
4 dt String 10 Y 세금계산서 작성일 YYYY-MM-DD
5 supmoney String 13 Y 공급가 총액 기본값 : 0
6 taxmoney String 13 Y 세액 총액 기본값 : 0
7 taxrate ▲ String 1 과세구분 코드표 참고
↳ taxrate
코드 종류
0 과세율
1 영세율
2 면세율
3 매입세액불공제
4 의제매입
8 cash String 13 세금계산서상의 현금지급액 기본값 : 0
9 checks String 13 세금계산서상의 수표지급액 기본값 : 0
10 note String 13 세금계산서상의 어음지급액 기본값 : 0
11 credit String 13 세금계산서상의 외상미수금 기본값 : 0
12 gubun ▲ String 1 Y 청구구분 기본값 : 2
↳ gubun
코드 종류
1 영수
2 청구
13 bigo String 150 비고
14 billtype ▲ String 2 Y 세금계산서 종류 코드표 참고
↳ billtype
코드 종류
10 세금계산서
11 비회원 세금계산서
20 (면세)계산서
21 비회원 (면세)계산서
30 거래명세서
31 비회원 거래명세서
40 위수탁 세금계산서
41 비회원 위수탁 세금계산서
50 위수탁 (면세)계산서
51 비회원 위수탁 (면세)계산서
61 개인 매출 세금계산서
62 개인 매출 계산서
Y1 외부 매출 세금계산서
Z1 비회원 위수탁 (면세)계산서
15 scompany String 200 Y 공급자 업체명
16 sceoname String 100 Y 공급자 대표자명
17 suptae String 100 공급자 업태
18 supjong String 100 공급자 업종
19 saddress String 150 공급자 주소
20 saddress2 String 150 공급자 상세주소
21 suser String 100 공급자 담당자명
22 sdivision String 100 공급자 부서명
23 stelno String 20 공급자 전화번호 000-0000-0000
24 semail String 100 공급자 이메일주소
25 sreg_id String 4 공급자 종코드
26 rcompany String 200 Y 공급 받는자 업체명
27 rceoname String 100 Y 공급 받는자 대표자명
28 ruptae String 100 공급 받는자 업태
29 rupjong String 100 공급 받는자 업종
30 raddress String 150 공급 받는자 주소
31 raddress2 String 150 공급 받는자 상세주소
32 ruser String 100 공급 받는자 담당자명
33 rdivision String 100 공급 받는자 부서명
34 rtelno String 20 공급 받는자 전화번호 000-0000-0000
35 remail String 100 공급 받는자 이메일주소
36 rreg_id String 4 공급 받는자 종코드
37 report_amend_cd ▲ String 2 신고문서 수정사유코드 코드표 참고
↳ report_amend_cd
코드 종류
01 기재사항 착오/정정
02 공급가액 변동
03 환입
04 계약의 해제
05 내국신용장 사후 개설
06 착오에 의한 이중발행
38 report_except_yn String 1 Y 발행예정 여부 기본값 : N
39 book_no String 6 책번호
40 page_no String 6 호번호
41 serial_no String 25 일련번호
42 transyn String 1 전송여부 기본값 : N
43 reverseyn String 1 역발행여부 기본값 : N
44 sendid ▲ String 20 공급자 아이디 코드표 참고
↳ etc01
구분 정발행 매출 문서 역발행 매입 문서
S SENDID : 센드빌 ID SENDID : 센드빌 ID
I SENDID : 센드빌 ID SENDID : 거래처 ID
X SENDID : 거래처 ID SENDID : 거래처 ID
45 recvid ▲ String 20 공급받는자 아이디 코드표 참고
↳ etc01
구분 정발행 매출 문서 역발행 매입 문서
S RECVID : 센드빌 ID RECVID : 센드빌 ID
I RECVID : 거래처 ID RECVID : 센드빌 ID
X RECVID : 거래처 ID RECVID : 거래처 ID
46 user_set_div String 4 유저 검색 구분 코드
47 user_set_value String 50 유저 검색 값
48 test_yn String 1 테스트여부 기본값 : N
49 file_url String 250 첨부파일 URL
50 upbillseq String 50 상위문서 고유번호
51 close_dt String 8 역발행문서 전송가능일자 YYYYMMDD
52 ruser2 String 100 담당자2 이름
53 rtelno2 String 20 담당자2 전화번호 000-0000-0000
54 remail2 String 100 담당자2 이메일
55 saccount_no String 100 매출자계정코드
56 raccount_no String 50 매입자계정코드
57 etc01 ▲ String 10 ID 구분 코드표 참고
↳ etc01
구분 정발행 매출 문서 역발행 매입 문서
S SENDID : 센드빌 ID SENDID : 센드빌 ID
RECVID : 센드빌 ID RECVID : 센드빌 ID
I SENDID : 센드빌 ID SENDID : 거래처 ID
RECVID : 거래처 ID RECVID : 센드빌 ID
X SENDID : 거래처 ID SENDID : 거래처 ID
RECVID : 거래처 ID RECVID : 거래처 ID
58 etc03 String 10 비회원 자동가입 여부(Y/N) 기본값 : N
59 etc04 String 25 기타4
60 etc05 String 200 기타5
61 etc06 String 200 기타6
62 etc07 String 200 기타7
63 etc08 String 200 기타8
64 report_etc01 String 200 수정세금계산서 당초승인번호
65 report_etc02 String 200 국세청 신고 기타2
66 item ▲ ArrayList Y 품목 정보 최대 99개
↳ item
No 변수명 타입 길이 필수여부 설명 비고
1 tax String 13 Y 품목별세액
2 sup String 13 Y 품목별공급가액
3 danga String 18 단가
4 vlm String 12 수량
5 unit String 60 규격
6 obj String 100 품목명
7 dt String 10 Y 품목별 거래일자 YYYY-MM-DD
8 remark String 100 비고
67 broker ▲ Object △ 수탁자 정보
↳ broker
No 변수명 타입 길이 필수여부 설명 비고
1 venderno String 10 Y 사업자등록번호
2 reg_id String 4 reg_id
3 company String 200 Y 업체명
4 ceoname String 100 Y 대표자명
5 uptae String 100 업태
6 upjong String 100 업종
7 address String 150 주소
8 address2 String 150 상세주소
9 division String 100 부서명
10 users String 100 담당자명
11 telno String 20 전화번호 000-0000-0000
12 email String 100 이메일
13 nid String 20 연동ID
14 etc01 String 200 기타정보 01
15 etc02 String 200 기타정보 02
16 etc03 String 200 기타정보 03
17 etc04 String 200 기타정보 04
18 etc05 String 200 기타정보 05
Request JSON 샘플 ›
Request 항목 명세
POST https://api.sendbill.co.kr/api/agent/document/registBulkDirect

SBKEY: xxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json;charset=UTF-8
Accept-Charset: UTF-8			

Body
{
    "documents" : [
    {
	"billseq" : "seq20260611_01",
	"svenderno" : "1234567890",
	"rvenderno" : "1111111111",
	"reverseyn" : "N",
	"billtype" : "10",
	"dt" : "2026-06-11",
	"supmoney" : "11000",
	"taxmoney" : "1100",
	"gubun" : "2",
	"bigo" : "비고",
	"taxrate" : "0",
	"scompany" : "매출업체",
	"sceoname" : "매출테스트",
	"saddress" : "공급자 주소",
	"saddress2" : "공급자 상세주소",
	"suser" : "공급자 담당자",
	"sdivision" : "공급자 부서명",
	"rcompany" : "매입업체명",
	"rceoname" : "매입자 대표명",
	"stelno" : "010-1234-5678",
	"semail" : "test05@netmania.co.kr",
	"rtelno" : "010-1111-1111",
	"ruser" : "공급받는자 담당자",
	"rdivision" : "공급받는자 부서명",
	"raddress" : "공급 받는자 주소",
	"raddress2" : "공급 받는자 상세 주소",
	"remail" : "test050923@naver.com",
	"item" : [
            	    {"tax" : "550", "sup" : "5500", "dt" : "2026-06-11", "obj" : "품목1", "remark" : "품목 비고"},
            	    {"tax" : "550", "sup" : "5500", "dt" : "2026-06-11", "obj" : "품목2", "remark" : "품목 비고"}
         	 ]
    },
    {
	"billseq" : "seq20260611_02",
	"svenderno" : "1234567890",
	"rvenderno" : "1111111111",
	"reverseyn" : "N",
	"billtype" : "10",
	"dt" : "2026-06-11",
	"supmoney" : "11000",
	"taxmoney" : "1100",
	"gubun" : "2",
	"bigo" : "비고",
	"taxrate" : "0",
	"scompany" : "매출업체",
	"sceoname" : "매출테스트",
	"saddress" : "공급자 주소",
	"saddress2" : "공급자 상세주소",
	"suser" : "공급자 담당자",
	"sdivision" : "공급자 부서명",
	"rcompany" : "매입업체명",
	"rceoname" : "매입자 대표명",
	"stelno" : "010-1234-5678",
	"semail" : "test05@netmania.co.kr",
	"rtelno" : "010-1111-1111",
	"ruser" : "공급받는자 담당자",
	"rdivision" : "공급받는자 부서명",
	"raddress" : "공급 받는자 주소",
	"raddress2" : "공급 받는자 상세 주소",
	"remail" : "test050923@naver.com",
	"item" : [
            	    {"tax" : "550", "sup" : "5500", "dt" : "2026-06-11", "obj" : "품목1", "remark" : "품목 비고"},
            	    {"tax" : "550", "sup" : "5500", "dt" : "2026-06-11", "obj" : "품목2", "remark" : "품목 비고"}
         	 ]
    }
    ]
}

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 Success int 성공건수
2 Fail int 실패건수
3 Error ▲ ArrayList 오류정보
↳ Error
No 변수명 타입 설명
1 billseq String (세금)계산서 고유번호
2 err_code String 오류코드
3 err_mesg String 오류메시지
Response JSON 샘플 › 
{
    "Success" : 0,
    "Fail" : 2,
    "Error" : [
	{
	    "billseq": "seq20260611_01",
	    "err_code": -12101,
	    "err_mesg": "[Billseq] 데이터가 중복되었습니다."
	},
	{
	    "billseq": "seq20260611_02",
	    "err_code": -12101,
	    "err_mesg": "[Billseq] 데이터가 중복되었습니다."
	}
    ]
}