Cria um novo cliente ou atualiza um existente com base no endereço de e-mail.

POST /api/customer/createorupdate

Este endpoint fornece funcionalidade de upsert usando o e-mail como identificador único.

Se já existir um cliente com o e-mail fornecido, ele será atualizado e retornado.
Se não existir nenhum cliente com esse e-mail, um novo cliente será criado após validar a exclusividade do e-mail e do tipo+número de documento.

Regras de validação:

O e-mail é obrigatório e é usado como chave de busca primária
Se Id ou GlobalId forem fornecidos (diferentes de zero/não vazios), a requisição será rejeitada com 400 - use o endpoint UpdateCustomer em vez disso
Para novos clientes: valida que a combinação de e-mail e tipo+número de documento ainda não exista
Para atualizações: se o tipo ou número de documento mudar, valida que a nova combinação não esteja sendo usada por outro cliente (requer permissões)

Request

Cliente criado ou atualizado com sucesso