Marketplaces via Olist

O Olist é um serviço pago e fechado — e o Liber conversa com ele assim mesmo. A venda do Mercado Livre desce com canal, cliente e nota fiscal; o estoque da prateleira sobe; e o livro-razão continua sendo o seu. O Olist é um adaptador: se um dia sair, a integração sai com ele e os seus dados ficam.

Como ligo a integração?

É uma conta por empresa: cada selo com a sua conta Olist, cada conta apontando para uma empresa do sistema. E a cerca vale nos dois sentidos — quem é de uma empresa só vê a conta, o catálogo e os pedidos dela; o Olist do selo vizinho nem aparece.

1. No Olist, em Extensões‣Token API, gere o token da API v2.
2. Aqui, em Olist‣Configurações‣Contas, crie a conta: nome, empresa e o token. A empresa precisa ter CNPJ preenchido — é ele que prova que cada nota importada é dela.
3. Use os botões da conta na primeira vez: Ler catálogo, Ler pedidos, Ler notas fiscais. Depois, os agendamentos mantêm tudo fresco sozinhos — os pedidos e os detalhes, de duas em duas horas.

O estoque, lado a lado

Em Olist‣Estoque, cada livro mostra três números: o saldo que o Olist oferece, o estoque do armazém aqui, e o que seria enviado — o armazém, menos o que está reservado por entregas abertas (o pacote que espera coleta ainda conta no armazém, mas tem dono), menos a margem de segurança. A lista ordena pela divergência — o trabalho começa por onde a diferença é maior.

O número que sobe é o estoque do armazém, não o "Em mãos" — o que já está numa caixa fechada com etiqueta de outro cliente não se oferece num marketplace. E a Margem de segurança da conta desconta os últimos exemplares: a contagem erra, e vender o último de um número talvez errado é o que vira cancelamento.

É o mesmo livro?

Em Olist‣Produtos mora o espelho do catálogo de lá: nome, preço, ISBN e a ficha completa. O casamento com o seu catálogo é por ISBN e acontece sozinho. O que não casa — reedição com ISBN novo de um lado e cadastro antigo do outro é o caso comum — se resolve nesta tela:

O caminho inverso também existe: Olist‣Fora do Olist lista os livros do seu catálogo que ainda não estão à venda lá.

O canal de lá, o canal da casa

O Olist diz de onde veio cada pedido — "Mercado Livre", o nome da loja própria. Esse nome é deles; o canal de venda que os seus relatórios usam é seu. Em Olist‣Configurações‣Canais do Olist, cada nome descoberto nos pedidos aparece como uma linha, e a casa escolhe a qual canal de venda ele corresponde. A linha amarela é a que falta mapear — pedido que chega por ela entra sem canal até alguém decidir.

Quanto vendemos por dia — e de quê?

Em Olist‣Relatório (logo antes das Configurações), as vendas viram gráfico: uma barra por dia, empilhada por canal, nos últimos 30 dias — cancelados fora. Ele nasce das linhas dos pedidos e mede quatro coisas — Quantidade (exemplares), Valor bruto, Desconto e Valor líquido, sempre mercadoria, sem o frete — e agrupa por livro: o botão Medidas troca a régua, e o pivô mostra as colunas lado a lado, cruzadas por data, canal ou título. No agrupamento por livro, cada linha usa o rótulo curto — ISBN · título cortado… — para a tabela caber na tela; o ISBN na frente garante que dois títulos parecidos nunca se somem numa linha só.

A diferença entre bruto e líquido é o que a casa deu: cupom, brinde, promoção do marketplace. O Olist concede o desconto no pedido e não diz de qual livro ele saiu — o Relatório o rateia pelo peso de cada linha, então somado por data, canal ou mês o número é exato, e livro a livro é a melhor aproximação que o dado permite. O líquido é o faturamento da mercadoria, não o dinheiro em conta: o frete que o comprador pagou e a comissão retida no repasse ficam de fora dos dois lados.

A venda desce pronta

Em Olist‣Pedidos, a lista traz os pedidos de lá com situação, valor e rastreio. O canal e os itens vêm num segundo passo — Ler detalhe — porque custam uma consulta por pedido; o agendamento faz isso aos poucos, e a conta mostra a cobertura ("47 de 978 lidos").

São duas telas, duas naturezas. Olist‣Despachar é a fila da equipe, com um botão único — Despachar. Na política padrão, só o que tem nota emitida entra: a caixa viaja com a DANFE, e o pedido sem nota espera o Olist faturar. Em Definições‣Olist‣Despachar pedidos do Olist a casa pode escolher Com ou sem nota: o pedido entra na fila assim que chega, e a fatura o alcança sozinha quando a nota vier — até se a entrega já tiver sido validada. Um clique registra o negócio e entrega o trabalho: a venda confirmada, a fatura do XML e o recebimento no diário, e a entrega Pronta na caixa Marketplaces (série MP/OUT/, um cartão próprio na visão geral do Inventário, com o XML da nota no clipe), reservando o exemplar. É o clique da equipe — embalou, validou — que baixa a prateleira. Já Olist‣Pedidos é a auditoria: o espelho completo, com todos os estados, filtros e os botões de leitura — abre sem filtro nenhum, mostrando tudo. E o histórico que não interessa se põe de lado sem apagar: selecione e Ações‣Arquivar — o arquivado some da fila, dos contadores e do Relatório, e o filtro Arquivados o traz de volta quando quiser.

O pacote é da casa: a entrega Pronta na caixa Marketplaces é a fila de embalagem, a etiqueta em PDF vem do painel do Olist, e validar a entrega é o que baixa a prateleira. Se o Olist marcar o pedido Entregue antes de alguém validar, a entrega se conclui sozinha — o mundo confirmando vale por um clique. Na lista geral de entregas, o filtro Do Olist separa essas saídas do resto da expedição. E o estoque oferecido ao marketplace desconta o que está reservado por outras saídas abertas (uma remessa de consignação em separação, por exemplo): exemplar com dono não se oferece de novo.

Importar para o Odoo é o ato que traz o pedido para dentro, por linhas escolhidas — e ele traz a nota junto: a fatura nasce do XML que a SEFAZ autorizou, não do que o pedido diz. Quando os dois divergem (frete, desconto), a diferença fica à vista em vez de silenciosa.

Duas escolhas governam o efeito do pedido importado — uma da conta, uma das Definições:

Quem faz isto? O comercial — Assistente e Gerente — atualiza a lista de pedidos, lê o detalhe, mapeia canais e despacha. A ficha da conta é outra coisa e continua da administração: é lá que moram o token da API e a trava Somente leitura, que impede o sistema de escrever no Olist de verdade — decisão de configuração, não de operação.

Quando algo não sai como esperado

O que não fazer

• Não desligue o "Somente leitura" para testar. Não existe conta de homologação no Olist: toda escrita é na conta que vende. Teste lendo — é para isso que a trava existe.
• Não crie produto para todo ISBN que não casa. Metade do que parece faltar é livro que já existe com outro ISBN (reedição). Olhe a sugestão e case; criar sem olhar duplica o catálogo da editora.
• Não lance o recebimento na conta bancária. O dinheiro está com o Olist até o repasse cair. Diário próprio do marketplace — é ele que deixa as taxas visíveis.

Glossário

Todo documento do sistema carrega um prefixo na numeração — CO/2026/00001 é um acerto, AT/2026/00042 é um chamado. A lista é a mesma em todos os manuais:

Bases antigas guardam transferências nas séries COM/ e RET/, de antes da separação por direção — o histórico não é renumerado.