Uma "Negociação" (Deal) representa uma oportunidade de venda dentro do RD Station CRM. É o objeto central que rastreia o progresso de uma venda potencial desde o contato inicial até o fechamento. Cada negociação possui um valor monetário, está associada a contatos e/ou empresas, pertence a um proprietário (usuário) e ocupa uma etapa específica dentro de um funil de vendas. A manipulação deste recurso é fundamental para a automação de processos de vendas e a integração com outras ferramentas de negócio.
Estrutura do Objeto Deal
Atributo (JSON, dentro de data) | Tipo de Dados | Descrição | Observações |
|---|---|---|---|
id | String | ID da negociação | Somente leitura, formato MongoDB ID. |
name | String | Nome da negociação | Mínimo de 2 caracteres e máximo de 255 caracteres. |
recurrence_price | Float | Valor recorrente da negociação. Calculado a automaticamente. | - |
one_time_price | Float | Valor único da negociação. Calculado automaticamente. | - |
total_price | Float | Valor total da negociação. Calculado automaticamente. | Somente leitura. |
expected_close_date | Date | Data de previsão de fechamento da negociação. | Formato: YYYY-MM-DD. |
rating | Integer | Qualificação da negociação. Valores permitidos: 1 a 5. | - |
status | String | Status da negociação | Valores permitidos: won, lost, ongoing (default), paused. |
closed_at | DateTime | Data de fechamento da negociação. | Somente Leitura. Formato: YYYY-MM-DDTHH:MM:SSZ. |
pipeline_id | String | ID do funil de vendas da negociação | Formato: MongoDB ID. |
owner_id | String | ID do usuário responsável pela negociação | Formato: MongoDB ID. |
stage_id | String | ID da etapa da negociação | Formato: MongoDB ID. |
source_id | String | ID da fonte da negociação | Formato: MongoDB ID. |
campaign_id | String | ID da campanha da negociação | Formato: MongoDB ID. |
lost_reason_id | String | ID do motivo de perda da negociação | Formato: MongoDB ID. |
custom_fields | Object | Campos personalizados da negociação | Objeto contendo os campos personalizados onde a chave é o slug. Vide [[Estrutura do Objeto Custom Field]] |
distribution_settings | Object | Configurações de distribuição da negociação | Somente escrita. |
contact_ids | Array(String) | IDs dos contatos associados à negociação | Formato MongoDB ID. |
created_at | DateTime | Data de criação da negociação | Somente leitura, formato YYYY-MM-DDTHH:MM:SSZ. |
updated_at | DateTime | Data de atualização da negociação | Somente leitura, formato YYYY-MM-DDTHH:MM:SSZ. |