Rvops

Overview

This node integrates with the "Rvops" system to manage and interact with various CRM objects, including deals (Negócio). Specifically, the "List Deals" operation retrieves a list of deals from the system. It supports filtering, sorting, pagination, and incremental fetching based on cursors.

Common scenarios where this node is beneficial include:

• Synchronizing deal data from Rvops into other systems or workflows.
• Monitoring new or updated deals incrementally by using the watch feature.
• Exporting deal lists for reporting or analysis.
• Fetching specific deal properties to tailor the output to your needs.

For example, you can use this node to fetch all deals modified since the last workflow run, sorted by modification date ascending, limiting results to 50 per execution, or to retrieve all deals at once ignoring pagination.

Properties

Name	Meaning
Autenticação Do Cliente	Authentication method to access the API. Only "Access Token" is supported.
Limite	Limits the number of deals returned in one request. Minimum 1, maximum 100. Defaults to 100.
Propriedade Names or IDs	Additional deal properties to include in the response. You can select from a list or specify property IDs via expressions.
Listar Todos	Boolean flag indicating whether to fetch all deals at once, ignoring pagination. If true, the node will paginate internally until all deals are retrieved.
Monitorar Novos Valores	Boolean flag to enable incremental fetching. When enabled, the node fetches deals starting from the last saved cursor, allowing monitoring of new or updated deals since the last execution. Defaults to true.
Campo De Ordenação	Field used to sort the results. Options: "Data De Modificação" (updatedAt) or "Data De Inclusão" (createdAt). Defaults to "Data De Modificação".
Tipo De Ordenação	Sort order type. Options: "Ascendente" (ascending) or "Descendente" (descending). Defaults to "Ascendente".

Output

The node outputs an array of deal objects under the json field. Each deal object contains:

• id: The unique identifier of the deal.
• properties: An object containing the deal's properties as key-value pairs, including any additional properties requested.
• associations: Related objects associated with the deal (e.g., contacts, companies, products).

The output is structured to allow easy further processing in n8n workflows. No binary data is output by this operation.

Dependencies

• Requires an API authentication token (access token) configured in n8n credentials to authenticate requests to the Rvops API.
• Relies on the external Rvops API service to fetch deal data.
• Uses internal helper methods to handle API requests and pagination.

Troubleshooting

• Issue: No deals returned or incomplete data.

  • Cause: The limit may be too low or filters exclude all deals.
  • Solution: Increase the "Limite" property or disable filters. Use "Listar Todos" to fetch all deals.

• Issue: Incremental fetching does not return new deals.

  • Cause: The "Monitorar Novos Valores" flag might be off or the cursor was reset.
  • Solution: Ensure "Monitorar Novos Valores" is enabled to track changes since last run.

• Error: API authentication errors.

  • Cause: Invalid or expired access token.
  • Solution: Verify and update the API token in the node credentials.

• Error: Rate limiting or server errors from the API.

  • Solution: Implement retry logic or reduce request frequency.

Links and References

• n8n Expressions Documentation
• Rvops API documentation (not publicly linked here; refer to your API provider)
• n8n official docs on Creating Custom Nodes