> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.calimaerp.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como baixar, instalar e utilizar o Box File?

| ✅ O Box File tem por objetivo captar as notas que estão no computador do seu cliente. Para isto, é preciso instalar o aplicativo do Box File e apontar a pasta onde estão os XMLs. Vamos ao passo a passo!

1. Baixe e instale o aplicativo do Box File através do link [CLICANDO AQUI](https://id3qvymhlwic.objectstorage.sa-saopaulo-1.oci.customer-oci.com/n/id3qvymhlwic/b/downloads/o/box-file.exe)! Durante a instalação do Box File, é possível que o seu sistema operacional, o Windows, por exemplo, bloqueie o download por não conhecer a origem do programa. **Nesse caso, siga os passos abaixo!**

* Clique em **MAIS INFORMAÇÕES**. Na tela seguinte, clique em **EXECUTAR ASSIM MESMO**.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/2/5/6/e25605c2f6f21800/windows1_75cjp5.gif =500x468)

2. Após instalar o aplicativo, acesse o ${color}[#0800ff](**Módulo Box > Utilitários > Código de Acesso - Box File**). Clique em **"Gerar código"**.

3. No campo **"Empresas"** clique no botão de seta (↗️), selecione as empresas desejadas e clique em **"Confirmar"**.

4. No campo **"Descrição"** digite uma descrição que melhor identifique esse código gerado para a empresa do seu cliente. Clique em **"Gerar ✔️"**.

| ✅ O Box File trabalha com ** NF-e, NFC-e, CF-e, CT-e e CT-eOS e NFS-e Nacional**.

|| 📌 Você pode liberar o acesso para TODAS as empresas ou limitar para uma/duas/quantas empresas desejar. Informe também uma descrição para facilitar seu controle! 🙂

![](https://storage.crisp.chat/users/helpdesk/website/-/e/2/5/6/e25605c2f6f21800/operan18bxiwwsw_thzmt0.gif)

5. Na tela de Código de Acesso, veja que ficou registrado o cadastro feito. Agora é só copiar esse código e colar no programa Box File instalado no computador do seu cliente.

🔵 Sobre o Código de Acesso, ele se trata de uma numeração/código único gerado pelo contador dentro do Calima. Com esse código, dentro do Box File instalado no computador do cliente, você seleciona a pasta e os arquivos serão importados automaticamente para dentro do Calima Box. **Resumindo:**

* Cada código é de uso único;
* Os códigos de acesso podem ser excluídos e gerados novamente;
* Um código pode dar acesso a várias empresas;
* Quando o código é lançado pelo cliente no Box File ele é ativado dentro do Módulo Box do Calima na coluna Habilitado dentro do menu Utilitários. Observe na imagem a seguir! ⬇️

![](https://storage.crisp.chat/users/helpdesk/website/e25605c2f6f21800/calima41kgdnam_15zlqqi.png =900x868)

---

###### Configurando o Box File no cliente:

1. Com o Box File instalado e aberto, digite o código gerado dentro do Calima e clique em **Confirmar**.
2. Selecione a pasta que possui os XMLs desejados e clique em **Sincronizar**. Subpastas dentro dessa são localizadas automaticamente.
3. Os arquivos serão enviados e uma subpasta será criada pelo Box File com o nome **ENVIADOS** (dentro da pasta selecionada) para facilitar sua organização, ou seja, os arquivos já importados serão movidos automaticamente para essa pasta.
4. A tela principal do Box File exibe o **nome da empresa administradora** (contador) que está cadastrada no Calima, além das **empresas configuradas/vinculadas ao código de acesso**.
5. Assim que você liga sua máquina, o Box File já começa a trabalhar. Para sair do programa, é só clicar em **Desconectar** no canto inferior direito. Nesse caso, um novo código deverá ser gerado para acessar novamente o Box File.

![](https://storage.crisp.chat/users/helpdesk/website/e25605c2f6f21800/padrao_ings79.png)

🔵 O envio é feito por lotes conforme você coloca novos XMLs na pasta selecionada. O programa instalado **monitora em tempo real** a pasta onde você coloca os XMLs e trabalha em segundo plano. Caso tenha um novo arquivo na pasta, ele manda para o Box que, por sua vez, envia ao Módulo Fiscal do Calima. 

||| ⚠️ O processo de autenticação e validação é simplificado e está todo dentro do Calima. O Box File apenas capta e envia as notas da(s) pasta(s) indicadas(s). **O Box File trabalha com NF-e, NFC-e, CF-e, CT-e, CT-eOS, NFS-e Nacional **. Por enquanto, **o Box File só faz a leitura de XMLs, arquivos zipados/compactados devem ser extraídos antes**.

⬇️ As notas vindas do Box File podem ser localizadas dentro da tela ${color}[#0800ff](**Módulo Box > Processos > Visualização de Notas**). 

---

###### Histórico de eventos:

* No Box File, na aba **Histórico de eventos**, você pode conferir as notas que deram erro e seu motivo.

* Um dos motivos, como o da imagem abaixo, é se o cliente não tiver permissão para importar as notas de uma empresa específica. Como já explicamos, essa permissão depende das empresas que foram configuradas/autorizadas no Código de Acesso gerado pelo contador!

![](https://storage.crisp.chat/users/helpdesk/website/e25605c2f6f21800/456_w8c4a6.png)