日報タグ集計取得（従業員別）

GET

/daily_report_tags/summary/staff

const url = 'https://api.smaregi.dev/TARGET-CONTRACT-ID/timecard/daily_report_tags/summary/staff?from_date=2020-05-01&to_date=2020-05-31&store_id=1';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.smaregi.dev/TARGET-CONTRACT-ID/timecard/daily_report_tags/summary/staff?from_date=2020-05-01&to_date=2020-05-31&store_id=1' \
  --header 'Authorization: Bearer <token>'

日報タグ集計（従業員別）を取得します

対象

プラン
- エンタープライズ、旧有料
オプション
- 日報

対象ユーザー権限

日報管理閲覧

Authorizations

AppAccessToken
timecard.daily-reports:read
UserAccessToken
timecard.daily-reports:read

Parameters

Query Parameters

from_date

required

string format: date

/^\d{4}-\d{2}-\d{2}$/

集計開始日 [YYYY-MM-DD]

Example

2020-05-01

to_date

required

string format: date

/^\d{4}-\d{2}-\d{2}$/

集計終了日 [YYYY-MM-DD]

Example

2020-05-31

store_id

string

事業所ID

Example

Responses

200

取得成功

application/json

object

fromDate

集計開始日 [YYYY-MM-DD]

string format: date

toDate

集計終了日 [YYYY-MM-DD]

string format: date

summaryDivision

集計区分 staff: 従業員別

string

Allowed values: staff

dailyReportTagSummary

従業員別日報タグ集計リスト

Array<object>

object

staffId

従業員ID

string

summary

合計時間（小数）（時間）

string

staffName

従業員名

string

tagSummary

タグ別集計リスト

Array<object>

object

dailyReportTagId

日報タグID

string

color

色コード

string

dailyReportTagName

タグ名

string

sortNum

表示順

string

showFlag

従業員に表示するかどうか

0: 非表示
1: 表示

string

Allowed values: 0 1

defaultFlag

デフォルトのタグかどうか

0: デフォルトでない
1: デフォルト

string

Allowed values: 0 1

dailyReportTagGroupCode

日報タググループコード

string

dailyReportTagDivisionCode

日報タグ区分コード

string

summary

タグ別合計時間（小数）（時間）

string

Example

{
  "fromDate": "2020-05-01",
  "toDate": "2020-05-31",
  "summaryDivision": "staff",
  "dailyReportTagSummary": [
    {
      "staffId": "1",
      "summary": "20.00",
      "staffName": "スマレジ太郎",
      "tagSummary": [
        {
          "dailyReportTagId": "1",
          "color": "#FF6B6B",
          "dailyReportTagName": "営業活動",
          "sortNum": "1",
          "showFlag": "1",
          "defaultFlag": "1",
          "dailyReportTagGroupCode": "1",
          "dailyReportTagDivisionCode": "1",
          "summary": "8.00"
        },
        {
          "dailyReportTagId": "5",
          "color": "#4ECDC4",
          "dailyReportTagName": "会議",
          "sortNum": "5",
          "showFlag": "1",
          "defaultFlag": "0",
          "dailyReportTagGroupCode": "",
          "dailyReportTagDivisionCode": "",
          "summary": "12.00"
        }
      ]
    },
    {
      "staffId": "2",
      "summary": "16.50",
      "staffName": "スマレジ花子",
      "tagSummary": [
        {
          "dailyReportTagId": "1",
          "color": "#FF6B6B",
          "dailyReportTagName": "営業活動",
          "sortNum": "1",
          "showFlag": "1",
          "defaultFlag": "1",
          "dailyReportTagGroupCode": "1",
          "dailyReportTagDivisionCode": "1",
          "summary": "16.50"
        }
      ]
    }
  ]
}

400

リクエストの形式が不正な場合

application/json

object

type

エラータイプを識別するURI、もしくはabout:blank

string

title

エラーの概要

string

detail

エラーの詳細

string

Example

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "開始日及び終了日はyyyy-mm-ddで入力してください。"
}