Visão geral
O que é
As APIs de produtos do Grupo Eu Preciso foram desenvolvidas para facilitar a gestão dos componentes que compõem um produto. Os produtos inseridos no marketplace do Eu Preciso são gerenciados por meio de Portfólios, que centralizam as informações dos SKUs (Unidades de Manutenção de Estoque) associados a um portfólio. Além disso, permitem realizar ajustes simples de preços e estoques de cada SKU.
Como funciona
A estrutura do Portfólio é composta por três elementos principais:
- SKU: representação dos produtos dentro de um portfólio.
- Inventory: controle da quantidade de produtos disponíveis para venda..
- Price: gerenciamento dos preços de um produto.
O fluxo básico de uso do Portfólio envolve:
- Criar SKU utilizando o serviço SKU.
- Vincular um inventário a um SKU utilizando o serviço Inventory.
- Vincular um preço a um SKU utilizando o serviço Price.
Considerações sobre escopos
Os escopos definem o nível de acesso que sua aplicação solicitará ao cliente. No caso do Portfólio, existem os seguintes escopos:
portfolio:read- Permitirá o acesso de leitura a todos os recursos.portfolio:write- Permitirá o acesso de escrita a todos os recursos.
Casos de uso
Atualmente, a integração com o Marketplace do Eu Preciso só pode ser realizada por meio de um integrador. Se você é um integrador, siga os passos abaixo:
- Registre sua aplicação, fornecendo os dados necessários, conforme explicado na seção Registro da Aplicação;
- Siga as etapas de autenticação até obter um token de acesso para seu cliente;
- Consulte todos os SKUs cadastradas do cliente através dos endpoints disponíveis no modelo SKU;
- Para gerenciamento de estoque de um SKU utilize o modelo Inventory;
- Para gerenciamento do preço de um SKU utilize o modelo Price.