🎫工單

通用資料

此區為工單相關對應資料,如「狀態」、「優先度」等代碼。

狀態 statuses

名稱

待處理

0

處理中

1

已解決

2

已關閉

3

優先度 priority

名稱

0

1

2

緊急

3

搜尋工單

根據各種條件搜尋工單,詳細介紹請參考下表

除了工單本身資訊以外,也包含關聯的客戶,分類,子分類,聯絡記錄,處理人員,業主等資訊。

Query Parameters

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

page

false

1

Number

目前在第幾頁

per_page

false

15

Number

每頁呈現多少筆

search

false

NULL

String

模糊搜尋工單標題和內容

contact_id

false

NULL

Number

客戶 id

statuses

false

NULL

Array

工單狀態 < 0: 待處理 1: 處理中 2: 已解決 3: 已關閉 >

due_at__start

false

NULL

Datetime

截止日期時間(起始)

due_at__end

false

NULL

Datetime

截止日期時間(結束)

created_at__start

false

NULL

Datetime

建立日期時間(起始)

created_at__end

false

NULL

Datetime

建立日期時間(結束)

sponsor_id

false

NULL

Number

業主 id

termination_code_ids

false

NULL

Array

狀態細項 id 陣列

handler_ids

false

NULL

Array

處理工單的員工之 id 陣列

creater_ids

false

NULL

Array

建立工單的員工之 id 陣列

Response

PROPERTY

TYPE

DESCRIPTION

data

Array of objects

meta

Object

Pagination meta

取得工單

新建工單

Form Data

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

sponsor_id

false

NULL

Number

業主的 id

handler_id

false

NULL

Number

處理員工的 id

termination_code_id

false

NULL

Number

狀態細項的 id

subject

true

NULL

String

工單標題

content

true

NULL

String

工單內容

due_at

false

NULL

Datetime

工單截止時間

priority

false

0(最低)

Number

工單優先等級

status

false

0(待處理)

Number

工單處理狀態

status_memo

false

NULL

String

工單狀態備註

sub_category_id

false

NULL

Number

子分類

contact_id

false

NULL

Number

客戶的id

Response

請參考 工單 回應格式

PROPERTY

TYPE

DESCRIPTION

data

Object

檢視工單

URL Parameters

PARAMETER

DESCRIPTION

id

工單 id

Response

請參考 工單 回應格式

更改工單

URL Parameters

PARAMETER

DESCRIPTION

id

工單 id

Form Data

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

sponsor_id

false

NULL

Number

業主的 id

handler_id

false

NULL

Number

處理員工的 id

termination_code_id

false

NULL

Number

狀態細項的 id

subject

false

NULL

String

工單標題

content

false

NULL

String

工單內容

due_at

false

NULL

Datetime

工單截止時間

priority

false

0(最低)

Number

工單優先等級

status

false

0(待處理)

Number

工單處理狀態

status_memo

false

NULL

String

工單狀態備註

sub_category_id

false

NULL

Number

子分類

contact_id

false

NULL

Number

客戶的id

Response

請參考 工單 回應格式

刪除工單

Http status 為 204

URL Parameters

PARAMETER

DESCRIPTION

id

工單 id

查詢員工

Query Parameters

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

page

false

1

Number

目前在第幾頁

per_page

false

15

Number

每頁呈現多少筆

search

false

NULL

String

模糊搜尋員工姓名,身分證,員工編號

Response

PROPERTY

TYPE

DESCRIPTION

data

Array of objects

meta

Object

Pagination meta

查詢業主

Response

PROPERTY

TYPE

DESCRIPTION

data

Array of objects

meta

Object

Pagination meta

查詢工單狀態細項

Query Parameters

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

page

false

1

Number

目前在第幾頁

per_page

false

15

Number

每頁呈現多少筆

search

false

NULL

String

模糊搜尋員工姓名,身分證,員工編號

Response

PROPERTY

TYPE

DESCRIPTION

data

Array of objects

meta

Object

Pagination meta

Response

PROPERTY

TYPE

DESCRIPTION

id

Number

狀態細項 id

name

String

狀態細項名稱

description

String

狀態細項敘述

status

Number

對應的工單狀態 <0: 待處理 1: 處理中 2: 已完成 3: 已關閉>

creater_id

Number

該狀態細項的建立員工之id

查詢主分類

Query Parameters

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

page

false

1

Number

目前在第幾頁

per_page

false

15

Number

每頁呈現多少筆

Response

PROPERTY

TYPE

DESCRIPTION

data

Array of objects

meta

Object

Pagination meta

查詢子分類

Query Parameters

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

page

false

1

Number

目前在第幾頁

per_page

false

15

Number

每頁呈現多少筆

category_id

false

Number

所屬的主分類id

Response

PROPERTY

TYPE

DESCRIPTION

data

Array of objects

meta

Object

Pagination meta

Last updated