since now

나이스빌 개발자 BOOK

업무 단축을 위한 편리하고 신속한 개발 가이드를 제공합니다.

개발을 위한 개발계 주소를 원하시면 를 통하여 언제든 말씀하세요!

개발 테스트를 시작하기에 앞서 회원가입 전 필수로 진행하셔야 하는 부분을 확인 바랍니다.

  • 1. API 신규 연동 업체의 사용 유형에 따른 표준업무 신청
    • 계산서 사용 후 차감 방식 (선발행 후 정산, 포인트 차감 등)
    • 발행 후 안내 메시지 발송 여부 및 차감 방식 (알림톡, LMS 등)
    • 나이스빌 웹 서비스 접속 및 사용 여부
    • 부가서비스 사용 여부 (메시지, 거래명세서, FAX, 예금주 성명 조회 등)
  • 2. API 신규 연동 업체에서 사용할 링크코드 (Link Code)
    • 대문자 영문 3자리 구성 (OOO_ID 생성), 중복일 시 미리 알려드립니다.
  • 3. 위/수탁 전자(세금)계산서 사용 여부

개발서버 토큰 문의는 euni0003@nicednr.co.kr 로 문의주시길 바랍니다.

설명

데이터 조회 전 보안 토큰 생성을 위한 인증토큰 생성

  • API키는 하나의 링크코드(고객사)마다 부여됩니다.
  • 리프레시 토큰은 유효기간이 1년이며, 고객사마다 다르게 설정할 수 있습니다.
  • 엑세스 토큰은 유효기간이 1시간이며, 고객사마다 다르게 설정할 수 있습니다.

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/token/issue
  • 운영: https://api.nicebill.co.kr/token/issue

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 연계사 회원 ID linkId 1 String O
3 연계사 회원 사업자번호 bizNo 1 String O 하이픈('-') 제거

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "linkId": "titester"
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O
3 접근토큰 data accessToken 1 String O 만료시간 : 1시간
- 1시간은 권장, 지정 필요
4 재발급토큰 refreshToken 1 String O 만료시간 : 10년
- 10년은 권장, 지정 필요
5 접근토큰 만료일시 exprDttmAT 1 String O YYYYMMDDHH24MISS
6 재발급토큰 만료일시 exprDttmRT 1 String O YYYYMMDDHH24MISS

응답 데이터 예시

{
  "resultCd": "0000",
  "resultMsg": "",
  "data": {		
    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzXDsic-6sBi4...",
    "refreshToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiO...",
    "exprDttmAT": "20241211163033",
    "exprDttmRT": "20341211163638"
  }
}

설명

리프레시 토큰 재발급

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/token/refresh
  • 운영: https://api.nicebill.co.kr/token/refresh

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 연계사 회원 ID linkId 1 String O
3 연계사 회원 사업자번호 bizNo 1 String O 하이픈('-') 제거

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "linkId": "titester"
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O
3 접근토큰 data accessToken 1 String O
4 토큰 만료일시 exprDttmAT 1 String O YYYYMMDHH24MISS

응답 데이터 예시

{
  "resultCd": "0000",
  "resultMsg": "",
  "data": {
    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzXDsic-6sBi4...",
    "refreshToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiO….",
    "exprDttmAT": "20241211163033",
    "exprDttmRT": "20341211163638"
  }
}

설명

데이터 조회에 필요한 엑세스 토큰 재발급

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/token/access
  • 운영: https://api.nicebill.co.kr/token/access

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 연계사 회원 ID linkId 1 String O
3 연계사 회원 사업자번호 bizNo 1 String O 하이픈('-') 제거

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "linkId": "titester"
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O
3 접근토큰 data accessToken 1 String O
4 토큰 만료일시 exprDttmAT 1 String O YYYYMMDHH24MISS

응답 데이터 예시

{
  "resultCd": "0000",
  "resultMsg": "",
  "data": {
    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzXDsic-6sBi4...",
    "refreshToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiO….",
    "exprDttmAT": "20241211163033",
    "exprDttmRT": "20341211163638"
  }
}

설명

API 조회를 이용해 사업자 과세유형을 조회 (100건 이하)

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/business/status
  • 운영: https://api.nicebill.co.kr/business/status

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 연계사 회원 ID linkId 1 String O
3 연계사 회원 사업자번호 bizNo 1 String O 하이픈('-') 제거
4 조회 사업자번호 bizNoList 1 List O 하이픈('-') 제거
ex) ["1078708207", "1234567890", … ]

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "membId": "titester",
  "bizNoList": [
    "0000000000",
    "1234567890"
  ]
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O
3 과세유형조회
결과코드		 data dataCode 1 String O
4 사업자번호 bizNo 1 String O 하이픈('-') 제거
5 폐업일자 closeDt 1 String O YYYYMMDD
6 과세유형변경일자 changeDt 1 String O YYYYMMDD
7 과세유형조회일자 searchDt 1 String O YYYYMMDD
8 과세유형명 taxTypeNm 1 String O
9 과세유형 txtnCls 1 String O
10 과세유형-상세 txtnCls2 1 String O
11 세금계산서 적용일자 invoiceApplyDt 1 String YYYYMMDD

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상",
  "data": [
    {
      "bizNo": "0000000000",
      "closeDt": "",
      "changeDt": "",
      "searchDt": "2024XXXX",
      "taxTypeNm": "부가가치세 일반과세자",
      "txtnCls": "1",
      "txtnCls2": "1",
      "dataCode": "0000",
      "invoiceApplyDt": ""
    },
    {
      "bizNo": "1234567890",
      "closeDt": "",
      "changeDt": "",
      "searchDt": "2024XXXX",
      "taxTypeNm": "부가가치세 간이과세자",
      "txtnCls": "2",
      "txtnCls2": "2",
      "dataCode": "0000",
      "invoiceApplyDt": ""
    },
    {
      ...
    },
}

설명

