Skip to navigation

Criar oportunidade

Cria uma oportunidade usando clientes, produtos e modelos já cadastrados.

Autenticação: Bearer Token da API WBudget. O acesso aos dados respeita as permissões do usuário.

Os campos são opcionais. Valores omitidos seguem as configurações da conta. Substitua os IDs ilustrativos por registros da sua conta.

Corpo da requisição

CampoTipoObrigatórioDescrição
namestringNãoTítulo da oportunidade.
modelintegerNãoID obtido em GET /models.
statusintegerNãoID de uma etapa do funil.
companyintegerNãoID obtido em GET /companies.
clientintegerNãoID obtido em GET /clients.
itemsarray<integer>NãoIDs de produtos ou serviços obtidos em GET /items. Não são objetos de item.

Exemplo de JSON enviado

{
"name": "Proposta de serviços",
"model": 1,
"status": 10,
"company": 1,
"client": 101,
"items": [
501
]
}

Resposta

HTTP 201. Os exemplos usam dados fictícios e mostram os campos principais; outros campos podem acompanhar a resposta. Campos sem valor podem ser nulos.

Campos principais de data:

CampoTipoDescrição
idintegerID criado.
statusintegerID da etapa inicial.
{
"data": {
"id": 1001,
"status": 10
}
}

Consulte a introdução da collection para o formato de erros e a configuração das variáveis.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
clientdoubleOptional
companydoubleOptional
itemslist of doublesOptional
modeldoubleOptional
namestringOptional
statusdoubleOptional

Response

201 — Sucesso — exemplo ilustrativo

dataobjectOptional