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
| auth | Token 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
- A comanda deve estar com a coluna
STATUSda tabelaCAPAPREigual a 0 (indicando que está aberta). - Para verificar a situação da comanda antes da emissão, utilize o endpoint Consulta de Status da Comanda (Pré-venda).
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:
- Preencher a coluna
CPT_FI_NRREGcom o valor deFI_NRREGda tabelaCAPAPRE, referente à comanda utilizada; - Deixar vazias as colunas
CPT_NUMEROeCPT_SERIE.