회원 가입

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/member/join
  • 운영: https://api.nicebill.co.kr/member/join

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 사업자번호 bizNo 1 String O 하이픈('-') 제거 필요
3 회원아이디 linkId 1 String O
4 회사명 custName 1 String O
5 대표자명 ownerName 1 String O
6 업태 bizCond String
7 종목 bizItem String
8 담당자명 membName 1 String O
9 이메일 email 1 String O 이메일 형식
10 전화번호 telNo String 숫자만 입력
11 휴대폰번호 hpNo String 숫자만 입력
12 우편번호 zipCode String
13 주소 (기본) addr1 String
14 주소 (상세) addr2 String

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1214567812",
  "linkId": "TST_user12312122",
  "custName": "Test Company",
  "ownerName": "대표자",
  "bizCond": "업태",
  "bizItem": "종목",
  "membName": "담당자명",
  "email": "email@co.kr",
  "telNo": "020000000",
  "hpNo": "0100000000",
  "zipCode": "55631",
  "addr1": "서울특별시",
  "addr2": "강남구" 
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O
3 클라이언트 번호 data clientNo 1 String O
4 회원아이디 linkId 1 String O 연계코드 및 회원ID 조합 (예: TST_user1)

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상적으로 처리되었습니다.",
  "data": {
    "clientNo": "0001489166",
    "linkId": "TST_user1231212"
  }
}

설명

회원 수정

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/member/update
  • 운영: https://api.nicebill.co.kr/member/update

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 사업자번호 bizNo 1 String O 하이픈('-') 제거 필요
3 회원아이디 linkId 1 String O
4 회사명 custName 1 String
5 대표자명 ownerName 1 String
6 업태 bizCond String
7 종목 bizItem String
8 담당자명 membName 1 String
9 이메일 email 1 String 이메일 형식
10 전화번호 telNo String 숫자만 입력
11 휴대폰번호 hpNo String 숫자만 입력
12 우편번호 zipCode String
13 주소 (기본) addr1 String
14 주소 (상세) addr2 String

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1214567812",
  "linkId": "TST_user12312122",
  "custName": "Test Company",
  "ownerName": "대표자",
  "bizCond": "업태",
  "bizItem": "종목",
  "membName": "담당자명",
  "email": "email@co.kr",
  "telNo": "020000000",
  "hpNo": "0100000000",
  "zipCode": "55631",
  "addr1": "서울특별시",
  "addr2": "강남구" 
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상적으로 처리되었습니다."
}

설명

회원 조회

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/member/info
  • 운영: https://api.nicebill.co.kr/member/info

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 사업자번호 bizNo 1 String O 하이픈('-') 제거 필요
3 회원아이디 linkId 1 String O

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1214567812",
  "linkId": "TST_user12312122"
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O
3 회원아이디 data linkId 1 String O 연계코드 및 회원ID 조합
4 담당자명 membName 1 String O
5 회사명 custName 1 String O
6 대표자명 ownerName 1 String O
7 업태 bizCond String O
8 종목 bizItem String O
9 대표자명 ownerName 1 String O
10 이메일 email 1 String O 이메일 형식
11 전화번호 telNo String O 숫자만 입력
12 휴대폰번호 hpNo String O 숫자만 입력
13 우편번호 zipCode String O
14 주소 (기본) addr1 String O
15 주소 (상세) addr2 String O

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상적으로 처리되었습니다.",
  "data": {
    "linkId": "TST_user12312122",
    "membName": "담당자명",
    "custName": "Test Company",
    "bizNo": "1214567812",
    "bizCond": "업태",
    "bizItem": "종목",
    "ownerName": "대표자",
    "email": "email@co.kr",
    "telNo": "020000000",
    "hpNo": "0100000000",
    "zipCode": "55631",
    "addr1": "서울특별시",
    "addr2": "강남구"
  }
}

설명

인증서 등록 URL 조회

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/certificate/register
  • 운영: https://api.nicebill.co.kr/certificate/register

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 사업자번호 bizNo 1 String O 하이픈('-') 제거 필요
3 회원아이디 linkId 1 String O
4 결과 반환 URL returnURL 1 String 결과 반환 URL이 있을 경우 인증서 등록/갱신 시 아래의 내용 반환
  • frnNo: 고객사코드
  • userId: 사용자ID
  • certPw: 공인인증서 비밀번호
  • expireDt: 공인인증서 유효기간

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "linkId": "titester",
  "returnURL": "https://dev.nicebill.co.kr/returnURL"
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O
3 인증서 등록 URL data registrationUrl 1 String O

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상적으로 처리되었습니다.",
  "data": {
    "registrationUrl": "https://dev.nicebill.co.kr/ti/TI_80101.do?frnNo=33110A0E06260F1F360E&userId=1E232704230B0507&passwd=29200459301039510D18263B345821763B1507113131085D0D1E11230B451C0A1130050008042D300018203D023C31212D0312051F0617582C253F3826211C0A&linkCd=274A1E&retUrl=623C2734237F434A0B1D22415E38052B0A3E27274B03284725057C1B1A3A2A0F60365E58"
  }
}

설명

인증서 정보 조회

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/certificate/info
  • 운영: https://api.nicebill.co.kr/certificate/info

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 사업자번호 bizNo 1 String O 하이픈('-') 제거 필요
3 회원아이디 linkId 1 String O

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "linkId": "titester"
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O
3 사업자번호 data bizNo 1 String O
4 유효 기간 availableTerm 1 String O
5 연계코드 linkCode 1 String O
6 마지막 변경 일시 changeDateTime 1 String O

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상적으로 처리되었습니다.",
  "data": {
    "bizNo": "1234567890",
    "availableTerm": "20250706",
    "linkCode": "TST",
    "changeDateTime": "2025-03-18 17:03:37.0"
  }
}

설명

포인트 정보 조회

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/point/info
  • 운영: https://api.nicebill.co.kr/point/info

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 사업자번호 bizNo 1 String O 하이픈('-') 제거 필요
3 회원아이디 linkId 1 String O

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "linkId": "titester"
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O
3 보너스포인트 data gnlPoint 1 String O 포인트 회원사인 경우
4 일반포인트 bnsPoint 1 String O
5 포인트 합계 totPoint 1 String O

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상적으로 처리되었습니다.",
  "data": {
    "gnlPoint": 1372570,
    "bnsPoint": 0,
    "totPoint": 1372570
  }
}

설명

(세금)계산서 즉시발행

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/invoice/issue
  • 운영: https://api.nicebill.co.kr/invoice/issue

요청 정보

