npm package: @rubicahq/n8n-nodes-emplicon
Description: n8n node for Emplicon HRIS – employees, attendance, overtime, insights
Author: Rubica
Latest version: 0.1.0

# @rubicahq/n8n-nodes-emplicon

n8n community node for [Emplicon](https://emplicon.com) HRIS: employees, attendance, overtime, and insights.

## Install in n8n

1. In n8n, go to **Settings → Community nodes → Install community nodes**.
2. Enter package name: **`@rubicahq/n8n-nodes-emplicon`**
3. Check "I understand the risks..." and click **Install**.

## Credentials

Create an **Emplicon API** credential with:

- **API Base URL**: `https://api.emplicon.com` (or `https://api-demo.emplicon.com` for demo)
- **Client ID**: from Emplicon dashboard (Pengaturan → Perusahaan)
- **API Key**: from Emplicon dashboard (Pengaturan → Perusahaan)

## Node: Emplicon

Operations:

- **Health Check** – Check API connection
- **List Employees** – List company employees
- **Get Employee** – Get employee by ID or Unique ID (e.g. MULIA-1234567)
- **Employee Count** – Total employee count
- **List Attendances** – List attendances in date range (optional filter by employee)
- **Attendance Summary** – Summary of attendances by employee
- **List Overtimes** – List overtime sessions
- **Overtime Summary** – Summary of overtime by employee
- **Insights Dashboard** – Combined insights (employees, attendances, overtime) for a period

## Cara publish ke npm (lengkap)

Agar node ini bisa di-install di n8n lewat **Install community nodes** dengan nama `@rubicahq/n8n-nodes-emplicon`, paket harus di-**publish** (unggah) ke npm. Berikut langkah lengkapnya.

### 1. Apa itu npm?

**npm** = registry tempat orang memasang paket Node.js. n8n mengambil community node dari npm. Jadi kita harus unggah paket kita ke npm dulu.

### 2. Daftar akun npm (register)

Kalau belum punya akun npm:

1. Buka **https://www.npmjs.com**
2. Klik **Sign Up**
3. Isi **Username** (nama akun), **Email**, **Password**
4. Verifikasi email kalau diminta
5. Selesai = Anda sudah terdaftar di npm

**Register** = bikin akun di website npm (sekali saja).

### 3. Nama paket: @rubicahq/n8n-nodes-emplicon

Paket kita pakai **scope** `@rubicahq`.

- Kalau **username npm** Anda = `rubicahq` → Anda bisa publish `@rubicahq/n8n-nodes-emplicon` dengan akun itu.
- Kalau mau pakai **organisasi** (tim):
  1. Di **https://www.npmjs.com** → login → buat **Organization** nama `rubicahq`
  2. Publish paket lewat organisasi itu

### 4. Login npm dari komputer (untuk publish)

Setelah punya akun, dari **komputer Anda** (Terminal / Command Prompt / PowerShell):

1. Jalankan:
   ```bash
   npm login
   ```
2. Isi saat diminta:
   - **Username:** username npm Anda
   - **Password:** password npm Anda
   - **Email:** email yang dipakai daftar
   - **One-time password (OTP):** kalau pakai 2FA, masukkan kode dari app authenticator
3. Kalau berhasil: **Logged in as …**

**Login** = dari terminal “masuk” ke akun npm supaya bisa publish. Cukup sekali per komputer (atau sampai `npm logout`).

### 5. Publish paket

Masih di komputer Anda, masuk ke folder paket lalu:

```bash
cd path/ke/emplicon/n8n-nodes-emplicon
npm run build
npm publish --access public --ignore-scripts
```

- Pertama kali publish paket scope `@rubicahq`, npm bisa tanya **publish as organization?** → pilih Y atau n sesuai mau pakai org atau user.
- `--access public` = paket bisa dipasang siapa saja (termasuk di n8n).

### 6. Ringkas

| Istilah    | Arti |
|------------|------|
| **Register** | Daftar akun di **npmjs.com** (Sign Up) |
| **Login**    | Di terminal: `npm login` = masuk ke akun npm |
| **Publish**  | `npm publish --access public --ignore-scripts` = unggah paket ke npm |

Setelah publish sukses, di n8n → **Install community nodes** → isi **`@rubicahq/n8n-nodes-emplicon`** → Install.

## License

MIT