> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.ephra.io/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 integrar com a Spedy?

A Spedy é uma plataforma de emissão de notas fiscais. Com a integração, cada venda aprovada na Ephra é enviada automaticamente para a Spedy, que emite a nota fiscal de serviços eletrônica (NFS-e) referente à venda.

Esta integração é feita e mantida pela Ephra. Você não precisa configurar nada na Spedy além dos dados fiscais da sua empresa, e não precisa criar webhooks manualmente.

||| Para a integração funcionar, a sua conta na Spedy precisa estar no plano Advanced ou superior.

## Antes de começar

Você vai precisar de:

1. Uma conta ativa na Spedy.
2. Cadastro completo da sua empresa na Spedy: CNPJ, inscrição estadual e municipal (se aplicáveis), endereço e demais dados fiscais.

## Como funciona a integração

Funciona assim:

1. O comprador paga a sua venda na Ephra.
2. A Ephra registra essa venda na Spedy, com os dados do cliente, os produtos e os valores.
3. A Spedy emite a nota fiscal assim que recebe a venda.

## Gerando a chave de API na Spedy

Acesse a sua conta na Spedy.

Clique no seu nome de usuário, no canto superior direito, e vá em **Minha Empresa**.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/b/9/f/eb9f5658bc851800/image_7qfhnc.png =651xauto)

Clique no botão **Credenciais da API**.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/b/9/f/eb9f5658bc851800/image_eay7lr.png =641xauto)

Em seguida, copie a chave de API gerada.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/b/9/f/eb9f5658bc851800/image_cet506.png =647xauto)

||| Essa chave é o que autoriza a Ephra a criar vendas e notas na sua conta da Spedy.

## Habilitando a integração na Ephra

Acesse a sua conta na Ephra, clique em **Aplicativos** e localize a **Spedy**.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/b/9/f/eb9f5658bc851800/image_q0ny7d.png =666xauto)

Clique em **Spedy** e depois em **Conectar Integração**.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/b/9/f/eb9f5658bc851800/image_1rlfl6j.png =671xauto)

Cole a chave copiada no campo **API Key**.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/b/9/f/eb9f5658bc851800/image_e9ec11.png =672xauto)

Por fim, clique em **Salvar integração**.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/b/9/f/eb9f5658bc851800/image_z75rcs.png =634xauto)

Pronto! Suas vendas passam a ser enviadas para a Spedy assim que o pagamento é aprovado.

## Como conferir se a integração está funcionando

Faça uma venda de teste no seu checkout e confirme na Spedy que a venda apareceu e que a nota foi emitida.

Se nada chegar, confira dois pontos:

* A chave colada no campo **API Key** na Ephra é a mesma que aparece em **Credenciais da API** na Spedy
* O cadastro fiscal da sua empresa na Spedy está completo

||| Sem a integração, alguém lança nota pedido a pedido no fim do mês. Com a Spedy ligada à Ephra, a NFS-e sai sozinha a cada venda aprovada, com os dados do comprador já preenchidos.

Ficou com alguma dúvida? Fale com o nosso time pelo chat da plataforma ou chame o gerente de conta.