Actions11
Deal → Search
AI-generatedOverview
This node operation allows users to search for deals within the Groner CRM system using a variety of filters and criteria. It is useful for retrieving specific deals based on detailed parameters such as deal type, responsible personnel, stage, status, location, financial metrics, dates, and additional custom fields. Practical examples include finding deals in a particular city with a minimum value, or deals assigned to a specific seller within a date range.
Use Case Examples
- Search deals filtered by deal type and status to generate sales reports.
- Retrieve deals in a specific city with a minimum consumption and power for energy management.
- Find deals created within a date range and sorted by value for performance analysis.
Properties
| Name | Meaning |
|---|---|
| Filters | Collection of filters to narrow down the search by deal type, pre-seller, responsible seller, responsible technician, stage, and status. |
| Location | Filters to narrow down deals by city and state. |
| Financial | Filters related to financial and consumption metrics of deals, including minimum and maximum values for consumption, power, and deal value. |
| Dates | Filters to specify date ranges for deal creation, closing forecast, sale dates, and other relevant dates. |
| Additional Fields | Additional filters for more specific search criteria such as ad set, advertisement, campaign, contact owner ID, qualification scores, lead ID, origin IDs, page size, return only list flag, search criteria, search query, sort by field, status history IDs, store IDs, and tag IDs. |
Output
JSON
Contentlist- List of deals matching the search criteria
pageSize- Number of deals returned per pagequery- Search query usedcriterio- Additional search criteria usedtipoProjetoId- Deal type filter appliedetapaId- Deal stage filter appliedstatusId- Deal status filter appliedvendedorResponsavelId- Responsible seller filter appliedtecnicoResponsavelId- Responsible technician filter appliedpreVendedorId- Pre-seller filter appliedleadId- Lead ID filter appliedlojasIds- Store IDs filter appliedcidade- City filter applieduf- State filter appliedpotenciaInicial- Minimum power filter appliedpotenciaFinal- Maximum power filter appliedvalorInicial- Minimum deal value filter appliedvalorFinal- Maximum deal value filter appliedconsumoInicial- Minimum consumption filter appliedconsumoFinal- Maximum consumption filter appliedetiquetasIds- Tag IDs filter appliedorigensIds- Origin IDs filter appliedstatusHistoricoIds- Status history IDs filter appliednStatusHistoricoIds- Negative status history IDs filter applieddataInicial- Start date filter applieddataFinal- End date filter applieddataPrevisaoFechamentoInicial- Initial closing forecast date filter applieddataPrevisaoFechamentoFinal- Final closing forecast date filter applieddataPropostaAceitaInicial- Initial proposal acceptance date filter applieddataPropostaAceitaFinal- Final proposal acceptance date filter applieddataVendaInicial- Initial sale date filter applieddataVendaFinal- Final sale date filter applieddataPerdaInicial- Initial loss date filter applieddataPerdaFinal- Final loss date filter appliedordenarPor- Sort by field appliedqualificacaoInicial- Minimum qualification score filter appliedqualificacaoFinal- Maximum qualification score filter appliedindicador- Performance indicator filter applieddonoContatoId- Contact owner ID filter appliedcampanha- Campaign filter appliedanuncio- Advertisement filter appliedconjuntoAnuncios- Ad set filter applied
Dependencies
- Groner API authentication
Troubleshooting
- Ensure all filter values are correctly formatted and valid according to the Groner API specifications.
- If the API returns an error, check the authentication credentials and permissions.
- Large result sets may require pagination using the pageSize parameter to avoid timeouts or incomplete data.
- If no deals are returned, verify that the search criteria are not too restrictive or conflicting.
Links
- Groner API - Search Deals - Official API documentation for searching deals in Groner CRM.