Ir para o conteúdo

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.

Imagem da estrutura do Portfólio

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:

  1. Criar SKU utilizando o serviço SKU.
  2. Vincular um inventário a um SKU utilizando o serviço Inventory.
  3. 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

  1. 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;
  2. 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;
  3. Quero vender produtos que estão no catálogo, utilizando o meu estoque. (Em breve com o Catalog).