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

<code>
api/nfce?comanda=0000
</code>

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

===== 🌐 Exemplo URL =====

<code>
localhost:8090/api/nfce?comanda=123
</code>

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

===== 🛡️ Parâmetros do Header =====

|auth|Token adquirido no [[:enduser:erp:developer:integracao:integracaowebservice:primeirospassos:login|]].|

===== 🧾 Exemplos de Retorno =====

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

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 ''STATUS'' da tabela ''CAPAPRE'' igual a 0 (indicando que está **aberta**).
  * Para verificar a situação da comanda antes da emissão, utilize o endpoint **[[:enduser:erp:developer:integracao:integracaowebservice:restaurante:statuscomanda|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_NRREG'' com o valor de ''FI_NRREG'' da tabela ''CAPAPRE'', referente à comanda utilizada;
  * Deixar vazias as colunas ''CPT_NUMERO'' e ''CPT_SERIE''.