No Name Element0 Element1 Element2 Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 사업자번호 bizNo 1 String O 하이픈('-') 제거 필요
3 회원아이디 linkId 1 String O
4 발행 건수 issueCount 1 Number O
5 ERP 번호 (고객사 ID) taxInvoice erpBillNo 1 String O
6 (세금)계산서 유형 코드 typeCode 1 String O
7 발행유형 issueCls 1 String O
8 거래일자(공급일자) issueDate 1 String O
9 영수/청구 코드 purposeCode 1 String O
10 공급가액 합계 supplyCostTotal 1 String O
11 세액 합계 taxTotal String
12 현금 cash String
13 수표 chk String
14 어음 pro String
15 외상미수금 credit String
16 메일 전송 여부 sendMail Boolean 기본값: true
17 메시지 전송 여부 sendMessage Boolean 기본값: false
18 수정사유 코드 chngReasonCode String 수정 (세금)계산서 필수
19 당초 승인번호 orgApprNo String 수정 (세금)계산서 필수
20 공급자 사업자번호 invoicerBizNo 1 String O
21 공급자 상호 invoicerBizName 1 String O
22 공급자 업종 invoicerBizItem String
23 공급자 업태 invoicerBizCode String
24 공급자 대표자명 invoicerCEOName 1 String O
25 공급자 담당자명 invoicerContactName String
26 공급자 이메일 invoicerEmail String
27 공급자 주소 invoicerAddr String
28 공급자 부서명 invoicerDeptName String
29 공급자 전화번호 invoicerTEL String
30 공급자 휴대폰번호 invoicerHP String
31 공급자 종사업장번호 invoicerTaxSubNo String
32 공급자 이메일 리스트 invoicerEmailList String 역발행 시 사용, 최대 5개
33 공급받는자 사업자번호 invoiceeBizNo 1 String O
34 공급받는자 상호 invoiceeBizName 1 String O
35 공급받는자 업종 invoiceeBizItem String
36 공급받는자 업태 invoiceeBizCode String
37 공급받는자 대표자명 invoiceeCEOName 1 String O
38 공급받는자 담당자명 invoiceeContactName String
39 공급받는자 이메일 invoiceeEmail String
40 공급받는자 주소 invoiceeAddr String
41 공급받는자 부서명 invoiceeDeptName String
42 공급받는자 전화번호 invoiceeTEL String
43 공급받는자 휴대폰번호 invoiceeHP String
44 공급받는자 종사업장번호 invoiceeTaxSubNo String
45 공급받는자
이메일 리스트		 invoiceeEmailList String 정발행 시 사용, 최대 5개
46 수탁자 사업자번호 trusteeBizNo String 위수탁 (세금)계산서 필수
47 수탁자 상호 trusteeBizName String 위수탁 (세금)계산서 필수
48 수탁자 업종 trusteeBizItem String 위수탁 (세금)계산서
49 수탁자 업태 trusteeBizCode String 위수탁 (세금)계산서
50 수탁자 대표자명 trusteeCEOName String 위수탁 (세금)계산서 필수
51 수탁자 담당자명 trusteeContactName String 위수탁 (세금)계산서
52 수탁자 이메일 trusteeEmail String 위수탁 (세금)계산서
53 수탁자 주소 trusteeAddr String 위수탁 (세금)계산서
54 수탁자 부서명 trusteeDeptName String 위수탁 (세금)계산서
55 수탁자 전화번호 trusteeTEL String 위수탁 (세금)계산서
56 수탁자 휴대폰번호 trusteeHP String 위수탁 (세금)계산서
57 수탁자 종사업장번호 trusteeTaxSubNo String 위수탁 (세금)계산서
58 품목 순번 detailList itemSeq 1 String O
59 품묵 공급일자 itemPurchaseDate 1 String O
60 품목 공급가액 itemSupAmount 1 String O
61 품목 부가세액 itemVatAmount 1 String O
62 품목 수량 itemQty String
63 품목 규격(단위) itemStandard String
64 품목명 itemName String
65 품목 단가 itemUnitAmount String
66 품목 비고 itemRemark String

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "linkId": "titester",
  "issueCount": 4,
  "taxInvoice": [
  {
    "erpBillNo": "ERP1234570",
    "typeCode": "0101",
    "issueCls": "001",
    "issueDate": "20240205",
    "purposeCode": "01",
    "supplyCostTotal": "100000",
    "taxTotal": "10000",
    "invoicerBizNo": "1234567890",
    "invoicerBizName": "공급자 회사",
    "invoicerBizItem": "도매업",
    "invoicerBizCode": "001",
    "invoicerCEOName": "공급자 대표",
    "invoicerContactName": "공급자 담당자",
    "invoicerEmail": "invoicer@example.com",
    "invoiceeBizNo": "9876543210",
    "invoiceeBizName": "공급받는자 회사",
    "invoiceeBizItem": "소매업",
    "invoiceeBizCode": "002",
    "invoiceeCEOName": "공급받는자 대표",
    "invoiceeContactName": "공급받는자 담당자",
    "invoiceeEmailList": ["invoicee@example.com"],
    "sendMail": true,
    "sendMessage": true,
    "detailList": [
      {
        "itemSeq": "1",
        "itemPurchaseDate": "20240204",
        "itemSupAmount": "100000",
        "itemVatAmount": "10000",
        "itemQty": "2",
        "itemStandard": "박스",
        "itemName": "상품A",
        "itemUnitAmount": "25000",
        "itemRemark": "테스트 품목"
      }
    ]
  },
  {
    "erpBillNo": "ERP1234561",
    "typeCode": "0201",
    "issueCls": "001",
    "issueDate": "20240401",
    "purposeCode": "02",
    "supplyCostTotal": "150000",
    "taxTotal": "15000",
    "orgApprNo": "20250228410000400000000e",
    "chngReasonCode": "01",
    "invoicerBizNo": "1234567890",
    "invoicerBizName": "공급자 회사",
    "invoicerBizItem": "제조업",
    "invoicerBizCode": "003",
    "invoicerCEOName": "공급자 대표",
    "invoicerContactName": "공급자 담당자",
    "invoicerEmail": "invoicer@example.com",
    "invoiceeBizNo": "9876543210",
    "invoiceeBizName": "공급받는자 회사",
    "invoiceeBizItem": "서비스업",
    "invoiceeBizCode": "004",
    "invoiceeCEOName": "공급받는자 대표",
    "invoiceeContactName": "공급받는자 담당자",
    "invoiceeEmailList": ["invoicee@example.com"],
    "sendMail": true,
    "sendMessage": true,
    "detailList": [
        {
          "itemSeq": "1",
          "itemPurchaseDate": "20240401",
          "itemSupAmount": "150000",
          "itemVatAmount": "15000",
          "itemQty": "2",
          "itemStandard": "개",
          "itemName": "상품B",
          "itemUnitAmount": "37500",
          "itemRemark": "수정 세금계산서 품목"
        }
      ]
    },
  {
    "erpBillNo": "ERP1234562",
    "typeCode": "0103",
    "issueCls": "001",
    "issueDate": "20240205",
    "purposeCode": "01",
    "supplyCostTotal": "120000",
    "taxTotal": "12000",
    "invoicerBizNo": "1234567890",
    "invoicerBizName": "공급자 회사",
    "invoicerBizItem": "건설업",
    "invoicerBizCode": "005",
    "invoicerCEOName": "공급자 대표",
    "invoicerContactName": "공급자 담당자",
    "invoicerEmail": "invoicer@example.com",
    "invoiceeBizNo": "9876543210",
    "invoiceeBizName": "공급받는자 회사",
    "invoiceeBizItem": "물류업",
    "invoiceeBizCode": "006",
    "invoiceeCEOName": "공급받는자 대표",
    "invoiceeContactName": "공급받는자 담당자",
    "invoiceeEmailList": ["invoicee@example.com"],
    "trusteeBizNo": "1234567890",
    "trusteeBizName": "위수탁 회사",
    "trusteeCEOName": "위수탁 대표",
    "trusteeContactName": "위수탁 담당자",
    "trusteeEmail": "trustee@example.com",
    "sendMail": true,
    "sendMessage": true,
    "detailList": [
        {
          "itemSeq": "1",
          "itemPurchaseDate": "20240204",
          "itemSupAmount": "120000",
          "itemVatAmount": "12000",
          "itemQty": "2",
          "itemStandard": "톤",
          "itemName": "상품C",
          "itemUnitAmount": "30000",
          "itemRemark": "위수탁 품목"
        }
      ]
    },
    {
      "erpBillNo": "ERP1234563",
      "typeCode": "0301",
      "issueCls": "001",
      "issueDate": "20240205",
      "purposeCode": "02",
      "supplyCostTotal": "70000",
      "taxTotal": "0",
      "invoicerBizNo": "1234567890",
      "invoicerBizName": "공급자 회사",
      "invoicerBizItem": "유통업",
      "invoicerBizCode": "007",
      "invoicerCEOName": "공급자 대표",
      "invoicerContactName": "공급자 담당자",
      "invoicerEmail": "invoicer@example.com",
      "invoiceeBizNo": "9876543210",
      "invoiceeBizName": "공급받는자 회사",
      "invoiceeBizItem": "교육업",
      "invoiceeBizCode": "008",
      "invoiceeCEOName": "공급받는자 대표",
      "invoiceeContactName": "공급받는자 담당자",
      "invoiceeEmailList": ["invoicee@example.com"],
      "sendMail": true,
      "sendMessage": true,
      "detailList": [
        {
          "itemSeq": "1",
          "itemPurchaseDate": "20240204",
          "itemSupAmount": "70000",
          "itemVatAmount": "0",
          "itemQty": "1",
          "itemStandard": "세트",
          "itemName": "상품D",
          "itemUnitAmount": "70000",
          "itemRemark": "계산서 테스트 품목"
        }
      ]
    }
  ]
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O
3 연계코드 linkCd 1 String O
4 요청 건수 requestCount 1 String O
5 성공 건수 successCount 1 String O
6 실패 건수 failureCount 1 String O
7 ERP 번호(고객사 ID) issueResults erpBillNo 1 String O
8 개별 결과코드 code 1 String O
9 개별 결과메세지 message 1 String O
10 승인번호 apprNo 1 String O 발행 성공시
11 발행시각 issueDateTime 1 String O 발행 성공시
12 보너스포인트 gnlPoint 1 String O 포인트 회원사인 경우
13 일반포인트 bnsPoint 1 String O 포인트 회원사인 경우
14 포인트 합계 totPoint 1 String O 포인트 회원사인 경우

