O Provedor de Software #1 no Mercado de Metais Preciosos

Estamos aqui para ajudar

Confira nossos tutoriais, guias técnicos e documentação da API.

Experimente o software nFusion gratuitamente por 14 dias.

Conheça nossos clientes satisfeitos

Instituições financeiras, revendedores e atacadistas se beneficiam de nossas visualizações poderosas para dados históricos e em tempo real.

Como podemos ajudar?

Nossa equipe de suporte dedicada está aqui para ajudar você com quaisquer perguntas ou desafios que você possa enfrentar. Se você precisa de orientação técnica ou ajuda para navegar em nossos serviços, estamos a apenas um clique de distância para fornecer as soluções que você precisa.

Where do you get your spot prices?

At nFusion Solutions, our spot prices are sourced from a curated network of trusted global providers, including leading global exchanges and financial institutions like SIX-Group (Swiss Stock Exchange), Morningstar, UBS, Saxo Bank, Morgan Stanley, AFX, and BNP Paribas. We continuously monitor these real-time feeds using a proprietary confidence-scoring system to ensure the most accurate, timely, and reliable data.

Our system calculates a best bid and offer (BBO) by selecting the most trustworthy quotes and filtering out anomalies. From there, we derive a clean midpoint and construct balanced bid/ask prices tailored to current market conditions.

Want a deeper look at how it all works? Read our full guide on precious metals spot prices ›

Por que meus preços spot não estão sendo atualizados?

Se os preços à vista não parecem estar sendo atualizados, pode ser porque o mercado está fechado. O horário de mercado para metais preciosos corresponde a Horas CME Globex para futuros de metais

Como posso personalizar o preço spot da minha empresa?

To configure custom spot pricing for metals:

  1. Faça login em seu nFusion Dashboard as an administrator.

  2. Navigate to the “Metal Price Configuration” section on the home page.

  3. Enable Custom Overrides by toggling the switch at the top of the section. Once enabled:

    • You’ll have the option to set an “Expires On” date. This determines when your custom pricing will expire and automatically revert to the global spot price.

  4. Configure Spot Prices for Individual Metals:
    Below the toggle and expiration date, you’ll see a table listing each supported metal:
    Gold, Silver, Platinum, Palladium, Rhodium, and Copper.

    For each metal, you can:

    • Set a Fixed Bid and/or Fixed Ask value to lock in a specific price.

    • Apply a Bid Adjustment ou Ask Adjustment to automatically increase or decrease the spot price.

    For example:
    To set a fixed Ask price for Gold at $1,215.75, click the pencil icon for Gold, enter 1215.75 in the Fixed Ask field, and save.
    To adjust the price dynamically instead, enter 0.5 in Ask Adjustment and -0.5 in Bid Adjustment to increase your Ask by 50¢ and decrease your Bid by 50¢ relative to the live spot price.

  5. Edit Metal Pricing:
    Click the pencil icon next to the metal you wish to configure. This will open an editing dialog where you can enter your desired values for the appropriate metal.

Por que o valor da alteração (preço, oferta, venda, etc.) em nosso site não corresponde ao site Y?

There are a number of factors that affect how spot prices are calculated and how they are displayed.

  1. O site Y pode estar usando uma fonte de dados diferente. Se utilizarem um fornecedor de dados diferente, os seus preços spot serão quase certamente ligeiramente diferentes devido a variações nos cálculos, entrega, armazenamento em cache e tempo.
  2. O site Y pode estar aplicando ajustes ao preço spot global para afetar a forma como seu site exibe os dados de preços.
  3. O site Y pode ter diferenças em relação ao seu site, como velocidade, latência, entrega, cache, intervalos de pesquisa e código.
Como posso obter dados de preços spot em XML ou JSON?

To access spot price data in either XML or JSON format, first log in to your nFusion Dashboard. From the dashboard:

Go to the Connections page and scroll down to the API Keys section.

Click the “View” button in the “Documentation” column for the corresponding Market Data API key to access detailed usage instructions, including supported formats and endpoints.

By default, API responses are returned in JSON. If you prefer XML, you can set the appropriate Accept header in your request (application/xml) or use the format query parameter (e.g., ?format=xml). We recommend using JSON (application/json) for most use cases due to its widespread compatibility and performance.

Como integro dados de catálogo (APIs)?

To access the nFusion Solutions APIs, you’ll need one or more API tokens, depending on your use case. To find your API tokens:

  1. Log in to your nFusion Dashboard.
  2. Navigate to the Connections page.
  3. Locate the API Keys section to view your token(s) and access the appropriate documentation for full implementation details.

Your API tokens are sensitive credentials and should be kept secret. Never expose them in client-side code (e.g., JavaScript running in the browser), as this can allow others to view and misuse your token. Instead, route requests through your own server using a secure proxy, such as:

https://yoursite.com/proxy/metals/spot

This server-side proxy can safely call nFusion APIs using your token while keeping it hidden from the public.

To improve performance and reduce redundant API calls, we strongly recommend implementing caching on your proxy server. This ensures that multiple client-side requests don’t result in a 1:1 call ratio to nFusion APIs.

When making API requests, use the following HTTP headers as appropriate:

  • Aceitar: Recommended value is application/json. For XML, use application/xml.
  • Aceitar-codificação: Use deflate,gzip for compressed and faster responses.
  • Tipo de conteúdo: For POST or PUT requests with a body, use application/json.
  • Agente de usuário: We recommend setting this to your customer ID for identification.

For further guidance, refer to the API documentation linked from your Dashboard.

Por que algumas das minhas chamadas de API retornam o código HTTP 403?

An HTTP 403 (Forbidden) response with substatus 502 typically means your API requests have exceeded the rate limit. This happens when you make too many calls in a short period of time.

To resolve this, reduce the number of API requests you’re making per second. Implementing caching on your server or delaying certain requests can help stay within the allowed limits.

For high-frequency use cases, consider batching or aggregating your requests where possible to optimize efficiency and stay within allowed limits.

Por que os widgets do meu site não carregam?

