Criar oportunidade | WBudget

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

Campo	Tipo	Obrigatório	Descrição
`name`	string	Não	Título da oportunidade.
`model`	integer	Não	ID obtido em GET /models.
`status`	integer	Não	ID de uma etapa do funil.
`company`	integer	Não	ID obtido em GET /companies.
`client`	integer	Não	ID obtido em GET /clients.
`items`	array<integer>	Não	IDs 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:

Campo	Tipo	Descrição
`id`	integer	ID criado.
`status`	integer	ID 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.

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 | Campo | Tipo | Obrigatório | Descrição | |---|---|---|---| | `name` | string | Não | Título da oportunidade. | | `model` | integer | Não | ID obtido em GET /models. | | `status` | integer | Não | ID de uma etapa do funil. | | `company` | integer | Não | ID obtido em GET /companies. | | `client` | integer | Não | ID obtido em GET /clients. | | `items` | array<integer> | Não | IDs de produtos ou serviços obtidos em GET /items. Não são objetos de item. | ### Exemplo de JSON enviado ```json { "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`: | Campo | Tipo | Descrição | |---|---|---| | `id` | integer | ID criado. | | `status` | integer | ID da etapa inicial. | ```json { "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.

namestringRequired

modelintegerRequired

statusintegerRequired

companyintegerRequired

clientintegerRequired

itemslist of integersRequired

Response

Created

dataobject