A tela Referências Inválidas (acessível pelo menu em Ferramentas > Referências Inválidas ou /postbacks/referencias-sem-pacotes) lista todas as ofertas recebidas por postback que ainda não possuem um Pacote correspondente cadastrado no Paylog. O item fica no nível de Ferramentas, fora do submenu Integrações.
Você precisa da permissão Listar referências sem pacote para acessar e gerenciar esta fila.
Como funciona a fila de 15 dias
Quando uma plataforma de pagamento (como Hotmart, Monetizze, Braip, Yampi, Ticto, Perfect Pay, B4You, Payt ou YouShop) envia um postback aprovado, o Paylog inspeciona o código da oferta ou plano recebido.
Se esse código não estiver associado a nenhum pacote ativo no Paylog:
- O postback não é descartado;
- A transação entra na fila de Referências Inválidas;
- O registro permanece retido na fila por uma janela móvel de 15 dias corridos;
- No topo da página, os cartões exibem os totais: Total de Referências, Ofertas Desativadas, Referências Deletadas e Ofertas Não Encontradas.
A coluna Motivo da tabela explica por que a oferta caiu na fila:
| Motivo | O que aconteceu |
|---|---|
| Oferta não Encontrada | O código recebido não corresponde a nenhuma referência cadastrada em um pacote seu. |
| Oferta Desativada | Existe um pacote para essa referência, mas ele não está ativo. |
| Referência Deletada | A referência existia e foi removida do pacote. |
| Pacote sem Embalagem | A referência está mapeada, mas o pacote não tem embalagem cadastrada. Fale com o suporte — o botão Resolver fica desabilitado até a embalagem existir. |
Use os filtros Produto, Plataforma de Pagamento e Código da Transação para localizar uma pendência específica; Limpar Filtros aparece quando há algum filtro ativo. O botão de informação de cada linha abre Detalhes da Referência, com todos os códigos de transação retidos naquela oferta.
Se o mapeamento não for realizado dentro do prazo de 15 dias, a oferta expira na fila. Nesses casos, após vincular a referência ao pacote, será necessário solicitar o reenvio do postback pela plataforma de pagamento ou recriar a transação.
Como mapear uma referência sem pacote
Para resolver as pendências e liberar o envio dos pedidos:
- Acesse Ferramentas > Referências Inválidas;
- Na tabela de pendências, localize o código da referência e a plataforma de origem;
- Na coluna Ações, clique no botão de link — a janela Mapear Oferta para Pacote se abre;
- Escolha como a oferta será atendida:
- Pacote existente: selecione um pacote ativo já cadastrado na sua conta;
- Composição: descreva a oferta como uma lista de
produto×quantidade. O Paylog cria o pacote a partir dessa composição e o nomeia com o nome da oferta;
- Confira os dados e salve o mapeamento.
Quando a referência já está mapeada para um pacote com embalagem, a linha mostra Mapeado → <pacote> e um botão Resolver aparece nas ações. Ele apenas limpa a pendência e reprocessa os postbacks retidos, sem criar um novo mapeamento.
Para aprender mais sobre as regras de nomenclatura e identificadores de cada plataforma, leia o guia Mapear pacotes com as plataformas.
Reprocessamento automático e comportamento de Retry
Assim que o vínculo entre a referência e o pacote interno é salvo:
- O Paylog ativa o mecanismo de retry automático;
- Todas as vendas retidas associadas àquela referência que deram entrada nos últimos 15 dias são reprocessadas imediatamente em segundo plano;
- Os pedidos são criados automaticamente na lista Meus Pedidos (
/pedido/todos) apontando para a composição física do pacote mapeado; - Não é necessário reenviar os postbacks manualmente na plataforma de pagamento para as vendas que estavam dentro da janela de 15 dias.
Diferença em relação às filas dedicadas de SKU
É importante não confundir a fila de Referências Inválidas com as filas específicas de mapeamento de SKUs de ERPs e marketplaces:
| Fila no Paylog | Tipo de integração | O que é mapeado | Onde resolver |
|---|---|---|---|
| Referências Inválidas | Checkout / Plataformas de pagamento (Hotmart, Braip, Monetizze, etc.) | Código da oferta ou plano (offer_code, plan_key, etc.) para um Pacote Paylog ou uma composição |
/postbacks/referencias-sem-pacotes |
| Fila de SKUs Bling (ERP) | ERP Bling Pedidos | SKU cadastrado no Bling para um Produto Paylog | Aba Mapeamento de SKUs dentro da integração Bling |
| Mapeamento TikTok Shop | Marketplace direto | sku_id do TikTok para um Produto ou Kit |
Aba Mapeamento na página do TikTok Shop |
| Mapeamento Mercado Livre | Marketplace direto | Anúncio e variação do ML para Pacote Existente, Criar Pacote ou Composição | Aba Mapeamento na página do Mercado Livre |
| Mapeamento SkaleTracking | Logística / Rastreamento | SKU do item individual enviado no postback SkaleTracking para um Produto Paylog | Aba Mapeamento na página da SkaleTracking |
Se o pedido vem de um checkout de pagamento tradicional, a pendência aparecerá em Referências Inválidas. Se vem de um ERP ou marketplace com integração própria, a pendência deve ser tratada na aba Mapeamento da própria integração.
Estado da fila limpa
Quando todas as referências forem mapeadas ou nenhuma transação sem pacote tiver dado entrada nos últimos 15 dias, a tela exibe Nenhuma oferta sem pacote encontrada:
