WavUps CRM
Entrar
Negócios do Pipeline

Atualizar Negócio do Pipeline

Atualiza os dados de um negócio existente no pipeline de CRM pelo seu ID, incluindo seus produtos vinculados.

PUT/account-crm-pipeline-deal/{id}
curl --request PUT \
  --url 'https://crm.wavups.com/api/v1/account-crm-pipeline-deal/cmsnopzzl002l01ukfjsxp80a' \
  --header 'Token: SEU_TOKEN_DE_API' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": "won",
    "wonAt": "2026-10-06",
    "value": 2000.0,
    "currency": "EUR",
    "customFields": {
      "orcamento": 2000,
      "segmento": "Varejo"
    },
    "products": [
      {
        "productId": "cmprod001",
        "quantity": 1,
        "discount": 0,
        "discountType": "FIXED"
      }
    ]
  }'
{
  "message": "Account CRM pipeline deal updated successfully"
}

Requisição

PUT https://crm.wavups.com/api/v1/account-crm-pipeline-deal/{id}

Tokenstringobrigatório

Seu token de autenticação.

idstringobrigatório

ID do negócio a ser atualizado.

Body

Todos os campos são opcionais. Envie apenas os campos que deseja atualizar.

titlestring

Novo título do negócio.

stageIdstring

Novo ID do estágio do pipeline.

leadIdstring

Novo ID do lead vinculado.

dealOwnerstring

Novo ID do usuário responsável.

descriptionstring

Nova descrição do negócio.

valuenumber

Novo valor estimado do negócio.

statusstring

Novo status do negócio: open, won ou lost. Outro valor responde 400.

O status e a etapa andam juntos: marcar won ou lost leva o negócio para a primeira etapa de ganho ou de perdido do pipeline; mover para uma etapa de ganho ou de perdido (pelo stageId) marca o negócio como won ou lost; reabrir (open) leva de volta para a última etapa em andamento.

Ao virar ganho ou perdido, a data do ganho (wonAt) ou da perda (lostAt) passa a ser o momento da alteração, a não ser que você envie a data real. Enviar o mesmo status de novo não muda a data.

wonAtstring

Data real do ganho, em ISO 8601 (2026-10-06 ou 2026-10-06T14:30:00Z). Só é aceita quando o negócio fica ganho (já é, ou vira com esta alteração); senão responde 400. Serve também para corrigir a data de um negócio já ganho. Não pode ser no futuro.

lostAtstring

Data real da perda, em ISO 8601. Mesma regra do wonAt, para negócios perdidos.

lossReasonIdstring

Motivo da perda: o ID de um motivo cadastrado na plataforma, o mesmo que aparece em lossReasonId nos negócios perdidos. ID que não é da conta responde 404.

lossNotestring

Observação da perda (até 1000 caracteres).

currencystring

Moeda do valor: código ISO 4217 de 3 letras, como BRL, USD, EUR, GBP ou JPY (aceito também em minúsculas). Só a moeda muda: o value não é convertido. Código desconhecido responde 400.

typestring

Novo tipo ou categoria do negócio.

nextActionstring

Nova próxima ação prevista.

sourcestring

Nova origem do negócio.

customFieldsobject

Campos personalizados do negócio, pela chave do campo (os campos de negócio são por pipeline; veja a chave em Pipelines > Campos, na plataforma). Exemplo: { "origem_da_proposta": "Indicação", "orcamento": "1.500,50" }.

  • Só valem os campos do pipeline da etapa em que o negócio fica (quando você troca a etapa, vale o pipeline da etapa de destino).
  • Seleção: o nome ou o id da opção. Seleção múltipla: uma lista de nomes.
  • Número e moeda: 1500 ou 1.500,50. Data: 2026-03-15 ou 15/03/2026. Sim/Não: true/false ou sim/não.
  • Chave desconhecida, de outro pipeline ou valor inválido responde 400 e nada é gravado. Campos obrigatórios não são exigidos por esta API.
  • Neste endpoint, null ou texto vazio limpa o campo, e os campos que você não enviar ficam como estão.
probabilitynumber

Nova probabilidade de fechamento em percentual (0 a 100).

ordernumber

Nova posição de ordenação.

expectedClosestring

Nova data prevista de fechamento no formato ISO 8601.

productsarray

Nova lista de produtos a serem associados ao negócio (substitui os vínculos existentes).

Resposta

messagestring

Mensagem de confirmação da atualização.

Autorização

Tokenstring · headerobrigatório

Token de autenticacao gerado na plataforma WavUps CRM.

Parâmetros de caminho

idstringobrigatório

Identificador único do recurso.

Corpo da requisição

application/json · object
titlestringobrigatório

Titulo do negocio.

stageIdstringobrigatório

ID do estagio em que o negocio se encontra.

leadIdstring

ID do lead vinculado ao negocio.

dealOwnerstring

ID do usuario responsavel pelo negocio.

descriptionstring

Descricao do negocio.

valuenumber

Valor estimado do negocio.

statusenum<string>

Status do negocio. Padrao: open. A etapa manda: criado numa etapa de ganho ou de perdido, o negocio ja nasce won ou lost (o status enviado e ignorado). Enviado como won ou lost para uma etapa em andamento, o negocio vai para a primeira etapa de ganho ou de perdido do pipeline, se houver.

Valores aceitos: open, won, lost

typestring

Tipo do negocio.

nextActionstring

Proxima acao prevista.

customFieldsobject

Campos personalizados do negócio, pela chave do campo. Só valem os campos do pipeline da etapa em que o negócio fica (na atualização, a etapa de destino quando o negócio muda de etapa). Seleção aceita o nome ou o id da opção; números aceitam `1500` ou `1.500,50`; datas, `2026-03-15` ou `15/03/2026`; Sim/Não, `true`/`false` ou `sim`/`não`. Chave desconhecida, de outro pipeline ou valor inválido responde `400` e nada é gravado. Na atualização, `null` ou texto vazio limpa o campo e os campos não enviados ficam como estão.

Exemplo: 
{
  "origem_da_proposta": "Indicação",
  "orcamento": "1.500,50"
}
sourcestring

Origem do negocio.

probabilityinteger

Probabilidade de fechamento em percentual (0 a 100).

orderinteger

Posicao de ordenacao.

expectedClosestring<date-time>

Data prevista de fechamento (ISO 8601).

wonAtstring

Data real do ganho (ISO 8601, ex: 2026-10-06 ou 2026-10-06T14:30:00Z). So vale quando o negocio fica ganho. Se omitida, a data do ganho e o momento da criacao (ou da mudanca para ganho). Nao pode ser no futuro.

lostAtstring

Data real da perda (ISO 8601). So vale quando o negocio fica perdido. Se omitida, a data da perda e o momento da criacao (ou da mudanca para perdido). Nao pode ser no futuro.

currencystring

Moeda do valor do negocio: codigo ISO 4217 de 3 letras (BRL, USD, EUR, GBP, JPY...), aceito tambem em minusculas. Padrao: BRL. Codigo desconhecido responde 400.

Exemplo: "BRL"
lossReasonIdstring

ID de um motivo de perda cadastrado na plataforma (o mesmo de lossReasonId nos negocios perdidos). So vale quando o negocio fica perdido. ID que nao e da conta responde 404.

lossNotestring

Observacao da perda (ate 1000 caracteres). So vale quando o negocio fica perdido.

productsobject[]

Lista de produtos vinculados ao negocio.

Respostas

200application/json · object

Negócio atualizado com sucesso.

messagestring
Exemplo: "Operação realizada com sucesso."
404
500