ADVBOX icon

ADVBOX

Consume Advbox API

Actions14

Overview

This node integrates with the Advbox API to manage legal case (lawsuit) data and related tasks. Specifically, the Get lawsuit task history operation retrieves the history of tasks associated with a particular lawsuit, optionally filtered by task status (all, pending, or completed). This is useful for tracking the progress and changes in tasks linked to a legal case.

Common scenarios include:

  • Auditing all task activities related to a lawsuit.
  • Monitoring pending or completed tasks for case management.
  • Generating reports on task timelines and statuses for legal teams.

Example: A law firm wants to fetch all completed tasks for a specific lawsuit to review what has been done before a court hearing.

Properties

Name Meaning
Lawsuit ID The unique identifier of the lawsuit for which to retrieve the task history.
Additional Fields Optional filters; currently supports filtering tasks by their status:
- All: Retrieve all tasks regardless of status.
- Pending: Retrieve only tasks that are pending.
- Completed: Retrieve only tasks that have been completed.

Output

The node outputs an array of JSON objects representing the task history entries for the specified lawsuit. Each entry typically contains details about individual tasks such as timestamps, status, descriptions, and other metadata returned by the Advbox API's /history/{lawsuit_id}/ endpoint.

If binary data were involved, it would be summarized here, but this operation deals solely with JSON task history data.

Dependencies

  • Requires an API key credential for authenticating with the Advbox API.
  • The node expects the Advbox API base URL and token to be configured in the credentials.
  • No additional external dependencies beyond the Advbox API and n8n's HTTP request capabilities.

Troubleshooting

  • Missing or invalid API token: The node will throw an error if the API token is not provided or invalid. Ensure the API key credential is correctly set up.
  • Invalid Lawsuit ID: If the lawsuit ID does not exist or is malformed, the API may return an error or empty results.
  • Network or API errors: Errors during the HTTP request (e.g., network issues, API downtime) will cause the node to fail with an error message indicating the failure to obtain task history.
  • Error message example:
    Erro ao obter histórico de tarefas do processo: <error message>
    This indicates a failure fetching the task history; verify the lawsuit ID and API connectivity.

Links and References

Discussion