응답 데이터 예시

{
  "resultCode": "101",
  "resultMsg": "일부 세금계산서 발행에 실패하였습니다.",
  "linkId": "titester",
  "requestCount": 4,
  "successCount": 3,
  "failureCount": 1,
  "issueResults": [
    {
      "erpBillNo": "ERP1234560",
      "code": "0000",
      "message": "정상적으로 처리되었습니다.",
      "apprNo": "2024020541000040000001b2",
      "issueDateTime": "2025-04-01 15:36:13"
    },
    {
      "erpBillNo": "ERP1234561",
      "code": "8102",
      "message": "계산서 공급가액과 품목의 공급가액의 합계가 일치해야 합니다."
    },
    {
      "erpBillNo": "ERP1234562",
      "code": "0000",
      "message": "정상적으로 처리되었습니다.",
      "apprNo": "2024020541000040000001b3",
      "issueDateTime": "2025-04-01 15:36:13"
    },
    {
      "erpBillNo": "ERP1234563",
      "code": "0000",
      "message": "정상적으로 처리되었습니다.",
      "apprNo": "2024020541000040000001b4",
      "issueDateTime": "2025-04-01 15:36:14"
    }
  ]
}

설명

(세금)계산서 익일 발행

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/invoice/issue-next-day
  • 운영: https://api.nicebill.co.kr/invoice/issue-next-day

요청 정보

