---
title: Ideris
slug: ideris
createdAt: 2026-10-30T19:43:30.067Z
---

## Objetivo

O conector **Ideris** integra a plataforma Fluid com a API da Ideris, um hub de gestão de pedidos e anúncios multicanal para operações de e-commerce. Através dele, é possível automatizar a sincronização de **pedidos**, **notas fiscais**, **clientes**, **SKUs**, **marcas**, **NCMs**, **anúncios**, **modelos de anúncio** e **variações** entre a Ideris e os demais sistemas conectados ao seu fluxo.

## Como configurar a Conexão

Para cadastrar a conexão com a Ideris na plataforma Fluid:

1. Acesse o menu **Conexões** no painel da Fluid.
2. Clique em **Nova Conexão** e selecione o conector **Ideris**.
3. Preencha os campos obrigatórios: **Nome** (para identificar a conexão) e **Token** (token de autenticação da conta Ideris). A **Descrição** é opcional.

## Configurando Fluxo

Após conectar, arraste o conector **Ideris** para o seu fluxo e selecione o **Recurso** e a **Operação** desejados.

### Recursos disponíveis

- Pedidos
- Nota fiscal
- Cliente
- Ncm
- Marca
- Skus
- Anúncio
- Modelo de Anúncio
- Variação

Cada recurso possui uma ou mais operações associadas, detalhadas a seguir.

### Pedidos

- **Listar Pedidos**: lista pedidos com filtros opcionais — limit, offset, orderId, statusId, authenticationId, marketplace, origin, orderPackId, orderCode, startDate, endDate.
- **Buscar Pedido pelo Id**: consulta um pedido específico (Obrigatório informar o id).
- **Criar Novo Pedido**: cria um novo pedido (Obrigatório informar o body, via De/Para ou Template).
- **Atualizar Dados do Pedido**: atualiza um pedido existente (Obrigatório informar o body).
- **Listar Status dos Pedidos**: lista os status dos pedidos com filtros opcionais — limit, offset, id, statusId, authenticationId, marketplace, origin, statusDescription.
- **Alterar Status do Pedido**: altera o status de um pedido (Obrigatório informar o authenticationId; opcionalmente o body).
- **Buscar Status do Pedido pelo Id**: consulta o status de um pedido (Obrigatório informar o id).

### Nota fiscal

- **Pesquisar NF por Id do Pedido**: busca a nota fiscal vinculada a um pedido (Obrigatório informar o id).
- **Criar Nova NF**: cria uma nova nota fiscal para um pedido (Obrigatório informar o body).

### Cliente

- **Listar clientes**: lista clientes com filtros opcionais — limit, offset, id (lista de IDs separada por vírgula), strId, firstName, lastName, email, document (CPF/CNPJ).
- **Criar cliente**: cria um novo cliente (Obrigatório informar o body).
- **Atualizar Dados do Cliente**: atualiza os dados de um cliente (Obrigatório informar o body).
- **Buscar Cliente pelo Id**: consulta um cliente (Obrigatório informar o id).
- **Excluir Cliente pelo Id**: exclui um cliente (Obrigatório informar o id).

### Ncm

- **Listar NCMs**: lista NCMs com filtros opcionais — limit, offset, name, code.
- **Criar NCM**: cria um novo NCM (Obrigatório informar o body).
- **Atualizar Dados do NCM**: atualiza um NCM (Obrigatório informar o body).
- **Buscar NCM pelo Id**: consulta um NCM (Obrigatório informar o id).
- **Excluir NCM pelo Id**: exclui um NCM (Obrigatório informar o id).

### Marca

- **Listar Marcas**: lista marcas com filtros opcionais — limit, offset, description.
- **Criar marca**: cria uma nova marca (Obrigatório informar o body).
- **Atualizar Dados da Marca**: atualiza uma marca (Obrigatório informar o body).
- **Buscar Marca pelo Id**: consulta uma marca (Obrigatório informar o id).
- **Excluir Marca pelo Id**: exclui uma marca (Obrigatório informar o id).

### Skus

- **Listar Skus**: lista SKUs com filtros opcionais — limit, offset, idsSku, sku, tipoSkuId.
- **Criar Sku**: cria um novo SKU (Obrigatório informar o body).
- **Atualizar Dados do Sku**: atualiza um SKU (Obrigatório informar o body).
- **Atualizar Dados do Estoque do Sku**: atualiza o estoque de um SKU (Obrigatório informar o body).
- **Buscar Sku pelo Id**: consulta um SKU pelo id (Obrigatório informar o skuId).
- **Buscar Sku pelo Código**: consulta um SKU pelo código (Obrigatório informar o code).
- **Excluir Sku pelo Id**: exclui um SKU pelo id (Obrigatório informar o skuId).
- **Excluir Sku pelo Código**: exclui um SKU pelo código (Obrigatório informar o code).

### Anúncio

- **Atualizar Preço do Anúncio**: atualiza o preço de um anúncio (Obrigatório informar o body).
- **Atualizar Status do Anúncio**: atualiza o status de um anúncio (Obrigatório informar o body).
- **Listar pelo código do anúncio e id da autenticação**: consulta um anúncio pelo sku (código do anúncio) e pelo authentication (id da autenticação).
- **Listar pelo SKU do produto e id da autenticação**: consulta um anúncio pelo sku (código do SKU do produto) e pelo authentication (id da autenticação).

### Modelo de Anúncio

- **Atualizar Modelo de Anúncio**: atualiza um modelo de anúncio (Obrigatório informar o body).
- **Criar Modelo de Anúncio**: cria um novo modelo de anúncio (Obrigatório informar o body).
- **Listar Modelos de Anúncio**: lista modelos de anúncio, com filtro opcional pelo sku.

### Variação

- **Listar Variações**: lista variações com diversos filtros opcionais — limit, offset, id, mainSstockId, listingModelId, skuId, listingModelStatusId, listingId, listingModelCompositeId, listingModelCompositeOrigintId, mainStockOnly, variationOnly, listingModelCompositeOriginJoin, strSkulike, strSku, strSkuVariant, listingStrSellerId.
- **Criar Variação**: cria uma nova variação (Obrigatório informar o body).
- **Atualizar Dados da Variação**: atualiza uma variação (Obrigatório informar o body).
- **Excluir Variação pelo Id**: exclui uma variação (Obrigatório informar o id).

:::hint{type="info"}
Campos como body, id, skuId, code, entre outros, variam conforme o recurso e a operação escolhidos, e podem ser preenchidos via De/Para ou Template
:::

## Observações Técnicas

- As requisições são enviadas em Content-Type: application/json.
- Conector classificado na categoria **E-Commerce**.
- Operações de criação e atualização (Criar, Atualizar) exigem o preenchimento do campo body, montado via De/Para ou Template.

## Conclusão

Com o conector **Ideris**, você centraliza a gestão de pedidos, notas fiscais, clientes e catálogo (SKUs, marcas, NCMs, anúncios, modelos de anúncio e variações) diretamente na plataforma Fluid, automatizando a troca de informações entre a Ideris e os demais sistemas do seu fluxo.
