Oi @jgoliveira Bom dia. Tudo certo. Por nada.
1. Como Obter o Nome da Entidade de Clientes
O nome da entidade de clientes no Master Data geralmente é chamado de Clientes ou Costumer
. CL é o acrônimo. A entidade CL
armazena as informações relacionadas aos clientes.
Seu cliente pode verificar as entidades disponíveis diretamente no Master Data usando a seguinte chamada, porém ela é mais usada para a versão V1. Testa para ver se funciona na V2:
Endpoint:
GET https://{{accountName}}.vtexcommercestable.com.br/api/dataentities
Essa chamada listará todas as entidades de dados disponíveis, incluindo a de clientes (geralmente CL
). Se ele quiser verificar diretamente os dados de clientes, ele pode fazer uma chamada para a entidade CL
(caso não tenha sido alterada).
Documentação: Master Data API - v1 › Data Entities
2. Garantir Permissões de Acesso ao Master Data V2
O erro 403 Forbidden indica que o token ou a API Key utilizada não tem permissão para acessar os dados do Master Data. Para resolver isso, é necessário garantir que as permissões corretas sejam configuradas para a API Key no Admin VTEX.
Passos para Configurar Permissões de Acesso:
- Acesse o Admin VTEX:
- O cliente (ou a pessoa responsável pelas permissões) deve acessar o painel administrativo da VTEX (
{{accountName}}.myvtex.com/admin
).
- Verifique o Permissionamento da API Key:
- No Admin, vá para o menu Configurações da Conta > Chaves de Aplicação.
- Localize a API Key que foi gerada e clique em Edit para ajustar as permissões.
- Adicionar Permissões de Acesso ao Master Data:
- Nas permissões da API Key, verifique se há permissão de acesso ao Master Data. As permissões precisam incluir o seguinte escopo:
- Data Entity: Permitir acesso à entidade
CL
para leitura e escrita de dados (dependendo do que é necessário). - Document: Permitir acesso para realizar operações de CRUD (Create, Read, Update, Delete) nos documentos dentro da entidade.
- Permission Group: Verifique se o grupo de permissões ao qual a API Key está vinculada tem acesso ao
Master Data
.
- Data Entity: Permitir acesso à entidade
Documentação: Permissions
Any user or application key must have at least one of the appropriate License Manager resources to be able to successfully run this request. Otherwise they will receive a status code 403
error.
Se te ajudou, marque-a como “Solução”.
Sigo à disposição.
Abs,
Estevão.