Destroy Tickets

Description

銷毀票券。

Resource

POST /v1/ticket/destruction

Authorization

採用 OAuth 2.0 Bearer Token，詳細使用流程請參考 Auth Login。

Request Body Parameters

Name	Type	Description
id	string	任務編號/訂單編號 (option)
ticket_id_list	List[string]	票劵編號列表 (option)

Request Example

{
  "id": "test21092200001",
  "ticket_id_list": [
    "A001",
    "B001"
  ]
}

Response

Status-Code: 204 No Content

Destroy Tickets API Workflow

sequenceDiagram
  autonumber
  participant C as Client
  participant OP as OmniPlatform

  C->>OP: Call Destroy Tickets API
  activate OP
  alt params['id'] != ''
    OP->>OP: Call destroy_tickets_by_id(params['id'])
    OP->>C: Return Response()
  end
  alt params['ticket_id_list'] != ''
    OP->>OP: Call destroy_tickets_by_ticket_id_list(params['ticket_id_list'])
    OP->>C: Return Response()
  end
  OP->>C: Return Response(400, "缺少請求參數 id 或 ticket_id_list")
  deactivate OP

Destroy Tickets By ID Workflow

sequenceDiagram
  autonumber
  participant O as Object
  participant DTBI as destroy_tickets_by_id()
  participant R as repository

  O->>DTBI: Call destroy_tickets_by_id(id)
  activate DTBI
  DTBI->>R: Call get_ticket_by_id(company_id, id)
  Note Over DTBI,R: 透過任務/訂單編號取得 ticket_df
  alt if ticket_df.empty
    DTBI->>O: Return Response(204)
  end
  alt if use_ticket_df.empty
    DTBI->>O: Return Response(400, message='已使用票券')
  end
  DTBI->>DTBI: Call handle_ticket_df(ticket_df, id)
  alt if need_destroy_to_pos
    DTBI->>DTBI: Call destroy_ticket_to_pos(ticket_df, id)
    alt if destroy_ticket_to_pos_result['status_code'] != 204
      DTBI->>O:return destroy_ticket_to_pos_result
    end
  end
  DTBI->>R: Call update_ticket_isuse_status(company_id, ticket_id_list, '4')
  DTBI->>O: Return Response(204)
  deactivate DTBI

Destroy Tickets By Ticket ID List Workflow

sequenceDiagram
  autonumber
  participant O as Object
  participant DTBTIL as destroy_tickets_by_ticket_id_list(()
  participant R as repository

  O->>DTBTIL: Call destroy_tickets_by_ticket_id_list(ticket_id_list)
  activate DTBTIL
  DTBTIL->>DTBTIL: Call destroy_ticket_to_pos(ticket_df, id)
  alt if destroy_ticket_to_pos_result['status_code'] != 204
    DTBTIL->>O:return destroy_ticket_to_pos_result
  end
  DTBTIL->>R: Call update_ticket_isuse_status(company_id, ticket_id_list, '4')
  DTBTIL->>O: Return Response(204)
  deactivate DTBTIL