No Name Element0 Element1 Element2 Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 사업자번호 bizNo 1 String O 하이픈('-') 제거 필요
3 회원아이디 linkId 1 String O
4 발행 건수 issueCount 1 Number O
5 ERP 번호(고객사 ID) taxInvoice erpBillNo 1 String O
6 (세금)계산서 유형 코드 typeCode 1 String O 4자리 숫자(코드표 참고)
7 발행유형 issueCls 1 String O
8 거래일자(공급일자) issueDate 1 String O
9 영수/청구 코드 purposeCode 1 String O
10 공급가액 합계 supplyCostTotal 1 String O
11 세액 합계 taxTotal String
12 현금 cash String
13 수표 chk String
14 어음 pro String
15 외상미수금 credit String
16 메일 전송 여부 sendMail Boolean 기본값: true
17 메시지 전송 여부 sendMessage Boolean 기본값: false
18 수정사유 코드 chngReasonCode String 수정 (세금)계산서 필수
19 당초 승인번호 orgApprNo String 수정 (세금)계산서 필수
20 공급자 사업자번호 invoicerBizNo 1 String O
21 공급자 상호 invoicerBizName 1 String O
22 공급자 업종 invoicerBizItem String
23 공급자 업태 invoicerBizCode String
24 공급자 대표자명 invoicerCEOName 1 String O
25 공급자 담당자명 invoicerContactName String
26 공급자 이메일 invoicerEmail String
27 공급자 주소 invoicerAddr String
28 공급자 부서명 invoicerDeptName String
29 공급자 전화번호 invoicerTEL String
30 공급자 휴대폰번호 invoicerHP String
31 공급자 종사업장번호 invoicerTaxSubNo String
32 공급자 이메일 리스트 invoicerEmailList String 역발행 시 사용, 최대 5개
33 공급받는자 사업자번호 invoiceeBizNo 1 String O
34 공급받는자 상호 invoiceeBizName 1 String O
35 공급받는자 업종 invoiceeBizItem String
36 공급받는자 업태 invoiceeBizCode String
37 공급받는자 대표자명 invoiceeCEOName 1 String O
38 공급받는자 담당자명 invoiceeContactName String
39 공급받는자 이메일 invoiceeEmail String
40 공급받는자 주소 invoiceeAddr String
41 공급받는자 부서명 invoiceeDeptName String
42 공급받는자 전화번호 invoiceeTEL String
43 공급받는자 휴대폰번호 invoiceeHP String
44 공급받는자 종사업장번호 invoiceeTaxSubNo String
45 공급받는자
이메일 리스트		 invoiceeEmailList String 정발행 시 사용, 최대 5개
46 수탁자 사업자번호 trusteeBizNo String 위수탁 (세금)계산서 필수
47 수탁자 상호 trusteeBizName String 위수탁 (세금)계산서 필수
48 수탁자 업종 trusteeBizItem String 위수탁 (세금)계산서
49 수탁자 업태 trusteeBizCode String 위수탁 (세금)계산서
50 수탁자 대표자명 trusteeCEOName String 위수탁 (세금)계산서 필수
51 수탁자 담당자명 trusteeContactName String 위수탁 (세금)계산서
52 수탁자 이메일 trusteeEmail String 위수탁 (세금)계산서
53 수탁자 주소 trusteeAddr String 위수탁 (세금)계산서
54 수탁자 부서명 trusteeDeptName String 위수탁 (세금)계산서
55 수탁자 전화번호 trusteeTEL String 위수탁 (세금)계산서
56 수탁자 휴대폰번호 trusteeHP String 위수탁 (세금)계산서
57 수탁자 종사업장번호 trusteeTaxSubNo String 위수탁 (세금)계산서
58 품목 순번 detailList itemSeq 1 String O
59 품묵 공급일자 itemPurchaseDate 1 String O
60 품목 공급가액 itemSupAmount 1 String O
61 품목 부가세액 itemVatAmount 1 String O
62 품목 수량 itemQty String
63 품목 규격(단위) itemStandard String
64 품목명 itemName String
65 품목 단가 itemUnitAmount String
66 품목 비고 itemRemark String

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "linkId": "titester",
  "issueCount": 4,
  "taxInvoice": [
    {
      "erpBillNo": "ERP1234570",
      "typeCode": "0101",
      "issueCls": "001",
      "issueDate": "20240205",
      "purposeCode": "01",
      "supplyCostTotal": "100000",
      "taxTotal": "10000",
      "invoicerBizNo": "1234567890",
      "invoicerBizName": "공급자 회사",
      "invoicerBizItem": "도매업",
      "invoicerBizCode": "001",
      "invoicerCEOName": "공급자 대표",
      "invoicerContactName": "공급자 담당자",
      "invoicerEmail": "invoicer@example.com",
      "invoiceeBizNo": "9876543210",
      "invoiceeBizName": "공급받는자 회사",
      "invoiceeBizItem": "소매업",
      "invoiceeBizCode": "002",
      "invoiceeCEOName": "공급받는자 대표",
      "invoiceeContactName": "공급받는자 담당자",
      "invoiceeEmailList": ["invoicee@example.com"],
      "sendMail": true,
      "sendMessage": true,
      "detailList": [
        {
          "itemSeq": "1",
          "itemPurchaseDate": "20240204",
          "itemSupAmount": "100000",
          "itemVatAmount": "10000",
          "itemQty": "2",
          "itemStandard": "박스",
          "itemName": "상품A",
          "itemUnitAmount": "25000",
          "itemRemark": "테스트 품목"
        }
      ]
    },
    {
      "erpBillNo": "ERP1234561",
      "typeCode": "0201",
      "issueCls": "001",
      "issueDate": "20240401",
      "purposeCode": "02",
      "supplyCostTotal": "150000",
      "taxTotal": "15000",
      "orgApprNo": "20250228410000400000000e",
      "chngReasonCode": "01",
      "invoicerBizNo": "1234567890",
      "invoicerBizName": "공급자 회사",
      "invoicerBizItem": "제조업",
      "invoicerBizCode": "003",
      "invoicerCEOName": "공급자 대표",
      "invoicerContactName": "공급자 담당자",
      "invoicerEmail": "invoicer@example.com",
      "invoiceeBizNo": "9876543210",
      "invoiceeBizName": "공급받는자 회사",
      "invoiceeBizItem": "서비스업",
      "invoiceeBizCode": "004",
      "invoiceeCEOName": "공급받는자 대표",
      "invoiceeContactName": "공급받는자 담당자",
      "invoiceeEmailList": ["invoicee@example.com"],
      "sendMail": true,
      "sendMessage": true,
      "detailList": [
        {
          "itemSeq": "1",
          "itemPurchaseDate": "20240401",
          "itemSupAmount": "150000",
          "itemVatAmount": "15000",
          "itemQty": "2",
          "itemStandard": "개",
          "itemName": "상품B",
          "itemUnitAmount": "37500",
          "itemRemark": "수정 세금계산서 품목"
        }
      ]
    },
    {
      "erpBillNo": "ERP1234562",
      "typeCode": "0103",
      "issueCls": "001",
      "issueDate": "20240205",
      "purposeCode": "01",
      "supplyCostTotal": "120000",
      "taxTotal": "12000",
      "invoicerBizNo": "1234567890",
      "invoicerBizName": "공급자 회사",
      "invoicerBizItem": "건설업",
      "invoicerBizCode": "005",
      "invoicerCEOName": "공급자 대표",
      "invoicerContactName": "공급자 담당자",
      "invoicerEmail": "invoicer@example.com",
      "invoiceeBizNo": "9876543210",
      "invoiceeBizName": "공급받는자 회사",
      "invoiceeBizItem": "물류업",
      "invoiceeBizCode": "006",
      "invoiceeCEOName": "공급받는자 대표",
      "invoiceeContactName": "공급받는자 담당자",
      "invoiceeEmailList": ["invoicee@example.com"],
      "trusteeBizNo": "1234567890",
      "trusteeBizName": "위수탁 회사",
      "trusteeCEOName": "위수탁 대표",
      "trusteeContactName": "위수탁 담당자",
      "trusteeEmail": "trustee@example.com",
      "sendMail": true,
      "sendMessage": true,
      "detailList": [
        {
          "itemSeq": "1",
          "itemPurchaseDate": "20240204",
          "itemSupAmount": "120000",
          "itemVatAmount": "12000",
          "itemQty": "2",
          "itemStandard": "톤",
          "itemName": "상품C",
          "itemUnitAmount": "30000",
          "itemRemark": "위수탁 품목"
        }
      ]
    },
    {
      "erpBillNo": "ERP1234563",
      "typeCode": "0301",
      "issueCls": "001",
      "issueDate": "20240205",
      "purposeCode": "02",
      "supplyCostTotal": "70000",
      "taxTotal": "0",
      "invoicerBizNo": "1234567890",
      "invoicerBizName": "공급자 회사",
      "invoicerBizItem": "유통업",
      "invoicerBizCode": "007",
      "invoicerCEOName": "공급자 대표",
      "invoicerContactName": "공급자 담당자",
      "invoicerEmail": "invoicer@example.com",
      "invoiceeBizNo": "9876543210",
      "invoiceeBizName": "공급받는자 회사",
      "invoiceeBizItem": "교육업",
      "invoiceeBizCode": "008",
      "invoiceeCEOName": "공급받는자 대표",
      "invoiceeContactName": "공급받는자 담당자",
      "invoiceeEmailList": ["invoicee@example.com"],
      "sendMail": true,
      "sendMessage": true,
      "detailList": [
        {
          "itemSeq": "1",
          "itemPurchaseDate": "20240204",
          "itemSupAmount": "70000",
          "itemVatAmount": "0",
          "itemQty": "1",
          "itemStandard": "세트",
          "itemName": "상품D",
          "itemUnitAmount": "70000",
          "itemRemark": "계산서 테스트 품목"
        }
      ]
    }
  ]
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O
3 연계코드 linkCd 1 String O
4 요청 건수 requestCount 1 String O
5 성공 건수 successCount 1 String O
6 실패 건수 failureCount 1 String O
7 ERP 번호 (고객사 ID) issueResults erpBillNo 1 String O
8 개별 결과코드 code 1 String O
9 개별 결과메세지 message 1 String O
10 승인번호 apprNo 1 String O 발행 성공시
11 발행시각 issueDateTime 1 String O 발행 성공시
12 보너스포인트 gnlPoint 1 String O 포인트 회원사인 경우
13 일반포인트 bnsPoint 1 String O 포인트 회원사인 경우
14 포인트 합계 totPoint 1 String O 포인트 회원사인 경우

