v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB

NFGás (Beta)

Emitir

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

post/nfgas

Query parameters

refstring required

Example:123456

Referência da NFGás

Request body

natureza_operacaostring required

Natureza da Operação.

data_emissaostring date-time required

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

tipo_documentostring required

Tipo de documento da NFGás.

cnpj_emitentestring required

CNPJ do emitente (somente números).

inscricao_estadual_emitentestring required

Inscrição Estadual do emitente.

nome_emitentestring required

Nome/Razão Social do emitente.

nome_fantasia_emitentestring

Nome fantasia do emitente.

logradouro_emitentestring

Logradouro do endereço do emitente.

numero_emitentestring

Número do endereço do emitente.

complemento_emitentestring

Complemento do endereço do emitente.

bairro_emitentestring

Bairro do endereço do emitente.

codigo_municipio_emitentestring

Código IBGE do município do emitente.

municipio_emitentestring

Nome do município do emitente.

cep_emitentestring

CEP do endereço do emitente.

uf_emitentestring

UF do emitente.

telefone_emitentestring

Telefone do emitente.

cnpj_destinatariostring required

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

inscricao_estadual_destinatariostring required

Inscrição Estadual do destinatário.

nome_destinatariostring required

Nome/Razão Social do destinatário.

nome_fantasia_destinatariostring

Nome fantasia do destinatário.

logradouro_destinatariostring

Logradouro do endereço do destinatário.

numero_destinatariostring

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

complemento_destinatariostring

Complemento do endereço do destinatário.

bairro_destinatariostring

Bairro do endereço do destinatário.

codigo_municipio_destinatariostring

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

municipio_destinatariostring

Nome do município do destinatário.

cep_destinatariostring

CEP do endereço do destinatário.

uf_destinatariostring

UF do destinatario.

telefone_destinatariostring

Telefone do destinatario.

valor_totalstring required

Valor total da NFGás.

valor_fretestring

Valor do frete.

valor_segurostring

Valor do seguro.

valor_descontostring

Valor do desconto.

valor_outras_despesasstring

Valor de outras despesas.

cfopstring required

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

codigo_municipiostring required

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

municipiostring required

Nome do município de ocorrência.

ufstring required

UF de ocorrência.

observacoesstring

Observações adicionais.

forma_pagamentostring

Forma de pagamento.

condicao_pagamentostring

Condição de pagamento.

Example request

{
  "natureza_operacao": "Venda de mercadoria",
  "data_emissao": "2024-01-15T10:00:00-03:00",
  "tipo_documento": "0",
  "cnpj_emitente": "12345678000123",
  "inscricao_estadual_emitente": "123456789",
  "nome_emitente": "EMPRESA LTDA",
  "nome_fantasia_emitente": "EMPRESA",
  "logradouro_emitente": "Rua das Flores",
  "numero_emitente": "123",
  "complemento_emitente": "Sala 1",
  "bairro_emitente": "Centro",
  "codigo_municipio_emitente": "3550308",
  "municipio_emitente": "São Paulo",
  "cep_emitente": "01234-567",
  "uf_emitente": "SP",
  "telefone_emitente": "11999999999",
  "cnpj_destinatario": "12345678000123",
  "inscricao_estadual_destinatario": "987654321",
  "nome_destinatario": "CLIENTE LTDA",
  "nome_fantasia_destinatario": "CLIENTE",
  "logradouro_destinatario": "Av. Principal",
  "numero_destinatario": "456",
  "complemento_destinatario": "Andar 2",
  "bairro_destinatario": "Vila Nova",
  "codigo_municipio_destinatario": "3550308",
  "municipio_destinatario": "São Paulo",
  "cep_destinatario": "01234-567",
  "uf_destinatario": "SP",
  "telefone_destinatario": "11988888888",
  "valor_total": "100.00",
  "valor_frete": "10.00",
  "valor_seguro": "5.00",
  "valor_desconto": "15.00",
  "valor_outras_despesas": "2.00",
  "cfop": "5102",
  "codigo_municipio": "3550308",
  "municipio": "São Paulo",
  "uf": "SP",
  "observacoes": "Observação importante",
  "itens": [
    {
      "codigo_produto": "001",
      "descricao": "Produto exemplo",
      "quantidade": "10.00",
      "valor_unitario": "10.00",
      "valor_total": "100.00",
      "unidade_comercial": "UN",
      "codigo_ncm": "12345678",
      "cfop": "5102"
    }
  ],
  "forma_pagamento": "01",
  "condicao_pagamento": "À vista"
}

Response

Requisição aceita para processamento

cnpj_emitentestring

CNPJ do emitente

refstring

Referência única da NFGás.

statusstring

Status da NFGás