Skip to navigation

Atualizar produto ou serviço

Atualiza parcialmente um produto ou serviço.

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

Requer permissão de edição do cadastro de produtos. Campos omitidos são preservados, inclusive a unidade ao alterar type. Envie pelo menos um campo documentado. Zero e false são valores válidos. Null remove category, description, tag, sku e pn; em metadata, null preserva o objeto. Name, type, unit, active e campos numéricos não aceitam null. Esta operação altera o cadastro do produto; para editar uma linha de proposta, use PUT /budgets/:id/items/:itemId.

Parâmetros de caminho

CampoTipoObrigatórioDescrição
idintegerSimID do produto ou serviço.

Corpo da requisição

CampoTipoObrigatórioDescrição
namestringNãoNome, entre 1 e 150 caracteres.
typestringNãoproduct ou service. Padrão product.
categoryinteger ou nullNãoID de categoria existente. Null remove a categoria; omitido na criação usa o padrão da conta.
valuenumberNãoPreço unitário entre 0 e 99999999.9999. Padrão 0.
qtynumberNãoQuantidade entre 0 e 99999999.9999. Padrão 1; arredondada conforme a unidade.
unitstringNãoUnidade cadastrada (até 8 caracteres). Na criação: un para produto e hour para serviço.
descriptionstring ou nullNãoDescrição do produto ou serviço.
activeboolean ou integerNãotrue/false ou 1/0. Padrão true. Itens inativos deixam de aparecer em GET /items.
costnumberNãoCusto não negativo, máximo 99999999.9999. Padrão 0; a consulta respeita as permissões do usuário.
taxnumberNãoTributo não negativo, máximo 999999.999999. Padrão 0, conforme configuração comercial da conta.
skustring ou nullNãoCódigo SKU único, até 45 caracteres. Null ou texto vazio remove o código.
pnstring ou nullNãoCódigo do fabricante único, até 45 caracteres. Null ou texto vazio remove o código.
tagstring ou nullNãoEtiquetas do item.
metadataobject ou nullNãoCampos personalizados. Chaves enviadas são mescladas; uma chave com null é removida. O objeto omitido ou null preserva os valores atuais.

Exemplo de JSON enviado

{
"value": 175,
"active": false,
"metadata": {
"referencia": "ERP-501",
"observacao": null
}
}

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 produto ou serviço.
namestringNome, entre 1 e 150 caracteres.
typestringproduct ou service. Padrão product.
categoryinteger ou nullID de categoria existente. Null remove a categoria; omitido na criação usa o padrão da conta.
valuenumberPreço unitário entre 0 e 99999999.9999. Padrão 0.
qtynumberQuantidade entre 0 e 99999999.9999. Padrão 1; arredondada conforme a unidade.
unitstringUnidade cadastrada (até 8 caracteres). Na criação: un para produto e hour para serviço.
descriptionstring ou nullDescrição do produto ou serviço.
activeboolean ou integertrue/false ou 1/0. Padrão true. Itens inativos deixam de aparecer em GET /items.
costnumberCusto não negativo, máximo 99999999.9999. Padrão 0; a consulta respeita as permissões do usuário.
taxnumberTributo não negativo, máximo 999999.999999. Padrão 0, conforme configuração comercial da conta.
skustring ou nullCódigo SKU único, até 45 caracteres. Null ou texto vazio remove o código.
pnstring ou nullCódigo do fabricante único, até 45 caracteres. Null ou texto vazio remove o código.
tagstring ou nullEtiquetas do item.
metadataobject ou nullCampos personalizados. Chaves enviadas são mescladas; uma chave com null é removida. O objeto omitido ou null preserva os valores atuais.
category_namestring ou nullNome da categoria.
create_datestringData de criação.
{
"data": {
"id": 501,
"name": "Consultoria",
"type": "service",
"category": null,
"category_name": null,
"value": 175,
"qty": 1,
"unit": "hour",
"description": "Consultoria por hora",
"active": false,
"cost": 0,
"tax": 0,
"sku": "SERV-501",
"pn": null,
"tag": "consultoria",
"metadata": {
"referencia": "ERP-501"
},
"create_date": "2026-09-06T10:00:00-03:00"
}
}

Erros específicos

HTTPCódigoSituação
404ITEM_NOT_FOUNDItem not found.
422VALIDATION_FAILEDInvalid field: name.
409ITEM_ALREADY_EXISTSSKU or part number already exists.
400NOTHING_TO_UPDATENo supported fields to update.

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 do produto ou serviço.

Request

This endpoint expects an object.
activebooleanOptional
metadataobjectOptional
valuedoubleOptional

Response

200 — Sucesso — exemplo ilustrativo

dataobjectOptional

Errors

400
Bad Request Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error