# Produtos

## Categorias

Caso seu Marketplace possua conceitos de categorias de produtos pré-definidas e portanto as mesmas sejam obrigatórias para o cadastro de uma oferta, onde o integrador deve enviar o **identificador da categoria** durante o envio de ofertas, é necessário que sejam implementadas as APIs de categorias.

{% hint style="info" %}
Notifique o integrador sobre a convenção de seu Marketplace, ou seja, se existem categorias pré-definidas ou não e se as mesmas são obrigatórias ou não para a integração de produtos, assim o integrador poderá fazer esta configuração no envio de produtos.
{% endhint %}

## Produtos e Skus

Em produtos a sua integração precisa realizar as seguintes ações:

* Consultar todos os produtos
* Criar produto
* Consultar produto específico
* Atualizar produto específico
* Deletar um produto específico<br>
* Consultar todas as variações de um produto
* Criar variação em produto
* Consultar variação específica
* Atualizar variação de produto
* Deletar variação de um produto<br>
* Consultar produtos com filtro
* Criação e Atualização em lote de produtos
* Consultar atualizações de status de produtos adicionados na fila
* Deletar uma variação de produto da fila
* Consultar Log de integração

{% hint style="warning" %}
**Atualização de Produtos**\
Ao enviar o **POST** de um produto, não será possível a alteração da categoria de um produto através do **PUT**, por isso tenha certeza de enviar o produto na categoria correta, caso contrário você terá de excluir o produto através do **DELETE.**<br>
{% endhint %}

O desenvolvimento do endpoint de **products** é importante para que o seller possa enviar/criar, consultar, atualizar e deletar os seus produtos no Marketplace, a nossa API de **products** utiliza o conceito de produtos e SKUs, conhecida também por:

* Produto e variação de produto
* Produto pai e produto filho
* Produto simples e produto composto

**Quando eu devo utilizar o envio de produtos em lote?**

Todas as vezes em que você tiver uma carga muito grande de criação ou atualizações a serem feitas, você deverá utilizar a atualização em lote.

**Cenário 01:** Na carga inicial de produtos, durante o processo de implantação do seller, deve ser enviado um lote para criação de produtos, dessa forma com uma única chamada, a integração enviará todos os produtos do seller para o marketplace

**Cenário 02:** Uma nova coleção de produtos chegou na loja do seller, e ele deseja disponibilizar estes no marketplace, a Linx indica a utilização da criação de produtos em lote.

**Cenário 03:** Imagine que o seller fez muitas alterações em vários produtos e precisa replicar essas informações para o Marketplace, para isso a Linx indica a utilização da atualização de produtos em lote.

**Qual o limite de produtos que posso enviar em 1 lote?**

O limite é de 100 produtos por lote (batch)

A API possui o conceito de **Produtos** e **Skus** (variações de produto), sendo que um produto deverá possuir ao menos uma variação. Ou seja, caso o produto seja simples (sem variação), no array **variations** deverá ser enviado os detalhes do produto como uma variação, conforme exemplo abaixo:

```
{
  "id": "000100",
  "name": "Camiseta",
  .
  ...
  "variations": [
  {
      "sku": "000100"
    }
  ]
}
```

## Status de Produtos

***New*** – O produto recebe o status: ***New*** quando ele é cadastrado com sucesso, mas ainda não foi publicado.

***InReview*** – O produto recebe o Status: ***InReview*** quando ele passa algum tipo de moderação.

A moderação é uma das formas de o Marketplace verificar se o cadastro do produto está correto e liberá-lo ou recusa-lo por algum motivo.

***OBS:*** Atualmente nós não temos implementado a moderação de produto no Marketplace, por esse motivo nenhum produto terá esse status no momento.

***Published*** – O produto recebe o status: ***Published*** quando ele está publicado no Marketplace.

***Inactive*** – O produto recebe o status: ***Inactive*** quando a integração enviar no cadastro ou na atualização do produto o Active = False

***Failed*** – O produto recebe o status: ***Failed*** quando ele foi cadastrado, mas teve algum erro ao ser publicado no Marketplace.

## Venda sem estoque

É possível informar quais variações terão vendas mesmo sem ter estoque

Na criação das variações no campo:

**backorderlimit** aqui você informará qual é o limite da venda sem estoque.

**backordertime** aqui você informará qual o tempo de manuseio para venda de itens sem estoque.

## Regras do cadastro de imagens

Cada Marketplace terá as suas próprias configurações de dimensões mínimas para o envio de imagens de produtos, para saber quais são as dimensões entre em contato com o Marketplace. \
\
Os formatos aceitos são JPG e PNG.

**Mais detalhes sobre API de Produtos em:**&#x20;

{% content-ref url="/pages/-LvbyDKai0hosqg-Cvep" %}
[Broken mention](broken://pages/-LvbyDKai0hosqg-Cvep)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://oma.linx.com.br/products.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.