API consulta carrinho abandonado?

[jgoliveira]

Existe alguma API para consultar os carrinhos abandonados de uma loja?

[estevao_santos]

Oi @jgoliveira tudo certo?

Não existe API para tal. Mas você consegue consultar o MasterData e trazer os dados do carrinho abandonado a partir do parâmetro rclastcart.

Veja alguns comentários sobre isso na comunidade:

Existe alguma API para integrar os carrinhos abandonados para o ERP?

Bom dia, Patricia Eu desenvolvi uma integração do ERP da empresa com a VTEX, e para obter essa informação utilizei a API do MasterData v2, basicamente, eu consulto o documento dentro da entidade de clientes e lá eu pego o retorno do carrinho abandonado e do valor do carrinho. Após isso, com o retorno do carrinho, que vem informando as SKU’s e as quantidades, eu trato a resposta e envio isso no ERP como a equipe comercial deseja. Em resumo: Pego os dados do cliente e do carrinho via API do Ma…

Ou seja, você não tem uma API específica, mas consegue usar a do MasterData para fazer isso.

Documentação para consulta Master Data V2 para VTEX IO: Master Data API - v2

Espero que estas informações possa te ajudar.

Abs,
Estevão.

[jgoliveira]

Olá @estevao_santos, Bom dia!

Tudo certo e vc?
Obrigado pela ajuda!

Preciso orientar meu cliente a como pegar o nome da entidade de clientes e também a como dar permissão de acesso aos dados do MasterData V2.
Ele já me passou um API-Key e Token que funcionam para Orders por exemplo, mas retorna 403 Forbidden na Master Data.

Existe algum topico ou doc explicando um pouco sobre essa parte?

Obrigado Novamente!

[estevao_santos]

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:

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

2. 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.

3. 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.