v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB

NFCom

Emitir

Quando uma NFCom é 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 NFCom não será aceita e você receberá uma mensagem de erro de forma síncrona.

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

Para verificar se a NFCom 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 verificar a listagem completa de campos veja o link a seguir.

Documentação completa de campos da NFCom

post/nfcom

Query parameters

refstring required

Example:123456

Referência da NFCom

Request body

natureza_operacaostring required

Natureza da Operação.

data_emissaostring date-time required

Data e hora de emissão da NFCom.

tipo_documentostring required

Tipo de Documento da NFCom.

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 destinatário.

telefone_destinatariostring

Telefone do destinatário.

valor_totalstring required

Valor total da NFCom.

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 NFCom.

statusstring

Status da NFCom