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 | ✘ |