Editar negócio

Edição parcial — só os campos enviados mudam. É por aqui que o negócio muda de etapa.

PATCH https://app.salos.com.br/api/deals/{id} deals:write

Corpo de exemplo — mover de etapa

{ "column_id": "3f9d1a7c-8e2b-4f6d-9a1c-5b7e2d8f4a63" }

O que muda em relação à criação

  • Só os campos enviados mudam. Campo ausente fica como está.
  • name deixa de ser obrigatório.
  • ⛔ company_id não é aceito aqui — a empresa do negócio não muda depois de criado; mandá-la é 400 unknown_field.
  • Entram aqui (e não na criação) column_id — a etapa do funil — e notes.
  • 409 também aparece quando o negócio foi alterado por outra requisição enquanto esta rodava: releia o negócio e tente de novo.
  • ⛔ actual_close_date não é aceito aqui. A data real de fechamento só entra na criação — ver Criar negócio.
  • ⛔ external_id pode ser DEFINIDO, nunca TROCADO. Um negócio que já tem um recebe 409 external_id_immutable — o de-para com o sistema de origem não muda de dono no meio de uma migração.
  • value segue a mesma régua da criação: no máximo duas casas decimais e o mesmo teto.

stage × column_id — leia antes de integrar

Os dois descrevem a mesma coisa. Mandando column_id, o stage é derivado da coluna e o que você enviar em stage é ignorado. ⛒ Mandar column_id de uma coluna de Ganho junto com stage: "new" grava Ganho.

Para mover negócio no funil, mande column_id.