Começando

Primeiros Passos

Do zero até sua primeira NFS-e autorizada em ambiente de homologação -- sem custo, sem efeito fiscal, e sem precisar entender XML.

💡

Pré-requisito único: um contrato ativo com a CentralFiscal. Se sua empresa ainda não tem um, fale com comercial@centralfiscal.com.br -- a ativação é feita pelo nosso time, não é um cadastro self-service.

1. Gerar sua API key

Ainda não existe autoatendimento pra isso -- peça sua API key de Homologação pelo canal de atendimento CentralFiscal do seu contrato. Guarde-a assim que receber -- ela só é exibida uma vez. Detalhes em Autenticação.

2. Cadastrar a empresa emissora

Cadastre o CNPJ que vai emitir os documentos (o "prestador" da nota).

curl -X POST https://areacliente.centralfiscal.com.br/v1/contribuintes \
  -H "Authorization: Bearer cf_test_51JqK..." \
  -H "Content-Type: application/json" \
  -d '{
    "tipo_documento": "CNPJ",
    "documento": "12345678000190",
    "razao_social": "EMPRESA EXEMPLO LTDA",
    "regime_tributario": "SIMPLES_NACIONAL",
    "municipio_ibge": 4314902,
    "uf": "RS"
  }'

3. Vincular o certificado digital

Certificado A1 (arquivo .pfx/.p12) do CNPJ cadastrado no passo anterior, enviado em Base64.

curl -X POST https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}/certificado-digital \
  -H "Authorization: Bearer cf_test_51JqK..." \
  -H "Content-Type: application/json" \
  -d '{
    "tipo": "A1",
    "arquivo_base64": "MIIKXAIBAzCCCh...",
    "senha": "senha-do-certificado"
  }'

⚠️

A senha do certificado é armazenada de forma criptografada e nunca é retornada em nenhuma resposta da API, inclusive em consultas futuras.

4. Emitir sua primeira NFS-e

Estrutura completa, com todos os campos e as 7 linguagens, em NFS-e · Emitir. Exemplo mínimo:

curl -X POST https://areacliente.centralfiscal.com.br/v1/nfse/emissoes \
  -H "Authorization: Bearer cf_test_51JqK..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-0001" \
  -d '{
    "data_emissao": "2026-08-06",
    "competencia": "2026-08-06",
    "prestador": {
      "documento": "12345678000190"
    },
    "servico": {
      "codigo_lista_servico": "01.07",
      "discriminacao": "Suporte tecnico em informatica."
    },
    "valores": {
      "valor_servicos": 1500,
      "aliquota_iss": 2
    }
  }'

5. Conferir o resultado

A emissão de NFS-e é síncrona -- a própria resposta do passo 4 já vem com status: AUTHORIZED (ou ERROR, se algo faltou) e o número/protocolo definitivos. Não é preciso consultar de novo, mas GET /v1/nfse/emissoes/{emissao_id} continua disponível pra reconsulta.

6. Baixar XML e PDF (DANFSe)

Com status: AUTHORIZED, a própria resposta do passo 4 já traz os links de download do XML autorizado e do DANFSe em PDF dentro de detalhes.

🎉

Pronto -- você emitiu sua primeira NFS-e. Para produção de verdade, peça uma API key de produção ao suporte CentralFiscal (Ambientes) e repita os passos 2-3 com os dados reais do seu cliente.