Mover oportunidade de etapa | WBudget

Move a oportunidade para outra etapa do funil.

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

Consulte GET /status/{id}/form para conhecer os campos e atividades da etapa antes da movimentação. A movimentação respeita a sequência permitida, a aprovação e as atividades obrigatórias da etapa. A consulta do formulário não substitui o preenchimento dessas exigências.

Parâmetros de caminho

Campo	Tipo	Obrigatório	Descrição
`id`	integer	Sim	ID da oportunidade.

Corpo da requisição

Campo	Tipo	Obrigatório	Descrição
`status`	integer	Sim	ID da etapa de destino.
`options`	object	Não	Opções da movimentação. create_activities=1 cria as atividades previstas para a etapa; padrão 0.
`options.create_activities`	integer	Não	1 cria as atividades configuradas para a etapa; 0 não cria automaticamente (padrão).

Exemplo de JSON enviado

{
  "status": 20,
  "options": {
    "create_activities": 0
  }
}

Resposta

HTTP 200. 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 do recurso.
`status`	integer	ID da etapa.

{
  "data": {
    "id": 1001,
    "status": 20
  }
}

Erros específicos

HTTP	Código	Situação
422	`VALIDATION_FAILED`	The status field is required.

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

Move a oportunidade para outra etapa do funil. **Autenticação:** Bearer Token da API WBudget. O acesso aos dados respeita as permissões do usuário. Consulte GET /status/{id}/form para conhecer os campos e atividades da etapa antes da movimentação. A movimentação respeita a sequência permitida, a aprovação e as atividades obrigatórias da etapa. A consulta do formulário não substitui o preenchimento dessas exigências. ### Parâmetros de caminho | Campo | Tipo | Obrigatório | Descrição | |---|---|---|---| | `id` | integer | Sim | ID da oportunidade. | ### Corpo da requisição | Campo | Tipo | Obrigatório | Descrição | |---|---|---|---| | `status` | integer | Sim | ID da etapa de destino. | | `options` | object | Não | Opções da movimentação. create_activities=1 cria as atividades previstas para a etapa; padrão 0. | | `options.create_activities` | integer | Não | 1 cria as atividades configuradas para a etapa; 0 não cria automaticamente (padrão). | ### Exemplo de JSON enviado ```json { "status": 20, "options": { "create_activities": 0 } } ``` ### Resposta HTTP **200**. 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 do recurso. | | `status` | integer | ID da etapa. | ```json { "data": { "id": 1001, "status": 20 } } ``` ### Erros específicos | HTTP | Código | Situação | |---|---|---| | 422 | `VALIDATION_FAILED` | The status field is required. | 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.

Path parameters

idstringRequired

ID da oportunidade.

Request

This endpoint expects an object.

statusintegerRequired

optionsobjectRequired

Response

dataobject

Errors

422

Unprocessable Entity Error