# NotasX

> API de emissão de NFS-e pelo Padrão Nacional (Sefin Nacional + ADN), para integradores que emitem para vários Prestadores.

- [NotasX](https://docs.notasx.com.br/index.md): API de emissão de NFS-e pelo Padrão Nacional, para quem emite em nome de vários Prestadores.
- [Início rápido](https://docs.notasx.com.br/inicio-rapido.md): Da Chave de API à primeira NFS-e em homologação, em cinco chamadas.
- [Autenticação](https://docs.notasx.com.br/autenticacao.md): Chave de API para integrações; sessão para o painel. As duas representam a mesma Conta.
- [Ciclo da Nota](https://docs.notasx.com.br/conceitos/ciclo-da-nota.md): Do pedido à NFS-e: os status, a diferença entre Rejeição e Falha e por que uma Nota nunca vira duas NFS-e.
- [Prestador e Certificado](https://docs.notasx.com.br/conceitos/prestador-e-certificado.md): Quem emite a NFS-e e o Certificado A1 que assina cada DPS.
- [Ambientes](https://docs.notasx.com.br/conceitos/ambientes.md): Homologação para testar, produção para valer. Cada Nota guarda o Ambiente em que foi criada.
- [Glossário](https://docs.notasx.com.br/conceitos/glossario.md): Os termos usados em toda a API e nesta documentação.
- [Idempotência](https://docs.notasx.com.br/guias/idempotencia.md): Como repetir um pedido sem medo de emitir duas NFS-e.
- [Erros](https://docs.notasx.com.br/guias/erros.md): Um formato só para todos os erros. Trate pelo código.
- [Limites e Cota](https://docs.notasx.com.br/guias/limites-e-cota.md): Requisições por minuto e NFS-e de produção por mês.
- [Paginação](https://docs.notasx.com.br/guias/paginacao.md): Listar Notas página a página, por cursor.
- [Webhook](https://docs.notasx.com.br/guias/webhook.md): Receba o resultado das Notas sem consultar a API.
- [Listar Notas](https://docs.notasx.com.br/api-reference/notas/listar-notas.md): Notas dos Prestadores vinculados à sua Conta, das mais recentes para as mais antigas.
- [Criar Nota](https://docs.notasx.com.br/api-reference/notas/criar-nota.md): Cria a Nota `pendente` e a coloca na fila de emissão; responde `202` na hora, sem esperar a Sefin. Acompanhe o resultado em `GET /v1/notas/{id}`.
- [Consultar Nota](https://docs.notasx.com.br/api-reference/notas/consultar-nota.md): A Nota e o resultado da emissão. Consulte até o `status` sair de `pendente`/`processando` (normalmente alguns segundos; com a Sefin instável, as novas tentativas podem levar minutos).
- [Baixar o XML da NFS-e](https://docs.notasx.com.br/api-reference/notas/baixar-o-xml-da-nfs-e.md): Devolve um link temporário (5 minutos) para o XML oficial da NFS-e. Disponível pouco depois de `emitida`; antes disso, `404 xml_indisponivel`.
- [Consultar a Cota](https://docs.notasx.com.br/api-reference/conta/consultar-a-cota.md): Uso da Cota no mês corrente. Só NFS-e de produção contam; homologação é livre.
- [Consultar o Webhook](https://docs.notasx.com.br/api-reference/conta/consultar-o-webhook.md): Endereço e segredo do Webhook da Conta.
- [Configurar o Webhook](https://docs.notasx.com.br/api-reference/conta/configurar-o-webhook.md): Define (ou troca) o endereço do Webhook da Conta. Há um Webhook por Conta. O NotasX chama esse endereço quando uma Nota chega a um resultado (`emitida`, `rejeitada` ou `falhou`).
- [Remover o Webhook](https://docs.notasx.com.br/api-reference/conta/remover-o-webhook.md): Remove o Webhook. Para voltar a receber, configure de novo (um segredo novo será gerado).
- [Listar Prestadores](https://docs.notasx.com.br/api-reference/prestadores/listar-prestadores.md): Prestadores vinculados à sua Conta, na ordem de cadastro.
- [Cadastrar Prestador](https://docs.notasx.com.br/api-reference/prestadores/cadastrar-prestador.md): Cadastra o Prestador e o vincula à sua Conta. Ele começa em `homologacao` e inativo: envie o Certificado em seguida. Cada CNPJ existe uma única vez no NotasX; se já estiver cadastrado, a resposta é `409`.
- [Consultar Prestador](https://docs.notasx.com.br/api-reference/prestadores/consultar-prestador.md): Um Prestador vinculado à sua Conta.
- [Ativar produção](https://docs.notasx.com.br/api-reference/prestadores/ativar-produção.md): Passa o Prestador para **produção**: as Notas criadas daqui em diante geram NFS-e com valor fiscal e consomem a Cota. As Notas já criadas mantêm o Ambiente que tinham.
- [Enviar Certificado A1](https://docs.notasx.com.br/api-reference/prestadores/enviar-certificado-a1.md): Envia o Certificado A1 do Prestador (`multipart/form-data`). Ele assina as DPS e autentica na Sefin.
- [Listar Chaves de API](https://docs.notasx.com.br/api-reference/chaves-de-api/listar-chaves-de-api.md): Todas as chaves da Conta, inclusive as revogadas, mais recentes primeiro. O valor nunca é devolvido.
- [Criar Chave de API](https://docs.notasx.com.br/api-reference/chaves-de-api/criar-chave-de-api.md): Cria uma Chave de API para a Conta. Ela age sobre todos os Prestadores vinculados à Conta. A primeira chave costuma ser criada pelo painel, com a sessão; depois, uma chave pode criar outras.
- [Revogar Chave de API](https://docs.notasx.com.br/api-reference/chaves-de-api/revogar-chave-de-api.md): Revoga a chave na hora: requisições com ela passam a receber `401`. Não tem volta; crie outra se precisar. Revogar de novo uma chave já revogada não muda nada.

## OpenAPI Specs

- [openapi](/openapi.json)


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