WibiClickInstall

Overview

This node integrates with the WibiClick API to perform various operations across multiple resources such as notes, jobs, contacts, employees, estimates, invoices, line items, websites, WhatsApp messages, users, technicians, tasks, suppliers, and settings.

Specifically for the Technician resource with the Calculate Salary operation, the node calculates a technician's salary for a specified year and month. This is useful in scenarios where you want to automate payroll calculations based on monthly reports or performance data tracked in the WibiClick system.

Practical examples:

• Automatically calculate and retrieve a technician’s salary at the end of each month.
• Integrate salary calculation into a payroll workflow that triggers payments or generates payslips.
• Use the salary data for financial reporting or budgeting within your organization.

Properties

Output

The output JSON structure for the "Calculate Salary" operation under the Technician resource contains the salary details returned by the WibiClick API for the specified technician and period. The exact fields depend on the API response but typically include salary components, totals, and possibly breakdowns of earnings and deductions.

Example output snippet:

{
  "salaryDetails": {
    "baseSalary": 3000,
    "bonuses": 500,
    "deductions": 200,
    "totalSalary": 3300,
    "year": 2024,
    "month": 1,
    "technicianId": "abc123"
  }
}

(Note: The actual field names depend on the API response and are not explicitly defined in the source code.)

Dependencies

• Requires an active connection to the WibiClick API.
• Requires an API key credential configured in n8n for authentication with the WibiClick service.
• The node uses HTTP requests to communicate with the WibiClick API endpoints.

Troubleshooting

• Common issues:

  • Invalid or missing Technician ID, Year, or Month parameters will cause the API call to fail.
  • Network connectivity issues or incorrect API credentials will result in authentication errors.
  • If the API returns unexpected data or errors, ensure the technician exists and the requested period is valid.

• Error messages:

  • Errors from the API are thrown as node errors with messages from the API response.
  • If the API key is invalid or missing, authentication errors will occur.
  • Date-related errors may arise if the year or month parameters are out of range or incorrectly formatted.

• Resolution tips:

  • Verify all required input properties are correctly set.
  • Confirm the API key credential is valid and has necessary permissions.
  • Check the technician ID exists in the WibiClick system.
  • Ensure the year and month values are valid integers within expected ranges.

Links and References

• WibiClick API Documentation (Assumed URL; replace with actual if available)
• n8n Documentation on HTTP Request Node
• n8n Credential Setup Guide for API Keys

This summary focuses solely on the "Technician" resource and "Calculate Salary" operation as requested, based on static analysis of the provided source code and property definitions.