응답 데이터 예시

{
  "resultCode": "101",
  "resultMsg": "일부 세금계산서 발행에 실패하였습니다.",
  "linkId": "titester",
  "requestCount": 4,
  "successCount": 3,
  "failureCount": 1,
  "issueResults": [
    {
      "erpBillNo": "ERP1234560",
      "code": "0000",
      "message": "정상적으로 처리되었습니다.",
      "apprNo": "2024020541000040000001b2",
      "issueDateTime": "2025-04-01 15:36:13"
    },
    {
      "erpBillNo": "ERP1234561",
      "code": "8102",
      "message": "계산서 공급가액과 품목의 공급가액의 합계가 일치해야 합니다."
    },
    {
      "erpBillNo": "ERP1234562",
      "code": "0000",
      "message": "정상적으로 처리되었습니다.",
      "apprNo": "2024020541000040000001b3",
      "issueDateTime": "2025-04-01 15:36:13"
    },
    {
      "erpBillNo": "ERP1234563",
      "code": "0000",
      "message": "정상적으로 처리되었습니다.",
      "apprNo": "2024020541000040000001b4",
      "issueDateTime": "2025-04-01 15:36:14"
    }
  ]
}

설명

(세금)계산서 발행 목록 조회

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/invoices
  • 운영: https://api.nicebill.co.kr/invoices

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 사업자번호 bizNo 1 String O 하이픈('-') 제거 필요
3 회원아이디 linkId 1 String O
4 페이지 번호 page 1 Number O
5 페이지 크기 size 1 Number O 최대 300건
6 조회 날짜 기준 dateType 1 String O ISSUE_DATE: 발행일자 기준, CANCEL_DATE: 작성일자 기준
7 조회 시작일 startDate 1 String O yyyy-MM-dd 또는 yyyyMMdd 형식
8 조회 종료일 endDate 1 String O yyyy-MM-dd 또는 yyyyMMdd 형식
9 (세금)계산서 유형코드 typeCode 1 String (세금)계산서 유형코드 참조
10 승인번호 apprNo 1 String
11 ERP 번호 erpBillNo 1 String
12 상호명 shopName 1 String
13 전송 상태 sendStatus 1 String (세금)계산서 신고상태 코드 참조

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "linkId": "titester",
  "page": 1,
  "size": 20,
  "dateType": "ISSUE_DATE",
  "startDate": "2025-02-01",
  "endDate": "2025-04-30",
  "typeCode": "0101",
  "apprNo": "",
  "erpBillNo": "",
  "shopName": "",
  "sendStatus": "C"
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode String 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg String
3 승인번호 data apprNo String
4 ERP 번호 erpBillNo String
5 조회 날짜 기준 dateType String ISSUE_DATE: 발행일자 기준, CANCEL_DATE: 작성일자 기준
6 거래일자(공급일자) dealYmd String yyyyMMdd 형식
7 발행일시 issueDttm String
8 익일 발행 일시 sndDttm String 익일 발행 시
9 공급자 사업자번호 invoicerBizNo String
10 공급자 상호 invoicerBizName String
11 공급받는자 사업자번호 invoiceeBizNo String
12 공급받는자 상호 invoiceeBizName String
13 (세금)계산서 유형코드 typeCode String (세금)계산서 유형코드 참조
14 (세금)계산서 유형 type String
15 처리 상태코드 pcsStatus String
16 신고 상태 코드 returnStatusCode String (세금)계산서 신고상태 코드 참조
17 신고 상태 returnStatus String
18 품목명 itemName String
19 공급가액 합계 supplyCostTotal String
20 세액 합계 taxTotal String
21 총액 totAmt String

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상적으로 처리되었습니다.",
  "data": [
    {
      "apprNo": "2024020541000040000001b5",
      "erpBillNo": "ERP1234570",
      "dateType": "ISSUE_DATE",
      "dealYmd": "20240205",
      "issueDttm": "2025-04-02 16:35:50",
      "sndDttm": "2025-04-03 03:00:00",
      "invoicerBizNo": "1234567890",
      "invoicerBizName": "공급자 회사",
      "invoiceeBizNo": "9876543210",
      "invoiceeBizName": "공급받는자 회사",
      "typeCode": "0101",
      "type": "세금계산서",
      "pcsStatus": "110",
      "returnStatusCode": "C",
      "returnStatus": "신고 성공",
      "itemName": "상품A",
      "supplyCostTotal": 100000,
      "taxTotal": 10000,
      "totAmt": 110000
    },
    {
      "apprNo": "2024020541000040000001b2",
      "erpBillNo": "ERP1234560",
      "dateType": "ISSUE_DATE",
      "dealYmd": "20240205",
      "issueDttm": "2025-04-01 15:36:13",
      "invoicerBizNo": "1234567890",
      "invoicerBizName": "공급자 회사",
      "invoiceeBizNo": "9876543210",
      "invoiceeBizName": "공급받는자 회사",
      "typeCode": "0101",
      "type": "세금계산서",
      "pcsStatus": "110",
      "returnStatusCode": "C",
      "returnStatus": "신고 성공",
      "itemName": "상품A",
      "supplyCostTotal"": 100000,
      "taxTotal"": 10000,
      "totAmt"": 110000
    },
    {
      "apprNo": "202503274100004000000001",
      "erpBillNo": "",
      "dateType": "ISSUE_DATE",
      "dealYmd": "20250327",
      "issueDttm": "2025-03-27 17:25:43",
      "invoicerBizNo": "1078708207",
      "invoicerBizName": "나이스디앤알",
      "invoiceeBizNo": "1234567890",
      "invoiceeBizName": "테스트업체",
      "typeCode": "0101",
      "type": "세금계산서",
      "pcsStatus": "110",
      "returnStatusCode": "C",
      "returnStatus": "신고 성공",
      "itemName": "품목명1 외1",
      "supplyCostTotal"": 100000,
      "taxTotal"": 10000,
      "totAmt"": 110000
    }
  ]
}

