Overview
This node integrates with the Apprecio API to perform various loyalty points and gift card related operations. Specifically, the "Consultar Lotes" operation allows users to query information about specific load batches ("lotes") by their ID. This is useful in scenarios where you need to verify or audit batch loads of points or transactions processed through the Apprecio system.
Practical examples include:
- Retrieving details of a particular batch load to confirm its status or contents.
- Auditing point allocations made in bulk for reporting or troubleshooting.
- Integrating batch load information into workflows that manage loyalty program data.
Properties
| Name | Meaning |
|---|---|
| ID Lote | The unique identifier of the batch load to be queried. |
Output
The node outputs a JSON object containing the response from the Apprecio API regarding the requested batch load. The structure depends on the API's response but generally includes detailed information about the batch such as its status, contents, timestamps, and any relevant metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Apprecio API.
- Uses the Axios HTTP client library to send requests.
- Requires network access to the Apprecio API endpoint (default:
https://apiv2.dcanje.com/api). - The node internally generates a timestamp and MD5 hash signature for request validation using cryptographic functions.
Troubleshooting
Common issues:
- Invalid or missing batch ID (
ID Lote) will cause the API to return errors. - Network connectivity problems can prevent reaching the Apprecio API.
- Incorrect or expired API credentials will result in authentication failures.
- Invalid or missing batch ID (
Error messages:
"Error de la API de Apprecio: <message>": Indicates the API returned an error; check the message for details such as invalid parameters or authorization issues."No se recibió respuesta de la API de Apprecio": Suggests a timeout or network issue; verify connectivity and API availability."Error al realizar la solicitud: <message>": General request failure; review the error message for specifics.
To resolve these errors:
- Verify the correctness of the
ID Loteinput. - Ensure valid and active API credentials are configured.
- Check network settings and firewall rules allowing outbound HTTPS requests.
- Review API documentation for any changes in required parameters or authentication.
Links and References
- Apprecio API Documentation (assumed base URL)
- n8n Documentation on Creating Custom Nodes
- Axios HTTP Client: https://axios-http.com/