NFCom

Emitir NFCom

Emite uma Nota Fiscal de Serviços de Comunicação Eletrônica (NFCom).

POST/v1/nfcom/emit

POST /v1/nfcom/emit emite uma NFCom (mod: "62") — Nota Fiscal de Serviços de Comunicação Eletrônica, usada por prestadoras de telefonia, TV por assinatura, internet e outros serviços de telecomunicação.

Parâmetros do corpo

Campos comuns

modstringobrigatório

Valores aceitos: 62

Modelo do documento: fixo 62 para NFCom.

data_emissaostringobrigatório

Data e hora de emissão do documento fiscal (ISO 8601).

cnpj_emitentestring

CNPJ da emitente. Utiliza os dados do cadastro da empresa quando omitido.

nome_destinatariostring

Nome ou razão social do destinatário/assinante.

cnpj_destinatariostring

CNPJ do destinatário/assinante. Obrigatório informar CNPJ, CPF ou outra identificação do destinatário/assinante.

cpf_destinatariostring

CPF do destinatário/assinante. Obrigatório informar CNPJ, CPF ou outra identificação do destinatário/assinante.

tipo_assinantestring | number

Tipo de assinante — ver listagem completa de campos para o significado de cada código.

tipo_servicostring | number

Tipo de serviço utilizado (telefonia, dados, TV por assinatura, internet, etc) — ver listagem completa de campos.

itensarray

Itens da nota fiscal.

numero_itemstringobrigatório

Número do item da NFCom, começando por 1.

codigo_produtostringobrigatório

Código do produto ou serviço.

descricaostringobrigatório

Descrição do produto.

cfopstring | number

CFOP.

unidade_medidastring | number

Unidade Básica de Medida — ver listagem completa de campos.

quantidade_faturadastring | number

Quantidade faturada.

valor_itemstring | number

Valor unitário do item.

valor_total_itemstring | number

Valor total do item.

Todos os campos de identificação do emitente, destinatário e valores totais são opcionais e são preenchidos automaticamente a partir do cadastro da empresa (emitente) ou calculados a partir dos itens (valores) quando omitidos. Veja a listagem completa de campos de NFCom para todos os grupos (faturamento, contingência, substituição, IBS/CBS, fidelidade, entrega da fatura, etc).

Resposta

202 Accepted

messagestring

Confirmação de que o documento entrou na fila de processamento.

invoiceIdstring

UUID interno do documento — use na chamada de consulta.

accessKeystring

Chave de acesso de 44 dígitos do documento fiscal, quando já pode ser calculada no momento do enfileiramento.

curl -X POST https://app.nfe.tenzanlabs.com/v1/nfcom/emit \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "mod": "62",
    "data_emissao": "2026-08-19T12:00:00-03:00",
    "cnpj_emitente": "12345678000199",
    "nome_destinatario": "João da Silva",
    "cpf_destinatario": "11122233344",
    "tipo_assinante": "3",
    "tipo_servico": "4",
    "itens": [
      {
        "numero_item": "1",
        "codigo_produto": "PLANO-FIBRA-500",
        "descricao": "Assinatura mensal - Internet Fibra 500MB",
        "cfop": "5307",
        "unidade_medida": "4",
        "quantidade_faturada": 1,
        "valor_item": 99.90,
        "valor_total_item": 99.90
      }
    ]
  }'

import { NFeClient } from '@tenzanlabs/nfe-node-sdk';

const client = new NFeClient('nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', 'nfe_test_SUA_CHAVE_AQUI');

const resposta = await client.emit({
  mod: '62',
  data_emissao: new Date().toISOString(),
  cnpj_emitente: '12345678000199',
  nome_destinatario: 'João da Silva',
  cpf_destinatario: '11122233344',
  tipo_assinante: '3',
  tipo_servico: '4',
  itens: [
    {
      numero_item: '1',
      codigo_produto: 'PLANO-FIBRA-500',
      descricao: 'Assinatura mensal - Internet Fibra 500MB',
      cfop: '5307',
      unidade_medida: '4',
      quantidade_faturada: 1,
      valor_item: 99.9,
      valor_total_item: 99.9,
    },
  ],
});
console.log(resposta.invoiceId);

from datetime import datetime, timezone
from nfe_sdk import NFeClient

client = NFeClient(access_key='nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', api_key='nfe_test_SUA_CHAVE_AQUI')

resposta = client.emit({
    "mod": "62",
    "data_emissao": datetime.now(timezone.utc).isoformat(),
    "cnpj_emitente": "12345678000199",
    "nome_destinatario": "João da Silva",
    "cpf_destinatario": "11122233344",
    "tipo_assinante": "3",
    "tipo_servico": "4",
    "itens": [
        {
            "numero_item": "1",
            "codigo_produto": "PLANO-FIBRA-500",
            "descricao": "Assinatura mensal - Internet Fibra 500MB",
            "cfop": "5307",
            "unidade_medida": "4",
            "quantidade_faturada": 1,
            "valor_item": 99.90,
            "valor_total_item": 99.90,
        }
    ],
})
print(resposta["invoiceId"])

import br.com.saascore.nfe.NFeClient;
import br.com.saascore.nfe.model.NfcomData;
import java.util.*;

NFeClient client = new NFeClient("nfe_access_SUA_CHAVE_DE_ACESSO_AQUI", "nfe_test_SUA_CHAVE_AQUI");

NfcomData nota = new NfcomData();
nota.mod = "62";
nota.data_emissao = java.time.Instant.now().toString();
nota.cnpj_emitente = "12345678000199";
nota.nome_destinatario = "João da Silva";
nota.cpf_destinatario = "11122233344";
nota.tipo_assinante = "3";
nota.tipo_servico = "4";

NfcomData.NfcomDataItens item = new NfcomData.NfcomDataItens();
item.numero_item = "1";
item.codigo_produto = "PLANO-FIBRA-500";
item.descricao = "Assinatura mensal - Internet Fibra 500MB";
item.cfop = "5307";
item.unidade_medida = "4";
item.quantidade_faturada = 1;
item.valor_item = 99.90;
item.valor_total_item = 99.90;
nota.itens = List.of(item);

var resposta = client.emit(nota);
System.out.println(resposta.invoiceId);

Exemplo de resposta

{
  "message": "Documento enfileirado para processamento",
  "invoiceId": "62f0a1b2-...",
  "accessKey": "35260812345678000199620010000000011000000018"
}