설명

(세금)계산서 상세 조회

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/invoice
  • 운영: https://api.nicebill.co.kr/invoice

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 사업자번호 bizNo 1 String O 하이픈('-') 제거 필요
3 회원아이디 linkId 1 String O
4 승인번호 apprNo 1 String O 승인번호 또는 ERP 번호 중 하나만 제공 (둘 다 입력 시 에러)
5 ERP 번호 erpBillNo 1 String O 승인번호 또는 ERP 번호 중 하나만 제공 (둘 다 입력 시 에러)

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "linkId": "titester",
  "apprNo": "2024020541000040000001b7"
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode String 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg String
3 승인번호 data apprNo String
4 ERP 번호 erpBillNo String
5 거래일자 (공급일자) dealYmd String yyyyMMdd 형식
6 발행일시 issueDttm String
7 익일 발행 일시 sndDttm String 익일 발행 시
8 (세금)계산서 유형 type String
9 (세금)계산서 유형코드 typeCode String (세금)계산서 유형코드 참조
10 처리 상태코드 pcsStatus String
11 영수/청구 코드 purposeCode String
12 비고 remark String
13 공급자 사업자번호 invoicerBizNo String
14 공급자 상호 invoicerBizName String
15 공급자 대표자명 invoicerCEOName String
16 공급자 업태 invoicerBizCode String
17 공급자 업종 invoicerBizItem String
18 공급자 주소 invoicerAddr String
19 공급자 종사업장 번호 invoicerTaxSubNo String
20 공급받는자 사업자번호 invoiceeBizNo String
21 공급받는자 상호 invoiceeBizName String
22 공급받는자 대표자명 invoiceeCEOName String
23 공급받는자 업태 invoiceeBizCode String
24 공급받는자 업종 invoiceeBizItem String
25 공급받는자 주소 invoiceeAddr String
26 공급받는자 종사업장 번호 invoiceeTaxSubNo String
27 수탁자 사업자번호 trusteeBizNo String 위수탁 (세금)계산서
28 수탁자 상호 trusteeBizName String 위수탁 (세금)계산서
29 수탁자 대표자명 trusteeCEOName String 위수탁 (세금)계산서
30 수탁자 업태 trusteeBizCode String 위수탁 (세금)계산서
31 수탁자 업종 trusteeBizItem String 위수탁 (세금)계산서
32 수탁자 주소 trusteeAddr String 위수탁 (세금)계산서
33 수탁자 종사업장 번호 trusteeTaxSubNo String 위수탁 (세금)계산서
34 공급가액 합계 supplyCostTotal String
35 세액 합계 taxTotal String
36 총액 totAmt String
37 현금 cash String
38 수표 chk String
39 어음 pro String
40 외상미수금 credit String
41 수정사유 코드 chngReasonCode String 수정 (세금)계산서
42 당초 승인번호 orgApprNo String 수정 (세금)계산서
43 신고 상태 코드 returnStatusCode String (세금)계산서 신고상태 코드 참조
44 신고 상태 returnStatus String
45 신고 결과 코드 returnRslCode String
46 신고 처리 일자 returnPcsYmd String
47 전송 유형 ntsTransmissionType String 즉시 전송, 익일 전송

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상적으로 처리되었습니다.",
  "data": {
    "apprNo": "2024020541000040000001b7",
    "erpBillNo": "ERP001001",
    "dealYmd": "20240205",
    "issueDttm": "2025-04-02 12:51:06",
    "sndDttm": "2025-04-03 03:00:00",
    "type": "세금계산서",
    "typeCode": "0101",
    "pcsStatus": "110",
    "purposeCode": "01",
    "remark": "",
    "invoicerBizNo": "1234567890",
    "invoicerBizName": "공급자 회사",
    "invoicerCEOName": "공급자 대표",
    "invoicerBizCode": "001",
    "invoicerBizItem": "도매업",
    "invoicerAddr": "",
    "invoicerTaxSubNo": "",
    "invoiceeBizNo": "9876543210",
    "invoiceeBizName": "공급받는자 회사",
    "invoiceeCEOName": "공급받는자 대표",
    "invoiceeBizCode": "002",
    "invoiceeBizItem": "소매업",
    "invoiceeAddr": "",
    "invoiceeTaxSubNo": "",
    "trusteeBizNo": "",
    "trusteeBizName": "",
    "trusteeCEOName": "",
    "trusteeBizCode": "",
    "trusteeBizItem": "",
    "trusteeAddr": "",
    "trusteeTaxSubNo": "",
    "supplyCostTotal": "100000",
    "taxTotal": "10000",
    "totAmt": "110000",
    "cash": "",
    "chk": "",
    "pro": "",
    "credit": "",
    "chngReasonCode": "",
    "orgApprNo": "",
    "returnStatusCode": "C",
    "returnStatus": "신고 성공",
    "returnRslCode": "성공",
    "returnPcsYmd": "20250402",
    "ntsTransmissionType": "익일 전송"
  }
}