Existem vários motivos pelos quais os widgets podem não carregar em uma página.

  1. Se você estiver recebendo respostas com o código de status 401 (não autorizado), pode ser que sua assinatura tenha expirado ou você tenha um domínio incompatível.
  2. Você pode ter adicionado o código do script à sua página incorretamente. Verifique novamente as instruções incluídas que você recebeu.
  3. Há um erro de javascript na página. Verifique se há erros no painel do desenvolvedor do seu navegador.
  4. Há mais de um widget na mesma página com IDs correspondentes. Isto está causando um conflito com os scripts do widget. Para corrigir esse erro, consulte nosso tutorial abaixo sobre como adicionar várias instâncias de um widget ao mesmo.
Como envio mensagens para alertar os usuários?

Faça login no portal de serviços de alertas usando seu endereço de e-mail de administrador. Depois de fazer login como administrador no URL de administrador, você verá as seguintes opções:  

  • Definir mensagem de marketing para e-mails de alerta
  • Envie uma mensagem promocional agora para todos os usuários
  • Exportar lista de usuários
  • Gerenciar modelos de e-mail

Clique na segunda opção – envie uma mensagem promocional agora para todos os usuários. Esta opção permite que o administrador envie uma mensagem a qualquer momento para todos os usuários que optaram por receber notícias e mensagens promocionais. Após clicar na segunda opção, você será direcionado para uma nova página contendo uma caixa de entrada de texto onde poderá adicionar a mensagem desejada. Depois de terminar de criar sua mensagem, basta clicar no botão Enviar. Posteriormente, uma página exibirá os resultados da sua mensagem. Esses resultados contêm informações sobre a mensagem. Por exemplo, você verá quantas notificações foram enviadas com mais detalhes sobre se foram ou não notificações push ou SMS. Isso permite que você entenda quantas pessoas sua mensagem está alcançando e como ela as alcança, permitindo assim aprimorar suas estratégias de marketing.

Quais plug-ins de moeda são compatíveis com o plug-in de preços automatizados de produtos de metais preciosos?

Testamos e confirmamos a compatibilidade com os três plug-ins multimoedas mais populares na loja de plug-ins do WordPress. Esses plug-ins funcionarão imediatamente com nosso plug-in a partir da versão 2.9.9. Se você não estiver usando pelo menos a versão 2.9.9 do nosso plugin, os plugins de troca de moeda podem não ser compatíveis. Observe a versão com a qual eles foram testados.

  1. CURCY – Multimoeda para WooCommerce
  2. WOOCS – Trocador de moeda para WooCommerce
  3. Trocador de moeda para WooCommerce
Por que meu plug-in de moeda não funciona com o plug-in de preços automatizados de produtos de metais preciosos?

Se você não estiver usando um dos plugins que confirmamos serem compatíveis na lista mencionada aqui, há algumas coisas a serem observadas. Nosso plugin depende da função get woocommerce_currency() que retorna o código da moeda atual do WooCommerce. Se o seu plugin de troca de moeda não estiver atualizando a moeda WooCommerce, nosso plugin não atualizará os preços dos produtos com a nova moeda. A outra coisa que pode estar fazendo com que seu plugin não funcione corretamente é a prioridade na qual o filtro woocommerce_product_get_price está definido. A partir da versão 2.9.9, nosso plugin Catálogo de Produtos está definindo a prioridade do filtro mencionado acima para 10000 na tentativa de que nosso gancho seja executado por último. Se a prioridade do referido filtro no plugin de moeda for superior a 10000, pode estar substituindo o preço que está sendo retornado do Catálogo de Produtos.

Posso modificar a funcionalidade do seu plugin Precious Metals Automated Product Pricing?
Se nosso plugin gratuito não oferece suporte ao comportamento específico desejado, você pode modificar sua cópia local do plug-in para ter um comportamento personalizado, se desejar. Tenha em mente os seguintes cuidados se você decidir modificar o plugin:
 
1. Não oferecemos suporte para versões modificadas de nossos plugins. Depois de modificar o código de sua fonte pública, todo o suporte de desenvolvimento para esse plugin estará fora do escopo de nossa equipe.
2. Se você modificar sua cópia local e não desativar as atualizações automáticas desse plug-in, na próxima vez que lançarmos uma nova versão, suas alterações locais serão substituídas e perdidas.
3. Se você desabilitar as atualizações automáticas e modificar sua cópia local, você não receberá mais atualizações quando as lançarmos. Isso significa que você não receberá o benefício de futuras correções de bugs e/ou melhorias de recursos. Pode ser possível para o seu desenvolvedor examinar o código no repositório público e mesclar as alterações, mas nossa equipe não pode fornecer suporte para a mesclagem, nem para qualquer código do seu plugin customizado.
Como faço para que meus widgets sejam exibidos na moeda definida pelo meu plugin de troca de moeda?

Para fazer isso, você deve usar um de nossos plug-ins de troca de moeda suportados. Se estiver usando um alternador de moeda compatível, você terá duas opções:

1. Use nosso Plug-in de gráficos e widgets para WordPress
A partir da versão 1.2.4, nosso plugin de widgets funcionará imediatamente com qualquer um dos alternadores de moeda suportados mencionados acima.

2. Use nosso script auxiliar de moeda
O script auxiliar de moeda é implementado de maneira muito semelhante aos nossos scripts de widget padrão. Você simplesmente precisa colar um script na página onde deseja exibir o widget. Se desejar usar esta opção, visite nosso tutorial sobre como implementar o script auxiliar de moeda.

Como personalizar o estilo do widget usando o Dashboard

Agora você pode personalizar o estilo dos seus widgets sem esforço através do nosso novo aplicativo Dashboard! Para começar, siga estas etapas:

Acesse a página de widgets: Faça login em seu Painel nFusion e navegue até a página de widgets.

Editar um widget: Na página de widgets, localize o widget que deseja personalizar e clique no ícone de lápis ‘editar’ na coluna de ações. Esta ação o levará para a tela do editor do widget.

Seções de personalização: Na tela do editor do widget, você encontrará duas seções principais:

  • Seção de upload de arquivo: Esta seção permite fazer upload de arquivos, como CSS e (JS, disponível apenas no pacote de widget avançado), bem como um arquivo de imagem.
  • Seção de configurações do widget: Aqui, você pode definir configurações específicas do widget. Neste guia, vamos nos concentrar na seção de upload de arquivo e explorar como fazer upload de um arquivo CSS personalizado.

Antes de você começar:

Antes de enviar seu CSS personalizado, é altamente recomendável revisar nosso Melhores práticas de CSS documentação para garantir que seu estilo seja aplicado sem conflitos.

Fazendo upload de CSS personalizado:

Para fazer upload do seu arquivo CSS personalizado, siga estas etapas:

  1. Clique no botão do ícone ‘upload’ na coluna ‘Upload CSS’. Esta ação abrirá um explorador de arquivos, permitindo que você selecione o arquivo CSS que deseja enviar.
  2. Depois de selecionar um arquivo CSS, você receberá uma mensagem de confirmação confirmando que seu arquivo CSS foi carregado com sucesso.

Visualize suas alterações:

Para ver suas personalizações em ação, retorne à página de widgets e clique no botão “visualizar” do widget que você acabou de editar. Isso abrirá uma página de visualização do widget onde você poderá visualizar seu novo estilo CSS.

Solução de problemas do aplicativo CSS:

Se você descobrir que seu CSS personalizado não está sendo aplicado, considere as seguintes soluções:

  • Limpando cache e recarga forçada:
    • Abra o Developer Console usando Control+Shift+I (Windows/Linux) ou Option+Command+I (Mac), ou via Ferramentas > Desenvolvedor > Ferramentas do desenvolvedor, ou clicando com o botão direito e escolhendo Inspecionar.
    • Pressione e segure ou clique com o botão direito no ícone Atualizar.
    • Escolha “Esvaziar Cache e Recarregar Forçado” no menu suspenso.
  • Verifique a especificidade do CSS:
    • Abra o Developer Console e inspecione o elemento que deseja estilizar. No painel “Estilos” do lado direito, certifique-se de que sua regra CSS não esteja riscada. Se for, isso indica que uma regra CSS diferente pode ter maior especificidade.
  • Verifique os seletores e arquivos CSS:
    • Verifique se há erros de digitação nos seletores CSS e em sua ordem.
    • Verifique se o arquivo CSS que você enviou é o correto usando a guia “Rede” do Developer Console e encontrando a solicitação CSS correspondente ao seu arquivo CSS personalizado.

Se nenhuma das soluções acima funcionar, entre em contato com nossa equipe de suporte em suporte@nfusionsolutions.com. Ao relatar seu problema, certifique-se de incluir todas as etapas que você tomou para resolver o problema antes de entrar em contato. Isso nos ajudará a fornecer a solução mais rápida possível para suas necessidades de personalização.

Como adicionar várias instâncias de um widget à mesma página

Para isso, cada widget deve ter um ID exclusivo para que, ao serem carregados na página, não haja erros ou conflitos de javascript. Portanto, ao adicionar várias instâncias do mesmo widget a uma única página, você precisa alterar o ID do elemento DIV para que ele seja exclusivo nessa página; em seguida, modifique o atributo src no script adicionando “/your-id” ao final do domínio raiz. Ao alterar o ID e modificar o src, você informa ao script em qual elemento DIV carregar o gráfico. Por exemplo, aqui está um script de widget de gráfico padrão que foi copiado da página de visualização:


<div id='c528ee05-722d-4762-a635-213197f7b8b4' style='width:100%;height:100%;'></div>
<script>
    (function () {
        var t = document.getElementsByTagName('script')[0];
        var s = document.createElement('script');
        s.async = true;
        s.src =
            'https://widget.nfusionsolutions.com/widget /script/chart/1/32796899-2cc3-4454-ac51-2c95c78799af/c528ee05-722d-4762-a635-213197f7b8b4';
        t.parentNode.insertBefore(s, t);
    })();
</script>

Agora digamos que você queira adicionar outro gráfico na mesma página (talvez para alterar o símbolo selecionado, por exemplo). Aqui está como seria adicionar uma segunda instância do mesmo widget a uma única página:


<div id='my-custom-id' style='width:100%;height:100%;'></div>
<script>
    (function(){
        var t = document.getElementsByTagName('script')[0];
        var s = document.createElement('script'); s.async = true;
        s.src = 'https://widget.nfusionsolutions.com/widget/script/chart/1/32796899-2cc3-4454-ac51-2c95c78799af/c528ee05-722d-4762-a635-213197f7b8b4/my-custom-id';
        t.parentNode.insertBefore(s, t);
    })();
</script>

Observe como tudo é igual, exceto o ID do elemento DIV e o final do atributo src.

Como ter botões externos que manipulam o iframe
Para isso, você deve conectar os dois elementos, tanto o botão quanto o iframe, via javascript. Este tutorial usará o exemplo de criação de um botão que altera o símbolo selecionado de um gráfico. Primeiro, comece adicionando o ouvinte de evento desejado. Neste exemplo, como estamos usando um botão, adicionaríamos um evento click. Depois de adicionar o ouvinte de evento ao elemento de botão, crie uma função que irá manipular o iframe e chamá-lo de dentro do evento click. Agora, esta função será executada sempre que o botão for clicado. Em seguida, você precisará obter acesso ao elemento iframe. Depois de ter acesso, você poderá manipular seus atributos. Neste exemplo, estaremos manipulando o “src”. Depois de obter o src do iframe, você simplesmente precisa substituir ou substituir esse URL src pelo novo URL src desejado.
 
Por exemplo, um URL src de gráfico padrão se parece com este: “https://widget.nfusionsolutions.com/widget/chart/1/fya3e32-e870-adf20-a9f3-c88c636f7s8d/188e705d-23afa-45dd-fce21-09c8298af4f2”
 
Se você quiser alterar o símbolo quando o botão for clicado, o URL src ficaria assim: “https://widget.nfusionsolutions.com/widget/chart/1/fya3e32-e870-adf20-a9f3-c88c636f7s8d/188e705d- 23afa-45dd-fce21-09c8298af4f2?selecionado=prata”
 
Quando você substitui o URL src no javascript, o iframe do gráfico será atualizado e exibirá o novo URL src.
Abaixo está um exemplo de trecho de código usando jQuery para mudar o símbolo selecionado do gráfico para prata:
 
deixe botão = $('.sample-button'), widget = $('#188e705d-23afa-45dd-fce21-09c8298af4f2'); botão.click(changeSymbol()); function changeSymbol() { widget.children("iframe").attr("src", "https://widget.nfusionsolutions.com/widget/script/chart/1/6e98ae99-d878-43a2-81f0-a2528bd3d47e/5444e580 -e249-426f-b07f-d23c19049c08" + "?selecionado= prata"); }
Como redefinir a senha do catálogo de produtos

Se você está logado e deseja alterar sua senha:

Enquanto estiver logado no catálogo de produtos, navegue até o item de menu no canto superior direito da tela no menu de navegação e clique no item que exibe seu nome de usuário. Depois de clicar em seu nome de usuário, um menu suspenso aparecerá com quatro opções. Clique na segunda opção, “senha”. A partir daqui, você pode simplesmente criar uma nova senha. Insira a senha antiga do usuário especificado e, em seguida, insira a nova senha do usuário. Por último, confirme a nova senha para garantir que está correta. Depois de preencher todos os campos obrigatórios para redefinir sua senha, clique no botão enviar na parte inferior do formulário e ele enviará suas alterações. Sua nova senha entrará em vigor imediatamente.

Se você não está logado e esqueceu/perdeu sua senha:

Tente utilizar a funcionalidade de redefinição de senha. Na tela de login, clique em “não consigo acessar sua conta”, escolha a conta “profissional ou escolar” e preencha as instruções para iniciar uma redefinição de senha. Se você ainda não conseguir fazer login, entre em contato nossa equipe de suporte.

Como implementar widgets usando o script auxiliar de moeda

To implement your widgets using our currency helper there are two simple steps.
1. To ensure that the helper script is available before attempting to use it, you must add the following script within your header:


<script src="https://widgetcdn.nfusionsolutions.com/asset/static/1/common/1/js/currency-interop.min.js"></script>

2. Agora que o script está disponível para uso, você pode adicionar um widget à página usando um código semelhante ao seguinte:


<div id='YOUR-WIDGET-ID' style='width:100%;height:100%;'></div>
<script>
    (function(){
         nFSCurrencyHelper.init('YOUR-WIDGET-SCRIPT-SRC-URL');
     })();
</script>

Simply replace “YOUR-WIDGET-ID” in the above script with the ID that is in your widgets preview page script. Then similarily, replace the “YOUR-WIDGET-SCRIPT-SRC-URL” with the url being assigned to the s.src variable that is in your widgets preview page script.
This script is very similar to our default widget scripts, with the exception that you need to use the “nFSCurrencyHelper.init” function and pass the function the widget’s src.

Como fazer login no painel e no catálogo usando um provedor social terceirizado

Abra seu navegador da web e visite seu painel nFusion em https://dashboard.nfusionsolutions.com/ ou seu catálogo nFusion em https://nfusioncatalog.com/account/login?tenantalias={your_tenant_name}&scheme=AzureAdB2C. Se você ainda não estiver logado, será apresentada a página de login.

Ao entrar nas soluções nFusion Cloud, você pode aproveitar o poder de suas contas existentes do Google, Microsoft, Apple ou Facebook. Por exemplo, se o e-mail em que você recebeu o convite do Dashboard estiver vinculado a uma conta do Google ou Gmail, um simples clique no botão Google fará com que você seja autenticado rapidamente, facilitando o login!

Caso o seu endereço de e-mail não esteja associado a nenhum desses quatro provedores, existe uma opção alternativa. Basta clicar em “inscreva-se agora” na parte superior e você poderá criar facilmente uma nova conta usando seu endereço de e-mail, juntamente com uma senha de sua preferência. Isso permite que você crie uma nova conta com facilidade.

Como mudar para nova autorização de catálogo

Em um de nossos últimos lançamentos no Catálogo de Preços de Produtos, adicionamos um recurso SSO (Single Sign On) que permite que você faça login em seu Catálogo de Preços de Produtos e no Painel usando a mesma conta de usuário! Isso ajudará a agilizar o processo e minimizar o tempo gasto para fazer login em seus aplicativos nFusion!

To switch to this new way of Authentication, you need to navigate to the Users page of your nFusion Dashboard by visiting: https://dashboard.nfusionsolutions.com/en/pages/users

Aqui você verá uma tabela de usuários que atualmente têm acesso ao seu Catálogo de Produtos. Para adicionar seu registro de usuário a esta tabela, clique em “Adicionar usuário” na seção de usuários da página. Em seguida, insira seu nome e o endereço de e-mail no qual você recebeu o convite do nFusion Dashboard. Em “Função”, selecione a função que você gostaria de fornecer a esta conta de usuário. A função “Administrador” permite acesso de leitura e gravação a produtos, famílias de produtos, etc., enquanto a função “Vendas” é essencialmente uma visualização somente leitura do catálogo de produtos para aqueles usuários que precisam apenas de acesso de visualização aos produtos dentro do Catálogo . Depois que essas informações forem inseridas, clique em “Enviar” no canto inferior esquerdo da página.

O usuário que você acabou de adicionar agora pode fazer login no catálogo e você deverá ter recebido um e-mail para ajudá-lo a fazer isso. Para aceitar seu convite para ingressar no Catálogo de Produtos, navegue até https://nfusioncatalog.com/account/login?tenantalias={your_tenant_name}&scheme=AzureAdB2C. Aqui é onde você pode aproveitar o poder de suas contas existentes do Google, Microsoft, Apple ou Facebook. Por exemplo, se o e-mail em que você recebeu o convite do Dashboard estiver vinculado a uma conta do Google ou Gmail, um simples clique no botão Google fará com que você seja autenticado rapidamente, facilitando o login!

Agora que você está conectado usando sua nova conta de usuário que utiliza seu método de autenticação social pessoal, você não precisa mais fazer login no Painel usando o antigo administrador e/ou e-mails de vendas que foram fornecidos anteriormente a você.

Como instalar e configurar o aplicativo Shopify

To use the nFusion Shopify app, you must have an active subscription to the nFusion Product Pricing Catalog service. If you don’t yet have a subscription, please contact our sales team.

App Setup Instructions:

1. Install the App

  • From the Shopify App Store, install the nFusion Shopify App
  • Accept the requested permissions to complete installation.

2. Configure App Settings:

Once installed, open the nFusion app from your Shopify admin and configure the following settings:

  • Subdomínio do catálogo
  • Canal de vendas de catálogo
  • Chave de API do catálogo

You can retrieve your API Key and available Sales Channels from within your nFusion Dashboard.

3. Set Up Your Sales Channel

You can either use an existing sales channel or create a new one (e.g., “Website”) within the nFusion Dashboard. This sales channel determines which products are synced to Shopify.

To learn how to assign products to a sales channel, please see the Sales Channel Assignment Setup Guide.

Important: The SKU for each product in the nFusion Dashboard must exactly match the corresponding product SKU in Shopify. Mismatched SKUs will prevent price updates.

4. Complete the Integration

Once all settings are configured, email suporte@nfusionsolutions.com to finalize the integration.

Como instalar e configurar o plugin WordPress

To use the nFusion plugin with WordPress/WooCommerce, you must have an active subscription to the nFusion Product Pricing Catalog. Se você ainda não tem uma assinatura, por favor contact our sales team.

Plugin Setup Instructions:

1. Install and Activate the Plugin

2. Configure nFusion Settings

  • After activation, go to Settings → nFusion Settings in the WordPress toolbar.
  • Enter the required configuration details:
    • Subdomínio do catálogo
    • Canal de vendas de catálogo
    • Chave de API do catálogo

You can find this information in your nFusion Dashboard

3. Create or Select a Sales Channel

You can either use an existing sales channel or create a new one for this integration (e.g., “Website”) within the nFusion Dashboard.

To learn how to assign products to a sales channel, please see the Sales Channel Assignment Setup Guide.

Only products assigned to the selected sales channel will be eligible for automatic price updates.

4. Link WooCommerce Products to Catalog SKUs

  • In your WordPress admin, go to Products.
  • For each product you want to sync, open the Edit Product screen.
  • Find the WooCommerce product SKU field.
  • Enter the exact SKU as it appears in your nFusion Product Catalog.

Important: SKUs must match exactly between WooCommerce and the nFusion Catalog. Otherwise, price updates will not apply.

Once these steps are complete, your plugin should be fully integrated with the nFusion Product Pricing Catalog, and your WooCommerce products will begin receiving price updates automatically.

Como habilitar a reindexação de produtos para WordPress

Nosso plug-in de catálogo de produtos para WooCommerce permitirá automaticamente a reindexação de produtos se o plug-in Action Scheduler estiver instalado e ativo em seu site WordPress.

Agendador de ações:

O plugin Action Scheduler é uma fila de tarefas escalonável e rastreável para processamento em segundo plano de grandes filas de tarefas no WordPress. Projetado para distribuição em plug-ins do WordPress – não é necessário acesso ao servidor. O Action Scheduler é desenvolvido e mantido por Automático (os desenvolvedores do WordPress e WooCommerce) com um desenvolvimento inicial significativo concluído por Sem voo.

Como instalar e ativar:

  1. Baixe o arquivo .zip do mais recente versão estável
  2. Vou ao Plug-ins > Adicionar novo > Carregar tela de administração em seu site WordPress
  3. Selecione o arquivo que você acabou de baixar
  4. Clique em Instalar agora
  5. Clique em Ativar

Ou clone o repositório Git na pasta wp-content/plugins do seu site.

Uso:

Depois que o plug-in Action Scheduler for instalado, o plug-in do catálogo de produtos utilizará sua funcionalidade para reindexar de forma assíncrona seus produtos no WooCommerce.

Como configurar a integração do eBay

Abaixo está um processo passo a passo sobre como configurar a integração do eBay com o Catálogo de preços de produtos.

  1. Crie um canal de vendas que servirá para agrupar todos os produtos que deseja integrar ao eBay. Você pode pular esta etapa se já tiver um canal de vendas que gostaria de usar.
  2. Adicione qualquer produto que você deseja integrar ao eBay ao canal de vendas do eBay.
    1. Você pode adicionar produtos individualmente a um canal de vendas clicando no ícone de seta à esquerda do SKU de um produto na guia Produtos principal. Isso expandirá a linha e você poderá clicar na guia Canal de vendas e, em seguida, clicar no ícone de lápis (editar) para adicionar esse produto a um ou mais canais de vendas.
    2. Você pode adicionar todos os produtos a um canal de vendas clicando na navegação superior Configurações/Atributos e, em seguida, rolando para baixo até a seção Canal de vendas. A partir daqui, escolha o canal de vendas ao qual deseja adicionar todos os produtos e clique no botão Adicionar todos os produtos no lado direito.
  3. Clique na navegação superior Integração / eBay e vá para a guia eBay no catálogo. Vá para onde diz “Token de autenticação da API do eBay”. Existe um link “[Para emitir um novo token de autorização para sua integração com o eBay, clique aqui]”. Clique nesse link e emita um token para o Catálogo nFusion para permitir que ele atualize suas listagens do eBay.
  4. Clique no link que diz “[Para atualizar suas listagens do eBay manualmente antes do próximo intervalo programado, clique aqui]”. Você não precisa fazer isso sempre, pois ele será atualizado automaticamente assim que o trabalho de integração for agendado. Se você tiver alguma listagem de preço fixo ativa ou programada no eBay, ela deverá aparecer na tabela.
  5. Mapeie listagens do eBay para catalogar produtos. Para isso acesse cada linha da tabela, clique em editar, depois na coluna “Catálogo de Produto” selecione o SKU do produto a ser mapeado.
  6. Crie suas marcações de listagens no eBay. Se as marcações forem aplicadas às listagens do eBay, elas serão aplicadas à “pedida de varejo” desse produto no catálogo. Existem várias opções de preços de listagens do eBay:
    1. Aplique uma marcação ao canal de vendas usado para listagens do eBay. Isto aplicará uma marcação consistente a todas as listagens (ou seja, 10% acima da solicitação de varejo).
    2. Aplique marcação em cada linha da tabela de mapeamento de listagens do eBay. Isso permite que você especifique diferentes valores de marcação para cada listagem.
    3. Combine as opções a e b. As marcações do canal de vendas são aplicadas primeiro e, em seguida, as marcações do nível de mapeamento.
  7. Assim que sua configuração inicial for concluída, notifique a nFusion Solutions para que sua integração possa ser iniciada.
  8. Lembre-se de que à medida que você cria novas listagens ou que as listagens existentes expiram ou são renovadas (se o eBay criar um novo ID de listagem), você precisará executar a etapa de mapeamento novamente.

Algumas coisas a serem observadas durante este processo:

  • Somente listagens de preço fixo podem ser atualizadas no eBay
  • Listagens não podem ser criadas no eBay a partir do catálogo, apenas atualizadas
  • Apenas o campo de preço é atualizado no eBay
  • O catálogo não leva em consideração os níveis de estoque
  • Preços zero não são empurrados para o eBay, eles são ignorados
  • O trabalho de integração do eBay não pode ser executado com mais frequência do que a cada 10 minutos. (Isso ocorre devido às limitações impostas pela API do eBay)
  • Não oferece suporte a preços diferenciados
  • Suporta apenas instâncias de listagens do eBay nos EUA
Como configurar seu catálogo pela primeira vez

O Catálogo de preços de produtos (PPC) é uma calculadora de preços dinâmica e um painel de gerenciamento de preços de produtos que incorpora preços spot em tempo real, taxas de câmbio, peso unitário, margens de lucro inseridas pelo usuário e realiza cálculos sob demanda, que são integrados ao seu e- sistema de comércio via APIs. Nossa plataforma permite que você defina todos os preços de seus produtos exatamente como gostaria em seu painel de gerenciamento e, em seguida, extraia automaticamente esses preços dinâmicos em tempo real para seu site, aplicativo móvel, página de faturamento personalizada, ERP, etc. Catálogo de preços (PPC), você verá alguns produtos de demonstração já configurados. Você pode usar esses produtos de exemplo, modificá-los ou adicionar novos produtos conforme necessário. Você pode editar um produto para ajustar as margens e obter o preço exatamente como você precisa, aplicando valores em dólar ou % ou ambos. Você pode definir seu Ask (preços de venda) e também seu Bid (preços de compra) nesta mesma visualização. Tenha em mente que o SKU do produto (chave primária exclusiva por produto) e o Canal de Vendas são necessários para que os preços dos produtos sejam atualizados adequadamente em seu software de comércio eletrônico. Além disso, o Catálogo de Preços de Produtos (PPC) possui uma série de APIs que você pode acessar assim que estiver logado. No canto superior direito, abaixo do seu nome de usuário, há um menu suspenso que contém a documentação da API. Você também pode acessar seu token da API PPC neste menu suspenso.

Como mudar o nome da minha empresa

Envie uma solicitação para suporte@nfusionsolutions.com com o nome atual da empresa e o novo nome da empresa, incluindo o endereço, se alterado.

How to create a new sales channel

Follow these steps to create a new sales channel:

  1. Faça login em seu nFusion Dashboard.
  2. Navigate to the Products page.
  3. Click the “Product Actions” (hamburger menu) button in the top right.
  4. Select “View Product Attributes” from the pop-up menu.
  5. In the Product Attributes page, scroll to the Sales Channels section.
  6. Click the “+ Sales Channel” button.
  7. Enter a name for your sales channel and configure any desired markups.
  8. Click Save.

That’s it! You’ve successfully created a new sales channel. You can now begin assigning products to it using either individual edits or the bulk update method.

How to assign products to a sales channel

To get started, sign in to your nFusion Dashboard. From there, there are two ways to assign products to a sales channel:

Option 1: Add Products Individually

  1. Navigate to the Products page.
  2. Find the product you want to include.
  3. Click the edit (pencil) icon.
  4. Navigate to the Sales Channels tab.
  5. Select the desired sales channel and click Save.

Option 2: Add or Remove Products in Bulk

  1. Navigate to the Products page and click the “Product Actions” (hamburger menu) button.
  2. Select “View Product Attributes” from the pop-up menu.
  3. On the Product Attributes page, go to the Sales Channels section.
  4. From there, you can add or remove all products from a specific sales channel in bulk.
Práticas recomendadas de API

API Best Practices

Following these best practices will help you get the most reliable, secure, and efficient performance when working with nFusion APIs.

Use HTTPS

All API requests must be made over HTTPS, using TLS 1.2 or higher. Unsecured (HTTP) requests are not supported.

Authentication & Security

To access the nFusion APIs, you will be issued one or more API tokens, depending on your use case. These tokens are sensitive credentials and should be treated like passwords.

  • Never expose your API token in client-side code (e.g., JavaScript that runs in the browser), as it can be easily viewed and misused.
  • Instead, make API requests from your server-side code via a secure proxy. For example: https://yoursite.com/proxy/metals/spot
  • Your server can securely call the nFusion API using the token, keeping it hidden from public access.
  • Implement caching in your proxy to avoid sending a new request to nFusion for every client request. This improves performance and helps prevent hitting rate limits.
Rate Limits

To avoid throttling, limit your request rate:

  • Keep API calls under 1 call per second per service.
  • If rate limits are exceeded, you may receive a 403 Forbidden response with substatus 502.
Optimize API Efficiency

Reduce unnecessary API traffic by consolidating requests using supported query parameters.

Example: Good Practice

Em vez de fazer estas 2 chamadas:

Currencies/summary?pairs=CAD/USD
Currencies/summary?pairs=USD/CAD

Make a single call:

Currencies/summary?pairs=CAD/USD,USD/CAD

Another Example:

Instead of making 8 separate metal price calls by currency and metals:

Metals/spot/summary?currency=USD&metals=gold
Metals/spot/summary?currency=USD&metals=silver
Metals/spot/summary?currency=USD&metals=platinum
Metals/spot/summary?currency=USD&metals=palladium
Metals/spot/summary?currency=CAD&metals=gold
Metals/spot/summary?currency=CAD&metals=silver
Metals/spot/summary?currency=CAD&metals=platinum
Metals/spot/summary?currency=CAD&metals=palladium

Make one efficient request:

Metals/spot/summary?currency=USD,CAD&metals=gold,silver,platinum,palladium

Recommended HTTP Headers

Alguns dos seguintes cabeçalhos HTTP devem ser adicionados às suas solicitações de API, dependendo dos seus casos de uso.

Aceitar

O valor recomendado para este cabeçalho é “application/json”. Se preferir resultados XML, você pode especificar “application/xml”, mas recomendamos JSON para a maioria dos casos de uso.

Aceitar-codificação

O valor recomendado para este cabeçalho é “deflate,gzip”. Isso resultará em resultados compactados que geralmente apresentam melhor desempenho.

Tipo de conteúdo

Para operações POST/PUT que requerem um corpo de mensagem, este cabeçalho deve ser definido como “application/json”.

Agente de usuário

We recommend setting this to a unique value, such as your tenant ID or tenant alias/catalog subdomain, to allow for easier searching in logs if needed.

Documentação Adicional
Práticas recomendadas de CSS da nFusion

Use seletores nFusion:

Certifique-se de que os seletores que você está usando sejam os mais específicos possíveis. Isso reduzirá a probabilidade de seu CSS não substituir o CSS padrão.

Para encontrar o melhor seletor a ser usado ao estilizar seus widgets, use o Developer Console para inspecionar os elementos do widget e visualizar as regras CSS que estão sendo aplicadas a ele no momento. Isso lhe dará uma melhor compreensão de qual CSS você deve adicionar e onde.

Por exemplo, o widget de gráfico aplica uma família de fontes padrão usando um seletor de alto nível “.nfusionsolutions-com-chart” assim:

.nfusionsolutions-com-chart {

    família de fontes: 'Lora', serif;

}

Para substituir o padrão, você usaria o mesmo seletor e atribuiria a propriedade da família de fontes ao valor da família de fontes desejado.

.nfusionsolutions-com-chart {

    família de fontes: {minha-fonte personalizada}, serif;

}

Outras práticas recomendadas:

  • Use ferramentas e linters para ajudar a evitar que erros não sejam detectados e façam com que seu CSS não funcione corretamente. Existem várias ferramentas e linters como Stylelint e CSSLint que podem ajudá-lo a identificar e corrigir problemas relacionados às práticas recomendadas de CSS em seu código.
  • Você pode usar métodos como BEM (Block-Element-Modifier) ou SMACSS (Scalable and Modular Architecture for CSS) para estruturar seu CSS. Além disso, agrupar estilos relacionados e usar comentários para documentação pode ajudar a melhorar a organização do código

Se você é novo no CSS, poderá encontrar vários tutoriais e artigos on-line sobre as práticas recomendadas de CSS. Sites, blogs e fóruns como MDN Web Docs, CSS-Tricks e Stack Overflow são excelentes lugares para começar.

Moedas, metais, índices e benchmarks suportados

Para ver suportado: 

Moedas: Visite nosso Documentação da API em Moedas e veja os endpoints onde o caminho termina em “suportado”

Metais: Visite nosso Documentação da API em Metais e veja os pontos finais onde o caminho termina em “suportado”

Índices: Visite nosso Documentação da API em Moedas e veja os endpoints onde o caminho termina em “suportado”

Referências: Visite nosso Documentação da API em Metais e visualize os pontos finais onde o caminho contém “benchmark”

Tipos de widget, opções de configuração suportadas e parâmetros de consulta

Configurações são valores padrão que podem ser alterados e se tornarem o novo padrão para esse widget. Parâmetros de string de consulta são valores que substituem os valores padrão do widget por instância do widget. Por exemplo, você pode usar o mesmo gráfico várias vezes, sendo cada instância diferente devido a parâmetros de string de consulta. Digamos que a moeda padrão nos widgets configurações está definido como USD. Ao adicionar um parâmetro de string de consulta para um dos URLs src das instâncias do gráfico, podemos substituir a moeda por algo diferente apenas para essa instância do gráfico.

Configurações padrão:

  • Moeda: Altera a moeda padrão a ser exibida.
  • Unidade de medida: altera a unidade de medida padrão a ser exibida.
  • Atualização automática: pode ser ativada ou desativada (ativada por padrão).
  • Intervalo de Atualização: Altera o intervalo em que o widget atualiza os preços.
  • Link: quando um usuário clica na área do widget, ele é redirecionado para o URL fornecido
  • Fuso horário: altera o fuso horário padrão a ser exibido.
  • URL(s) da lista de permissões: controla em quais URLs o widget pode ser exibido.

Operações/parâmetros de string de consulta padrão:

  • Símbolos (?symbols): altera os símbolos que preenchem o widget. Esta operação também tem a capacidade de reorganizar a ordem em que os símbolos são exibidos.
  • Moeda (?moeda): altera a moeda em que os preços são exibidos.
  • Unidade de Medida (?unitofmeasure): Altera a unidade de medida em que os preços são exibidos.
  • Largura (?largura): altera a largura do iframe do widget.
  • Altura (?altura): altera a altura do iframe do widget.

Gráficos:

Dentro dos nossos widgets gráficos, existem duas versões principais, V1 e V2. A única diferença entre estas duas versões é o layout dos elementos do gráfico. No que diz respeito à funcionalidade, ambos os gráficos são capazes de realizar as mesmas tarefas. Dito isto, ambas as versões podem suportar as seguintes configurações e operações de string de consulta:

Configurações:

  • Exibir barra de navegação: esta opção permite exibir ou ocultar a barra de navegação na parte inferior do gráfico. (exibido por padrão)

Operações/parâmetros de string de consulta:

  • Símbolo Selecionado (?selected=): Altera o símbolo que o gráfico exibe inicialmente.
  • Período selecionado (?timeframeindex=): altera o período que o gráfico exibe inicialmente.
  • Tipo de gráfico (?charttype=): altera o estilo da linha representada graficamente na área do gráfico.
  •  

Use esta demonstração interativa do nosso gráfico V1 para entender melhor como funcionam os parâmetros da string de consulta:

Tabelas:

Dentro de nossos widgets de tabela, existem seis versões, V1 (padrão), V2 (carrossel), V3 (Tabela de Desempenho Histórico), V4 (Tabela de Desempenho Histórico Anual), V5 (Tabela Multi-Unit) e V6 (Multi-Unit Multi -Tabela de moedas).

V1 e V2:

Semelhante aos gráficos V1 e V2, a única diferença entre as tabelas V1 e V2 é o estilo e a posição dos elementos da tabela.

Configurações:

  • Campos da Tabela: Exibe o(s) campo(s) selecionado(s)
    • Perguntar
    • Oferta
    • Mudar
    • Porcentagem de alteração
    • Alto
    • Baixo
    • Pr. Fechar
    • Abrir
    • Durar

Parâmetros de string de consulta: Suporta os parâmetros padrão.

V3 (Tabela de Desempenho Histórico):

Nossa tabela da versão três é uma tabela de desempenho histórico que exibe dados históricos para um único símbolo selecionado em um dia, uma semana, um mês, seis meses, um ano, cinco anos, dez anos e quinze anos. Configurações:

  • Campos da Tabela: Exibe o(s) campo(s) selecionado(s)
    • Perguntar
    • Oferta
    • Mudar
    • Alto
    • Baixo

Parâmetros de string de consulta: Suporta os parâmetros padrão.

V4 (Tabela Anual de Desempenho Histórico):

Nossa tabela da versão quatro exibe pontos históricos de dados percentuais de solicitação e alteração para diversas moedas em intervalos de um ano até quarenta anos.

Configurações: Suporta os parâmetros padrão.

Parâmetros de string de consulta:

  • Anos (?years=): Isso permite determinar quantos anos de dados devem ser exibidos
  • Moeda (?currency=): Uma lista de moedas separadas por vírgulas permite selecionar várias moedas para os dados serem apresentados

V5 (tabela multiunidades):

Nossa tabela da versão cinco exibe preços spot em tempo real para um único metal em múltiplas unidades de medida.

Configurações:

  • Campos da Tabela: Exibe o(s) campo(s) selecionado(s)
    • Perguntar
    • Oferta
    • Mudar
    • Porcentagem de alteração
    • Alto
    • Baixo
    • Pr. Fechar

Parâmetros de string de consulta:

  • Unidade de medida (?unitofmeasure=): Uma lista de unidades de medida separadas por vírgula permite selecionar várias unidades de medida para os dados a serem apresentados em

V6 (Tabela Multi-Unidade e Multi-Moeda):

Nossa tabela da versão seis exibe preços spot em tempo real para vários metais em diversas moedas e diversas unidades de medida.

Configurações: Suporta os parâmetros padrão.

Parâmetros de string de consulta:

  • Unidade de medida (?unitofmeasure=): Uma lista de unidades de medida separadas por vírgula permite selecionar várias unidades de medida para os dados a serem apresentados em
  • Moeda (?currency=): Uma lista de moedas separadas por vírgulas permite selecionar várias moedas para os dados serem apresentados

Relógio:

Nosso ticker de preço spot exibe pontos de dados em tempo real em um design responsivo semelhante a um banner.

Configurações:

  • Rolagem (padrão): Esta opção define o ticker para rolar continuamente da esquerda para a direita
  • Corrigido: esta opção remove o efeito de rolagem e exibe os elementos do ticker em um layout responsivo para dispositivos móveis.
  • Campos de ticker: exibe o(s) campo(s) selecionado(s)
    • Perguntar
    • Oferta
    • Mudar
    • Porcentagem de alteração
    • Alto
    • Baixo
    • Pr. Fechar

Parâmetros de string de consulta: Suporta os parâmetros padrão.

Calculadora RMD:

Nossa calculadora RMD (distribuição mínima obrigatória) permite que os usuários visualizem seu RMD estimado por meio de um gráfico amigável com base nas informações inseridas, como idade, saldo da conta, se há ou não um beneficiário principal e taxa de retorno estimada.

Página do produto:

Nosso widget de página de produtos utiliza o catálogo de produtos e seus recursos, incluindo canais de vendas e famílias de produtos, para criar uma exibição de página inteira com lances ao vivo e preços solicitados para os produtos desejados.

Página do widget:

Nossa página de widget permite que você utilize totalmente todos os recursos de nossos widgets de gráfico, tabela e ticker, encapsulando vários widgets em um único layout de página. Na página do widget, o usuário tem a capacidade de alterar o símbolo, a moeda e a unidade de medida de cada instância do widget na página, tudo ao mesmo tempo.

Vamos nos conectar

Saiba como podemos ajudar

Se você precisar de suporte técnico ou tiver alguma dúvida, preencha o formulário abaixo ou clique no botão para ligar. Nosso horário de suporte é De segunda a sexta, das 8h às 17h CST.

Nome(Obrigatório)
Área de suporte (obrigatório)

Deixe-nos ajudar você a expandir seus negócios

Quando se trata de qualidade, funcionalidade, personalização e serviço, nossas soluções de software bullion são inigualáveis. Deixe-nos ajudar você a expandir seus negócios.