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

# Integrações do Vault ERP com Plataformas e Sistemas Externos

> Conecte o Vault ERP ao provedor fiscal para NF-e, marketplaces de relógios de luxo, servidores de e-mail e sistemas externos via API REST.

O Vault ERP se conecta às ferramentas e plataformas que o seu negócio já utiliza — desde provedores fiscais para emissão de NF-e diretamente nas vendas, até marketplaces especializados em relógios de luxo e serviços de e-mail para comunicação automatizada com clientes. Centralize sua operação e elimine retrabalho ao integrar o Vault ERP ao seu ecossistema tecnológico.

## Integrações Disponíveis

> **[Provedor Fiscal (NF-e)](https://docs.vaulterp.com.br/sales/invoicing.md)**
>
> Conecte seu provedor fiscal — como **Focus NFe**, **NFe.io** ou **Bling** — para emitir Notas Fiscais eletrônicas diretamente a partir das vendas registradas no Vault ERP. A integração exige CNPJ ativo, certificado digital A1 e as credenciais de API do seu provedor. Assim que ativada, a NF-e pode ser gerada com um clique na tela de venda.

> **[E-mail / SMTP](https://docs.vaulterp.com.br/crm/communications.md)**
>
> Configure o servidor de e-mail da sua empresa para o envio de notificações automáticas — confirmações de venda, envio de propostas, laudos de autenticação e lembretes de consignação. O Vault ERP é compatível com **Gmail**, **Outlook/Microsoft 365** e qualquer servidor **SMTP customizado**. Você também pode configurar um endereço de "responder para" diferente do remetente.

> **[Marketplaces](https://docs.vaulterp.com.br/catalog/overview.md)**
>
> Sincronize seu catálogo com os principais marketplaces de relógios de luxo: **Chrono24**, **WatchBox** e **OLX Luxo**. Relógios com status **"Disponível"** no estoque são publicados automaticamente com fotos, especificações e preço. Ao registrar uma venda no Vault ERP, os anúncios são despublicados automaticamente para evitar dupla venda.

> **[API REST](https://docs.vaulterp.com.br/api/overview.md)**
>
> Conecte qualquer sistema externo ao Vault ERP usando nossa **API REST**. Acesse **Configurações > Integrações > API** para gerar sua chave de acesso e consultar os endpoints disponíveis. A API permite leitura e escrita de estoque, clientes, vendas e laudos — ideal para integrar ERPs corporativos, sites próprios ou ferramentas personalizadas.

## Configurando o Provedor Fiscal

A integração com o provedor fiscal habilita a emissão de NF-e diretamente pelo Vault ERP no momento da venda. Antes de começar, certifique-se de que você possui o certificado digital A1 da sua empresa (arquivo `.pfx`) e as credenciais de API do provedor escolhido.

**1. Acesse as configurações fiscais**

No menu lateral, navegue até **Configurações > Integrações > Fiscal**.

**2. Selecione o seu provedor**

Escolha o provedor fiscal que você utiliza na lista disponível: **Focus NFe**, **NFe.io**, **Bling** ou outro provedor compatível. Caso o seu provedor não esteja listado, entre em contato com o suporte do Vault ERP.

**3. Informe suas credenciais**

Preencha o **CNPJ** da empresa emissora, a **chave de API** fornecida pelo seu provedor fiscal e selecione o **ambiente** de operação: **Homologação** (para testes, sem validade fiscal) ou **Produção** (para emissão de NF-e com validade jurídica).

**4. Faça o upload do certificado digital**

Carregue o arquivo do seu **certificado digital A1** no formato `.pfx` e insira a senha correspondente. O certificado é armazenado com criptografia e nunca é exposto em texto claro.

**5. Teste a conexão**

Clique em **Testar Conexão**. O Vault ERP enviará uma requisição de verificação ao provedor. Se bem-sucedida, uma mensagem de confirmação será exibida com os dados da empresa retornados pelo provedor.

**6. Ative a integração**

Após confirmar que a conexão está funcionando corretamente, clique em **Ativar**. A partir desse momento, o botão **Emitir NF-e** estará disponível nas vendas concluídas.

## Gerando uma Chave de API

A API REST do Vault ERP permite que sistemas externos leiam e escrevam dados na plataforma de forma segura e autenticada. Cada chave de API possui um nome identificador e pode ser revogada individualmente sem afetar as demais integrações.

**1. Acesse a área de API**

No menu lateral, navegue até **Configurações > Integrações > API**.

**2. Crie uma nova chave**

Clique em **Gerar Nova Chave**. Uma janela será exibida para você configurar a chave.

**3. Dê um nome descritivo à chave**

Atribua um nome que identifique claramente o uso da chave — por exemplo, `"Integração Site"`, `"ERP Corporativo"` ou `"Automação de Estoque"`. Isso facilita o gerenciamento quando você tiver múltiplas integrações ativas.

**4. Copie a chave gerada**

A chave de API será exibida **uma única vez** imediatamente após a criação. Copie-a agora e armazene em local seguro (como um gerenciador de senhas ou cofre de segredos). Após fechar essa janela, não será possível recuperar o valor da chave — apenas revogá-la e gerar uma nova.

**5. Use a chave nas suas requisições**

Em todas as chamadas à API do Vault ERP, inclua a chave no cabeçalho HTTP de autenticação:

```http theme={null}
Authorization: Bearer SUA_CHAVE_DE_API
```

Substitua `SUA_CHAVE_DE_API` pelo valor copiado no passo anterior.

> [!WARNING]
>
> Trate suas chaves de API com o mesmo cuidado que senhas. **Nunca compartilhe uma chave de API por e-mail, chat ou documentos acessíveis a terceiros**, e **nunca a inclua diretamente em código versionado** (como arquivos `.env` commitados no Git). Caso uma chave seja comprometida, revogue-a imediatamente em **Configurações > Integrações > API** e gere uma nova. O Vault ERP registra todas as requisições feitas por cada chave para fins de auditoria.

Para a documentação completa dos endpoints disponíveis, parâmetros, exemplos de requisição e códigos de resposta, consulte a [Referência da API REST do Vault ERP](https://docs.vaulterp.com.br/api/overview.md).


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