Skip to main content

Lista Negócios

Status: Disponível
Lista os negócios para os filtros e campos selecionados na requisição. Retorna apenas negócios que a unidade tem permissão para visualizar. Gatilho: Por requisição via API.
PropriedadeValor
Método HTTPGET
Endpointcrm.deal.list
Headersnenhum
Documentação nativaapidocs.bitrix24.com

Query Params

FIELDS[{id_do_campo}]
string
Filtros e seleção de campos desejados.Exemplo: FIELDS[UF_CRM_1621027933376] = SP São José do Rio PretoConsulte a lista de campos principais para os IDs disponíveis.

Obtém Negócio

Status: Disponível
Retorna todos os campos que o negócio possui — nativos e personalizados. Gatilho: Por requisição via API.
PropriedadeValor
Método HTTPGET
Endpointcrm.deal.get
Headersnenhum
Documentação nativaapidocs.bitrix24.com

Query Params

ID
integer
required
ID do negócio. Ex: ID = {id_do_negocio}

Edita Negócio / Muda de Fase / Altera Nº da Tentativa de Contato

Status: Disponível
Edita os campos do negócio que forem passados como parâmetro, sem alterar os demais campos não citados. Também utilizado para mover o negócio de fase e alterar o número da tentativa de contato. Gatilho: Por requisição via API.
PropriedadeValor
Método HTTPGET
Endpointcrm.deal.update
Headersnenhum
Documentação nativaapidocs.bitrix24.com

Query Params

ID
integer
required
ID do negócio. Ex: ID = {id_do_negocio}
FIELDS[UF_CRM_1669405845]
string
Mudar o negócio de fase. Preencha com o nome por extenso da fase desejada.Exemplo: FIELDS[UF_CRM_1669405845] = Tentativa de contatoIsso aciona a automação que move o negócio para a respectiva fase.Fases disponíveis:
Nome da FaseID nativo (STAGE_ID)
Nova oportunidadeNEW
RepiquePREPARATION
Tentativa de contatoPREPAYMENT_INVOICE
Em contatoEXECUTING
Buscar / cadastrar no ERPFINAL_INVOICE
Agendado1
Confirmado2
Em negociação3
PerdasLOSE
Venda Cancelada4
Venda realizadaWON
FIELDS[UF_CRM_1636587029]
string
Alterar o número da tentativa de contato. Preencha com o ID da tentativa.Exemplo: FIELDS[UF_CRM_1636587029] = 1243 → altera o campo para 3ª tentativa
Para mudar o negócio de fase via automação, utilize o campo personalizado UF_CRM_1669405845 (e não o campo nativo STAGE_ID). O campo nativo deve ser usado apenas para listagem/filtro por fase.