레거시 URL
예전 REST 경로를 Job API로 옮길 때 참고합니다.
예전에는 API마다 URL이 달랐습니다. 지금은 모든 요청이 POST /v1/jobs 하나로 들어가고, 무엇을 수집할지는 요청 본문의 action 값으로 정합니다.
아래 표에서 쓰던 경로를 찾아 오른쪽 action 값으로 바꾸면 됩니다. 헤더와 응답 형식은 작업 처리 흐름 문서를 따릅니다.
신규 연동은 Job API만 사용하세요. 아래 경로는 이전 연동을 옮기기 위한 대조표입니다.
예전 경로 → 지금 action
| 예전 경로 | 지금 action |
|---|---|
| /hometax/products/v1/a/s1/login | hometax.session.login |
| /hometax/products/v1/a/s1/user/info | hometax.session.user_info |
| /hometax/products/v1/a/c1/certificates-list | hometax.certificate.list |
| /hometax/products/v1/a/c1/national-tax-payment | hometax.certificate.apply.national_tax_payment |
| /hometax/products/v1/a/c1/tax-payment-record | hometax.certificate.apply.tax_payment_record |
| /hometax/products/v1/a/c1/vat-standard | hometax.certificate.apply.vat_standard |
| /hometax/products/v1/a/c1/business-registration | hometax.certificate.apply.business_registration |
| /hometax/products/v1/a/c1/business-suspension | hometax.certificate.apply.business_suspension |
| /hometax/products/v1/a/c1/financial-statement | hometax.certificate.apply.financial_statement |
| /hometax/products/v1/a/c1/business-closure | hometax.certificate.apply.business_closure |
| /hometax/products/v1/a/c1/business-registration-reissue | hometax.certificate.apply.business_registration_reissue |
| /hometax/products/v1/a/c1/income-statement | hometax.certificate.apply.income_statement |
| /hometax/products/v1/a/e1/invoice-summary | hometax.etax.invoice.search_summary |
| /hometax/products/v1/a/e1/invoice-list | hometax.etax.invoice.search_list |
| /hometax/products/v1/a/e1/invoice-statistics | hometax.etax.invoice.search_statistics |
| /hometax/products/v1/a/e1/invoice-detail | hometax.etax.invoice.search_detail |
| /hometax/products/v1/a/e1/issue | hometax.etax.invoice.issue |
| /hometax/products/v1/a/e1/modify | hometax.etax.invoice.modify |
| /hometax/products/v1/a/t1/business-registration-status | hometax.tax.business_registration.search_status |
| /hometax/products/v1/a/t1/my-tax-agent | hometax.tax.my_tax_agent.search |
| /hometax/products/v1/a/t1/business-registration-info | hometax.tax.business_registration.search_info |
| /hometax/products/v1/a/t1/tax-return-history-vat | hometax.tax.return_history.search_vat |
| /hometax/products/v1/a/t1/payment-due-tax-amount | hometax.tax.payment_due.search_or_pay |
| /hometax/products/v1/a/t1/electronic-notice-status | hometax.tax.electronic_notice.check_status |
| /hometax/products/v1/a/t1/refund-detail | hometax.tax.refund.search_detail |
| /hometax/products/v1/a/t1/unclaimed-refund | hometax.tax.unclaimed_refund.search |
| /hometax/products/v1/a/t1/notice-history | hometax.tax.notice.search_history |
| /hometax/products/v1/a/t1/overdue-history | hometax.tax.overdue.search_history |
| /hometax/products/v1/a/t1/payment-statement | hometax.tax.payment_statement.search |
| /hometax/products/v1/a/t1/payment-statement-submit-history | hometax.tax.payment_statement.search_submit_history |
| /hometax/products/v1/a/t1/trade-partner-list | hometax.tax.trade_partner.search_list |
| /hometax/products/v1/a/t1/credit-card-sales-data | hometax.tax.credit_card.search_sales_data |
| /hometax/products/v1/a/cr1/sales-history | hometax.cash_receipt.sales.search_history |
| /hometax/products/v1/a/cr1/sales-summary | hometax.cash_receipt.sales.search_summary |
| /hometax/products/v1/a/cr1/purchase-history | hometax.cash_receipt.purchase.search_history |
| /hometax/products/v1/a/cr1/issue-individual | hometax.cash_receipt.issue_individual |
| /hometax/products/v1/a/cr1/daily-issue | hometax.cash_receipt.daily_issue.search |
| /hometax/products/v1/a/cr1/modify-daily-issue | hometax.cash_receipt.daily_issue.modify |
| /hometax/products/v1/a/cr1/cancel-daily-issue | hometax.cash_receipt.daily_issue.cancel |
v1 action 별칭
| 별칭 | 정본 action |
|---|---|
| fetch_invoices | hometax.etax.invoice.search_list |
| fetch_cash_receipts | hometax.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 |
이 액션들은 공개 문서 대상이 아닙니다. 이전 연동을 옮길 수 있게 상품으로 올려 둔 액션은 Job API 가 받고, 상품으로 올라 있지 않은 액션은 요청해도 403 POLICY_PROVIDER_FORBIDDEN 으로 거절됩니다. 상태 확인용 경로 /hometax/products/v1/a/s1/health 는 x-api-key 헤더로 부르는 예전 방식이고 OpenAPI 문서에만 있습니다.