เริ่มต้นใช้งาน
ข้อมูลหลัก
อื่นๆ

ประวัติการทำงาน

Info
ประวัติการทำงานรองรับเฉพาะใน API เวอร์ชัน 2 (/api/partner/v2/add/requests/career_history) คำขอต้องใช้ write.career_history OAuth scope

คำอธิบายฟิลด์

ดู OpenAPI specification สำหรับสคีมาแบบเต็ม (รวมถึงฟิลด์ที่ไม่บังคับ)
{
  "credential_id": { "type": "string" }, // (Required) Unique identifier for this credential payload
  "fields": { // { "type": "object" }, (Required)
    "full_name": { "type": "string" }, // (Required)
    "employment" : [
      {
        "organisation": { "type": "string" }, // (Required) Name of the company or employer
        "role_classification": { "type": "string" }, // Category or type of the position held
        "role_title": { "type": "string" }, // Official job title for the employment period
        "start_date": { "type": "string", "format": "date" }, // (Required) Date employment began, Date format: "YYYY-MM"
        "end_date": { "anyOf": [ { "type": "string", "format": "date"}, { "type": "null" }] }, // Date employment ended, Date format: "YYYY-MM"
        "last_processed_month": { "type": "string", "format": "date" }, // (Required) Most recent month for which employment data was updated, Date format: "YYYY-MM"
      }
    ]
  },
  "partner_chain": { "type": ["array", "null"] } // (Optional unless otherwise specified) Array of objects to specifiy partner institutions, e.g. [{ "name": "Partner Organization" }]
}

การใช้ประโยชน์จากฟิลด์ประวัติการทำงาน

ด้านล่างนี้คือคำอธิบายโดยละเอียดสำหรับแต่ละฟิลด์ในข้อมูลรับรองประวัติการทำงาน คำอธิบายเหล่านี้มีไว้เพื่อช่วยให้พาร์ทเนอร์เข้าใจวัตถุประสงค์และการใช้งานที่ถูกต้องของแต่ละฟิลด์:

ฟิลด์ของอ็อบเจ็กต์ข้อมูลรับรอง

  • full_name: ชื่อเต็มตามกฎหมายของบุคคลที่กำลังอธิบายประวัติการทำงาน ชื่อนี้ต้องตรงกับชื่อที่ปรากฏในเอกสารทางการ
  • employment: อาร์เรย์ของระเบียนการจ้างงาน โดยแต่ละรายการแสดงช่วงเวลาการจ้างงานที่แยกจากกัน

ฟิลด์ของอ็อบเจ็กต์การจ้างงาน

  • organisation: ชื่อบริษัทหรือผู้ประกอบการที่บุคคลนั้นทำงานด้วย ควรเป็นชื่อทางการหรือชื่อที่องค์กรเป็นที่รู้จักทั่วไป
  • role_classification: หมวดหมู่หรือประเภททั่วไปของบทบาทที่ดำรงอยู่ ควรเป็นป้ายกำกับกว้าง ๆ ที่เป็นมาตรฐาน เพื่ออธิบายประเภทของงานที่ทำ เช่น "Software Engineer", "Accountant", "Project Manager" หรือ "Sales Representative"
  • role_title: ชื่อตำแหน่งงานเฉพาะที่บุคคลนั้นดำรงในช่วงเวลาการจ้างงานนี้ ควรเป็นชื่อตำแหน่งทางการที่ผู้ประกอบการใช้ เช่น "Associate Software Engineer", "Senior Manager" หรือ "Sales Executive" ซึ่งสะท้อนชื่อตำแหน่งที่บันทึกไว้ตามสัญญาจ้างงาน สลิปเงินเดือน หรือเอกสารทางการอื่น ๆ
หมายเหตุ: สำหรับระเบียนการจ้างงานแต่ละรายการ ต้องระบุอย่างน้อยหนึ่งฟิลด์ระหว่าง role_classification หรือ role_title แนะนำให้ระบุทั้งสองฟิลด์เพื่อความชัดเจน แต่หากมีเพียงฟิลด์เดียว โปรดตรวจสอบให้แน่ใจว่าฟิลด์นั้นมีข้อมูล
  • start_date: เดือนและปีที่เริ่มการจ้างงาน จัดรูปแบบเป็น "YYYY-MM" ฟิลด์นี้จำเป็นต้องระบุ
  • end_date: เดือนและปีที่สิ้นสุดการจ้างงาน จัดรูปแบบเป็น "YYYY-MM" หากบุคคลนั้นยังทำงานอยู่ อาจละเว้นฟิลด์นี้ได้
  • last_processed_month: เดือนล่าสุดที่มีการอัปเดตข้อมูลการจ้างงาน จัดรูปแบบเป็น "YYYY-MM" ฟิลด์นี้จำเป็นต้องระบุ และควรสะท้อนเดือนล่าสุดที่มีการยืนยันสถานะการจ้างงานหรือรายละเอียดการจ้างงานแล้ว
หมายเหตุ: ฟิลด์วันที่ทั้งหมดต้องใช้รูปแบบ "YYYY-MM" (เช่น "2023-01")

ห่วงโซ่พาร์ทเนอร์

ฟิลด์ partner_chain ใช้เก็บความสัมพันธ์ระดับกลางในลำดับชั้นพาร์ทเนอร์แบบหลายชั้นที่ไม่ได้แสดงไว้ในส่วนอื่นของการผสานรวม ซึ่งช่วยเพิ่มความละเอียดของการวิเคราะห์ที่ SEEK Pass สามารถมอบให้คุณได้คลิกที่นี่เพื่อดูรายละเอียดเพิ่มเติม

ตัวอย่าง payload

{
  "credential_id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "fields": {
    "full_name": "John Doe",
    "employment": [
      {
        "organisation": "Company A",
        "role_classification": "Software Engineer",
        "role_title": "Associate Software Engineer",
        "start_date": "2020-01",
        "end_date": "2022-12",
        "last_processed_month": "2023-01"
      },
      {
        "organisation": "Company B",
        "role_classification": "Software Engineer",
        "role_title": "Senior Software Engineer",
        "start_date": "2023-02",
        "last_processed_month": "2024-05"
      }
    ]
  }
}