【公開停止】提供明細取得API

CAREKARTEから提供明細のCSVを取得するAPI

リクエストで指定した月に請求処理をされたデータをCSV形式で取得可能です。

 

APIから返却されたデータはCSV形式への変換に以下の作業が必要です。
・Bodyのcalcresultとivの値をBase64デコードする
・APIキーをMD5ハッシュ化し、128bitのAES復号化キーを生成する
・Base64デコードしたcalcresultの値はAES暗号化されている為、AES復号化キーとivを使用し、AES復号化する
・AES復号化した値は圧縮データとなっている為、gzip解凍する

なお、文字コードはUTF-8となっているため、
CSVファイルとして保存する場合は文字コードをShift-JISへ変換をお願いします。

API ID

KH0001

Request URL

recekh/recelist/select
環境 URL
Staging環境 https://stage-api.link.carekarte.jp/recekh/recelist/select
環境 URL
本番環境 https://api.link.carekarte.jp/recekh/recelist/select

HTTPメソッド

POST

リクエスト

ヘッダー

名前 必須
Content-Type application/json
Authorization tokenサービスで取得した値を設定

 

ボディ

パラメータ名 物理パラメータ名 必須 文字種/形式 備考
取得したい請求月 claimedMonth String YYYY-MM-DD 月初日をセットする

提供明細CSVを取得するサンプルリクエストデータ (実際にリクエストしても使用できません)

//コード1 recekh/recelistをリクエスト

URL:recekh/recelist/select

HTTPメソッド:POST

header:
Authorization:Bearer eyJhbGc…
Content-Type:application/json

body:
{ 
    "claimedMonth":"2023-07-01",
}

レスポンス

ボディ

パラメータ 必須:○ サイズ・形式 説明
calcresult String AES暗号化後、Base64エンコードされたgzip圧縮ファイルデータの文字列 (以下の作業がクライアント側で必要) 1.Base64文字列のデコード 2.AES復号化 (Key:APIキーをMD5ハッシュ化した128bitの文字列。初期ベクトルはパラメータ「iv」のbase64デコードした値) 3.復号化したgzip圧縮データを解凍し、CSVファイルを取得する 4.文字コードはUTF-8になっている為、ファイルとして保存する場合はShift-JISに変換する
iv String AES暗号化の初期ベクトル IVはbyte型のためBase64エンコードされた値(以下の作業がクライアント側で必要) 1.Base64文字列のデコード

 

{
    "calcresult": "zMnlMTXW7J8HZ9……",
    "iv": "AcOK5tp2sR6zroxDl6YgyA=="
}

エラーレスポンス

エラーレスポンスを参照してください。

連携イメージ(CAREKARTE)

提供明細CSVの内容について

■CSVファイルの注意点 請求金額の確認は「行区分」が「明細行」以外の行をご参照ください。 介護保険の計算方法として、月のすべての単位数に地域単価等を適用し端数が切り捨てられる等の処理が行われています。 そのため明細行に表示されている金額は、その結果を単価や回数に応じて分配して便宜上表示しているものとなるため、合計に対して数円単位の誤差が発生する可能性がございます。 「行区分」について 利用者合計行・・・1ヶ月に1行表示されます。最終的な金額についてはこちらを参照ください。 保険者合計行・・・その月に利用のあったサービスの保険者数分表示されます。保険者ごとの最終的な金額はこちらを参照ください。 事業所合計行・・・その月に利用のあったサービス種別分が保険者ごとに表示されます。サービスごとの最終的な金額はこちらを参照ください。 請求行・・・通常は保険者、事業所別に国保請求、個人請求に分かれて表示されます。また、公費や減免などの状況により行数が変化します。該当する明細行の総金額はこちらを参照ください。 ■その他のヘッダについては以下を参照ください。 ※制度改正などの影響で項目数は今後増減する可能性があります。 そのため、データ取得の際は列数ではなく区分名にて参照するようお願いいたします。

