Geranet NFe

NFe / NFCe

Endpoints para emissão, cancelamento, carta de correção e inutilização de numeração de NFe (modelo 55) e NFCe (modelo 65).

POST /api/v1/nfe/emitir

Emite uma NFe ou NFCe via integração com o acbrcmd. O corpo da requisição deve ser um JSON no formato esperado pelo acbrcmd.

Campos obrigatórios no corpo (raiz)

  • acao — use "emitir"
  • modeloDocumento — use "nfe"
  • certificadoDigital — conteúdo do certificado A1 em hexadecimal
  • senhaCertificadoDigital — senha do certificado
  • modelo — "55" NFe ou "65" NFCe
  • ufEmitente — UF do emitente (ex.: "SP")
  • nfe — objeto com os dados da nota (emitente, destinatário, itens, etc.)

Exemplos de código

curl -X POST "https://nfe.geranet.net/api/v1/nfe/emitir" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"acao":"emitir","modeloDocumento":"nfe","certificadoDigital":"...","senhaCertificadoDigital":"...","ambiente":"2","modelo":"55","ufEmitente":"SP","nfe":{...}}'

Exemplo de payload

Escolha entre exemplo simples (NFe ou NFCe) ou a estrutura completa (NFe). Os payloads são os arquivos em resources/documentacao/exemplos-payloads/. O certificado deve ser enviado em certificadoDigital em hexadecimal. Para NFCe use modelo = "65".

Nos JSONs, dataEmissao e dataSaida servem apenas como exemplo; na emissão real use data e hora atuais.

{
    "acao": "emitir",
    "modeloDocumento": "nfe",
    "certificadoDigital": "(conteúdo do certificado A1 em hexadecimal)",
    "senhaCertificadoDigital": "sua_senha",
    "ambiente": "2",
    "modelo": "55",
    "ufEmitente": "SP",
    "nfe": {
        "empresa": {
            "cnpj": "00000000000191",
            "inscricaoEstadual": "123456789",
            "razaoSocial": "COMERCIAL EXEMPLO LTDA",
            "nomeFantasia": "COMERCIAL EXEMPLO",
            "telefone": "63900000000",
            "email": "financeiro@exemplo.com.br",
            "logradouro": "Rua das Flores",
            "numero": "100",
            "bairro": "Centro",
            "municipio": "ARAGUAINA - TO",
            "codigoMunicipio": "170210",
            "uf": "TO",
            "cep": "77800000",
            "codigoRegimeTributario": "1",
            "tipoAtividade": "3",
            "serie": "2",
            "contingencia": "nao"
        },
        "cliente": {
            "cpf": "12345678909",
            "razaoSocial": "João da Silva",
            "consumidorFinal": "1",
            "indicadorIEdestinatario": "9",
            "telefone": "11900000000",
            "email": "cliente@exemplo.com.br",
            "logradouro": "Av. Brasil",
            "numero": "500",
            "bairro": "Vila Nova",
            "municipio": "ARAGUAINA - TO",
            "codigoMunicipio": "170210",
            "codigoPais": "1058",
            "nomePais": "Brasil",
            "uf": "TO",
            "cep": "77800001"
        },
        "indicativoIntermediador": "0",
        "dataSaida": "2026-03-27 12:00:00",
        "dataEmissao": "2026-03-27 12:00:00",
        "modelo": "55",
        "ambiente": "2",
        "tipo": "1",
        "frete": "9",
        "finalidade": "1",
        "naturezaOperacao": "Venda de Produtos ou Servicos",
        "itens": [
            {
                "quantidade": "1.00000000",
                "valorUnitario": "20.00000000",
                "valorTotal": "20.00",
                "ncmProduto": "07099911",
                "tipoItem": "00",
                "codigoProduto": "1",
                "nomeProduto": "Produto",
                "cfop": "5102",
                "unidadeMedidaProduto": "UNID",
                "origemProduto": "0",
                "icmsCst": "102",
                "pisCst": "8",
                "pisAliquota": "0.65",
                "cofinsCst": "8",
                "cofinsAliquota": "3.0",
                "federaisRetido": "nao",
                "aliquotaInss": "0.0000",
                "aliquotaIrrf": "0.0000",
                "aliquotaCsll": "0.0000"
            }
        ]
    }
}

Respostas

A API retorna JSON com a estrutura abaixo. Em caso de sucesso na emissão, a resposta inclui ainda:

  • numero — número da nota (nNF)
  • chave — chave de acesso da NFe/NFCe (44 dígitos), para uso em cancelamento, consulta ou carta de correção
  • protocolo — número do protocolo de autorização da SEFAZ
  • cstat — código de status retornado pela SEFAZ (ex.: 100 autorizado, 204 duplicidade)

Sucesso (HTTP 200)

{
  "situacao": "sucesso",
  "mensagem": "NFe emitida com sucesso.",
  "xml": "(conteúdo do XML em hexadecimal)",
  "pdf": "(conteúdo do PDF em hexadecimal)",
  "cstat": "100",
  "numero": "000001",
  "chave": "35260218612608000132550020000000031369409922",
  "protocolo": "135260000368176"
}

Erro (HTTP 422)

{
  "situacao": "erro",
  "mensagem": "Rejeição 204: Duplicidade de NF-e. Chave já existente na base da SEFAZ.",
  "cstat": "204",
  "xml": "",
  "pdf": ""
}

Em caso de erro, os campos numero, chave e protocolo não são retornados.

← Introdução ? NFSe ?