日報タグ集計取得（タグ別）

GET

/daily_report_tags/summary/tag

curl --request GET \
  --url 'https://api.smaregi.dev/TARGET-CONTRACT-ID/timecard/daily_report_tags/summary/tag?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

1

Responses

200

取得成功

Media typeapplication/json

object

fromDate

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

string format: date

toDate

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

string format: date

summaryDivision

集計区分 tag: タグ別

string

Allowed values: tag

dailyReportTagSummary

タグ別日報タグ集計リスト

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": "tag",
  "dailyReportTagSummary": [
    {
      "dailyReportTagId": "1",
      "color": "#FF6B6B",
      "dailyReportTagName": "営業活動",
      "sortNum": "1",
      "showFlag": "1",
      "defaultFlag": "1",
      "dailyReportTagGroupCode": "1",
      "dailyReportTagDivisionCode": "1",
      "summary": "24.50"
    },
    {
      "dailyReportTagId": "2",
      "color": "#4ECDC4",
      "dailyReportTagName": "会議",
      "sortNum": "2",
      "showFlag": "1",
      "defaultFlag": "0",
      "dailyReportTagGroupCode": "",
      "dailyReportTagDivisionCode": "",
      "summary": "12.00"
    },
    {
      "dailyReportTagId": "3",
      "color": "#45B7D1",
      "dailyReportTagName": "資料作成",
      "sortNum": "3",
      "showFlag": "1",
      "defaultFlag": "0",
      "dailyReportTagGroupCode": "2",
      "dailyReportTagDivisionCode": "1",
      "summary": "8.50"
    }
  ]
}

400

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

Media typeapplication/json

object

type

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

string

title

エラーの概要

string

detail

エラーの詳細

string

Example

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