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ção | O que conferir |
|---|---|
| Não consigo conectar | Client ID, secret, URL HTTPS exata e permissões no Olist. Não compartilhe o segredo. |
| A conta pede nova autorização | Use Reconectar Olist; token expirado, autorização revogada ou permissões alteradas podem exigir novo consentimento. |
| Um recurso falha ou não aparece | Confira 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 mudaram | Confira a operação ativada, execução, vínculos e a origem configurada para cada campo. |
| Cliente não foi vinculado | Confira CPF/CNPJ e se o identificador é único para a empresa. |
| Pedido não pode ser enviado | Confira aprovação, elegibilidade, vínculos de cliente/produtos e pendências do pedido. |
| Envio ficou incerto | Consulte o pedido no Portal e no Olist antes de repetir; não envie às cegas. |
| Consulta financeira indisponível | Confira 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.
