API Reference

Emitir

post
https://api.focusnfe.com.br/v2/nfe

Recebe o payload da NF-e e inicia o envio para autorização na SEFAZ.
Por padrão, o fluxo é assíncrono: a API confirma o recebimento da requisição e a nota segue em fila até o processamento. Quando permitido pelo estado e pela configuração da conta, a emissão pode ocorrer de forma síncrona, com o resultado retornado na mesma requisição.
Para acompanhar o status até a autorização, use a consulta da nota ou os webhooks.
A NF-e na versão 4.00 admite muitos campos. A referência completa dos campos aceitos pela API, com a correspondência às tags XML, está no link abaixo.
Documentação completa dos campos da NF-e (versão 4.00)

Query Params
string
required

Referência única da NFe no seu sistema

Body Params
string
required

Descrição da natureza da operação a ser realizada pela nota fiscal

date-time
required

Data da emissão da NFe (formato ISO)

date-time

Data de entrada ou saída da mercadoria

integer
enum
required

Tipo da NFe:

  • 0: Nota Fiscal de Entrada
  • 1: Nota Fiscal de Saída
Allowed:
integer
enum

Local onde a operação irá acontecer:

  • 1: Operação interna
  • 2: Operação interestadual
  • 3: Operação com exterior
Allowed:
integer
enum
required

Finalidade da emissão da nota:

  • 1: Normal
  • 2: Complementar
  • 3: Nota de ajuste
  • 4: Devolução
Allowed:
integer
enum

Indica se a operação é com consumidor final:

  • 0: Normal
  • 1: Consumidor final
Allowed:
integer
enum

Presença do comprador:

  • 0: Não se aplica
  • 1: Operação presencial
  • 2: Operação não presencial, pela Internet
  • 3: Operação não presencial, Teleatendimento
  • 4: NFC-e em operação com entrega em domicílio
  • 9: Operação não presencial, outros
Allowed:
string

CNPJ do emitente (usar este ou cpf_emitente)

string

CPF do emitente (usar este ou cnpj_emitente)

string

Razão social do emitente

string

Nome fantasia do emitente

string

Logradouro do emitente

string

Número do logradouro do emitente

string

Bairro do emitente

string

Município do emitente

string

UF do emitente

string

CEP do emitente

string

Inscrição Estadual do emitente

integer
enum

Regime tributário do emitente:

  • 1: Simples Nacional
  • 2: Simples Nacional – excesso de sublimite de receita bruta
  • 3: Regime Normal
Allowed:
string

Nome completo do destinatário

string

CNPJ do destinatário (usar este ou cpf_destinatario)

string

CPF do destinatário (usar este ou cnpj_destinatario)

string

Inscrição Estadual do destinatário

integer
enum

Indicador da IE do destinatário:

  • 1: Contribuinte ICMS
  • 2: Contribuinte isento
  • 9: Não Contribuinte
Allowed:
string

Logradouro do destinatário

string

Número do logradouro do destinatário

string

Bairro do destinatário

string

Município do destinatário

string

UF do destinatário

string

CEP do destinatário

string

País do destinatário

string

Telefone do destinatário

float

Valor total do frete

float

Valor total do seguro

float

Valor total do desconto

float

Valor das despesas acessórias

float

Valor total da nota fiscal

float

Valor total dos produtos

integer
enum

Modalidade do frete:

  • 0: Por conta do emitente
  • 1: Por conta do destinatário
  • 2: Por conta de terceiros
  • 9: Sem frete
Allowed:
items
array of objects
required

Lista de itens da NFe

items*
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated 3 months ago

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html

Updated 3 months ago