CUBO CRM
  1. Deal
CUBO CRM
  • Comece por aqui
  • Activities
    • Listar todas as atividades
      GET
    • Criar nova atividade
      POST
    • Obter atividade por ID
      GET
    • Atualizar atividade
      PUT
    • Excluir atividade
      DELETE
  • Annotation
    • Criar nova anotação
      POST
    • Obter anotação por ID
      GET
    • Atualizar anotação
      PUT
    • Excluir anotação
      DELETE
  • Apikey
    • Listar todas as apikeys
      GET
    • Criar nova apikey
      POST
    • Obter apikey por ID
      GET
    • Atualizar apikey
      PUT
    • Excluir apikey
      DELETE
  • Category
    • Listar todas as categorias
      GET
    • Criar nova categoria
      POST
    • Obter categoria por ID
      GET
    • Atualizar categoria
      PUT
    • Excluir categoria
      DELETE
  • Company
    • Obter empresa
    • Atualizar empresa
  • Custom Field
    • Listar todos os campos personalizados
    • Criar novo campo personalizado
    • Obter campo personalizado por ID
    • Atualizar campo personalizado
    • Excluir campo personalizado
  • Deal
    • Listar todos os negócios
      GET
    • Criar novo negócio
      POST
    • Obter negócio por ID
      GET
    • Atualizar negócio
      PUT
    • Excluir negócio
      DELETE
  • Domain
    • Listar todos os domínios
    • Criar novo domínio
    • Obter domínio por ID
    • Excluir domínio
  • LostReason
    • Listar todos os motivos de perda
    • Criar motivo de perda
    • Obter motivo de perda por ID
    • Atualizar motivo de perda
    • Excluir motivo de perda
  • Organization
    • Listar todas as organizações
    • Criar nova organização
    • Obter organização por ID
    • Atualizar organização
    • Excluir organização
  • People
    • Listar todas as pessoas
    • Criar nova pessoa
    • Obter pessoa por ID
    • Atualizar pessoa
    • Excluir pessoa
  • Pipe
    • Listar todos os funis
    • Criar novo funil
    • Listar funil por ID
    • Atualizar Funil
    • Excluir funil
  • Product
    • Listar todos os produtos
    • Criar novo produto
    • Obter produto por ID
    • Atualizar produto
    • Excluir produto
  • Proposal
    • Listar todos as propostas
    • Criar proposta para negociação pelo ID
    • Obter proposta por ID
    • Atualizar proposta
  • Stage
    • Buscar todos os estágios do funil pelo ID
    • Criar estágios
    • Obter estágios por ID
    • Atualizar estágio
    • Excluir estágio
  • Template
    • Listar todos os templates de mensagem
    • Criar template de mensagem
    • Criar template de mensagem para negócio pelo ID
    • Obter template de mensagem por ID
    • Atualizar template de mensagem
    • Excluir template de mensagem
  • Webhooks
    • Receber dados do BotConversa para criação
    • Receber dados do BotConversa para atualização
    • Receber dados do ManyChat para criação
    • Receber dados do ManyChat para atualização
  1. Deal

Atualizar negócio

