WibiClickInstall

Overview

This node integrates with the WibiClick API to perform various operations across multiple resources such as technicians, jobs, contacts, invoices, and more. Specifically for the Technician resource with the Get Monthly Report operation, it retrieves a detailed monthly report for a given technician based on their ID, year, and month.

Common scenarios where this node is beneficial include:

• Generating monthly performance or activity reports for technicians.
• Automating payroll or salary calculations by fetching monthly work summaries.
• Integrating technician reports into broader business workflows or dashboards.

For example, a user can input a technician's ID along with a specific year and month to automatically fetch that technician’s monthly report data, which can then be used for performance reviews or invoicing.

Properties

Output

The output JSON structure for the "Get Monthly Report" operation contains the monthly report data for the specified technician. This data typically includes metrics, activities, or summarized information relevant to the technician’s work during the specified month and year.

Example output JSON structure (simplified):

{
  "technicianId": "string",
  "year": 2024,
  "month": 1,
  "reportData": {
    // Various fields representing the monthly report details
  }
}

If the operation is "Get Monthly Report Text," the output will contain a textual summary of the report under the textReport field.

No binary data output is involved in this operation.

Dependencies

• Requires an active connection to the WibiClick API.
• Requires an API key credential for authentication with the WibiClick service.
• The node expects the API URL and API key to be configured in the credentials.

Troubleshooting

• Invalid Technician ID: If the technician ID does not exist or is incorrect, the API may return an error or empty report. Verify the technician ID before running the node.
• Invalid Date Parameters: Ensure the year and month are valid numbers, with month between 1 and 12.
• API Authentication Errors: If the API key is missing or invalid, requests will fail with authorization errors. Confirm the API key credential is correctly set up.
• Network Issues: Connectivity problems to the WibiClick API endpoint will cause request failures.
• Unexpected API Responses: If the API returns unexpected data or errors, check the API status or contact support.

Links and References

• WibiClick API Documentation (Assumed link; replace with actual if available)
• n8n Documentation on Creating Custom Nodes
• General info on HTTP Request Node (for understanding underlying HTTP calls)

This summary focuses exclusively on the "Technician" resource and the "Get Monthly Report" operation as requested.