> For the complete documentation index, see [llms.txt](https://ajuda.uplaces.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md).

# 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](https://ajuda.uplaces.com.br/integracoes/bling.md), [Tiny](https://ajuda.uplaces.com.br/integracoes/tiny.md) ou [Omie](https://ajuda.uplaces.com.br/integracoes/omie.md)) ou gateway de pagamento configurado ([Asaas](https://ajuda.uplaces.com.br/integracoes/asaas.md)).
* O menu **Integração ERP** aparece para o administrador e para o diretor da loja.

{% stepper %}
{% step %}

## 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.
{% endstep %}

{% step %}

## 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.
{% endstep %}

{% step %}

## 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**.
{% endstep %}

{% step %}

## 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.
{% endstep %}

{% step %}

## 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.
{% endstep %}
{% endstepper %}

## Resultado

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

## Problemas comuns

<details>

<summary>O pedido não chegou ao ERP</summary>

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.

</details>

<details>

<summary>O estoque ou o preço não atualiza</summary>

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**.

</details>

<details>

<summary>O pagamento foi aprovado e o pedido não mudou de status</summary>

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**.

</details>

<details>

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

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

</details>

## Perguntas frequentes

<details>

<summary>Por quanto tempo o log guarda as mensagens?</summary>

Por 12 meses.

</details>

<details>

<summary>Posso mandar o JSON para o suporte do meu ERP?</summary>

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

</details>

<details>

<summary>Por que a hora é diferente da do meu computador?</summary>

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

</details>

## Veja também

* [Integrações](https://ajuda.uplaces.com.br/integracoes/integracao-com-erp.md)
* [Importar do ERP](https://ajuda.uplaces.com.br/integracoes/importar-do-erp.md)
* [Pedidos da Uplaces no Tiny](https://ajuda.uplaces.com.br/integracoes/tiny/sincronizacao-de-pedidos-com-o-tiny.md)
