> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useaira.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar contrato de um PDF

> Envie o PDF de um contrato ao Watchtower, revise o que a Aira leu e crie o contrato como rascunho.

> No **Watchtower**, você envia o PDF de um contrato, a Aira lê o cliente, as contas de pagamento, a vigência, a cobrança e os planos, e você revisa a proposta antes de criar o contrato. A aprovação cria o contrato como **rascunho**: nada é cobrado até você ativá-lo em **Contratos**.

## Quem pode usar

O Watchtower aparece no menu para quem tem acesso a ele. Os grupos **Admin** e **Editor** importam, revisam, aprovam e rejeitam contratos. O grupo **Visualizador** acompanha as tarefas, mas não envia PDFs nem decide.

## Enviar o PDF

Clique em **Importar contrato** ou arraste o PDF para a área do Watchtower. O envio volta na hora e abre a tarefa em **Aira está fazendo**, onde você acompanha a leitura do PDF. Quando a proposta fica pronta, a tarefa passa para **Precisa de você**. A lista se atualiza sozinha, e o número ao lado de cada aba mostra quantas tarefas ela tem.

* Se a Aira configurou modelos de contrato para a sua empresa, ela pergunta o **Modelo do contrato** depois que você escolhe o PDF, para ler o contrato com as regras desse modelo. Escolha o modelo e clique em **Importar**. Para um PDF que não segue nenhum modelo, escolha o **Modelo genérico**.
* A Aira aceita só PDF, um arquivo por vez. Um PDF maior do que o limite de leitura é recusado no envio.
* Se o mesmo PDF já estiver em revisão ou já tiver virado contrato, a Aira avisa, mas importa o arquivo mesmo assim. Confira antes de aprovar os dois.
* Se a Aira não conseguir usar o PDF, a tarefa aparece como **Falhou** com o motivo: um PDF com senha precisa de uma cópia sem senha, um arquivo corrompido ou ilegível precisa de outra cópia, e um documento que não vende nada, como um acordo de confidencialidade ou um certificado de assinaturas, não é um contrato. Nesse último caso, rejeite a tarefa ou envie o contrato.

## As tarefas do Watchtower

| Grupo | Tarefas |
| - | - |
| **Precisa de você** | Propostas aguardando revisão e tarefas que falharam |
| **Aira está fazendo** | PDFs na fila ou em leitura |
| **Feitas** | Contratos criados como rascunho e tarefas rejeitadas |

Além do envio de um PDF, só um clique troca de aba: decidir uma tarefa mantém você onde está, e cada aba abre a sua primeira tarefa. Uma tarefa que muda de aba enquanto você a lê continua aberta, e a aba para onde ela foi a mostra selecionada quando você clica nela. Depois que a Aira lê um contrato, a tarefa leva o nome do cliente do PDF. Busque uma tarefa pelo nome do arquivo ou do cliente. Ao selecionar uma tarefa, você vê o que a Aira propõe: o cliente, as contas de pagamento, a vigência, a periodicidade e os planos com as cobranças lidas no PDF. Uma tarefa concluída lista o que a aprovação criou ou vinculou e leva ao contrato.

## Revisar a proposta

Em **Abrir revisão**, o PDF fica ao lado das etapas da revisão, ajustado à largura, e acima dele aparece a página em que você está. Arraste a borda entre o PDF e as etapas para aumentar ou diminuir o PDF, até o limite de cada lado. Aumente ou diminua o zoom pelos botões **−** e **+** acima do PDF, ou com Ctrl (⌘ no Mac) e a roda do mouse, e volte à largura pelo botão ao lado. Você pode selecionar e copiar o texto do PDF. Para achar um trecho, clique na lupa da barra do PDF, ou clique no PDF e use Ctrl+F (⌘+F no Mac), que então busca só no PDF: a busca abre no canto direito, sobre as páginas. Ela ignora acentos e marca cada ocorrência: Enter vai para a próxima, Shift+Enter volta para a anterior e Esc fecha a busca. Um PDF escaneado não tem texto, então a busca não encontra nada nele. Entre os clientes que a Aira encontrou, o mais provável vem marcado com o motivo, como **CNPJ igual**, e um aviso marca o que ela leu com pouca certeza, para você conferir com o PDF. Uma conta cujo CNPJ ou CPF não passa na verificação dos dígitos também recebe esse aviso, porque a Aira leu algum número errado. O mesmo vale para o nome do cliente e para a razão social, o CNPJ ou CPF e os e-mails de uma conta que não aparecem no texto do PDF, sem contar maiúsculas, acentos, espaços e pontuação: a Aira leu alguma letra ou algum número errado. Um PDF escaneado não tem texto, então nele só a verificação dos dígitos acontece.

