Este material explica como o sistema ILLI se conecta à Credsystem para consultar faturas, receber pagamentos e operar o Totem PIX nas lojas.\## Em linguagem simples
O sistema permite que a loja **consulte a fatura do clientecliente** pelo CPF, **receba o pagamentopagamento** (dinheiro, cartão ou PIX) e **registre tudotudo** no caixa e no histórico da loja.
Existem três formas principais de uso:
Portal no computador — o operador atende o cliente no balcão.
Totem PIX — o cliente paga sozinho na tela de autoatendimento.
App Gestor no celular — configura qual caixa e impressora cada funcionário usa.
Tudo isso conversa com os servidores da Credsystem (empresa do cartão/fatura) pela internet, de forma segura.
Cliente / Operador Sistema ILLI (bibliotecas) Credsystem (na internet) Caixa / PDV (receita) Totem PIX App Gestor Figura 1 — O ILLI fica no meio: recebe o pedido da loja, fala com a Credsystem e registra no caixa.\## Glossário — palavras que você vai encontrar
CPFNúmero de identificação do cliente. É usado para buscar a fatura dele.Extrato / FaturaConta que o cliente precisa pagar. Pode ter valor total, valor mínimo ou parcelas.Entidade / LojaCada unidade de negócio cadastrada no ILLI. Cada loja tem sua própria configuração.CaixaO ponto de venda onde o operador trabalha. O pagamento pode gerar uma entrada de dinheiro no caixa.Pré-autorizaçãoPasso em que a Credsystem \*reserva*reserva\* o pagamento antes de confirmar de vez. É como "segurar" o valor.EfetivaçãoConfirmação final do pagamento na Credsystem.Estorno / DesfazimentoCancelar um pagamento que já foi feito. Só é permitido em alguns casos e dentro de um prazo.PIXForma de pagamento instantânea pelo celular, usando QR Code.TotemTela de autoatendimento na loja, onde o cliente paga sozinho pelo PIX.IntegradorBanco de dados auxiliar que guarda histórico de clientes, pagamentos e avaliações do totem.PDVSistema de ponto de venda do ILLI. Registra entradas e saídas de dinheiro no caixa.\## Detalhes para T.I.
O diretório `bibliotecas/` contém 5 módulos PHP independentes, cada um identificado por UUID:
UUIDClasseFunção`981bfb94-…``api_integracao_credsystem`api\_integracao\_credsystem`Cliente REST/OAuth Credsystem`88e14c87-…``api_integracao_credsystem_pagamento_total`api\_integracao\_credsystem\_pagamento\_total`Portal, totem, PDV, banco integrador`857e21c5-…``credsystem_gestor_configuracoes`credsystem\_gestor\_configuracoes`Config caixa/impressora por usuário`4ac2090b-…``izap`Envio WhatsApp via iZap`f3d67c71-…``configCredsystem`Tela legada (substituída pela Quasar em `981bfb94`)
