Python - Django SDK 개발환경 설정방법 | 링크허브 개발가이드

[Python – Django] SDK 적용방법

2018.07.04

본 개발가이드는 팝빌에서 제공하는 전자세금계산서 API, 전자명세서 API, 현금영수증 API, 문자 API, 팩스 API, 휴폐업조회 API, 홈택스 매입/매출 조회 API를 쉽고 빠르게 시스템에 연동할 수 있도록, API 예제를 통해 ‘SDK 이용방법’과 ‘상업용 환경설정’ 방법을 상세히 안내드립니다.

Python V2.7 이상 개발환경 지원
Django V1.11 기반으로 제작
API 호출과 응답에 사용되는 메시지 인코딩 방식은 “UTF-8 Character-Set” 적용

1. SDK 이용방법 안내

SDK를 이용하기 위해서는 팝빌 상품 라이브러리 추가를 위한 ‘Python 패키지 설치’와 통신전문 보안에 사용되는 ‘인증정보 설정’이 필요합니다. 다음의 설명에 따라 SDK를 이용하시길 바랍니다.

Python 패키지 설치

Python 패키지 설치 툴인 pip 또는 easy_install 을 사용하여 PyPI(Python Package Index) 에 등록되어 있는 팝빌 SDK 패키지와 Django Framwork를 설치합니다.


 $ pip install -r requirements.txt

$ pip install -r requirements.txt

또는


 $ easy_install popbill django==1.11

$ easy_install popbill django==1.11

인증정보 설정

SDK 샘플소스를 다운로드한 후 “settings.py”파일에 링크아이디(LinkID)와 비밀키(SecretKey)를 각각 링크허브 가입시 발급받은 링크아이디와 비밀키로 수정하면 인증정보 설정이 완료됩니다.


# 링크아이디
LinkID = "TESTER"

# 발급받은 비밀키, 유출에 주의하시기 바랍니다.
SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

# 연동환경 설정값, 개발용(True), 상업용(False)
IsTest = True

# 팝빌회원 사업자번호
testCorpNum = "1234567890"

# 팝빌회원 아아디
testUserID = "testkorea"

100

101

102

103

104

# 링크아이디

LinkID = "TESTER"

# 발급받은 비밀키, 유출에 주의하시기 바랍니다.

SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

# 연동환경 설정값, 개발용(True), 상업용(False)

IsTest = True

# 팝빌회원 사업자번호

testCorpNum = "1234567890"

# 팝빌회원 아아디

testUserID = "testkorea"

▼ [참고] 인증관련 에러별 트러블 슈팅(Trouble Shooting)

1. 에러코드 : -99010004, “유효한 요청 시간이 아닙니다.” [바로가기]

2. 에러코드 : -99010007, “권한요청 정보의 서명이 일치하지 않습니다.” [바로가기]

2. 상업용 환경설정

테스트 완료 후 연동환경을 상업용으로 설정하기 위해서는 “settings.py” 파일의 IsTest 변수값을 “False” 로 기재하거나 주석으로 처리하면 상업용 연동환경 설정이 완료됩니다.


# 링크아이디
LinkID = "TESTER"

# 발급받은 비밀키, 유출에 주의하시기 바랍니다.
SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

# 연동환경 설정값, 개발용(True), 상업용(False)
IsTest = False

# 팝빌회원 사업자번호
testCorpNum = "1234567890"

# 팝빌회원 아아디
testUserID = "testkorea"

100

101

102

103