설명

(세금)계산서 신고제외

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/invoice/exclusion
  • 운영: https://api.nicebill.co.kr/invoice/exclusion

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 사업자번호 bizNo 1 String O 하이픈('-') 제거 필요
3 회원아이디 linkId 1 String O
4 승인번호 apprNo 1 String O 승인번호 또는 ERP 번호 중 하나만 제공 (둘 다 입력 시 에러)
5 ERP 번호 erpBillNo 1 String O 승인번호 또는 ERP 번호 중 하나만 제공 (둘 다 입력 시 에러)

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "linkId": "titester",
  "erpBillNo": "ERP0010201"
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode String 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg String

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상적으로 처리되었습니다."
}

설명

(세금)계산서 이메일 재발행

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/invoice/reissue
  • 운영: https://api.nicebill.co.kr/invoice/reissue

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 사업자번호 bizNo 1 String O 하이픈('-') 제거 필요
3 회원아이디 linkId 1 String O
4 승인번호 apprNo 1 String O 승인번호 또는 ERP 번호 중 하나만 제공 (둘 다 입력 시 에러)
5 ERP 번호 erpBillNo 1 String O 승인번호 또는 ERP 번호 중 하나만 제공 (둘 다 입력 시 에러)
6 이메일 재발행 리스트 recpEmailList 1 String O 최대 5개

요청 데이터 예시

{
  "linkCd": "TST",
  "bizNo": "1234567890",
  "linkId": "titester",
  "apprNo": "20250211410000400000000a",
  "recpEmailList": ["test@nicednr.co.kr"]
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상적으로 처리되었습니다."
}

설명

(세금)계산서 수동 동기화 데이터 조회

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/sync/manual
  • 운영: https://api.nicebill.co.kr/sync/manual

요청 정보

No Name Element Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 조회일 issueDate 1 String O 발행일 기준 3일 전 ~ 기준일까지

요청 데이터 예시

{
  "linkCd": "TST",
  "issueDate": "20250402"
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode String 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg String
3 승인번호 data apprNo String 최대 500건 조회
4 ERP 번호 erpBillNo String
5 발행일시 issueDttm String
6 처리 상태코드 pcsStatus String
7 신고 상태 returnStatus String
8 신고 결과 코드 returnRslCode String

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상적으로 처리되었습니다.",
  "data": [
    {
      "apprNo": "2024020541000040000001b2",
      "erpBillNo": "ERP1234560",
      "issueDttm": "2025-04-01 15:36:13",
      "pcsStatus": "110",
      "returnStatus": "C",
      "returnRstlCode": ""
    },
    {
      "apprNo": "2024020541000040000001b3",
      "erpBillNo": "ERP1234562",
      "issueDttm": "2025-04-01 15:36:13",
      "pcsStatus": "110",
      "returnStatus": "C",
      "returnRstlCode": ""
    }
  ]
}

설명

(세금)계산서 수동 동기화 요청

호출 정보

POST 방식

접근 URL

  • 개발: https://dev-api.nicebill.co.kr/invoice/sync/manual/complete
  • 운영: https://api.nicebill.co.kr/invoice/sync/manual/complete

요청 정보

No Name Element0 Element2 Occur. 타입 필수 비고/Function
1 연계코드 linkCd 1 String O VARCHAR(3)
2 승인번호 syncData apprNo 2 String O (세금)계산서 수동 동기화 데이터 조회 API에서
조회한 데이터 업데이트 후 그대로 요청
3 ERP 번호 erpBillNo 3 String O
4 발행일시 issueDttm 4 String O
5 처리 상태코드 pcsStatus 5 String O
6 신고 상태 returnStatus 6 String O
7 신고 결과 코드 returnRslCode 7 String O

요청 데이터 예시

{
  "linkCd": "TST",
  "syncData": [
      {
      "apprNo": "2024020541000040000001b2",
      "erpBillNo": "ERP1234560",
      "issueDttm": "2025-04-01 15:36:13",
      "pcsStatus": "110",
      "returnStatus": "C",
      "returnRstlCode": ""
    }
  ]
}

응답 정보

No Name Element0 Element1 Occur. 타입 필수 비고/Function
1 결과코드 resultCode 1 String O 0000 : 정상 (오류코드 참조)
2 결과메세지 resultMsg 1 String O

응답 데이터 예시

{
  "resultCode": "0000",
  "resultMsg": "정상적으로 처리되었습니다."
}