> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/guias/sincronizar-catalogo.md).

# Sincronizar Catálogo

Este guia mostra o **fluxo recomendado** para montar e manter o catálogo da sua loja via API: dos departamentos aos produtos e ao estoque.

{% hint style="info" %}
Cada passo tem uma página dedicada com todos os detalhes. Aqui mostramos a **ordem** e como as peças se encaixam.
{% endhint %}

## 1️⃣ Crie a estrutura de departamentos

Os produtos são organizados em **departamentos** (categorias). Crie primeiro os departamentos, pois os produtos são associados a eles pelo nome.

{% content-ref url="/pages/mHqykE9GTRDBP0Gd1BLf" %}
[Criar Departamento](/departamentos/criar-departamento.md)
{% endcontent-ref %}

Para criar uma hierarquia (subdepartamentos), informe o `CodigoPai` do departamento pai. Consulte os departamentos existentes em:

{% content-ref url="/pages/gCqcpUynkvEUmuOBYBti" %}
[Listar Departamentos](/departamentos/listar-departamentos.md)
{% endcontent-ref %}

## 2️⃣ Cadastre os produtos

Com os departamentos prontos, cadastre os produtos, associando cada um aos seus departamentos:

{% content-ref url="/pages/KJSLnRImpNDiCRtK7Ult" %}
[Criar Produto](/produtos/criar-produto.md)
{% endcontent-ref %}

{% hint style="info" %}
Se você importa produtos de outro sistema, preencha o campo `CodigoImportacao`. Depois, você pode localizar o produto por esse código na [listagem de produtos](/produtos/listar-produtos.md).
{% endhint %}

## 3️⃣ Gerencie o estoque separadamente

{% hint style="warning" %}
O estoque **não** é alterado pelo endpoint de edição de produto. Use sempre o endpoint específico de estoque.
{% endhint %}

{% content-ref url="/pages/0VIX9jhqVUZ098rKiXAX" %}
[Gerenciar Estoque](/produtos/gerenciar-estoque.md)
{% endcontent-ref %}

## 4️⃣ Mantenha o catálogo atualizado

Para atualizações contínuas:

* **Editar** dados de um produto (preço, nome, descrição): [Editar Produto](/produtos/editar-produto.md).
* **Atualizar estoque** (inclusive por variação): [Gerenciar Estoque](/produtos/gerenciar-estoque.md).
* **Remover** um produto: [Excluir Produto](/produtos/excluir-produto.md).

## 🔄 Resumo do fluxo

| Passo | Ação                      | Endpoint                                 |
| ----- | ------------------------- | ---------------------------------------- |
| 1     | Criar departamentos       | `POST /departamentos/`                   |
| 2     | Cadastrar produtos        | `POST /produtos/`                        |
| 3     | Definir/atualizar estoque | `PUT /produtos/estoque/{CodigoProduto}/` |
| 4     | Editar produto            | `PUT /produtos/{Codigo}/`                |