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 SupplierCpfCnpj mudar 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 IDSupplierCategory for informado, a categoria precisa pertencer à empresa autenticada.
• Se IDTypeAccountPayableReceivable for informado, o plano de contas precisa existir na empresa.
• Se o pai (IDSupplierFather) ou o tipo do fornecedor (pela categoria) mudar, o vínculo de filiais é conferido: o pai precisa ser um fornecedor ativo da mesma empresa, do mesmo tipo, que não seja filho de outro nem o próprio fornecedor; um fornecedor com filhos ativos não pode ganhar pai e não pode mudar para um tipo diferente do dos filhos. Editar outros campos de um filho, sem mudar o pai nem o tipo, não refaz essa conferência.
• Se IDCompanyLabel mudar, 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=1 e o fornecedor ainda não tinha CarrierQuotationExternalId, 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

Fornecedor atualizado.

400

Erros de validação (prefixo [BadRequest]):

• Fornecedor não existe
• Categoria fornecedor não existe
• Já existe um fornecedor com esse CPF/CNPJ
• Plano de contas não existe
• Fornecedor tem filhos e não pode ser vinculado a um pai
• Fornecedor tem filhos de outro tipo de fornecedor (a nova categoria muda o tipo, e há filhos ativos de outro tipo)
• Fornecedor não pode ser pai dele mesmo
• Fornecedor pai não existe (não é um fornecedor ativo da mesma empresa)
• Fornecedor pai já é filho de outro fornecedor
• Fornecedor pai precisa ser do mesmo tipo do fornecedor
• Etiqueta não existe

500

Erro interno (prefixo Error:).