店舗向け
購買データAPI
電子レシート・売上・購買履歴を取得し、販売分析やCRMに活用できます。店舗の売上データを外部システムと連携する基盤APIです。
api/v1/store/receipts
APIリファレンスで確認
エンドポイント一覧
| メソッド | パス | 説明 | レスポンス |
|---|---|---|---|
| GET |
/api/v1/store/receipts/{id}
|
レシート詳細を取得
指定IDの電子レシートを取得します。商品名、価格、店舗情報、購入日時などが含まれます。
|
200 404 |
| GET |
/api/v1/store/receipts/search
|
レシートを検索
店舗IDまたは日付範囲でレシートデータを検索します。
|
200 |
| POST |
/api/v1/store/receipts/
|
レシートを作成・更新（Upsert）
新しいレシートを作成するか、IDが既存の場合は更新します。
|
200 |
| DELETE |
/api/v1/store/receipts/{id}
|
レシートを削除
指定IDのレシートを削除します。
|
204 404 |
エンドポイント詳細
指定IDの電子レシートを取得します。商品名、価格、店舗情報、購入日時などが含まれます。
完全パス：
GET /api/v1/store/receipts/{id}
レスポンスコード：
200
404
店舗IDまたは日付範囲でレシートデータを検索します。
完全パス：
GET /api/v1/store/receipts/search
レスポンスコード：
200
新しいレシートを作成するか、IDが既存の場合は更新します。
完全パス：
POST /api/v1/store/receipts/
レスポンスコード：
200
指定IDのレシートを削除します。
完全パス：
DELETE /api/v1/store/receipts/{id}
レスポンスコード：
204
404
リクエスト例
リクエスト
GET /api/v1/store/receipts/{id}
Authorization: Bearer {access_token}
レスポンス
{
"id": "rcp-8421093",
"store": "Example Store",
"total": 842,
"items": [
{ "name": "コーヒーM", "price": 180 },
{ "name": "サンドイッチ", "price": 420 }
],
"timestamp": "2025-11-11T10:32:45Z"
}
認証について
このAPIを利用するには、Authorization: Bearer {access_token} ヘッダーが必要です。
トークンの取得方法は認証ガイドをご確認ください。