Portal Integrasi

Buka Portal Integrasi

Tambahkan ?page=integrasi di akhir URL sistem inventori. Misalnya:
https://script.google.com/.../?page=integrasi

Buat API Key untuk Sistem Absensi

Di bagian "API Key Integrasi", isi nama (contoh: "Sistem Absensi Pusat"), lalu klik Buat API Key Baru. API key akan muncul SEKALI saja — segera salin dan simpan di tempat yang aman.

Berikan API Key dan URL ke Developer Sistem Absensi

Developer sistem absensi membutuhkan dua hal: URL endpoint (ada di bagian "Contoh URL Endpoint") dan API key yang sudah dibuat. Berikan keduanya dengan aman.

Test Koneksi

Setelah API key dibuat, tempelkan ke bagian "Test Koneksi", isi Branch ID cabang mana saja, lalu klik Jalankan Test Koneksi. Jika berhasil, koneksi sudah siap.

Cek Status Laporan Cabang Secara Manual

Gunakan "Simulasi Cek Status Laporan" untuk melihat apakah cabang tertentu sudah laporan atau belum di tanggal tertentu. Tidak perlu API key — cukup pilih cabang dan tanggal.

Hubungi PIC Cabang

Minta staff cabang untuk segera membuka sistem inventori dan menyelesaikan laporan harian. Setelah laporan tersubmit, status otomatis berubah ke "boleh absen keluar".

Alur Integrasi

Ketika staff klik "Absen Keluar" di sistem absensi:

1. Sistem absensi panggil endpoint GET checkout-status dengan branch_id staff
2. Baca field can_checkout_attendance
3. Jika true → lanjutkan proses absen keluar
4. Jika false → tolak dan tampilkan field message ke staff

Request

GET [ENDPOINT_URL]?action=api.v1.integration.checkout-status
    &branch_id=CABANG_ID
    &date=YYYY-MM-DD       ← opsional
    &api_key=API_KEY_ANDA

Response Jika Sudah Laporan

{
  "success": true,
  "can_checkout_attendance": true,
  "branch_id": "cabang01",
  "branch_name": "Nama Cabang",
  "date": "2026-05-22",
  "has_reported": true,
  "reports": {
    "laporan_harian": true
  },
  "missing_reports": [],
  "message": "Cabang sudah menyelesaikan laporan harian. Staff boleh absen keluar.",
  "meta": {
    "generated_at": "2026-05-22T10:00:00.000Z",
    "timezone": "Asia/Makassar",
    "request_id": "..."
  }
}

Response Jika Belum Laporan

{
  "success": true,
  "can_checkout_attendance": false,
  "branch_id": "cabang01",
  "branch_name": "Nama Cabang",
  "date": "2026-05-22",
  "has_reported": false,
  "reports": {
    "laporan_harian": false
  },
  "missing_reports": ["laporan_harian"],
  "message": "Cabang belum menyelesaikan laporan harian. Staff belum boleh absen keluar.",
  "meta": { ... }
}

Response Error (API key salah, cabang tidak ditemukan, dll)

// API key salah
{
  "success": false,
  "can_checkout_attendance": false,
  "message": "API key tidak valid.",
  "meta": { ... }
}

// Cabang tidak ditemukan
{
  "success": false,
  "can_checkout_attendance": false,
  "branch_id": "cabang99",
  "date": "2026-05-22",
  "message": "Cabang tidak ditemukan.",
  "meta": { ... }
}

Pseudocode Implementasi di Sistem Absensi

async function checkCanCheckout(branchId) {
  const url = ENDPOINT_URL + "?action=api.v1.integration.checkout-status"
            + "&branch_id=" + branchId
            + "&api_key=" + API_KEY;

  const res = await fetch(url);
  const data = await res.json();

  if (!data.can_checkout_attendance) {
    showError(data.message); // tampilkan ke staff
    return false;
  }
  return true;
}

// Panggil saat staff klik "Absen Keluar"
if (await checkCanCheckout(currentStaff.branchId)) {
  processCheckout(); // lanjutkan
}

Catatan Penting

• Field paling penting: can_checkout_attendance (boolean)
• Timezone: WITA (Asia/Makassar = UTC+8)
• Jam cutoff: sebelum jam 03:00 pagi dihitung sebagai laporan hari sebelumnya
• Jika date tidak diisi, sistem otomatis pakai tanggal pelaporan aktif (sudah memperhitungkan cutoff)
• API key harus disimpan di environment variable, bukan hardcode di kode
• Jangan tampilkan API key di log atau error message sistem absensi