Fornecedores

📄️Lista fornecedores e transportadoras

Retorna o catálogo de fornecedores (e transportadoras — compartilham o mesmo cadastro) da empresa autenticada. Apenas cadastros ativos (`SupplierStatus=1`) entram na resposta. Aceita filtros por categoria, tipo de fornecedor, CPF/CNPJ, sinal de leilão de frete e nome; aceita ainda uma busca textual genérica (`Search`) que cruza nome, e-mail, CPF/CNPJ e id.

📄️Cadastra um fornecedor

Cria um novo fornecedor (ou transportadora — depende da categoria informada). Quando `SupplierCpfCnpj` for um CNPJ válido, o handler tenta consultar `publica.cnpj.ws` e **sobrescreve automaticamente** os campos de endereço, telefone, e-mail, razão social, nome fantasia, inscrição estadual e data de início de atividade a partir da Receita — qualquer valor enviado no corpo para esses campos é ignorado (a consulta tem timeout de 5 s; em caso de falha, o handler cai de volta para os valores do corpo).

📄️Detalha um fornecedor ou transportadora

Retorna o cadastro completo de um fornecedor. O mesmo cadastro também é usado para transportadoras — os campos com prefixo `Carrier*` ficam preenchidos apenas quando o fornecedor opera como transportadora.

📄️Atualiza um fornecedor

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:

📄️Exclui (inativa) um fornecedor

Marca o fornecedor como inativo e limpa os vínculos com integração (`IDCompanyIntegration`) e leilão de frete (`CarrierAuction`). Não há exclusão física do registro: o `SupplierStatus` passa para **0** quando o fornecedor nunca teve título a pagar/receber, ou para **2** quando já existe pelo menos um título vinculado — isso preserva o histórico financeiro mas remove o fornecedor das listas ativas.

📄️Define o rateio padrão de centros de custo do fornecedor

Substitui (apaga e regrava) o rateio padrão de centros de custo aplicado nos títulos gerados a partir deste fornecedor. O corpo é um **array** de pares `IDTypeCostCenter` + `ValueRatio`, onde a soma de `ValueRatio` precisa fechar em **1** (100%). Quando o array é vazio (`[]`), o rateio padrão é removido. Todos os centros de custo precisam existir na empresa.

📄️Sobe ou troca o logotipo do fornecedor

Aceita duas formas de envio do logotipo:

🗃Contatos

3 itens