@rubicahq/n8n-nodes-emplicon

n8n community node for Emplicon 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:

   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:

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