RDMarketplace
A integração com o RDMarketplace conecta a sua conta ao idworks e sincroniza os fluxos correspondentes ao canal — credenciais, regras de sincronização de produtos, importação de pedidos, conciliação financeira e demais ações específicas dele. A configuração reúne 26 parâmetros distribuídos em 4 grupo(s).
Antes de configurar, ative a integração em Configurações → Integrações (aba Integrações Disponíveis), preencha o nome interno e (quando o tipo exigir) passe pelo fluxo de autenticação. A partir daí, os parâmetros abaixo ficam disponíveis na Configuração (ícone de engrenagem) da integração.
Categoria no catálogo do idworks: Canal de Venda.
Índice
Conceito
Cadastro e autenticação
Parâmetros por grupo
Referência rápida
O que é a integração RDMarketplace?
É a conexão entre o canal RDMarketplace e o idworks. Ela controla como dados fluem entre os dois sistemas — depende do tipo da integração (a categoria neste caso é Canal de Venda), mas em geral cobre uma combinação de credenciais, regras de sincronização, gatilhos automáticos e parâmetros de conciliação.
📍 Onde: menu lateral → Configurações → Integrações → aba Integrações Disponíveis → RDMarketplace.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por RDMarketplace e clique no botão +.
- Preencha:
- Conta (apenas multi-conta) — empresa dona da integração.
- Nome da Integração — texto livre. Útil para distinguir várias instâncias do mesmo tipo.
- Clique em Salvar.
A integração aparece imediatamente em Minhas Integrações. Dependendo do tipo, o status inicial é Ativo (quando só requer credencial fixa) ou Não Autenticado (quando depende de autenticação externa).
Pré-requisito: privilégio Criar parametrizações empresa.
Como autenticar e validar as credenciais?
Preencha o grupo Credenciais de Acesso (ver tabela abaixo). Quando a integração pede uma autorização externa (o canal abre a tela de login dele para você liberar o acesso), clique em Autenticar Integração na linha da integração (ícone de cadeado) — uma nova aba abre o login do canal e, ao confirmar, a conexão fica liberada. Para integrações com credencial fixa (usuário/senha/chave), basta preencher os campos e salvar.
Depois de salvar, use a ação Validar credenciais (quando disponível) para confirmar que o canal responde. O status na listagem reflete o resultado: Ativo = OK, Erro = credencial inválida ou revogada, Não Autenticado = falta concluir o fluxo de autorização.
Pré-requisito: privilégio Editar parametrizações empresa.
Credenciais de Acesso
4 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Texto | (sem descrição cadastrada) | |
| Código | Texto | (sem descrição cadastrada) |
| Chave de Integração - API | Senha | (sem descrição cadastrada) |
| Validar credenciais | Botão | Clique para validar as credenciais informadas |
Integração de Vendas
5 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Empresa Faturadora | Lista | Empresa responsável pelo faturamento dos pedidos, caso seja diferente da principal. |
| Importar pedidos | Sim/Não | Ative se quiser que a idworks integre os pedidos feitos no canal de vendas. |
| Excluir valor frete na NF para PF | Sim/Não | Ative se quiser excluir o valor do frete na Nota Fiscal quando a venda por para pessoa física (PF) |
| Detalhar forma de pagamento | Sim/Não | Importar o detalhe da forma de pagamento utilizado pelo cliente, como cartão de crédito, boleto e etc. Exige realizar o DE/PARA de todas as formas |
| Data inicial para importação de pedidos | Data | Seleciona a data inicial da criação do pedido no canal para importar. Se não informar, sempre será importado pedidos dos últimos 6 dias |
Integração de Produtos
13 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Estoque de segurança | Inteiro | Se a quantidade de um produto estiver abaixo do valor escolhido, seu anúncio será pausado para evitar que sejam feitas vendas sem estoque. O valor de estoque mínimo é aplicado a todos os produtos. |
| Atualizar saldo estoque | Sim/Não | Ative se quiser que a idworks atualize o saldo de estoque na integração. |
| Atualizar Imagem | Sim/Não | Ative se quiser enviar a atualização de imagem na integração |
| Atualizar preço | Sim/Não | Ative se quiser enviar a atualização de preço na integração |
| Utilizar título como nome SKU | Sim/Não | Utilizar o campo título como nome do SKU ao enviar para o canal |
| Armazéns para somar quantidade | Lista múltipla | Selecionar os armazéns que deve somar a quantidade para enviar aos canais de venda. Caso não seja preenchido, será enviado a quantidade do armazém que esta no de/para |
| Valor de ajuste no preço | Decimal | Valor em R$ fixo a ser somado ao preço por (base) para compor o preço de venda |
| Valor de ajuste no preço frete grátis | Decimal | Valor em R$ fixo a ser somado ao preço de venda já ajustado, se houver frete grátis e se o preço com o ajuste normal atingir a regra de frete grátis |
| Arredondamento dos centavos do preço | Decimal | Valor em centavos para arredondar o preço de venda. Preencha entre 0,01 e 0,99. |
| Percentual de ajuste no preço | % | Valor percentual a ser somado ao preço por (base) para compor o preço de venda |
| Percentual de ajuste no preço frete grátis | % | Valor percentual sobre o preço por (base) a ser somado ao preço de venda já ajustado, se houver frete grátis e se o preço com o ajuste normal atingir a regra de frete grátis |
| Percentual disponibilidade de estoque | % | Valor base para utilizar do estoque em percentual. Ex. se tiver 100 unidades disponíveis e o percentual for 80% será enviado 80 para o canal |
| Atualizar produto | Sim/Não | Ative se quiser enviar a atualização de produto na integração |
Importação de Anúncios
A importação traz para o idworks os produtos que já estão no RDMarketplace e cria os anúncios correspondentes no Hub. Ela lê só os produtos ativos no canal (os desabilitados não entram) e os anúncios entram como ativos.
A importação fica na janela de configuração da integração (ícone de engrenagem Configuração em Minhas Integrações), aba Importação de Anúncios. A aba só aparece para integrações que têm os parâmetros abaixo.
Como importar:
- Na linha da integração, abra a Configuração e vá à aba Importação de Anúncios.
- Ligue as opções que quiser (tabela abaixo).
- Clique em Importar Anúncios e confirme "Confirma a importação dos anúncios para esta integração?". O idworks salva as opções marcadas e roda a importação em segundo plano.
- Acompanhe na seção Resultado última importação, na própria aba (ela abre sozinha enquanto a importação não termina; depois fica recolhida, clique no título para abrir): Data início, Data finalização, Quantidade, Usuário e Progresso importação (use Atualizar Dados para recarregar). Visualizar abre o detalhe da importação.
Enquanto uma importação está em andamento, o botão fica desabilitado: só roda uma por integração de cada vez.
Como o anúncio é ligado ao Produto/SKU: o idworks procura no seu cadastro o Produto/SKU cujo Cód. referência é igual ao SKU do produto no RDMarketplace. Quando o produto tem variações, o anúncio liga ao Produto e cada variação liga ao SKU de mesmo código; a variação que não acha SKU entra sem vínculo. Produto sem variações no RDMarketplace só liga a um cadastro que não seja do tipo Produto (o pai de uma grade de variações): se o código for o de um Produto com variações, o anúncio é tratado como sem correspondência. A primeira categoria do produto no RDMarketplace vem junto no anúncio.
4 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Importar somente anúncios inexistente dentro da idworks. | Sim/Não | Ligado, também importa os anúncios que não acharam Produto/SKU no idworks; eles entram sem vínculo, para você associar depois. Desligado, esses anúncios ficam de fora, sem aviso na tela. Apesar do rótulo (e da dica ao lado do campo), ligar a opção aumenta a quantidade importada. |
| Incluir Título na ficha do Anúncio | Sim/Não | Grava o nome do produto no RDMarketplace como título do anúncio. Desligado, vale o campo Nome do cadastro do produto no momento da sincronização do anúncio. |
| Incluir Descrição na Ficha do Anúncio. | Sim/Não | Grava a descrição do produto no RDMarketplace na ficha do anúncio. Desligado, vale o campo Descrição do cadastro do produto no momento da sincronização do anúncio. |
| Incluir Preços na ficha do Anúncio | Sim/Não | Grava o preço do RDMarketplace no campo R$ manual de cada SKU do anúncio (o de cada variação, quando o produto tem variações). O preço manual tem prioridade: enquanto existir, é ele que o idworks usa no envio de preço ao canal, sem aplicar a política comercial nem os ajustes de preço de Integração de Produtos, e o preço a nível de anúncio fica bloqueado (veja Qual a diferença entre preço do anúncio e preço manual da variação?). Desligado, vale o preço definido pela política comercial do cadastro do produto no momento da sincronização do anúncio. |
Cuidado: anúncio do RDMarketplace que já existe no idworks é pulado. A importação não atualiza o título, a descrição nem o preço de um anúncio já cadastrado. Os anúncios pulados continuam contando como pendentes: o Progresso importação pode ficar abaixo da Quantidade e a Data finalização em branco, mesmo com a importação já concluída. O botão Importar Anúncios só volta a ficar disponível 2 horas depois do início.
Pré-requisito: privilégios Editar parametrizações empresa (sem ele, o ícone Configuração não aparece na linha da integração) e Importar Produto / Anúncio (sem ele, a aba fica desabilitada).
Para trazer só alguns anúncios, sem rodar a importação completa, veja Como importo anúncios que criei direto no canal?.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar integrações | Acesso à tela de Integrações e a esta página de configuração. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). |
| Editar parametrizações empresa | Abrir a Configuração (engrenagem), editar nome e status e validar credenciais. |
| Deletar parametrizações empresa | Excluir a integração. |
| Importar Produto / Anúncio | Aba Importação de Anúncios na janela de configuração. |