Atualizar negócio
PUT
https://api.cubosuite.com.br/deals/{id}
Descrição
Campos opcionais
| Campo | Tipo | Descrição |
|---|---|---|
| title | string | Novo título do negócio. |
| status | enum | Novo status do negócio. Valores: open, won, lost. |
| price | number | Valor monetário do negócio. |
| details | string | Observações ou detalhes adicionais. |
| userId | number | ID do responsável pelo negócio. Deve pertencer à mesma empresa. |
| peopleId | number | ID do contato associado. Deve pertencer à mesma empresa. |
| organizationId | number | ID da organização associada. Pode ser null. |
| stageId | number | ID da etapa do funil. |
| pipeId | number | ID do funil de vendas. |
| lostReasonId | number | ID do motivo de perda (obrigatório se status for lost). |
| winReasonId | number | ID do motivo de ganho. |
| rating | number | Avaliação de 0 a 5. |
| customfields | array | Campos personalizados no formato: `{ customfieldId: number, value: string |
| products | array | Lista de produtos no formato: { productId, quantity, price, status }. |
| lostDate | datetime | Data de perda. Formato: yyyy-MM-dd HH:mm:ss. |
| winDate | datetime | Data de ganho. Formato: yyyy-MM-dd HH:mm:ss. |
| expectClosingDate | date | Data 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": "Negociação com Empresa X Update",
"status": "open",
"price": 15000,
"userId": 5,
"pipeId": 2,
"stageId": 7,
"rating": 4,
"customfields": [
{
"customfieldId": 3,
"value": "Urgente"
}
],
"expectClosingDate": "31/12/2025"
}'Response Response Example
{
"organizationId": 456733,
"lostReasonId": null,
"winReasonId": null,
"duplicatedId": null,
"lostStageId": null,
"id": 1419746,
"title": "Negociação com Empresa X Update",
"price": 15000,
"details": null,
"userId": 52,
"peopleId": 1374164,
"stageId": 315013,
"pipeId": 303357,
"status": "open",
"probability": null,
"lostDate": null,
"winDate": null,
"rdUuid": null,
"rotten": false,
"lastMove": "2025-06-23T10:26:44.503-03:00",
"orderNr": 0,
"createdBy": "api",
"rating": 4,
"timeUntilClosing": null,
"createdAt": "2025-06-23T10:20:26.000-03:00",
"updatedAt": "2025-06-23T10:26:44.503-03:00",
"expectClosingDate": "31/12/2025",
"transshipmentOriginId": null,
"firstMove": "2025-06-23T10:26:44.503-03:00",
"ipAddress": null,
"userAgent": null,
"url": null,
"token": null,
"conversasId": null,
"throughSplit": 0,
"payload": {
"price": 15000,
"title": "Negociação com Empresa X",
"pipeId": 303357,
"rating": 4,
"status": "open",
"userId": 52,
"stageId": 315012,
"products": [
{
"price": 5000,
"quantity": 2,
"productId": 313641
},
{
"quantity": 1,
"productId": 311928
}
],
"peopleName": "João Silva",
"peoplePhone": "(11) 99999-9999",
"customfields": [
{
"value": "Urgente",
"customfieldId": 315335
}
],
"expectClosingDate": "2025-12-31T00:00:00.000-03:00"
},
"stage": {
"id": 315012,
"name": "Novos",
"description": null,
"orderNr": 1,
"pipeId": 303357,
"rottenFlag": 0,
"rottenDays": 1,
"createdAt": "2025-06-23T08:38:06.000-03:00",
"updatedAt": "2025-06-23T08:38:06.000-03:00",
"lightBackground": null,
"darkBackground": null,
"meta": {
"deleted_at": null
}
},
"activities": [],
"user": {
"id": 52,
"name": "CuboCRM",
"phone": "(17) 99218-2270",
"email": "cubocrm@cubocrm.com.br",
"status": "active",
"type": "administrator",
"picture": "https://files.cubocrm.com.br/user/default-user-avatar.jpg",
"companyId": 1,
"defaultPipe": null,
"rememberMeToken": null,
"createdAt": "2020-12-14T22:12:58.000-03:00",
"updatedAt": "2025-04-09T13:49:29.000-03:00",
"sendNotificationWhatsapp": true,
"manychatContactId": 950438185,
"messagesAtOnce": 100,
"meta": {
"google_refresh_token": null
}
},
"people": {
"id": 1374164,
"name": "João Silva",
"phone": "(11) 99999-9999",
"organizationId": null,
"userId": 52,
"companyId": 1,
"status": "active",
"createdAt": "2025-06-23T10:20:26.000-03:00",
"updatedAt": "2025-06-23T10:20:26.000-03:00",
"token": null,
"normalizedPhone": "11999999999"
},
"organization": {
"id": 456733,
"name": "Empresa X LTDA",
"status": "active",
"companyId": 1,
"userId": 52,
"createdAt": "2025-06-23T10:20:26.000-03:00",
"updatedAt": "2025-06-23T10:20:26.000-03:00"
},
"lostReason": null,
"products": [],
"customfields": [
{
"id": 7308575,
"dealId": 1419746,
"customfieldId": 315335,
"value": "Urgente Update",
"createdAt": "2025-06-23T10:20:26.000-03:00",
"updatedAt": "2025-06-23T10:26:44.000-03:00",
"customfield": {
"id": 315335,
"name": "Bairro Odonto",
"context": "deal",
"companyId": 1,
"type": "text",
"mask": null,
"status": "active",
"showCard": 1,
"createdAt": "2025-06-18T18:01:27.000-03:00",
"updatedAt": "2025-06-18T18:01:27.000-03:00"
}
}
],
"pipe": {
"id": 303357,
"name": "Daniel",
"orderNr": 0,
"companyId": 1,
"dailyReports": null,
"createdAt": "2025-06-23T08:37:46.000-03:00",
"updatedAt": "2025-06-23T08:37:46.000-03:00",
"status": "active",
"firstRating": null,
"seccondRating": null,
"thirdRating": null,
"fourthRating": null,
"fifthRating": null,
"showProductFormat": "setfield",
"timeEditAnnotation": 0,
"showCustomFieldFormat": "setfield",
"primaryField": null,
"stages": [
{
"id": 315012,
"name": "Novos",
"description": null,
"orderNr": 1,
"pipeId": 303357,
"rottenFlag": 0,
"rottenDays": 1,
"createdAt": "2025-06-23T08:38:06.000-03:00",
"updatedAt": "2025-06-23T08:38:06.000-03:00",
"lightBackground": null,
"darkBackground": null,
"meta": {
"deleted_at": null
}
},
{
"id": 315013,
"name": "Update",
"description": null,
"orderNr": 2,
"pipeId": 303357,
"rottenFlag": 0,
"rottenDays": null,
"createdAt": "2025-06-23T08:41:48.000-03:00",
"updatedAt": "2025-06-23T08:41:48.000-03:00",
"lightBackground": null,
"darkBackground": null,
"meta": {
"deleted_at": null
}
}
],
"users": [
{
"id": 52,
"name": "CuboCRM",
"phone": "(17) 99218-2270",
"email": "cubocrm@cubocrm.com.br",
"status": "active",
"type": "administrator",
"picture": "https://files.cubocrm.com.br/user/default-user-avatar.jpg",
"companyId": 1,
"defaultPipe": null,
"rememberMeToken": null,
"createdAt": "2020-12-14T22:12:58.000-03:00",
"updatedAt": "2025-04-09T13:49:29.000-03:00",
"sendNotificationWhatsapp": true,
"manychatContactId": 950438185,
"messagesAtOnce": 100,
"meta": {
"google_refresh_token": null,
"pivot_pipe_id": 303357,
"pivot_user_id": 52,
"pivot_splitter": 1,
"pivot_count": 0
}
},
{
"id": 300152,
"name": "Web Dev",
"phone": null,
"email": "webcompra@prospecta.digital",
"status": "active",
"type": "administrator",
"picture": null,
"companyId": 1,
"defaultPipe": null,
"rememberMeToken": null,
"createdAt": "2023-06-27T16:36:36.000-03:00",
"updatedAt": "2023-06-27T16:36:36.000-03:00",
"sendNotificationWhatsapp": false,
"manychatContactId": null,
"messagesAtOnce": 100,
"meta": {
"google_refresh_token": null,
"pivot_pipe_id": 303357,
"pivot_user_id": 300152,
"pivot_splitter": 1,
"pivot_count": 0
}
},
{
"id": 301200,
"name": "Gustavo Vicente",
"phone": "(17) 99177-0642",
"email": "gustavobvicente@hotmail.com",
"status": "active",
"type": "administrator",
"picture": null,
"companyId": 1,
"defaultPipe": null,
"rememberMeToken": null,
"createdAt": "2024-05-10T10:57:12.000-03:00",
"updatedAt": "2025-04-23T14:31:46.000-03:00",
"sendNotificationWhatsapp": true,
"manychatContactId": 990151908,
"messagesAtOnce": 100,
"meta": {
"google_refresh_token": null,
"pivot_pipe_id": 303357,
"pivot_user_id": 301200,
"pivot_splitter": 1,
"pivot_count": 0
}
},
{
"id": 301704,
"name": "Ricardo Junior",
"phone": "(17) 98208-1918",
"email": "rijunior335@gmail.com",
"status": "active",
"type": "administrator",
"picture": "https://files.cubocrm.com.br/companies/1/user/301704/picture/cubologo-JXk3KxABna-p4TvsGgpx.jpeg",
"companyId": 1,
"defaultPipe": null,
"rememberMeToken": null,
"createdAt": "2024-09-16T08:59:53.000-03:00",
"updatedAt": "2025-06-11T15:09:58.000-03:00",
"sendNotificationWhatsapp": false,
"manychatContactId": 315145454,
"messagesAtOnce": 100,
"meta": {
"google_refresh_token": null,
"pivot_pipe_id": 303357,
"pivot_user_id": 301704,
"pivot_splitter": 1,
"pivot_count": 0
}
},
{
"id": 302113,
"name": "Dário",
"phone": "(17) 99179-2161",
"email": "dariopereiradps6@gmail.com",
"status": "active",
"type": "administrator",
"picture": null,
"companyId": 1,
"defaultPipe": null,
"rememberMeToken": null,
"createdAt": "2025-01-16T10:50:21.000-03:00",
"updatedAt": "2025-06-20T09:01:28.000-03:00",
"sendNotificationWhatsapp": true,
"manychatContactId": 1218142097,
"messagesAtOnce": 100,
"meta": {
"google_refresh_token": null,
"pivot_pipe_id": 303357,
"pivot_user_id": 302113,
"pivot_splitter": 1,
"pivot_count": 0
}
},
{
"id": 302476,
"name": "Vitoria Cruzeiro",
"phone": "(17) 99769-6645",
"email": "vitoriafcruzeiro@gmail.com",
"status": "active",
"type": "administrator",
"picture": null,
"companyId": 1,
"defaultPipe": null,
"rememberMeToken": null,
"createdAt": "2025-04-10T14:19:27.000-03:00",
"updatedAt": "2025-05-28T16:15:30.000-03:00",
"sendNotificationWhatsapp": true,
"manychatContactId": 754006967,
"messagesAtOnce": 100,
"meta": {
"google_refresh_token": null,
"pivot_pipe_id": 303357,
"pivot_user_id": 302476,
"pivot_splitter": 1,
"pivot_count": 0
}
}
],
"meta": {
"deleted_at": null
}
},
"winReason": null,
"whatsappMessages": [],
"annotations": [
{
"dealId": 1419746,
"organizationId": null,
"peopleId": null,
"activityId": null,
"id": 7364197,
"text": "Bairro Odonto: Urgente → Urgente Update",
"userId": 52,
"type": "alteration",
"createdAt": "2025-06-23T10:26:44.000-03:00",
"updatedAt": "2025-06-23T10:26:44.000-03:00",
"user": {
"id": 52,
"name": "CuboCRM",
"phone": "(17) 99218-2270",
"email": "cubocrm@cubocrm.com.br",
"status": "active",
"type": "administrator",
"picture": "https://files.cubocrm.com.br/user/default-user-avatar.jpg",
"companyId": 1,
"defaultPipe": null,
"rememberMeToken": null,
"createdAt": "2020-12-14T22:12:58.000-03:00",
"updatedAt": "2025-04-09T13:49:29.000-03:00",
"sendNotificationWhatsapp": true,
"manychatContactId": 950438185,
"messagesAtOnce": 100,
"meta": {
"google_refresh_token": null
}
},
"activity": null
},
{
"dealId": 1419746,
"organizationId": null,
"peopleId": null,
"activityId": null,
"id": 7364196,
"text": "Estágio: Novos → Update",
"userId": 52,
"type": "alteration",
"createdAt": "2025-06-23T10:26:44.000-03:00",
"updatedAt": "2025-06-23T10:26:44.000-03:00",
"user": {
"id": 52,
"name": "CuboCRM",
"phone": "(17) 99218-2270",
"email": "cubocrm@cubocrm.com.br",
"status": "active",
"type": "administrator",
"picture": "https://files.cubocrm.com.br/user/default-user-avatar.jpg",
"companyId": 1,
"defaultPipe": null,
"rememberMeToken": null,
"createdAt": "2020-12-14T22:12:58.000-03:00",
"updatedAt": "2025-04-09T13:49:29.000-03:00",
"sendNotificationWhatsapp": true,
"manychatContactId": 950438185,
"messagesAtOnce": 100,
"meta": {
"google_refresh_token": null
}
},
"activity": null
},
{
"dealId": 1419746,
"organizationId": null,
"peopleId": null,
"activityId": null,
"id": 7364195,
"text": "Preço: R$ 11.500,00 → R$ 15.000,00",
"userId": 52,
"type": "alteration",
"createdAt": "2025-06-23T10:26:44.000-03:00",
"updatedAt": "2025-06-23T10:26:44.000-03:00",
"user": {
"id": 52,
"name": "CuboCRM",
"phone": "(17) 99218-2270",
"email": "cubocrm@cubocrm.com.br",
"status": "active",
"type": "administrator",
"picture": "https://files.cubocrm.com.br/user/default-user-avatar.jpg",
"companyId": 1,
"defaultPipe": null,
"rememberMeToken": null,
"createdAt": "2020-12-14T22:12:58.000-03:00",
"updatedAt": "2025-04-09T13:49:29.000-03:00",
"sendNotificationWhatsapp": true,
"manychatContactId": 950438185,
"messagesAtOnce": 100,
"meta": {
"google_refresh_token": null
}
},
"activity": null
},
{
"dealId": 1419746,
"organizationId": null,
"peopleId": null,
"activityId": null,
"id": 7364194,
"text": "Titulo: Negociação com Empresa X Update → Negociação com Empresa X Update",
"userId": 52,
"type": "alteration",
"createdAt": "2025-06-23T10:26:44.000-03:00",
"updatedAt": "2025-06-23T10:26:44.000-03:00",
"user": {
"id": 52,
"name": "CuboCRM",
"phone": "(17) 99218-2270",
"email": "cubocrm@cubocrm.com.br",
"status": "active",
"type": "administrator",
"picture": "https://files.cubocrm.com.br/user/default-user-avatar.jpg",
"companyId": 1,
"defaultPipe": null,
"rememberMeToken": null,
"createdAt": "2020-12-14T22:12:58.000-03:00",
"updatedAt": "2025-04-09T13:49:29.000-03:00",
"sendNotificationWhatsapp": true,
"manychatContactId": 950438185,
"messagesAtOnce": 100,
"meta": {
"google_refresh_token": null
}
},
"activity": null
},
{
"dealId": 1419746,
"organizationId": null,
"peopleId": null,
"activityId": null,
"id": 7364097,
"text": "Negociação criada",
"userId": 52,
"type": "alteration",
"createdAt": "2025-06-23T10:20:26.000-03:00",
"updatedAt": "2025-06-23T10:20:26.000-03:00",
"user": {
"id": 52,
"name": "CuboCRM",
"phone": "(17) 99218-2270",
"email": "cubocrm@cubocrm.com.br",
"status": "active",
"type": "administrator",
"picture": "https://files.cubocrm.com.br/user/default-user-avatar.jpg",
"companyId": 1,
"defaultPipe": null,
"rememberMeToken": null,
"createdAt": "2020-12-14T22:12:58.000-03:00",
"updatedAt": "2025-04-09T13:49:29.000-03:00",
"sendNotificationWhatsapp": true,
"manychatContactId": 950438185,
"messagesAtOnce": 100,
"meta": {
"google_refresh_token": null
}
},
"activity": null
}
]
}Requisição
Parâmetros Path
id
string
requerido
Exemplo:
995915
Parâmetros Header
Content-Type
string
opcional
Exemplo:
application/json
Parâmetros Bodyapplication/json
Respostas
Modificado em 2025-06-23 14:02:30