Nuvem Solution icon

Nuvem Solution

Interact with Nuvem Solution API

Actions120

Veículo Cliente → Listar Veículos Geral

AI-generated

Overview

This node interacts with the "Veículo Cliente" (Customer Vehicle) resource of the Nuvem Solution API, specifically supporting the operation "Listar Veículos Geral" (List Vehicles General). It allows users to retrieve a paginated list of customer vehicles filtered by date range and chassis number. This is useful for scenarios where you need to analyze or report on customer vehicle data over specific periods or identify vehicles by their chassis numbers.

Practical examples include:

  • Generating reports of all customer vehicles added or updated within a certain timeframe.
  • Filtering vehicles by chassis number to verify details or status.
  • Paginating through large datasets of customer vehicles efficiently.

Properties

Name Meaning
Start At Start date/time filter for the query (optional).
End At End date/time filter for the query (optional).
Page Page number for pagination (default: 1).
Page Size Number of items per page (default: 20).
Número do Chassi Chassis number filter to narrow down the search results (optional).

Output

The output is a JSON array containing the list of customer vehicles matching the specified filters. Each item in the array represents a vehicle with its associated properties as returned by the Nuvem Solution API's /erp/oficina/veiculosClientes/ListarVeiculosGeral endpoint.

The structure typically includes vehicle details such as identifiers, chassis number, customer association, and other metadata relevant to the vehicle record.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Nuvem Solution API.
  • The node uses the base URL and authentication tokens obtained from these credentials.
  • Proper configuration of the API credentials in n8n is necessary before using this node.

Troubleshooting

  • Authentication errors: If the node fails due to authentication issues, ensure that the API key credential is correctly configured and valid.
  • Invalid date formats: The Start At and End At fields expect valid ISO 8601 date-time strings. Invalid formats may cause request failures.
  • Pagination parameters: Providing non-positive integers for Page or Page Size may result in errors or unexpected behavior.
  • Empty results: If no vehicles are returned, verify that the filters (dates, chassis number) match existing data.
  • API rate limits or downtime: Network or server issues can cause request failures; retry after some time or check API status.

Links and References

  • Nuvem Solution API Documentation (general reference)
  • Specific API endpoint for listing customer vehicles general: /erp/oficina/veiculosClientes/ListarVeiculosGeral

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion