Criar novo negócio
POST
https://api.cubosuite.com.br/deals
Descrição
Valida estágios e pipelines, trata duplicados, calcula preço total e cria anotações iniciais.
Campos
| Campo | Tipo | Descrição |
|---|---|---|
| title | string | Título da negociação. Obrigatório. |
| status | enum ['open', 'won', 'lost'] | Status da negociação. Opcional, padrão é 'open'. |
| price | number | Preço total da negociação. Opcional, pode ser calculado a partir dos produtos. |
| userId | number | ID do usuário responsável. Opcional, deve existir na empresa. |
| duplicatedId | number | ID de negociação duplicada. Opcional. |
| peopleName | string | Nome da pessoa relacionada. Obrigatório se peopleId não for fornecido. |
| peopleId | number | ID da pessoa relacionada. Obrigatório se peopleName não for fornecido. |
| peoplePhone | string | Telefone da pessoa. Opcional. |
| organizationName | string | Nome da organização. Opcional. |
| organizationId | number | ID da organização. Opcional. |
| stageId | number | ID do estágio da negociação. Opcional, validado conforme pipeline. |
| pipeId | number | ID do pipeline da negociação. Opcional, validado conforme empresa. |
| rating | number (0 a 5) | Avaliação da negociação. Opcional. |
| products | array de objetos | Lista de produtos associados com productId, quantity e preço opcional. |
| customfields | array de objetos | Campos personalizados associados, com customfieldId e value. |
| expectClosingDate | date (dd/MM/yyyy) | Data esperada para fechamento da negociação. Opcional. |
| lostDate | datetime (yyyy-MM-dd HH:mm:ss) | Data em que a negociação foi perdida. Opcional. |
| lostReasonId | number | Motivo da perda, obrigatório se status for lost. |
| winDate | datetime (yyyy-MM-dd HH:mm:ss) | Data em que a negociação foi ganha. Opcional. |
Requisição
Parâmetros Header
Parâmetros Bodyapplication/json
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.cubosuite.com.br/deals' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"title": "Negociação com Empresa X",
"status": "open",
"price": 15000,
"userId": 5,
"peopleName": "João Silva",
"peoplePhone": "(11) 99999-9999",
"organizationName": "Empresa X LTDA",
"pipeId": 2,
"stageId": 7,
"rating": 4,
"products": [
{
"productId": 10,
"quantity": 2,
"price": 5000
},
{
"productId": 15,
"quantity": 1
}
],
"customfields": [
{
"customfieldId": 3,
"value": "Urgente"
}
],
"expectClosingDate": "31/12/2025"
}'Response Response Example
200 - Success
{
"organizationId": 456733,
"lostReasonId": null,
"winReasonId": null,
"lostStageId": null,
"title": "Negociação com Empresa X",
"status": "open",
"price": 11500,
"userId": 52,
"stageId": 315012,
"pipeId": 303357,
"rating": 4,
"expectClosingDate": "31/12/2025",
"peopleId": 1374164,
"rotten": false,
"throughSplit": false,
"createdBy": "api",
"payload": "{\"customfields\":[{\"customfieldId\":315335,\"value\":\"Urgente\"}],\"products\":[{\"productId\":313641,\"quantity\":2,\"price\":5000},{\"productId\":311928,\"quantity\":1}],\"peoplePhone\":\"(11) 99999-9999\",\"peopleName\":\"João Silva\",\"title\":\"Negociação com Empresa X\",\"status\":\"open\",\"price\":15000,\"userId\":52,\"stageId\":315012,\"pipeId\":303357,\"rating\":4,\"expectClosingDate\":\"2025-12-31T00:00:00.000-03:00\"}",
"lastMove": "2025-06-23T10:20:26.176-03:00",
"firstMove": "2025-06-23T10:20:26.176-03:00",
"createdAt": "2025-06-23T10:20:26.176-03:00",
"updatedAt": "2025-06-23T10:20:26.176-03:00",
"id": 1419746,
"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,
"meta": {
"deleted_at": 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"
},
"whatsappMessages": [],
"activities": [],
"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": [
{
"id": 311928,
"name": "Bicicleta aro 17",
"sku": null,
"price": "1500.00",
"status": "active",
"companyId": 1,
"createdAt": "2024-10-16T10:22:00.000-03:00",
"updatedAt": "2024-10-16T10:22:00.000-03:00",
"description": null,
"urlThumbnail": null,
"urlImage": null,
"showCard": 0,
"meta": {
"pivot_price": "1500.00",
"pivot_quantity": 1,
"deleted_at": null,
"pivot_deal_id": 1419746,
"pivot_product_id": 311928,
"pivot_status": "active",
"pivot_created_at": "2025-06-23T10:20:26.000-03:00",
"pivot_updated_at": "2025-06-23T10:20:26.000-03:00"
}
},
{
"id": 313641,
"name": "Apartamento JK",
"sku": null,
"price": "300000.00",
"status": "active",
"companyId": 1,
"createdAt": "2025-05-30T13:40:54.000-03:00",
"updatedAt": "2025-05-30T13:40:54.000-03:00",
"description": null,
"urlThumbnail": null,
"urlImage": null,
"showCard": 0,
"meta": {
"pivot_price": "5000.00",
"pivot_quantity": 2,
"deleted_at": null,
"pivot_deal_id": 1419746,
"pivot_product_id": 313641,
"pivot_status": "active",
"pivot_created_at": "2025-06-23T10:20:26.000-03:00",
"pivot_updated_at": "2025-06-23T10:20:26.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
}
},
"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,
"company": {
"id": 1,
"name": "Cubo",
"smtpHost": null,
"smtpPort": null,
"smtpPassword": "m",
"userLimit": 99999,
"status": "active",
"createdAt": "2021-06-27T01:14:23.000-03:00",
"updatedAt": "2025-06-23T10:18:39.000-03:00",
"stripeSubscriptionId": null,
"stripeSubscriptionStatus": null,
"stripeCustomerId": null,
"refferName": null,
"segment": "Tecnologia e Inovação",
"completedOnboarding": 1,
"refferId": "m2rlmjc",
"tapfiliateId": "ricardojunior3",
"startTrialDate": null,
"endTrialDate": null,
"stripeQuantity": null,
"stripeLastPayment": null,
"stripePaymentMethod": null,
"onboardingStep": 0,
"firstLoginCrm": "2025-01-28T14:43:57.000-03:00",
"lastLoginCrm": "2025-06-23T08:16:50.000-03:00",
"firstLoginExtension": null,
"lastLoginExtension": null,
"firstDealCreated": "2025-01-28T14:21:50.000-03:00",
"lastDealCreated": "2025-06-23T10:18:39.000-03:00",
"firstImportCreated": "2025-02-24T10:01:48.000-03:00",
"lastImportCreated": "2025-05-21T16:47:20.000-03:00",
"firstLandingCreated": "2025-02-20T15:41:42.000-03:00",
"lastLandingCreated": "2025-02-20T15:41:42.000-03:00",
"firstIntegrationCreated": "2025-02-10T07:14:19.000-03:00",
"lastIntegrationCreated": "2025-06-20T11:13:32.000-03:00",
"firstQueueCreated": "2025-01-29T09:58:26.000-03:00",
"lastQueueCreated": "2025-06-18T10:04:13.000-03:00",
"firstActivityCreated": "2025-01-29T08:24:38.000-03:00",
"lastActivityCreated": "2025-06-23T08:34:21.000-03:00",
"firstProductCreated": "2025-02-20T15:34:35.000-03:00",
"lastProductCreated": "2025-05-30T13:40:54.000-03:00",
"optCode": null,
"meta": {}
},
"meta": {
"google_refresh_token": null
}
},
"annotations": [
{
"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
}
],
"customfields": [
{
"id": 7308575,
"dealId": 1419746,
"customfieldId": 315335,
"value": "Urgente",
"createdAt": "2025-06-23T10:20:26.000-03:00",
"updatedAt": "2025-06-23T10:20:26.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"
}
}
]
}Modificado em 2025-06-23 14:02:25