Toolzz Specialities icon

Toolzz Specialities

ToolzzSpecialities

Overview

The Toolzz Specialities node is designed to retrieve a list of medical specialties from the Toolzz API, filtered by institution URL and optional subgroup IDs. This node is useful in scenarios where you need to dynamically fetch or synchronize specialty data for healthcare-related workflows, such as populating dropdowns, validating user input, or integrating with other systems that require up-to-date specialty information.

Practical examples:

  • Fetching available medical specialties for a specific institution to display in a form.
  • Filtering specialties based on subgroups for targeted marketing or reporting.
  • Integrating specialty data into patient management or scheduling systems.

Properties

Name Type Meaning
Url of Institution String The base URL identifying the institution whose specialties are being queried.
Ambiente Options Selects the environment (currently only "Prod" is available).
SubGrupos String Comma-separated list of subgroup IDs to filter the specialties.

Output

The node outputs a JSON array containing the specialties returned by the Toolzz API. Each item in the array represents a specialty object as provided by the API. The exact structure depends on the API response, but typically includes fields such as specialty name, ID, and possibly related metadata.

Example output:

[
  {
    "id": "123",
    "name": "Cardiology",
    // ...other fields
  },
  {
    "id": "456",
    "name": "Dermatology"
    // ...other fields
  }
]

Dependencies

  • External Service: Requires access to the Toolzz API at https://gateway.api.toolzz.com.br.
  • No authentication credentials are required for this node as per the current implementation.
  • n8n Configuration: No special configuration or environment variables are needed.

Troubleshooting

  • Common Issues:

    • Invalid or missing "Url of Institution": If the URL is incorrect or empty, the API may return an error or no results.
    • Malformed "SubGrupos": Ensure subgroup IDs are comma-separated without spaces or invalid characters.
    • Network/Connectivity Errors: If n8n cannot reach the Toolzz API endpoint, check your network settings and firewall rules.

  • Error Messages:

    • 4xx/5xx HTTP errors: These indicate issues with the request or server. Double-check the input parameters and try again.
    • "Cannot read property 'toString' of undefined": This may occur if required parameters are not set; ensure all mandatory fields are filled.

Links and References

Discussion