OpenAPI

HOME > OpenAPI > 과세유형조회

과세유형조회

사업자의 과세 유형 및 상태정보를 제공합니다.


1 요청URL
GET
POST
    URL
  • http://ds.gscms.co.kr:8888/Rest/api/BSNStatus?sessionID=공개키
    • 샘플
  • http://ds.gscms.co.kr:8888/Rest/api/BSNStatus?sessionID=test
  • [application/x-www-form-urlencoded]
  • path01=1178171379
  • [application/xml]
  • <R><path01>1178171379</path01></R>
  • [application/json]
  • {"path01":"1178171379"}

    • 주의사항
  • filename, type, eCode, serviceKey, subFileName, wcfName 요청변수명은 사용이 불가하며,
  • path01 ~ path20은 Path에서 사용하지 않을 경우 사용가능.
  • 요청변수명 중복사용시 Query보다 Body가 우선함.

2 요청변수
구분 요청변수 변수명 유형 필수 샘플값 설명
Path fileName 요청 업무 string true BSNStatus
 BSNStatus
추가/변경 가능
path01 사업자번호 string true 1178171379
Query returnType응답형식stringfalsexmlxml or json
HTTP Header의 Accept 사용 권장
eCode 법인코드 string false Dataservice 요청 처리하고자 하는 법인코드
sessionID 공개키 string true test 접근하려는 연계시스템 또는 사용자에 부여하는 Key값
subFileName 요청 업무(구분) string false 088 요청 업무 세부 구분 코드(예-은행코드)

3 출력결과필드
출력변수 유형 샘플값 설명
result responseindex success 처리결과코드 (success, error)
resultMessage responseindex 성공 처리결과메세지 (성공, 오류명반환)
bsnno responseindex 1178171379 사업자번호
EndDt responseindex 폐업일자 (YYYYMMDD 포맷)
TaxTypeChangeDt responseindex 최근과세유형전환일자 (YYYYMMDD 포맷)
b_stt_cd responseindex 01 납세자유형코드
01 : 계속사업자
02 : 휴업자
03 : 폐업자
b_stt responseindex 계속사업자 납세자유형코드명
tax_type_cd responseindex 01 과세유형코드
01 : 부가가치세 일반과세자
02 : 부가가치세 간이과세자
03 : 부가가치세 과세특례자
04 : 부가가치세 면세사업자
05 : 부가가치세 비영리법인,국가기관
06 : 부가가치세 고유번호부여단체
07: 부가가치세 간이과세자(세금계산서발급사업자)
tax_type responseindex 부가가치세 일반과세자 과세유형코드명

4 추가응답코드
  • 개발가이드 페이지의 기본응답코드외 해당 업무특성상 추가되는 응답코드
    • 응답코드 응답메세지 조치 방안

    5 Test API
    Header
    Key Value 비고
    Content-Type application/x-www-form-urlencoded application/xml
    application/json
    Accept application/xml
    application/json
    Authorization 토큰 인증용 헤더(Bearer + ' ' + 발급토큰)
    client_id 접속회원ID
    client_secret 접속비밀번호
    serviec_key 서비스Key
    user-tr-no 요청자 거래고유번호(요청자 생성)


  • [GET] http://ds.gscms.co.kr:8888/Rest/api/BSNStatus


    • Response


  • [POST] http://ds.gscms.co.kr:8888/Rest/api/BSNStatus?sessionID=test

    • Body
    Key Value 비고
    path01 사업자번호


    Response