Conta do cliente
Perfil, documentos, endereços, campos extras e privacidade do cliente logado.
A conta do cliente reúne o que pertence à pessoa, e não a um pedido: o perfil e os documentos (CPF ou CNPJ), a senha e o e-mail de login, o caderno de endereços, os campos extras de cadastro que a loja define e a escolha de receber (ou não) recomendações personalizadas. Tudo é chamado com o token do próprio cliente, e cada cliente só enxerga e altera a sua conta.
Como funciona
CPF, CNPJ e o tipo de pessoa
No Brasil, quem compra é pessoa física (CPF, 11 dígitos) ou jurídica (CNPJ, 14 dígitos). A conta guarda isso em person_type: F ou J. Uma conta jurídica mantém o CNPJ da empresa e, separado, o CPF do responsável (responsible_cpf). Em lojas B2B, vários usuários do mesmo CNPJ formam uma conta corporativa e enxergam os pedidos uns dos outros (Meus pedidos).
| Regra do documento | Detalhe |
|---|---|
| Formato | Com ou sem máscara (123.456.789-09 ou 12345678909). A plataforma valida os dígitos verificadores e grava só os números. |
| Trocar o documento | O cliente não troca um documento que a conta já tem (403 document_locked: "fale com a loja"). Preencher quando está vazio, ou reenviar o mesmo valor, é aceito. |
| Duplicidade | O mesmo CPF em duas contas é recusado (409 cpf_already_registered). |
| Trocar de física para jurídica | Pelo campo person_type do perfil, se a loja aceitar o tipo (403 person_type_not_accepted caso contrário). |
Endereços: caderno e pedido
O caderno de endereços (Endereços) é a lista salva do cliente. Ao fechar um pedido, o endereço escolhido é copiado para dentro do pedido: editar ou apagar o endereço depois não altera pedidos antigos.
Campos extras de cadastro
Além dos campos fixos (nome, telefone, CPF), a loja pode definir campos extras (inscrição estadual, ramo de atividade, anexos...) que aparecem no cadastro e no perfil. A lista dos campos é pública e os valores do cliente ficam em Campos do perfil.
Endpoints
| Método e caminho | Para quê | Autenticação | Página |
|---|---|---|---|
GET /api/v1/storefront/profile | Lê o perfil | cliente | Perfil |
PUT /api/v1/storefront/profile | Altera nome, telefone, documentos e preferências | cliente | Perfil |
POST /api/v1/storefront/profile/avatar | Envia a foto de perfil | cliente | Perfil |
POST /api/v1/storefront/profile/password | Troca a senha | cliente | Senha e e-mail |
POST /api/v1/storefront/profile/email | Troca o e-mail de login | cliente | Senha e e-mail |
GET /api/v1/storefront/addresses | Lista os endereços | cliente | Endereços |
POST /api/v1/storefront/addresses | Cria um endereço | cliente | Endereços |
PUT /api/v1/storefront/addresses/{id} | Altera um endereço | cliente | Endereços |
DELETE /api/v1/storefront/addresses/{id} | Apaga um endereço | cliente | Endereços |
GET /api/v1/storefront/profile/fields | Campos extras definidos pela loja | pública | Campos do perfil |
GET /api/v1/storefront/profile/field-values | Valores do cliente | cliente | Campos do perfil |
PUT /api/v1/storefront/profile/field-values | Grava os valores | cliente | Campos do perfil |
GET /api/v1/storefront/account/personalization | Vê o que a loja aprendeu | cliente | Personalização |
POST /api/v1/storefront/account/personalization/optout | Desliga a personalização | cliente | Personalização |
POST /api/v1/storefront/account/personalization/optin | Liga a personalização | cliente | Personalização |
DELETE /api/v1/storefront/account/personalization | Apaga o perfil aprendido | cliente | Personalização |
Pedidos, devoluções e contestações do cliente estão em Pedidos e conta do cliente e Devoluções e contestações.