Primeira Emissão
Pré-requisitos
Tipos de documento
| Tipo | Quando usar | Endpoint |
|---|---|---|
| NFe | Venda B2B | POST /nfe/emitir |
| NFCe | Venda varejo | POST /nfce/emitir |
| MDFe | Transporte | POST /mdfe/emitir |
| NFSe | Serviços | POST /nfse/emitir |
Campos obrigatórios (NFe)
Destinatário
| Campo | Tipo | Descrição |
|---|---|---|
cnpj ou cpf | string | Documento do destinatário |
nome | string | Nome/Razão social |
endereco | object | Endereço completo |
indicadorIE | number | 1=Contribuinte, 2=Isento, 9=Não contribuinte |
Itens
| Campo | Tipo | Descrição |
|---|---|---|
codigo | string | Código interno |
descricao | string | Descrição do produto |
ncm | string | NCM (8 dígitos) |
cfop | string | CFOP (ex: 5102) |
unidade | string | UN, KG, LT |
quantidade | number | Quantidade |
valorUnitario | number | Preço unitário |
valorTotal | number | Quantidade × preço |
Status de retorno
| Status | Significado |
|---|---|
AUTHORIZED | ✅ Autorizada pela SEFAZ |
REJECTED | ❌ Rejeitada — corrija os dados |
ERROR | ⚠️ Erro de comunicação — tente novamente |