Como utilizar o componente ACBrSmartTEF
O componente ACBrSmartTEF foi desenvolvido para facilitar a integração com o SmartTEF, permitindo, entre outras coisas, criar, consultar e cancelar ordens de pagamento de forma simples e padronizada.
O exemplo incluído nos fontes do ACBr demonstra todas as principais funcionalidades e como configurar corretamente o componente.
Configuração inicial
Na aba “Configuração”, você deve informar os parâmetros necessários para comunicação com o SmartTEF:
Seção Smart TEF
GW-Token-Integrador → Token fornecido pelo SmartTEF para o integrador
CNPJ Integrador → CNPJ do integrador cadastrado
GW-Token-Loja → GW-Token específico da loja
CNPJ Loja → CNPJ da loja vinculada
JWT-Token-Integrador → Token JWT
Seção Proxy (opcional)
Permite configurar acesso via proxy caso a rede exija autenticação.
Seção Log
Define o arquivo e o nível de log (Ex: “Muito Alto” para depuração detalhada).
Após preencher os dados, clique em Salvar Parâmetros para gravar as configurações no arquivo SmartTEFTeste.ini.
Ordens de Pagamento
Na aba Endpoints > ERP > Ordens de Pagamento, é possível criar novas ordens:
Tipo Pagamento: CREDIT, DEBIT, PIX, VOUCHER, OUTROS.
Parcelas: número de parcelas da venda (Apenas para Credito)
Valor: valor total da operação
Tipo Ordem: NRM (Será criado um card para todos os terminais), CRD_UNICO (A ordem será enviada APENAS para um terminal específico)
Tipo Juros: F_CLIENT, F_STORE.
ID Usuário: Id do usuário logado no terminal (Enviado APENAS caso o tipo seja CRD_UNICO).
Serial POS: número de série do terminal (Enviado APENAS caso o tipo seja CRD_UNICO).
CPF/CNPJ e Nome: dados opcionais do cliente
Ao clicar em Criar, a aplicação enviará a requisição e exibirá no Log das Operações o JSON de retorno.
Ordens de Impressão
Na aba ERPs > Ordens de Impressão, é possível gerar comandos de impressão para comprovantes, definindo:
Tipo Ordem: NRM (Será criado um card para todos os terminais), CRD_UNICO (A ordem será enviada APENAS para um terminal específico)
Print Id: Id da impressão
ID Usuário: Id do usuário logado no terminal (Enviado APENAS caso o tipo seja CRD_UNICO).
Serial POS: número de série do terminal (Enviado APENAS caso o tipo seja CRD_UNICO).
Arquivo: Arquivo de imagem enviado para impressão
Log das Operações
O painel lateral exibe todas as etapas executadas pelo componente:
Leitura e gravação da configuração
Comunicação com a API SmartTEF
Respostas JSON das ordens criadas, consultadas, canceladas, etc.
Demais Funcionalidades
Além dessas principais funcionalidades, também é possível Listar Terminais, Usuários, Consultar Lojas...
Comunicação com a API SmartTEF
Respostas JSON das ordens criadas, consultadas, canceladas, etc.
Equipamentos homologados para uso do SmartTEF em Produção:
Rede: Laranjinha Positivo L400, N960K
Cielo: LIO 2, LIO ON, AXIUM DX8000
Getnet: P2, P3, N910, A8, AXIUM DX8000
Stone: A8, P2, L400
Sipag: AXIUM DX8000, P2, X990
Sicredi: FLEX 405 (Clover)
PagBank: P2, A930, GPOS780
SafraPay: P2, A8, L300
Vero: L300, N950, P2
CAIXA: FLEX 405 (Clover)
Bin: FLEX 405 (Clover)
Clover: FLEX 405
Phoebus: L300, A910, A920
Fonte: https://www.smarttef.com.br/
Veja também: https://linktr.ee/POS.SmartTEF