Files

Welton Silva 9ef245b9fe feat: Add payment partial support, comanda printing, and direct print configuration

- Implement partial payment flow with 'Pagamento Parcial' button
- Calculate remaining value considering existing payments
- Add payment tracking in comanda list and PDV modal
- Add 'Imprimir' button for comanda receipt printing
- Add print silent mode configuration
- Fix product name display in print and list views
- Add fallback when no printer is configured

2026-04-04 17:35:21 -03:00

2.6 KiB

Raw Blame History

RRBEC Middleware - Guia de Integração (Electron/Desktop)

Este guia documenta como a aplicação Electron deve se comunicar com o servidor middleware local em Go.

1. Configurações Base

URL Base: http://localhost:8080/api/v1
Porta Default: 8080 (configurável no arquivo .env do servidor).
Formato: Todas as requisições e respostas utilizam application/json.

2. Autenticação (SimpleAuth)

O servidor não utiliza tokens JWT complexos localmente. A autenticação funciona assim:

Faça login em /login enviando username e password.
O servidor retornará um objeto de usuário. Capture o valor do campo id (inteiro).
Envie esse valor no cabeçalho HTTP X-User-ID em todas as rotas marcadas como [PROTEGIDO].

3. Endpoints da API

POST /login

Body: { "username": "seu_usuario", "password": "sua_senha" }
Retorno: Objeto User completo.

[PÚBLICO] Listar Mesas

GET /mesas

Retorno: Array de objetos mesas com id, uuid, name, active.

[PÚBLICO] Listar Produtos/Estoque

GET /products

Retorno: Array de produtos com preços e quantidade em estoque.

[PÚBLICO] Listar Categorias

GET /categories

[PÚBLICO] Listar Clientes

GET /clients

[PÚBLICO] Listar Pedidos (Cozinha/Orders)

GET /orders

[PÚBLICO] Listar Tipos de Pagamento

GET /payment-types

[PÚBLICO] Listar Pagamentos Realizados

GET /payments

[PÚBLICO] Ver Comanda por ID

GET /comandas/:id (Ex: /api/v1/comandas/9)

Retorno: Detalhes da comanda.

4. Comandas e Itens (Ações)

[PROTEGIDO] Abrir Nova Comanda

POST /comandas

Headers: X-User-ID: <id_do_usuario>
Body: { "mesa_id": 1, "client_id": null }

[PROTEGIDO] Lançar Pedido (Adicionar Item)

POST /items-comanda

Headers: X-User-ID: <id_do_usuario>
Body: { "comanda_id": 9, "product_id": 50, "applicant": "Nome do Garçom" }

[PROTEGIDO] Deletar Item Individual

DELETE /items-comanda/:id

Headers: X-User-ID: <id_do_usuario>

[PROTEGIDO] Limpar e Fechar Comanda (Apagar Inteira)

POST /comandas/:id/apagar

Headers: X-User-ID: <id_do_usuario>
Efeito: Remove todos os itens da comanda e muda o status para CLOSED.

[PROTEGIDO] Pagar e Fechar Comanda

POST /comandas/:id/pagar

Headers: X-User-ID: <id_do_usuario>

Body:

{
    "value": 50.00,
    "type_pay_id": 1,
    "client_id": null
}

Efeito: Registra o pagamento localmente e fecha a comanda.

2.6 KiB Raw Blame History