A Negociação é uma das três Entidades do RD Station CRM:
- Negociação
- Contato
- Empresa
Ela representa a possibilidade de negociar uma venda e contém todas as fases do processo de negociação.
Toda Negociação cadastrada percorre o funil de vendas e, a cada atualização, as informações referentes ao avanço da negociação podem ser registradas em campos específicos.
Assim, todo o histórico de negociações, sejam elas ganhas (venda realizada) ou perdidas, fica armazenado no cadastro da Empresa à qual pertencem, independente do vendedor responsável e do tipo de produto ou serviço negociado.
Atenção
Toda informação cadastrada deve conter no mínimo 2 caracteres.
Query params
Parâmetros utilizados para listar e exibir Negociações.
| Nome | Tipo | Descrição |
|---|---|---|
| token | String | Token do usuário |
| deal_id | String | ID da negociação a ser exibida |
| page | String | Número da página listada. Valor padrão é 1 |
| limit | String | Limite de negociações que virão por listagem. Valor padrão é 20. Valor máximo é 200 |
| order | String | Ordenação. Valor padrão é "created_at". |
| direction | String | Ordenação da lista. "asc" ou "desc", padrão é "desc" |
| name | String | Nome da negociação |
| exact_name | String | Para buscas com nome exato, usar o parâmetro exact_name= true |
| win | String | Negociações ganhas. Com o valor true para trazer as negociações ganhas, false para trazer as negociações perdidas e null para retornar as negociações em aberto. |
| user_id | String | ID do usuário relacionado à negociação. |
| start_date | String | Primeiro dia/hora em que deve ser aplicado o filtro para o parâmetro closed_at_period ou created_at_period. Ex.: "start_date": "2020-12-14T15:00:00". |
| end_date | String | Último dia/hora em que deve ser aplicado o filtro para o parâmetro closed_at_period ou created_at_period. Ex.: "end_date": "2020-12-14T15:00:00" |
| closed_at | Boolean | Ao informar true, retorna as negociações GANHAS/PERDIDAS. Ao informar false, retorna as negociações EM ABERTO OU PAUSADAS. |
| closed_at_period | Boolean | Data de fechamento da deal: se true deve ser informado start_date e end_date. |
| created_at_period | Boolean | Data de criação da deal: se true, deve ser informado start_date e end_date |
| prediction_date_period | Boolean | Data de previsão de fechamento da negociação: se true, deve ser informado start_date e end_date |
| closed_by_id | String | ID do usuário que fechou a venda |
| deal_stage_id | String | ID da etapa |
| deal_lost_reason_id | String | ID do motivo de perda |
| organization | String | ID da empresa |
| hold | String | Estado da negociação pausada. Se marcado como true, retorna todas negociações pausadas. Para outros casos, não deve-se utilizar esse parâmetro. |
| product_presence | String | Negociações que contenham produtos/serviços relacionados: false (nenhum produto relacionado), true (um ou mais produtos relacionados) ou uma lista de IDs de produto. A lista de IDs deve ser informada com os valores separados por vírgula. Ex.: 5esdsds, d767dsdssd, c6e40fd2f000972a083. |
| deal_pipeline_id | String | ID do Funil |
Body params
Parâmetros utilizados para criar e atualizar Negociações.
| Nome | Tipo | Descrição | Obrigatório | Observação |
|---|---|---|---|---|
| name | String | Nome da negociação a ser exibida | ✓ | Obrigatório somente ao criar uma negociação. |
| deal_stage_id | String | ID da etapa do funil | ✘ | |
| deal_custom_fields | Object | Campos customizados da negociação | ✘ | |
| deal_source | Object | Fonte da negociação | ✘ | |
| contacts | Array of objects | Contatos associados a negociação | ✘ | |
| deal_products | Array of objects | Produtos vinculados a negociação | ✘ | |
| campaign | Object | Campanha da negociação | ✘ | |
| organization | Object | Empresa à qual a negociação pertence | ✘ | |
| user_id | Object | Usuário responsável pela negociação | ✘ | Se esse parâmetro não for enviado na requisição, o dono do Token (utilizado para autorizar a requisição) será atribuído como Responsável pela negociação. |
| hold | Boolean | Status da negociação | ✘ | Valores aceitos: paused (pausada), null (em aberto) |
| rating | Integer | Avaliação da negociação | ✘ | |
| win | Boolean | Status da negociação | ✘ | Valores aceitos: true (negociação ganha), false (negociação perdida), null (negociação em aberto) |
| prediction_date | Date | Data da previsão de fechamento da negociação | ✘ | Formato (yyyy-mm-dd) |
| deal_lost_reason_id | String | ID do motivo da perda | ✘ | |
| contacts.legal_base | Array | Base legal | ✘ |