大項目 区分名(日本語) 区分名(英語) 備考1
キー 行区分 rowtype 計画単位数行、限度外単位行、限度対象単位行、支給限度超え単位行、事業所合計行、請求行、保険者合計行、明細行、利用者合計行が表示。そのうち正確な単位・金額を表示している行は「請求行」となります。その他の行は合計から割返した値を便宜上表示しており、正確なものではない場合があります。
キー 対象者コード daicd CAREKARTE上の個人番号
キー 対象者カナ kananame  
キー 対象者名称 name  
キー 被保険者番号 hhcd  
キー 保険者番号 hocd  
キー 保険者名 honm  
キー 介護度 gklv  
キー 性別 gender  
キー サービス提供月 srvsdate 請求対象となるサービスを提供した月
キー 国保請求月 recedatekokuho 国保請求処理を行った月(通常サービス提供月の翌月に処理を行うことが多いですが、返礼などの場合は翌月以降となる場合があります。また、個人請求に影響しない加算の漏れ等が発生した場合は、国保請求処理月のみ翌月以降となる場合があります。)
キー 個人請求月 recedatekojin 個人請求処理を行った月(通常サービス提供月の翌月に処理を行うことが多いですが、返礼などの場合は翌月以降となる場合があります。また、実費の入れ忘れなどで個人請求のみが翌月以降の処理月となる場合がございます。)
キー 種別 jsrvkbncd 介護保険におけるサービス種類コード
キー 事業所コード jigcd 事業所番号
キー 指定 shitei サテライト事業所など、事業所番号、サービス種別が同じ場合にCAREKARTE上で事業所を区別するために発行している番号
キー 事業所名 jignm  
キー 日付 sdate  
キー 開始 stime  
キー 終了 etime  
キー サービス種別 kindnm 明細行は「介護福祉施設」といった介護保険上のサービス名、「生活保護」などの公費名、「日常生活費」などの種別、「請求行」や「事業所合計行」などには「保険対象外実日数」「事業所合計」など
キー コード srvcd 介護保険上のサービスコードが表示されます
キー サービス内容 srvnm 基本サービスや加算名、実費名など
キー 科目コード kmkcd 実費それぞれに設定された科目コード
キー 科目名 kmknm 実費それぞれに設定された科目名
キー 商品コード productid 福祉用具関連項目
キー JAN/TAISコード taiscd 福祉用具関連項目
キー 商品名 productnm 福祉用具関連項目
キー 単位数識別記号 type 福祉用具関連項目
キー 合成単位 taniSrc 事業所割引適用前の単位数
キー 割引率% discount 事業所体制における割引率
金額 基準額(円) basePay 食費居住費の基準額
金額 実際の費用 hosokSumPrice 施設が提供する食費居住費の費用
金額 負担限度(円) limitPay 負担限度額認定証で定められた負担限度額
金額 単位 taniDst ※参考値
金額 回数 countSum  
金額 合計単位 taniSum ※参考値
金額 請求方法 paykbn 国保請求「国」 公費請求「公」
金額 給付率 insura  
金額 第1公費 kouhi1 公費負担割合
金額 第2公費 kouhi2 公費負担割合
金額 第3公費 kouhi3 公費負担割合
金額 地域単価 areacost  
金額 保険+公費負担額 insurSum ※明細行は参考値
金額 保険分自己負担額 insuraOwn ※明細行は参考値
金額 全額自己負担金額 insoutOwn ※明細行は参考値
金額 社福軽減額 ___sfk ※明細行は参考値
金額 自治体独自助成等 ___jsi ※明細行は参考値
金額 高額介護サ費 ___kougk ※明細行は参考値
金額 医療費控除対象額 medTarget  
金額 利用者請求額 ___riyouPay ※明細行は参考値
金額 サービス費用総額 sumPrice ※明細行は参考値
金額 消費税 ___zei ※明細行は参考値
金額 消費税内訳(8%) zei8 ※明細行は参考値
金額 消費税内訳(10%) zei10 ※明細行は参考値
金額 補足給付(円) hosokPay ※明細行は参考値
金額 生保支払(円) seihoPay ※明細行は参考値
金額 福祉事務所(円) fukusPay ※明細行は参考値
金額 自己負担(円) hoskOwn ※明細行は参考値
金額 調整額(円) adjustPay ※明細行は参考値
日別利用回数 1 DAY1  
日別利用回数 2 DAY2  
日別利用回数 3 DAY3  
日別利用回数 4 DAY4  
日別利用回数 5 DAY5  
日別利用回数 6 DAY6  
日別利用回数 7 DAY7  
日別利用回数 8 DAY8  
日別利用回数 9 DAY9  
日別利用回数 10 DAY10  
日別利用回数 11 DAY11  
日別利用回数 12 DAY12  
日別利用回数 13 DAY13  
日別利用回数 14 DAY14  
日別利用回数 15 DAY15  
日別利用回数 16 DAY16  
日別利用回数 17 DAY17  
日別利用回数 18 DAY18  
日別利用回数 19 DAY19  
日別利用回数 20 DAY20  
日別利用回数 21 DAY21  
日別利用回数 22 DAY22  
日別利用回数 23 DAY23  
日別利用回数 24 DAY24  
日別利用回数 25 DAY25  
日別利用回数 26 DAY26  
日別利用回数 27 DAY27  
日別利用回数 28 DAY28  
日別利用回数 29 DAY29  
日別利用回数 30 DAY30  
日別利用回数 31 DAY31