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
KH0002
Request URL
recekh/recelist/select2
| 環境 | URL |
|---|---|
| Staging環境 | https://stage-api.link.carekarte.jp/recekh/recelist/select2 |
| 環境 | URL |
|---|---|
| 本番環境 | https://api.link.carekarte.jp/recekh/recelist/select2 |
HTTPメソッド
POST
リクエスト
ヘッダー
| 名前 | 必須 | 値 |
| Content-Type | ○ | application/json |
| Authorization | ○ | tokenサービスで取得した値を設定 |
ボディ
| パラメータ名 | 物理パラメータ名 | 必須 | 型 | 文字種/形式 | 備考 |
| 取得したい請求月 | claimedMonth | ◯ | String | YYYY-MM-DD | 月初日をセットする |
提供明細CSVを取得するサンプルリクエストデータ （実際にリクエストしても使用できません）
//コード1 recekh/recelist2をリクエスト
URL：recekh/recelist/select2
HTTPメソッド：POST
header：
Authorization：Bearer eyJhbGc…
Content-Type：application/json
body：
{
"claimedMonth":"2025-12-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ファイルの注意点
請求金額の確認は「rowtype（行区分）」が「明細行」以外の行をご参照ください。
介護保険の計算方法として、月のすべての単位数に地域単価等を適用し端数が切り捨てられる等の処理が行われています。
そのため明細行に表示されている金額は、その結果を単価や回数に応じて分配して便宜上表示しているものとなるため、合計に対して数円単位の誤差が発生する可能性があります。
「rowtype（行区分）」の種類について
請求行・・・通常は保険者、事業所別に表示されます。また、公費や減免などの状況により行数が変化します。該当する明細行の総金額はこちらを参照ください。
事業所合計行・・・その月に利用のあったサービス種別分が保険者ごとに表示されます。サービスごとの最終的な金額はこちらを参照ください。
■その他のヘッダについては以下を参照ください。
※制度改正などの影響で項目数は今後増減する可能性があります。 そのため、データ取得の際は列数ではなく区分名にて参照するようお願いいたします。
| 列名 | 列名（日本語） | 備考１ |
| rowtype | 行区分 | 明細行、支給限度超え単位行、計画単位数行、限度対象単位行、限度外単位行、請求行、事業所合計行が表示される。 （そのうち正確な単位・金額を表示している行は「請求行」となります。その他の行は合計から割返した値を便宜上表示しており、正確なものではない場合があります。） |
| daicd | 対象者コード | CAREKARTE上の利用者個人番号 （左から0埋め10桁） |
| kananame | 対象者カナ | |
| name | 対象者名称 | |
| hhcd | 被保険者番号 | 左から0埋め10桁 |
| hocd | 保険者番号 | 221028など |
| honm | 保険者名 | 静岡市駿河区など |
| gklv | 介護度 | 非該当 経過的要介護 事業対象者 要支援１ 要支援２ 要介護１ 要介護２ 要介護３ 要介護４ 要介護５ 再調査 取消 |
| gender | 性別 | 男、女 |
| srvsdate | サービス提供月 | 請求対象となるサービスを提供した月（YYYY-MM-DD） |
| recedatekokuho | 国保請求月 | 国保請求処理を行った月 （個人請求時のデータを取得する為、値は入りません。） |
| recedatekojin | 個人請求月 | 個人請求処理を行った月（YYYY-MM-DD） （通常はサービス提供月の翌月に処理を行うことが多いですが、返礼などの場合は翌月以降となる場合があります。また、実費の入れ忘れなどで個人請求のみが翌月以降の処理月となる場合もあります。） |
| jsrvkbncd | 種別 | 介護保険におけるサービス種類コード |
| jigcd | 事業所コード | 事業所番号（10桁） |
| shitei | 指定 | サテライト事業所など、事業所番号、サービス種別が同じ場合にCAREKARTE上で事業所を区別するために発行している番号 （左から0埋め2桁） |
| jignm | 事業所名 | |
| sdate | 日付 | （未使用） |
| stime | 開始 | （未使用） |
| etime | 終了 | （未使用） |
| kindnm | サービス種別 | 明細行は「介護福祉施設」といった介護保険上のサービス名、「生活保護」などの公費名、「日常生活費」などの種別、 明細行以外には「保険対象外実日数」「事業所合計」など |
| srvcd | コード | 介護保険上のサービスコード （サービス種別コード2桁＋サービスコード4桁の6桁） |
| srvnm | サービス内容 | 明細行は基本サービス名、加算名、実費名、 明細行以外には「▲支給限度基準を超える単位」や「計画単位数④」などの行のラベル |
| kmkcd | 科目コード | 各実費に設定された科目コード （左から0埋め4桁） |
| kmknm | 科目名 | 各実費に設定された科目名 |
| productid | 商品コード | 福祉用具関連項目（最大8桁） |
| taiscd | JAN/TAISコード | 福祉用具関連項目（00160-000243など） |
| productnm | 商品名 | 福祉用具関連項目 |
| type | 単位数識別記号 | 福祉用具関連項目 |
| taniSrc | 合成単位 | 事業所割引適用前の単位数 |
| discount | 割引率％ | 事業所体制における割引率 |
| basePay | 基準額(円) | 食費居住費の基準額 |
| hosokSumPrice | 実際の費用 | 施設が提供する食費居住費の費用 |
| limitPay | 負担限度(円) | 負担限度額認定証で定められた負担限度額 |
| taniDst | 単位 | |
| countSum | 回数 | |
| taniSum | 合計単位 | |
| paykbn | 請求方法 | 国保請求は「国」、公費請求は「公」 |
| insura | 給付率 | 利用者が1割負担の場合は90など |
| kouhi1 | 第１公費 | 公費負担割合 |
| kouhi2 | 第２公費 | 公費負担割合 |
| kouhi3 | 第３公費 | 公費負担割合 |
| areacost | 地域単価 | 10.27など |
| insurSum | 保険＋公費負担額 | |
| insuraOwn | 保険分自己負担額 | |
| insoutOwn | 全額自己負担金額 | |
| ___sfk | 社福軽減額 | 社会福祉法人の減免額 |
| ___sfk_Tekiyo | 社福軽減摘要 | 社会福祉法人の減免がある場合の摘要 （「ｻｰﾋﾞｽ費\18,435うち1%減額, 食費\60,000うち2%減額, 居住費\30,000うち3%減額」など） |
| ___jsi | 自治体独自助成等 | 自治体独自助成等の減免額 |
| ___jsi_Tekiyo | 自治体独自助成摘要 | 自治体独自助成等の減免がある場合の摘要 （「ｻｰﾋﾞｽ費総額\13,248うち5%減額, 自費\600うち5%減額」など） |
| ___kougk | 高額介護サ費 | 高額介護サービス費 |
| medTarget | 医療費控除対象額 | |
| medTarget_Tekiyo | 医療費控除摘要 | 医療費控除対象がある場合の摘要 |
| ___riyouPay | 利用者請求額 | |
| sumPrice | サービス費用総額 | |
| ___zei | 消費税 | |
| zei8 | 消費税内訳(8%) | |
| zei10 | 消費税内訳(10%) | |
| hosokPay | 補足給付(円) | |
| seihoPay | 生保支払(円) | |
| fukusPay | 福祉事務所(円) | |
| hoskOwn | 自己負担(円) | |
| adjustPay | 調整額(円) | |
| Kojin_Tekiyo | 個人請求書摘要 | |
| DAY1 | 1 | 明細行の日毎のサービス利用実績数 |
| DAY2 | 2 | 明細行の日毎のサービス利用実績数 |
| DAY3 | 3 | 明細行の日毎のサービス利用実績数 |
| DAY4 | 4 | 明細行の日毎のサービス利用実績数 |
| DAY5 | 5 | 明細行の日毎のサービス利用実績数 |
| DAY6 | 6 | 明細行の日毎のサービス利用実績数 |
| DAY7 | 7 | 明細行の日毎のサービス利用実績数 |
| DAY8 | 8 | 明細行の日毎のサービス利用実績数 |
| DAY9 | 9 | 明細行の日毎のサービス利用実績数 |
| DAY10 | 10 | 明細行の日毎のサービス利用実績数 |
| DAY11 | 11 | 明細行の日毎のサービス利用実績数 |
| DAY12 | 12 | 明細行の日毎のサービス利用実績数 |
| DAY13 | 13 | 明細行の日毎のサービス利用実績数 |
| DAY14 | 14 | 明細行の日毎のサービス利用実績数 |
| DAY15 | 15 | 明細行の日毎のサービス利用実績数 |
| DAY16 | 16 | 明細行の日毎のサービス利用実績数 |
| DAY17 | 17 | 明細行の日毎のサービス利用実績数 |
| DAY18 | 18 | 明細行の日毎のサービス利用実績数 |
| DAY19 | 19 | 明細行の日毎のサービス利用実績数 |
| DAY20 | 20 | 明細行の日毎のサービス利用実績数 |
| DAY21 | 21 | 明細行の日毎のサービス利用実績数 |
| DAY22 | 22 | 明細行の日毎のサービス利用実績数 |
| DAY23 | 23 | 明細行の日毎のサービス利用実績数 |
| DAY24 | 24 | 明細行の日毎のサービス利用実績数 |
| DAY25 | 25 | 明細行の日毎のサービス利用実績数 |
| DAY26 | 26 | 明細行の日毎のサービス利用実績数 |
| DAY27 | 27 | 明細行の日毎のサービス利用実績数 |
| DAY28 | 28 | 明細行の日毎のサービス利用実績数 |
| DAY29 | 29 | 明細行の日毎のサービス利用実績数 |
| DAY30 | 30 | 明細行の日毎のサービス利用実績数 |
| DAY31 | 31 | 明細行の日毎のサービス利用実績数 |