White-Label, CNAME & Gestão via API
Domínio personalizado para DANFE/XML, customização de marca e gestão de sub-clientes.
A Org API & Domínio Próprio (CNAME) do NFER permite que plataformas, ERPs e integradores façam a gestão programática completa de empresas e sub-clientes (empresas, certificados digitais, API keys) e disponibilizem a visualização de DANFE em PDF, download do XML e envio de e-mails sob o seu próprio domínio.
Escopo da Integração Headless & White-Label
O NFER opera como infraestrutura fiscal embutida e invisível para Software Houses, ERPs e plataformas parceiras. Seus clientes emitem direto pela sua interface enquanto assinatura digital, cálculo tributário e transmissão SEFAZ ocorrem em segundo plano.
- • Domínio Próprio (CNAME): links de DANFE em PDF e XML com o seu domínio (ex.:
danfe.seuerp.com.br) e SSL automático. - • infRespTec & CSRT: CNPJ e hash CSRT da sua Software House autenticados no XML da SEFAZ.
- • Logomarca nos Documentos: logotipo customizado da empresa no cabeçalho do DANFE e NFC-e.
- • Operação Headless via API: cadastro de empresas, certificados A1 e emissões por dentro do seu próprio software.
- • Interface com o Cliente Final: as telas de emissão e listagem de notas devem ser providas no seu próprio sistema via API.
- • O portal NFER (
app.nfer.me) é destinado exclusivamente à gestão técnica e suporte da sua equipe. - • Não fornecemos painel administrativo web com sua marca para revenda aos seus usuários finais.
Apresente links como https://danfe.seuerp.com.br/352608... com certificado SSL automático.
Dispare notificações aos seus clientes finais com links diretos apontando para a sua própria infraestrutura de domínio.
1. Como Configurar o Domínio Personalizado (CNAME)
Para que seus clientes acessem a DANFE e o XML no seu domínio, você só precisa criar uma entrada DNS do tipo CNAME no seu provedor de DNS (Cloudflare, Registro.br, Route53, GoDaddy, etc.).
| Tipo | Nome / Host | Destino / Valor (Target) | TTL / Proxy |
|---|---|---|---|
| CNAME | danfe (ou nfe) | cname.nfer.me | Auto / DNS Only (ou Cloudflare Proxied) |
| CNAME | xml (opcional) | cname.nfer.me | Auto / DNS Only |
2. Links Públicos Diretos para Consumidores
Quando você emite uma NF-e ou NFC-e, a API retorna automaticamente as URLs prontas para envio por WhatsApp ou e-mail. Não é necessário nenhum token na URL: a própria Chave de Acesso de 44 dígitos autoriza a exibição.
Parâmetros Opcionais de Query:
?download=1— Força o download do arquivo (Content-Disposition: attachment) em vez de abrir inline no navegador.?regenerate=1— Força a regeração do layout do PDF no storage.
3. Autenticação da Org API & Criação de Empresas
Para realizar operações de organização (criar empresas via POST /v1/companies, listar filiais e configurar white-label), utilize sua Org Key com prefixo nfer_org_ no header X-Org-Key (ou X-API-Key).
Sua Org Key fica disponível em Configurações → Minha Conta (/dashboard/account), onde você pode copiá-la ou realizar a rotação de credenciais a qualquer momento com segurança.
4. Endpoints da Org API
Endpoints administrativos para gerenciamento headless de organizações, domínios CNAME e empresas parceiras:
| Operação | Método e Rota | Referência Técnica |
|---|---|---|
| Consultar Configurações Org | GET /v1/org/settings | Ver Configurações → |
| Atualizar Domínio CNAME | PATCH /v1/org/settings | Ver Parâmetros → |
| Verificar Resolução DNS | POST /v1/org/settings/verify-cname | Ver Teste CNAME → |
| Listar Empresas & Filiais | GET /v1/org/projects | Ver Listagem → |
| Cadastrar Empresa (Onboarding) | POST /v1/org/projects | Ver Criação Headless → |
| Upload de Certificado A1 | POST /v1/org/projects/:id/certificate | Ver Upload A1 → |
| Upload de Logomarca DANFE | POST /v1/org/projects/:id/logo | Ver Upload Logo → |
| Ajustar Sequência Numérica | PATCH /v1/org/projects/:id/numeracao | Ver Séries Fiscais → |
5. Exemplo: Configurando o Domínio Próprio via API
6. Responsável Técnico & CSRT Customizável (infRespTec)
Para plataformas parceiras e Software Houses que utilizam a infraestrutura de emissão embutida (headless), o NFER permite configurar o grupo infRespTec diretamente com os dados da sua Software House em cada empresa emissora gerenciada.
Estados como PR, AM, MS, PE, SC e TO exigem o preenchimento do Responsável Técnico e a assinatura do hash do CSRT (Código de Segurança do Responsável Técnico). Ao configurar seus dados na empresa, o NFER calcula o hash SHA-1 oficial com o seu identificador e omite qualquer menção externa: