GUIA DE CONFIGURAÇÃO · ERP

Logo do Olist ERPERP · antigo Tiny

Integração Olist ERP (Tiny) com o Portal B2B

Aprenda como integrar Olist ERP, antigo Tiny, à plataforma de e-commerce B2B Ascenfy e configurar os dados da sua operação.

Voltar ao catálogo de integrações ↗

1. Prepare sua conta Olist

Acesse o Olist ERP com permissão para gerenciar aplicativos. Confirme se o plano e os módulos da conta permitem usar a API v3 e as operações desejadas. Crie um aplicativo privado seguindo a documentação oficial de criação de aplicativo. O Olist pode exigir etapas adicionais de autorização ou homologação conforme a distribuição do aplicativo.

Habilite apenas as permissões necessárias: produtos e estoque para catálogo; contatos para vínculos de clientes; pedidos para envio; caixa, contas a receber e notas para consultas. Se alterar permissões depois, reconecte a conta no Portal B2B.

2. Cadastre a URL de retorno

No Portal B2B, acesse Integrações → ERPs nativos → Olist ERP. Na primeira etapa, copie a URL de retorno exibida e cadastre exatamente essa URL HTTPS no aplicativo Olist. Não use endereço de exemplo nem tente adivinhar a URL.

3. Salve as chaves e autorize

No aplicativo Olist, obtenha Client ID e Client secret. Informe-os apenas na tela autenticada do Portal B2B e selecione Salvar chaves. Depois, selecione Conectar Olist e conclua a autorização no Olist. Volte ao Portal e confira se a empresa aparece conectada. Se a autorização expirar ou for revogada, use Reconectar Olist.

As chaves e tokens ficam vinculados à empresa que configurou a integração. O site público da NYD nunca solicita esses valores.

4. Escolha o que o Olist controla

Na terceira etapa da configuração, ative somente as operações necessárias e salve as preferências:

  • Importar produtos: lê o catálogo Olist e o relaciona ao catálogo do Portal; produtos novos podem exigir revisão.
  • Importar estoque: atualiza saldo dos produtos vinculados quando Olist é definido como origem.
  • Vincular contatos: associa clientes existentes por CPF/CNPJ válido e único dentro da empresa.
  • Enviar pedidos aprovados: disponibiliza o envio ao ERP para pedidos elegíveis com clientes e produtos vinculados.
  • Envio automático: envia pedidos elegíveis após aprovação. Teste o envio manual antes; apenas um ERP pode receber pedidos automaticamente.
  • Consultar financeiro e notas: exibe resumos de caixa, contas a receber e notas em modo somente leitura, para usuários autorizados.

Defina também a origem dos dados do produto, preço comercial, estoque e visibilidade da loja: Portal B2B ou Olist ERP. Quando Olist é escolhido para um campo, a sincronização pode atualizá-lo no Portal. Revise preços, visibilidade e estoque antes da primeira importação.

5. Sincronize e confira os dados

Após salvar as preferências, use as ações de sincronização para produtos, estoque ou contatos. Acompanhe o resultado e as pendências mostradas. Uma autorização válida não garante que todos os módulos estejam disponíveis no plano da conta.

Comece com poucos dados ou uma conta de validação, quando disponível. Confira produtos, preços, visibilidade, saldos e vínculos de clientes antes de ampliar o uso.

6. Envie um pedido de teste

Com o envio habilitado, abra no painel um pedido elegível e use a ação de envio manual para Olist. O pedido precisa seguir o fluxo comercial do Portal e ter cliente e produtos vinculados. Confira o resultado e o identificador associado.

Se houver falha de comunicação e o resultado ficar incerto, use conferir no ERP e verifique o pedido no Olist antes de tentar novamente. Isso evita pedidos duplicados. Depois de validar manualmente, a empresa pode optar pelo envio automático. Desative o envio automático no Bling antes de ativá-lo no Olist.

Enviar um pedido ao ERP não confirma pagamento. Consultas de caixa, contas a receber ou notas não baixam valores, emitem documento fiscal nem alteram o estado do pedido no Portal.

Solução de problemas

SituaçãoO que conferir
Não consigo conectarClient ID, secret, URL HTTPS exata e permissões no Olist. Não compartilhe o segredo.
A conta pede nova autorizaçãoUse Reconectar Olist; token expirado, autorização revogada ou permissões alteradas podem exigir novo consentimento.
Um recurso falha ou não apareceConfira disponibilidade do módulo no plano e permissões do aplicativo; salve as preferências e autorize novamente após mudanças.
Produtos ou estoque não mudaramConfira a operação ativada, execução, vínculos e a origem configurada para cada campo.
Cliente não foi vinculadoConfira CPF/CNPJ e se o identificador é único para a empresa.
Pedido não pode ser enviadoConfira aprovação, elegibilidade, vínculos de cliente/produtos e pendências do pedido.
Envio ficou incertoConsulte o pedido no Portal e no Olist antes de repetir; não envie às cegas.
Consulta financeira indisponívelConfira a opção de consulta, permissão financeira do usuário e permissões do aplicativo.

Ao pedir suporte, informe a empresa, horário aproximado, operação, identificador do pedido (quando houver) e mensagem de erro sem dados sensíveis. Nunca inclua chaves ou tokens.

Dúvidas sobre Olist ERP e Tiny

O Tiny ERP agora é Olist ERP?

Sim. O guia se refere ao Olist ERP, anteriormente conhecido como Tiny. A conexão descrita usa o aplicativo e a API v3 do Olist ERP.

O que a integração do Olist com a NYD sincroniza?

Conforme permissões e configuração, pode importar produtos e estoque, vincular contatos, enviar pedidos elegíveis e consultar resumos financeiros e fiscais em modo somente leitura.

Preciso conectar o Olist para usar a plataforma B2B?

A integração Olist é uma opção para empresas que usam esse ERP. A operação da loja B2B não depende de conectar o Olist.

Onde informo as credenciais do aplicativo Olist?

Somente na área autenticada de integrações do Portal B2B. Nunca envie Client secret ou tokens pelo site público, e-mail ou chat.

Referências oficiais