1. **Cliente:** vincule o cliente que a Aira encontrou ou crie um novo, com os campos do [cadastro de cliente](https://docs.useaira.com/clientes/criar-clientes.md): nome, ID externo, régua de cobrança e campos adicionais. Se a Aira não encontrar nenhum cliente, o formulário do cliente novo já abre, sem nada para escolher. O ID externo de um cliente novo vem em branco, porque é a chave do cliente nos seus sistemas e a Aira não o deduz do nome: digite-o para continuar. A régua de cobrança vem com a régua padrão do seu ambiente, e as filiais novas de uma organização nova recebem a mesma régua. Nos detalhes de um cliente encontrado, corrija o nome e o ID externo pelo lápis ao lado de cada um, e os campos adicionais em **Editar**. A aprovação grava essas correções no cliente vinculado. Se outro cliente já usa o novo ID externo, a revisão marca o campo. Escolha em **Tipo de cliente** se o cliente novo é um **Cliente único** ou uma **Organização**, como no cadastro de cliente; a revisão começa com o tipo que a Aira leu no PDF, e uma organização ganha a etapa **Filiais**. O cliente tem uma conta de pagamento, dentro do próprio cliente, com os campos da conta de pagamento do cadastro de cliente: CNPJ ou CPF, razão social, nome fantasia, endereço de cobrança e e-mails. Um cliente novo ganha uma conta nova, com o que a Aira leu no PDF. Quando o PDF não traz uma parte do endereço, como o bairro, a revisão busca o CEP e preenche só os campos em branco, sem mudar o que a Aira leu. O endereço vai completo ou em branco: enquanto um campo dele estiver vazio, a revisão marca esse campo e **Continuar** fica desabilitado. Um CNPJ ou CPF que não passa na verificação dos dígitos aparece marcado no campo assim que a revisão abre. Quando a Aira encontra o cliente e uma conta dele com o mesmo CNPJ, a conta aparece como na página do cliente, com a razão social, o CNPJ e o endereço que a Aira guarda: troque-a por outra conta do cliente em **Conta do cliente**, ou corrija os dados em **Editar**, menos o CNPJ ou CPF, que identifica a conta. A aprovação grava as correções na conta.
2. **Filiais:** aparece só quando o cliente é uma organização. A Aira lista como filiais novas as empresas que o PDF inclui no contrato, com o ID externo em branco, e a revisão só continua quando cada filial nova tem o seu. Clique numa filial, ou use **Editar** no menu **⋮**, para digitar o ID externo e corrigir o nome e os campos adicionais; **Excluir**, no mesmo menu, tira a filial do contrato. **Adicionar filial** cria uma filial nova ou vincula uma que a organização já tem. Se outro cliente já usa o ID externo de uma filial nova, a revisão marca essa filial. Cada filial pode ter uma conta de pagamento, como no cadastro de cliente: a Aira dá a uma filial a conta da mesma empresa que leu no PDF, e uma conta que não é de nenhuma filial fica fora da revisão. Na janela da filial, **Adicionar conta de pagamento** inclui uma conta, e **Remover** a tira. A conta de uma filial é criada nela. O contrato fatura o uso da organização e dessas filiais.
3. **Contrato:** em **Informações gerais**, a conta de pagamento do cliente paga as faturas. Para uma organização, escolha em **Geração das faturas** o método, como no contrato: **Consolidar tudo em uma fatura**, **Ratear faturas percentualmente** entre a conta do cliente e as contas das filiais, ou **Faturar por filiais**. Em **Faturar por filiais**, cada linha cobra o uso de uma filial com a conta de pagamento dela, e a revisão começa com uma linha para cada filial que tem conta. Depois, confira a vigência, a periodicidade e o dia de abertura da fatura, que o PDF costuma não trazer. Quando o seu ambiente pede, informe o regime tributário em **Configurações da fatura** e o método de pagamento com o vencimento em **Pagamentos**.
4. **Planos:** cada plano lido no PDF aparece num card com as suas cobranças: o tipo, o volume e o valor, e as faixas de uma cobrança por faixa ao clicar nela. No topo do card, no lugar do nome lido no PDF, escolha o plano do catálogo; o plano que a Aira sugere vem marcado como **Sugerido**. A Aira sugere o plano com o nome do plano lido, com os mesmos preços ou com cobranças de mesmo nome. Quando nenhum serve, ela olha os planos cujo nome tem pelo menos uma palavra em comum com o nome lido, que cobram no mesmo calendário do contrato e têm os mesmos tipos de cobrança do plano lido, como cobrança fixa ou por volume, com uma cobrança de diferença no máximo. Se só um plano serve, ela o sugere. Se vários servem, ela sugere o que cobra mais dos itens, dos recursos e das licenças que encontrou para as cobranças do plano lido, e nenhum quando nenhum deles cobra esses cadastros ou quando dois empatam. Um plano do catálogo vai para um só plano lido: fica com ele o plano lido com o motivo mais forte, nesta ordem: o mesmo nome, os mesmos preços, cobranças de mesmo nome, os cadastros das cobranças e um nome parecido. O outro plano lido recebe a próxima sugestão, se houver. Quando dois planos lidos têm o mesmo motivo, nenhum dos dois fica com o plano do catálogo, e ele aparece primeiro na lista dos dois. A lista traz só os planos do catálogo: um plano que ainda não existe nele precisa ser [criado em Planos](https://docs.useaira.com/planos/criar-planos.md) antes de ser escolhido aqui.

Cada cobrança do PDF precisa do item, do recurso ou da licença que ela cobra. A Aira procura esse cadastro pelos nomes do PDF antes de olhar qualquer plano do catálogo: o cadastro com o mesmo nome da cobrança e, se não houver, o que tem mais palavras em comum com esse nome, entre os que podem cobrar o modelo de precificação dela. Quando o nome da cobrança não encontra nenhum, ou quando dois empatam, e nenhuma outra cobrança do mesmo plano é do mesmo tipo de cobrança, a Aira procura da mesma forma pelo nome do plano no PDF. O plano do catálogo do card, sugerido ou escolhido por você, nunca troca um cadastro que os nomes do PDF encontraram: só a cobrança que ficou sem cadastro usa o da cobrança equivalente desse plano. Quando nada disso encontra um cadastro, a cobrança fica marcada no card com o que falta, mesmo antes de você escolher o plano, e o rascunho só é criado depois que você escolhe esse cadastro em **Editar cobranças**.

O card de um plano mostra os preços que o rascunho vai cobrar, que são os preços do PDF em qualquer plano do catálogo que você escolher: as cobranças do plano escolhido recebem os nomes e os valores do PDF, uma cobrança do PDF que esse plano não tem entra só no plano deste contrato, e as cobranças próprias do plano que o PDF não tem nunca entram no lugar delas. Só um plano do catálogo com cobrança personalizada mantém os preços do catálogo, e o card avisa quando eles diferem do PDF.

Depois que você escolhe o plano do catálogo, **Editar cobranças**, abaixo dos preços do card, abre ao lado do PDF as cobranças do plano neste contrato, como ao [personalizar o plano de um contrato](https://docs.useaira.com/planos/versionamento.md): você altera valores, modelos de precificação e faixas, e adiciona ou remove cobranças. **Salvar** leva as cobranças para a revisão, e o rascunho usa esses preços no lugar dos preços do catálogo. O plano do catálogo não muda. A lixeira do card tira o plano do contrato. Cada plano que fica no contrato precisa do seu plano do catálogo: para criar o rascunho sem um plano lido no PDF, tire-o pela lixeira.

## Criar o rascunho ou rejeitar

**Criar rascunho** fica desabilitado enquanto alguma etapa da revisão tem um campo obrigatório em branco, como o ID externo de um cliente novo, a data de início do contrato ou o plano do catálogo de um plano. Com todas as etapas completas, ele cria o cliente ou vincula o cliente com as suas correções, cria ou vincula as filiais e as contas de pagamento, cria o contrato como rascunho e anexa os planos escolhidos, tudo de uma vez. Se um valor estiver num formato inválido, como um CNPJ que não existe, a revisão abre a etapa dele com o campo marcado e nada é gravado. Se algum campo for recusado, ele aparece marcado na revisão e nada é gravado. Se a criação falhar, a tarefa aparece como **Falhou** e você pode aprová-la de novo. Depois de criar o rascunho, você volta para **Precisa de você** com a tarefa aberta, que mostra o que a aprovação criou ou vinculou.

**Rejeitar** descarta a tarefa com um motivo, que você escolhe na lista: **Arquivo errado**, **Contrato duplicado**, **Não é um contrato** ou **Outro**. Em **Outro**, descreva em até 500 caracteres o que aconteceu e por que você rejeita a tarefa, e a tarefa rejeitada mostra esse texto como o motivo. Nada é criado na Aira.

> [!NOTE]
>
> O rascunho ainda não fatura. Quando ele tiver um plano, ative-o por **Ativar contrato**, na própria tarefa, ou pela tela do contrato, como em [Ciclo de vida do contrato](https://docs.useaira.com/contratos/ciclo-de-vida.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.