# Tulha

> API REST para emitir NFS-e (Nota Fiscal de Serviço eletrônica) no padrão nacional brasileiro. O sistema do cliente envia a venda em JSON; o Tulha emite a nota, guarda XML e PDF e avisa por webhook assinado. Produto da Value Code.

## Fatos

- Preço: R$ 0,49 por nota autorizada, até 1.000 notas por mês, sem mensalidade. Acima disso, preço negociado por volume. Carteira pré-paga (recarga a partir de R$ 100 no cartão); crédito não expira; cancelar não gera cobrança; sandbox grátis.
- Documentos: NFS-e disponível. NFC-e e NF-e em breve.
- Onde emite: municípios conveniados ao emissor nacional da NFS-e (Sefin Nacional, com certificado A1 do CNPJ) e prefeituras com sistema próprio da E&L (com o token da prefeitura, sem A1; em produção em Taiobeiras-MG).
- Sem nota em dobro: toda emissão exige `Idempotency-Key`; o número da DPS é reservado antes do envio e o Tulha consulta o emissor antes de qualquer reenvio.
- Integração com o Asaas: cobrança paga vira NFS-e sem código no sistema do cliente; também emite antes do pagamento sem duplicar.
- Reforma tributária: o grupo IBSCBS (IBS/CBS) da DPS é configurado no emitente; a API não muda.
- Acesso: lista de espera em https://tulha.dev/#lista-de-espera. Contato: contato@valuecode.com.br.

## API

- Base: `https://api.tulha.dev/v1`. Autenticação: `Authorization: Bearer <token>`. O token define o ambiente (`sandbox` ou `production`).
- `POST /nfse` emite (responde 202; resultado por webhook `nfse.authorized`, `nfse.rejected`…).
- `GET /nfse/{id}`, `GET /nfse` (lista), `GET /nfse/{id}/xml`, `GET /nfse/{id}/pdf`.
- `POST /nfse/{id}/cancel` cancela; `POST /nfse/{id}/replace` substitui.
- `POST /asaas/payments/{payment_id}/nfse` emite a nota de uma cobrança do Asaas, inclusive antes do pagamento.
- Webhooks assinados com `X-Tulha-Signature` (HMAC-SHA256 do corpo com o secret do endpoint).
- Erros sempre em `{"error": {"code", "message", "details"}}`.

## Documentação

- [Documentação completa da API](https://tulha.dev/docs): autenticação, emitir, idempotência, estados, consultar, XML e PDF, cancelar, substituir, prefeituras, série da DPS, reforma tributária, webhooks, erros e integração com o Asaas.
- [Página inicial](https://tulha.dev/): como funciona, preço e perguntas frequentes.