Add Stamp - Gofive OpenAPI

เพิ่มแสตมป์ให้พนักงาน

เพิ่มแสตมป์จากระบบภายนอกให้พนักงาน โดย resolve CompanyName, EmployeeNo และ StampCardName
ภายใน tenant แล้วใช้ stamp engine เดียวกับระบบหลัก
ระบบสมัครบัตรให้พนักงานอัตโนมัติเมื่อยังไม่มีบัตรที่ active และแจ้งผลผ่าน AutoEnrolled

📋 ต้องมีข้อมูลก่อนเรียก — ตรวจรายการบัตรได้จาก GET /api/v1/stamp-cards

บัตรสะสมชื่อ StampCardName ต้องถูกสร้างไว้แล้วใน tenant (เทียบชื่อแบบตรงตัว)

บัตรต้องยังเปิดใช้งานและไม่หมดอายุ

ถ้าเป็นบัตรแบบสะสมครั้งเดียว พนักงานคนนั้นต้องยังสะสมไม่ครบ

🔐 ต้องมีสิทธิ์ Open API โมดูล StampCard ระดับ ReadAndWrite

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Example

{
    "CompanyName": "Acme",
    "EmployeeNo": "EMP001",
    "StampCardName": "Team Star",
    "StampAmount": 2,
    "OccurredAt": "2026-07-01T09:30:00Z",
    "Remark": "Awarded from partner campaign"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

เพิ่มแสตมป์สำเร็จและคืนยอดปัจจุบันหลังทำรายการ

Bodyapplication/json

Example

{
    "StatusCode": 200,
    "Message": "Success",
    "Data": {
        "StampCardId": 301,
        "StampCardName": "Team Star",
        "EmployeeNo": "EMP001",
        "StampAmount": 2,
        "CurrentStampCount": 6,
        "TotalStamp": 10,
        "IsCompleted": false,
        "AutoEnrolled": false,
        "TransactionDate": "2026-07-01T09:30:05Z"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429Too Many Requests

🔴500Server Error