For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Pular para o conteúdo

Log de integração

Log de integração da Uplaces: veja o que o ERP e o gateway de pagamento enviaram, os pedidos que a loja enviou ao ERP e ache o erro.

O Log de integração guarda, por 12 meses, tudo o que o seu ERP e o gateway de pagamento enviaram para a loja e cada pedido que a loja enviou ao ERP, exatamente como chegou ou saiu. É a prova de que você precisa quando um estoque, uma baixa de boleto ou um pedido não bate. Fica em Integração ERP › Log de integração.

Antes de começar

  • Integração com o ERP conectada (Bling, Tiny ou Omie) ou gateway de pagamento configurado (Asaas).

  • O menu Integração ERP aparece para o administrador e para o diretor da loja.

1

Escolher o dia

No alto da tela, use as setas para ir ao dia anterior ou ao próximo, escolha uma data no calendário ou clique em Hoje. Dá para voltar até 12 meses. O log é separado por dia.

2

Escolher o sentido

Duas abas dividem o log:

Aba
O que mostra

Recebidos

os avisos (webhooks) que o ERP e o gateway de pagamento mandaram para a loja: mudança de estoque, de preço, de situação do pedido, pagamento confirmado

Enviados ao ERP

os pedidos que a loja enviou ao ERP, com a resposta que ele deu

Acima da lista, três indicadores resumem o dia: Mensagens no dia, Com erro (na aba Enviados ao ERP, Recusados ou com falha) e Última mensagem. Clique em Com erro para ver só as mensagens com problema. Se a integração costuma mandar mensagens e a hora da última está parada, vale conferir se o aviso continua cadastrado no ERP.

Em Integrações, cada ERP ou gateway aparece como um botão com a contagem do dia. Clique num deles para ver só as mensagens dele, e clique de novo para voltar a todas. O gráfico Por hora mostra o movimento de cada hora: clique numa barra para ver só aquela hora.

3

Procurar uma mensagem

No campo de busca, digite o que identifica o que você procura: SKU, ID do produto, evento, número da nota fiscal ou número do pedido. A busca olha o conteúdo da mensagem. Use De e até para limitar o horário e clique em Buscar. Limpar filtros volta ao dia inteiro.

Se o dia tem muitas mensagens, a lista carrega aos poucos: clique em Carregar mais. Numa busca, o botão passa a ser Continuar procurando nas mais antigas.

4

Ler a linha e abrir o JSON

Na aba Recebidos, as colunas são Hora, Integração, O que chegou, Status, Resposta e Ações. Na aba Enviados ao ERP, são Hora, Pedido, ERP, Resultado, Nº no ERP e Ações.

  • Status e resultado: nos enviados, o selo é Aceito ou Recusado. Nos recebidos, é o código da resposta que a loja deu.

  • Pedido: o número é um link que abre o pedido na Uplaces.

  • Nº no ERP: o número que o ERP deu ao pedido.

Clique em Ver JSON para abrir o detalhe da mensagem:

  • O que chegou (ou O que saiu para o ERP): o conteúdo, como foi recebido ou enviado.

  • Recebido em (ou Enviado em): data e hora, no horário de Brasília.

  • O que a loja respondeu (ou O que o ERP respondeu) e Erro, quando houver.

  • Impressão digital (SHA-256): identifica o conteúdo exato, útil para comparar com o que o suporte ou o ERP viu.

  • Baixar JSON salva o arquivo da mensagem, e Copiar copia o conteúdo para a área de transferência.

Mensagens antigas podem trazer o aviso Atenção: nelas, o conteúdo foi remontado pelo sistema, e não é o texto original.

5

O mesmo histórico, dentro do pedido

Na tela de um pedido, o botão JSON do ERP abre JSON do pedido com cada tentativa de envio ao ERP: o selo Aceito ou Recusado, a hora, o ERP e o número dele para o pedido. Clique em Ver para ler o que saiu e o que o ERP respondeu, ou em Baixar para salvar a tentativa. Baixar todas as tentativas reúne tudo. Se aparecer Nenhum envio deste pedido está guardado, o pedido ainda não foi enviado ao ERP.

O botão Simular com os dados de hoje mostra como o pedido seria montado agora. Pode sair diferente do que foi enviado: a prova do que o ERP recebeu são as tentativas.

Na lista de pedidos, a coluna Integração mostra o número do pedido no ERP e se foi em Produção ou Homologação. Quando houve erro, aparece um botão vermelho com o motivo.

Resultado

Você sabe, para cada pedido ou aviso, se chegou, quando, com que conteúdo e o que o outro lado respondeu.

Problemas comuns

O pedido não chegou ao ERP

Abra a aba Enviados ao ERP, busque o número do pedido e veja o selo. Recusado: leia o Erro em Ver JSON; o ERP costuma dizer o que faltou (cliente, vendedor, depósito, forma de pagamento). Não aparece no log: o pedido ainda não chegou ao status de Enviar para integração quando o status for, ou Integração ativa está desligada.

O estoque ou o preço não atualiza

Abra a aba Recebidos, busque o SKU e veja se o ERP mandou o aviso. Se nenhum aviso chegou, o endereço de webhook não está cadastrado no ERP ou o tipo de evento não está marcado. Se chegou com erro, leia a Resposta.

O pagamento foi aprovado e o pedido não mudou de status

Na aba Recebidos, filtre por Asaas e procure o aviso do pagamento. Sem aviso, confira o webhook no Asaas. Com aviso, confira Atualizar status do pedido quando o pagamento for aprovado.

A tela fica carregando ou diz que o arquivo não pôde ser aberto

Tente de novo em instantes. Se continuar, fale com o suporte da Uplaces e informe o dia e a hora.

Perguntas frequentes

Por quanto tempo o log guarda as mensagens?

Por 12 meses.

Posso mandar o JSON para o suporte do meu ERP?

Sim. Use Baixar JSON ou Copiar. Não envie o arquivo a quem não precisa dele: ele traz dados de clientes e pedidos.

Por que a hora é diferente da do meu computador?

O log mostra o horário de Brasília.

Veja também