Skip to navigation

Atualizar oportunidade

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

CampoTipoObrigatórioDescrição
idintegerSimID da oportunidade.

Corpo da requisição

CampoTipoObrigatórioDescrição
namestringNãoTítulo.
codestringNãoCódigo comercial.
companyintegerNãoID de empresa emissora.
clientintegerNãoID de cliente.
client_contactintegerNãoID de contato do cliente.
paymentintegerNãoID de condição de pagamento.
modelintegerNãoID de modelo de documento.
budget_company_sponsorstringNãoContato da empresa emissora.
budget_client_sponsorstringNãoContato do cliente na proposta.
create_datestringNãoData no formato YYYY-MM-DD.
expiration_datestringNãoData no formato YYYY-MM-DD.
payment_datestringNãoData no formato YYYY-MM-DD.
approval_datestringNãoData no formato YYYY-MM-DD.
descriptionstringNãoDescrição da proposta.
metadataobjectNãoCampos personalizados.
currencystringNãoCódigo da moeda, por exemplo BRL.
currency_ratenumberNãoTaxa de conversão.
tagstringNãoEtiqueta.
signstringNãoIdentificador de assinatura.
followersarray<integer>NãoIDs 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:

CampoTipoDescrição
idintegerID do recurso.
{
"data": {
"id": 1001
}
}

Erros específicos

HTTPCódigoSituação
400NOTHING_TO_UPDATENo 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.
descriptionstringOptional
expiration_datestringOptional
namestringOptional

Response

200 — Sucesso — exemplo ilustrativo

dataobjectOptional

Errors

400
Bad Request Error