API consulta carrinho abandonado?

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 - v1Data 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:

  1. 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).
  1. 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.
  1. 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.

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.

2 Likes