하이픈(HYPHEN)- 펌뱅킹, API마켓, 간편결제 전문 기업

관리자

2024.10.29 14:27:36

[정정공지] API 업데이트에 따른 응답부 변경 예정의 건

안녕하세요 하이픈 데이터마켓입니다.

이전 공지내용에 정정된 사항있어 재공지 드립니다 아래내역 참고하시어 업무에 적용 부탁드립니다.

당사 내부 API 연동 시스템 업데이트에 의하여 현재 수신받고 계신 API의 응답부가 일부 변경될 예정입니다.

해당되는 API를 사용하고 계시는 경우 해당 응답값 변경에 맞추어 업데이트를 요청드립니다.

자세한 사안은 각 개발가이드 업데이트 후 개별 API 응답부 확인 부탁드립니다.

개발가이드 업데이트	24. 10. 23(수) 08:00
응답부 업데이트(1차)	24. 10. 30(수) 07:00 ~ 08:00
응답부 업데이트(2차)	24. 11. 06(수) 07:00 ~ 08:00
대 상 API	총 36개 API(하단 리스트 참조) / 1차(7개), 2차(29개)
업데이트 사유	일부 API 응답부 중복값 제거

■변경 예정 API 리스트(1차)

NO	패키지	제공기관	API명	적용일자
1	국민건강보험 진료정보	국민건강보험공단	진료 정보 조회	10. 30
2	국민건강보험 진료정보	국민건강보험공단	건강검진결과 한눈에보기	10. 30
3	국민건강보험 진료정보	국민건강보험공단	국민건강보험 자격득실확인서	10. 30
4	국민건강보험 진료정보	국민건강보험공단	국민건강보험 자격득실확인서(new)	10. 30
5	국민건강보험 진료정보	국민건강보험공단	국민건강보험 납부확인서	10. 30
6	국민건강보험 진료정보	국민건강보험공단	투약 정보 조회	10. 30
7	국민건강보험 진료정보	국민건강보험공단	4대보험 완납증명서	10. 30

■변경 예정 API 리스트(2차)

NO	패키지	제공기관	API명	적용일자
1	국민건강보험 진료정보	국민건강보험공단	개인별건강보험료산출내역	11. 06
2	국민건강보험 진료정보	국민건강보험공단	개인별고용보험료산출내역	11. 06
3	국민건강보험 진료정보	국민건강보험공단	개인별연금보험료산출내역	11. 06
4	법인카드 조회	신용카드사	법인카드 승인내역조회	11. 06
5	법인카드 조회	신용카드사	법인카드 보유카드조회	11. 06
6	법인카드 조회	신용카드사	법인카드 매입내역조회	11. 06
7	기업계좌 조회	은행	기업계좌 거래내역조회	11. 06
8	기업계좌 조회	은행	기업계좌 전계좌조회	11. 06
9	기업계좌 조회	은행	기업계좌 잔액 조회	11. 06
10	홈택스 매입/매출 조회	홈텍스	홈텍스 세금계산서발행내역(매입)	11. 06
11	홈택스 매입/매출 조회	홈텍스	홈텍스 세금계산서발행내역(매출)	11. 06
12	홈택스 매입/매출 조회	홈텍스	홈텍스 현금영수증(매입)	11. 06
13	홈택스 매입/매출 조회	홈텍스	홈텍스 계산서발행내역(매입)	11. 06
14	홈택스 매입/매출 조회	홈텍스	홈텍스 계산서발행내역(매출)	11. 06
15	홈택스 매입/매출 조회	홈텍스	홈텍스 현금영수증(매출)	11. 06
16	홈택스 증명/조회	홈텍스	소득금액증명(통합)	11. 06
17	홈택스 증명/조회	홈텍스	홈텍스 부가가치세과세표준증명	11. 06
18	홈택스 증명/조회	홈텍스	홈텍스 납세증명	11. 06
19	홈택스 증명/조회	홈텍스	홈텍스 민원증명 원본확인	11. 06
20	홈택스 사업자 매입	홈텍스	홈텍스 사업용신용카드 매입세액 공제 확인/변경	11. 06
21	홈택스 사업자 매입	홈텍스	홈텍스 신용카드 매출자료 조회	11. 06
22	홈택스 사업자 매입	홈텍스	사업장 전환	11. 06
23	홈택스 사업자 매입	홈텍스	홈텍스 사업용신용카드 누계조회	11. 06
24	홈택스 수임처 신고	홈텍스	홈텍스 수임납세자 등록	11. 06
25	홈택스 나의세무대리인	홈텍스	홈텍스 나의세무대리인 수임동의	11. 06
26	홈택스 나의세무대리인	홈텍스	홈텍스 나의세무대리인 수임해지	11. 06
27	홈택스 멤버십	홈텍스	홈텍스 회원정보	11. 06
28	현금영수증 매출/매입 조회	홈텍스	홈텍스 현금영수증 매출총액 조회	11. 06
29	전자(세금)계산서 발행/조회	홈텍스	홈텍스 전자세금계산서 발행	11. 06

