Implementação de recebimentos e integração com terminais Stone para pagamentos com cartão e PIX (FACILITEC) - NT 0143/2025
Resumo da Nota Técnica
Integrado recebimento e pagamento com a maquininha Stone no FaciliteC.
Detalhes da Nota Técnica
Passo a passo de como realizar um pagamento via Stone:
Abra a aplicação e clique em "Recebimento":
Selecione nos botões acima o tipo de comanda que deseja filtrar as comandas em aberto e clique na comanda que deseja realizar o recebimento:
Selecione a cobrança "STONE":
Após selecionar stone, aparecerá a tela abaixo. Após isso, digite o valor que irá receber neste pagamento e selecione o tipo de pagamento (cartão de crédito à vista, parcelado emissor, parcelado lojista, débito ou PIX):
Após confirmar, deverá aparecer uma tela semelhante a tela abaixo, indicando que a maquininha está aguando o usuário inserir/aproximar o cartão para pagamentos em cartão, ou aguardando o usuário ler e pagar o QR Code, no caso de pagamentos em PIX:
Após o pagamento, a maquininha retornará para a tela do FACILITEC com o pagamento realizado e para enviar a cobrança para o aplicativo Comanda no FACILITE, é necessário clicar em confirmar novamente. Se o usuário clicar em "voltar", a cobrança será cancelada no app FACILITEC (não será cancelada na Stone, o usuário deve fazer o cancelamento manualmente nesse caso). Lembrando que após a confirmação do pagamento, será impresso o relatório de pedido automaticamente.
Passo a passo de como realizar a impressão do pedido manualmente:
Entre no app e clique no botão "Consumo":
Clique no tipo de comanda que deseja listar:
Neste caso, utilizaremos uma mesa, então selecionamos "Mesa" e serão listadas todas as mesas:
Clique em uma das mesas abertas (mesas em amarelo significa que já foram recebidas, então não é possível "entrar" nelas) e clique em "Imprimir Comanda":
Após clicar em "Imprimir Comanda, um relatório semelhante a este deve ser impresso":
Detalhes técnicos das alterações:
- Implementações:
* Sincronização das seguintes entidades do Facilite através do ServerFaciliteC: Representantes, cobranças, empresa, tipo de comanda, comanda, vencimentos da comanda, itens da comanda, relação entre itens da comanda e ingredientes (preparar sem) e relação entre itens da comanda e complementos (adicionar). * As entidades de representantes, empresa, cobranças e tipo de comanda são sincronizadas no botão "Sincronizar dados", na tela de Configurações. * As entidades tipo de comanda, comanda, vencimentos da comanda, itens da comanda, relação entre itens da comanda e ingredientes (preparar sem) e relação entre itens da comanda e complementos (adicionar) são sincronizadas ao entrar no Consumo, ao finalizar um recebimento, ou ao clicar nos botões de tipo de comanda na tela de listagem das comandas em aberto ou em recebimento parcial antecedente a tela de Recebimento. * Recebimento offline (para cobranças comuns). * Recebimento online com Stone (cartão de crédito, cartão de débito, PIX e seus derivados, que seriam o crédito parcelado emissor, crédito parcelado lojista e crédito à vista). * Relatório de pedido, que inclui informações sobre os itens do pedido, como o valor unitário, unidade, total da comanda com taxas, total da comanda sem taxas, valor das taxas e descontos separados e listagem de recebimentos agrupando o valor por tipo de cobrança (ex: 2 recebimentos feitos com a cobrança STONE de R$ 2,00 aparecem do relatório como apenas uma linha de R$ 4,00. Se for outra cobrança, aparecerá em outra linha, respectivamente). A impressão do relatório ocorrerá ao clicar em "Confirmar", na tela de Recebimento, ou ao clicar em "Imprimir Comanda", na tela de Consumo. Lembrando que nos dispositivos que não são terminais da Stone, o botão "Imprimir Comanda" continua com a mesma funcionalidade de antes * Algoritmo que limpa da memória tamporária do dispositivo as telas consideradas "inúteis" para o processo de recebimento quando o usuário inicia o mesmo. Ao finalizar o recebimento, as demais telas do aplicativo são iniciadas estritamente de forma sequencial e sob demanda conforme o usuário for utilizando a aplicação e iniciando as telas manualmente ou caso o usuário inicie uma ação que dependa da tela que foi "finalizada" pelo algoritmo. Lembrando que a decisão da implementação do algoritmo foi tomada por conta das limitações de memória temporária nos terminais L3 e L4 de 1GB de RAM da Positivo, que são redistribuídos com a marca da Stone. - Alterações: * O ServerFaciliteC foi alterado em questão das rotas de listagem de comandas para prover tabém as entidades de tipo de comanda, vencimentos da comanda, relação entre itens da comanda e ingredientes (preparar sem) e relação entre itens da comanda e complementos (adicionar), além das entidades de comanda e itens da comanda que já existiam.
