Conta e emitentes
Produtos contratados, o header X-Emitente-Id e o isolamento entre emitentes.
Conta e produtos
A sua empresa é uma conta. Ela é dona dos emitentes e dos produtos contratados: NFSE, NFE e NFCE.
curl -s https://api.u2dnotafiscal.com.br/api/v1/conta -H "Authorization: Bearer $ACCESS_TOKEN"{
"id": "6f1c2a9e-3b7d-4c1e-9a2f-5d8e7b6c4a10",
"nome": "Sua Empresa",
"produtos": ["NFCE", "NFE"],
"ativo": true,
"plano": { "codigo": "PROFISSIONAL", "nome": "Profissional", "recursos": ["API", "WEBHOOK"] }
}Rota de nota de produto não contratado responde 403 produto-nao-contratado, com o produto no corpo. Vale para
/nfse/**, /nfe/** e /nfce/**; /produtos exige NF-e ou NFC-e. Para contratar um produto, fale com o
Atendimento. Ao descontratar, as notas já emitidas continuam guardadas.
O plano define a franquia de notas, o limite de emitentes ativos e se a conta usa API e webhooks (o objeto
completo está em Planos e limites).
Emitente em toda rota de nota
Uma conta pode ter vários emitentes (matriz, filiais, outras empresas). Toda rota de nota e de cadastro por
emitente (/nfse, /nfe, /nfce, /clientes, /produtos) exige o header:
X-Emitente-Id: 8b3c1f0e-5d2a-4a1b-9c3d-2e1f0a9b8c7d- O valor é o
iddevolvido porPOST /emitentes(ou listado emGET /emitentes). - Emitente de outra conta, inexistente ou inativo responde
404 emitente-nao-encontrado. - Nota de outro emitente responde
404, mesmo que seja da mesma conta: cada consulta enxerga só os documentos do emitente do header.
As rotas de /emitentes, /conta, /tabelas e /status-servico não usam o header.
Dados que nunca voltam
O certificado A1, a senha dele e o CSC da NFC-e ficam cifrados no servidor. A API devolve só metadados (titular,
validade, fingerprint) e o idToken do CSC, nunca o arquivo, a senha ou o código.