※ 2차 패치 전 data부에 데이터가 없는 경우가 발생할 수 있으니 반드시 해당 일자에 맞추어 적용 부탁드립니다.

■변경 예정사항(예시)

변경 전

변경 후

{
  "common": {
    "userTrNo": "",
    "hyphenTrNo": "10202410170000038141",
    "errYn": "N",
    "errMsg": ""
  },
  "data": {
    "taxTypeNm": "부가가치세 일반과세자",
    "changeDt": "",
    "bizNo": "4988102543",
    "taxTypeCd": "01",
    "taxMsg": "부가가치세 일반과세자 입니다.",
    "errMsg": "",
    "reqCd": "crc-24575d6d-fc0a-419c-b32e-e03d902b1d96",
    "taxSt": "00",
    "errYn": "N",
    "searchDt": "20241017"
  },
"resCd": "0000",
  "resMsg": "정상",
  "out": {
    "taxTypeNm": "부가가치세 일반과세자",
    "changeDt": "",
    "bizNo": "4988102543",
    "taxTypeCd": "01",
    "taxMsg": "부가가치세 일반과세자 입니다.",
    "errMsg": "",
    "reqCd": "crc-24575d6d-fc0a-419c-b32e-e03d902b1d96",
    "taxSt": "00",
    "errYn": "N",
    "searchDt": "20241017"
  },
  "reqTm": "2024-10-17 17:30:06",
  "reqTmSs": "2024-10-17 17:30:06.992",
  "resTm": "2024-10-17 17:30:07",
  "resTmSs": "2024-10-17 17:30:07.551",
  "reqCd": "crc-24575d6d-fc0a-419c-b32e-e03d902b1d96"

  "common": {
    "userTrNo": "",
    "hyphenTrNo": "10202410170000038304",
    "errYn": "N",
    "errMsg": ""
  },
  "data": {
    "taxTypeNm": "부가가치세 일반과세자",
    "changeDt": "",
    "bizNo": "498-81-02543",
    "taxTypeCd": "01",
    "taxMsg": "부가가치세 일반과세자 입니다.",
    "errMsg": "",
    "reqCd": "crc-3d3a6e41-e3ea-4a98-8e1e-b5d2183bb9b7",
    "taxSt": "00",
    "errYn": "N",
    "searchDt": "20241017"
  }
}

■변경 상세(코드별)

필드명	필드상세	대체코드
resCd	하이픈 ↔ 당사 스크래핑 서버간의 응답코드	삭제
resMsg	하이픈 ↔ 당사 스크래핑 서버간의 응답값	삭제
taxTypeNm	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
changeDt	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
bizBNo	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
taxTypeCd	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
taxMsg	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
errMsg	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
reqCd	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
taxSt	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
errYn	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
searchDt	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
regTm	하이픈 ↔ 당사 스크래핑 서버간의 응답시간	삭제
reqTmSs	하이픈 ↔ 당사 스크래핑 서버간의 응답시간	삭제
resTm	하이픈 ↔ 당사 스크래핑 서버간의 응답시간	삭제
resTmSs	하이픈 ↔ 당사 스크래핑 서버간의 응답시간	삭제
reqCd	하이픈 ↔ 당사 스크래핑 서버간의 응답코드	삭제

※ 개발가이드에 정의된 데이터 이외에 더미성 데이터가 전달될 수 있으나 실 데이터와 무방한 데이터 입니다.

관련 문의는 하이픈 고객센터(1600-4173 또는 help@hyphen.im)를 이용해 주세요.

더욱 편리한 서비스를 제공할 수 있도록 최선을 다하겠습니다.

감사합니다.