Senior ERP - Cliente Upsert

Quando aplicar

• "criar cliente" / "cadastrar cliente" / "cadastro de cliente"
• "atualizar dados do cliente" / "alterar cadastro"
• "upsert cliente" (criar se nao existe, atualizar se existe)
• "integrar clientes do e-commerce/CRM para o Senior"

Contrato de integracao (agnostico de linguagem)

Leia references/REFERENCE.md para a referencia base (autenticacao, headers, seguranca, resiliencia, idempotencia).

Passos

1. Confirmar o objetivo e o escopo do cadastro
   • PJ vs PF, campos obrigatorios, regra de negocio (ex.: cliente ativo/inativo, tipo de contribuinte).
   • Confirmar quais identificadores devem ser usados para deduplicacao (ex.: CNPJ/CPF + filial/empresa, ou codigo externo).