전자세금계산서 발행
hometax__etax__invoice__issueREQUIRES prior hometax__session__login call with same account_link_id. Issue an e-tax invoice to 국세청. IRREVERSIBLE: once issued the buyer is notified and it enters VAT filing; it can only be corrected by issuing a 수정세금계산서, and this service's modify tool only issues one that cancels the original in full (reasons 04 and 06). This writes to the institution. The first call is not executed: it returns a preview of exactly what will be sent and a one-time confirmation_token (error WRITE_CONFIRMATION_REQUIRED). Show that preview to the user as it is. Only after the user agrees, call again with the same arguments plus that confirmation_token. Never add the token without the user's agreement. Changing any argument makes the token invalid; call without the token to get a new preview. The preview shows the main values you sent; the supply amount and tax are computed by the server and are not in it. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"dmnr_bsno": "<dmnr_bsno>",
"item_name": "<item_name>",
"supply_date": "<supply_date>",
"bill_method": "<bill_method>",
"item_quantity": "<item_quantity>",
"item_unit_price": "<item_unit_price>"
},
"name": "hometax__etax__invoice__issue"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| splr_tin | No | 공급자 식별값(tin). 보통 입력하지 않습니다. 서버가 기관 응답과 로그인 세션에서 공급자 값을 채우고, 거기서 얻지 못할 때만 이 값을 씁니다. | |
| dmnr_bsno | Yes | Buyer business registration number (구매자 사업자등록번호, 10 digits) | |
| item_name | Yes | Item/service name (품목명) | |
| bill_method | Yes | Billing method (청구방법): '01'=영수, '02'=청구 | |
| splr_mpb_no | No | 공급자 종사업장번호. 주사업장이면 "0". Optional (기본 "0"). | |
| supply_date | Yes | Supply date YYYYMMDD (공급일자) | |
| etxiv_knd_cd | No | Invoice kind code (전자세금계산서 종류코드). Optional. The tax is 10% of the supply amount whatever this code is. | |
| etxiv_clsf_cd | No | Invoice class code (전자세금계산서 구분코드). Optional. The tax is 10% of the supply amount whatever this code is. | |
| item_quantity | Yes | Item quantity (수량) | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| item_unit_price | Yes | Unit price (단가, KRW) | |
| confirmation_token | No | 첫 호출이 돌려준 1회용 확인 토큰입니다(오류 WRITE_CONFIRMATION_REQUIRED). 같은 인자에 이 값을 그대로 넣어 다시 호출하면 실행됩니다. 10분 뒤 만료되고 한 번만 쓸 수 있습니다. |