Tabela de conteúdos

POST - Emissão de NFC-e pela Comanda (Pré-venda)


Este endpoint realiza a emissão de uma Nota Fiscal de Consumidor Eletrônica (NFC-e) a partir de uma comanda previamente registrada no sistema. Durante o processo, a nota é transmitida ao SEFAZ, gerando o respectivo PDF autorizado da nota fiscal, retornado em formato Base64.

api/nfce?comanda=0000

O parâmetro enviado na URL é obrigatório.

🌐 Exemplo URL

localhost:8090/api/nfce?comanda=123

O número informado é código da pré-venda corresponde à coluna FI_NRREG da tabela CAPAPRE.

🛡️ Parâmetros do Header

authToken adquirido no Login.

🧾 Exemplos de Retorno

{
    "bemSucedido": true,
    "mensagemFalha": null,
    "novoCodigo": null,
    "dados": {
        "bemSucedido": true,
        "numeroNota": 1505,
        "serieNota": "A8",
        "descricaoRetorno": "Nota fiscal de teste autorizada",
        "notaFiscalPdf": "JVBERi0xLjQNCiWio4+TDQo5IDAgb2JqDQo8PC9OIDMgL0FsdGVybmF0ZSAvRGV2aWNlUkdCIC9GaWx0ZXIgL0ZsYXRlR..."
    }
}

O campo notaFiscalPdf contém o arquivo PDF da NFC-e autorizada pela SEFAZ, codificado em Base64.

⚙️ Pré-requisitos

Antes de realizar a emissão da NFC-e pela comanda, é necessário garantir que as condições abaixo estejam atendidas:

Comanda fechada

Parâmetro do usuário Totem PAF

Campo Valor
PSS_NR_SISTEMA 70
PSS_COD_PARAM USUARIO_TOTEM_PAF
PSS_VALOR Código Funcionário

É obrigatório cadastrar o parâmetro USUARIO_TOTEM_PAF na base de dados Firebird. O valor do parâmetro deve ser o código do funcionário (FUNCIONARIOS) responsável pela comanda, ou seja, o valor presente na coluna CX_CODIGO da tabela CAPAPRE.

Vinculação do comprovante TEF

Para localizar corretamente o registro de comprovante na tabela COMPROVANTESTEF, é necessário: