Business

사업자 관련 정보를 제공하는 서비스입니다.

사업자 진위확인 서비스
사업자번호 대해 사업자의 진위확인을 리턴합니다.(국세청)
End Point Method Parameter
/v1/business/inquiry/validation GET Query

Request Parameters
필드 설명 타입
businesses_number 사업자번호 String
businesses_start_date 사업개시일 String
ceo_name 대표자명 String

Response
필드 설명 타입
businesses_number 사업자번호 String
valid 사업자유효코드(01:유효) String
b_stt 납세자상태(명칭): 01: 계속사업자, 02: 휴업자, 03: 폐업자 String
b_stt_cd 납세자상태(코드): 01: 계속사업자, 02: 휴업자, 03: 폐업자 String
tax_type 과세유형메세지(명칭):
01:부가가치세 일반과세자,
02:부가가치세 간이과세자,
03:부가가치세 과세특례자,
04:부가가치세 면세사업자,
05:수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등,
06:고유번호가 부여된 단체,
07:부가가치세 간이과세자(세금계산서 발급사업자),
* 등록되지 않았거나 삭제된 경우: "국세청에 등록되지 않은 사업자등록번호입니다" 		String
tax_type_cd 과세유형메세지(코드):
01:부가가치세 일반과세자,
02:부가가치세 간이과세자,
03:부가가치세 과세특례자,
04:부가가치세 면세사업자,
05:수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등,
06:고유번호가 부여된 단체,
07:부가가치세 간이과세자(세금계산서 발급사업자) 		String
end_dt 폐업일 String
utcc_yn 단위과세전환폐업여부 String
tax_type_change_dt 최근과세유형전환일자 String
invoice_apply_dt 세금계산서적용일자 String

Response Sample

{
  "code": "0000",
  "message": "정상처리"
  "body": {
    {
      "businesses_number": "2148639239",
      "valid": "01",
      "request_param": {
        "businesses_number": "2148639239",
        "businesses_start_date": "19991004",
        "ceo_name": "김홍국"
      },
      "status": {
        "businesses_number": "2148639239",
        "b_stt": "계속사업자",
        "b_stt_cd": "01",
        "tax_type": "부가가치세 일반과세자",
        "tax_type_cd": "01",
        "end_dt": "",
        "utcc_yn": "N",
        "tax_type_change_dt": "",
        "invoice_apply_dt": ""
      }
    }
  ]
}
사업자 상태확인 서비스
사업자번호 대해 사업자의 상태를 리턴합니다.(국세청)
End Point Method Parameter
/v1/business/inquiry/status GET Query

Request Parameters
필드 설명 타입
business_number 사업자번호 String

Response
필드 설명 타입
businesses_number 사업자번호 String
valid 사업자유효코드(01:유효) String
b_stt 납세자상태(명칭): 01: 계속사업자, 02: 휴업자, 03: 폐업자 String
b_stt_cd 납세자상태(코드): 01: 계속사업자, 02: 휴업자, 03: 폐업자 String
tax_type 과세유형메세지(명칭):
01:부가가치세 일반과세자,
02:부가가치세 간이과세자,
03:부가가치세 과세특례자,
04:부가가치세 면세사업자,
05:수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등,
06:고유번호가 부여된 단체,
07:부가가치세 간이과세자(세금계산서 발급사업자),
* 등록되지 않았거나 삭제된 경우: "국세청에 등록되지 않은 사업자등록번호입니다" 		String
tax_type_cd 과세유형메세지(코드):
01:부가가치세 일반과세자,
02:부가가치세 간이과세자,
03:부가가치세 과세특례자,
04:부가가치세 면세사업자,
05:수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등,
06:고유번호가 부여된 단체,
07:부가가치세 간이과세자(세금계산서 발급사업자) 		String
end_dt 폐업일 String
utcc_yn 단위과세전환폐업여부 String
tax_type_change_dt 최근과세유형전환일자 String
invoice_apply_dt 세금계산서적용일자 String

Response Sample

{
  "code": "0000",
  "message": "정상처리"
  "body": {
      "b_no": "2148639239",
      "b_stt": "계속사업자",
      "b_stt_cd": "01",
      "tax_type": "부가가치세 일반과세자",
      "tax_type_cd": "01",
      "end_dt": "",
      "utcc_yn": "N",
      "tax_type_change_dt": "",
      "invoice_apply_dt": ""
  }
}