개발자 문서
개발자 문서

레거시 URL

예전 REST 경로를 작업 API로 옮길 때 참고합니다.

예전에는 API마다 URL이 달랐습니다. 지금은 모든 요청이 POST /v1/jobs 하나로 들어가고, 무엇을 수집할지는 요청 본문의 action 값으로 정합니다.

아래 표에서 쓰던 경로를 찾아 오른쪽 action 값으로 바꾸면 됩니다. 헤더와 응답 형식은 작업 처리 흐름 문서를 따릅니다.

아래 예전 경로는 더 이상 요청을 받지 않습니다(404). 기존 연동도 오른쪽 action 값으로 POST /v1/jobs 에 보내도록 옮기세요. 이 표는 옮기기 위한 대조표입니다.

예전 경로 → 지금 action

예전 경로지금 action
/hometax/products/v1/a/s1/loginhometax.session.login
/hometax/products/v1/a/s1/user/infohometax.session.user_info
/hometax/products/v1/a/c1/certificates-listhometax.certificate.list
/hometax/products/v1/a/c1/national-tax-paymenthometax.certificate.apply.national_tax_payment
/hometax/products/v1/a/c1/tax-payment-recordhometax.certificate.apply.tax_payment_record
/hometax/products/v1/a/c1/vat-standardhometax.certificate.apply.vat_standard
/hometax/products/v1/a/c1/business-registrationhometax.certificate.apply.business_registration
/hometax/products/v1/a/c1/business-suspensionhometax.certificate.apply.business_suspension
/hometax/products/v1/a/c1/financial-statementhometax.certificate.apply.financial_statement
/hometax/products/v1/a/c1/business-closurehometax.certificate.apply.business_closure
/hometax/products/v1/a/c1/business-registration-reissuehometax.certificate.apply.business_registration_reissue
/hometax/products/v1/a/c1/income-statementhometax.certificate.apply.income_statement
/hometax/products/v1/a/e1/invoice-summaryhometax.etax.invoice.search_summary
/hometax/products/v1/a/e1/invoice-listhometax.etax.invoice.search_list
/hometax/products/v1/a/e1/invoice-statisticshometax.etax.invoice.search_statistics
/hometax/products/v1/a/e1/invoice-detailhometax.etax.invoice.search_detail
/hometax/products/v1/a/e1/issuehometax.etax.invoice.issue
/hometax/products/v1/a/e1/modifyhometax.etax.invoice.modify
/hometax/products/v1/a/t1/business-registration-statushometax.tax.business_registration.search_status
/hometax/products/v1/a/t1/withholding-tax/regular-report/inithometax.tax.withholding.regular_report.init
/hometax/products/v1/a/t1/withholding-tax/regular-report/requirementshometax.tax.withholding.regular_report.requirements
/hometax/products/v1/a/t1/withholding-tax/regular-report/basic-savehometax.tax.withholding.regular_report.basic_save
/hometax/products/v1/a/t1/withholding-tax/regular-report/detail-savehometax.tax.withholding.regular_report.detail_save
/hometax/products/v1/a/t1/withholding-tax/regular-report/reviewhometax.tax.withholding.regular_report.review
/hometax/products/v1/a/t1/withholding-tax/regular-report/previewhometax.tax.withholding.regular_report.preview
/hometax/products/v1/a/t1/withholding-tax/regular-report/submithometax.tax.withholding.regular_report.submit
/hometax/products/v1/a/t1/withholding-tax/regular-report/historyhometax.tax.withholding.regular_report.history
/hometax/products/v1/a/t1/my-tax-agenthometax.tax.my_tax_agent.search
/hometax/products/v1/a/t1/business-registration-infohometax.tax.business_registration.search_info
/hometax/products/v1/a/t1/tax-return-history-vathometax.tax.return_history.search_vat
/hometax/products/v1/a/t1/tax-return-historyhometax.tax.return_history.search
/hometax/products/v1/a/t1/tax-return-document-detailhometax.tax.return_document.detail
/hometax/products/v1/a/t1/tax-return-document-pdfhometax.tax.return_document.pdf
/hometax/products/v1/a/t1/payment-due-tax-amounthometax.tax.payment_due.search_or_pay
/hometax/products/v1/a/t1/electronic-notice-statushometax.tax.electronic_notice.check_status
/hometax/products/v1/a/t1/refund-detailhometax.tax.refund.search_detail
/hometax/products/v1/a/t1/unclaimed-refundhometax.tax.unclaimed_refund.search
/hometax/products/v1/a/t1/notice-historyhometax.tax.notice.search_history
/hometax/products/v1/a/t1/overdue-historyhometax.tax.overdue.search_history
/hometax/products/v1/a/t1/payment-statementhometax.tax.payment_statement.search
/hometax/products/v1/a/t1/payment-statement-submit-historyhometax.tax.payment_statement.search_submit_history
/hometax/products/v1/a/t1/trade-partner-listhometax.tax.trade_partner.search_list
/hometax/products/v1/a/t1/credit-card-sales-datahometax.tax.credit_card.search_sales_data
/hometax/products/v1/a/cr1/sales-historyhometax.cash_receipt.sales.search_history
/hometax/products/v1/a/cr1/sales-summaryhometax.cash_receipt.sales.search_summary
/hometax/products/v1/a/cr1/purchase-historyhometax.cash_receipt.purchase.search_history
/hometax/products/v1/a/cr1/issue-individualhometax.cash_receipt.issue_individual
/hometax/products/v1/a/cr1/daily-issuehometax.cash_receipt.daily_issue.search
/hometax/products/v1/a/cr1/modify-daily-issuehometax.cash_receipt.daily_issue.modify
/hometax/products/v1/a/cr1/cancel-daily-issuehometax.cash_receipt.daily_issue.cancel

더 받지 않는 v1 action 이름

예전 이름지금 action
fetch_invoiceshometax.etax.invoice.search_list
fetch_cash_receiptshometax.cash_receipt.sales.search_history

왼쪽 이름은 예전 v1 연동에서 쓰던 이름이고, 지금은 요청을 받지 않습니다. 오른쪽 action 으로 바꿔 요청해 주세요.

흡수된 레거시 액션

action
hometax.certificate.apply_with_template
hometax.certificate.list_templates
hometax.certificate.apply_auto
hometax.certificate.download
hometax.certificate.apply_auto_download
hometax.etax.invoice.issue_finalize
hometax.etax.business_info.get
hometax.etax.client_info.get
hometax.etax.invoice.hold

이 중 7개는 상품으로 올라 있어 홈택스 API 문서(증명서, 전자세금계산서)에 설명이 있습니다.