Cadastra um fornecedor
POST/supplier
Cria um novo fornecedor (ou transportadora — depende da categoria informada). Quando SupplierCpfCnpj é informado, o sistema tenta consultar a base pública de CNPJ (publica.cnpj.ws) com timeout de 5 s. Se a consulta retornar com sucesso (típico para CNPJ válido), os campos de endereço, telefone, e-mail, razão social, nome fantasia, inscrição estadual e data de início de atividade são sobrescritos com os dados da Receita — qualquer valor enviado no corpo para esses campos é ignorado. Em caso de falha (CPF, CNPJ inexistente, timeout, indisponibilidade do serviço externo), o sistema cai de volta para os valores do corpo.
SupplierCpfCnpj aceita CNPJ alfanumérico (válido a partir de 2026): o valor é convertido para maiúsculas e as letras são preservadas como parte do documento. Quando o valor é apenas numérico, ficam apenas os dígitos. Em ambos os casos o documento é completado com zeros à esquerda até 11 caracteres (CPF) ou 14 (CNPJ).
Quando a parametrização Bloquear cadastro duplicado de fornecedor (BlockDuplicateSupplier, grupo Fornecedor) está ativada, o sistema bloqueia o cadastro se já existir outro fornecedor ativo com o mesmo CPF/CNPJ.
Os parâmetros de transportadora IDCarrierGateway e IDCarrierType são aceitos no corpo mas não são gravados na criação — defina-os depois, em PUT /supplier/{idsupplier}.
A resposta é o detalhe completo do fornecedor recém-criado (mesmo formato de GET /supplier/{idsupplier}).
Request
Responses
- 200
- 400
- 500
Fornecedor criado. Retorna o cadastro completo.
Erros de validação (prefixo [BadRequest]):
Já existe um fornecedor com esse CPF/CNPJ(quandoBlockDuplicateSupplier=1)Categoria fornecedor não existeEmpresa não existe
Erro interno (prefixo Error:).