Emitir

post

https://api.focusnfe.com.br/v2/nfgas

Quando uma NFGás é enviada para processamento, é realizada uma pré-validação, caso ocorra algum problema como: ausência de campos essenciais, formato de dados incorreto ou problemas com o cadastro do emitente em nossa base, a NFGás não será aceita e você receberá uma mensagem de erro de forma síncrona.

Caso a NFGás seja aceita para processamento, ela será enviada para uma fila e será processada de forma assíncrona. Com isto, a NFGás poderá ser autorizada ou retornar um erro, de acordo com a validação da SEFAZ.

Para verificar se a NFGás já foi autorizada, você terá que efetuar uma consulta ou se utilizar de webhooks (gatilhos).

Abaixo você poderá verificar uma listagem dos principais campos disponíveis. Para acompanhar publicações técnicas oficiais consulte o portal da NFGás.

Documentação completa de campos da NFGás

Query Params

ref

string

required

Referência da NFGás

Body Params

natureza_operacao

string

required

Natureza da Operação.

data_emissao

date-time

required

Data e hora de emissão da NFGás.

tipo_documento

string

required

Tipo de documento da NFGás.

cnpj_emitente

string

required

CNPJ do emitente (somente números).

inscricao_estadual_emitente

string

required

Inscrição Estadual do emitente.

nome_emitente

string

required

Nome/Razão Social do emitente.

nome_fantasia_emitente

string

Nome fantasia do emitente.

logradouro_emitente

string

Logradouro do endereço do emitente.

numero_emitente

string

Número do endereço do emitente.

complemento_emitente

string

Complemento do endereço do emitente.

bairro_emitente

string

Bairro do endereço do emitente.

codigo_municipio_emitente

string

Código IBGE do município do emitente.

municipio_emitente

string

Nome do município do emitente.

cep_emitente

string

CEP do endereço do emitente.

uf_emitente

string

UF do emitente.

telefone_emitente

string

Telefone do emitente.

cnpj_destinatario

string

required

CNPJ do destinatário (somente números).

inscricao_estadual_destinatario

string

required

Inscrição Estadual do destinatário.

nome_destinatario

string

required

Nome/Razão Social do destinatário.

nome_fantasia_destinatario

string

Nome fantasia do destinatário.

logradouro_destinatario

string

Logradouro do endereço do destinatário.

numero_destinatario

string

Número do endereço do destinatário.

complemento_destinatario

string

Complemento do endereço do destinatário.

bairro_destinatario

string

Bairro do endereço do destinatário.

codigo_municipio_destinatario

string

Código IBGE do município do destinatário.

municipio_destinatario

string

Nome do município do destinatário.

cep_destinatario

string

CEP do endereço do destinatário.

uf_destinatario

string

UF do destinatario.

telefone_destinatario

string

Telefone do destinatario.

valor_total

string

required

Valor total da NFGás.

valor_frete

string

Valor do frete.

valor_seguro

string

Valor do seguro.

valor_desconto

string

Valor do desconto.

valor_outras_despesas

string

Valor de outras despesas.

cfop

string

required

CFOP - Código Fiscal de Operações e Prestações.

codigo_municipio

string

required

Código IBGE do município de ocorrência.

municipio

string

required

Nome do município de ocorrência.

string

required

UF de ocorrência.

observacoes

string

Observações adicionais.

itens

array of objects

Lista de itens da NFGás.

itens

forma_pagamento

string

Forma de pagamento.

condicao_pagamento

string

Condição de pagamento.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

202Requisição aceita para processamento

401Não autorizado

403Ação não permitida