> For the complete documentation index, see [llms.txt](https://knowledge.out-smart.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.out-smart.com/outsmart-knowledge-base/outsmart-knowledge-base-pt/integracoes/integracoes/jortt/resolver-problemas-do-jortt.md).

# Resolver problemas do Jortt

Rever o registo de sincronização do Jortt e corrigir avarias comuns de ligação, importação e exportação.

## Resolver problemas do Jortt

Utilize o **painel de registo** nas Definições do Jortt para rever a atividade de sincronização, avisos e avarias. As entradas com um ícone de aviso podem ser abertas para ver todos os detalhes.

### Introdução

A maioria das Falhas do Jortt enquadra-se em três grupos: a ligação, os Clientes importados e as Faturas exportadas. Deve começar pelo registo.

### Explicação detalhada

A Integração volta a tentar a mesma ação até a causa ser corrigida, por isso a mesma avaria pode continuar a aparecer até ser resolvida a causa raiz.

Mensagens de avaria comuns e o que significam:

* **«Repor a ligação» / token já não é válido** — a ligação expirou e não pôde ser renovada. Deve ser desligada com o ícone de energia e ligada novamente.
* **«Permissões insuficientes na ligação» (permissões insuficientes)** — a ligação não tem as Permissões necessárias. Deve voltar a ligar-se e aprovar todos os acessos solicitados.
* **É necessária uma Conta paga** — o Jortt recusou a chamada porque a organização precisa de um plano Jortt pago.
* **«Jortt API temporariamente indisponível» (temporariamente indisponível)** — o Jortt está em manutenção. É preciso aguardar e tentar novamente.
* **Campos em falta no Cliente** — o Cliente não tem os campos obrigatórios (número de devedor, nome, Morada, código postal, cidade).
* **Tipo de hora desconhecido na Ordem de trabalho** — um Tipo de hora usado na Ordem de trabalho não existe no OutSmart, pelo que não é possível determinar o Preço. Criar o Tipo de hora no OutSmart.

### Guia passo a passo

{% stepper %}
{% step %}

#### Abrir as Definições do Jortt

Ir para **Definições → Geral → Integrações de software** e abrir **Jortt**.
{% endstep %}

{% step %}

#### Rever o registo

Verificar primeiro as entradas mais recentes. Abrir qualquer entrada com um ícone de aviso para ver a mensagem completa.
{% endstep %}

{% step %}

#### Corrigir a falha de origem

Corrigir o Cliente, o Tipo de hora, a Configuração ou a ligação indicados na mensagem.
{% endstep %}

{% step %}

#### Voltar a ligar, se necessário

Para avarias de ligação ou de Permissões, deve desligar com o ícone de energia e iniciar sessão no Jortt novamente.
{% endstep %}

{% step %}

#### Sincronizar novamente

Executar uma sincronização manual. Para as Ordens de trabalho com Estado 99 Falhou, repor o Estado para que sejam Entregue novamente.
{% endstep %}
{% endstepper %}

### FAQ

<details>

<summary>A ligação continua a expirar. O que fazer?</summary>

O OutSmart tenta primeiro atualizar a ligação automaticamente.

Se ainda falhar, deve desligar com o ícone de energia no painel do registo e ligar novamente.

</details>

<details>

<summary>O Jortt diz que é necessária uma Conta paga. Porquê?</summary>

A criação de Faturas requer um plano Jortt pago.

A Conta Jortt deve ser atualizada e, em seguida, voltar a sincronizar.

</details>

<details>

<summary>Uma Ordem de trabalho não é exportada. Onde procurar?</summary>

Abrir o registo dessa sincronização.

Verificar campos do Cliente em falta, um Tipo de hora desconhecido ou o Estado 99 na Ordem de trabalho.

</details>

### Referências

* **Jortt**
* **Configurar o Jortt**
* **Configurar exportações Jortt**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://knowledge.out-smart.com/outsmart-knowledge-base/outsmart-knowledge-base-pt/integracoes/integracoes/jortt/resolver-problemas-do-jortt.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.