CUBO CRM
  1. Negociação
CUBO CRM
  • Comece por aqui
  • Atividade
    • Listar todas as atividades
      GET
    • Criar nova atividade
      POST
    • Obter atividade por ID
      GET
    • Atualizar atividade
      PUT
    • Excluir atividade
      DELETE
  • Anotação
    • Criar nova anotação
      POST
    • Obter anotação por ID
      GET
    • Atualizar anotação
      PUT
    • Excluir anotação
      DELETE
  • Chave de API
    • Listar todas as chaves de API
      GET
    • Criar nova chave de API
      POST
    • Obter chave de API por ID
      GET
    • Atualizar chave de API
      PUT
    • Excluir chave de API
      DELETE
  • Categoria
    • Listar todas as categorias
      GET
    • Criar nova categoria
      POST
    • Obter categoria por ID
      GET
    • Atualizar categoria
      PUT
    • Excluir categoria
      DELETE
  • Empresa
    • Obter empresa
    • Atualizar empresa
  • Campo Personalizado
    • Listar todos os campos personalizados
    • Criar novo campo personalizado
    • Obter campo personalizado por ID
    • Atualizar campo personalizado
    • Excluir campo personalizado
  • Negociação
    • 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
  • Dominio
    • Listar todos os domínios
    • Criar novo domínio
    • Obter domínio por ID
    • Excluir domínio
  • Motivo de Perda
    • Listar todos os motivos de perda
    • Criar motivo de perda
    • Obter motivo de perda por ID
    • Atualizar motivo de perda
    • Excluir motivo de perda
  • Organização
    • Listar todas as organizações
    • Criar nova organização
    • Obter organização por ID
    • Atualizar organização
    • Excluir organização
  • Pessoa
    • Listar todas as pessoas
    • Criar nova pessoa
    • Obter pessoa por ID
    • Atualizar pessoa
    • Excluir pessoa
  • Funil
    • Listar todos os funis
    • Criar novo funil
    • Listar funil por ID
    • Atualizar Funil
    • Excluir funil
  • Produto
    • Listar todos os produtos
    • Criar novo produto
    • Obter produto por ID
    • Atualizar produto
    • Excluir produto
  • Proposta
    • Listar todos as propostas
    • Criar proposta para negociação pelo ID
    • Obter proposta por ID
    • Atualizar proposta
  • Estágio
    • Buscar todos os estágios do funil pelo ID
    • Criar estágios
    • Obter estágios por ID
    • Atualizar estágio
    • Excluir estágio
  • Modelo
    • Listar todos os modelos de mensagem
    • Criar modelo de mensagem
    • Criar modelo de mensagem para negócio pelo ID
    • Obter modelo de mensagem por ID
    • Atualizar modelo de mensagem
    • Excluir modelo 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. Negociação

Criar novo negócio

POST
https://api.cubosuite.com.br/deals
Descrição#
Cria uma nova negociação associada à empresa do usuário autenticado, incluindo pessoas, organizações, produtos e campos personalizados relacionados.
Valida estágios e pipelines, trata duplicados, calcula preço total e cria anotações iniciais.
Campos#
CampoTipoDescrição
titlestringTítulo da negociação. Obrigatório.
statusenum ['open', 'won', 'lost']Status da negociação. Opcional, padrão é 'open'.
pricenumberPreço total da negociação. Opcional, pode ser calculado a partir dos produtos.
userIdnumberID do usuário responsável. Opcional, deve existir na empresa.
duplicatedIdnumberID de negociação duplicada. Opcional.
peopleNamestringNome da pessoa relacionada. Obrigatório se peopleId não for fornecido.
peopleIdnumberID da pessoa relacionada. Obrigatório se peopleName não for fornecido.
peoplePhonestringTelefone da pessoa. Opcional.
organizationNamestringNome da organização. Opcional.
organizationIdnumberID da organização. Opcional.
stageIdnumberID do estágio da negociação. Opcional, validado conforme pipeline.
pipeIdnumberID do pipeline da negociação. Opcional, validado conforme empresa.
ratingnumber (0 a 5)Avaliação da negociação. Opcional.
productsarray de objetosLista de produtos associados com productId, quantity e preço opcional.
customfieldsarray de objetosCampos personalizados associados, com customfieldId e value.
expectClosingDatedate (dd/MM/yyyy)Data esperada para fechamento da negociação. Opcional.
lostDatedatetime (yyyy-MM-dd HH:mm:ss)Data em que a negociação foi perdida. Opcional.
lostReasonIdnumberMotivo da perda, obrigatório se status for lost.
winDatedatetime (yyyy-MM-dd HH:mm:ss)Data em que a negociação foi ganha. Opcional.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.cubosuite.com.br/deals' \
--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
{
  "id": 0,
  "title": "string",
  "price": "string",
  "userId": 0,
  "peopleName": "string",
  "peoplePhone": "string",
  "organizationName": "string",
  "stageId": 0,
  "pipeId": 0,
  "rating": 0,
  "products": [
    {
      "productId": 0,
      "quantity": 0,
      "price": "string"
    }
  ],
  "customfields": [
    {
      "customfieldId": 0,
      "value": "string"
    }
  ],
  "createdAt": "string",
  "updatedAt": "string"
}

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros Header
Content-Type
string 
opcional
Exemplo:
application/json
Parâmetros Bodyapplication/json
title
string 
requerido
status
string 
opcional
price
number 
opcional
userId
integer 
opcional
peopleId
integer 
opcional
peopleName
string 
requerido
peoplePhone
string 
opcional
organizationName
string 
opcional
pipeId
integer 
requerido
stageId
integer 
opcional
rating
integer 
opcional
products
array [object {3}] 
opcional
productId
integer 
requerido
quantity
integer 
requerido
price
integer 
opcional
customfields
array [object {2}] 
opcional
customfieldId
integer 
requerido
value
string 
requerido
expectClosingDate
string 
opcional
Examples

Respostas

🟢200OK
application/json
Body
id
integer 
requerido
title
string 
requerido
price
string 
requerido
userId
integer 
requerido
peopleName
string 
requerido
peoplePhone
string 
requerido
organizationName
string 
requerido
stageId
integer 
requerido
pipeId
integer 
requerido
rating
integer 
requerido
products
array [object {3}] 
requerido
productId
integer 
opcional
quantity
integer 
opcional
price
string 
opcional
customfields
array [object {2}] 
requerido
customfieldId
integer 
opcional
value
string 
opcional
createdAt
string 
requerido
updatedAt
string 
requerido
🟠401Não autorizado
Modificado em 2025-06-16 14:44:59
Página anterior
Listar todos os negócios
Próxima página
Obter negócio por ID
Built with