메일/그룹웨어 매뉴얼
Home > 메일/그룹웨어 > 세금계산서 > 세금계산서 사용하기 > 설정하기
신규 전자세금계산서 API는 개발자센터>세금계산서 API에서 확인하시기 바랍니다.
아래 방법은 전자세금계산서 (구)API를 이용해 간편 서명을 적용하는 방법입니다.
1. 간편 서명에 필요한 2개의 파라미터를 추가합니다.
1) easy_sign
> 간편 서명 진행 여부에 대한 표시
> ‘Y’: 문서 저장 후 간편 서명 진행
> ‘N’: 문서 저장 후 간편 서명 진행하지 않음
> Type: String
> Value: ‘Y’ or ‘N’
2) office_token
> 간편 서명 진행 시 인증 과정에 사용하는 token
> 오피스 관리>API 관리에서 전자세금계산서 Scope 설정이 있는 오피스 토큰을 발급받아 사용
> Type: String
> Length: 32
2. 언어별 Example을 활용하여 작업하시기 바랍니다.
1) 언어별 공통 – XML 형식
예) 오피스 토큰 값이 Abcsd2e24fghik89dkFG3Hdkfdk12345 일 때
|
<hiworksbilldata> <service_info_array>. . .< service_info_array> <service_info_array>. . .< service_info_array> <service_account_array>. . .< service_account_array> . . . <serial>222-222</serial> <easy_sign>Y</easy_sign> <office_token> Abcsd2e24fghik89dkFG3Hdkfdk12345</office_token> . . . </hiworksbilldata> |
2) ASP
> SetBasicInfo 파라미터 추가하기
|
Sub SetBasicInfo( name, /* 수신자 담당자 명*/ email, /* 수신자 이메일 주소*/ hp, /* 수신자 휴대폰 번호 */ memo, /* 메모 */ book_no, /* 책번호 */ serial /* 일련번호 */ easy_sign /* 간편 서명 허용 여부 */ office_token /* 간편 서명 인증을 위한 token */ ); |
> 문서 생성 시 Value 추가해서 호출하기
예) 오피스 토큰 값이 Abcsd2e24fghik89dkFG3Hdkfdk12345 일 때
|
<% SetConfig “gabia.com”, “bill”, “741ddfeae81eb5d4677c2c5d”, “A0000” SetBasicInfo ‘홍길동’, ‘api@hiworks.co.kr’, ‘010-000-0000’, ‘메모’, ‘123-123’, ‘123-123’,’Y’,’Abcsd2e24fghik89dkFG3Hdkfdk12345’ %> |
3) PHP
> 문서 생성 시, set_basic_info의 파라미터 및 Value 추가해서 호출하기
예) 오피스 토큰 값이 Abcsd2e24fghik89dkFG3Hdkfdk12345 일 때
|
<?php : $HB->set_basic_info('serial', '222-222'); // serial : 일련번호 $HB->set_basic_info('easy_sign', 'Y'); // 간편 서명 허용 여부 $HB->set_basic_info('office_token', Abcsd2e24fghik89dkFG3Hdkfdk12345); // 간편 서명 인증을 위한 token ?> |
4) JSP
> 문서 생성 시, set_basic_info의 파라미터 및 Value 추가해서 호출하기
예) 오피스 토큰 값이 Abcsd2e24fghik89dkFG3Hdkfdk12345 일 때
|
<% Hiworks_Bill HB = new Hiworks_Bill( "gabia.com", "bill", "ABCD-DDDD", "XXXXX" );
//기본정보 입력 : HB.set_basic_info("memo", "메모"); // memo : 메모 HB.set_basic_info("easy_sign", "Y"); // easy_sign : 간편 서명 허용 여부 HB.set_basic_info("office_token", "Abcsd2e24fghik89dkFG3Hdkfdk12345"); // office_token : 간편 서명 인증을 위한 token %> |
5) DLL 설치 방식
기존 DLL 파일에 아래 샘플 부분을 추가하여 사용할 수 있습니다.
DLL 파일 업데이트 버전은 지원하지 않습니다.
원본 파일을 원하시는 경우, 고객센터로 문의 주시면 개별 전달 드립니다.
예) 오피스 토큰 값이 Abcsd2e24fghik89dkFG3Hdkfdk12345라고 할 때
|
<hiworksbilldata> <service_info_array>. . .< service_info_array> <service_info_array>. . .< service_info_array> <service_account_array>. . .< service_account_array> . . . <serial>222-222</serial> <easy_sign>Y</easy_sign> <office_token> Abcsd2e24fghik89dkFG3Hdkfdk12345</office_token> . . . </hiworksbilldata> |
3. 간편 서명 연동 에러 코드 값
|
코드 |
설명 |
|
10000 |
문서 발급이 완료되었습니다. 발급된 문서는 국세청으로 즉시 전송합니다. |
|
10001 |
easy_sign은 Y나 N값만 허용합니다. 올바른 easy_sign값 등록 후 사용하시기 바랍니다. |
|
10002 |
간편 서명 연동 과정에서 오류가 발생했습니다. 오피스에 접속하셔서 발급 및 국세청 전송을 직접 진행하시기 바랍니다. 지속적으로 해당 오류가 발생한다면 관리자에게 문의하세요. |
|
10100 |
인증 과정에서 오류가 발생하였습니다. office_token을 확인한 후 진행하시기 바랍니다. 오피스에 접속하셔서 발급 및 국세청 전송을 직접 진행하시기 바랍니다. |
|
10101 |
document id에 해당하는 문서를 찾을 수 없습니다. |
|
10102 |
세금계산서 정책에 의해 발급에 실패했습니다. 오피스에 접속하셔서 발급 및 국세청 전송을 직접 진행하시기 바랍니다. |
|
10103 |
발급 과정에서 내부 오류가 발생했습니다. 오피스에 접속하셔서 발급 및 국세청 전송을 직접 진행하시기 바랍니다. |
|
10104 |
간편 서명을 위한 오피스 토큰이 없습니다. 오피스에 접속하셔서 발급 및 국세청 전송을 직접 진행하시기 바랍니다. |
