Ideris
9 min
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:
- Acesse o menu Conexões no painel da Fluid.
- Clique em Nova Conexão e selecione o conector Ideris.
- 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).
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.