Introdução¶
O que é¶
O Portfólio é responsável pela gestão das informações relacionadas aos SKUs que integram um portfólio, além disso é possível realizar gereciamentos simples dos preços e estoques que compõem um SKU.
Como funciona¶
A estrutura do Portfólio é dividida em 3 modelos:
- SKU: representação dos produtos dentro de um portfólio.
- Inventory: quantidade de produtos disponíveis para a venda.
- Price: gestão de preços de um produto.
O processo mais comum para uso do Portfólio é o seguinte:
- 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 permitem especificar exatamente que tipo de acesso sua aplicação irá solicitar ao cliente. Dado que o Portfólio é o sistema que faz a gestão do portfólio dos clientes, existem os seguintes escopos:
open:portfolio:read
- Permitirá o acesso de leitura a todos os recursos.open:portfolio:write
- Permitirá o acesso de escrita a todos os recursos.
Casos de uso¶
- Sou uma integradora e quero me integrar a um Marketplace que utiliza o Portfólio:
- Crie uma aplicação;
- Consulte o Tenant ID do 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;
- Sou um vendedor, tenho um time de desenvolvimento e quero me integrar a um Marketplace que utiliza o Portfólio:
- Crie uma aplicação utilizando meu cliente ID de seller.
- Consulte todos os seus SKUs cadastradas 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;
- Quero vender produtos que estão no catálogo, utilizando o meu estoque. (Em breve com o Catalog).