PUT
https://api.cubosuite.com.br/deals/{id}
Descrição#
Atualiza os dados de um negócio pertencente à empresa do usuário autenticado.
Campos opcionais#
CampoTipoDescrição
titlestringNovo título do negócio.
statusenumNovo status do negócio. Valores: open, won, lost.
pricenumberValor monetário do negócio.
detailsstringObservações ou detalhes adicionais.
userIdnumberID do responsável pelo negócio. Deve pertencer à mesma empresa.
peopleIdnumberID do contato associado. Deve pertencer à mesma empresa.
organizationIdnumberID da organização associada. Pode ser null.
stageIdnumberID da etapa do funil.
pipeIdnumberID do funil de vendas.
lostReasonIdnumberID do motivo de perda (obrigatório se status for lost).
winReasonIdnumberID do motivo de ganho.
ratingnumberAvaliação de 0 a 5.
customfieldsarrayCampos personalizados no formato: `{ customfieldId: number, value: string
productsarrayLista de produtos no formato: { productId, quantity, price, status }.
lostDatedatetimeData de perda. Formato: yyyy-MM-dd HH:mm:ss.
winDatedatetimeData de ganho. Formato: yyyy-MM-dd HH:mm:ss.
expectClosingDatedateData esperada de fechamento. Formato: dd/MM/yyyy. Pode ser null.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.cubosuite.com.br/deals/995915' \
--header 'Content-Type: application/json' \
--data-raw '{
  "title": "Negócio com ACME",
  "status": "lost",
  "price": 12000,
  "userId": 3,
  "peopleId": 15,
  "organizationId": 8,
  "pipeId": 1,
  "stageId": 4,
  "lostReasonId": 2,
  "customfields": [
    {
      "customfieldId": 6,
      "value": "Alto potencial"
    }
  ],
  "products": [
    {
      "productId": 2,
      "quantity": 3,
      "price": 4000,
      "status": "active"
    }
  ],
  "lostDate": "2024-10-12 14:00:00",
  "expectClosingDate": "15/11/2024"
}'
Response Response Example
{"organizationId":null,"lostReasonId":null,"winReasonId":null,"duplicatedId":null,"lostStageId":null,"id":995915,"title":"Teste IMPOR","price":null,"details":null,"userId":1,"peopleId":995357,"stageId":305900,"pipeId":300908,"status":"open","probability":null,"lostDate":null,"winDate":null,"rdUuid":null,"rotten":false,"lastMove":"2025-02-10T11:22:38.681-03:00","orderNr":0,"createdBy":"manual","rating":0,"timeUntilClosing":null,"createdAt":"2024-11-14T14:23:26.000-03:00","updatedAt":"2025-02-10T11:22:38.681-03:00","transshipmentOriginId":null,"firstMove":"2025-02-10T11:22:38.681-03:00","ipAddress":null,"userAgent":null,"url":null,"token":null,"conversasId":null,"throughSplit":0,"stage":{"id":305900,"name":"Novo Estágio","description":"Teste","orderNr":1,"pipeId":300908,"rottenFlag":0,"rottenDays":1,"createdAt":"2024-05-24T10:32:36.000-03:00","updatedAt":"2025-02-10T08:55:09.000-03:00","lightBackground":"bg-white","darkBackground":"gray-200","meta":{"deleted_at":null}},"activities":[],"customfields":[{"id":6561307,"dealId":995915,"customfieldId":309061,"value":"s ","createdAt":"2025-02-10T11:22:38.000-03:00","updatedAt":"2025-02-10T11:22:38.000-03:00","customfield":{"id":309061,"name":"Aniversário Cliente","context":"deal","companyId":3,"type":"text","mask":null,"status":"active","showCard":0,"createdAt":"2024-08-27T14:41:41.000-03:00","updatedAt":"2024-09-10T09:35:04.000-03:00"}}],"lostReason":null,"organization":null,"people":{"id":995357,"name":"TESTE IMPORT","phone":"(17) 99218-2270","organizationId":null,"userId":1,"companyId":3,"status":"active","createdAt":"2024-11-14T14:23:26.000-03:00","updatedAt":"2024-11-14T14:23:26.000-03:00","validPhone":"validating","token":null,"normalizedPhone":null},"user":{"id":1,"name":"Wellington Capoia","phone":"(17) 99206-1486","email":"wellingtonc@prospecta.digital","status":"active","type":"administrator","picture":"https://files.cubocrm.com.br/user/default-user-avatar.jpg","companyId":3,"defaultPipe":null,"rememberMeToken":null,"createdAt":"2021-01-13T11:19:31.000-03:00","updatedAt":"2025-01-21T10:52:27.000-03:00","sendNotificationWhatsapp":true,"manychatContactId":620274171,"meta":{}},"products":[],"pipe":{"id":300908,"name":"Wellington (Não Excluir)","orderNr":6,"companyId":3,"primaryField":null,"dailyReports":null,"createdAt":"2024-02-26T11:40:01.000-03:00","updatedAt":"2025-02-07T15:53:47.000-03:00","status":"active","firstRating":"FRIO","seccondRating":"SEGUNDA","thirdRating":"TERCEIRA","fourthRating":"QUARTA","fifthRating":"QUINTA","showProduct":1,"showProductFormat":"list","timeEditAnnotation":135,"users":[{"id":1,"name":"Wellington Capoia","phone":"(17) 99206-1486","email":"wellingtonc@prospecta.digital","status":"active","type":"administrator","picture":"https://files.cubocrm.com.br/user/default-user-avatar.jpg","companyId":3,"defaultPipe":null,"rememberMeToken":null,"createdAt":"2021-01-13T11:19:31.000-03:00","updatedAt":"2025-01-21T10:52:27.000-03:00","sendNotificationWhatsapp":true,"manychatContactId":620274171,"meta":{"pivot_pipe_id":300908,"pivot_user_id":1,"pivot_splitter":1,"pivot_count":0}}],"stages":[{"id":305900,"name":"Novo Estágio","description":"Teste","orderNr":1,"pipeId":300908,"rottenFlag":0,"rottenDays":1,"createdAt":"2024-05-24T10:32:36.000-03:00","updatedAt":"2025-02-10T08:55:09.000-03:00","lightBackground":"bg-white","darkBackground":"gray-200","meta":{"deleted_at":null}},{"id":303609,"name":"Teste 3","description":null,"orderNr":2,"pipeId":300908,"rottenFlag":1,"rottenDays":2,"createdAt":"2024-02-26T11:42:19.000-03:00","updatedAt":"2025-02-10T09:51:42.000-03:00","lightBackground":"white","darkBackground":"red-200","meta":{"deleted_at":null}},{"id":305902,"name":"novo de novo","description":null,"orderNr":3,"pipeId":300908,"rottenFlag":0,"rottenDays":1,"createdAt":"2024-05-24T10:47:58.000-03:00","updatedAt":"2025-02-10T11:09:01.000-03:00","lightBackground":"yellow-200","darkBackground":"bg-null","meta":{"deleted_at":null}},{"id":305985,"name":"Novo 5","description":null,"orderNr":3,"pipeId":300908,"rottenFlag":0,"rottenDays":1,"createdAt":"2024-05-27T14:22:10.000-03:00","updatedAt":"2025-02-03T10:21:40.000-03:00","lightBackground":null,"darkBackground":null,"meta":{"deleted_at":null}},{"id":310394,"name":"Teste novo","description":null,"orderNr":5,"pipeId":300908,"rottenFlag":0,"rottenDays":1,"createdAt":"2024-11-11T15:29:38.000-03:00","updatedAt":"2024-11-11T15:29:38.000-03:00","lightBackground":null,"darkBackground":null,"meta":{"deleted_at":null}},{"id":310543,"name":"teste alteração em massa","description":null,"orderNr":6,"pipeId":300908,"rottenFlag":0,"rottenDays":1,"createdAt":"2024-11-18T10:01:16.000-03:00","updatedAt":"2024-11-18T10:01:16.000-03:00","lightBackground":null,"darkBackground":null,"meta":{"deleted_at":null}},{"id":310894,"name":"Meu novo estágio 456","description":null,"orderNr":7,"pipeId":300908,"rottenFlag":0,"rottenDays":null,"createdAt":"2024-11-28T15:34:56.000-03:00","updatedAt":"2024-11-28T15:41:22.000-03:00","lightBackground":"#A9A9A9","darkBackground":"#A9A9A9","meta":{"deleted_at":null}},{"id":310969,"name":"Teste Daniel","description":null,"orderNr":8,"pipeId":300908,"rottenFlag":0,"rottenDays":1,"createdAt":"2024-12-03T16:06:06.000-03:00","updatedAt":"2024-12-03T16:06:06.000-03:00","lightBackground":"black","darkBackground":"pink-200","meta":{"deleted_at":null}}],"primary":null,"meta":{"deleted_at":null,"show_custom_field_format":"setfield"}},"whatsappMessages":[],"winReason":null,"annotations":[{"dealId":995915,"organizationId":null,"peopleId":null,"activityId":null,"id":6264824,"text":"Aniversário Cliente: Sem informação → s ","userId":1,"type":"alteration","createdAt":"2025-02-10T11:22:38.000-03:00","updatedAt":"2025-02-10T11:22:38.000-03:00","user":{"id":1,"name":"Wellington Capoia","phone":"(17) 99206-1486","email":"wellingtonc@prospecta.digital","status":"active","type":"administrator","picture":"https://files.cubocrm.com.br/user/default-user-avatar.jpg","companyId":3,"defaultPipe":null,"rememberMeToken":null,"createdAt":"2021-01-13T11:19:31.000-03:00","updatedAt":"2025-01-21T10:52:27.000-03:00","sendNotificationWhatsapp":true,"manychatContactId":620274171,"meta":{}},"activity":null},{"dealId":995915,"organizationId":null,"peopleId":null,"activityId":null,"id":6264823,"text":"Estágio: Novo 5 → Novo Estágio","userId":1,"type":"alteration","createdAt":"2025-02-10T11:22:37.000-03:00","updatedAt":"2025-02-10T11:22:37.000-03:00","user":{"id":1,"name":"Wellington Capoia","phone":"(17) 99206-1486","email":"wellingtonc@prospecta.digital","status":"active","type":"administrator","picture":"https://files.cubocrm.com.br/user/default-user-avatar.jpg","companyId":3,"defaultPipe":null,"rememberMeToken":null,"createdAt":"2021-01-13T11:19:31.000-03:00","updatedAt":"2025-01-21T10:52:27.000-03:00","sendNotificationWhatsapp":true,"manychatContactId":620274171,"meta":{}},"activity":null},{"dealId":995915,"organizationId":null,"peopleId":null,"activityId":null,"id":5335437,"text":"Negociação criada","userId":1,"type":"alteration","createdAt":"2024-11-14T14:23:26.000-03:00","updatedAt":"2024-11-14T14:23:26.000-03:00","user":{"id":1,"name":"Wellington Capoia","phone":"(17) 99206-1486","email":"wellingtonc@prospecta.digital","status":"active","type":"administrator","picture":"https://files.cubocrm.com.br/user/default-user-avatar.jpg","companyId":3,"defaultPipe":null,"rememberMeToken":null,"createdAt":"2021-01-13T11:19:31.000-03:00","updatedAt":"2025-01-21T10:52:27.000-03:00","sendNotificationWhatsapp":true,"manychatContactId":620274171,"meta":{}},"activity":null}]}

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros Path
id
string 
requerido
Exemplo:
995915
Parâmetros Header
Content-Type
string 
opcional
Exemplo:
application/json
Parâmetros Bodyapplication/json
stageId
integer 
requerido
customfields
array [object {2}] 
requerido
customfieldId
string 
opcional
value
string 
opcional
Examples

Respostas

🟢200Success
application/json
Body
organizationId
null 
requerido
lostReasonId
null 
requerido
winReasonId
null 
requerido
duplicatedId
null 
requerido
lostStageId
null 
requerido
id
integer 
requerido
title
string 
requerido
price
null 
requerido
details
null 
requerido
userId
integer 
requerido
peopleId
integer 
requerido
stageId
integer 
requerido
pipeId
integer 
requerido
status
string 
requerido
probability
null 
requerido
lostDate
null 
requerido
winDate
null 
requerido
rdUuid
null 
requerido
rotten
boolean 
requerido
lastMove
string 
requerido
orderNr
integer 
requerido
createdBy
string 
requerido
rating
integer 
requerido
timeUntilClosing
null 
requerido
createdAt
string 
requerido
updatedAt
string 
requerido
transshipmentOriginId
null 
requerido
firstMove
string 
requerido
ipAddress
null 
requerido
userAgent
null 
requerido
url
null 
requerido
token
null 
requerido
conversasId
null 
requerido
throughSplit
integer 
requerido
stage
object 
requerido
id
integer 
requerido
name
string 
requerido
description
string 
requerido
orderNr
integer 
requerido
pipeId
integer 
requerido
rottenFlag
integer 
requerido
rottenDays
integer 
requerido
createdAt
string 
requerido
updatedAt
string 
requerido
lightBackground
string 
requerido
darkBackground
string 
requerido
meta
object 
requerido
activities
array
requerido
customfields
array [object {7}] 
requerido
id
integer 
opcional
dealId
integer 
opcional
customfieldId
integer 
opcional
value
string 
opcional
createdAt
string 
opcional
updatedAt
string 
opcional
customfield
object 
opcional
lostReason
null 
requerido
organization
null 
requerido
people
object 
requerido
id
integer 
requerido
name
string 
requerido
phone
string 
requerido
organizationId
null 
requerido
userId
integer 
requerido
companyId
integer 
requerido
status
string 
requerido
createdAt
string 
requerido
updatedAt
string 
requerido
validPhone
string 
requerido
token
null 
requerido
normalizedPhone
null 
requerido
user
object 
requerido
id
integer 
requerido
name
string 
requerido
phone
string 
requerido
email
string 
requerido
status
string 
requerido
type
string 
requerido
picture
string 
requerido
companyId
integer 
requerido
defaultPipe
null 
requerido
rememberMeToken
null 
requerido
createdAt
string 
requerido
updatedAt
string 
requerido
sendNotificationWhatsapp
boolean 
requerido
manychatContactId
integer 
requerido
meta
object 
requerido
products
array
requerido
pipe
object 
requerido
id
integer 
requerido
name
string 
requerido
orderNr
integer 
requerido
companyId
integer 
requerido
primaryField
null 
requerido
dailyReports
null 
requerido
createdAt
string 
requerido
updatedAt
string 
requerido
status
string 
requerido
firstRating
string 
requerido
seccondRating
string 
requerido
thirdRating
string 
requerido
fourthRating
string 
requerido
fifthRating
string 
requerido
showProduct
integer 
requerido
showProductFormat
string 
requerido
timeEditAnnotation
integer 
requerido
users
array [object {15}] 
requerido
stages
array [object {12}] 
requerido
primary
null 
requerido
meta
object 
requerido
whatsappMessages
array
requerido
winReason
null 
requerido
annotations
array [object {12}] 
requerido
dealId
integer 
requerido
organizationId
null 
requerido
peopleId
null 
requerido
activityId
null 
requerido
id
integer 
requerido
text
string 
requerido
userId
integer 
requerido
type
string 
requerido
createdAt
string 
requerido
updatedAt
string 
requerido
user
object 
requerido
activity
null 
requerido
Página anterior
Obter negócio por ID
Próxima página
Excluir negócio
Built with