# Geranet NFe

Geranet NFe é uma API brasileira para emissão de documentos fiscais: NFe, NFCe, NFSe, CTe e MDFE.

Base URL da API v1: https://nfe.geranet.net/api/v1
OpenAPI: https://nfe.geranet.net/api-v1-openapi.json
Documentação humana: https://nfe.geranet.net/documentacao
Redoc: https://redocly.github.io/redoc/?url=https%3A%2F%2Fnfe.geranet.net%2Fapi-v1-openapi.json
Suporte WhatsApp: https://wa.me/5563992501357

## Cadastro por API pública

É possível criar uma conta gratuita por API pública:

POST https://nfe.geranet.net/api/v1/contas/criar
Content-Type: application/json
Accept: application/json

Payload:

```json
{
  "nome": "Nome do programador ou empresa",
  "email": "programador@example.com",
  "senha": "uma-senha-com-8-ou-mais-caracteres",
  "confirmacaoSenha": "uma-senha-com-8-ou-mais-caracteres"
}
```

Resposta de sucesso HTTP 201:

```json
{
  "situacao": "sucesso",
  "mensagem": "Conta criada gratuitamente.",
  "usuario": {
    "nome": "Nome do programador ou empresa",
    "email": "programador@example.com"
  },
  "chaveApi": "gn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "autenticacao": {
    "tipo": "Bearer",
    "cabecalho": "Authorization: Bearer gn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}
```

A rota de cadastro tem limite de tentativas por IP e por e-mail para evitar criação massiva de contas. Não crie contas em loop.

## Cobrança

Criar conta é grátis.
Não há cobrança por notas de teste/homologação (`ambiente = 2`).
A cobrança ocorre somente pelo uso real de emissões autorizadas em produção (`ambiente = 1`), conforme a política publicada no site.

## Autenticação

Após criar a conta, use a chave retornada no header:

Authorization: Bearer SUA_CHAVE_API

Exemplo:

```bash
curl -X GET "https://nfe.geranet.net/api/v1/user" \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -H "Accept: application/json"
```

## Endpoints principais

- POST /api/v1/nfe/emitir: emitir NFe modelo 55 ou NFCe modelo 65.
- POST /api/v1/nfe/consultar-notas: consultar distribuição de NFe.
- POST /api/v1/nfe/gerar-pdf: gerar DANFE a partir de XML autorizado.
- POST /api/v1/nfe/cancelar: cancelar NFe/NFCe.
- POST /api/v1/nfse/emitir: emitir NFSe.
- POST /api/v1/nfse/consultar-notas: consultar NFSe.
- POST /api/v1/nfse/gerar-pdf: gerar PDF de NFSe.
- POST /api/v1/nfse/cancelar: cancelar NFSe.
- POST /api/v1/cte/emitir: emitir CTe.
- POST /api/v1/mdfe/emitir: emitir MDFE.
- POST /api/v1/ciot/emitir: registrar uma operação de transporte e obter o CIOT.
- POST /api/v1/ciot/consultar: consultar o código CIOT pelo identificador do cliente.
- POST /api/v1/ciot/cancelar: cancelar uma operação CIOT.
- POST /api/v1/ciot/encerrar: encerrar uma operação CIOT.

Use o OpenAPI para schemas completos, exemplos de payload e respostas.