Olist — conectar, pedidos, estoque e nota fiscal

Ao final deste guia sua loja vai estar ligada ao Olist (o antigo Tiny): o pedido pago vira venda lá sozinho, o estoque fica igual nos dois lados e a nota fiscal sai pelo Olist.

O Olist é um sistema de gestão: emite nota, controla estoque e financeiro. A tela da integração é a mesma do Bling, em abas, com o que o Olist tem.

Onde fica: menu Integrações → Olist.

Antes de começar

Você precisa de	Por quê
Uma loja na Operizy	A conexão liga o Olist a uma loja que já existe. Ainda não tem? Crie a sua
Uma conta do Olist ativa, com acesso de administrador	É quem cria o aplicativo e autoriza a Operizy
Não ter o Bling conectado	Cada loja usa um sistema de gestão só. Dois disputariam o mesmo estoque e a mesma numeração de nota
O mesmo SKU nos dois lados	O produto da loja e o do Olist se encontram pelo código (SKU). `CAM-PRETA-P` aqui e `1234` lá não se ligam

Como conectar

No Olist, quem integra cria um aplicativo na própria conta: é a regra da API do Olist. Você faz isso uma vez; leva uns 5 minutos.

Crie o aplicativo no Olist: Menu → Configurações → aba Geral → Aplicativos → Novo aplicativo. Dê um nome, como "Operizy".
Cole o endereço de retorno. A tela de conectar da Operizy mostra o endereço exato; cole no campo de redirecionamento do aplicativo.
Traga as chaves. Ao salvar, o Olist mostra o Client ID (começa com tiny-api-) e o Client Secret. Cole os dois na Operizy e clique em Conectar com o Olist.
Você vai ao Olist, autoriza o aplicativo e volta para a Operizy com o Olist conectado. O topo da tela mostra o nome e o CNPJ da sua conta.

As chaves ficam guardadas cifradas e só servem para a sua loja. Desconectar não as apaga: para reconectar, é só clicar em Conectar de novo (o segredo nunca volta para a tela).

Depois de conectar

A Visão geral mostra o que falta, cada item com o botão que resolve.

Passo	Onde	O que fazer
1. Ligar os depósitos	aba Depósitos	Clique em Atualizar lista do Olist e ligue cada centro de estoque da loja a um depósito do Olist. É de onde sai a baixa de cada venda
2. Cadastrar os avisos	aba Avisos	Copie o endereço e cole no app Webhooks do Olist (veja abaixo). Sem ele, o que muda no Olist não chega à loja
3. Escolher quem manda	aba Preferências	No estoque e na situação dos pedidos. Dá para mudar quando quiser

A tela

Uma tela só, em abas: Visão geral · Produtos · Pedidos · Depósitos · Preferências · Histórico · Avisos.

No topo, "Conectado e respondendo" quer dizer que o Olist está de fato aceitando a conexão. Quando não está, aparece desde quando e o botão Reconectar. A conexão se renova sozinha.

No celular a tela é a mesma, com as abas em botões que rolam de lado.

Avisos: o que muda no Olist chega à loja

O Olist conta à loja o que mudou lá (o estoque de um produto, a situação de um pedido) por avisos. Para isso:

No Olist, instale o app Webhooks (ele só aparece em alguns planos do Olist).
Em Configurações → Geral → Outras configurações → Webhooks, cole o endereço da aba Avisos nos avisos de lançamentos de estoque e de vendas.
Mude o estoque de um produto ligado pela tela do Olist e confira: o aviso aparece na lista da aba Avisos em instantes.

O endereço é só da sua loja: a parte depois de token= é a palavra secreta que prova que o aviso veio do seu Olist. Não compartilhe.
A aba mostra o último aviso, quantos chegaram e quantos foram recusados nos últimos 7 dias.
Enquanto nenhum aviso chega, a Visão geral avisa.
Integração desconectada: o aviso é recebido mas não mexe em nada (nem estoque, nem pedido).

Produtos

A aba Produtos mostra os dois lados numa lista só:

Situação	Quer dizer
Ligado	O produto da loja e o do Olist conversam
Par sugerido	O mesmo SKU nos dois lados, ainda não ligados
Só na loja / Só no Olist	Existe de um lado só
Sumiu do Olist	Estava ligado a um produto que foi apagado ou inativado no Olist
Não chegou	O Olist recusou o envio — a mensagem dele aparece na linha

