Atualiza um fornecedor
PUT/supplier/:idsupplier
Atualiza parcialmente o cadastro do fornecedor — apenas os campos enviados no corpo são alterados. As validações disparam quando os campos correspondentes vêm preenchidos:
- Se
SupplierCpfCnpjmudar e a parametrização Bloquear cadastro duplicado de fornecedor estiver ativa, o sistema bloqueia o salvamento quando já existe outro fornecedor ativo com o mesmo documento. O campo aceita CNPJ alfanumérico (válido a partir de 2026): o valor é convertido para maiúsculas, as letras são preservadas como parte do documento e o resultado é completado com zeros à esquerda até 11 caracteres (CPF) ou 14 (CNPJ). - Se
IDSupplierCategoryfor informado, a categoria precisa pertencer à empresa autenticada. - Se
IDTypeAccountPayableReceivablefor informado, o plano de contas precisa existir na empresa. - Se
IDCompanyLabelmudar, o template de etiqueta precisa pertencer à empresa autenticada ou à empresa-padrão de etiquetas (id 54) e ser do tipo etiqueta de transportadora. - Se
CarrierAuction=1e o fornecedor ainda não tinhaCarrierQuotationExternalId, o sistema atribui um id sequencial dentro da empresa.
Sempre que o cadastro muda para/de transportadora, a lista de transportadoras de leilão de frete é regravada.
Atenção: SupplierBirthDate é a única exceção à atualização parcial — o campo é gravado em toda chamada, então omiti-lo, ou enviá-lo vazio, apaga a data já cadastrada. Reenvie o valor atual sempre que salvar.
A resposta é o detalhe completo do fornecedor atualizado.
Request
Responses
- 200
- 400
- 500
Fornecedor atualizado.
Erros de validação (prefixo [BadRequest]):
Fornecedor não existeCategoria fornecedor não existeJá existe um fornecedor com esse CPF/CNPJPlano de contas não existeEtiqueta não existe
Erro interno (prefixo Error:).