# Obter item vendável por SKU Obtém um item vendável por SKU para criar um catálogo. Nota Esta chamada de API retorna dados genéricos do catálogo de itens quando usada sem autorização. Use a autorização para recuperar dados personalizados do usuário, como limites e promoções associadas ao item. Para fazer isso, passe o JWT do usuário no cabeçalho Authorization. Para mais informações sobre o JWT do usuário, consulte o bloco Segurança para esta chamada. Endpoint: GET /v2/project/{project_id}/items/sku/{sku} Version: 2.0.0 Security: XsollaLoginUserJWT ## Path parameters: - `project_id` (integer, required) ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto. Example: 59080 - `sku` (string, required) SKU do item. Example: "electric_shield" ## Query parameters: - `promo_code` (string) Código exclusivo que diferencia maiúsculas de minúsculas. Contém letras e números. Example: "WINTER2021" - `show_inactive_time_limited_items` (integer) Exibe itens de tempo limitado que não estão disponíveis para o usuário. O prazo de validade desses itens não começou ou já expirou. Example: 1 - `additional_fields[]` (array) Campos adicionais para incluir na resposta. Por padrão, esses campos não são retornados. Passe os valores necessários para incluí-los. Enum: "media_list", "order", "long_description", "custom_attributes", "item_order_in_group" ## Response 200 fields (application/json): - `item_id` (integer) ID de item exclusivo interno que é fornecido na criação do item. Example: 259774 - `sku` (string) ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, pontos, traços e sublinhados. Example: "electric_shield" - `name` (string) Nome do item. Example: "Electric shield" - `groups` (array) Grupo aos quais o item pertence. - `groups.external_id` (string) [ID de grupo de itens externo](/pt/api/catalog/item-groups-admin/admin-create-item-group#item-groups-admin/admin-create-item-group/t=request&path=external_id) especificado durante a criação. Example: "exclusive" - `groups.name` (string) Nome do grupo. Example: "Exclusive" - `groups.item_order_in_group` (integer) A posição do item dentro do grupo que determina sua ordem de exibição. Retornado somente se solicitado pelo parâmetro de pesquisa additional_fields[] Example: 1 - `attributes` (array) Lista de atributos e seus valores correspondentes ao item. Pode ser usado para a filtragem de catálogos. - `attributes.external_id` (string) ID de atributo exclusivo. O external_id só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, traços e sublinhados. - `attributes.name` (object) Nome do atributo. Example: "Genre" - `attributes.values` (array) - `attributes.values.external_id` (string) ID de valor exclusivo para um atributo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados. - `attributes.values.value` (string) Valor do atributo. Example: "Strategy" - `type` (string) Tipo de item: virtual_good/virtual_currency/bundle/game_key/physical_good. Enum: "virtual_good", "virtual_currency", "bundle", "game_key", "physical_good" - `description` (string) Descrição do item. Example: "Electric shield" - `image_url` (string) URL da imagem. Example: "https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png" - `is_free` (boolean) Se o item é gratuito ou não. - `price` (object) Preços dos itens. - `price.amount` (string) Preço do item com desconto. Example: "9.99" - `price.amount_without_discount` (string) Preço do item. Example: "9.99" - `price.currency` (string) Moeda do preço do item. Código de três letras de acordo com [a ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Example: "USD" - `virtual_prices` (array) Preços virtuais. - `virtual_prices.amount` (integer) Preço do item em moeda virtual. Example: 100 - `virtual_prices.amount_without_discount` (integer) Preço do item em moedas virtuais sem desconto. Sempre igual a amount já que descontos não são aplicados a preços em moedas virtuais. Example: 200 - `virtual_prices.calculated_price` (object) - `virtual_prices.calculated_price.amount` (string) - `virtual_prices.calculated_price.amount_without_discount` (string) - `virtual_prices.sku` (string) SKU de moeda virtual. Example: "vc_gold" - `virtual_prices.is_default` (boolean) Se o preço padrão é definido em uma moeda virtual ou não. Example: true - `virtual_prices.image_url` (string,null) URL de imagem da moeda virtual Example: "http://image.png" - `virtual_prices.item_id` (integer) ID de item único atribuído pela Xsolla. Example: 259774 - `virtual_prices.name` (string) Nome da moeda virtual. Example: "Gold" - `virtual_prices.type` (string) Tipo de item. Para moedas virtuais, é `virtual_currency. Example: "virtual_currency" - `virtual_prices.description` (string,null) Descrição da moeda virtual. Example: "In-game currency used to purchase weapons and upgrades" - `can_be_bought` (boolean) Se true, o usuário pode comprar um item. Example: true - `promotions` (array) Promoções aplicadas a itens específicos no carrinho. A matriz é retornada nos seguintes casos: * Uma promoção de desconto é configurada para um item específico. * Um código promocional com a configuração Desconto em itens selecionados é aplicado. Se nenhuma promoção no nível do item for aplicada, é retornada uma matriz vazia. - `promotions.name` (string) - `promotions.date_start` (string,null) - `promotions.date_end` (string,null) - `promotions.discount` (object,null) - `promotions.discount.percent` (string,null) - `promotions.discount.value` (string,null) - `promotions.bonus` (array) - `promotions.bonus.sku` (string) - `promotions.bonus.quantity` (integer) - `promotions.bonus.type` (string) Tipo de item bônus. Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft" - `promotions.bonus.name` (string) Nome do item bônus. Indisponível para o tipo de item bônus physical_good. - `promotions.bonus.image_url` (string) URL da imagem do item bônus. Indisponível para o tipo de item bônus physical_good. - `promotions.bonus.bundle_type` (string) Tipo de item de pacote de bônus. Disponível apenas para o tipo de item bônus bundle. Enum: "standard", "virtual_currency_package" - `promotions.limits` (object) - `promotions.limits.per_user` (object) - `promotions.limits.per_user.available` (integer) - `promotions.limits.per_user.total` (integer) - `virtual_item_type` (string) Tipo de item virtual. Possíveis valores: - consumable — Um item que desaparece do inventário após o uso (ex.: munição).. - non_consumable — Um item que permanece no inventário por um tempo ilimitado. - non_renewing_subscription — Item de tempo limitado que pode representar acesso a serviços ou conteúdos por um período específico. Enum: "consumable", "non_consumable", "non_renewing_subscription" - `limits` (object,null) Limites de itens. - `limits.per_user` (object,null) Limites de item para um usuário. - `limits.per_user.total` (integer) Quantidade máxima de itens que o usuário atual pode comprar. Example: 5 - `limits.per_user.available` (integer) Quantidade restante de itens que o usuário atual pode comprar. Example: 3 - `limits.per_user.recurrent_schedule` (any) - `limits.per_user.limit_exceeded_visibility` (string) Determina a visibilidade do item no catálogo após o limite de compra ser atingido, até o próximo limite ser redefinido. Aplica-se a itens para os quais redefinições recorrentes de limite estão configurados na matriz recurrent_schedule. Se os limites redefinidos não forem configurados, o item não aparecerá no catálogo após o limite de compra ser atingido, independentemente do valor limit_exceeded_visibility. Possíveis valores: - show — O item é retornado nas chamadas API de recuperação de catálogo após o limite de compra ser atingido. Nas chamadas API de recuperação de catálogo, quando o limite for atingido, o item será retornado com a marcação can_be_bought: false. A próxima data de redefinição é retornada em reset_next_date. - hide — O item não é retornado nas chamadas API de recuperação de catálogo após o limite de compra ser atingido, até o limite ser redefinido. Enum: "show", "hide" - `limits.per_item` (object,null) Limites de item para um item. - `limits.per_item.total` (integer) Quantidade máxima de itens que todos os usuários podem comprar. Example: 5 - `limits.per_item.available` (integer) Quantidade restante de itens que todos os usuários podem comprar. Example: 3 - `custom_attributes` (object) Um objeto JSON que contém atributos e valores de item. - `vp_rewards` (array) Lista de recompensas de pontos de valor para o item. - `vp_rewards.item_id` (integer) ID de item exclusivo interno. - `vp_rewards.sku` (string) ID de ponto de valor exclusivo. - `vp_rewards.amount` (integer) Quantidade de pontos de valor. - `vp_rewards.name` (string) Nome do ponto de valor. - `vp_rewards.image_url` (string) URL da imagem. - `vp_rewards.is_clan` (boolean) Se o ponto de valor é usado em cadeias de recompensa de clã ou não. - `loyalty_rewards` (array) Pontos de fidelidade que o usuário recebe como recompensa por comprar o item. - `loyalty_rewards.name` (string) Nome dos pontos de fidelidade. - `loyalty_rewards.sku` (string) SKU de pontos de fidelidade. Passe esse valor no parâmetro loyalty_point_sku de outras chamadas de API, por exemplo, ao criar um pedido pago com pontos de fidelidade. - `loyalty_rewards.description` (string) Descrição dos pontos de fidelidade. - `loyalty_rewards.image_url` (string,null) URL da imagem. - `loyalty_rewards.amount` (integer) Quantidade de pontos de fidelidade que o usuário recebe por comprar o item. - `loyalty_prices` (array) Pontos de fidelidade que podem ser usados para comprar o item. - `loyalty_prices.name` (string) Nome dos pontos de fidelidade. - `loyalty_prices.sku` (string) SKU de pontos de fidelidade. Passe esse valor no parâmetro loyalty_point_sku de outras chamadas de API, por exemplo, ao criar um pedido pago com pontos de fidelidade. - `loyalty_prices.description` (string) Descrição dos pontos de fidelidade. - `loyalty_prices.image_url` (string,null) URL da imagem. - `loyalty_prices.amount` (integer) Preço do item especificado em pontos de fidelidade. ## Response 404 fields (application/json): - `statusCode` (integer) Example: 404 - `errorCode` (integer) Example: 4001 - `errorMessage` (string) Example: "[0401-4001]: Item with sku = 'electric_shiel' not found"