Cadastrar Venda

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Esse endpoint permite cadastrar vendas.

Abaixo estão os parâmetros que podem ser enviados no body da requisição.

IMPORTANTE: Caso o ID do vendedor e/ou do SDR não seja informado, será usado o ID do usuário autenticado (vinculado ao token do header Authorization).

Pré-requisitos e regras:

  • O usuário do token precisa ser um consultor ativo no escritório.
  • cliente_id, oportunidade_id, produto, origem, vendedor_id, sdr_id e contrato_escritorio_id precisam pertencer a um escritório acessível pelo token.
  • Para produtos do tipo RPV, valor_acordado_venda é obrigatório.
  • A venda é bloqueada se o cliente já possuir processo/venda finalizado produtivo para o mesmo produto.
Body Params
string
required

ID do cliente que ficará referenciado a venda que será cadastrada. Disponível ao criar um cliente.

int32
required

ID da oportunidade que terá relação com a venda criada. Disponível ao criar uma oportunidade.

int32

ID do usuário vendedor que participou da venda.

int32

ID do usuário SDR que participou da venda.

string
enum
required

Meio em que a venda foi realizada

Allowed:
float

Valor da causa.

float

Valor das parcelas vencidas.

string

Observação da venda que foi realizada.

int32
required

ID do produto da venda.

int32

ID do escritório que será gerado o contrato, por padrão se não informado, será o mesmo do escritorio_id

int32
required

Origem da venda. As origens disponíveis podem ser consultadas em API 1.0 > CRM > Oportunidades > Consultar Origens

float

Obrigatório para produtos do tipo RPV (ex.: produto = 250). Ignorado para os demais.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain