Inmobalia CRMInstall

Overview

This node integrates with the Inmobalia CRM API to retrieve location-related data. Specifically, the "List Cities by Province" operation fetches a list of cities within a specified province. This is useful in scenarios where you need to dynamically populate city options based on a selected province, such as in real estate platforms, travel applications, or any system that requires geographic hierarchy data.

For example, if you have a form where users select a province first, this node can be used to automatically provide the corresponding cities for that province, ensuring accurate and relevant location data.

Properties

Output

The output is an array of JSON objects, each representing a city within the specified province. Each item contains the city's details as returned by the Inmobalia CRM API. The exact structure depends on the API response but typically includes fields like city name, city ID, and possibly other metadata related to the city.

No binary data output is produced by this operation.

Example output snippet (conceptual):

[
  {
    "id": 123,
    "name": "City Name",
    "provinceId": 45,
    ...
  },
  {
    "id": 124,
    "name": "Another City",
    "provinceId": 45,
    ...
  }
]

Dependencies

• Requires an active connection to the Inmobalia CRM API.
• Requires an API authentication token configured via OAuth2 credentials in n8n.
• The node uses the Inmobalia CRM client library internally to communicate with the API.

Troubleshooting

• Common issues:

  • Missing or invalid Province ID parameter will cause the API call to fail.
  • Authentication errors if the OAuth2 credential is not properly set up or expired.
  • Network connectivity issues preventing access to the Inmobalia CRM API.

• Error messages:

  • Unsupported operation: Indicates the selected operation is not implemented; ensure "List Cities by Province" is chosen.
  • Unsupported resource: Indicates the selected resource is not recognized; ensure "Location" is selected.
  • API errors wrapped as NodeApiError may include HTTP status codes and messages from the Inmobalia CRM API, such as unauthorized access or invalid parameters.

• Resolutions:

  • Verify the Province ID is provided and valid.
  • Check and refresh the OAuth2 credentials.
  • Confirm network access to the API endpoint.
  • Select correct Resource and Operation in the node configuration.

Links and References

• Inmobalia CRM API Documentation (example placeholder link)
• n8n OAuth2 Credential Setup
• n8n Node Development Guide