Atualizar oportunidade | WBudget

Atualiza os dados comerciais de uma oportunidade.

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

Envie ao menos um campo editável. Nos campos comerciais, valores omitidos, nulos ou vazios preservam o valor atual. Use PATCH /budgets/{id}/status para alterar a etapa. Esta referência apresenta os campos destinados às integrações comerciais.

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
`name`	string	Não	Título.
`code`	string	Não	Código comercial.
`company`	integer	Não	ID de empresa emissora.
`client`	integer	Não	ID de cliente.
`client_contact`	integer	Não	ID de contato do cliente.
`payment`	integer	Não	ID de condição de pagamento.
`model`	integer	Não	ID de modelo de documento.
`budget_company_sponsor`	string	Não	Contato da empresa emissora.
`budget_client_sponsor`	string	Não	Contato do cliente na proposta.
`create_date`	string	Não	Data no formato YYYY-MM-DD.
`expiration_date`	string	Não	Data no formato YYYY-MM-DD.
`payment_date`	string	Não	Data no formato YYYY-MM-DD.
`approval_date`	string	Não	Data no formato YYYY-MM-DD.
`description`	string	Não	Descrição da proposta.
`metadata`	object	Não	Campos personalizados.
`currency`	string	Não	Código da moeda, por exemplo BRL.
`currency_rate`	number	Não	Taxa de conversão.
`tag`	string	Não	Etiqueta.
`sign`	string	Não	Identificador de assinatura.
`followers`	array<integer>	Não	IDs dos usuários que acompanham a proposta.

Exemplo de JSON enviado

{
  "name": "Proposta de implantação revisada",
  "expiration_date": "2026-10-15",
  "description": "Implantação e treinamento."
}

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.

{
  "data": {
    "id": 1001
  }
}

Erros específicos

HTTP	Código	Situação
400	`NOTHING_TO_UPDATE`	No updatable field sent.

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

Atualiza os dados comerciais de uma oportunidade. **Autenticação:** Bearer Token da API WBudget. O acesso aos dados respeita as permissões do usuário. Envie ao menos um campo editável. Nos campos comerciais, valores omitidos, nulos ou vazios preservam o valor atual. Use PATCH /budgets/{id}/status para alterar a etapa. Esta referência apresenta os campos destinados às integrações comerciais. ### 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 | |---|---|---|---| | `name` | string | Não | Título. | | `code` | string | Não | Código comercial. | | `company` | integer | Não | ID de empresa emissora. | | `client` | integer | Não | ID de cliente. | | `client_contact` | integer | Não | ID de contato do cliente. | | `payment` | integer | Não | ID de condição de pagamento. | | `model` | integer | Não | ID de modelo de documento. | | `budget_company_sponsor` | string | Não | Contato da empresa emissora. | | `budget_client_sponsor` | string | Não | Contato do cliente na proposta. | | `create_date` | string | Não | Data no formato YYYY-MM-DD. | | `expiration_date` | string | Não | Data no formato YYYY-MM-DD. | | `payment_date` | string | Não | Data no formato YYYY-MM-DD. | | `approval_date` | string | Não | Data no formato YYYY-MM-DD. | | `description` | string | Não | Descrição da proposta. | | `metadata` | object | Não | Campos personalizados. | | `currency` | string | Não | Código da moeda, por exemplo BRL. | | `currency_rate` | number | Não | Taxa de conversão. | | `tag` | string | Não | Etiqueta. | | `sign` | string | Não | Identificador de assinatura. | | `followers` | array<integer> | Não | IDs dos usuários que acompanham a proposta. | ### Exemplo de JSON enviado ```json { "name": "Proposta de implantação revisada", "expiration_date": "2026-10-15", "description": "Implantação e treinamento." } ``` ### 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. | ```json { "data": { "id": 1001 } } ``` ### Erros específicos | HTTP | Código | Situação | |---|---|---| | 400 | `NOTHING_TO_UPDATE` | No updatable field sent. | 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.

namestringRequired

expiration_datedateRequired

descriptionstringRequired

Response

dataobject

Errors

400

Bad Request Error