Ligar os dois (na linha) ou Ligar os pares pelo SKU (a lista inteira): a loja vale, e o produto vai ao Olist.
Enviar ao Olist: pela linha, marcando vários ou "Enviar os que estão só na loja". Vai um de cada vez, dentro do limite de chamadas do Olist; o andamento aparece no topo da lista.
Desligar não apaga nada: o produto continua nos dois lados, só deixa de conversar.
Salvar um produto na loja também manda ao Olist (o ligado e o de mesmo SKU).
Produto com variações (cor, tamanho…) vai como produto com variações no Olist: cada variação com o seu SKU, o seu preço e o seu estoque.
O que você mudar no cadastro do produto no Olist não volta para a loja: o cadastro vale o da loja.
Ainda não dá para trazer um produto que só existe no Olist para a loja. Cadastre-o na loja com o mesmo SKU e ligue os dois.
A lista do Olist é uma cópia que a Operizy guarda: ela se atualiza ao conectar, toda madrugada e quando você clica em Atualizar do Olist. O Olist não informa o estoque na listagem, então a coluna do Olist mostra o preço sem o saldo.

Estoque: um dono só

Em Preferências → Estoque — quem manda? você escolhe:

Escolha	O que acontece
O Olist manda (recomendado)	Cada venda paga dá baixa no Olist; o cancelamento devolve. O saldo do Olist volta para a loja pelos avisos. Ajuste o estoque no Olist
A loja manda	Toda mudança de estoque da loja (venda, ajuste, planilha) vai ao Olist. Mudança feita no Olist não volta
Não sincronizar	Nenhum lado mexe no estoque do outro

A venda baixa no depósito ligado ao centro de onde ela sai. Centro sem depósito ligado: a venda vai sem depósito e o Olist usa o padrão da conta.
Com o Olist no comando, o saldo só volta se os avisos estiverem cadastrados (aba Avisos).

Pedidos

O pedido vai ao Olist quando o pagamento é confirmado, não ao ser criado. Pix e boleto só aparecem lá depois de pagos. A venda nasce como Aprovada.
Pedido que sai de dois centros vira duas vendas no Olist, cada uma com os itens que saem daquele lugar. Não é duplicado: cada envio tem a sua nota.
A venda leva o que o cliente pagou: o desconto e o frete (divididos entre as vendas pelo valor de cada envio; somando, bate) e a forma de pagamento: a forma ativa da sua conta do mesmo tipo em que o cliente pagou (Pix, cartão, boleto). Se a sua conta não usa aquela forma, a venda vai sem forma e o Olist usa a padrão.
O comprador que já é contato no Olist não é cadastrado de novo: a Operizy procura pelo CPF/CNPJ antes.
Venda de balcão (PDV) sem CPF não vai ao Olist: o Olist exige o documento do comprador. Ela aparece na aba Pedidos com o motivo.

Situação do pedido

Em Preferências → Situação dos pedidos — quem manda?: os dois conversam (padrão), a Operizy manda, o Olist manda ou não sincronizar.

Na Operizy	No Olist
confirmado	Aprovada
em separação	Preparando Envio
faturado	Faturada
despachado	Enviada
entregue	Entregue
cancelado	Cancelada

No sentido contrário (pelos avisos de vendas), "Pronto Envio" vira faturado e "Em Devolução" não muda o pedido: a devolução segue pelo fluxo de trocas da Operizy. Quando o Olist manda o código de rastreio junto, ele fica no pedido.

Pedido que não chegou ao Olist

A aba Pedidos lista cada pedido pago que não chegou, com o motivo (falta CPF/CNPJ, produto não ligado, o Olist recusou, o Olist não respondeu) e o botão Reenviar. Reenviar não duplica.

Nota fiscal

A Operizy manda o pedido; quem emite a nota é o Olist, com os seus dados fiscais e o seu certificado digital. A configuração fiscal é lá.

Fale com sua contabilidade antes da primeira nota.

Quando a nota sai: em Configurações → Notas fiscais, automática (no pagamento ou no despacho) ou à mão pelo pedido.
Nota esperando a SEFAZ fica em "Aguardando", não em "Com problema". Em Vendas → Notas Fiscais, o menu da nota tem Consultar de novo no Olist, que traz a situação de agora.
Recusada, o motivo aparece em frase. Nota recusada não segura o pedido: o despacho segue.
Cancelar a nota é no Olist. A Operizy só mostra "cancelada" quando o Olist diz que a nota foi cancelada.

Quando algo não bate

Sintoma	Onde olhar
Pedido não apareceu no Olist	Foi pago? Se sim, a aba Pedidos diz o motivo
Estoque diferente nos dois	Quem manda no estoque (Preferências), se o centro está ligado a um depósito e se os avisos estão chegando (aba Avisos)
Mudei no Olist e não veio	Aba Avisos: o aviso chegou? Foi aplicado?
Nota não saiu	Vendas → Notas Fiscais, abas Com problema, Aguardando ou Pedidos sem nota
"O Olist não está respondendo"	Clique em Reconectar no topo da tela
O que a loja e o Olist conversaram	Aba Histórico

Suporte

Não achou a resposta aqui? Fale com a gente pelo chat do painel (o balão no topo da tela) ou por [email protected]. Diga o número do pedido ou o SKU do produto: ajuda a achar o caso mais rápido.