Home

Manual Desenvolvedor

1. C digos Retorno Hexadeci Decimal Significado mal 0x0000 0 Sucesso 0x0003 3 Estabelecimento comercial inv lido 0x0006 6 Erro 0x0009 9 Transa o em andamento 0x000C 12 Transa o inv lida 0x000D 13 Valor da transa o inv lido 0x000E 14 Cart o inv lido 0x000F 15 Institui o n o cadastrada 0x0013 19 Refa a transa o 0x001E 30 Erro de formato 0x001F 31 Institui o n o pertence rede 0x0026 38 Excedido o n mero de tentativas do PIN 0x0029 41 Cart o extraviado 0x002B 43 Cart o roubado 0x0033 51 Saldo insuficiente 0x0034 52 Conta corrente n o cadastrada 0x0036 54 Cart o vencido 0x0037 55 Senha incorreta 0x0038 56 Cart o sem registro 0x0039 57 Transa o n o permitida a esse cliente 0x003C 60 Entrar em contato com a institui o 0x003D 61 Excedido o limite de saque 0x0041 65 Excedida a frequ ncia de saque 0x004C 76 Cart o bloqueado 0x004D 77 Pendente de confirma o 0x004E 78 Transa o cancelada 0x004F 79 Transa o n o permitida neste ciclo 0x0050 80 Transa o inexistente 0x0051 81 Transa o estornada 0x0052 82 Chave de criptografia inv lida 0x0053 83 Timeout 0x0054 84 Logon Desfazimento 0x0055 85 Problema rede local 0x0056 86 Transa o desfeita 0x0059 89 Mensagem enviada pelo Host Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 196 OKI
2. 092 Consulta Saldo D bito 093 Resumo de Pagamentos 094 Baixa de O S 095 Teste de Comunica o 096 Estat stica 097 Moedeiro 098 Compra com Cart o Dinheiro 099 Estorno da compra com Cart o Dinheiro 100 Consulta Contrato 101 Saque INSS 102 Saque Cpcheque 103 Consulta Vale G s 104 Compra de Cheque Pr Datada 105 Dep sito CDB 106 Resgate CDB 107 Estorno de Dep sito CDB 108 Estorno de Resgate CDB 109 Compra com Cart o de Cr dito com juros 110 Carga de Cart o Dinheiro 111 Consulta Saldo do Cart o Dinheiro 112 Estorno da Carga de Cart o Dinheiro 113 Parcele Mais 114 Estorno do Parcele Mais 115 Transa o Off line 118 Troco Surpresa Chance Legal 121 Consulta Resgate de Pr mios 122 Pagamento de DARF 123 Pagamento de GPS 124 Inje o de chaves 125 D bito parcelado pela administradora 126 Envio de off line 127 Atualiza o de chip 128 Autoriza o de Voucher 133 Simula o Credi rio 134 Credi rio 136 Atualiza o de pre os 142 Cancelamento de Autoriza o de Voucher Conv nios As transa es relacionadas s transa es de PBM exigem o c digo das redes as quais s o listadas abaixo C digos do Conv nio Hexadeci Significado Fal Decimal 0x0001 0001 E Pharma 0x0002 0002 Vidalink 0x0003 0003 PrevSaude 0x0004 0004 Funcional Card 0x000
3. C digos Retorno Hexadeci Decimal Significado mal 0x005A 90 Fechamento cont bil 0x005B 91 Institui o temporariamente fora de opera o 0x0100 256 Retorno gen rico para c digos alfanum ricos Para obter o exato c digo alfanum rico retornado necess rio chamar a fun o ScopeObtemCampoExt passando o bit equivalente ao c digo de resposta ver Obtendo os campos 0x0101 257 Cliente com restri o na lista negra local 0x0102 258 J consultou sob mesmo banco e ag ncia 0x0103 259 J consultou sob banco e ou ag ncia diferente s 0x0104 260 C digo GAR n o autorizado 0x0105 261 Compre Saque Redecard aprovado parcial 0x0106 262 Voucher Redecard aprovado parcial 0x0107 263 Informa o de transa o aprovada com pr mio C digos de erros do SCOPE Em qualquer momento na chamada de qualquer fun o o SCOPE Client devolver um c digo de retorno O c digo que n o estiver na rela o dos c digos de coleta e na das autorizadoras encontram se abaixo e geralmente denota um erro C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFAOS 64003 Par metro 3 inv lido OxFAO4 64004 Par metro 4 inv lido OxFAO5 64005 Par metro 5 inv lido OxFBO1 64257 N o foi poss vel criar a thread
4. OxFC26 64550 Coletar plano de pagamento Fininvest OxFC28 64552 Coletar n mero do item Fininvest OxFC34 64564 Coleta o valor da transa o OxFC53 64595 Coleta c digo do material OxFC6D 64621 Coleta a data de emiss o do cart o OxFC6E 64622 Coleta o plano Infocards OxFC6F 64623 Coleta n mero do cupom fiscal OxFCOE 64526 Coletar quantidade de parcelas OxFC15 64533 Coletar valor de entrada OxFC1B 64539 Imprime consulta OxFC20 64544 Coletar o n mero da pr autoriza o OxFC23 64547 Coletar CEP OxFC33 64563 Coleta valor da taxa de servi o OxFC64 64612 Coleta RG OxFC7E 64638 Go On Chip OxFC80 64640 Coleta o valor da taxa de embarque OxFC84 64644 Obt m os servi os OxFC85 64645 Coleta o cart o digitado OxFC8A 64650 Coleta a data quando o cliente aderiu ao cart o OxFC29 64553 Coletar c digo de seguran a OxFC2F 64559 Coleta c digo da localidade do telefone OxFC30 64560 Coleta n mero do telefone OxFC51 64593 Imprime cupom promocional OxFCA5 64677 Coleta o n mero do Voucher OxFCFE 64766 Mostrar informa es e retornar fluxo para o cliente SCOPE OxFCFF 64767 Mostrar Informa es e aguardar confirma o do operador Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro
5. C digos Retorno Hexadeci Decimal Significado mal OxFCOO 64512 Coletar cart o OxFCO1 64513 Coletar validade do cart o OxFCO2 64514 Imprime Cupom OxFCO3 64515 Coletar CGC ou CPF OxFCO9 64521 Coletar se a transa o ser a vista ou n o OxFCOB 64523 Coletar se a transa o ser pr datada OxFCOC 64524 Coletar se a parcela ser vista OxFCOD 64525 Coletar quantidade de dias entre parcelas OxFCOE 64526 Coletar quantidade de parcelas 0xFC10 64528 Coletar o dia e o m s DDMM 0xFC11 64529 Coletar a senha OxFC13 64531 Coletar a forma de pagamento OxFC14 64532 Coletar data do primeiro vencimento OxFC15 64533 Coletar valor de entrada OxFC18 64536 Coletar ltimos d gitos do cart o OxFC1IA 64538 Coletar se deseja consultar parcelas OxFC1B 64539 Imprime consulta O0xFC22 64546 Imprime nota promiss ria OxFC23 64547 Coletar CEP OxFC24 64548 Coletar n mero do endere o OxFC25 64549 Coletar parte num rica do complemento OxFC2B 64555 Coleta se com ou sem garantia de pr datado OxFC2C 64556 Coleta se aceita ou n o risco OxFC30 64560 Coleta n mero do telefone Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 59 OKI OxFC32 64562 Coleta data formato DDMMAA OxFC33 64563 Coleta valor da taxa de servi o OxFC47 64583 Col
6. Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 198 OKI C digos Retorno Hexadeci Decimal Significado mal OxFF28 65320 Opera o n o permitida OxFF29 65321 CNPJ CPF inv lido OxFF2A 65322 Primeiro bloco do c digo de barras est inv lido OxFF2B 65323 Segundo bloco do c digo de barras est inv lido OxFF2C 65324 Terceiro bloco do c digo de barras est inv lido OxFF2D 65325 Quarto bloco do c digo de barras est inv lido OxFF2E 65326 Dados adicionais AID do chip do cart o inexistente OxFF30 65328 Autorizador retornou dados inv lidos OxFF31 65329 Conta n o permitida OxFF32 65330 Conta vencida OxFF33 65331 N o existe resumo OxFF34 65332 C digo de barra inv lido OxFF35 65333 Erro na consist ncia do DAC OxFF36 65334 Erro no envio da confirma o ou desfazimento da transa o anterior OxFF37 65335 Servi o invertido a aplica o est tentando fazer uma transa o de d bito com um cart o de cr dito ou vice versa OxFF38 65336 Cart o n o permitido OxFF39 65337 Permitido somente a coleta do CPF consulta de cheque OxFF3A 65338 Erro interno na execu o da coleta OxFF3B 65339 Lista de produtos de medicamentos etc n o est dispon vel OxFF3C 65340 Erro de leitura do cart o OxFF3D 65341 Controle inv lido OxFF3SE 65342 Erro ao enviar mensagem para o servidor OxFF3F 65343 Interface SAB n o inicializa
7. Prot tipo LONG EXPORT ScopeSuspend LONG estado Par metros Estado de parada Indica o passo de execu o ap s o qual o controle de execu o retornar ao aplicativo O lin LONG stado SCOPE Client manter o contexto de sa da e aguardar que o aplicativo retome ou aborte o seu fluxo de execu o Ver a lista de c digos de estado na tabela Estados para interrup o Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal mal Significado 0xFA01 64001 Par metro 1 inv lido 0xFE01 65025 SCOPE API n o foi inicializada corretamente Exemplo definindo o ponto de suspens o retorno ScopeSuspend 4 LEMBRETE uma vez suspensa a transa o o SCOPE Client n o retomar sozinho necess rio que a aplica o notifique o SCOPE para retoma la Retomando a transa o Todo o tempo em que a transa o est suspensa a aplica o far algo que ela necessita Realizado o que a aplica o deveria fazer enquanto a transa o est suspensa a aplica o deve informar para o SCOPE que pode continuar caso contr rio a transa o n o ser conclu da Prot tipo LONG EXPORT ScopeResume void Par metros N o h par metro Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Significado Manual d
8. Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 111 OKI Obtendo teclas do PIN Pad O par de fun es ScopePPStartGetKey ScopePPGetKey captura uma tecla pressionada no PIN Pad Elas fazem parte do conjunto de fun es n o blocantes N o blocantes significa que a chamada a essas fun es s o de retorno imediato n o interrompendo o fluxo de processamento da aplica o Iniciando a leitura da tecla A fun o ScopePPStartGetKey respons vel pelo in cio do processo colocando o PIN Pad em modo de espera por uma tecla n o num rica Prot tipo LONG EXPORT ScopePPStartGetKey void Par metros N o h par metro Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x000A 10 Necess ria opera o previa 0x000F 15 PIN Pad n o foi aberto 0x00D3 211 PIN Pad n o foi aberto pela aplica o Obtendo a tecla Ap s ter posto o PIN Pad em modo de captura de tecla a fun o ScopePPStartGetKey dever ser chamada continuamente at que o retorno dela seja diferente de 1 PIN Pad em processamento Esta fun o finaliza o processo iniciado por ScopePPStartGetKey Enquanto o retorno for igual a 1 o processo pode ser cancelado pelo checkout atrav s da fun o ScopePPAbort Prot tipo LONG EXPORT ScopePPGetkKey void Par m
9. C digos Formato Hexadeci Decimal Significado mal 0x0000 00 String representando uma data no formato DDMMAA 0x0001 01 String representando uma data no formato DDMM 0x0002 02 String representando uma data no formato MMAA 0x0003 03 String representando uma hora no formato HHMMSS 0x0004 04 String representando um n mero 0x0005 05 String representando uma senha que num rica 0x0006 06 String representando um n mero com 4 d gitos 0x0007 07 String representando um dado alfanum rico 0x0008 08 String representando uma data no formato DDMMAAAA N LEMBRETE utilizado apenas com a interface coleta A C digos das Teclas Durante o processamento da transa o a aplica o dever disponibilizar um meio que permita que usu rio prossiga retorne ou cancele o processamento No entanto de acordo com o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 204 OKI momento do processamento ou seja conforme o estado da coleta de dados em que o SCOPE Client se encontra nem sempre estas tr s op es estar o dispon veis Para que a aplica o saiba qual is a o es ela deve disponibilizar ao usu rio ela deve utilizar o membro HabTeclas da estrutura sIPARAM COLETA ap s a chamada fun o ScopeGetParam O valor deste campo a combina o bin ria bitwise de C digos Formato Hexadeci Decimal Significado ma
10. Valor este campo uma cadeia com 12 caracteres num ricos que representam um valor fixo para escolha do cliente com a v rgula impl cita exemplo caso o dado neste campo seja 000000001500 ent o ele est representando o valor R 15 00 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 78 OKI e B nus este campo uma cadeia com 12 caracteres num ricos que representam o b nus que o cliente ganha ao escolher o valor fixo deste registro com a v rgula impl cita exemplo caso o dado neste campo seja 000000010000 ent o ele est representando o valor R 100 00 e Custo este campo uma cadeia com 12 caracteres num ricos que representam o custo da recarga ao escolher o valor fixo deste registro com a v rgula impl cita exemplo caso o dado neste campo seja 000000005000 ent o ele est representando o valor R 50 00 typedef struct char TipoValor char ValorMinimo 10 char ValorMaximo 10 char Totvalor StREC CEL VALOR TabValores 10 char MsgPromocional 41 char TotFaixaValores StREC CEL FAIXA VALORES 2 TabFaixaValores 10 StREC CEL VALORES MODELO 4 ptREC CEL VALORES MODELO 4 A rede GWCel permite que o cliente fa a uma recarga utilizando uma faixa de valores ao inv s de valores pr definidos A maioria dos membros dessa estrutura s o os mesmo
11. 10 Taxa de servi o excede limite 11 Digita o n o permitida 12 Protocolo n o suportado 13 N o h PDVSs dispon veis 14 Protocolo incompat vel 15 Inserir cart o chip 16 BIN ou servi o n o configurado pela rede adquirente 17 Conta n o permitida 18 Servi o invertido Cr dito por D bito ou vice versa 19 Identifica o de PDV inconsistente recebeu um buffer inv lido 20 Erro na leitura do cart o 21 Dados n o encontrados 22 Rede inv lida ou n o suportada pelo PINPad desse PDV 23 Dados de recarga n o encontrados 24 Vers o do BD incompat vel 25 Chip n o habilitado pela rede 26 Servi o n o permitido para chip 27 Chip sem dados adicionais pode indicar falha na carga de tabelas 28 Cart o com Service Code inv lido 29 Rede exige uso de PINPad compartilhado 30 PINPad compartilhado n o opera com rede VISANET 2000 01 31 Estorno fora do prazo permitido 32 Estorno parcial n o permitido valor deve ser o total 33 Estorno excede valor m ximo permitido 34 Estorno com valor acima do total original n o permitido 35 Estorno com valor acima do total original excede limite permitido 36 Estorno com valor zerado n o permitido 37 Estorno com valor original zerado n o permitido 38 Estorno j realizado 39 Cupom n o encontrado 40 Prompts Adicionais n o encontrados pode indicar falha na carga de tabelas 41 Contrato suspenso 42 Cart o inv lido 43 Modo inv lido 44 Leitor inat
12. Exemplos de configura o 2 Aqui temos uma configura o para um estabelecimento que tem apenas POS da CIELO como conting ncia N o ser perguntada pela rede REDECARD SCOPEABPTEOSI DigitacaoCodigo n Complementar n Redes 102 Bandeiras 1 2 8 21 246 247 NomeBandeira001 VISA NomeBandeira002 MASTERCARD NomeBandeira008 MAESTRO NomeBandeira021 ELECTRON NomeBandeira246 BNDES NomeBandeira247 CONSTRUCARD SCOPEAPIPOS R102 Nome CIELO Bandenras 2 sa TAAG Exemplos de configura o 3 A configura o desse exemplo agrega rede GETNET e as bandeiras SIMCRED e VISA para um estabelecimento que tem um POS da GETNET como conting ncia al m do POS da CIELO e da REDECARD SCOPEAPIPOS DigitacaoCodigo n Complementar s Redes 73 Bandeiras 136 NomeBandeiral36 SIMCRED SCOPEAPIPOS R073 Nome GETNET Bandeiras 136 1 Exemplos de configura o 4 Com essa configura o ser dada a op o OUTRA e coletado o c digo de bandeira se essa op o for selecionada SCOPEAPIPOS DigitacaoCodigo s Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 137 OKI A configura o desse exemplo agrega rede GETNET e as bandeiras SIMCRED e VISA e ELECTRON para um estabelecimento que tem um POS da G
13. campos Posi o Formato Descri o l C digo do Produto C digo do Servi o ou C digo 01a 13 String EAN 14 a 34 String Descri o 35 a 47 String Valor m nimo 47 a 59 String Valor m ximo 59a71 String Valor sugerido Exemplo char sQtdProd 3 0 LONG 1Ret lRet ScopeRecuperaBufTabela Manual do desenvolvedor sotdProd ichar lst SCOPE Solu o Completa para Pagamento Eletr nico 2 27 StREGISTRO PRODUTOS SAVS IstProdutos 50 0 BUF_TAB_PRODUTOS_SAVS Produtos sizeof lstProdutos 189 OKI if lRet RCS SUCESSO Sucesso no recebimento da lista de produtos os membros das estruturas estar o preenchidos else LI BECO ads Cielo Transa es Sem Contato Contactless S o transa es realizadas atrav s de leitura sem contato no PINPad Atualmente a Cielo 4 1 R2014 tamb m conhecida como Cielo Release 2014 a nica que permite realizar esse tipo de transa o Atualmente as bandeiras Visa Visa Electron Mastercard Maestro e Amex s o as nicas certificadas a operar atrav s de leitura sem contato Requisitos Para que esse tipo de transa o seja aceito o estabelecimento precisa estar trabalhando com Cielo 4 1 R2014 O PINPad precisa ser no m nimo 1 08a com m dulo Contactless instalado e firmware atualizado Em caso de d vida consulte o fabricante do PINPad para saber se seu PINPad est ou n o preparado par
14. arrancar near ra aaaana nar aaar aa aaar aa nennen nnna 67 E SOMOS eaaa RAR UR OR OND ONT O NR OE E RD RE 67 Fun es de CONSUMO ennnen ennnen mnnn nnmnnn nnmnnn 68 CHOQUE E E E E E EAE T 68 Consulta de Cheques sssussrivess eiireariiiras iiien niea adheri amida nana Eua di lada dan 68 ANS EAE fodendo das Lanoadadao Leben QUagiadhaao bedbod couniaa ab lei salqun o 69 Consulta AVS cs icaaruigiracatoa oiiaaie ideias iid aie a eaa aeea adare hiaai aaia aaant dna 69 Recarga de celulat aii aa 71 Configurando a recarga de celular ereta Ennn En AEEA AEEA aa EAEE renan Annn unnn nnmnnn ennnen nn nn 71 Processando a recarga de celular ee AREON ENNAN REESE SAANA NA INRE E NEARER a 71 Iniciando a transa o de recarga diriana E NEANKE EENE 72 Obtendo operadoras dispon veis erre aaaeracanaaaeea near renan ana eaaar aa aaar renan nana 73 Obtendo valores de recarga rece narra aaa aanaaaaaaeaa aaa a nana nara anar anna anna aiie 76 Fun es de consulta para recarga de celular erre era aear area aeaa aaa acararaaaaanaaa 81 Obtendo operadoras dispon veis fora do fluxo de recarga ireeeraraeeaaeareeeaaeareeanaos 81 Obtendo valores de recarga dispon veis fora do fluxo de recarga e eerseeerearreeaneas 82 Estorno de Iransa es spas ama sa USO a iaaa 84 Estornando a transa o s isassssaossesiioeasasuabeadasasuesasiaa o ddes bi cea g
15. 12 bytes Valor m nimo representado por string 12 bytes Valor m ximo representado por string 1 byte Total de valores fixos da tabela 12 bytes Valor fixo 1 da recarga com 2 casas decimais 12 bytes B nus da recarga para o valor 1 12 bytes Custo da recarga para o valor 1 12 bytes Valor fixo 2 da recarga com 2 casas decimais Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 76 OKI 12 bytes B nus da recarga para o valor 2 12 bytes Custo da recarga para o valor 2 12 bytes Valor fixo 3 da recarga com 2 casas decimais 12 bytes B nus da recarga para o valor 3 12 bytes Custo da recarga para o valor 3 12 bytes Valor fixo 4 da recarga com 2 casas decimais 12 bytes B nus da recarga para o valor 4 12 bytes Custo da recarga para o valor 4 12 bytes Valor fixo 5 da recarga com 2 casas decimais 12 bytes B nus da recarga para o valor 5 12 bytes Custo da recarga para o valor 5 12 bytes Valor fixo 6 da recarga com 2 casas decimais 12 bytes B nus da recarga para o valor 6 12 bytes Custo da recarga para o valor 6 12 bytes Valor fixo 7 da recarga com 2 casas decimais 12 bytes B nus da recarga para o valor 7 12 bytes Custo da recarga para o valor 7 12 bytes Valor fixo 8 da recarga com 2 casas decimais 12 bytes B nus da reca
16. 0x00CD 205 PIN Pad j aberto via SCOPE Exemplo WORD porta 1 LONG retorno 0 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 107 OKI retorno ScopePPOpen porta Encerrando a comunica o Uma vez que o PIN Pad n o ser mais utilizado a aplica o pode encerrar a comunica o com o PIN Pad deixando uma mensagem no visor display do PIN Pad Prot tipo LONG EXPORT ScopePPClose char IdleMsg Par metros IdleMsg Mensagem de 32 caracteres 2 linhas x 16 colunas a ser mantida no display do PIN Pad ap s o fechamento in String Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x00D3 211 PIN Pad n o foi aberto pela aplica o Exemplo LONG retorno 0 retorno ScopePPClose Itautec S A as E Mensagens no visor Para personaliza o da aplica o de frente de loja a aplica o pode enviar mensagens para o PIN Pad desde que o SCOPE Client n o esteja processando alguma transa o IMPORTANTE Estas s o as nicas fun es que n o dependem da configura o do N A ScopeCNF quanto ao uso exclusivo do SCOPE Mensagens de tamanho padr o Devido diversidade de formatos de visor por padr o todos os PIN Pads devem prover um visor com o m nimo de 2 linhas por 16 colunas para ex
17. IMPORTANTE A utiliza o destas fun es com exce o das usadas para a exibi o de A mensagens no visor est condicionada configura o no ScopeCNF onde a op o Uso exclusivo do Scope deve estar desmarcada Comunica o com o PIN Pad Como em qualquer dispositivo a comunica o com o PIN Pad precisa ser iniciada e ap s o uso finalizada ScopePPOpen e ScopePPClose As fun es aqui relacionadas devem sempre ser chamadas quando a op o Uso exclusivo do Scope n o estiver marcada Iniciando a comunica o Antes do in cio de qualquer transa o a aplica o deve abrir o PIN Pad ou seja iniciar o canal de comunica o com o PIN Pad A chamada bem sucedida desta fun o pr requisito para todas as outras da interface com o PIN Pad Prot tipo LONG EXPORT ScopePPOpen WORD PortaSerial Par metros in WORD PortaSerial Porta serial que se encontra conectado o PIN Pad Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x000E 14 PIN Pad j foi aberto 0x001F 31 Erro de comunica o PIN Pad provavelmente desconectado ou problemas com a interface serial Pode ser que a porta que est passando como par metro esteja errada 0x00CA 202 Mem ria n o alocada para a estrutura do PIN Pad compartilhado 0x00CB 203 Erro alocando mem ria
18. N IMPORTANTE Atualmente somente a rede Vidalink e PBM Padr o compat vel com o A layout 3 de estrutura Lista de Projetos A fun o ScopeRecuperaBufTabela fornecer para a aplica o de automa o comercial uma lista de informa es a serem exibidas na tela para facilitar a sele o da op o desejada Ela servir para facilitar futuras implementa es que atendam a mesma finalidade O par metro _TipoTabela indicar o formato dos dados que ser o fornecidos LONG EXPORT ScopeRecuperaBufTabela BYTE TipoTabela char QtdRegistros char Buffer WORD TamBuffer Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 101 OKI Par metros Tipo de lista de elementos que se deseja in BYTE TipoTabela recuperar devendo ser como definido na tabela a seguir QtdRegistros Retorna a quantidade de elementos da out String 9 tabela out String Buffer Retorna os elementos da tabela in WORD TamBuffer Tamanho em bytes do campo Buffer Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFAO3 64003 Par metro 3 inv lido Layouts ID layout Usar estrutura Descri o BUF TAB PRJ PHARMASYSTEM Projeto stREGISTRO PROJETO PHMS ID 0 PharmaSystem O f
19. Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar Exemplo PIN Pad compartilhado conectado retorno ScopeValidaInterfacePP 2 conecta ao ScopesSRV LEMBRETE a chamada a essa fun o deve ser feita antes de chamar a fun o A ScopeOpen Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 40 OKI Fun es espec ficas das interfaces Dependendo da interface sobre a qual a aplica o de PDV foi desenvolvida a aplica o dever tratar fun es espec ficas da interface escolhida Interface coleta Como a aplica o ser respons vel pela coleta entrada de dados do usu rio esta deve obter do SCOPE Client informa es para solicitar os dados Da mesma maneira a aplica o deve devolver o que foi coletado para o SCOPE Client Antes de tudo a aplica o necessita de um meio para informar ao SCOPE Client que o modo de intera o ser pela interface coleta O fluxo da aplica o quando esta utiliza a interface coleta est esbo ado no diagrama da figura 5 Nos t picos subsequentes explicamos os mecanismos para realizar estas opera es Na interface coleta o SCOPE Client retornar atrav s da fun o ScopeStatus um c digo ver c digos na tabela Coleta de dados sempre que necessi
20. Solu o Completa para Pagamento Eletr nico 2 27 138 OKI Bandeiras ServicoB001 Lo 2 8 9 2 Ao 7 028 ServicoB002 9 027 28 ServicoB008 6 4 ServicoB02 1 6 4 ServicoB246 6 4 5 5 5 C digos de servi os No SCOPE existem v rios c digos de servi os dispon veis mas nem todos s o aplic veis nesta funcionalidade Cada servi o agrupado em um grupo de servi o Abaixo est a rela o de grupos de servi os e os servi os previstos como no SCOPE Grupo de servi o Servi o C digo Descri o C digo Descri o 01 Cart o de D bito 6 D bito Vista 45 Compra CDC 134 Credi rio 02 Cart o de Cr dito 9 Cr dito Vista 27 Cr dito Parc Adm 28 Cr dito Parc Loja Percebe se que o CDC e o Credi rio est o agrupados em d bito mas para fins da transa o POS os servi os estar o agrupados nos conforme abaixo Grupo de servi o Servi o Descri o C digo Descri o Cart o de D bito 6 D bito Vista 45 Compra CDC 134 Credi rio CDC 45 Compra CDC 134 Credi rio Cart o de Cr dito 9 Cr dito Vista 27 Cr dito Parc Adm 28 Cr dito Parc Loja O servi o 134 credi rio id ntico ao CDC mas utilizado apenas para a rede CIELO Qualquer outra rede o servi o utilizado deve ser o 45 compra CDC Esses dois servi os est o em ambos os grupos
21. 233 OKI Um exemplo da sa da gerada por esse comando est na Figura 14 No exemplo apresentada a vers o 2 25 07 01 jpeJava so copeJava so 1 7 root localhost liblk Figura 14 visualizando a vers o do SCOPE Client na linha de comando do Linux Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 234 OKI Ap ndice F Formato do C digo de Barras InComm Este ap ndice tem como objetivo documentar o formato do c digo de barras da bandeira InComm O n mero do cart o para identifica o da bandeira InComm pelo SCOPE pode ser obtido por meio de cart o magn tico ou por c digo de barras O leitura e o tratamento do c digo de barras da InComm ser realizado pela automa o comercial a qual enviar o n mero do PAN j formatado para o SCOPE O layout do c digo de barras possui sequencialmente 11 d gitos refententes ao c digo do produto e 19 d gitos referentes ao n mero do cart o PAN o qual deve ser justificado direita e preenchido com zeros esquerda se for menor que 19 d gitos como podemos observar na figura 12 UPC 11 VAN Device ID Serial Number 19 79936654209000504998123456 892 Leading Zeros when reeded Sample Barcode 799366542090005049981234567892 Figura 15 leiaute do c digo de barras da InComm Ap s o c digo de barras ser lido e tratado pela automa o o PAN formatado ser enviado para o SCOPE que ir entender o mod
22. OKI Recarga de celular Com o crescimento n mero de pessoas que utilizam celulares do tipo pr pago a necessidade de disponibilizar pontos de recarga tem sido incentivada pelas operadoras de celulares O SCOPE contribui com este movimento provendo facilidades para esse tipo de servi o Configurando a recarga de celular Para a Recarga de Celular devem ser efetuadas as configura es a seguir e ScopeCNF ver no documento Scope Manual de Instala o e Configura o doc cadastrando os atributos para a Recarga de Celular e ScopelNI O tamanho m nimo de d gitos permitidos para serem lidos pelo PIN Pad deve ser configurado como descrito no item Configura o do arquivo scope ini se o Sess o PINPAD deste documento Processando a recarga de celular Apesar de o processamento seguir de maneira similar s outras transa es nesta modalidade existem c digos de coleta espec ficos Durante a itera o do processamento da transa o de recarga de celular a aplica o de PDV dever estar preparada para receber da fun o ScopeStatus no caso de uso da interface Coleta os dois c digos de coleta abaixo al m de outros comuns a outras transa es e C digo 64624 0xFC70 neste momento a aplica o dever recuperar do SCOPE a lista de operadoras dispon veis e C digo 64558 0xFC2E este c digo representa que a aplica o deve obter a lista de valores dispon veis de recarga No caso da interface HL
23. OxFC28 64552 Coletar n mero do item Fininvest OxFC29 64553 Coletar c digo de seguran a OxFC2A 64554 Coleta se c digo de seguran a ausente ou ileg vel OxFC2B 64555 Coleta se com ou sem garantia de pr datado OxFC2C 64556 Coleta se aceita ou n o risco OxFC2D 64557 Coleta valor do saque OxFC2E 64558 Coleta valor da recarga de celular pr pago OxFC2F 64559 Coleta c digo da localidade do telefone OxFC30 64560 Coleta n mero do telefone OxFC31 64561 Coleta d gito verificador do telefone OxFC32 64562 Coleta data formato DDMMAA OxFC33 64563 Coleta valor da taxa de servi o OxFC34 64564 Coleta valor OxFC35 64565 Coleta se quer realizar saque OxFC36 64566 Coleta se quer realizar simula o de saque OXFC37 64567 Coleta se quer saldo ou extrato OxFC38 64568 Coleta se quer o extrato resumido ou a segunda via OxFC39 64569 Coleta se consulta investimento ou resgate OxFC40 64576 Coleta se resgate avulso OxFC41 64577 Coleta data formato DDMMAAAA OxFC42 64578 Coleta o c digo de autoriza o PBMS OxFC43 64579 Coleta a lista de medicamentos OxFC44 64580 Retorna a lista de medicamentos OxFC45 64581 Exibir mensagem OxFC46 64582 Imprime cupom parcial OxFC47 64583 Coleta quantidade de parcelas e aceita 1 parcela OxFC48 64584 Coleta c digo de barras OxFC49 64585 Coleta c digo de consulta PBM OxFC4A 6
24. OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBO3 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFOC 65292 Transa o n o implementada OxFFiD 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Exemplo char valor 12 1 char taxa 12 1 obt m o valor da compra e armazena em valor obt m a taxa de servi o armazena em taxa abre sess o retorno ScopeSimulacaoCrediario 1l valor taxa processa a transa o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 63 fecha a sess o OKI LEMBRETE A transa o de Compra Credi rio efetuada no fluxo de d bito ou seja Pal dever ser chamada a fun o Sco
25. Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Exemplo abre sess o retorno ScopeReimpressao0ffLine processa a transa o fecha a sess o IMPORTANTE na reimpress o n o h cupom reduzido IMPORTANTE a fun o ScopeReimpressaoOffLine substitui a anterior A ScopeReimpressaoComprovante No entanto esta ltima ainda mantida por compatibilidade Solicitando o comprovante on line Utilizada nos casos em que a rede autorizadora ou o correspondente banc rio oferece a transa o on line de reimpress o do comprovante do pagamento de conta Prot tipo LONG EXPORT ScopeReimpressaoOnLine WORD CodBandeira Manual d SCOPE Solu o Completa para Pagamento Eletr nico 2 27 89 N A OKI Par metros lin WORD CodBandeira C digo da bandeira do cart o ver C digo das bandeiras Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server l
26. in WORD TamLista Tamanho em bytes do campo ListaBuffer Retorno Ver tabela de c digo de retorno Par metro TipoTabela ID layout Usar estrutura Descri o Cont m os campos BUF TAB MERCADORIA CIELOAUTO conforme a transa o stREG MERCADORIA CIELOAUTO ID 3 AUTO da especifica o CIELO Par metro ListaBuffer O SCOPE est preparado para tratar MAX MERCADORIA CIELOAUTO 72 mercadorias da CIELO AUTO A lista formada por registros stREG MERCADORIA CIELOAUTO com os seguintes campos Posi o Formato Descri o 01a02 char C digo do Ramo Principal 03 a 04 char C digo da Mercadoria 05 a 45 String Descricao da Mercadoria Exemplo int i 0 char qtd 2 1 0 LONG 1Ret StREG MERCADORIA CIELOAUTO lista MAX MERCADORIA CIELOAUTO 0 lRet ScopeRecuperaBufTabela BUF TAB MERCADORIA CIELOAUTO atd char lista sizeof lista if lRet RCS SUCESSO Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 183 for else G 0y i lt atorltatd i OKI Sucesso no recebimento da lista de mercadorias exibe os membros das estruturas que estar o preenchidos lista i CodRamoPrinc lista i CodMercadoria lista i Descricao Erro Informa es Adicionais Cielo Auto Estas informa es ser o exibidas para cole
27. se o menu tem 10 itens alguns deles n o foram exibidos e o operador seleciona o ltimo item do menu o item a ser selecionado continua sendo o ndice 10 valor a ser passado pelo ScopeMenuSelecionaltem Prot tipo dllScopeAPI ScopeMenuRecuperaItens BYTE TipoTabela char Buffer WORD TamBuffer Par metros lin BYTE TipoTabela Fixo em 1 Para permitir evolu es futuras Ponteiro para rea alocada pela aplica o para receber os in String Buffer itens do menu formato abaixo in WORD _TamBuffer Tamanho da rea alocada dispon vel Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFAOS3 64003 Par metro 3 inv lido OxFF6B 65387 N o Encontrado para quando n o veio menu din mico na carga de tabelas Estruturas do Menu Din mico typedef struct char CodFuncao 4 1 char Descricao 40 1 char CodGrupoServico 2 1 char CodFluxoPDV 3 1 char CodRede 3 1 char CodBandeira 3 1 char CodFuncaoRede 4 1 stScopeItemMenuDinamico LPScopeItemMenuDinamico typedef struct char TipoTabela char QtdItens stScopeItemMenuDinamico sItem 15 stScopeMenuDinamico LPScopeMenuDinamico Prot tipo dlliScopeAPI ScopeMenuSelecionaIte
28. 11 2 3 4 5 6 10 5 9 8 6 5 47 109 e SCOPE DADO PLANO LOJA ID 2 string com o m ximo 12 bytes de comprimento contendo o valor total do ticket dado complementar utilizado pela fun o ScopeCompraCDC exemplo 10000 para R 100 00 e SCOPE DADO ATRIBUTOS APLIC ID 3 ver Atributos da aplica o e SCOPE DADO TRILHA 01 ID 4 string com a trilha 01 do cart o lida no PIN Pad e SCOPE DADO REG FORMA PAGTO ID 5 string de no m ximo 30 bytes de comprimento com a descri o do registrador de forma de pagamento e SCOPE DADO AUT SUPERVISOR ID 6 string de no m ximo 15 bytes de comprimento com a autoriza o do supervisor e SCOPE DADO IMPRIME CHEQUE ID 7 string com 1 byte de comprimento informando se imprime S ou n o N o cheque e SCOPE DADO SEPARADOR LINHA ID 8 string com 1 byte de comprimento parametrizando o separador de linha do cupom exemplo D Atualmente suporta apenas o caractere sendo que para qualquer outro caractere parametrizado ou caso esta parametriza o n o seja efetuada ser considerado o caractere n como finalizador de linha do cupom e SCOPE DADOS APLIC ID 9 tipo de terminal A para ATM ou P para PDV e usu rio e SCOPE DADOS PAGAMENTO ID 10 dados do pagamento confronte com SCOPE DADOS PAGAMENTO EX e SCOPE DADOS APLIC CBD ID 11 desenvolvido para a rede CBD e utilizado tamb m pela rede VR SmartNet sendo um string com o primeiro char inform
29. Hexa Decimal Significado decimal O0xFC60 64608 Coleta se continua ap s verificar a conta OxFC61 64609 Coleta o c digo da bandeira OxFC62 64610 Coleta se conta da fatura OxFC63 64611 Coleta o valor total OxFC64 64612 Coleta RG OxFC65 64613 Coleta se deseja realizar novamente a transa o retentativa OxFC66 64614 Coleta somente CPF OxFC67 64615 Coleta o endere o OxFC68 64616 Coleta o andar OxFC69 64617 Coleta o conjunto OxFC6A 64618 Coleta o bloco OxFC6B 64619 Coleta o bairro OxFC6C 64620 Coleta a autoriza o ou o cart o OxFC6D 64621 Coleta a data de emiss o do cart o OxFC6E 64622 Coleta o plano Infocards OxFC6F 64623 Coleta n mero do cupom fiscal OxFC70 64624 Coleta a operadora de recarga de celular pr pago OxFC71 64625 Coleta dados SAB OxFC72 64626 Coleta o n mero do telefone com o d gito verificador OxFC73 64627 Coleta os dados transa o for ada SAB OxFC74 64628 Coleta o tipo de servi o t cnico baixa t cnica teste comum ou estat stica OxFC75 64629 Coleta o n mero da OS OxFC76 64630 Coleta identifica o do t cnico O0xFC77 64631 Coleta o c digo de ocorr ncia OxFC78 64632 Coleta a EPS credenciada OxFC79 64633 Decide se coleta valor de entrada n o mais utilizado OxFC7A 64634 Decide se coleta valor da primeira parcela n o mais utilizado OxFC7B 64635 Coleta o valor da primei
30. Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFFiD 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere H como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFiD 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutu
31. INSIRA O CARTAO n Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 122 OKI do memset szComanda 0x00 sizeof szComanda Retorno ScopePPObtemComanda comanda cafe szComanda 1 while Retorno 1 Limpando a comanda de um cart o A limpeza de um cart o do tipo comanda se d com o uso de fun es n o blocantes ScopePPStartLimpaComanda e para o tipo comanda caf ScopePPLimpaComanda Iniciando o modo de limpeza da comanda ScopePPStartLimpaComanda a fun o que inicia o processo de limpeza do cart o inicializa o timer a ser utilizado para verifica o de time out e direciona para a fun o que trata aquele determinado tipo de comanda Prot tipo LONG EXPORT ScopePPStartLimpaComanda int TipoComanda Par metros fin lint TipoComanda Tipo de comanda Atualmente existe apenas o tipo Comanda Caf Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x00D3 211 PIN Pad n o foi aberto pela aplica o 0X00D7 215 Comanda Inv lida Limpando a comanda A fun o ScopePPLimpaComanda finaliza o processo iniciado por ScopePPStartLimpaComanda chamada caso o tipo seja comanda caf onde o cart o tem chip Ela deve ser chamada constantemente enquanto retornar valor igual a 1 PIN Pad em processamento Em ca
32. Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 18 OKI Legenda de Abrevia es Formato Atributo a Caracteres alfab ticos n Caracteres num ricos an Caracteres alfab ticos e num ricos ans Caracteres alfab ticos num ricos e especiais MM M s DD Dia AA Ano hh Hora mm Minuto ss Segundo LLvar Tamanho de um campo vari vel Ex Se o conte do do campo AB1234CD teremos para represent lo 08 AB1234CD LLLvar Tamanho de um campo vari vel Ex Se o conte do do campo AB1234CD teremos para represent lo 008 AB1234CD 10 Tamanho fixo de 10 caracteres 10 Tamanho vari vel de at 10 caracteres b Representa o bin ria dos dados Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 19 OKI Instala o Nesta sess o comentada a localiza o das bibliotecas do SCOPE Client em cada sistema operacional Quanto composi o do SCOPE Client deve se consultar o Ap ndice E Conjunto de bibliotecas do SCOPE Client Instala o do SCOPE Client para MS Windows As bibliotecas do SCOPE Client para MS WindowsQ devem estar em um diret rio acess vel pela aplica o A decis o da localiza o destas bibliotecas tomada pela equipe que desenvolve a aplica o de PDV porque a particularidade da linguagem e ou ambiente de desenvolvimento tem impacto
33. Nome interno Nome original do arquivo Vers o do arquivo Vers o do produto Cancelar Figura 13 janela de propriedade de ScopeAPI dll SCOPE Client para Linux Em Linux no pr prio nome das bibliotecas j est a vers o Elas normalmente s o instaladas no OKI diret rio usr lib ver Instala o do SCOPE Client para Linux bastando a listagem dos arquivos do SCOPE Execute Is libScope As bibliotecas e seus versionamentos s o definidos da seguinte forma e libScopeApi so lt a gt lt bbb gt lt cc gt lt dd gt e libScopeCom so lt a gt lt bbb gt lt cc gt lt dd gt e libScopeJava so lt a gt lt bbb gt lt e gt e lt a gt a vers o da interface do SCOPE Client cuja altera o deste implica em incompatibilidade entra as bibliotecas exemplo altera o de par metros de fun es ou nomes de constantes Este item faz parte do soname utilizado em Linux com shared libraries para prover informa o de compatibilidade e lt bbb gt a vers o e o release do produto SCOPE Esta vers o representada sem o ponto como por exemplo 225 o SCOPE 2 25 e lt cc gt a vers o do pacote do SCOPE Perceba que n o h ponto separador entre a vers o O release e o pacote e lt dd gt o build do pacote e lt e gt a vers o da camada de interface Java Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27
34. OxFEO9 65033 Servidor n o configurado no arquivo scope ini OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFEOC 65036 N o pode mais desfazer uma transa o que j iniciou o ciclo de finaliza o situa o que pode ocorrer apos queda de energia ou na inicializa o da aplica o OxFEOD 65037 N o h arquivo com dados da transa o anterior salvo OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFO1 65281 Institui o off line OxFFO2 65282 Transa o cancelada pelo operador ou no caso de um estorno via REDECARD estorno fora do prazo permitido validade n o confere OxFFOS3 65283 Servi o ou BIN n o configurado OxFF04 65284 Transa o j foi cancelada OxFFO5 65285 Transa o n o encontrada OxFF06 65286 Transa o n o permite cancelamento OxFFO7 65287 Dados informados n o conferem com a transa o original OxFFO8 65288 Erro no acesso ao banco de dados OxFFO9 65289 Time out no acesso ao banco de dados OxFFOA 65290 Banco de dados off line OxFFOB 65291 Transa o abortada pelo aplicativo OxFF
35. OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere H como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 PO1 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 159 OKI OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO ScopeResumoOperacoes Utilizada nos casos em que a rede ou correspondente banc rio oferece a possibilidade de obten o de um resumo das opera es realizadas Prot tipo LONG EXPORT ScopeResumoOperacoes WORD CodServico WORD CodBandeira Par metros in WORD C digo do servi o do produto a ser CodServico executado Use O zero para indicar que o c digo do servi o dever ser coletado durante o fluxo da transa o in WORD C digo da bandeira do produto a ser CodBandeira executado Use O zero para indicar que o c digo da bandeira dever ser coletado Retorno Ver tabela de c digo de retorno Poss veis Retornos de E
36. Prot tipo LONG EXPORT ScopeResumeParam LONG codTipoColeta char dados WORD dadosParam eACAO APL acao Par metros C digo do estado obtido pela fun o im LONG codTipoGplaia ScopeStatus para qual o dado foi coletado in String dados Dado coletado pela aplica o Modo de captura do dado Informa se a captura foi feita pelo teclado 0x0004 ou pela leitura in WORD dadosParam magn tica 0x0020 ou pela interface que suporta tanto a leitura magn tica como a leitura do Chip 0x0080 ou pela leitura de CMC7 0x0010 in eACAO APL A o A o tomada pelo operador ver C digos de Fluxo Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 45 OKI C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE04 65028 N o existe transa o suspensa OxFF10 65296 Dado inv lido Exemplo executa transa o cr dito d bito etc char dados 128 WORD modo entrada inicia itera o cod coleta ScopesStatus if cod coleta 0xFEOO obt m os par metros para a coleta atualiza as teclas retornar avan ar e cancelar coleta os dados e armazena em na vari vel dados modo entrada
37. Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x00D1 209 PIN Pad n o configurado 0x00D2 210 Display n o permitido neste momento ou situa o 0x00D3 211 PIN Pad n o foi aberto pela aplica o Exemplo Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 109 char mensagem OKI 065Enviando uma mensagem maior que a mensagem padr o para g o PIN Pad LONG retorno 0 retorno ScopePPDisplayEx mensagem Informa es obtidas do PIN Pad Internamente os PIN Pads com a biblioteca compartilhada possuem informa es armazenadas sobre a vers o dos dados das redes autorizadoras e do pr prio dispositivo Quando o parque de PDVs muito grande o levantamento via aplicativo dos PIN Pads uma maneira mais segura e r pida que o m todo manual Dados das redes autorizadoras Para algumas autorizadoras o PIN Pad armazena tabelas com dados para utiliza o nas leituras de cart o e senha Com o tempo estes dados podem ficar obsoletos sendo necess rio o armazenamento da vers o destas tabelas nos PIN Pads Estas tabelas s o retornadas pelo PIN Pad atrav s da fun o ScopePPGetlnfo no formato abaixo Posi o Formato Descri o 001 020 A20 Nome da rede adquirente com espa os direita 021 033 A13 Vers o da aplica o d
38. WORD TamLista Tamanho em bytes do campo ListaMedicamentos Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno mal Hexadeci Decimal Significado OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE04 65028 N o existe transa o suspensa OxFEO6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado PDV s dispon veis OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFF11 65297 N o existe cupom v lido OxFF12 65298 rea reservada para o buffer insuficiente para o SCOPE Client x os dados solicitados OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 99 OKI Lista de medicamentos Extendida A fun o ScopeObtem
39. a substitui o de dinheiro por este cart o Tamb m conhecido como Cart o Presente ou Gift Card Opera es As opera es transa es que podem ser efetuadas com o cart o dinheiro s o e Compra Carga de cart o e Compra usando cart o d bito e Consulta a saldo e Estornos Compra Carga do cart o dinheiro Para realizar a opera o de recarga e tamb m a compra carga inicial do cart o dinheiro deve se utilizar a fun o ScopeCartaoDinheiro como descrito abaixo Como as outras transa es o fluxo de processamento similar Prot tipo LONG EXPORT ScopeCartaoDinheiro WORD servico char Valor Par metros Para efetuar a opera o de Compra Carga in WORD Servico de cart o dinheiro usar o servi o 110 S CARGA CARTAO DINHEIRO String com o a E UR i ayj Valor da transa o com a v rgula impl cita in it de 12 Valor exemplo R 123 00 12300 Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFFOC 65292 Transa o n o implementada Exemplo Long servico S CARGA CARTAO DINHEIRO valor de 110 char valor 12 1 Manual do desenvolvedor SCOPE Solu o Com
40. configurado para uso de PIN Pad compartilhado mas a aplica o informou que est com o kit Visanet para PIN Pad OxFF5C 65372 O SCOPE n o est configurado para uso de PIN Pad compartilhado mas a aplica o informou que est com PIN Pad compartilhado OxFF5D 65373 Erro ao inicializar perif ricos na interface HLAPI OxFF5E 65374 Erro ao desmontar a estrutura ISO Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 199 OKI C digos Retorno Hexadeci Decimal Significado mal OxFF5F 65375 Bandeira n o est configurada OxFF60 65376 Fun o indispon vel OxFF61 65377 Valor m nimo da parcela inv lido OxFF62 65378 Valor da consulta Vale G s ainda n o est dispon vel OxFF63 65379 N mero de Telefone inv lido OxFF64 65380 DDD inv lido OxFF65 65381 Erro Rede Modelo 2 OxFF66 65382 Erro Rede Modelo 3 OxFF67 65383 Confirma o Positiva Inconsistente OxFF68 65384 Transa o Offline Permitido apenas reimpress o offline OxFF69 65385 Contrato Suspenso OxFF6A 65386 Transa o permite somente digitado OxFF6B 65387 N o Encontrado para quando n o veio menu din mico na carga de tabelas OxFF6F 65391 Erro ao acessar arquivo de contexto da PBM OxFFFF 65535 Erro gen rico 5000 Erro desmontando o pacote recebido 5001 N o achou a Master Key referente 5002 Ocorreu timeout do pacote 5003 Erro configurando o re
41. dados do PIN Pad e valor maior que 0 dependendo do valor ser o obtidas as informa es espec ficas das aplica es das autorizadoras Prot tipo LONG EXPORT ScopePPGetInfo WORD IdSaida WORD DadosLen char Dados Par metros in WORD IdSaida Informa a op o do formato dos dados de sa da in WORD DadosLen Tamanho reservado pelo aplicativo para receber os dados String Dados Dados sobre o PIN Pad Utilize as tabelas descritas nas out sess es acima para a especifica o do buffer retornado Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal O0x00CA 202 Mem ria n o alocada para a estrutura do PIN Pad compartilhado 0x00D1 209 PIN Pad n o configurado 0x00D2 210 Display n o permitido neste momento ou situa o 0x00D3 211 PIN Pad n o foi aberto pela aplica o Exemplo char aux 255 if ScopePPGetInfo 0 WORD sizeof aux aux printf Nome do fabricante do PIN Pad 20 20s n amp aux 00 printf Modelo versao do hardware 20 20s n amp aux 20 printf Versao do firmware 20 20s n amp aux 40 printf Versao da especificacao 54 4s An amp aux 60 printf Versao da aplicacao basica 16 16s n aux 64 printf Numero de serie do PIN Pad 20 20s n amp aux 80
42. edes para perguntar no fluxo separados por v rgula Lista de at 14 c digos de bandeiras N meros de at 3 d gitos cada Bandeiras ne r distintas para perguntar no fluxo separados por v rgula Nome da bandeira YYY que ser exibida no fluxo onde YYY uma das bandeiras listadas na chave Bandeiras NomeBandeiraYYY E String de at 20 caracteres ATEN O se faltar a chave para alguma das bandeiras ser exibido c digo da bandeira para o operador Se o SCOPEAPIPOS RXXX Essa se o permite configura es de uma das redes configuradas na se o detalhada anteriormente onde XXX uma das redes listas na chave Redes Portanto deve haver uma se o para cada rede da lista ATEN O se n o houver a se o para alguma das redes listadas ser exibido o c digo da rede como op o e todas as bandeiras listadas estar o associadas rede Nome da rede XXX que ser exibida no fluxo String de at 20 caracteres Lista de bandeiras associadas a esta rede A BEP no N meros de at 3 d gitos cada Bandeiras bandeira deve existir na chave Bandeiras da separados por v rgula se o SCOPEAPIPOS Lista de c digos de servi os permitidos para essa bandeira associada a essa rede onde XXX o c digo com 3 d gitos zeros esquerda de E un f N meros de at 3 d gitos cada ServicoBXXX uma das bandeiras listada no campo Bandeiras separados por v rgula Se houver
43. na coleta de dados OxFBO2 64258 Erro na montagem do servi o pela API OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida 0xFB04 64260 Erro ao montar mensagem 0xFB05 64261 Erro no arquivo de controle da TEF OxFBO6 64262 Erro no contexto do arquivo de TEF n o mais utilizado OxFBO7 64263 Erro na totaliza o de TEF OxFBO8 64264 Erro no arquivo de controle utilizado finaliza o no ciclo multi TEF OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFBOA 64266 N o salvou a mensagem de confirma o para o SAB OxFBOB 64267 N o salvou a mensagem de desfazimento para o SAB OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFEO2 65026 SCOPE API j foi inicializada corretamente OxFEOS 65027 Existe transa o suspensa OxFE0O4 65028 N o existe transa o suspensa OxFEO5 65029 API ainda n o fez nenhuma transa o ap s a inicializa o A aplica o est tentando obter um handle sem ter feito nenhuma transa o desde ltima conex o com o ScopeSRV OxFE06 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server 0xFE08 65032 POS n o cadastrado Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 197 OKI C digos Retorno Hexadeci Decimal Significado mal
44. o apenas informativo n o necess rio para o resgate Note que durante os fluxos de compra cr dito e d bito a informa o se ocorreu um pr mio n o monet rio pode n o ser relevante para automa o j que n o h nenhum tratamento a fazer IMPORTANTE Para cupom de tamanho zero descartar o pr mio Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 177 OKI Como fazer um Resgate de Pr mio O resgate feito no SCOPE atrav s da fun o ScopeMenu Esta fun o ir exibir os produtos disponibilizados pela Cielo para o cnamado Menu Outros e poder conter outras op es al m do resgate de pr mio O operador dever selecionar a op o correspondente que ir acionar no SCOPE o servi o Consulta Resgate de Pr mio O fluxo do Resgate de Pr mio j prev uma consulta autom tica Cielo para buscar os pr mios dispon veis para um determinado cart o lido no in cio do fluxo Para obter a lista de brindes dispon veis AC pode tratar o estado de coleta TC EXIBE MENU RESGATE PREMIO retornado pela fun o ScopeStatus IMPORTANTE Para que a op o Resgate de Pr mio esteja dispon vel no Menu a A inicializa o de tabelas do estabelecimento em quest o dever estar atualizada de forma a contemplar o Cielo Premia Para os resgates n o monet rios deve ser seguido basicamente o fluxo 1 Recuperar do SCOPE os dados dos pr mios e exibir 2
45. o original 247 Exibe dados de cancelamento 248 Decide as vias de reimpress o 249 Exibe mensagem rotativa 250 Coleta do DDD no PINPad 251 Coleta do n mero do telefone no PINPad 252 Coleta do n mero do telefone e d gito verificador no PINPad 253 Coleta de redigita o no PINPad 254 Transa o aprovada parcial 255 Coleta valor das parcelas 256 Coleta 30 ou 60 dias para a cobran a da primeira parcela 257 Verifica se CDC ou Parcele Mais 258 Coleta se vista com juros 259 Transa o cancelada por fallback inv lido 260 Coleta a utiliza o do saldo restante do cart o voucher 261 Critica o valor na transa o de Troco Surpresa 262 Consulta para transa o de Vale G s 263 Verifica se deve coletar o c digo de ativa o do celular 264 Coleta o c digo de ativa o do celular 265 TEF Externa Coleta N mero do Cart o 278 Coleta c digo de servi o do posto 279 Coleta matr cula 280 Coleta a quantidade do servi o do posto prestado 281 Coleta hod metro do ve culo 282 Coleta a placa do ve culo 283 Coleta o valor de dedu o 284 Coleta o valor de acr scimo 285 Cr tica o valor da transa o 286 Mostra o valor 287 Mostra o vencimento 288 Coleta o valor para o Bradesco 289 Decide entre DARF e GPS 290 Decide o tipo de DARF 291 Coleta o c digo de receita 292 Coleta o n mero de refer ncia 293 Coleta o valor juros 29
46. os O que determinar cada um destes servi os ser o fluxo do SCOPE de acordo com o que este solicitar e o que o usu rio devolver Assim a transa o poder terminar como vista parcelada pelo estabelecimento ou parcelada pela administradora Prot tipo LONG EXPORT ScopeCompraCartaoCredito char Valor char TxServico Par metros String com o a z EREE P Valor da transa o com a v rgula impl cita in N oele Valor exemplo R 123 00 12300 in String TxServico Valor da taxa de servi o Retorno Ver tabela de c digo de retorno Estados de coleta A tabela abaixo mostra os estados de coleta que o fluxo poder retornar no modo coleta C digos Retorno Hexadeci Decimal Significado mal OxFCOO 64512 Coletar cart o OxFCO1 64513 Coletar validade do cart o OxFCO2 64514 Imprime Cupom OxFCO3 64515 Coletar CGC ou CPF OxFCO9 64521 Coletar se a transa o ser a vista ou n o OxFCOE 64526 Coletar quantidade de parcelas OxFCOA 64522 Coletar se a transa o ser parcelada pela administradora ou pelo estabelecimento OxFC18 64536 Coleta os 4 ltimos d gitos do cart o OxFC1F 64543 Coletar quantidade de dias OxFC24 64548 Coletar n mero do endere o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 53 OKI
47. tipo de dado o SCOPE DADOS ECF BENEFICIO gt Fornecer os dados da impressora fiscal A utiliza o desta constante deve ser feita na transa o de d bito num estado de coleta TC COLETA DADOS ECF Informa es adicionais na se o Fornecendo informa es extras para a transa o e StructField dados fornecidos pela aplica o cujo formato para a constante utilizada na tabela abaixo Posi o Formato Descri o 001 040 ans40 N mero de s rie de fabrica o do ECF alinhado esquerda com brancos direita 041 044 n4 N mero do PDV atribu do ao ECF alinhado direita com zeros esquerda Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 170 OKI 045 064 n20 N mero do documento fiscal alinhado esquerda com brancos direita 065 072 n8 Data de emiss o do documento fiscal no formato AAAAMMDD Dados da Lista de Mercadorias Consumidas Na transa o de compra online d bito Voucher necess rio enviar dados da Lista de Mercadorias Consumidas pela Aplica o O SCOPE retorna no modo coleta o estado de coleta TC COLETA LISTA MERCADORIAS FCCBh e a automa o deve invocar a fun o ScopeForneceCampo char TypeField void StructField com os seguintes par metros e TypeField tipo de dado SCOPE DADOS LISTA MERCADORIAS gt Fornecer os dados da Lista de Mercadorias Consumidas A utiliza o desta constante deve ser
48. 0x0004 pelo teclado obt m a a o que o usu rio escolheu e coloca em acao entrega o que coletou ao SCOPE na fun o abaixo ScopeResumeParam cod coleta dados modo entrada acao finaliza itera o Para resolver uma necessidade de alguns clientes que desejam manipular os itens do Menu Din mico montados atrav s da Inicializa o de Tabelas pelas redes VISANET 4 1 e CIELO foram definidas duas novas fun es exportadas pelo SCOPE Client conforme abaixo A ideia que ao receber o estado TC EXIBE MENU que j existe hoje o PDV possa opcionalmente chamar a fun o ScopeMenuRecuperaltens do SCOPE para receber os itens do Menu a serem exibidos e em seguida chamar a ScopeMenuSelecionaltem para indicar ao SCOPE qual item foi selecionado Desta forma o PDV poder por exemplo e Exibir todos os itens na mesma tela hoje pelo fluxo do SCOPE Client apresentado um item por vez e Excluir algum item da lista que eventualmente n o deva ser exibido ao operador e Alterar a descri o de algum item para melhor entendimento do operador e Fazer a sele o autom tica de um determinado item sem apresent lo ao operador Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 46 OKI OBSERVA O O ndice do item selecionado deve ser equivalente ao item da tabela A fornecida pelo Scope independente de ter sido exibido para o usu rio ou n o Por exemplo
49. 2 inv lido OxFBO1 64257 N o foi poss vel criar a thread na coleta de dados OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFEOS 65029 API ainda n o fez nenhuma transa o ap s a inicializa o A aplica o est tentando obter um handle sem ter feito nenhuma transa o desde ltima conex o com o ScopeSRV OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server 0xFE08 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere H como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFOC 65292 Transa o n o implementada Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 54 OKI OxFFiD 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser cha
50. 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server 0xFE08 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 105 OKI Exemplo BYTE TipoConvenio CodigoRede abre sess o coleta o tipo do conv nio o c digo da rede retorno ScopeCancelaPreAutMedicamento TipoConvenio CodigoRede processa a transa o fecha a sess o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 106 OKI Fun es de PIN Pad Esta se o documenta as fun es de acesso ao PIN Pad utilizando a biblioteca compartilhada Estas fun es seguem o formato ScopePP Funcao Utilize o ap ndice B C e a tabela de c digo de retorno como complemento
51. A El E E m B m B m E m E DA DA DA DA DO PLANO DO EMPRESA OJA DO ATRIBU TOS APLIC DO TRILHA 01 DO REG FORMA PAGTO DA DA DA DA DA DA DA DA DO AUT SU DO IMPRIM DO SEPARA DOS APLIC DOS PAGAM DO NSU CU PERVISOR E CHEQUE DOR LINHA r ENTO DOS APLIC CBD DO DATA MOVIMENTO POM FISCAL DA DA DOS COD A DOS AUTOMACAO UT MEDICAMENTOS DA AUTOMACAO P Co DA PF RES D TABELA DOS LISTA MEDICAMENTOS PARCELE DOS PAGAM DA ENTO EX RMITIR SAQUE AUTOMACAO PARTICIPA PPONLINI ULTADO VALIDACAO DOS ECF B ENEFICIO DA E PRODUTO DOS CART O PRESENTE DA DA DA DOS LISTA PRECOS DOS LISTA MERCADORIAS DO MAX AIS ERMITE SALDO VOUCHI Ra Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 150 OKI tDadoForneceCampo Onde e SCOPE DADO MIN ID 0 limite inferior do dom nio de valores que o primeiro par metro pode receber e SCOPE DADO EMPRESA ID 1 buffer onde os 7 primeiros bytes representam uma string com o n mero do cupom nota fiscal e outros 7 bytes com a s rie da nota fiscal exemplo 12345610 59865410
52. A leitura Sem Contato feita de forma nica ou seja somente necess rio aproximar o cart o do PINPad uma nica vez mesmo quando se tratar do tipo Chip EMV Sem Contato Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 191 OKI Ap ndice A Tabelas C digos de retorno Coleta de dados Estes c digos ser o retornados pela fun o ScopeStatus quando a aplica o optar pela coleta dos dados atrav s da fun o ScopeSetApIColeta Estes c digos informam para a aplica o de PDV a a o a ser tomada Como exemplo coletar um dado imprimir um cupom e ou cheque ou at mesmo mostrar informa es no display do operador e ou cliente aguardando a confirma o C digos Retorno Hexa Decimal Significado decimal OxFC00 64512 Coletar cart o OxFCO1 64513 Coletar validade do cart o OxFCO2 64514 Imprime Cupom OxFCO3 64515 Coletar CGC ou CPF OxFCO4 64516 Coletar banco OxFCO5 64517 Coletar ag ncia OxFC06 64518 Coletar n mero do cheque OxFCO7 64519 Coletar data do cheque bom para OxFCO8 64520 Imprime cheque OxFCO9 64521 Coletar se a transa o ser a vista ou n o OxFCOA 64522 Coletar se a transa o ser parcelada pela administradora ou pelo estabelecimento OxFCOB 64523 Coletar se a transa o ser pr data
53. Banrisul Fun o da API do SCOPE Conv nio Refeisul combust vel ScopeCompraCartaoDebito Cancelamento ScopeCancelamento Pagamento vista prazo e parcelado ScopeCompraCartaoDebito Cr dito 1 minuto ScopeCompraCDC Banco SIM parcelado ScopeCompraCartaoDebito Conv nio Refeisul alimenta o e refei o ScopeCompraCartaoDebito Conv nio Private label ScopeCompraCartaoCredito Consulta de saldo de conv nio Refeisul alimenta o refei o ScopeConsultaDebito Transa o conv nio combust vel Durante o fluxo de coleta desta transa o surgir o coletas espec ficas para a realiza o desta com o Banrisul que s o e C digo de servi o este um c digo de 2 d gitos que informa o tipo de servi o realizado previsto pelo Banrisul Os poss veis c digos e seus significados s o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 167 Ticket Edenred O O 01 Gasolina 02 lcool 03 Diesel 04 GNV 05 Combust vel Avia o 06 leo 07 Lavagem 08 Borracharia 09 leo Mar timo 10 Graxa 11 Outros 12 G s GLP 13 Filtro de Ar 14 Filtro de leo 15 leo Lubrificante 16 Filtro de Combust vel 17 Gasolina Aditivada 18 Servi o de Oficina OKI Quantidade de servi o um valor num rico de at 12 d gitos que representa a quantidade do servi o prestado Exemplo se o c digo do servi o escolhido foi 03 ent o a quantidade
54. Digamos que a cada venda paga com o cart o de cr dito a empresa deseja que seja atrelada a transa o o n mero de telefone do cliente e o n mero do pedido Para isso o administrador do SCOPE criou dois atributos no ScopeCNF figura 7 K ScopeCnf Configurador 2 10 03 11 Vers o Corrente do Configurador 6 Atributos da Aplica o ag Arquivos Cadastros Consultas Ferramentas Janelas Ajuda EEREREI 7 Tx Descri o 1 Telefone do Cliente 2 C digo do pedido Figura 10 atributos da aplica o cadastrados no ScopeCNF A aplica o coletar estes dados sempre que houver uma venda com cart o de cr dito Exemplificando na linguagem C uma compra com cart o de cr dito interface Alto N vel HLAPI LONG RC char szAtributosAplic 40 operador selecionou cr dito abre sess o de TEF ScopeSuspend EC COLETA CARTAO ScopeCompraCartaoCredito 100 O processa a transa o if RC RCS EXISTE TRN SUSPENSA coletou o telefone do cliente e n mero do pedido montou o buffer do atributo da aplica o ex 0201014 11 6097 123402006123456 e guardou em szAtributosAplic ScopeForneceCampo SCOPE DADO ATRIBUTOS APLIC szAtributosAplic ScopeResume Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 154 enc OKI rra sess o de TEF Separando o buffer do exemplo acima co
55. Estabelecimento nos respectivos cupons Permite a grava o em arquivo dos dados da coleta para ser recuperado em caso de queda de energia 128 Manual do desenvolvedor Permite que a aplica o interfira na conclus o de transa es que n o foram SCOPE Solu o Completa para Pagamento Eletr nico 2 27 38 OKI finalizadas apropriadamente em caso de quedas de energia confirmando ou desfazendo as transa es de acordo com a decis o do operador nes Se habilitado permitir a coleta de saque em opera es de d bito vista Atualmente s usado pela rede autorizadora Cielo IMPORTANTE este tipo de configura o s permitido quando a aplica o est utilizando A a interface coleta Configurando em tempo de execu o A fun o ScopeConfigura respons vel para a configura o da aplica o de PDV citada acima poder ser executada apenas uma nica vez ap s a inicializa o do SCOPE ou antes das opera es TEF Prot tipo LONG EXPORT ScopeConfigura LONG Id LONG Param Par metros Identifica o par metro a ser configurado iin LONG a conforme tabela acima Informa se deve habilitar ou desabilitar o item Para habilitar a aplica o dever ini LONG dci passar o valor 1 e para desabilitar o valor 0 Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadec
56. Felipe M Schaden e Inclus o da rede RVTECNOLOGIA e Inclus o da fun o ScopeObtemDadosTotalTEFEx e 1 34 03 07 2012 Edison Ogata atualiza o dos tipos de layouts que podem ser utilizados por ela 1 35 08 08 2012 Marcelo D Fonseca Nova fun o Simula o Credi rio e Novos servi os Credi rio e Simula o Credi rio o e Inclus o da fun o adicional e nova lista de 1 36 10 08 2012 Facti Tiago F Valerio medicamentos na sess o sobre PBM e Incluido novo c digo na lista de c digos de erro do Scope nao e Inclus o de novo estado de coleta de dados 1 37 30 08 2012 Facti Tiago F Valerio TC DECIDE PGTO CARNE e estado para interrup o EC DECIDE PGTO CARNE e Inclus o do c digo 32 para a fun o ScopeConfigura permitindo a grava o dos dados da coleta em arquivo 1 38 13 09 2012 Edison Ogata e Inclus o do valor 8 para a fun o ScopeObtemHandle que recupera dados da coleta gravados em arquivo Valores ser o retornados somente se o c digo 32 estiver habilitado ScopeConfigura 1 39 19 09 2012 Facti Felipe M Schaden Inclus o da rede CREDITEM e bandeira CREDITEM SENHA 1 40 21 09 2012 Edison Ogata e Atualiza o das tabelas de redes e bandeiras j e Inclus o do ID para obten o dos valores retornados na 1 41 15 10 2012 Facti Rafael D Tardivo resposta de consulta de saldo da EPAY na m scara 3 da fun o ScopeObtemCampo 1 42 17 10 2012 Facti Tiago F Valerio e Inclus o da rede GI
57. Itautec e ser retornada sem criptografia pela fun o ScopePPGetPIN em caso de sucesso A Master Key da Itautec est inserida por padr o nos PIN Pads homologados pela Visanet CUIDADO A utiliza o destas fun es apenas para a captura de informa es que diz N respeito apenas ao pr prio estabelecimento exemplo senha do supervisor da loja ou de AN algum funcion rio e n o deve ser utilizado para captura de senha de cart es de banco dos clientes Como a informa o digitada no PIN Pad aberta e poss vel passar a mensagem a ser exibida no display do PIN Pad a aplica o pode utiliz las para coletar apenas informa es de dom nio da aplica o Iniciando o modo de leitura da senha aberta A fun o ScopePPStartGetPIN respons vel pelo in cio do processo o qual complementado pela fun o ScopePPGetPIN Prot tipo LONG EXPORT ScopePPStartGetPIN char MsgDisplay Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 113 OKI Par metros Mensagem que ser exibida no PIN Pad Esta mensagem in String MsgDisplay deve ter no m ximo 32 caracteres sendo duas linhas de 16 caracteres Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x00CE 206 N o foi poss vel definir a Master Key a ser utilizada 0x000F 15 PIN Pad n o foi
58. Lava R pido Aditivos e Lubrificantes Filtros Borracharia Manuten o Geral Equipamentos el tricos ESTACIONAMENTO Estacionamento OKI Esta lista fornecida durante o fluxo de coleta atrav s do estado abaixo TC COLETA COD MERC CIELO AUTO OxFCDA Coleta Codigo de Mercadoria Cielo Auto Caso exista apenas uma mercadoria habilitada na Carga de Tabelas ou no cart o o SCOPE assume automaticamente essa mercadoria Num fluxo de Compra com Cartao de Debito recebendo o c digo de coleta 64730 TC COLETA COD MERC CIELO AUTO a aplica o de PDV dever obter a lista de mercadorias dispon veis atrav s da fun o ScopeRecuperaBufTabela Prot tipo LONG EXPORT ScopeRecuperaBufTabela BYTE TipoTabela char Qtd char ListaBuffer WORD TamLista Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 182 Descri o e Esta rotina servir para disponibilizar para a aplica o de automa o comercial uma lista de informa es a serem exibidas na tela para facilitar a sele o da op o desejada e Ela servir para facilitar futuras implementa es que atendam a mesma finalidade e Opar metro TipoTabela indicar o formato dos dados que ser o fornecidos Par metros out String 2 1 Qtd Retorna a quantidade de elementos da lista out String ListaBuffer Retorna os registros da lista
59. PPGERWS2 DLL PPINGW32 DLL PPSLBW32 DLL PPVFNWS2 DLL PPW32 DLL SCOPEAPI DLL SCOPECLT DLL SCOPECNX DLL SCOPECOM DLL SCOPEECF DLL SCOPEISO DLL SCOPELIB DLL SCOPEPRF DLL SCOPEREG DLL SCOPETCP DLL scope ini Linguagem Java Aplicativos de PDV escritos em Java al m das bibliotecas citadas acima tamb m precisam das seguintes PINPADJAVA DLL PINPADJAVA JAR SCOPEJAVA DLL Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 229 OKI e SCOPEJAVA JAR Linux Os ambientes executados no sistema operacional Linux precisam das seguintes bibliotecas e libScopeApi so e libScopeCom so e libScopeSerial so e libSenha so e scope ini Linguagem Java Como acontece em MS Windows o aplicativo de PDV escrito em Java tamb m precisa das seguintes bibliotecas e libPinpadJava so e pinpadjava jar e libScopeJava so e scopejava jar Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 230 OKI Ap ndice E Identificando a vers o do SCOPE Client Antes de atualizar o SCOPE Client ou reportar um problema para a Itautec S A muitas vezes necess ria n o s a verifica o da vers o do SCOPE Server mas tamb m do SCOPE Client Abaixo exibimos as diversas formas de verificar a vers o do SCOPE Client Verificando no SCOPE Server A verifica o da vers o do SCOPE Client no Server cuja tela exibida na Figura 11 simples Basta clicar no PDV cuja ver
60. Retorna a quantidade de elementos da lista out String ListaBuffer Retorna os registros da lista in WORD TamLista Tamanho em bytes do campo ListaBuffer Retorno Ver tabela de c digo de retorno Par metro TipoTabela Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 187 OKI ID layout Usar estrutura Descri o Fornecedores SAVS BUF TAB FORNECEDORE stREGISTRO FORNECED Cont m os campos S SAVS ID 1 ORES SAVS conforme a especifica o do Autorizador Voucher Par metro ListaBuffer A lista formada por registros stREGISTRO FORNECEDORES SAVS com os seguintes campos Posi o Formato Descri o 01a 04 String C digo do Fornecedor 05 a 25 String Nome do Fornecedor 26a 27 String C digo do Segmento de Mercado 27a27 String Quantidade m xima de produtos diferentes Exemplo char sotdFornec 3 0 LONG 1Ret StREGISTRO FORNECEDORES SAVS IstFornecedores 20 0 lRet ScopeRecuperaBufTabela BUF TAB FORNECEDORES SAVS sotdFornec char lIstFornecedores sizeof lstFornecedores if lRet RCS SUCESSO Sucesso no recebimento da lista de fornecedores os membros das estruturas estar o preenchidos else Erro Lista de Produtos A lista de produtos pode ser retornada para a automa o comercial no novo layout como descrito a seguir Nu
61. SCOPE Solu o Completa para Pagamento Eletr nico 2 27 130 OKI GeraRelatorioEmArquivo Buffer else erro ao obter o cupom com o relat rio Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 131 OKI Transa o de POS para concilia o Aqui ser tratada uma funcionalidade que guia a coleta de dados de um cupom de TEF Descri o da funcionalidade Essa funcionalidade determina um fluxo de coleta que direcione o operador a automa o comercial a entrar os dados do cupom de uma transa o que foi realizada na m quina de POS Este recurso foi criado para que a automa o cormercial obtivesse os dados do cupom para gravar no arquivo de concilia o do SCOPECON e que tais transa es fossem conciliadas Essa funcionalidade n o se comunica com o SCOPE Server e a conex o pode estar offline No entanto necess rio que o SCOPE Client tenha feito o logon com o Server isto que a fun o Scopeopen tenha sido executado com sucesso A funcionalidade tinha como foco cart es que o SCOPE s passam em POS como o CONSTRUCARD e o BNDES No entanto quaisquer cart es que passaram pelo POS podem usar esse recurso H situa es em que a rede autorizadora ou at mesmo o pr prio SCOPE Server est offline Quando acontece isso normalmente os estabelecimentos passam as transa es em POS que s o utilizados como conting ncia do concentrador de TEF Em linhas gerais o portado
62. SCOPE API n o foi inicializada corretamente OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere H como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 94 OKI Exemplo BYTE TipoConvenio CodigoRede abre sess o coleta o tipo do conv nio o c digo da rede retorno ScopeConsultaMedicamento TipoConvenio CodigoRede processa a transa o fecha a sess o Nesse tipo de transa o o SCOPE n o possui controle do valor de venda a ser registrado Portanto ao receber o c digo 64579 da fun o de status a aplica o deve atualizar o valor ver ScopeAtualizaValor informando assim
63. SCOPE Client n o preciso que este esteja A conectado no servidor mas obrigat rio que ele o tenha feito ao menos uma vez desde o start do servidor SCOPE Verificando no ambiente do PDV N o necess rio ter acesso ao servidor SCOPE para consulta da vers o do SCOPE Client e s vezes por pol tica da empresa nem todo colaborador tem acesso ao servidor Para estes casos deve se verificar a vers o do SCOPE Client no pr prio ambiente do PDV SCOPE Client para MS Windows Para isso deve se conhecer o local de instala o das DLL s do SCOPE Localize a biblioteca ScopeAPI dil e abra a janela de propriedades do arquivo clicando nela com o bot o direito e na op o Propriedades A janela Propriedade de ScopeAPI dll ser aberta Clique na aba Vers o e ser poss vel visualizar informa es como na Figura 13 No campo Vers o do arquivo encontra se a vers o do SCOPE Client no exemplo vemos 2 27 2 1 que a mesma do exemplo da sess o anterior Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 232 Propriedades de ScopeAPI dil 3 Geral Vers o Seguran a Resumo Vers o do arquivo 227 21 Descri o Scope Client Direitos autorais Copyright O Itautec 1997 2006 2x M Outras informa es de vers o Valor SCoPE Sistema Completo para Pagamento Eletronico Nome do item Empresa Idioma Nome do produto
64. SCOPE ser respons vel por toda a intera o com o PIN Pad Compartilhado num processo de TEF Quando configurado o PIN Pad Compartilhado no ScopeCNF o SCOPE n o retornar mais para a aplica o de PDV alguns estados de coleta pois estes estados ser o executados internamente pelo SCOPE Os estados s o o TC CARTAO o TC COLETA AUT OU CARTAO o TC SENHA o TC DECISAO CONT A aplica o ter a possibilidade de interromper a intera o do SCOPE com o PIN Pad Para isto a Aplica o PDV dever o Executar a fun o ScopeConfigura sinalizando que a aplica o PDV utilizar tal recurso ver Configura es gerais o Quando configurado o SCOPE na leitura do cart o ir devolver o c digo TC COLETA CARTAO EM ANDAMENTO 0xFCFC e durante as demais intera es com o PIN Pad devolver o c digo TC COLETA EM ANDAMENTO 0xFCFD atrav s da fun o ScopeStatus Neste momento a aplica o de PDV poder decidir se continua ou interrompe o processo o Para continuar o processo a aplica o de PDV dever executar a fun o ScopeResumeParam com o par metro PROXIMO ESTADO 0x00 e para cancelar CANCELAR 0x02 o Observa o O SCOPE devolver os c digos TC COLETA EM ANDAMENTO 0xFCFD e TC COLETA CARTAO EM ANDAMENTO 0xFCFC ao menos uma vez por segundo Para a aplica o de PDV cancelar uma leitura de cart o no PIN Pad e realizar uma transa o digitada nos casos permitidos ser o oferecidas as seguintes op es o
65. Scope ResumoOperacoes iria aaaraacee ana aa aaa aa nana aaaaaa aaa anna sanar SE EASE Ennn Ennn Ennn Enae 160 Scope Pagamento us isa sisscaso corureosboiraedo ioia aai n anida aia vian inda Dada add a Trac ad agua di canada do 161 ScopeServico Tecrit Arsiriand aa Aaa aaia 162 ScopeAtualizaParametrosChip ira aaaraananaaaaeea near renan anne aaa aa ana aananaananaa 163 ScopeVers o saiu stents org iair feaigra ia A aa aa i do fes Litaa Sondas asi a aa cuadao 164 ScopeAtualizaPrecosMercadorias ii carraaaaraacanaaaaraa aeee ra aaaaaaane aaa aa aaa nannanananaa 165 Redes com tratamentos espec ficos ns sreeseserereenacaennnaas 167 Banrisul EMV cc ves lccnararas aves Loshnda dida cenas stsAnda PEA dad EUR idana iaai aU RAIA Pa aaae aai adiada daraa ddaa 167 PINPads com suporte a rede indeni eean Aaa iE AARRE EA A AEAEE 167 Associa o dos produtos e as fun es do SCOPE e erereraeearera araras nnne ennan 167 Transa o conv nio combust vel rara arta area aaaraa near aa na aaaaaraa aaa aa aaaaannaans 167 Mieket Edenie disesar ER A COMER DDR E AR RN AR iugar oiana 168 PINPads com suporte a rede neede aiun aeaa tara nana aaa nana aa aa nana area aa AENEA 169 Associa o dos produtos e as fun es do SCOPE rrenan 169 Dados coletados assssssasassasoianisiaveliis doors assa pra bia da ces Ra aaa des AE Ea
66. Significado mal 0x0002 2 Notificar o operador com a mensagem recebida do PIN Pad 0x000A 10 Necess ria opera o previa 0x000F 15 PIN Pad n o foi aberto 0x0010 16 Erro interno de execu o 0x00CE 206 N o foi poss vel definir a Master Key a ser utilizada 0x00D3 211 PIN Pad n o foi aberto pela aplica o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 115 Lendo a senha criptografada A fun o ScopePPGetPINEx finaliza o processo iniciado por ScopePPStartGetPINEx Ela deve ser chamada constantemente enquanto retornar valor igual a 1 PIN Pad em processamento Nessa situa o o processo de captura de senha pode ser cancelado atrav s da fun o ScopePPAbort Em caso de sucesso esta fun o retorna o valor O Neste caso a senha criptografada de acordo com os par metros usados na fun o ScopePPStartGetPINEx retornada no par metro PIN Prot tipo LONG EXPORT ScopePPGetPINEx char PIN Par metros Senha retornada pelo PIN Pad criptografada Para senhas PIN criptografadas com os algoritmos DES 3DES o PIN deve ter 16 bytes Para senhas criptografadas com o algoritmo DUKPT PIN dever ter 36 bytes in String Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x00DO 208 Erro no par metro da fun o GetPIN 0x00D3 211 PIN Pad n o fo
67. Solu o Completa para Pagamento Eletr nico 2 27 119 OKI if retorno 0 se OK printf inOs dados do cart o s o s in cartao Mensagens de erro ScopePPMsgErro Esta fun o retorna a descri o referente ao c digo de erro informado retornado pelas fun es de acesso ao PIN Pad Prot tipo LONG EXPORT ScopePPMsgErro LONG RC char MsgErro Par metros in WORD RC C digo do erro in String MsgErro Mensagem referente ao c digo de erro informado Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x00D3 211 PIN Pad n o foi aberto pela aplica o Exemplo char cartao 256 char mensagem 256 LONG retorno retorno ScopePPStartGetCard 99 000 1f retorno 0 printf n Aguardando inserir ou passar o cartao do retorno ScopePPGetCard 0 mensagem sizeof cartao cartao if retorno 2 printf inMensagem do PIN Pad n 3s n mensagem if _kbhit se operador pressionou tecla do teclado cancela o processamento do cartao ScopePPAbort retorno 13 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 120 OKI while retorno retorno 2 enquanto em processamento ou mensagem if retorno 0 se OK printf inOs dados do cart o s o
68. a inicializa o A aplica o est tentando obter um handle sem ter feito nenhuma transa o desde ltima conex o com o ScopeSRV OxFE06 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFOC 65292 Transa o n o implementada 0xFF1D 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFF36 65334 Erro no envio da confirma o ou desfazimento da transa o anterior Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 166 OKI Redes com tratamentos espec ficos O objetivo de cap tulo abordar peculiaridades de tratamentos para algumas redes autorizadoras como a coleta de dados no fluxo do SCOPE ou o relacionamento
69. a seguir Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 173 Gerar Arquivo tabelas On line Cielo Premia O CIELO Premia um programa de premia o atrav s do qual o comprador pode receber pr mios no momento da compra quando a TEF transacionada pela Cielo Tamb m conhecido como Plataforma Promocional Online da Cielo ou abreviadamente PP Online Como a gest o da campanha Toda a gest o da campanha inclusive sua temporalidade controlada pela autorizadora ou seja a Cielo quem ir definir o per odo de validade da promo o quais brindes ser o oferecidos regras de sorteio cart es envolvidos etc As configura es s o internas da Cielo e ou Emissores e exigem uma atualiza o de tabelas Inicializa o A atualiza o das tabelas feita pelo SCOPE de forma online e autom tica mediante sinaliza o da Cielo Quais tipos de pr mios o comprador pode receber Est o previstos os seguintes tipos de pr mios e Brindes a serem resgatados posteriormente atrav s de transa o espec fica Resgate de Pr mio Chamado tamb m de resgate n o monet rio e Desconto instant neo a ser aplicado no momento da compra sobre o produto comprado Chamado tamb m de resgate monet rio Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 174 OKI e Cupom eletr nico que apenas uma notifica o de que o cli
70. aaaeae are aaaraaaaaraa nana Enst ra aaa anna nana anna anna a nan ananaa 113 Iniciando o modo de leitura da senha aberta rir ear area acaa aaa acer aaaaaaaaaaa 113 Lendo a senha aberta sscsisaesomasesolaragisairapndanohajasaraaiasdcapanDecanaia AEA dada CE ENEA AEE AES ENERE EARNE AS 114 Obtendo a senha criptografada rr carra arara nanaaaaeea aaa aa aaaa nana ea nnna aa anas na nanaananaa 115 Iniciando o modo de leitura da senha criptografada sr raraaaeareraacanaaa 115 Lendo a senha criptografada rare near nana arena near ana naar ana near ana naaraa nana 116 Lendo um car o ss 2ecaaas tsaiobaodeaavtadho decoid ceuapa ia be E doca ER AE EEEE A pa quai do cena suada Adap ad ds aa da ess Stade ganga 117 Iniciando a leitura do cart o irc aeaa area nana aaa nana area anna EEEN ER 117 Recuperando O CAAO senais aa a Rafa aaa ORE quinas aU asa nha es 117 Abortando o processamento ScopePPAbord eia nreeacaraaaaaaaananenaareaaaaraaaaaaaanneans 119 Mensagens de erro ScopePPMsgErro rear aanaeareaaaraa aaa aanaaaananea aaa aa aaa nnnaananaa 120 Obtendo a comanda de um cart o ir caraa arara nanaaaaeea near renan ana ESSE Ennn aaa Ennn nn nennt 121 Iniciando o modo de leitura da comanda errar cararaa near arena arena aaaraaaaaaanaaa 121 Lendo a comand doerien na E E E 122 Limpando a comanda de um cart o
71. aberto Lendo a senha aberta O processo de leitura da senha finalizado por ScopePPGetPIN Ela deve ser chamada constantemente enquanto retornar o valor igual a 1 PIN Pad em processamento Nessa situa o o processo de captura de senha pode ser cancelado pelo checkout atrav s da fun o ScopePPAbort Prot tipo LONG EXPORT ScopePPGetPIN char PIN Par metros PIN Senha capturada do usu rio j descriptografada finalizada com out String caractere nulo NO Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x00DO 208 Erro no par metro da fun o GetPIN Exemplo char pin 40 LONG retorno 0 if ScopePPStartGetPIN DIGITE A SENHA do retorno ScopePPGetPIN pin while if retorno 0 se OK Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 printf inAguardando digita o da senha 0 ud E retorno 1 enquanto em processamento 114 OKI printf inA senha digitada sl in pin Obtendo a senha criptografada O conjunto ScopePPStartGetPINEx ScopePPGetPINEx respons vel pela captura da senha do usu rio Estas fun es s o teis para clientes que possuem algum m dulo de descriptografia e vai trafegar a informa o que sigilosa por algum
72. as outras s o opcionais e depender da situa o de cada aplica o Exemplo para a configura o de um PDV cadastrado na empresa 0001 e filial 0007 que ir se conectar ao ScopeSRV no IP 10 50 9 70 o scope ini dever ser configurado da seguinte maneira 00010007 Name 10 50 9 70 Port 2046 VersaoAutomacao O1CAPS0001 valor fict cio Sess o SCOPEAPI Esta sess o n o obrigat ria e define os par metros abaixo relacionados ao ambiente Diret rio para salvar o cupom Diret rio padr o Habilita o log do PIN pad compartilhado Em MS Windows ser gerado no C V nos demais sistemas no diret rio corrente da aplica o o arquivo TracePin sc O sistema de log TracePin circular assim quando o tamanho desse Habilita arquivo for 1 MB ele ser renomeado para TracePin bak e um novo TracePin sc ser criado Diret rio para salvar os arquivos de controle do ArgControlPath Scope Client Somente v lido para o sistema Diret rio padr o C V operacional Windows Sess o PPCOMP Aqui configuram se itens relacionados ao PIN Pad compartilhado Configura para n o abrir o digitado se n o abre digita o padr o NaoAbrirDigitado cancelada a leitura do cart o no PIN Pad abre digita o compartilhado Configura o de porta serial para Linux Atualmente o SCOPE Client preparado para trabalhar apenas com PIN Pad conectados porta se
73. ass fes coadpaste ses dasis Edison cuales enai aana ae aa aaa aaa aeaa aaan a dada 102 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 9 Pre Autorizacao de Medicamentos PBM rare aaara aa naar eae near a near nanaas 104 Cancelamento de Pre Autorizacao de Medicamentos PBM arara 105 Fun es de PIN PAO aC OU Rad Ra aid nd ad end in 107 CGom nica o como PIN P dl sssss sistini aani annene aiita aaie a La ada ug Dao MALD a ada o ato nanda 107 Iniciando T Comunica o issa naa SA AnS A ami aus na EES E 107 Encerrando a COMUNICA O 2 sz ecaauascagastaseledssunde as EEAS A E E EAA RAA AE A 108 Mensagens No VISOR oe issin aAA ED EA N a EE AS 108 Mensagens de tamanho padr o sosisini aana RE EAAS AA RN SASS AAAA AAS 108 Mensagens Maiores essensies ipara EE aR a A T aA S E Un Su dalo np apdalant nas 109 Inf rma es obtidas do PIN Pad sessir aa S a EA AS SRNA SASE AE A pas acaso nad 110 Dados das redes autorizadofas sessista inaa An A AAN E ERAR E 110 Dados do dISPOSILIVO serississa tnan anea A S E A A S AE S 110 Obtendo as informa es smise issriidiisiiimiannianidi nrasane dieedid arean ani daidai iiad 111 Obtendo teclas do PIN Pad rr anaien eadein nara anar aa aaaa anna anita 112 Iniciando a leitura da tecla irc eraraa near iier aaa near aa aa nana i AE EE a 112 Obtendo a tecla A E PETE 112 Obtendo a senha aberta rare
74. bandeiras e Inclus o da m scara para a fun o ScopeObtemCampoExit2 e Inclus o dos novos servi os de pagamento DARF e GPS e Inclus o dos novos estados para interrup o e coleta de dados e Exclus o da bandeira GreenCard e Atualiza o da se o Configura es gerais e Tratando 1 7 16 02 2011 Jailton da S C Santana queda de energia e Inclus o das bandeiras Goodcard Senha NEUS SENHA Nutricash e Diamante e Revis o do texto referente reimpress o de comprovantes e Inclus o da fun o ScopeServicoTecnico e Inclus o da chave WKPAN na configura o do arquivo scope ini 1 8 17 03 2011 Paulo dos Santos Atualiza o da tabela de bandeiras Inclus o das M scaras DescResgateMonetario e 1 9 18 03 2011 Paulo dos Santos Tipo Cartao para uso na fun o ScopeObtemCampoExi2 FacTI Daniel Alves ma 1 10 19 04 2011 Atualiza o da tabela de redes e bandeiras Paraiso Inclus o de Rede Bandeira DMCARD em suas respectivas 1 12 26 04 2011 FacTI Rafael D Tardivo tabelas Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 3 OKI FacTI Felipe M E 1 13 29 04 2011 Inclus o da Rede Siscred Bandeiras Siscred e Planvale Schaden 1 14 04 05 2011 FacTI Vinicius Peracini Atualiza o da tabela de c digos de erro FacTI Felipe M a 1 15 11 05 2011 Inclus o da Bandeira DMCARD SEN
75. cada Fornecedor selecionado no Estado de Coleta TC COLETA FORNECEDOR SAV 0xFCD5 podem estar dispon veis alguns Produtos A lista de Produtos associada ao Fornecedor selecionado em passo anterior do fluxo de coleta est descrita posteriormente neste documento na se o Lista de Produtos Estorno de Autoriza o de Vouchers e Servi os Para estorno da transa o de Autoriza o de Vouchers e Servi os a automa o dever chamar a fun o ScopeCancelamento passando como par metro o valor total da transa o original Lista de Fornecedores A lista de fornecedores pode ser retornada para a automa o comercial no novo layout como descrito a seguir Num fluxo de Autoriza o de Servi os Voucher recebendo o c digo de coleta 64725 TC COLETA FORNECEDOR SAV a aplica o dever obter a lista de fornecedores dispon veis atrav s da fun o ScopeRecuperaBufTabela Prot tipo LONG EXPORT ScopeRecuperaBufTabela BYTE TipoTabela char Qtd char ListaBuffer WORD TamLista Descri o e Esta rotina servir para disponibilizar para a aplica o de automa o comercial uma lista de informa es a serem exibidas na tela para facilitar a sele o da op o desejada e Ela servir para facilitar futuras implementa es que atendam a mesma finalidade e O par metro TipoTabela indicar o formato dos dados que ser o fornecidos Par metros out String Qtd
76. caso realizado o desfazimento das transa es pendentes independentemente do par metro de entrada Um detalhe importante que uma sess o de TEF considerada finalizada ao iniciar a execu o dessa fun o Desta forma mesmo que ocorra queda de energia durante a execu o dessa fun o o SCOPE considera como finalizado a sess o de TEF e proceder para realizar a a o solicitada O segundo par metro faz o papel principal no tratamento em queda de energia Este par metro independente do primeiro par metro e somente tem funcionalidade nesta situa o Caso este par metro seja devolvido com o valor 1 True a aplica o deve exibir a mensagem A transa o TEF anterior foi desfeita cancelada Reter o cupom TEF e se poss vel acionar um supervisor para verificar a situa o Exemplo BYTE acao defez Conecta ao servidor do SCOPE ScopeFechaSessaoTEF acao amp defez if desfez printf A transa o TEF anterior foi desfeita cancelada printf in Reter o cupom TEF Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 34 OKI IMPORTANTE sempre que tratar uma poss vel queda de energia e o segundo par metro A da fun o ScopeFechaSessaoTEF retornar o valor 1 deve se imprimir a mensagem A transa o TEF anterior foi desfeita cancelada Reter o cupom TEF Deixando transa o pendente na queda d
77. como finalizar o cupom fiscal A informa o se houve ou n o desconto e o valor do desconto podem ser obtidas nos estados de coleta de impress o de cupom IMPORTANTE Quando h desconto na transa o o valor com desconto ser exibido no A pinpad para o cliente visualizar o valor final Mensagem VALOR COM DESCONTO Para saber o valor do desconto Para obter o valor do desconto usar a fun o ScopeObtemCampoExt2 m scara 3 Informa o do desconto do resgate monet rio 0x00000002 Esta informa o pode ser solicitada antes da impress o solicita o do Cupom ScopeGetCupomEx Caso o valor retornado seja zero ent o n o houve desconto Como tratar o desconto no Cupom Fiscal Veja fluxo sugerido pela Cielo no documento FLUXO BASICO CIELO PREMIA pdf Como saber se houve um pr mio n o monet rio brinde recebido durante uma compra Se houve algum pr mio n o monet rio um brinde esta informa o pode ser recuperada atrav s da fun o ScopeObtemCampoExt2 m scara 3 Informa es sobre a quantidade e e cupons dispon veis 0x00000001 A informa o segue a seguinte estrutura typedef struct char QtdeOcorrenciasECupom 2 char DadosResgate 3000 stPPResgateNaoMonetario Esta informa o pode ser solicitada antes da impress o solicita o do Cupom ScopeGetCupomEx Os brindes ser o acumulados pela Cielo atrav s do n mero de cart o portanto o cupom da promo
78. confirmada Em outras palavras no SCOPE n o se pode cancelar uma transa o que ainda est numa sess o de TEF em aberto Para este cancelamento a transa o deve ser desfeita ver Encerrando a sess o Estornando a transa o Para a realiza o do estorno necess rio informar ao SCOPE os dados da transa o original e em muitas vezes o n mero do controle gerado pelo pr prio SCOPE na transa o Prot tipo LONG EXPORT ScopeCancelamento char Valor char TxServico Par metros String com o Valor d x roula implici lin m ximo de 12 Valor alor da transa o com a v rgula impl cita d gitos exemplo R 123 00 12300 in String TxServico Valor da taxa de servi o Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 84 OKI OxFEOA 65034 N o h mais PDV s dispon veis Erro ret
79. dana cas ca each aaa densa es das UNEAN AEREN AAA 170 Consulta saldo same sccaamsacisiscado usicsndoadioaas eiaaso EEE REE dd dera dead a Ria da da He Ceia 170 Ble e aood E RD NR NE PE DDD DE N E A A 170 Dados da Lista de Mercadorias Consumidas rear anaae arena aaa naarananaaaa 171 Descri o do formato do registro SC101 rear anaaa are aaar aa aaaa na naarnanana 172 Dados da Lista de Atualiza o de Pre os de Mercadorias sra 172 ComprovanteS ssa panasissiosssecdobasiagoaabsc anae a a aaa i rae Eaa apa Aea iaR a anaE AEA aao E Eaa Eaa TAERA casadas 173 C digo das Mercadorias E T T nan aaaeaa aaa aa aaa aa aeee anas anna anna ana 173 Cielo Promia E E T E ENS aa da ANTA ed Ea adaga ea E Ala E EE Ea a ea 174 Como a gest o da campanha ir rarraaaaaaanaeaaaaeaa near aa naaa nana aaaa anna Ennn nn nennt 174 Quais tipos de pr mios o comprador pode receber iiereeeaer aaa nanaananaa 174 Que tipos de transa es podem receber os pr mios eecereerecenemeeresesereeseseneereresereneesesenceces 175 E poss vel restringir para tratar apenas pr mios n o monet rios ou seja n o permitir descontos 175 O que preciso configurar no SCOPE CNF2 are aaraaareacaraaaaaaranaarananaa 175 A Cielo precisa habilitar o Cielo Premia ss aaspntsasead raso nan sana Ed dana a 175 E poss vel integrar e testar atrav s do SCOPE Autorizador co aiacnisaroisnnasascainheuisai
80. de Dados SGBD Os seguintes SGBDs s o suportados pela solu o SCOPE e SQL Server 2005 ou 2008 e Oracle 10g ou 11g Descri o do Produto Objetivo O sistema SCOPE Solu o Completa para Pagamento Eletr nico permite ao software de PDV efetuar o pagamento atrav s de TEF por exemplo cart es de cr dito e d bito atrav s da digita o do embo o ou leitura da tarja magn tica ou chip Defini o O SCOPE foi concebido para gerenciar todas as etapas de uma TEF abstraindo a complexidade inerente transa o do aplicativo PDV Benef cios Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 13 OKI e O sistema permite uma arquitetura flex vel multi empresa multi filial centralizada ou distribu da adequando se necessidade do cliente e Facilita a gest o do neg cio pois oferece ferramentas de consulta e relat rios operacionais e gerenciais e Permite a gest o da sess o cont bil pelo estabelecimento ou pelo centro de processamento de forma a indicar eventuais diverg ncias nos cr ditos efetuados pelos bancos e Permite mecanismos de alta disponibilidade atrav s de solu o cluster e rotas de conting ncia Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 14 Conceitos OKI Transa es O SCOPE prov loja diversos tipos de transa es exemplo compra com cart o de cr dito compra com cart o de d bito r
81. de execu o do aplicativo a aplica o de frente de loja poder configurar os seguintes itens C digo de identifica o Descri o Permite que a aplica o cancele a transa o que est sendo executada no PIN Pad quando este esteja coletando algo Por padr o a aplica o n o tem conhecimento do momento em que o SCOPE est coletando o cart o a senha ou outra informa o no PIN Pad pois ele retorna o estado indicando processamento 65024 o qual n o um estado de coleta e portanto inviabilizando o uso da fun o ScopeResumeParm para o poss vel cancelamento Habilitado este item o SCOPE retornar o estado para obter os servi os 64644 durante o fluxo de TEF para que a aplica o de PDV possa obter os servi os e par metros configurados no ScopeCNF Se habilitado n o abrir o digitado na leitura do cart o com o PIN Pad Compartilhado Por padr o ao pressionar a tecla cancela no PIN Pad o SCOPE Client retornar um estado para coletar o PAN do cart o Normalmente ao solicitar a digita o da senha no PIN Pad pela fun o ScopePPStartGetPIN a fun o ScopePPGetPIN retorna para a aplica o a senha digitada no PIN Pad descriptografada Habilitando este item a senha retornada estar criptografada pela MasterKey da Itautec 16 32 PDVs com impressora com papel de carbono podem habilitar este item para n o imprimir a informa o de 1 Via Cliente ou 2 Via
82. entre DARF e GPS OxFCA7 64679 Decide entre DARF Preto e Simples OxFCAS 64680 Coleta o c digo de receita OxFCA9 64681 Coleta o n mero de refer ncia OxFCAA 64682 Coleta o valor juros OxFCAB 64683 Coleta o CPF do portador OXFCAC 64684 Coleta o CNPJ OXFCAD 64685 Coleta o percentual OXFCAE 64686 Coleta compet ncia OxFCAF 64687 Coleta o n mero identificador OxFCBO 64688 Coleta o valor INSS OxFCB1 64689 Coleta a receita bruta OxFCB2 64690 Coleta a op o do operador para continuar alterar ou cancelar OxFCB3 64691 Coleta o valor de acr scimo OxFCB4 64692 Coleta o valor de dedu o OxFCB5 64693 Coleta redigita o do DDD OxFCB6 64694 Coleta os 8 primeiros d gitos do cart o no Pin Pad OxFCB7 64695 Coleta os 8 d gitos finais do cart o no Pin Pad OxFCB8 64696 Coleta tipo da consulta transa o de Consulta Saldo Credito Infocards sendo 1 Saldo 2 Dados Cadastrais OxFCB9 64697 Confirma o n mero do cart o digitado no Pin Pad OxFCBA 64698 Coleta valida o do saque OxFCBB 64699 Coleta saque em andamento OxFCBC 64700 Coleta DDD Telefone no PIN Pad OxFCBD 64701 Redigita DDD Telefone no PIN Pad OxFCBE 64702 Coleta dados ECF OXFCC1 64705 Coleta op o de pagamento de carn para GetnetLAC no servi o de d bito a vista para bandeira ELECTRON 0 N o para pagamento de carn 1 Sim para pagamento de carn OxFCC
83. foi inicializada corretamente OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server 0xFE08 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere H como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO obt m o valor da compra e armazena em valor Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 60 OKI abre sess o retorno ScopeCompraCartaoDebito valor processa a transa o fecha a sess o Compra CDC Cr dito Direto ao Consumidor Apesar de existir uma fun o ScopeCompraCDC respons vel por essa modalidade de servi o esta transa o foi incorporada ao fluxo da transa o ScopeCompraCartaoDebito devido exig ncia da especifica o Visanet 4 1 O que difere no fluxo de um pagamento com cart o de d bito que um CDC um d bi
84. inanan anni ndan ANRA N NE NANNAN AE AANA ANRA ANKANA ARAARA ARNESES 123 Iniciando o modo de limpeza da comanda rir aeararaa nene area aaaa aaa nnatnn nnan en naat 123 Umpando a conmnanda es a T A 123 LICU LT ao VE TEE casta aos a doi ad an nd ad nd cad Dna o ad a 125 Relat rio de TEF syifa tientas eataa aa lana fra a dadas aaa aaa aa soa fan at ra aaa anaa Eaa anaa 125 InIGianNdo OS Toldi aaa n S A S S a S E S S 125 Cupom dos LotalS A E E E A fodas de Uaa E aiian dose 126 Dados dos tla ar a SA E pua E E an daqa na cegas 128 Transa o de POS para concilia o ass spusaasseaasossocastamicaaaionsea antas iadia das sorastaninasadoa caa 132 Descri o da funcionalidade E A nana na aaar anna naaraa nana 132 Transa o POS sirtarin aa a Ea a a Dn Pa LSD Re a aa aa aa pa Dida ta a dna dada 132 Redes e DandelaS a 2z 2 nssadia taste do eine ipa da tala o ao Rad ne Pe lino can gad ap fan dio sn aPa Gas SRUndoepRad ga dA daR oia SEE no RD ndo ias and at 135 C digos de SErvI OS sms asa iiuna aioa aaan dos Desde ea di a do das SL orando aaa E aa dado dana apa RAAE aaRS 139 Cupom CIELO X ScopeObtemCampoExi2 X arquivo aerea aaa nene 140 Cupom REDECARD X ScopeObtemCampoExt2 X arquivo rara 141 Outros cupons X ScopeObtemCampoExt2 X arquivo arena aaa nenanana 143 Formata o para o arquivo de concilia o rare aaara na naaraaaaaara na naaraaanaas 144 Fun es diversas
85. internamente REDE BANDEIRA SERVI O C D NOME C D NOME C D NOME 102 CIELO 1 VISA 9 Cr dito Vista 102 CIELO 1 VISA 27 Cr dito Parc Adm Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 135 OKI 102 CIELO 1 VISA 28 Cr dito Parc Loja 102 CIELO 2 MASTERCARD 9 Cr dito Vista 102 CIELO 2 MASTERCARD 27 Cr dito Parc Adm 102 CIELO 2 MASTERCARD 28 Cr dito Parc Loja 102 CIELO 8 MAESTRO 6 D bito Vista 102 CIELO 8 MAESTRO 134 Credi rio 102 CIELO 21 ELECTRON 6 D bito Vista 102 CIELO 21 ELECTRON 134 Credi rio 102 CIELO 247 BNDES 6 D bito Vista 102 CIELO 247 BNDES 134 Credi rio 102 CIELO 246 CONSTRUCARD 6 D bito Vista 102 CIELO 246 CONSTRUCARD 134 Credi rio 103 REDECARD L0500 1 VISA 9 Cr dito Vista 103 REDECARD L0500 1 VISA 27 Cr dito Parc Adm 103 REDECARD L0500 1 VISA 28 Cr dito Parc Loja 103 REDECARD L0500 2 MASTERCARD 9 Cr dito Vista 103 REDECARD L0500 2 MASTERCARD 27 Cr dito Parc Adm 103 REDECARD L0500 2 MASTERCARD 28 Cr dito Parc Loja 103 REDECARD L0500 8 MAESTRO 6 D bito Vista 103 REDECARD L0500 8 MAESTRO 45 Compra CDC 103 REDECARD L0500 21 ELECTRON 6 D bito Vista 103 REDECARD L
86. lin WORD CodServico de Contas a ser executado Use O zero para indicar que a decis o do servi o ser atrav s de coleta C digo da bandeira do produto a ser in WORD CodBandeira executado Use O zero para indicar que o c digo da bandeira dever ser coletado Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFEO5 65029 API ainda n o fez nenhuma transa o ap s a inicializa o A aplica o est tentando obter um handle sem ter feito nenhuma transa o desde ltima conex o com o ScopeSRV OxFE06 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 161 OKI OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere H como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremame
87. m dico 138 Coleta a UF do CRM do m dico 139 Decide se coleta seguro 140 Coleta seguro 141 Decide se coleta cart o 142 Coleta se pagamento com cart o 143 Coleta dados da Tokoro 144 Decis o pr via de financiamento pela administradora 145 Decide se quer pagar ap s o vencimento 146 Decide se coleta a senha 147 Imprime o cupom promocional 148 Coleta se utiliza o saldo 149 Coleta o c digo de material 150 Coleta o n mero do plano 151 Coleta se o pagamento em cheque 152 Coleta se confirma a transa o 153 Verifica a n o confirma o da transa o 154 Decide se o pagamento no rotativo 155 Confirma o valor 156 Exibe garantia n o autorizada 157 Coleta CMC7 158 Coleta se o pagamento em dinheiro ou cart o 159 TEF Externa coleta o c digo do grupo de servi o 160 TEF Externa coleta o c digo da rede 161 TEF Externa coleta o c digo do estabelecimento 162 TEF Externa coleta o NSU do host 163 TEF Externa coleta a data no formato DDMMAAAA 164 TEF Externa verifica a transa o 165 Decide se quer realizar uma consulta antes 166 Consultando 167 Coleta se continua ap s a aprova o da conta 168 Coleta o c digo de bandeira 169 Coleta se fatura 170 Verifica o c digo de barras 171 Coleta a confirma o do valor 172 Decide se imprime cupom total ou parcial 173 Coleta valor total 174 Coleta se quer resumo do pagament
88. m quina em que est o I P ou nome da m quina do ame ScopeSRYV ScopeSRV 7 Valor num rico o padr o Port Porta de conex o do ScopeSRV 2046 Par metro que decide se o SCOPE Client se n o deve sincronizar dever alterar a data e a hora da m quina para padr o AtualizaDataHora sincronizar com o ScopeSRV no momento da caso deseja se que conex o sincronize Controla o tamanho m ximo de colunas das 40 colunas padr o f mensagens que o SCOPE Client enviar para a MsgOperReduzida RA 20 colunas aplica o para que esta exiba no teclado do operador ou display com esta finalidade 16 colunas Configura a exibi o do cupom na tela Utilizado n N oexibe 0 ShowCupom apenas na interface HLAPI s Exibe padr o Configura o tempo em segundos de espera Valor num rico entre 10 e 60 TimeOutLogon para a conex o do SCOPE Client com o ScopeSRV Configura o tempo em segundos de espera da Valor num rico entre 15 e 180 TimeOutAdm a resposta da autorizadora em cada transa o padr o 30 Configura se deve exibir o cupom reduzido na n N o exibir 0 CupomReduzido tela Utilizado apenas na interface HLAPI s Exibir Sequ ncia de caracteres no padr o 10 Vers o da automa o passada pela rea de formato RRAAAACCCC sendo VersaoAutomacao o certifica o da Visanet que RR gt release de certifica o do Manual do desenvolvedor SCOPE Solu o Complet
89. meio condutor A senha criptografada pelo PIN Pad com a Master Key da Itautec e ser retornada com criptografia pelo m todo ScopePPGetPINEx A Master Key da Itautec est inserida por padr o nos PIN Pads homologados pela Visanet Iniciando o modo de leitura da senha criptografada A fun o ScopePPStartGetPINEx respons vel pelo in cio do processo o qual complementado pela fun o ScopePPGetPINEx Prot tipo LONG EXPORT ScopePPStartGetPINEx char msgDisplay int mode int mkey char wkey char pan Par metros Mensagem que ser exibida no PIN Pad Esta mensagem in String MsgDisplay deve ter no m ximo 32 caracteres sendo duas linhas de 16 caracteres Modo de criptografia Previsto receber s o valor 0 que usa in lint mode a Master Key Working Key DES Outros modos ser o utilizados no futuro lin lint mkey Indice da MasterKey Previsto receber apenas o valor 0 Outros ndices para uso futuro A Working Key Para o modo 0 dever o ser enviados 8 in String Wkey bytes Caso seja null a fun o n o devolver a senha criptografada e o PAN n o ser utilizado pan PAN do cart o com tamanho entre 11 e 19 d gitos Caso o pan ou a wkey seja null ser utilizado um valor fixo interno in String Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal
90. n o foi aberto pela aplica o Recuperando o cart o A fun o ScopePPGetCard finaliza o processo iniciado por ScopePPStartGetCard e deve ser chamada diversas vezes enquanto retornar 1 PIN Pad em processamento ou 2 exibir para o cliente e para o operador a mensagem que o PIN Pad passou Enquanto nessa situa o o processo pode ser cancelado pelo checkout atrav s da fun o ScopePPAbort Quando a fun o ScopePPGetCard retornar o c digo igual a 2 o PIN Pad colocou uma mensagem no segundo par metro da fun o e a aplica o deve exibi la na tela Logo ap s a exibi o da mensagem a aplica o deve continuar chamando esta fun o at que esta n o retorne mais um dos dois valores relacionados acima Ao retornar o valor O sucesso o ltimo par metro da fun o estar preenchido com os dados do cart o que segue o seguinte formato Posi o Formato Descri o Tipo de cart o lido e 00 Magn tico e 01 Moedeiro VisaCash sobre TIBC v1 001 002 N2 e 02 Moedeiro VisaCash sobre TIBC v3 e 03 EMV e 04 Easy Entry sobre TIBC vi 003 004 N2 Tamanho da trilha 1 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 117 OKI Trilha 1 sem as sentinelas e com o byte de formato primeiro caractere 005 080 A76 a De alfanum rico alinhada esquerda com espa os dir
91. na mesma sess o TEF O motivo para tal funcionamento que a partir do layout 5 pode ser requisitado coleta de senha atrav s do bit 22 do retorno da consulta mensagem 0110 Como essa informa o referente necessidade de coleta de senha deve ser coletada em uma transa o diferente 0200 ela armazenada em um arquivo de contexto e recuperado na compra de medicamentos Atualmente as redes Vidalink e PBM Padr o trabalham com o layout na nova vers o Lista de medicamentos Num fluxo de compra ou consulta de medicamento recebendo o c digo de coleta 64580 ver Status de transa o a aplica o dever obter a lista de medicamentos dispon veis atrav s das fun es ScopeObtemMedicamentos ScopeObtemMedicamentosComCRM ou ScopeObtemMedicamentosEx que ser o tratadas logo abaixo O formato da lista obtido pela fun o ScopeObtemMedicamentos encontra se na tabela abaixo Posi o Formato Descri o 01a 13 String C digo EAN do medicamento 14a 15 String Quantidade autorizada do produto 16 a 22 String Pre o m ximo ao consumidor 23a 29 String Pre o de venda 30 a 36 String Pre o de f brica 37 a43 String Pre o de aquisi o 44 a 50 String Pre o de repasse 51 Byte Reservado para uso futuro 52 a 53 String Motivo da rejei o Prot tipo LONG EXPORT ScopeObtemMedicamentos BYTE Qtd char ListaMedicamentos WORD TamLista
92. operador Mostrar informa es e retornar fluxo Mostrar a mensagem para o operador e OxFCFE 64766 para o cliente SCOPE devolver o controle para o SCOPE N o solicita dados ao operador Constantes em C dos estados de coleta Esta tabela mostra as constantes definidas no arquivo de cabe alho ScopeApi h Esse arquivo disponibilizado junto com o SCOPE Client Muito til para automa es escritas em linguagem C CONSTANTE C DIGO EM HEXA TC DECIDE AVISTA OxFC09 TC DECIDE P ADM EST 0xFCOA TC QTDE PARCELAS 0xFCOE TC ULTIMOS DIGITOS 0xFCc18 TC COLETA DDMMAA 0xFC32 TC COLETA VALOR 0xFC34 TC COLETA NSU HOST 0xFC3A TC EXIBE MENU 0xFC87 TC PRIMEIROS DIGITOS 0xFCC7 TC COLETA CAMPO AUT OxFCC8 TC COLETA CAMPO DOC OxFCC9 TC COLETA EM ANDAMENTO 0xFCFD TC INFO RET FLUXO 0xFCFE Redes e bandeiras O SCOPE Client tem um conjunto m nimo padr o implementado internamente para permitir a transa o POS S o garantidas as redes CIELO e REDECARD L0500 cujos respectivos c digos no SCOPE s o 102 e 103 As bandeiras garantidas s o VISA MASTERCARD ELECTRON ELO DEBITO ELO CREDITO BNDES CONSTRUCARD Os servi os s o D bito Vista Cr dito Vista Cr dito Parc Adm Cr dito Parc Loja Compra CDC e Credi rio A tabela abaixo mostra o relacionamento que o SCOPE Client mant m
93. para manter como o agrupamento no SCOPE No entanto escolhendo a op o de CDC logo no come o simplifica o fluxo j que n o perguntar se vista e perguntar o n mero de parcelas Consequentemente o fluxo poder chegar ao servi o CDC respondendo tanto d bito quanto CDC na primeira coleta Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 139 MENSAGEM TBL 9X VISA ELECTRON I Visanet 444054 2871 07 15 OKI 2a VIA ESTABELECIMENTO AUT B95823 0100002 44470001 POS 2500000C DOC 296844 24 12 12 09 46 VENDA A DEBITO EM Q2 PARCELAS VALOR 10 00 ta PARC 04 12 12 MENSAGEM TBL TC ONL D RECONHECO COMO LIQUIDA E CERTA A DI VIDA POR MIM ASSUMIDA EM DECORRENCIA DO CONTRATO CELEBRADO COM INSTITUI CAO FINANCEIRA EMISSORA DO MEU CARTAO TRANSACAO AUTORI Figura 8 cupom da CIELO ZADA COM SENHA Cupom CIELO X ScopeObtemCampoExt2 X arquivo Nesse t pico s o mapeados os campos de cupons da rede CIELO com as constantes da fun o ScopeobtemCampoExt2 do SCOPE Client e os campos do registro do arquivo de concilia o Na transa o POS o cupom utilizado dever ser a via do estabelecimento Seguindo o exemplo do cupom de uma transa o da CIELO da Figura 8 os campos ser o mapeados da forma conforme abaixo ARQUIVO CONCILIA O FUN O ScopeObtemCampoExt2 CUPOM DESCRI O POS TAM TIPO COMENT RIOS M S
94. s in cartao else ScopePPMsgErro retorno mensagem printf n 3s n mensagem Obtendo a comanda de um cart o A leitura de um cart o do tipo comanda se d com o uso de fun es n o blocantes ScopePPStartObtemComanda e para o tipo comanda caf ScopePPObtemComanda Iniciando o modo de leitura da comanda ScopePPStartObtemComanda a fun o que inicia o processo de leitura do cart o inicializa o timer a ser utilizado para verifica o de time out e direciona para a fun o que trata aquele determinado tipo de comanda Prot tipo LONG EXPORT ScopePPStartObtemComanda int TipoComanda Par metros fin lint TipoComanda Tipo de comanda Atualmente existe apenas o tipo Comanda Caf Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x000A 10 Necess ria opera o previa 0x000F 15 PIN Pad n o foi aberto O0x00CA 202 Mem ria n o alocada para a estrutura do PIN Pad compartilhado 0x00D3 211 PIN Pad n o foi aberto pela aplica o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 121 OKI A fun o ScopePPObtemComanda finaliza o processo iniciado por Lendo a comanda ScopePPStartObtemComanda chamada caso o tipo seja comanda caf onde o cart o tem chip Ela deve ser chamada constantemente enquan
95. solicitada a quantidade de litros de diesel Se o c digo foi 08 ent o a quantidade de servi o de borracharia executado que nesse caso poderia ser apenas 1 Matr cula valor alfanum rico de at 11 d gitos Hod metro valor num rico que o hod metro que est registrando no carro Placa do ve culo campo num rico apenas de at 8 d gitos e deve ser entrada apenas a parte num rica da placa do carro A implementa o desta trata da especifica o das transa es com o cart o com chip Ticket Car na modalidade Benef cio e Gest o de Frotas Transa es com cart o s o suportadas apenas utilizando o chip do cart o Ticket Car As transa es dispon veis no SCOPE que podem ser realizadas com esta rede s o D bito Voucher Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 Estorno Voucher Consulta saldo Atualiza o de par metros Chip Atualiza o de pre os 168 OKI Para trabalhar com Gest o de Frotas necess ria configura o descrita na se o Parametriza o de Gest o de Frota do Manual de Instala o e Configura o do Scope O SCOPE suporta a aprova o off line efetuada em POS e uma caracter stica deste cart o que as transa es aprovadas off line s o armazenadas no pr prio chip do cart o para ser descarregado numa pr xima transa o realizada noutro estabelecimento Portanto o SCOPE suporta o envio d
96. tipo bitwise Ver bits relacionados na tabela Dados dispon veis das transa es na parte da m scara 1 in LONG Masc2 M scara de bits indicando os campos de dados da transa o a serem recuperados que pode ser um valor tipo bitwise Ver bits relacionados na tabela Dados dispon veis das transa es na parte da m scara 2 in char FieldSeparator Caractere de separa o usado quando Masc1 e ou Masc2 forem do tipo bitwise recuperando mais de um campo no mesmo buffer out string Buffer Buffer de destino que conter os dados que o SCOPE retornar Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros char aux 128 handl if handle gt OxFFFF memset aux ArmazenaCampo aux Manual do desenvolvedor ScopeObtemHandl ScopeObtemCampoExt h 0 obtendo o nsu da transa o NO sizeof aux 0x00000004 0x00 17 C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFAO3 64003 Par metro 3 inv lido OxFAO4 64004 Par metro 4 inv lido OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFEO1 65025 SCOPE API n o foi inicializada corretamente Exemplo long h aux exemplo de retorno 015236 SCOPE Solu o Completa para Pagamento Eletr nico 2 27
97. transa o de consulta a cheque iniciada pela fun o ScopeConsultaCheque O fluxo de processamento similar s outras transa es Prot tipo LONG EXPORT ScopeConsultaCheque char Valor Par metros String com o in m ximo de 12 Valor d gitos Valor da transa o com a v rgula impl cita exemplo R 123 00 12300 Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros Hexadeci Decimal mal OxFAO1 64001 Par metro 1 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server 0xFE08 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere H como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutur
98. vers o e o release do SCOPE Client Para a sua instala o execute o comando rpm i itautec scope lt vers o gt 1 1386 rpm Este comando instalar as bibliotecas na pasta usr lib Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 20 OKI IMPORTANTE para a execu o deste comando necess rio ter direitos do usu rio root y N CUIDADO em ambiente Linux o usu rio root tem o direito de realizar comandos que y podem danificar o sistema LEMBRETE podem se acrescentar os par metros vh para exibir o progresso da instala o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 21 OKI Configura o Configura o do arquivo scope ini O arquivo scope ini respons vel por parte da configura o da aplica o Ele deve estar dispon vel com o SCOPE Client independente do sistema operacional que a aplica o executa Sess o lt empresa gt lt filial gt Esta sess o a nica obrigat ria para que o SCOPE Client possa se conectar ao ScopeSRV Dentro dos colchetes deve haver uma sequ ncia de 8 d gitos sendo que os 4 primeiros representam o c digo da empresa e os demais o c digo da filial cadastrado no SCOPE Estes c digos devem ser iguais aos utilizados como par metros da fun o ScopeoOpen Os valores das chaves configur veis nesta sess o se encontram na tabela abaixo N Endere o ou nome da
99. 0 Valor dado como desconto 1 Valor dado como desconto Observa o Repetir este bloco tantas quantas forem as mercadorias que os pre os foram atualizados Dados da Lista de Atualiza o de Pre os de Mercadorias Na transa o de Atualiza o de Pre os de Mercadorias necess rio enviar dados da Lista de Atualiza o de Pre os de Mercadorias O SCOPE retorna no modo coleta o estado de coleta TC COLETA LISTA PRECOS FCCAh e a automa o deve invocar a fun o ScopeForneceCampo com os seguintes par metros e TypeField tipo de dado o SCOPE DADOS LISTA PRECOS gt Fornecer os dados da Lista de Atualiza o de Pre os de Mercadorias A utiliza o desta constante deve ser feita na transa o de Atualiza o de Pre os de Mercadorias no estado de coleta TC COLETA LISTA MERCADORIAS Informa es adicionais na se o Fornecendo informa es extras para a transa o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 172 OKI e StructField dados fornecidos pela aplica o cujo formato para a constante utilizada na tabela abaixo Posi o Formato Descri o 001 004 an4 LP01 Identificador do layout da lista 005 009 an5 ID504 Cont m identificador do formato do registro que ser passado 010 012 n3 Qtd Registros Todos os registros a seguir dever o ser do mesmo formato RR a direita e preenchidos com zeros esquer
100. 0000000 0x00000008 0x00000000 121212 20121212 0x00000004 0x00000000 0x00000000 096044 096044 499931944 0x00004000 0x00000000 0x00000000 499931944 499931944 018833 0x00000100 0x00000000 0x00000000 018833 018833 X 1330 0x00000002 0x00000000 0x00000000 1330 000000000001330 8096 0x00000001 0x00000000 0x00000000 000000 8096 000000 8096 H E E o 0x00000000 0x08000000 0x00000000 0001 0001 z E gt 0001 0x00001000 0x00000000 0x00000000 1 gin E 0x00000000 0x00000000 0x00000080 P id MAESTRO 0x00040000 0x00000000 0x00000000 8 008 REDECARD 0x00400000 0x00000000 0x00000000 103 103 D bito vista 0x00080000 0x00000000 0x00000000 6 006 E 0000 000 Outros cupons X ScopeObtemCampoExt2 X arquivo Pela configura o do scope ini o SCOPE Client poder coletar dados de cupom de outras redes No entanto os nomes dos campos coletados ser o gen ricos ARQUIVO CONCILIA O FUN O ScopeObtemCampoExi2 CUPOM DESCRI O Pos TAM TIPO coment rios MASCARA MASCARA MASCARA campo OBRIG Tipo de registro 1 1 N Constante 1 NA NA NA NA NA Numero do PV 2 15 N C digo do 0x00000800 NA NA NA NA Estabelecimento Data da venda 17 8 D Data da venda NA 0x00000008 NA Data SIM YYYYMMDD NSU 25 6 A Num sequencial 0x00000004 NA NA
101. 000400 M scara 1 C digo do estabelecimento contrato 0x00000800 N mero de parcelas 0x00001000 Taxa de servi o gorjeta 0x00002000 NSU do Host 0x00004000 N mero do banco 0x00008000 N mero da ag ncia 0x00010000 Data de agendamento 0x00020000 C digo da bandeira 0x00040000 C digo do Servi o 0x00080000 Conte do do BIT 62 0x00100000 N mero do controle 0x00200000 C digo de rede 0x00400000 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 219 OKI Nome da bandeira 0x00800000 Nome da Rede 0x01000000 Trilha 02 do cart o 0x02000000 N mero de notas promiss rias 0x04000000 C digo de estabelecimento Visanet 0x08000000 C digo CMC7 0x10000000 CGC do conv nio PBMS 0x20000000 Mensagem de autentica o do cheque 0x40000000 Saldo dispon vel cart o conv nio 0x80000000 NSU da transa o original 0x00000001 Cliente aderente ao seguro IBlCred 0x00000002 Dados do parcelado da rede Cetelem 0x00000004 Data do movimento Interchange BBGCB 0x00000008 Nome do cedente ou empresa de conv nio Interchange 0x00000010 BBGCB Lista das formas de pagamento em TEF permitidas 0x00000020 Interchange Linha de autentica o Interchange Fininvest 0x00000040 Dados da consulta de fatura Interchange Fininvest Vide 0x00000080 ScopeApi h For
102. 0500 21 ELECTRON 45 Compra CDC 103 REDECARD L0500 246 CONSTRUCARD 6 D bito Vista 103 REDECARD L0500 246 CONSTRUCARD 45 Compra CDC Este relacionamento interno poder ser desconsiderado se configurado no scope ini um novo relacionamento Ver t pico Configura o do arquivo scope ini Exemplos de configura o 1 Esse exemplo mostra uma configura o em que a transa o teria um comportamento similar como situa o em que o arquivo n o est configurado O comportamento similar mas n o igual pois n o temos a associa o de servi o para cada configura o de rede ou bandeira Logo no fluxo as bandeiras n o ser o separadas conforme a op o escolhida de cr dito d bito ou CDC credi rio e todas elas aparecer o para que o operador escolha uma SCOPEAPIPOS DigitacaoCodigo n Complementar n Redes 102 103 Bandeiras 1 2 8 21 246 247 NomeBandeira001 VISA NomeBandeira002 MASTE RCARD NomeBandeira008 MAEST RO NomeBandeira SCOPEAPIPOS R102 Nome CIELO NomeBandeira021 ELECT NomeBandeira 246 BNDE 1 CONSTI S RON RUCARD Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 136 OKI Bandeiras 1 2 8 21 247 246 SCOPEAPIPOS R103 Nome REDECARD Pandeihaas PES ITEE
103. 0x0039 057 FIC 0x003A 058 Banestik cart o voucher da TecBan 0x003B 059 Cabal 0x003C 060 TMS 0x003D 061 Bonus cart o voucher 0x003E 062 Visa Vale Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 215 OKI C digos Bandeira Hexadeci Decimal Significado mal 0x003F 063 Correspondente banc rio Banco do Brasil 0x0040 064 Colaborador cart o de cr dito do SONAE 0x0041 065 Incomm reutiliza o do c digo da bandeira CB BankBoston 0x0042 066 Portal Card 0x0043 067 Vale Card 0x0044 068 Personal Card 0x0045 069 Green Card n o mais utilizada 0x0046 070 AsCard 0x0047 071 Evangelico 0x0048 072 Funcional card PBM 0x0049 073 ACSP Associa o Comercial de S o Paulo 0x004A 074 ExtraBom ABN 0x004B 075 Ediguay 0x004C 076 GoodMed PBM 0x004D 077 B nus Eletr nico cart o voucher do SONAE 0x004E 078 RefeiSul 0x004F 079 Multi Alimenta o 0x0050 080 Multi Cheque Novo 0x0051 081 CheckCheck 0x0052 082 EcxCard 0x0053 083 BigCard 0x0054 084 SuperCard 0x0055 085 Banese Banco do Estado de Sergipe 0x0056 086 Novartis PBM 0x0057 087 FlexMed PBM 0x0058 088 TrnCentre Transaction Centre 0x0059 089 InfoCards 0x005A 090 BaseCard 0x005B 091 SysData 0x005C 092 Correspondente banc rio Brades
104. 0xFCD6 Tipo de coleta de dados do Voucher Valor EstadoTC COLETA VALOR 0xFC34 ou TC INFO AGU CONF OP 0xFCFF N mero do Voucher Estado TC COLETA NRO VOUCHER 0xFCA5 C digo EAN Estado TC_COLETA_PRODUTO_SAV 0xFCD6 Valor EstadoTC COLETA VALOR 0xFC34 ou TC INFO AGU CONF OP OxFCFF N mero do Voucher Estado TC COLETA NRO VOUCHER 0xFCA5 N o solicita Coleta de Cliente Preferencial Cliente preferencial o Coleta Cliente Preferencial Sim N o Estado TC COLETA CLIENTE PREFERENCIAL OxFCD8 Para cada Segmento selecionado no Estado de Coleta TC COLETA SEGMENTO SAV 0xFCD4 podem estar dispon veis alguns Fornecedores A lista de Fornecedores associada ao segmento selecionado em passo anterior do fluxo de coleta est descrita posteriormente neste documento na se o Lista de Fornecedores e Parametriza o de Produtos De acordo com a parametriza o do Produto Produto Servi o ou C digo EAN selecionado podem ser habilitados e Coleta de dados din micos Num rico alfab tico alfanum rico menu de op es Trilha de Cart o Data etc Estado TC COLETA DADOS ADICIONAIS 0xFC7C e Exibi o de valor sugerido Estado TC COLETA VALOR 0xFC34 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 186 OKI e Confirma o do Valor Assumido por Parametriza o Estado TC INFO AGU CONF OP 0xFCFF Para
105. 1 61 04 07 2014 Facti Camila M Dutra e Inclus o de c digos de Conv nio Rede e Bandeira da PBM PADR O e Atualiza o da sess o Compra de medicamento a respeito do funcionamento do layout 5 e Atualiza o da sess o Lista de medicamentos Ex 1 62 07 07 2014 Facti Felipe M Schaden e Inclus o da coluna com os C digos SAT na tabela C digo das redes e Inclus o da m scara da fun o ScopeObtemCampoExt2 na tabela Dados Dispon veis para obten o do c digo SAT da transa o 1 63 07 07 2014 Facti Felipe M Schaden e Melhoria do detalhamento do campo SCOPE DADO SEPARADOR LINHA da fun o ScopeForneceCampo para parametriza o do finalizador de linha do cupom e Informa es adicionais para formata o do finalizador de linha da fun o ScopeGetCupomEx 1 64 08 07 2014 Alcimar Joaquim e Inclus o dos poss veis erros retornados pelas as fun es do Scope e Inclus o dos c digos de coleta o Scope para as fun es ScopeCompraCartaoCredito ScopeCompraCartaoDebito ScopeRecargaCelular e ScopeAtualizaPrecosMercadorias 1 65 14 07 2014 Alcimar Joaquim e Inclus o do t pico Cielo na se o Redes com tratamentos espec ficos e No t pico Cielo est descrito como implementar as funcionalidades do Cielo Premia 1 66 30 07 2014 Alcimar Joaquim e Inclus o da fun o ScopeObtemOperadorasRecCelOffTEF e Inclus o da fun o ScopeRec
106. 1 Fidelidade 0x000C 012 Serasa 0x000D 013 Telecheque 0x000E 014 Sodexo Alimentacao 0x000F 015 BrasilCard antiga RVA 0x0010 016 Ticket Alimenta o 0x0011 017 Hipercard 0x0012 018 CardCo antiga CNS 0x0013 019 MaxiCred 0x0014 020 Banrisul 0x0015 021 Visa Electron 0x0016 022 Redecard bandeira para opera es internas independentes de cart o Exemplo Resumo de Vendas 0x0017 023 JCB 0x0018 024 Quality Card 0x0019 025 Unnisa 0x001A 026 Fininvest 0x001B 027 Multi Cheque 0x001C 028 VR cart o voucher da CSU 0x001D 029 TransCheck 0x001E 030 TecBan bandeira gen rica para servi os TECBAN 0x001F 091 ACC Card 0x0020 032 Sorocred 0x0021 033 Parati 0x0022 034 BEM Banco do Estado do Maranh o 0x0023 035 Tokoro 0x0024 036 Zogbi 0x0025 037 TopPremium 0x0026 038 Carrefour cart o voucher da CooperCred 0x0027 039 Rainbow cart o voucher da TecBan 0x0028 040 Telesp Celular 0x0029 041 Policard 0x002A 042 Via Financeira 0x002B 043 IBI 0x002C 044 e Pharma PBM 0x002D 045 Vidalink PBM 0x002E 046 PrevSaude PBM 0x002F 047 e Pharma balc o solicita o de autoriza o via conex o direta com ScopeGW 0x0030 048 Aura 0x0031 049 Correspondente banc rio Unibanco 0x0032 050 Correspondente banc rio Citibank 0x0033 051 Recebimento Fininvest 0x0034 052 Multi Benef cios 0x0035 053 VA Eletr nico cart o alimenta o 0x0036 054 Valetik 0x0037 055 Losango 0x0038 056 Goodcard
107. 4 Coletao CPF do portador 295 Exibe a mensagem de erro de valor do Bradesco 296 Coletao CNPJ 297 Coleta o percentual 298 Coleta o m s de compet ncia do GPS 299 Coleta o n mero do identificador 300 Coleta o valor de INSS 301 Coleta a receita bruta 302 Coleta a op o do operador para confirmar alterar e cancelar 303 Coleta o n mero do Voucher 304 Coleta o valor do saque no PIN pad 305 Scope valida o valor do saque 306 Automa o valida o valor do saque 307 Confirma valor do saque no PIN pad 308 Saque PIN pad em andamento 314 Coleta DDD N mero de Telefone no PIN Pad 315 Redigita DDD N mero de Telefone no PIN Pad 316 Coleta dados ECF 317 Verifica se o cart o Ticket Car benef cio ou gest o de frotas 318 Verifica se h transa o off line gravada no chip do cart o Ticket Car 319 Monta a transa o off line gravada no chip do cart o Ticket Car 320 Apaga a transa o off line gravada no chip do cart o Ticket Car Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 210 OKI 339 Verifica se d bito a vista ou pagamento de carn para GetnetLAC 340 Coleta dados cart o presente 357 Coleta da Lista de Atualiza o de Pre os de Mercadorias 358 Coleta da Lista de Mercadorias Consumidas 359 Decide se deve ser coletada Lista de Mercadorias 360 Decide se devem ser coletados Dados do Ve culo 361 Decid
108. 4 Erro ao desmontar a estrutura ISO Exemplo BYTE bOtdvVias 0 LONG 1Ret StREGISTRO MEDICAMENTO IstMedsCRM 38 0 lRet ScopeObtemMedicamentos amp botdvVias char amp lstMedsCRM sizeof lstMedsCRM if lRet RCS SUCESSO Sucesso no recebimento dos medicamentos os membros das estruturas estar o preenchidos else LA RERO iag Lista de medicamentos com CRM A fun o ScopeObtemMedicamentosComCRM recupera a lista dos medicamentos consultados ou comprados com o CRM do m dico Esta fun o n o suporta as bandeiras Novartis e FlexMed e seu formato obedece defini o da tabela abaixo Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 98 OKI Posi o Formato Descri o Dados do medicamento obedecendo a defini o da 01a58 String tabela retornada para a fun o ScopeObtemMedicamentos 54 a 62 String N mero do CRM Prot tipo LONG EXPORT ScopeObtemMedicamentosComCRM BYTE Qtd BYTE TipoConv char ListaMedicamentos WORD TamLista Par metros out BYTE Qtd Retorna a quantidade de medicamentos consultados ou comprados Retorna o tipo de conv nio 0 Pagamento vista out BYTE TipoConv 1 Pagamento a prazo 2 Empresa Fechada 3 Empresa Aberta out Strin ListaMedicamentos Retorna os medicamentos consultados ou E comprados in
109. 4586 Coleta CRM m dico OxFC4B 64587 Coleta c digo UF CRM m dico OxFC4C 64588 Coleta se cliente deseja aderir ao seguro IBlCred OxFC4D 64589 Coleta se pagamento com cart o OxFC4E 64590 Coleta dados espec ficos da rede Tokoro OxFC4F 64591 Coleta se deseja pagar ap s vencimento O0xFC5O 64592 Coleta se a transa o com senha OxFC51 64593 Imprime cupom promocional OxFC52 64594 Coleta se utiliza saldo OxFC53 64595 Coleta c digo do material OxFC54 64596 Coleta c digo do plano OxFC55 64597 Coleta se o pagamento em cheque OxFC56 64598 Coleta se confirma transa o OxFC57 64599 Coleta se o pagamento no rotativo OxFC58 64600 Coleta CMC7 OxFC59 64601 Coleta se o pagamento em dinheiro ou TEF cart o OxFC5A 64602 Coleta o c digo do grupo de servi o para a TEF Externa OxFC5B 64603 Coleta o c digo da rede para a TEF Externa OxFC5C 64604 Coleta o c digo do estabelecimento para a TEF Externa OxFC5D 64605 Coleta o NSU do Host para TEF Externa OxFC5E 64606 Coleta data ddmmaaaa para TEF Externa OxFC5F 64607 Coleta se consulta Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 193 OKI C digos Retorno
110. 5 0005 GoodCard 0x0006 0006 Novartis 0x0007 0007 FlexMed 0x0008 0008 DataSUS 0x0009 0009 FarmaSeg Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 223 0x000A Pharmalink OKI 0x000B 0011 PBM Padr o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 224 OKI Ap ndice B Especifica o Visanet 4 1 Com a nova especifica o da Visanet denominada Visanet 4 1 as automa es j integradas ao SCOPE necessitar o se readequar e se certificar perante a Visanet Este ap ndice descreve as altera es necess rias Adequa o Para suportar a Visanet 4 1 os PIN Pads ter o seu firmware atualizado Os PIN Pads atualizados s o denominados PIN Pads compartilhados Este novo firmware compat vel com as vers es atuais ou seja tamb m suporta as fun es antigas de acesso ao PIN Pads realizada pela biblioteca PPVISA da Visanet e que eram utilizadas pelas aplica es de PDV No entanto quando o SCOPE estiver configurado para trabalhar com o PIN Pads compartilhado o acesso ao PIN Pads ser feito pelo SCOPE e n o mais pelas aplica es de PDV Abaixo seguem algumas funcionalidades da Visanet 4 1 que exigir o adequa o por parte da aplica o de PDV Transa o de venda cr dito vista ou parcelada Transa o de venda d bito vista parcelada e pr
111. 6 64710 Coletar dados cart o presente OxFCCA 64714 Coleta da Lista de Atualiza o de Pre os de Mercadorias OxFCCB 64715 Coleta da Lista de Mercadorias Consumidas OxFCCC 64716 Coleta de Hor metro OxFCCD 64717 Coleta de Cart o Magn tico OxFCD4 64724 Coleta de Segmento de Mercado OxFCD5 64725 Coleta de C digo de Fornecedor de Produto ou Servi o OxFCD6 64726 Coleta de C digo de Produto C digo de Servi o ou C digo EAN OxFCD7 64727 Coleta de Quantidade Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 195 OKI C digos Retorno Hexa Decimal Significado decimal OxFCD8 64728 Coleta de Confirma o de Cliente Preferencial OxFCD9 64729 Coleta Ramo Principal Cielo Auto OxFCDA 64730 Coleta Codigo de Mercadoria Cielo Auto OxFCFC 64764 Coleta cart o em andamento OxFCFD 64765 Coleta em andamento OxFCFE 64766 Mostrar informa es e retornar fluxo para o cliente SCOPE OxFCFF 64767 Mostrar Informa es e aguardar confirma o do operador Autorizadoras Abaixo se encontram relacionados os c digos devolvidos pelas redes autorizadoras na mensagem 0210 e entregue para a aplica o atrav s da fun o ScopeStatus
112. 7 205 OKI 4 Impress o do cupom 5 Recupera o dos servi os v lidos 6 Coleta de CPF ou CGC 7 8 9 Resultado com transa o cancelada Resultado com transa o autorizada Coleta do n mero do banco 10 Coleta do n mero da ag ncia 11 Coleta do n mero do cheque 12 Coleta da data para dep sito 13 Impress o de cheque 14 Escolha de pagamento vista 15 Escolha do plano de parcelamento da administradora de cart o ou da loja 16 Escolha de pr datado 17 Escolha de parcela vista 18 Coleta do intervalo de datas entre parcelas 19 Coleta de quantidade de parcelas 20 Decidindo o plano de financiamento 21 Coleta de n mero de dias ou da data de d bito 22 Decide se coleta a senha 23 Coleta de senha 24 Carrega da bandeira 25 Desfazimento de transa o 26 Recupera o de dados de transa o 27 Coleta o n mero de controle 28 Consist ncia dos dados originais da transa o cancelamento 29 Consist ncia do cart o 30 Montagem e envio da mensagem de pr autoriza o 31 Escolha da forma de pagamento 1 cheque 2 carn 4 C C 33 Coleta do valor da entrada Valor Entrada 36 Coleta do cheque da parcela Num Cheque Entrada ou Num Cheque Parcela 37 Coleta do n mero da conta corrente do cheque Conta Corrente 38 Encerramento da transa o abortada 39 Decide se deve coletar os 4 ltimos d gitos 40 Coleta os ltimos 4 d g
113. 89 A RESERVADO NAF NAF NA NA NA n o se aplica Para ilustrar o mapeamento considera se o c digo da empresa e o c digo da filial do PDV sendo 0001 e 0001 respectivamente e o cupom de exemplo Ap s a transa o POS do SCOPE Client e a formata o da automa o comercial o cupom dever resultar no registro com exibido na pr xima tabela CUPOM FUN O ScopeObtemCampoExt2 ARQUIVO CAMPO M SCARA 1 M SCARA 2 M SCARA 3 RETORNO REGISTRO nr 0x00000800 0x00000000 0x00000000 n 041212 0x00000000 0x00000008 0x00000000 041212 20121204 096044 0x00000004 0x00000000 0x00000000 096044 096044 0x00004000 0x00000000 0x00000000 i 095023 0x00000100 0x00000000 0x00000000 095023 095023 1000 0x00000002 0x00000000 0x00000000 1000 000000000001000 444054 2871 0x00000001 0x00000000 0x00000000 444054 2871 444054 2871 i E 5 nor 0x00000000 0x08000000 0x00000000 0001 0001 z 0001 2 0x00001000 0x00000000 0x00000000 2 oam 0x00000000 0x00000000 0x00000080 p NEM ELECTRON 0x00040000 0x00000000 0x00000000 21 ngar CIELO 0x00400000 0x00000000 0x00000000 102 102 a 0x00080000 0x00000000 0x00000000 134 i34 Cupom REDECARD X ScopeObtemCampoExt2 X arquivo Como no t pico anterio
114. A quantidade de pr mios pode ser igual a zero e corresponde que n o h AT premia o void demo ExibeResgateNaoMonetario char aux stPPResgateNaoMonetario sDadosResgateNaoMonetario short i nTamanhoEcupom 0 j 0 nQuantidade 0 char sTamanhoEcupom 2 1 sNomeEcupom 99 1 sQuantidade 2 1 memset amp sDadosResgateNaoMonetario 0 sizeof sDadosResgateNaoMonetario memset amp sNomeEcupom 0 sizeof sNomeEcupom memcpy sQuantidade aux 2 sQuantidade 2 0 strcpy sDadosResgateNaoMonetario DadosResgate amp aux 2 nQuantidade atoi sQuantidade if nQuantidade gt 0 printf n nPLATAFORMA PROMOCIONAL n n else printf n nNAO HA PREMIACAO CONSULTE REGULAMENTO return for i Op lt nQuantidade amp amp 1 lt 207 1 memcpy sTamanhoEcupom amp sDadosResgateNaoMonetario DadosResgate j 2 sTamanhoEcupom 2 0 nTamanhoEcupom atoi sTamanhoEcupom q BB memcpy SNomeEcupom amp sDadosResgateNaoMonetario DadosResgate j inTamanhoEcupom sNomeEcupom nTamanhoEcupom 0 j nTamanhoEcupom prince OZ so a sNomeEeupomi primet ENE me UN O return Ap s a exibi o dos pr mios a automa o pode fazer A coleta do ndice n mero do pr mio escolhido pelo cliente TC NRO RESGATE PREMIO OxFCA4 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 179 OKI A c
115. A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE04 65028 N o existe transa o suspensa OxFBO1 64257 N o foi poss vel criar a thread na coleta de dados OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF Exemplo transa o suspensa deseja s ScopeAbort cancelar a transa o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 51 OKI J CUIDADO s poss vel abortar uma transa o quando ela est suspensa A Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 52 OKI TEF Nas se es seguintes trataremos sobre as transa es com cart o cr dito e d bito desde compras a saldo at as pr prias consultas de saldo Cart o de cr dito Uma das opera es mais realizadas numa loja e muito incentivada pelas empresas de cart es o pagamento de compra com o cart o de cr dito apresenta diversos servi os relacionados compra vista parcelada pela loja parcelada pela administradora de cart o consulta de saldo e de financiamento e cancelamento que dedicamos um cap tulo exclusivo Compra com cart o de cr dito Embora haja diversos servi os relacionados ao cart o de cr dito apenas uma fun o est dispon vel ScopeCompraCartaoCredito Ela se refere ao grupo de servi o de cr dito e trata os seus servi
116. API antes do in cio da transa o de recarga chamada fun o ScopeRecargaCelular a aplica o deve informar ao SCOPE que o processamento deve ser suspenso via ScopeSuspend no estado 187 coleta a operadora Quando a ScopeStatus retornar 65027 existe transa o suspensa a aplica o deve receber a lista de operadoras dispon veis via ScopeRecuperaOperadorasRecCel exibila ao usu rio de alguma forma informar ao SCOPE um novo estado de suspens o o 95 coleta o valor de recarga de celular e dar continuidade ao processamento com a ScopeResume Posteriormente a ScopeStatus ir retornar novamente o valor 65027 existe transa o suspensa nesse contexto indicando o momento para a exibi o dos valores de recarga dispon veis Tais valores ser o obtidos pela fun o ScopeRecuperaValoresRecCel e dever o ser exibidos ao usu rio pela aplica o A aplica o deve informar um novo estado de suspens o 4 imprime cupom e permitir a continuidade do processamento com a ScopeResume Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 71 OKI Iniciando a transa o de recarga O in cio desta transa o dado pela cnamada fun o ScopeRecargaCelular Esta transa o como todas as outras deve estar numa sess o de TEF ver Sess o de transa o Prot tipo LONG EXPORT ScopeRecargaCelular void Par metros N o h par metros Retorno Ver t
117. AR amp ListaValores sizeof ListaValores codOperadora codLocalidade if RC RCS SUCESSO RC RCS ACQUIRER OFF Exibe os valores Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 82 OKI Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 83 OKI Estorno de transa es O estorno uma transa o de anula o de outra transa o que j est confirmada no lado da autorizadora e pode ser realizada quando ocorrerem erros na digita o valor data de agendamento das parcelas numero de parcelas etc ou desist ncia da compra por parte do cliente O SCOPE disponibiliza uma nica fun o para o estorno das diversas transa es ScopeCancelamento No entanto nem todas as transa es s o estorn veis como por exemplo transa es de consultas Na tentativa de estorno destas transa es o SCOPE retornar atrav s da fun o ScopeStatus o c digo de erro 65286 informando que a transa o n o cancel vel O estorno difere do desfazimento no sentido em que o primeiro uma nova transa o isolada enquanto o segundo a finaliza o de uma transa o Tanto que existe o desfazimento do estorno que n o permite que ocorra o cancelamento da transa o original mantendo a com o status de confirmada CUIDADO n o poss vel o cancelamento de uma transa o sem que esta j tenha sido Dai
118. BAL VOUCHER da lista de bandeiras pois j existe uma bandeira semelhante CABAL VALE 1 75 27 02 2015 Facti Felipe M Schaden e Inclus o da m scara da fun o ScopeObtemCampoExt2 na tabela Dados Dispon veis para obten o do c digo SAT e CNPJ da rede credenciadora da transa o 1 76 12 03 2015 Jailton Santana e Inclus o do par metro GenTiemout e Formata o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 7 OKI Indice PEOTACIO PA AAE E A I EN dani A asda nei aa danicancanacnl a 13 Aguen se destinan cieren a ar E EEE EE EAE AAR 13 ROQUISILOS anann e EE AEA EE EA EN 13 Plataformas Compat veis nimiro maesi dnai aiana n E iaa EAE a EAEE ENEE NEES 13 Requisitos de HW orana a A E R EEE EEA R 13 Requisitos de SW treets anaana ia aaa afora LA EEEN n Ea eaaa BAA E eE AEEA ENEE a renda Lg 13 Descri o do Prodi senenn AEA A R REA do fama aaa 13 ODJEtV Omina a aa a RA N a E EE Ea aa RR RR RD AEAT 13 DETInI O spessa a E SE E S E E E S ane gas im das uam 13 BENCT CIOS sogenitutisdn sianainatinon aa aeaa a aa ania arana ea aaka aaa eaea a OEE ai ANANE 13 COMNCO OS E a dd a aa 15 Transa es sia escapiogeess A E bodas iuaen E E a asa iba ag du Fev aa add br asd alan asia ql Maga aa va Ud Srta ada 15 Fluxo de estados de coleta center ceenaeaeaaanacaaananacaaaanaa aa aaanaa aa anana aaa AAAA AAN ananaaaa 16 Interfaces de inte
119. CARA 1 M SCARA M SCARA 3 CAMPO Tipo de registro 1 1 N Constante 1 NA NA NA NA Numero do PV 2 15 N C digo do 0x00000800 NAR NAF NA Estabelecimento Data da venda 17 8 D Data da venda x Data YYYYMMDD NA 0x00000008 NA NSU 25 6 A lea seq encial 0x00000004 NAM NaS DOC NSU do Host 31 15 A NSU complementar 0x00004000 NA NA NA C digo de 41 14 A C digo de AUT autoriza o autoriza o gzouaodion as NAS Valor da 51 15 2 N Valor da opera o 0x00000002 KAS NAS VALOR compra N mero do 66 22 A N mero do cart o 6 primeiros e 4 cart o 0x00000001 NA NA ltimos d gitos do cart o Status da 85 1 A Transa es OK NA transa o preencher com a NA NA NA letra O C digo 86 4 N Formato 0000 a NA Empresa NA 0x08000000 NA Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 140 OKI C digo Filial 90 4 N Formato 0000 NA NA NA NA Qtd Parcelas 94 2 N Quantidade de N mero de parcelas Se venda 0 00001000 NAS Na parcelas for vista preencher 00 Forma Captura 96 1 A P PosS P NA Internet M z Manual T TEF ou NA NA 0x00000080 O Outros C digo 97 3 N E A Bandeira C digo da Bandeira 900040000 NA Na Bandeira C digo Rede 100 N C digo da Rede 0x00400000 NA NA Rede C digo Servi o 103 5 N C digo do Servi o 0x00080000 NA NA Venda RESERVADO 108
120. CIELO E Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 175 OKI IMPORTANTE A 1 Antes de iniciar os testes lembre se de for ar uma Inicializa o para o estabelecimento em quest o para garantir que a carga PP OnLine seja carregada no banco de dados pelo ScopeSRYV 2 Os pr mios e cupons gerados pelo ScopeAUT possuem conte dos fixos e portanto n o representam efetivamente o que ir ocorrer em produ o poss vel fazer um teste usuando o HotKey Sim O HotkeyHLAPI HotKeyColeta e TstColeta est o preparados por m deve ser configurada uma nova chave no SCOPE INI do client conforme exemplo abaixo considerando empresa 0001 e filial 0001 00010001 AutomacaoParticipaPPOnline S A Automa o Comercial deve se adequar Sim A Automa o Comercial precisa informar que est preparada para o Cielo Premia adequar os fluxos de Cr dito e D bito e permitir o Resgate de Pr mio O que a Automa o Comercial precisa fazer para estar aderente Para habilitar o Cielo Premia ou seja configurar que est preparada Ap s o ScopeOpen chamar a fun o ScopeForneceCampo passando como par metros o tipo de dado SCOPE AUTOMACAO PARTICIPA PPONLINE e o conte do S ou 1 para indicar que SIM ou seja a automa o est preparada para participar da plataforma Cielo Premia Maiores detalhes sobre esta fun o est o no Manua
121. Cel da estrutura acima cont m a lista desejada e para percorr la pode se utilizar a estrutura typedef struct char CodOperCel char NomeOperCel TAM NOME OP Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 74 OKI StREC CEL ID OPERADORA ptREC CEL ID OPERADORA onde e CodOperCel c digo da operadora que ser escolhido pelo operador e devolvido para o SCOPE e NomeOperCel nome da operadora representada por uma string Reescrevendo o c digo exemplificado acima obtemos int StREC CEL OPERADORAS ListaOper StREC CEL ID OPERADORA Oper long retorno retorno ScopeRecuperaOperadorasReccCel 2 char amp ListaOper sizeof ListaOper if retorno 0 printf n n LISTA DE OPERADORAS Ann Exibe as operadoras for i 0 I lt int ListaOper NumOperCel i inicializa estruturas memcpy amp 0per amp ListaOper OperCel i sizeof stREC_ CEL ID _ OPERADORA sizeof StREC CEL ID OPERADORA printf ncCod sd Oper 21s int buffer ind_op buffer ind op 1 Prot tipo LONG EXPORT ScopeRecuperaOperadorasRecCel BYTE TpTab char buffer WORD TamBuf Par metros Informa o formato da tabela que a in BYTE TpTab aplica o de
122. Coletar o pr mio escolhido e a quantidade Para recuperar e exibir os dados dos pr mios 1 Trataro estado TC EXIBE MENU RESGATE PREMIO 2 Chamar a fun o ScopeObtemCampoExt2 pedindo pelos dados de resgate n o monet rio 3 Exibir sequencialmente os pr mios de acordo com exemplo abaixo SEE mm switch RC case TC EXIBE MENU RESGATE PREMIO h ScopeObtemHandle 0 if h gt 0xFFFF ScopeObtemCampoExt2 h 0x00 0x00 Dados Resgate Nao Monetario 0 aux demo ExibeResgateNaoMonetario aux S E Onde aux cont m um buffer que contenha espa o necess rio para ser armazenado o n mero de pr mios e os dados relativos aos pr mios O buffer ser preenchido com a seguinte estrutura typedef struct char QtdeOcorrenciasECupom 2 char DadosResgate 3000 stPPResgateNaoMonetario Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 178 OKI Os dois primeiros bytes do buffer correspondem quantidade de pr mios e os bytes restantes ser o os dados dos pr mios Para cada pr mio ele ser prefixado com 2 bytes que representam o tamanho do texto Posi o Formato Descri o 01 02 N2 N mero de E cupons 03 04 N2 Tamanho do 1 E cupom 05 x A n T tulo do 1 Pr mio de tamanho n vari vel definido nos 2 bytes anteriores Obs Repetem se tamanho e t tulo para os N cupons IMPORTANTE
123. Durante a coleta do cart o se for acionado a tecla Cancela no PIN Pad o E se no estado TC COLETA CARTAO EM ANDAMENTO 0xFCFC for executada a fun o ScopeResumeParam com o par metro CANCELA Se ocorrer uma das op es acima o SCOPE devolver o estado de coleta TC CARTAO DIGITADO 0xFC85 para receber da aplica o de PDV o n mero do cart o digitado Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 227 OKI e No arquivo scope ini poder ser desabilitado as op es acima digita o do cart o ver Sess o PPCOMP Opcionalmente a aplica o de PDV tamb m poder utilizar a fun o ScopeConfigura para o mesmo fim e O SCOPE tamb m disponibilizar a fun o ScopeValidaInterfacePP que possibilitar a aplica o de PDV validar se est utilizando a mesma interface de acesso ao PIN Pad que o que est configurado no SCOPE Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 228 OKI Ap ndice D Conjunto de bibliotecas do SCOPE Client Neste ap ndice relacionamos o conjunto de bibliotecas e arquivos que comp e o ambiente em que se localiza o SCOPE Client para cada sistema operacional e linguagem MS WINDOWS Para a maioria dos ambientes de programa o as bibliotecas necess rias para a execu o do SCOPE Client em MS Windows s o CMCT7 DLL COMVERIFONE DLL CSMSG DLL ECF4000 DLL ECNF DLL PINPAD DLL PPDIOW32 DLL
124. EL V0003 2 V0005 91 1 UPAID VI XX 2 V2 00 102 0 CIELO 4 1 0 1 4 1R2014 103 1 REDECARD V5 00 2 V5 01 3 V5 02 118 1 TENDENCIA VI XX 2 V2 00 C digo das bandeiras Como algumas transa es exigem o operador deve escolher uma bandeira e passar para o SCOPE o seu c digo cuja rela o se encontra abaixo Para que o operador possa escolher necess rio que ele tenha uma lista com os c digos de cada bandeira Uma op o ter uma lista impressa dispon vel para o operador No entanto como geralmente nem todas as bandeiras s o utilizadas para uma determinada loja pode ser vi vel a aplica o por meio de configura o exibir na tela uma lista de op es somente com as bandeiras utilizadas no momento que for necess rio C digos Bandeira Hexadeci Decimal Significado mal 0x0000 000 SCOPE 0x0001 001 Visa 0x0002 002 Mastercard 0x0003 003 Amex 0x0004 004 Lojista 0x0005 005 Dinners 0x0006 006 Sollo 0x0007 007 Cheque Eletr nico 0x0008 008 Mastercard Maestro conhecido tamb m como Redeshop 0x0009 009 Ita Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 214 OKI C digos Bandeira Hexadeci Decimal Significado mal 0x000A 010 Bradesco 0x000B 01
125. ENIOS 0x00B1 177 AMCARD 0x00B2 178 Rede MED 0x00B3 179 GPA 0x00B4 180 PAT sem senha 0x00B5 181 PAT com senha 0x00B6 182 FAN CARD 0x00B7 183 BANRICOMPRAS 0x00B9 185 Banrisul Refeisul Alimenta o Refei o 0x00BA 186 Banrisul Refeisul Combust vel 0x00BB 187 TIM ON LINE 0x00BC 188 BNB Clube 0x00BD 189 NEUS Senha 0x00BE 190 Diamante 0x00BF 191 MinasCred 0x00C0 192 Nutricash 0x00C2 194 ELO Debito 0x00C3 195 ELO Credito 0x00C4 196 Goodcard Senha 0x00C7 199 USECRED sem senha 0x00C8 200 USECRED com senha 0x00C9 201 SOROCRED Cr dito 0x00CA 202 SICREDI Cr dito 0x00CB 203 SICREDI D bito 0x00CC 204 BrasilCard com senha 0x00CF 207 PL GETNET VISA 0x00DO 208 DMCARD 0x00D1 209 PLANVALE com senha 0x00D2 210 SISCRED sem senha 0x00D3 211 SISCRED com senha 0x00D4 212 DMCARD com senha 0x00D5 213 RedeSoftnex Conv nio 0x00D6 214 RedeSoftnex 0x00D7 215 Claro Off line 0x00D8 216 Oi Fixa 0x00D9 217 Oi Off line 0x00DA 218 Vivo off line 0x00DB 219 Telesp Super 15 0x00DC 220 Embratel Livre Online 0x00DD 221 Epay 0x00E0 224 Orgcard d bito 0x00E1 225 Orgcard cr dito 0x00E2 226 Orgcard cr dito DV CS 0x00E4 228 Ticket Car 0x00E5 229 PL GETNET MASTER 0x00E6 230 SAVS 0x00E9 233 POLICARD SENHA 0X00F1 241 GIVEX 0x00F2 242 CREDITEM SENHA 0x00F4 244 MURY 0x00F5 245 ABRAPETITE 0x00F8 248 Sodexo Refeicao 0x00FA 250 TOPCARD com senha 0x00FB 251 TOPCARD sem senha Manual do desenvolvedor SCOPE Solu o Completa para P
126. ETNET como conting ncia al m do POS da CIELO e da REDECARD Al m disso associa os servi os de cr dito para SIMCRED e VISA e o servi o de d bito para ELECTRON Exemplos de configura o 5 SCOPEAPIPOS DigitacaoCodigo n Complementar s Redes 3 Bandeiras 136 NomeBandeiral36 SIMCRED SCOPEAPIPOS R073 Nome GETNET Bandeiras 136 1 2 ServicoB001 9 027 28 ServicoB136 009 27 028 ServicoB021 6 Exemplos de configura o 6 Esse exemplo mostra uma configura o em que a transa o teria um comportamento igual situa o em que o arquivo n o est configurado Diferente do exemplo 1 aqui o comportamento igual pois temos a associa o de servi o para cada configura o de rede ou bandeira ISCOBRA PINOS DigitacaoCodigo n Complementar n Redes 102 103 Bandeiras 1 2 8 21 246 247 NomeBandeira001 VISA NomeBandeira002 MASTERCARD NomeBandeira008 MAESTRO NomeBandeira021 ELECTRON NomeBandeira246 BNDES NomeBandeira247 CONSTRUCARD SCOPEAPIPOS R102 Nome CIELO Bandeiras Dre 2 MZA A6 ServicoB001 009 27 28 ServicoB002 9 27 28 ServicoB008 6 134 ServicoB021 6 134 ServicoB247 6 13 ServicoB246 6 1 pl SCOPEAPIPOS R103 Nome REDECARD Manual do desenvolvedor SCOPE
127. HA Schaden 1 16 07 06 2011 FacTI Vinicius Peracini Atualiza o da tabela de redes e bandeiras Atualiza o da tabela de c digos de erro com o erro OxFF6B 1 17 02 08 2011 FacTI Juliana Bersi e Inclus o do prot tipo das fun es ScopeMenuSelecionaltem e ScopeMenuRecuperaltens 1 18 09 08 2011 Frederico C Goulart Atualiza o da tabela de redes e bandeiras e Coleta Confirma o do valor do saque pelo PIN pad e Inclus o de ndices m scaras nas fun es ScopeForneceCampo ScopeSuspend ScopeConfigura e 1 19 23 08 2011 FacTI Rafael D Tardivo ScopeObtemCampoExt2 para uso em configura es de coleta valida o do saque Inclus o da chave ScopeValidaSaque configur vel por chave no INI ou REGISTRY e Consulta Cr dito Infocards Marcelo Dionysio da e Nova coleta TC COLETA TIPO CONSULTA 0xFCB8 1 20 12 09 2011 Fonseca e Novo campo da Mascara 3 do ObtemCampo Resposta Consulta Infocards 0x00000020 0x0000002 e Inclus o dos tr s novos estados de coleta 0xFCB6 1 21 15 09 2011 FacTI Juliana Bersi 0xFCB7 OxFCB9 para quando for solicitado o cart o digitado no Pin Pad e Inclus o dos estados de coleta OxFCBA e 0xFCBB para o 1 22 04 11 2011 Edison Ogata i Troco Visa Douglas Sebastiani e Inclus o dos t picos Plataformas Compat veis Requisitos 1 23 29 11 2011 a de HW e Requisitos de SW Bucciolli e Atualiza o do gloss rio 1 24 5 01 2012 Facti Rafael D Tardivo Inclus o dos c digos d
128. MedicamentosEx recupera a lista dos medicamentos consultados ou comprados em qualquer formato dispon vel atualmente A fun o deve receber qual a vers o que se deseja da lista de medicamentos como ser descrito a seguir Os formatos de listas antigas permanecem os mesmos por m h o formato do layout 5 conforme descrito no documento Scope PBM Vers o 1 10 doc que obedece tabela abaixo Posi o Formato Descri o 01a 13 String C digo EAN do medicamento 14a 15 String Quantidade autorizada do produto 16a 17 String Motivo da rejei o 18a 26 String C digo do conv nio 27a 34 String Pre o m ximo ao consumidor 35 a 42 String Pre o de venda 43 a 50 String Pre o de f brica 51a58 String Pre o de aquisi o 59 a 66 String Pre o de repasse 67 a 79 String N mero do CRM Prot tipo LONG EXPORT ScopeObtemMedicamentosEx BYTE IdLayout BYTE QtdRegistros char ListaMedicamentos WORD TamLista BYTE TipoConvenio Par metros in BYTE IdLayout Vers o da lista de medicamentos que se deseja recuperar devendo ser como definido na tabela a seguir out BYTE QtdRegistros Retorna a quantidade de medicamentos consultados ou comprados out String ListaMedicamentos Retorna os medicamentos consultados ou comprados in WORD TamLista Tamanho em bytes do campo ListaMedic
129. NA N O nico NSU do Host 31 15 A NSU complementar 0x00004000 NA NA CV N O C digo de 41 14 A C digo de 0x00000100 NA NA AUTO autoriza o autoriza o N O Valor da 51 15 2 N Valor da opera o 0x00000002 NA NA TOT SIM compra APROVADO N mero do 66 22 A N mero do cart o 0x00000001 NA NA 6 primeiros 5 cart o d gitos do NAO cart o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 143 OKI 4 ltimos d gitos do SIM cart o Status da 85 1 A Transa es OK NA NA NA NA transa o preencher com a NA letra O C digo 86 4 N Formato 0000 NA 0x08000000 NA NA NA Empresa C digo Filial 90 4 N Formato 0000 NA NA NA NA NA Qtd Parcelas 94 2 N Quantidade de 0x00001000 NA NA N mero de parcelas Se venda parcelas SIM for vista preencher 00 Forma Captura 96 1 A P POS I NA NA 0x00000080 NA Internet M NA Manual T TEF ou O Outros C digo 97 3 N NA NA SIM Bandeira C digo da Bandeira 0x00040000 Bandeira C digo Rede 100 3 N C digo da Rede 0x00400000 NA NA Rede SIM C digo Servi o 103 5 N C digo do Servi o 0x00080000 NA NA Venda SIM RESERVADO 108 89 A RESERVADO NA NA NA NA NA Formata o para o arquivo de concilia o Observa se nos exemplo
130. OC 65292 Transa o n o implementada OxFFOD 65293 Handle inv lido ver Obtendo handle OxFFOE 65294 Taxa de servi o inv lida OxFFOF 65295 Taxa de servi o excede limite OxFF1O 65296 Dado inv lido OxFF11 65297 N o existe cupom v lido OxFF12 65298 rea reservada para o buffer insuficiente para o SCOPE Client preencher com os dados solicitados OxFF13 65299 Limite inv lido inferior ao permitido OxFF14 65300 Transa o desfeita OxFF15 65301 Digita o n o permitida OxFF16 65302 Mem ria insuficiente OxFF17 65303 Service Code inv lido OxFF18 65304 Data inv lida OxFF19 65305 Cart o vencido OxFF1A 65306 Cart o inv lido OxFF1B 65307 Desfazimento n o dispon vel OxFF1C 65308 Erro na impress o do cupom OxFF1D 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFFE 65310 Transa o j efetuada OxFF1F 65311 Inserir chip do cart o OxFF20 65312 Controle obrigat rio OxFF21 65313 Pr autoriza o obrigat ria OxFF22 65314 Servi o n o configurado OxFF23 65315 Servi o n o definido OxFF24 65316 N mero de parcelas inv lidas OxFF25 65317 Valor inv lido OxFF26 65318 Servi o ou BIN n o configurado para Visanet OxFF27 65319 Estado de coleta n o definido
131. OKI SCOPE Manual do Desenvolvedor OKI Informa es Gerais Leia antes de utilizar o software imprescind vel a leitura deste material para o correto procedimento de instala o configura o e administra o deste produto Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 2 OKI Revis o Data Respons vel Hist rico 1 0 13 04 2010 Equipe Desenv SCOPE Vers o Inicial i Revis o do texto e inclus o de novos retornos e tipos de 1 1 30 04 2010 Equipe Desenv SCOPE dados FacTI Vinicius 1 2 01 07 2010 o Inclus o de tabela com c digo das redes Peracini Inclus o da m scara Logo_PAN usada na 1 3 31 08 2010 Paulo dos Santos ScopeObtemCampoExt Inclus o dos c digos de retorno coleta de dados da descri o do novo tipo de dado inclus o da nova fun o na sess o Fun es diversas obtendo os campos inclus o do FacTI Tiago Val rio o s o c digo de bandeira c digo do grupo de servi os e c digo do 1 4 04 10 2010 Frederico C Goulart N servi o referentes Plataforma Promocional da rede Cielo Jailton da S C Santana Novo tipo no ScopeForneceCampo Altera es referentes s transa es Banrisul EMV Acr scimo de t pico para detalhes espec ficos das redes 1 5 29 12 2010 Paulo dos Santos Atualiza o da tabela de bandeiras 1 6 05 01 2011 Marcos Teruhiro Atualiza o da tabela de
132. ONG ScopeIniciaTotalTEF BYTE Nivel Par metros Indica a que n vel dever ser inicializado in BYTE Nivel os totais de TEF 0 ambos 1 apenas do operador Retorno C digo Descri o A o 0x0000 Sucesso na inicializa o dos totalizadores OxFBO7 Erro na totaliza o de TEF causado por verifique o valor do par metro Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 125 OKI um dos motivos par metro inv lido n o foi poss vel criar o arquivo n o foi poss vel atualizar o arquivo n o foi poss vel ler o arquivo passado verifique o par metro passado fun o verifique direitos de grava o cria o e leitura de arquivos para o usu rio logado no PDV verifique se existe espa o dispon vel no disco OxFEOO Transa o em andamento impossibilita a execu o desta fun o o que Revisar a aplica o pois ela est chamando a fun o em momentos errado Ver tabela de c digo de retorno Cupom dos totais Exemplo carrega configura o do PDV de um novo dia conecta ao SCOPE Server erro ao zerar o arquivo if ScopeIniciaTotalTEF 0 0 zera ambos N o importa se por PDV ou por operador uma forma que o SCOPE entrega o relat rio para a J4 aplica o um texto formatado com 40 colunas que pode ser enviado diretamente para a impressora confo
133. OPE Esta reimpress o atua apenas entre o SCOPE Client e o SCOPE Server e n o vai para a autorizadora Prot tipo LONG EXPORT ScopeReimpressaoOffLine void Par metros N o h par metros Retorno Ver tabela de c digo de retorno Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 88 OKI Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBO3 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line 0xFF1D 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFFFF 65535
134. OPE Client procedendo libera o de todos os recursos alocados dever ser executada uma nica vez no t rmino do aplicativo usu rio Prot tipo Essa fun o LONG EXPORT ScopeClose void Par metros N o h par metro Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0xFE01 65025 SCOPE API n o foi inicializada corretamente 0xFE00 65024 A transa o em andamento a aplica o deve aguardar Exemplo retorno ScopeClose Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 30 OKI Sess o de transa o Sess o de TEF O conceito de sess o de TEF existe para garantir a integridade de uma opera o Desta forma entre a abertura e encerramento da sess o todas as atividades inclu das na respectiva opera o autoriza o da transa o impress o de comprovante dever o ser completamente realizadas Este mecanismo permite que em caso de falha queda de energia a opera o possa ser desfeita Isso corresponde a imprimir corretamente o cupom de TEF e garantir que a falha ocorrida n o atrapalhe no funcionamento da aplica o Sendo multi TEF o SCOPE implementa o conceito de sess o de TEF com o intuito de garantir que todas as transa es numa mesma sess o ser o aprovadas ou desfeitas Com isto o cliente pode efetuar o pagamento parcialment
135. OperadorasRecCelOffTE amp ListaOper sizeof ListaOper if RC RCS SUCESSO return RC exibe as operadoras Prot tipo OKI F REC CEL OPERADORAS MODELO 2 P_CHAR Obtendo valores de recarga dispon veis fora do fluxo de recarga Para obter os valores dispon veis para recarga deve ser feita uma chamda a fun o ScopeRecuperaValoresRecCelOffTEF ela retornar um buffer com a lista de valores dispon veis para uma operadora de uma localidade espec fica EXPORT ScopeRecuperaValoresRecCelOffTEF BYTE _TipoTabela char Buffer WORD TamBuffer char CodOperadora char CodLocalidade Par metros Informa o formato da tabela que a in BYTE TipoTabela aplica o deseja receber a lista de operadoras Aceita apenas o valor 2 Buffer com a lista de valores de recarga out String Buffer dispon veis Tamanho do array buffer segundo in WORD _TamBuffer par metro alocado que deve ser igual a 427 bytes in String CodOperadora C digo da bandeira da operadora in String CodLocalidade C digo da localidade DDD Retorno Ver tabela de c digo de retorno Exemplo LONG RC char codOperadora 3 1 char codLocalidade 2 1 StREC CEL VALORES ListaValores 0 Entra com o c digo da operadora e a localidade RC ScopeRecuperaValoresRecCelOffTEF BYTE JREC CEL VALORES MODELO 2 P CH
136. PE Solu o Completa para Pagamento Eletr nico 2 27 212 OKI C digos Rede Significado C digo SAT Decimal Decimal 86 Valeshop 999 87 Fidelize 999 88 UtilCard 999 89 RV Tec 999 90 GW Cel 999 91 U Paid 999 92 Redecard especifica o L0401 25 93 Banpar 999 94 Neus 999 95 CredShop 999 96 Banco HSBC 999 97 Banco do Brasil ISO GCB 999 98 Pharma Link 999 99 Banrisul EMV 999 100 Banestes 999 102 Cielo 12 103 Redecard especifica o L05 00 25 104 Diamante 999 105 RedeSoftnex 999 109 Usecred 999 112 DMCARD 999 113 Siscred 999 114 Epay 999 116 Orgcard 999 117 SAVS 999 118 TENDENCIA 999 121 RVTECNOLOGIA 999 123 GIVEX 999 124 CREDITEM 999 125 FOXWIN 999 126 BIN 999 127 TOPCARD 999 128 ELAVON 999 129 VR 31 133 PBM PADRAO 999 134 CONDUCTOR PL especifica o V02 05 999 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 213 OKI C digo de especifica o das redes Abaixo se encontram as redes que possuem mais que uma especifica o suportada pelo SCOPE C digo C digo Significado Rede Especifica o 13 1 SYSDATA VI XX 2 V2 00 66 1 CHECKEXPRESS V1 XX 2 V2 00 73 1 GETNET 6 0 V01 00 2 V02 00 77 1 IBI V1 XX 2 XSAB 1 28a 89 2 RVTEC V2 00 90 1 GWC
137. PGetCard 0 mensagem sizeof cartao cartao printf inMensagem do PIN Padin s An mensagem enquanto em processamento se OK 118 OKI printf inOs dados do cart o s o s in cartao Abortando o processamento ScopePPAbort Esta fun o finaliza um processo em andamento iniciado por uma fun o do tipo n o blocante que seguem o padr o ScopePPStartFunc Ela deve ser chamada caso o operador do checkout decida abortar a opera o enquanto a fun o complementar ScopePP Func estiver retornando o valor 1 PIN Pad em processamento Prot tipo LONG EXPORT ScopePPAbort void Par metros N o h par metro Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x00D3 211 PIN Pad n o foi aberto pela aplica o Exemplo char cartao 256 char mensagem 256 LONG retorno 0 if ScopePPStartGetCard 99 000 0 printf inAguardando inserir ou passar o cartao do retorno ScopePPGetCard 0 mensagem sizeof cartao cartao if retorno 2 printf inMensagem do PIN Pad n 3s n mensagem if _kbhit se operador pressionou tecla do teclado cancela o processamento do cartao ScopePPAbort retorno 13 while retorno 1 retorno 2 enquanto em processamento ou mensagem Manual do desenvolvedor SCOPE
138. Pagamento Eletr nico 2 27 220 OKI Dados da resposta de Consulta da EPAY Os dados 0x00000040 retornados consistem em 3 valores de concatenados 1 Valor M nimo 12 d gitos 2 Valor M ximo 12 d gitos 3 Saldo Dispon vel 12 d gitos Maximo de mercadorias permitidas para uma transacao 0x00000100 TicketCar O dado retornado um campo de 2 digitos C digo SAT ver c digos em C digo das redes 0x00000200 Vers o corrente de Carga de Tabelas do Host Formato 10 0x00000400 d gitos Preenchido com zeros a esquerda caso necess rio Dispon vel em transa es com as seguintes Redes e SAVS CNPJ da rede credenciadora SAT 0x00002000 Grupo de Servi os Nesta tabela encontram se os grupos de servi os que o SCOPE trabalha C digos Bandeira Hexadeci Decimal Significado mal 0x0001 001 Cart o de d bito 0x0002 002 Cart o de cr dito 0x0003 003 Consulta a cheques 0x0004 004 Controle SCOPE Autorizador 0x0005 005 Controle API Server 0x0006 006 PAT 0x0007 007 CDC 0x0008 008 Garantia de desconto de cheques 0x0009 009 Resumo de vendas 0x000A 010 IATA para companhias a reas 0x000C 012 Reimpress o de comprovante 0x000E 014 Fidelidade 0x000F 015 Recarga de celular 0x0010 016 Transa o financeira 0x0011 017 Investimento 0x0012 018 Medicamento 0x0013 019 Pagamento de conta 0x0014 020 T cnico 0x0017 023 Ad
139. Par metros out BYTE Qtd Retorna a quantidade de medicamentos consultados ou comprados out Strin ListaMedicamentos Retorna os medicamentos consultados ou 9 comprados in WORD TamLista Tamanho em bytes do campo Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 97 OKI ListaMedicamentos Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE0O4 65028 N o existe transa o suspensa OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere H como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFFF 65535 Erro gen rico OxFF5E 6537
140. Trans 0 0 0000 Contato 070 0 Be 0 o Servidor de TEF em Opera o Figura 11 janela principal do servidor SCOPE A janela similar a da Figura 12 ser apresentada Al m de outras informa es nela est a vers o do SCOPE Client representado no campo ScopeAPI neste exemplo vemos 2 27 02 01 Percebe se que embora tenha clicado num PDV espec fico na janela principal do servidor SCOPE a janela com as informa es do PDV possibilita a consulta de outros PDV s pelo campo Emp Filial Pdv Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 231 PDY Empresa 0001 Filial 0001 Pdy 002 Emp Filial Pdv 0001 0001 002 Pdv ltima conex o ocorrida em 132 04 10 13 11 40 192 168 125 238 ltima desconex o ocorrida em Vers o Logons Mais recente ocorrido em Scope PlI 2 27 02 01 eokeiados 13 04 10 1311 40 Protocolo Pog Respondidos 13 0410 13 11 40 Transa es Mensagens ISO Solicitadas ltima trafegada em 13 04 10 13 11 40 Respondidas C d Mensagem Aprovadas C d Processamento Reprovadas Confirmadas pelo PDY Enviadas Recebidas Desfeitas pelo PDV Totais 0 0 PDY ON 5 PDY s 1 operacional sendo 1 conectado Situa o em 13 0440 13 11 41 Figura 12 informa es adicionais do PDV IMPORTANTE na consulta da vers o do
141. VEX bandeira GIVEX atualiza o das sess es Estados para interrup o e Coleta de dados e Atualiza o da Sess o PINPAD com informa o da 1 43 03 01 2013 Edison Ogata limita o de d gitos de coleta do pinpad e Atualiza o da Recarga de celular com informa es de parametriza o de coleta 1 44 04 01 2013 Facti Felipe M Schaden e Inclus o da bandeira Sodexo Refeicao 1 45 05 03 2013 Edison Ogata e Inclus o da bandeira ABRAPETITE 1 46 08 03 2013 Edison Ogata e Acr scimo da se o ArqControlPath no scope ini Facti Henrique de O 1 47 13 03 2013 Buzachero e Inclus o da rede e bandeira TOPCARD 1 48 18 04 2013 Edison Ogata e Inclus o do par metro MascararDados Facti Henrique de O 1 49 07 05 2013 B ach ro e Inclus o da rede VR e bandeiras da VR e Inclus o da rede e bandeira INCOMM reutilizando o 1 50 25 06 2013 Facti Camila M Dutra c digo de rede e bandeira BANKBOSTON e Inclus o de Ap ndice sobre o formato do c digo de barras da INCOMM tratado pela automa o comercial e Inclus o da descri o de novas funcionalidades de 1 51 01 07 2013 Facti Felipe M Schaden Atualiza o de Pre os e Fornecimento de Lista de Mercadorias para a Ticket Car Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 5 OKI 1 52 01 07 2013 Regina M N Sato e Inclus o da m scara da fun o ScopeObtemCampoExt2 para obten o do Maximo de Mercadorias permit
142. XPORT ScopeTransacaoPo0OS char Valor WORD Rede WORD Bandeira WORD Servico Par metros Valor da transa o com a v rgula impl cita String com o exemplo R 123 00 12300 Passar in m ximo de 12 Valor string vazia para o SCOPE solicitar N o d gitos pode ser nulo nem string apenas com zeros N mero positivo que representa c digo da in WORD Rede rede autorizadora segundo o SCOPE Passar zero para o SCOPE solicitar N mero positivo que representa c digo da in WORD Bandeira bandeira segundo o SCOPE Passar zero para o SCOPE solicitar N mero positivo que representa c digo do in WORD Servico servi o segundo o SCOPE Passar zero para o SCOPE solicitar Retorno Ver tabela de c digo de retorno no SCOPE Poss veis Retornos de Erros Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 133 OKI C digos Retorno Hexadeci Decimal Significado mal OxFBO1 64257 N o foi poss vel criar a thread na coleta de dados OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFEOO 65024 A transa o em andamento a aplica o deve aguardar Exemplo retorno ScopeTransacaoP0OS 0 0 0 processa a transa o Estados de coleta A tabela abaixo mostra os estados de coleta que o fluxo poder retornar no modo coleta A maioria dos estados n o
143. a 1 byte Quantidade de Fun es retornadas que indica a quantidade de repeti es dos registros abaixo 29 bytes por fun o 1 byte Identifica a fun o C Cr dito D D bito H Cheque A CDC S Saque 14 Valor efetivado 2 casas decimais Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 128 OKI bytes 14 bytes Valor cancelado 2 casas decimais Layout Vers o 3 Tamanho Descri o 3 bytes Identifica o do buffer R03 3 bytes Quantidade de bandeiras retornadas que indica a quantidade de repeti es dos registros abaixo 1 byte Identifica a fun o C Cr dito D D bito H Cheque A CDC 3 bytes C digo da bandeira 17 bytes Descri o da bandeira 14 bytes Valor efetivado 2 casas decimais 14 bytes Valor cancelado 2 casas decimais Prot tipo LONG ScopeObtemDadosTotalTEF BYTE Nivel char Buffer WORD TamBuffer Par metros Indica a que n vel dever ser in BYTE Nivel inicializado os totais de TEF 0 PDV 1 Operador out char Buffer Retorna os dados de totais TEF im woro TamButer P a Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFEOO 65024 A transa o em andament
144. a ISO Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 68 AVS OKI Exemplo char valor 12 1 obt m o valor do chequ armazena em valor abre sess o retorno ScopeConsultaCheque valor processa a transa o fecha a sess o Termo em ingl s Address Verification Service tamb m conhecido por outras autorizadoras como VAS Verifica o Autom tica de Endere o um servi o de verifica o de endere o do portador do cart o utilizado para comparar o endere o que o cliente forneceu com o que est cadastrado junto com a administradora de cart o O AVS uma transa o n o financeira e n o atrelada a nenhuma transa o de venda isto a consulta n o garante que a pessoa que esteja realizando a transa o seja realmente o portador do cart o J CUIDADO Este tipo de informa o recebida pela consulta AVS tem o intuito apenas de oferecer suporte para a decis o do estabelecimento comercial quanto realiza o ou n o da venda Consulta AVS A fun o ScopeConsultaAVS aciona o SCOPE Client para efetuar uma transa o de consulta AVS para confirmar os dados do endere o fornecido com o cadastrado na administradora Prot tipo LONG EXPORT ScopeConsultaAVS void Par metros N o h par metros Retorno Ver tabela de c digo de retorno Poss veis Retornos de Err
145. a aceitar Contactless Na inicializa o de tabelas do estabelecimento em quest o a Cielo precisa habilitar e enviar na carga AlDs com Contctless habilitado O valor da transa o precisa estar dentro da faixa permitida para Contactless dado que tamb m configurado atrav s da inicializa o de tabelas A carga no PINPad precisa estar atualizada com pelo menos um AID do grupo da transa o em quest o Cr dito ou D bito com Contactless habilitado Funcionamento A habilita o ou n o da leitora Contactless feita de forma autom tica conforme t picos descritos acima N o necess ria nehuma configura o no SCOPE Quando ocorre erro na leitura sem contato dependendo do tipo de erro ocorrido a pr xima tentativa pode desabilitar a leitura sem contato de forma a evitar que o PINPAd leia novamente por aproxima o quando na verdade o portador do cart o deveria inserir o chip ou passar a tarja A leitura sem contato tamb m desabilitada automaticamente pelo PINPad quando o valor da trasa o for acima do limite permitido para Contactless Existem dois tipos de cart o sem contato Chip EMV Sem Contato e Tarja Sem Contato Transa es de Tarja Sem Contato s o equivalentes a uma transa o Magn tica Transa es de Chip EMV Sem Contato s o equivalentes a uma transa o de Chip EMV Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 190 OKI
146. a coleta do servi o ser feita pelo in WORD Li procedimento usual ver C digos dos Servi os Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64002 Par metro 2 inv lido OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFEOS 65029 API ainda n o fez nenhuma transa o ap s a inicializa o A aplica o est tentando obter um handle sem ter feito nenhuma transa o desde ltima conex o com o ScopeSRV OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server 0xFE08 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 158 OKI OxFFiD 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFF3A 65338 Erro interno na execu o
147. a de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0xFE01 65025 SCOPE API n o foi inicializada corretamente OxFEOO 65024 A transa o em andamento a aplica o deve aguardar Exemplo Conecta ao servidor do SCOPI Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 E 27 32 OKI Realiza a venda retorno ScopeAbreSessaoTEF if retorno 0 Trata o erro interrompe a sequ ncia else Inicia a s transa o s desejada s Encerrando a sess o Aciona o SCOPE para finalizar uma sess o de TEF ciclo com uma ou mais transa es de TEF ou seja confirmar ou desfazer as transa es da sess o em aberto ap s encerrar o processamento da transa o Prot tipo LONG EXPORT ScopeFechaSessaoTEF BYTE Acao BYTE DesfezTEFAposQueda Par metros Byte Informa o SCOPE para confirmar ou in O Desfaz Acao desfazer a s transa o s da sess o de 1 Confirma TEF atual Ponteiro p ra Retorna se a s transa o s da sess o out p DesfezTEFAposQueda de TEF foram desfeitas ap s uma queda byte de energia Retorno Caso retorne sucesso 0x0000 significa que o SCOPE conseguiu com xito confirmar ou desfazer a s transa o s de uma sess o de TEF Caso contr rio ocorreu algum problema na confirma o ou d
148. a num certo per odo e que pode ser enviado para a impressora ou para outro meio de armazenamento Estas informa es podem ser levantadas por PDV ou por operador No entanto mesmo que a aplica o se interesse pelas informa es relativas apenas por uma das op es PDV ou operador o SCOPE atualizar ambos Portanto n o haver otimiza o ao escolher apenas um dos dois No caso do PDV o per odo escolhido para a totaliza o dos valores pode ser di rio semanal mensal etc mas recomenda se que abranja o per odo do movimento isto ao iniciar o per odo num dia seja zerado o totalizador e no final do dia o relat rio seja obtido Quanto ao relat rio por operador aconselha se que seja zerado o totalizador na entrada do operador ao caixa e obtenha se o relat rio na sa da do mesmo IMPORTANTE o SCOPE n o controla identifica qual operador est operando o PDV A papel da aplica o o controle da entrada e sa da de cada operador e consequentemente iniciar o totalizador e obter o relat rio no momento correto Iniciando os totais No in cio do per odo de totaliza o a aplica o dever chamar a fun o ScopelniciaTotalTEF passando no par metro o c digo referente ao totalizador que se deseja zerar conforme abaixo e valor O ser zerados ambos os totalizadores o do PDV e o do operador e valor 1 ser zerado apenas o do operador Prot tipo L
149. a o limite do cart o de acordo com o valor informado como forma de reserva e garantia ao Com rcio Usu rio que no momento de receber efetivamente o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 225 OKI pagamento da despesa Atualmente somente hot is e locadoras s o autorizados para utiliza o da Pr Autoriza o e Consulta CDC Consulta direta ao banco emissor possibilita o acesso a taxas aplicadas no momento da inten o de compra e AVS Transa o utilizada para verifica o do endere o de envio da fatura do portador do cart o Estes dados s o informados pelo mesmo em uma compra feita atrav s de cart o n o presente e Pagamento de Fatura cart es Private Label Certifica o Uma vez que a aplica o de PDV cumpra as adequa es mencionadas anteriormente ela deve ser certificada pela Visanet A certifica o deve ser agendada com a Itautec S A atrav s do e mail apoioscopeOitautec com e consiste em e Pr homologa o realizada pela Itautec e Homologa o realizada pela Visanet ou por empresa designada por ela Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 226 OKI Ap ndice C PIN Pad Compartilhado Fo A IMPORTANTE Este t pico deve ser considerado apenas pela automa o que utiliza a interface coleta do SCOPE Abaixo segue alguns aspectos para integra o com SCOPE na interface coleta O
150. a para Pagamento Eletr nico 2 27 22 OKI AAAA gt Nome da automa o CCCC 5 C digo do memorando XXX o padr o 01HOTK0000 Configura se deve habilitar a Comunica o no N o habilitar Segura com o PIN Pad s Habilitar Configura se o Scope deve consistir o valor do no N o habilitar saque digitado com os valores configurados nos ScopeValidaSaque limites de saque do produto localizados no Habilitar Eis pa pe Nenhum cart o Todos os cart es ser o Todos os cart es ser o Todos os cart es ser o mascarados com asteriscos Todos os cart es que Indica como o valor do PAN deve ser enviado MascararDados seguem o padr o PCI DSS para a aplica o ser o mascarados com zeros Todos os cart es que seguem o padr o PCI DSS ser o mascarados com zeros Todos os cart es que seguem o padr o PCI DSS ser o mascarados com asteriscos Valor num rio de 1 99 que representa o tempo em segundos Se n o tiver configurado ou o valor estiver Define um tempo m ximo em segundo inv lido ser assumido o GenTimeout para o SCOPE Client gerar as chaves de valor padr o de 99 criptografia utilizado na conex o segundos Neste caso ser praticamente imposs vel alcan ar esse tempo e a chave ideal ser gerada sempre Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 23 OKI As chaves m nimas exigidas s o as duas primeiras Name e Port enquanto
151. a rede adquirente no formato VVV VV AAMMDD 034 040 A7 Informa es propriet rias da rede adquirente 041 042 A2 Tamanho em bytes dos dados a seguir 00 a yy Dados bin rios de identifica o do SAM caso existente no layout 043 2 Hxx Byy o exigido pela rede adquirente Dados do dispositivo O formato das informa es do PIN Pad padr o e segue o formato abaixo Posi o Formato Descri o 001 020 A20 Nome do fabricante do PIN Pad Modelo vers o do hardware no formato xxx xxx mmm onde xxxx 021 040 A20 o Nome do equipamento e nmm a capacidade de mem ria 512KB 1MB 2MB 041 060 A20 Vers o do firmware formato livre 061 064 A4 Vers o da especifica o no formato V VV neste caso fixo em 1 05 EN kig Vers o da aplica o b sica no formato VVV VV AAMMDD com 3 espa os direita 081 100 A20 N mero de s rie do PIN Pad com espa os direita Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 110 OKI A fun o ScopePPGetlnfo retorna as informa es sobre o PIN Pad e suas aplica es como Obtendo as informa es descrito acima Caso alguma informa o n o exista ou n o se aplique para o modelo de PIN Pad ela dever ser fornecida em branco espa os Para decidir qual informa o a aplica o quer obter o primeiro par metro deve receber o valor correspondente e valor O
152. aa 51 PSOE DRE SD RD A SRT A E 53 Cart o de Gredito PAM RRRO RNP RR PAR RR UR RR aa atan 53 Compra com cart o de Cr dito seinsta aaisan aeea onii aaia aain aiad aaia adin 53 Consulta a financiamento de cart o de cr dito rea arernarea aaa nana 55 Consulta a saldo de cart o de cr dito ir eraecare arara aaaaa na eranar aa aaaa na naaaananeaaa 56 Pr autoriza o de Cr dito isnie iiaiai aaia aa ea aaa aaaea aa aae aai aaa aE Taa 57 Cart o de d bDitO snsiseiseneriniineini rinadi arnoia qa nado d a URU La Da da aii ad adia Ud Va ES Aa diga da 59 Compra com cart o de d bito rara arara nanaaaera near ra nana ana eaaaa aa aaaa anna acena 59 Compra CDC Cr dito Direto ao Consumidor atra aarae arara aaa naaananaaa 61 Consulta CDG reagens irinen ea aa e aja Ding u Eta na gia diaaa adia aeaa data dead 61 Simula o Credi rio rara diaaa ainidi a nana aa nana anar aaa arena nana 62 Consulta a saldo de cart o de d bito e reecarr arara aaaaaa na enaaar aa aaaa renan nanaaaa 64 Cart o Dinheiro a csscssasavassaacaserosasreesavasanesarorooe canadiana sina socos aiai aaa eaaa aaia 65 Opera es E AE SO he li tidas U Doda gaba A A T 65 Compra Carga do cart o dinheiro erre rarranaaacareaaaar ra aaaa ana eaaar aa aaar nana aaananaaaa 65 Compra usando o cart o dinheiro d bito aerea arena near nana 66 Consulta ao saldo de cart o dinheiro
153. aa cuncoiiadta aaa 175 E poss vel fazer um teste usuando o HotKey rara aree narra aaa naarnanaaa 176 A Automa o Comercial deve se adequar ret acaraaaaaraananaaaaeaa near aaaaaaaannaans 176 O que a Automa o Comercial precisa fazer para estar aderente essere 176 Como saber se houve um pr mio n o monet rio brinde recebido durante uma compra 177 Como fazer um Resgate de Pr mio 2 carta ararrananaaaanea near aa nana a nana aa area narra aaaaannaaans 178 Existe uma forma de tratar os itens do Menu Din mico pela aplica o de AO sssini 180 Existe um c digo exemplo maasicsascsmadrssfesisao ensaiar efutaa ia na nda n Dea dade iiaa aia aiaiai 180 Qual a vers o m nima do SCOPE que contempla Cielo Premia 180 Cielo AULOsts suas a ER E dia je nda aan can Dada a er ie TA 180 Lista de produtos e ou servi os principais Cielo Auto errar 181 Lista de produtos e ou servi os secundarios Cielo Auto errar 181 Informa es Adicionais Cielo Auto rara areeaaaraa aaa aa aa aaa area near aa aaaa renan canas 184 DAVIS E E E Gana indndaia o LS Gata E Edna aa EDaLcASeSGu aa nei JaSLaaas ER 184 Associa o dos produtos e as fun es do SCOPE eres 184 Autoriza o de Vouchers e Servi os its rereaareaaaraa near aaaaaeaaanea aeee aaa aanneaans 185 Estorno de Autoriza o de Vouchers e S
154. abec 0 sizeof Cabec memset CpCliente 0 sizeof CpCliente memset CpLoja 0 sizeof CpLoja memset CpReduzido 0 sizeof CpReduzido retorno ScopeGetCupomEx sizeof Cabec Cabec sizeof CpCliente CpCliente sizeof CpLoja CpLoja sizeof CpReduzido CpReduzido amp NroLnhReduzido if RC RCS SUCESSO ImprimeCupomTEF CABECALHO Cabec ImprimeCupomTEF CUPOM DO CLIENTE CpCliente ImprimeCupomTEF CUPOM DA LOJA CpLoja if NroLnhReduzido gt 0 ImprimeCupomTEF CUPOM REDUZIDO CpReduzido break Reimpress o de comprovante Conforme necessidade o operador pode solicitar uma nova c pia do comprovante da ltima transa o realizada ou alguma espec fica anterior a ltima desde que tenha sido aprovada e se encontre no SCOPE S o duas as modalidades de reimpress o on line e off line Essa necessidade pode ter sido ocasionada por algum problema com a impress o original cupom ileg vel papel enroscado na impressora etc As duas modalidades de reimpress o do comprovante uma transa o e como tal dever ser tratada numa sess o de TEF preferencialmente sendo a nica da sess o Solicitando o comprovante off line Para toda e qualquer rede o SCOPE permite reimprimir apenas o ltimo comprovante realizado num PDV poss vel reimprimir cupons antigos exceto o reduzido desde que estes estejam na base de dados do SC
155. abela de c digo de retorno Estados de coleta A tabela abaixo mostra os estados de coleta que o fluxo poder retornar no modo coleta C digos Retorno Hexadeci Decimal Significado mal OxFCO2 64514 Imprime Cupom OxFC2E 64558 Coleta valor da recarga de celular pr pago OxFC2F 64559 Coleta c digo da localidade do telefone OxFC30 64560 Coleta n mero do telefone OxFC70 64624 Coleta a operadora de recarga de celular pr pago OxFC90 64656 Coletao DDD no PINPad OxFCB5 64693 Coleta redigita o do DDD OxFCBC 64700 Coleta DDD Telefone no PIN Pad OxFCBD 64701 Redigita DDD Telefone no PIN Pad Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server 0xFE08 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSr
156. ada se h transa es na sess o de TEF atual Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 160 OKI OxFF36 65334 Erro no envio da confirma o ou desfazimento da transa o anterior OxFF3A 65338 Erro interno na execu o da coleta OxFF5E 65374 Erro ao desmontar a estrutura ISO OxFF60 65376 Fun o indispon vel OxFFFF 65535 Erro gen rico ScopePagamento Utilizada para pagamento de conta t tulo ou conv nio ou fatura atrav s de uma rede autorizadora ou por interm dio de correspondente banc rio Os servi os atuais dispon veis s o pagamento de conta com cart o pagamento de conta sem cart o e pagamento de fatura O pagamento de conta com cart o usado quando a rede exige uma determinada bandeira Electron Cheque Eletr nico sendo que neste caso o SCOPE valide o BIN do cart o Pagamento de conta sem cart o quando o pagamento pode ser realizado atrav s de dinheiro cheque ou TEF externa outra transa o realizada separadamente Pagamento de fatura usado para o recebimento pr prio de fatura de cart o de cr dito Neste caso o c digo de barras n o obrigat rio j que o pagamento pode ser atrav s do n mero do cart o digitado ou lido Prot tipo LONG EXPORT ScopePagamento WORD CodServico WORD CodBandeira Par metros C digo do servi o do grupo Pagamento
157. agamento Eletr nico 2 27 218 OKI C digos Bandeira Hexadeci Decimal Significado mal 0x00FC 252 Elavon 0x00FD 258 VR ALIMENTACAO 0x00FE 254 VR AUTO 0x00FF 255 VR CULTURA 0x0100 256 VR REFEICAO 0x0101 257 MULTIBENEFICIO 0x0102 258 MULTIALIMENTACAO BEN 0x0103 259 MULTICESTABASICA 0x0104 260 CARTAO MAMAE 0x0105 261 MULTICASH 0x0106 262 CARTAO BRINQUEDO 0x0107 263 CARTAO NATAL 0x0108 264 MULTICHEQUE BEN 0x0109 265 MULTIEMPRESARIAL 0x010A 266 MULTICOMBUSTIVEL 0x010B 267 MULTICULTURA 0x010C 268 MULTIFARMA 0x010D 269 MULTIREFEICAO 0x0112 274 FORTBRASIL 0x0116 278 ELO AUTO 0x0125 293 BAHAMAS CR DITO 0x0126 294 BAHAMAS ALIMENTA O Dados dispon veis das transa es Abaixo est a rela o dos campos dispon veis que podem ser obtidos das transa es pelas fun es ScopeObtemCampoExi e ScopeObtemCampoExt2 CAMPO DE DADOS VALOR DO BIT PAN Personal Account Number n mero do cart o 0x00000001 Valor da transa o 0x00000002 NSU N mero Sequencial nico da transa o 0x00000004 Hora local da transa o 0x00000008 Data local da transa o 0x00000010 Data de validade do cart o 0x00000020 Data cont bil da transa o 0x00000040 N mero do cheque 0x00000080 C digo de autoriza o 0x00000100 C digo de resposta 0x00000200 Identifica o do terminal 0x00
158. al Significado mal OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente Exemplo Abre sess o retorno ScopeCompraCartaoCredito valor taxa servico if retorno 0 do retorno ScopeStatus trata conforme retorno if retorno 64024 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 36 OKI sleep 1000 continue else if retorno lt 0xFC00 retorno gt 0xFCFF processando 0 saiu da faixa de coleta trata a coleta de algum dado while processando 1 fim do if else Trata erro retornado na solicita o da transa o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 37 OKI Fun es de configura o de ambiente O SCOPE Client carrega diversos par metros de configura o para seu funcionamento no ambiente de PDV em que est executando Estes dados s o carregados na conex o com o ScopeSRY e na leitura do arquivo scope ini Al m destas duas fontes de configura o h tamb m aquela que a aplica o pode fazer por meio de algumas fun es dispon veis nas bibliotecas do SCOPE Client Dependendo do tipo de configura o a que nos referimos ela permite a aplica o ativar ou desativar as configura es durante a execu o do programa Configura es gerais No momento
159. alocada para a estrutura do PIN Pad compartilhado 0x00CB 203 Erro alocando mem ria 0x00CC 204 Mem ria insuficiente para receber os dados 0x00CD 205 PIN Pad j aberto via SCOPE 0x00CE 206 N o foi poss vel definir a Master Key a ser utilizada 0x00CF 207 N o foi poss vel definir o Estado de coleta no PIN Pad 0x00DO 208 Erro no par metro da fun o GetPIN 0x00D1 209 PIN Pad n o configurado 0x00D2 210 Display n o permitido neste momento ou situa o 0x00D3 211 PIN Pad n o foi aberto pela aplica o 0x00D4 212 Time out do cliente usu rio 0x00D5 213 Dado no chip n o encontrado 0x00D6 214 Comanda Vazia 0X00D7 215 Comanda Inv lida C digos de Retorno de Pr TEF Os c digos abaixo podem ser retornados pelo ScopeSRV ao ScopeAPI quando ocorre erro em uma Pr TEF Embora sejam erros internos ao SCOPE podem ser teis para identificar e ajudar na an lise de logs para identifica o de problemas Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 C digo de Retorno Descri o Decimal 00 Sucesso 01 Rede Offline 02 Erro na consulta ao BD 03 Timeout na consulta ao BD 04 BD n o conectado 05 Transa o n o localizada no BD 06 BIN ou Servi o n o configurado 07 PDV j logado 08 PDV n o cadastrado 09 Taxade servi o inv lida S 202 OKI
160. amentos out BYTE Retorna o tipo de conv nio O Pagamento vista TipoConvenio 1 Pagamento a prazo 2 Empresa Fechada 3 Empresa Aberta Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 100 OKI Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE04 65028 N o existe transa o suspensa OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server 0xFE08 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Layouts ID layout Usar estrutura 1 stREGISTRO MEDICAMENTO 2 sStREGISTRO MEDICAMENTO CRM 3 stREGISTRO MEDICAMENTO L3 4 sStREGISTRO PHARMASYSTEM RET
161. anaa iaaa daadaa daa 211 C digo de especifica o das redes ice arara nanaaaaera aaa nana aaa aa anna aaanasaanaarananaa 214 C digo das bandeiras iiszels cito cisapaealoa onna L lavi pal cpquala den nv ba da aaa a ia aaaea dan a pad daadaa adai 214 Dados dispon veis das transa es iara aaaraacaneaaaraa aaa aa aaaa anna aaar aa aaar ana sennen 219 Grupo de Servi Os isnin ii ia Aaa bla nda a aaaea iaai bind puta ad sau dadas 221 C digos Jos Servi Os assii inienn ieii aa i oaa ia dos fon bitea Lou a asdf daadaa AES 221 CONV NIOS ncasisiarisnurnnniii aieiai ia aiaa AT A a Ea a aa iaaa a aaa EA 223 Ap ndice B Especifica o Visanet 4 1 uassssuneesenunneennunnnnnnnnnnnnnnnnnnnnnnnnn mnnn nnmnnn nna 225 Vae ce N1 e OEI E E AE T A E T A E EE E A A E E sis anne dead 225 Certifica o atanena aa duda dai cd diin are ia aea aada aa ae iaa eaa AU ud pad cap AEN aaa 226 Ap ndice C PIN Pad Compartilhado ssssssansennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nnmnnn nna 227 Ap ndice D Conjunto de bibliotecas do SCOPE Client sssnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 229 MS WINDOWS meer onien e E E E 229 Linguagem Java sasssa annaa AES AAEN AAA nad SENTA pac laga a CEL Sand ln io apadtLa nas 229 E q LU E E E E ARPOADOR ROD RD RR 230 Linguagem Java sapsssaagaassnaofasiilado puiaia casca SAES anda lan f anna lala o aSl Uno galo aadLa lan ass lato adotar 230 Ap ndice E Identificando a ve
162. ando o tipo de terminal numero de 1 a 5 e o restante da string representando a data de movimento no formato MMDD como demonstrado a seguir Campo Formato Descri o Tipos de Terminal que podem ser configurados 1 Frente de loja default 2 Magazine Tipoterminal i 3 Batimento retaguarda 4 Posto de gasolina 5 WEB Data de Movimento n4 Data de Movimento no formato MMDD e SCOPE DADO DATA MOVIMENTO ID 12 n o mais suportado e SCOPE DADO NSU CUPOM FISCAL ID 13 n o mais suportado Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 151 OKI e SCOPE DADOS AUTOMACAO ID 14 buffer onde os 21 primeiros bytes representam uma string com o fabricante do software de automa o e outros 21 bytes com a vers o do software da automa o e SCOPE DADOS COD AUT MEDICAMENTOS ID 15 string com 13 bytes que cont m o c digo de autoriza o da PBM e SCOPE DADOS LISTA MEDICAMENTOS ID 16 buffer com a lista de medicamentos da PBM e SCOPE AUTOMACAO PERMITE SALDO VOUCHER ID 17 Atrav s deste campo a automa o informa ao Scope se permite que o pagamento efetuado atrav s de voucher utilize o valor dispon vel no saldo neste caso deve informar S ou aceita somente pagamento para os casos em que o saldo do voucher seja igual ou superior ao valor da transa o neste caso deve informar N Observe que este campo deve ser informado somente na abertura de c
163. ao na 85 1 A preencher com a NA NA NA NA letra O EO 86 4 N Formato 0000 NA 0x08000000 NA NA mpresa C digo Filial 90 4 N Formato 0000 NA NA NA NA Quantidade de parcelas Se venda N mero de Qtd Parcelas 94 2 N for vista 0x00001000 NA NA parcelas preencher 00 P POS I Internet M E y A Forma Captura 96 1 A Manual T TEF ou NA NA 0x00000080 NA O Outros Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 142 OKI C digo 97 3 Bandeira N C digo da Bandeira 0x00040000 NA NA Bandeira C digo Rede 100 3 N C digo da Rede 0x00400000 NA NA Rede C digo Servi o 103 5 N C digo do Servi o 0x00080000 NA NA Venda RESERVADO 108 89 A RESERVADO NA NA NA NA NA n o se aplica Para ilustrar o mapeamento considera se o c digo da empresa e o c digo da filial do PDV sendo 0001 e 0001 respectivamente e o cupom de exemplo Ap s a transa o POS do SCOPE Client e a formata o da automa o comercial o cupom dever resultar no registro com exibido nessa tabela CUPOM FUN O ScopeObtemCampoExt2 ARQUIVO CAMPO M SCARA 1 M SCARA 2 M SCARA 3 RETORNO REGISTRO E E E vn 0x00000800 0x00000000 0x00000000 000000000000000 000000000000000 121212 0x0
164. ar metro retornado pelo lin LONG TipoParam ScopeStatus deseja se obter isto os par metros para uma coleta de dados e ou exibi o de uma mensagem out ptPARAM COLETA lpParam Conjunto de dados para a coleta detalhado acima Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Significado Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 44 OKI Hexadeci Decimal mal OxFAO1 64001 Par metro 1 inv lido OxFEO1 65025 SCOPE API n o foi inicializada corretamente Exemplo executa transa o cr dito d bito etc StPARAM COLETA Pcoleta inicia itera o retorno ScopeStatus if retorno 0xFE0O0 memset amp PColeta 0 sizeof PColeta retorno ScopeGetParam retorno amp PColeta atualiza as teclas retornar avan ar e cancelar coleta os dados entrega o que coletou ao SCOPE finaliza itera o Passando o dado da coleta ao SCOPE Client Realizando a coleta de dados solicitada pelo SCOPE via fun o ScopeStatus a aplica o devolver o que foi coletado e alguma a o ao SCOPE A a o se refere interrup o do processamento retorno para um estado anterior ou continua o para o pr ximo estado de coleta Os dados coletados s o entregues ao SCOPE por meio da fun o ScopeResumeParam
165. ardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server 0xFE08 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere H como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Exemplo BYTE TipoConvenio CodigoRede coleta o tipo do conv nio o c digo da rede ElegibilidadeCartao TipoConvenio CodigoRede processa a transa o OKI Pre Autorizacao de Medicamentos PBM Para informar cada produto que ser inclu do na compra obtendo informa es do mesmo deve ser chama a fun o ScopePreAutorizacaoMedicamento A fun o pode retornar no fluxo de coleta o c digo de coleta 64579 para fornecer a lista de medicamentos e o c digo de coleta 64580 para obter a lista de medicamentos Essa fun o suporta a bandeira PharmaSystem P
166. asta Pe dda dada cade sa o aada dE espa suba dda nda idas ua Te cassados 84 COMproVANIos nasais paiizadpreria da asda E anaa iNNi Dainai 86 Comprovantes de transa es erre naeeaaaraaaaaraa nana area nana na Ennn ana aaaae ra aaaa anna nanaa 86 Obtendo os cupons de TEF ssasmsagasicosspssensdadpasto passo cepuinda saga ndo canta dp as do a paaaLaGa EA GUS Anda nada spa da asa nana Saad 86 Reimpress o de comprovante iaa nE aaa EAA aA ANANA eaaa AAAA 88 Solicitando o comprovante off line rara nant natt nn ttnn nnna ttnn annuae nunnan nnen nanaananaaaa 88 Solicitando o comprovante on line errar nant Eann EnEn En aa EASE Ennn nn annn nnen nenun nnne nn nann 89 Imprimindo o comprovante correto area aeareraaaaaren aa naarea aa aaaren aa naaren na naane nana 91 PBM MeEdICamenToS asian rare nnn nnnnnnnnnnnn nnmnnn nnmnnn 94 Consultando medicamento s inon aaaea ianea aaa Aaa Kaai aaaea an a EA aA Eaa AKTARAN 94 Compra d medicamento senseri anniren ea eaaa aa aaaea aa aaaea aan ENA Enlace est E R iana SEa 95 Lista de medicamentos asnes rniii an inaa aaa AAEN AE AEKA AAAA SAA ARENA AKEN AAAA EAKAS 97 Lista de medicamentos com GRM sssiisiersisanonainans aaaea aaa aaaea aaa Aaaa aaa AA aiei 98 Lista de medicamentos Extendida nna Kaa ARa EENAA AAAS RREA NENES ANAA ARANA EARANN 100 Lista de Prootoni na rannin aa AENA AR EAEE NRE 101 Elegibilidade do Cart o PBM iss iasssaaascpa
167. az es de otimiza o de tr fego o SCOPE Client envia estes dados para o servidor na solicita o da segunda pr TEF Portanto a aplica o deve fornecer este buffer antes da realiza o da mesma IMPORTANTE na interface HLAPI a aplica o deve mandar suspender em um dos estados de coleta que antecedem a segunda pr TEF Atrelando dados transa o Passar algum dado ao SCOPE com a fun o ScopeForneceCampo exige que ela seja chamada antes do envio da segunda pr TEF Prot tipo LONG EXPORT ScopeForneceCampo char TypeField void StructField Par metros in char TypeField Tipo de dado in void StructField Ponteiro para os dados Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 153 OKI C digos Retorno Hexadeci Decimal Significado mal OxFBO1 64257 N o foi poss vel criar a thread na coleta de dados OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFEOS 65029 API ainda n o fez nenhuma transa o ap s a inicializa o A aplica o est tentando obter um handle sem ter feito nenhuma transa o desde ltima conex o com o ScopeSRV OxFEOD 65037 N o h arquivo com dados da transa o anterior salvo OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF Exemplo
168. bandeiras sem configura o de servi o ser o associados todos os servi os previstos Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 26 OKI Configura o do registro do MS Windows No sistema operacional MS WindowsO poss vel configurar o SCOPE Client utilizando o registro do sistema operacional Abrindo o editor de registro as configura es do SCOPE devem estar em HKEY LOCAL MACHINEISOFTWAREIScope C RealVNC C Registered pplications q Scope 3 SCOPEADM 3 SCOPEAPI 3 SCOPEAUT SCOPEGW SCOPEIBD C Banco de Dados 0 Conexoes O Conexao0 E Conexao 19 Dados log SCOPESRV Figura 3 rvore do SCOPE no registro do MS Windows Em sistemas operacionais MS Windows de 64 bits x64 o SCOPE instalado sobre o subsistema Wow64 para funcionar corretamente No WoW64 as configura es do SCOPE s o armazenadas em HKEY LOCAL MACHINE SOFTWARE Wow6432Node Scope E Wow6432Node Classes H a Clients E InstallShield H a Itautec S A Ed Microsoft EE ODBC Ed ORACLE E Policies do RegisteredApplications H Scope SCOPEADM SCOPEAPI SCOPEAUT SCOPEGW E SCOPEIBD SCOPESRV Figura 4 rvore do SCOPE no registro do Wow648 Para maiores informa es sobre o Wow64 consulte a sess o Instala o do SCOPE em Sistemas Operacionais Microsoft Windows de 64 Bits no documento Scope Manual de Instala o e Configura o Relacionado na tabela abaixo e
169. canso s nnana 145 Dados da iransa o srona an nia ENAA EEEREN A sun dan rabs our estadantassscantars 145 Obtendo handle sssisicnaeiiine iie eieina naa a aaa ania aa eaaa aN aaa AaRON 145 Obtendo 05S Campos miersii eniin an aaa aaaea aa eea a aeaa a aaa anaa ia a aaRS AA lados 146 Fornecendo informa es extras para a transa o rara aeee near a aaara nana 150 Descri o dos lipos de dados sasasestassanargass Caeigas faces dalgasafas naan AA TAAKAN AAAA ERRAR 150 Atributos daraplica o ss aani AA ANAE NDEAN 152 Atrelando dados transa o siistiin aaeain eaaa anaa aa aiaa a aa aaa aa aat aaa 153 ScopeGetLastMS ge siseaeiniain naaa aa aa aE aaa eaaa aaa E aa Eaa aaa ta aaa 155 ScopeGetOheq enssins aaa a aaaea aaa aaa aa na Ea Sha a aaa aa eaaa aaa 156 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 10 ocopeAlualizaM alOr nespre dui enp aeaaee pienk eaea dial dana Dis atenda aE aa ganas EEEa EDS pasa AEAEE 156 ScopeGarantiaDescontoCheque ir untk Annt EASE nanaaaaraa near aa ANSEES SEES SEES annann Ennn nn nenna 157 ScopeTransacaoFinanceira sesssessssssueosnnounosnnesnnoruuoonueonnornnsrsnersnersnertsetsstsssrssstssstesstesstessttnstnnstenstenet 157 Scopelnvestimento seseina rraian paapaa ka R aa aaa eaii ass dada EP naa Eana Aaaa KAE RNE A EEE 158 ScopeObtemCartaolnvestimento iara aaarnananaaaaeea nana renan ESAE EASE Ennn Ennn na annann neat 159
170. cita a senha e Solicita a retirada do cart o do pinpad Prot tipo LONG EXPORT ScopeAtualizaParametrosChip char UsoFuturol char UsoFuturo2 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 163 OKI Par metros in char UsoFuturol Reservado para uso futuro Usar como par metro uma string vazia in char UsoFuturo Reservado para uso futuro Usar como par metro uma string vazia Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFBO1 64257 N o foi poss vel criar a thread na coleta de dados OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFEO5 65029 API ainda n o fez nenhuma transa o ap s a inicializa o A aplica o est tentando obter um handle sem ter feito nenhuma transa o desde ltima conex o com o ScopeSRV OxFE06 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispo
171. co 0x005D 093 Ticket Restaurante 0x005E 094 ValeCash 0x005F 095 BankCard 0x0060 096 MedCheque 0x0061 097 Premium cart o de cr dito do SONAE 0x0062 098 Vale G s 0x0063 099 Datasus PBM 0x0064 100 BankTec 0x0065 101 PoupCard 0x0066 102 ChequePre 0x0067 108 Banquet cart o voucher alimenta o 0x0068 104 Private Label da Redecard 0x0069 105 Cielo 0x006A 106 Rancho Conv nio PortalCard 0x006B 107 Rancho Alimenta o PortalCard 0x006C 108 PlanVale 0x006D 109 IBlCard 0x006E 110 IBI PL 0x006F 111 Pague Conta Visanet 0x0070 112 Cart o F cil EPA 0x0071 113 Cart o F cil Losango EPA 0x0072 114 CPF IBI PL deposito CDB 0x0073 115 ComproCard 0x0074 116 FarmaSeg PBM 0x0075 117 Unik Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 216 OKI C digos Bandeira Hexadeci Decimal Significado mal 0x0076 118 Verde Card 0x0077 119 Rossi 0x0078 120 Somar 0x0079 121 Solucard 0x007A 122 Banquet Smart 0x007B 123 VEGAS CARD SENHA 0x007C 124 Planvale Redecard 0x007D 125 Obo Card 0x007E 126 DaCasa 0x007F 127 CABAL Vale TECBAN e GETNET 6 0 0x0080 128 CABAL D bito TECBAN e GETNET 6 0 0x0081 129 BRTelecom Telefonia FIXA 0x0082 130 Brasil Telecom 0x0083 131 GoodVale GETNET 6 0 Voucher 0x0084 132 RedeSof
172. corresponde ao Fluxo 32 Transa o Auto Transa es s o suportadas apenas utilizando o chip do cart o A bandeira que ir tratar esta transa o ser e 278 CIELO AUTO As transa es dispon veis no SCOPE que podem ser realizadas com este cart o s o e D bito Voucher e Estorno Voucher e Consulta saldo Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 180 OKI e Atualiza o de par metros Chip Lista de produtos e ou servi os principais Cielo Auto Esta lista poder conter os seguintes ramos principais e COMBUST VEL e OUTROS PRODUTOS E SERVI OS e ESTACIONAMENTO Esta lista ser exibida de acordo com as informa es enviadas na Carga de Tabelas da CIELO e nas informa es habilitadas no chip do cart o O SCOPE disponibiliza os itens do Menu para a aplica o de automa o comercial para a melhor exibi o dessas informa es Esta lista fornecida durante o fluxo de coleta atrav s do estado abaixo TC COLETA RAMO PRINC CIELO AUTO OxFCD9 Coleta Ramo Principal Cielo Auto Num fluxo de Compra com Cartao de Debito recebendo o c digo de coleta 64729 TC COLETA RAMO PRINC CIELO AUTO a aplica o de PDV pode realizar o mesmo tratamento do estado TC EXIBE MENU que j existe hoje ou seja opcionalmente chamar a fun o ScopeMenuRecuperaltens do SCOPE para receber os itens do Menu a serem exibidos e em seguida chamar a ScopeMenuSelecio
173. da OxFCOC 64524 Coletar se a parcela ser vista OxFCOD 64525 Coletar quantidade de dias entre parcelas OxFCOE 64526 Coletar quantidade de parcelas OxFCOF 64527 Coletar o plano de financiamento OxFCiO 64528 Coletar o dia e o m s DDMM OxFC11 64529 Coletar a senha OxFC12 64530 Coletar o controle do SCOPE OxFC13 64531 Coletar a forma de pagamento OxFC14 64532 Coletar data do primeiro vencimento OxFC15 64533 Coletar valor de entrada OxFC16 64534 Coletar a forma de entrada OxFC17 64535 Coletar conta corrente OxFC18 64536 Coletar ltimos d gitos do cart o OxFC19 64537 Reimpress o de comprovante OxFCIA 64538 Coletar se deseja consultar parcelas OxFCIB 64539 Imprime consulta OxFC1C 64540 Coletar decis o de continuar OxFCID 64541 Coletar decide ltimo OxFCiE 64542 Coletar n mero de cheque CDC OxFCiF 64543 Coletar quantidade de dias OxFC20 64544 Coletar o n mero da pr autoriza o OxFC21 64545 Coletar dia do m s fechado OxFC22 64546 Imprime nota promiss ria Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 192 OKI C digos Retorno Hexa Decimal Significado decimal OxFC23 64547 Coletar CEP OxFC24 64548 Coletar n mero do endere o OxFC25 64549 Coletar parte num rica do complemento OxFC26 64550 Coletar plano de pagamento Fininvest OxFC27 64551 Coletar ciclos a pular Fininvest
174. da OxFF40 65344 Erro dados ainda n o dispon veis SAB OxFF41 65345 Erro dados indispon veis SAB OxFF42 65346 Servidor SAB off line OxFF43 65347 Erro de conex o entre SCOPE e SAB OxFF44 65348 Erro no NSU recebido OxFF45 65349 Erro no logon do PDV OxFF46 65350 Erro no processamento do chip OxFF47 65351 Operadora inv lida OxFF48 65352 Dados da recarga de celular n o encontrados OxFF49 65353 Transa o cancelada pelo cliente OxFF5O 65360 Transa o aprovada off line OxFF51 65361 Vers o do banco de dados incompat vel OxFF52 65362 Cancelamento fora do prazo permitido OxFF53 65363 Mensagem inv lida OxFF54 65364 PIN Pad n o foi aberto OxFF55 65365 PIN Pad j foi aberto a aplica o abriu o PIN Pad antes de conectar ao ScopeSRV mas n o deveria ter lo feito pois no ScopeCNF est configurado com uso exclusivo do SCOPE OxFF56 65366 Estado inv lido a aplica o est tentando obter os servi os dispon veis num estado de coleta inadequado OxFF57 65367 PIN Pad compartilhado n o est configurado mas a rede exige que seja compartilhado OxFF58 65368 PIN Pad compartilhado n o trabalha com a vers o 2000 da VISA OxFF59 65369 Fun o de uso exclusivo na interface coleta OxFF5A 65370 rea insuficiente para os atributos do servi o OxFF5B 65371 O SCOPE est
175. da caso necess rio 013 044 ans32 Registro ID504 Conforme descri o do formato 045 076 ans32 Registro ID504 Conforme descri o do formato Descri o do formato do registro ID504 Posi o Formato Descri o 001 008 n8 Data da atualiza o de pre o Formato AAAAMMDD 009 014 n6 Hora da atualiza o de pre o Formato HHMMSS 015 019 n5 C digo da mercadoria alinhado a direita e preenchidos com zeros esquerda caso necess rio 020 031 n12 Valor do pre o unit rio alinhado a direita e preenchidos com zeros esquerda caso necess rio 032 032 nt N mero de casas decimais para o valor unit rio da mercadoria Observa o Repetir este bloco tantas quantas forem as mercadorias que os pre os foram atualizados A consulta aos c digos das mercadorias est descrita posteriormente no tem C digo das Mercadorias Comprovantes Abaixo segue os comprovantes existentes para cada transa o Transa o Coletas Loja Cliente Reduzido Compra online D bito Voucher X X Estorno online X X Consulta saldo X Atualiza o de par metros Dados Chip Atualiza o de pre os C digo das Mercadorias A Ticket Edenred envia Inicializa o de Tabelas com as mercadorias e seus respectivos c digos poss vel consultar as mercadorias parametrizadas pela Ticket Edenred atrav s do ScopeCNF acessando o menu exibido
176. da coleta OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFF5E 65374 Erro ao desmontar a estrutura ISO OxFFFF 65535 Erro gen rico ScopeObtemCartaolInvestimento Aciona o SCOPE Client para obter o n mero do cart o a partir do CPF do cliente Viabiliza efetuar uma transa o de aplica o pelo n mero do CPF Prot tipo LONG EXPORT ScopeObtemCartaoInvestimento char CPF char Buf WORD TamBuf Par metros in String CPF CPF do cliente rea reservada pela aplica o para out Strin Buf receber o cart o ou lista de cart es O 9 layout dos dados foi definido pelo SAB o SCOPE n o critica nem altera este layout lin WORD TamBuf A aplica o deve informar ao SCOPE o tamanho da rea reservada Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE06 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado
177. da n o efetivo data de ativa o posterior atual 0x004B 75 Moeda inv lida cart o moedeiro 0x004C 76 Erro de alto n vel no cart o EMV que pass vel de fallback para tarja magn tica 0x0050 80 Mais de um cart o sem contato foi apresentado ao leitor este c digo de retorno opcional e depende da capacidade do equipamento em detectar esta situa o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 201 OKI C digos Retorno Hexadeci Decimal Significado mal 0x0051 81 Erro de comunica o entre o terminal antena e o cart o com chip sem contato 0x0052 82 Cart o foi invalidado sele o de aplica o retornou status 6A81 0x0053 83 Cart o com problemas Esse status v lido para muitas ocorr ncias no processamento de cart es sem contato em que o cart o n o se comporta conforme o esperado e a transa o deve ser finalizada 0x0054 84 Cart o sem nenhuma aplica o dispon vel para as condi es pedidas nenhum AID encontrado 0x0055 85 A aplica o selecionada n o pode ser utilizada o Get Processing Options retornou status 6985 ou houve erro no comando Select final e n o h outra aplica o compat vel na lista de candidatas 0x00C8 200 Transa o negada na fun o PP GoOnChip 0x00C9 201 Transa o negada na fun o PP GoOnChip O0x00CA 202 Mem ria n o
178. datada Esta funcionalidade tamb m contempla o Vale Alimenta o e o Vale Refei o Assim atende as opera es da Visanet como prestadora de servi os de Acquirer para os produtos Visa Vale e Valetik Vinculado transa o de d bito vista o produto Compre amp Saque possibilita ao portador a realiza o de saque em dinheiro Durante o fluxo de coleta desde que habilitado pela rede o SCOPE solicitar o valor do saque atrav s do estado TC COLETA VALOR SAQUE 0xFC2D O cancelamento de venda pode ser feito quando ocorrerem erros na digita o valor data de agenda n mero de parcelas etc ou desist ncia da compra por parte do cliente sendo necess rio informar os dados da transa o original a ser cancelada Reimpress o de comprovante Esta fun o possibilita ao lojista a impress o de uma nova c pia do comprovante da ltima transa o realizada ou alguma espec fica desde que tenha sido aprovada e se encontre no log do Concentrador TEF funcionando como solu o para o caso da exist ncia de algum problema com a impress o original Pagamento de contas Possibilidade de pagamento de contas de concession rias com cart o Visa Electron em estabelecimentos comerciais afiliados a Visanet rede de farm cias supermercados e estabelecimentos de varejo Somente ser o permitidas transa es de d bito vista Pr autoriza o de cr dito No momento que esta transa o aprovada a administradora de cr dito sensibiliz
179. de transa es a qual retorna todos os cupons Entretanto devido exig ncia da Visanet a aplica o dever imprimir apenas o cupom solicitado pelo operador Para isso a aplica o dever consultar no SCOPE qual o cupom que dever ser impresso com a ajuda da fun o ScopeObtemTipoViaReimpressao A necessidade desta fun o surgiu por causa da interface HLAPI porque o SCOPE coletava do operador qual a via que deveria ser impressa mas a aplica o que envia os comprovantes para a impressora n o sabia dessa escolha Prot tipo LONG EXPORT ScopeObtemTipoViaReimpressao BYTE EhReimpre BYTE Via Par metros Informa se uma transa o de out BYTE EhReimpre reimpress o valor 1 ou qualquer outra transa o valor 0 Caso seja uma transa o de reimpress o informa qual a via a ser impressa out BYTE Via 0 todas as vias 1 apenas a via da loja 2 apenas a via do cliente Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE04 65028 N o existe transa o suspensa OxFF11 65297 N o existe cupom v lido Exemplo BYTE NroLnhReduzido 0 EhReimpressao ViaReimpressao char Cabec 1024 CpCliente 2048 CpLoja 2048 CpReduzido 2048 LONG retorno obt m statu
180. dever esperar pelos c digos de coleta e 64582 0xFC46 imprimir cupom parcial e 64514 0xFCO2 imprimir cupom e 64539 0xFC1B imprimir consulta e 64546 0xFC22 imprime nota promiss ria e 64593 0xFC51 imprime cupom promocional Neste momento a aplica o chamar a fun o para obter os cupons da transa o CUIDADO quando a aplica o realizar uma consulta CDC no meio de uma TEF de d bito a aplica o n o dever enviar o cupom da consulta para a impressora mas apenas exibi lo e na tela No entanto quando for apenas uma transa o de consulta isto foi chamada A apenas uma fun o do tipo ScopeConsulta lt transa o gt o comprovante recebido deve ser enviado para a impressora Prot tipo LONG EXPORT ScopeGetCupomEx WORD CabecLen char Cabec WORD CupomClienteLen char CupomCliente WORD CupomLojaLen char CupomLoja WORD CupomReduzLen char CupomReduz BYTE NroLinhasReduz Par metros im woro oavecten ea out String Cabe Ri e ser recebido o im woRD owomcieneren Taahe sanad o fout Sting oupomorene rotera para rea onde ser recebida a Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 86 OKI dispon vel para a aplica o de PDV Tamanho reservado pela aplica o para in WORD CupomlojaLen receber a via da loja Ponteiro para rea onde ser recebida a out St
181. do mal 0x0016 22 Aplica o da rede adquirente n o existe no PIN Pad 0x001E 30 Erro de comunica o porta serial do PIN Pad provavelmente ocupada 0x001F 31 Erro de comunica o PIN Pad provavelmente desconectado ou problemas com a interface serial Pode ser que a porta que est passando como par metro esteja errada 0x0020 32 Status informado pelo PIN Pad n o conhecido 0x0021 33 Mensagem recebida do PIN Pad possui formato inv lido 0x0022 34 Tempo esgotado ao esperar pela resposta do PIN Pad no caso de comandos n o blocantes 0x0028 40 Erro interno do PIN Pad 0x0029 41 Erro de leitura do cart o magn tico 0x002A 42 Erro na captura do PIN senha Master Key pode n o estar presente 0x002B 43 N o h cart o inteligente presente no acoplador Cart o removido 0x002C 44 PIN Pad n o pode processar a captura de PIN temporariamente devido a quest es de seguran a como quando atingido o limite de capturas dentro de um intervalo de tempo 0x0032 50 Erro gen rico no m dulo SAM 0x0033 51 SAM ausente mudo ou com erro de comunica o 0x0034 52 SAM inv lido desconhecido ou com problemas 0x003C 60 Cart o n o responde mudo ou chip n o presente 0x003D 61 Erro de comunica o do PIN Pad com o cart o inteligente 0x003E 62 Cart o do tipo inv lido ou desconhecido n o pode ser tratado n o EMV nem TIBC v1 0x003F 63 Cart o bloq
182. do aa aar fais Usa aa E ja luas ia Na ca fa ada doa ads SN rat ade aaaea 25 se o SCOPEAPI POS ir iiaei eni pranane eaea aaea a a aea aa Eaa aaa aaa iNe eaaa 25 Se o SCOPEAPIPOS RXXX n ras ae ara aaataa anna aaaab a aid N auaina sadia 26 Configura o do registro do MS Windows ese 27 Fontes de Dados do SCOPE no WoW64 ie errararaaaaaraananeanarea aaa naaa nana 28 Fun es b sicas da API do SCOPE Client nn 29 Comunica o com o ScopeSRYV a i a a aA Ea a aN Naia 29 CONEX o inuuna a a a ONE RR a CRER DR CERCO RT Ea RR 29 BEE g Ee e D E E Pianos asa bn aenas am ceaaslan aequo damas das anel nas tante E E E E 30 Sess o de transa o e A E E nani Nfane dadas anda savana de au nad dana 31 Sess 40 de OR RO k e a RR RR ER a anaona 31 Abrindo UMA SOSS AG sirian rana A AES renda E SA alisa das E S A E S 32 Encerrando a SESS O rasai n aaa EA A A A E AAEN a A 33 Tratando queda de energia essin enana anaa A SNE AA NAAA a sanar uau nba eaua aneis 34 Deixando transa o pendente na queda de energia essseessrrsssernessrnnussennesnnnnnntennennnnnneennnunnnnnnnennennnn 35 Status de traNsaGaOsenostinenisdai ankai aaaea aie daaa aaaea ab aa aaia aiea asa bu dada a ca a 36 Consultando Status sissien naaa aina eaa a daaa aaia aa iaaa Taaa aaraa aada aa da dao 36 Fun es de configura o de ambiente ssssssssssnnnrennnnnnnnnnnnnnnnnnnnnnnnnn
183. do registro SC101 O formato deste registro foi baseado no formato do registro ID101 da especifica o TicketCar com o acr scimo da informa o da descri o da automa o para formatar o registro ID161 da TicketCar Posi o Formato Descri o 001 040 an40 Descri o da Mercadoria da Automa o Comercial 041 045 n5 C digo da Mercadoria consumida C digo TicketCar alinhado a direita e preenchidos com zeros esquerda caso necess rio 045 052 n8 Quantidade de Mercadoria consumida alinhado a direita e preenchidos com zeros esquerda caso necess rio 053 061 n9 Valor da Transa o para a mercadoria consumida alinhado a direita e preenchidos com zeros esquerda caso necess rio 062 070 n9 Valor unit rio ou valor unit rio teto da mercadoria consumida zerado se transa o for OFF LINE alinhado a direita e preenchidos com zeros esquerda caso necess rio 071 079 n9 Valor da Transa o para a mercadoria consumida com desconto alinhado a direita e preenchidos com zeros esquerda caso necess rio 080 088 n9 Valor do desconto ou Se dever ser enviado x 100 Exemplo 10 15 gt 000001015 Se dever utilizar expoente de moeda da transa o Exemplo expoente 2 15 66 gt 000001566 alinhado a direita e preenchidos com zeros esquerda caso necess rio 089 089 ni Significado do campo Valor do desconto moeda ou percentual
184. dos produtos da rede e as transa es do SCOPE Banrisul EMV Esta a implementa o da nova especifica o do Banrisul e que trata principalmente a utiliza o de cart es com chip Com esta implementa o ser poss vel realizar as seguintes transa es do Banrisul no SCOPE e D bito vista parcelado e pr datado com o cart o Banricompras e D bito vista e parcelado com o cart o Banco SIM e Cr dito 1 minuto que uma transa o de CDC e D bito voucher de conv nio Refeisul alimenta o e refei o e Consulta saldo de conv nio Refeisul alimenta o e refei o e D bito voucher de conv nio Refeisul combust vel e Cr dito com cart o conv nio Private Label PINPads com suporte a rede Para a realiza o das transa es com cart es com chip nos PINPads deve se garantir que o PINPad saiba tratar estes cart es do Banrisul Os PINPad com a vers o da especifica o da biblioteca compartilha 1 06a j suportam por m aqueles com a vers o 1 05g pode n o suportar Nestes casos dever ser efetuada a transa o com a tarja magn tica do cart o Para saber se o PINPad suporta o tratamento do cart o com chip Banrisul deve se entrar em contato do o banco Banrisul Associa o dos produtos e as fun es do SCOPE Abaixo est uma tabela onde s o relacionados os produtos do Banrisul e as fun es da API do SCOPE que deve ser invocada para realizar a transa o Produto
185. e string WrkKey chave de trabalho utilizada pela fun o PP iGetPIN que respons vel pela coleta de senha criptografada no PIN Pad string Este campo utilizado apenas com a biblioteca da VISANET para PIN Pad filler para alinhamento em 8 bytes nos ambientes executados sobre o sistema operacional Linux PosMasterKey posi o da Master Key utilizada pela fun o PP iGetPIN Este campo utilizado apenas com a biblioteca da VISANET para PIN Pad PAN n mero do cart o utilizado pela fun o PP iGetPIN Este campo utilizado apenas com a biblioteca da VISANET para PIN Pad UsaCriptoPinpad indica se a aplica o dever coletar senha com criptografia no PIN Pad fun o PP iGetPIN ou sem criptografia no PIN Pad fun o PP iGetString Para o valor 1 um deve coletar com criptografia no PIN Pad e para o valor O zero sem criptografia Este campo utilizado apenas com a biblioteca da VISANET para PIN Pad IdModoPagto modalidade de pagamento cr dito d bito ou outros Par metro utilizado na chamada da fun o PP iGetCard Este campo utilizado apenas com a biblioteca da VISANET para PIN Pad AceitaCartaoDigitado indica se aceita a entrada digitada do n mero do cart o Informa o dispon vel no estado de coleta do cart o Reservado utiliza o futura Prot tipo LONG EXPORT ScopeGetParam LONG tipoParam ptPARAM COLETA lpParam Par metros Aplica o informa que tipo de p
186. e coleta de Coleta DDD Telefone no PIN Pad e Redigita DDD Telefone no PIN Pad e Nova interrup o EC COLETA DADOS ECF FacTI S rgio R A e Nova coleta TC COLETA DADOS ECF 0xFCB9 e Nova bandeira Ticket Car 1 25 20 01 2012 Assun o e Nova fun o ScopeAtualizaParametrosChip Jailton da S C Santana e Novo c digo para ScopeForneceCampo e Acrescentado t pico da rede Ticket Edenred e Acrescentada a rede e a bandeira EPay i f e Altera o da bandeira PL COSAN para PL GETNET Facti Felipe M Schaden 1 26 05 03 2012 VISA Facti Tiago F Val rio e Inclus o da Bandeira PL GETNET MASTER 1 27 23 03 2012 Edison Ogata e Inclus o da se o PINPAD no arquivo scope ini 1 28 16 04 2012 Facti Tiago F Val rio e Inclus o da rede TENDENCIA Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 4 OKI e Inclus o do detalhamento sobre as configura es de registro do SCOPE no WoW64 1 29 26 04 2012 Facti Rafael D Tardivo q e Inclus o da sess o Fontes de Dados do Scope no WoW64 e Inclus o da nova estrutura de Dados de Recarga de 1 30 11 05 2012 Facti Rafael D Tardivo Celular stREC CEL VALORES MODELO 4 1 31 22 05 2012 Facti Felipe M Schaden e Inclus o da Bandeira POLICARD SENHA 1 32 20 06 2012 Edison Ogata e Inclus o da fun o ScopeVersao 1 33 21 06 2012 Facti
187. e de diversas maneiras exemplo 40 do valor da venda ser o pagos em d bito e o restante com o cart o de cr dito e para validar a venda todas as transa es dever o ser aprovadas caso contr rio as transa es n o podem ser conclu das n o tem sentido que a venda seja considerada conclu da apenas com a aprova o de parte do valor da compra Em cada venda realizada a aplica o deve abrir a sess o realizar as diversas transa es e finalmente fechar a sess o confirmando ou desfazendo todas as transa es desta venda A estrutura do fluxo b sico de funcionamento do SCOPE Client encontra se na figura 4 IMPORTANTE numa sess o de multi TEF em que h v rias transa es n o poss vel A desfazer uma ou outra transa o Para isso o operador dever cancelar todas daquela sess o ou confirm las Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 31 In cio do aplicativo Registra as vendas Realiza TEF s N Finaliza aplicativo Figura 5 vis o geral do funcionamento do SCOPE Client Abrindo uma sess o A fun o ScopeAbreSessaoTEF informa ao SCOPE para iniciar uma sess o de TEF ciclo com uma ou mais transa es TEF Ela deve ser invocada ao finalizar a venda e antes de selecionar o meio de pagamento Prot tipo LONG EXPORT ScopeAbreSessaoTEF void Par metros N o h par metro Retorno Ver tabel
188. e energia poss vel tamb m deixar a transa o pendente para depois realizar o acerto de pend ncia manual no m dulo de pend ncia SCOPEPND Este acerto s dever ser realizado por um gerente algu m de finan as ou quem a empresa deposite confian a e seja respons vel para tal procedimento O aplicativo deve chamar a fun o ScopeMTEFOnOff antes do tratamento de queda de energia informando se deseja desfazer ou deixar pendentes as transa es Prot tipo LONG EXPORT ScopeMTEFOnOff BYTE Trata Par metros Informa o SCOPE para desfazer 0 lin Byte Trata poss veis transa es interrompidas ou deixar pendente 1 para o posterior acerto manual Retorno e 0x0000 definiu com xito a a o a ser tomada conforme o par metro passado e 0xFE00 n o foi aberta a conex o com o SCOPE Server e 0xFE01 tem transa o em sendo processado Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente Exemplo BYTE acao defez Conecta ao servidor do SCOPE ScopeMTEFOnOff 1 deixa pendente ScopeFechaSessaoTEF acao amp defez 1f desfez printf A transa o TEF anterior foi desfeita cancelada printf in Reter o cupom TEF Ma
189. e importado pelo SCOPECon No final desse fluxo a automa o comercial poder obter quase todos os campos necess rio utilizando a fun o ScopeObtemCampoExt2 Na loja o operador de caixa ir com o portador do cart o a um POS passar o cart o para pagar a venda O operador retornar ao caixa com o cupom do estabelecimento impresso pelo POS e executar essa transa o Os dados contidos na via do estabelecimento s o importantes para alimentar os dados da transa o A n o utiliza o do SCOPE poder ser por diversas situa es A principal quando o cart o CONSTRUCARD ou BNDES pois eles n o s o tratados pelo SCOPE Outra situa o quando a rede autorizadora ou o pr prio SCOPE Server estiver offline Nesse caso a transa o ser paga no POS mas o estabelecimento poder fazer a concilia o da transa o Os par metros da fun o n o s o obrigat rios Passar valores diferentes do padr o simplificar o fluxo de coleta n o sendo solicitado ao operador Se esta fun o vai ser chamada para finalizar a venda que est aberta a automa o poder passar o valor da venda automaticamente IMPORTANTE Essa transa o n o exige abertura de sess o Tamb m ela n o tem A garantia de queda de energia ou seja no caso de interrup o da transa o os dados coletados ser o perdidos Se aberta a sess o de TEF ela n o considerada no limite de 9 TEFs permitidos na sess o Prot tipo LONG E
190. e se devem ser coletados Dados do Motorista 362 Decide se deve ser coletado Hod metro do Ve culo 363 Decide se deve ser coletado Hor metro do Ve culo 364 Coleta Hor metro do Ve culo 365 Decide se deve ser coletada a Placa do Ve culo 366 Coleta de Cart o Magn tico 368 Coleta de Segmento SAV 369 Coleta de Fornecedor SAV 370 Coleta de Produto Servi o C digo EAN SAV 371 Coleta de Quantidade 372 Recupera Dados 373 Coleta de Cliente Preferencial 374 Exibe Mensagem C digo das redes Abaixo se encontram as redes suportadas pelo SCOPE e seus respectivos c digos C digos Rede Significado C digo SAT Decimal Decimal 0 SCOPE 999 1 Tecban 31 2 Ita 999 3 Visanet especifica o 2000 01 999 4 Bradesco 999 5 Redecard 25 6 Fininvest 999 7 Serasa 999 8 Teledata 999 9 Banrisul 999 10 Ticket 32 11 Associa o Comercial de S o Paulo ACSP 999 12 BrasilCard Antiga CNS 999 13 Sysdata 999 14 Redecard especifica o L0102 25 15 Visanet especifica o 1998 10 999 16 CBD 999 17 Lojista 999 18 CSU 999 19 Parati 999 20 Bem 999 21 Tokor 999 22 MaxiCred 999 23 Zogbi 999 24 ACC Card 999 25 Sorocred 30 26 Coopercred 999 27 Telesp 999 28 Policard 23 29 Via Varejo 999 Manual do desenvolvedor SCOPE S
191. e senha DUKPT Prot tipo LONG EXPORT ScopeServicoTecnico WORD CodServico WORD CodBandeira Par metros in WORD C digo do servi o do grupo T cnico a ser CodServico executado Use O zero para indicar que a decis o do servi o ser atrav s de coleta in WORD C digo da bandeira do produto a ser CodBandeira executado Use O zero para indicar que o c digo da bandeira dever ser coletado Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 162 OKI OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFEO5 65029 API ainda n o fez nenhuma transa o ap s a inicializa o A aplica o est tentando obter um handle sem ter feito nenhuma transa o desde ltima conex o com o ScopeSRV OxFE06 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v l
192. e transa es realizadas em POS e gravadas no chip Para a transa o de envio destas off line verdade que o Pode acontecer em qualquer uma das transa es desta rede o N o vis vel para o operador do caixa ou portador do cart o ou seja nenhum dos dois sabem que est enviando tais mensagens o N o impresso comprovante para elas o N o visto em relat rios do SCOPEADM o Apenas poss vel verificar a exist ncia do envio da offline pelos logs do SCOPE Server N o h transa es com os cart es Ticket Alimenta o e Ticket Restaurante roteadas para esta rede no SCOPE PINPads com suporte a rede Para a realiza o das transa es com cart es com chip nos PINPads deve se garantir que o PINPad saiba tratar os cart es Ticket Car Para isto deve se utilizar PINPads Gertec modelo PPC900 com a vers o da especifica o da biblioteca compartilhada 1 07A ou superior contendo a chave Masterkey 3 Associa o dos produtos e as fun es do SCOPE Abaixo est uma tabela onde s o relacionados os produtos da rede Ticket Edenred e as fun es da API do SCOPE que deve ser invocada para realizar a transa o Produto Ticket Edenred Fun o da API do SCOPE Compra online D bito Voucher ScopeCompraCartaoDebito vide item Compra com cart o de d bito Estorno online ScopeCancelamento vide item Estornando a transa o Consulta saldo ScopeConsultaSaldoDebito vide item ScopeConsultaSaldoDebi
193. eTransacaoFinanceira Aciona o SCOPE Client para efetuar uma transa o financeira Prot tipo LONG EXPORT ScopeTransacaoFinanceira char Valor WORD Servico Par metros in String Valor Valor da transa o Informa qual o servi o a ser adotado Caso in WORD Servi o O zero a coleta do servi o ser feita pelo procedimento usual ver C digos dos Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 157 Retorno OKI Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64002 Par metro 2 inv lido OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFBO1 64257 N o foi poss vel criar a thread na coleta de dados OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFFiD 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual Scopelnvestimento Aciona o SCOPE Client para efetuar um investimento Prot tipo LONG EXPORT ScopeInvestimento char Valor WORD Servico Par metros in String Valor Valor da transa o Informa qual o servi o a ser adotado Caso Servico O zero
194. ecarga de celular pagamento de contas e de fatura de cart es etc Numa transa o o SCOPE Client comunica se com o SCOPE Server baseado em mensagens as quais seguem a norma ISO 8583 que especifica o protocolo de mensagens para transa es financeiras com cart o As mensagens b sicas e as suas sequ ncias que geralmente compoem uma transa o completa e bem sucedida s o demonstradas na figura 1 e descritas abaixo Observe que a informa o apresentada abaixo n o exposta interface de programa o compreendendo um fluxo interno entre SCOPE Cliente SCOPE Server 9604 mensagem de solicita o da pr TEF esse tipo de mensagem geralmente enviado duas vezes com finalidade diferentes primeira e segunda pr TEF A primeira pr TEF cont m o BIN de um cart o e um grupo de servi o al m de outros dados exigidos numa mensagem ISO A segunda abrange o produto selecionado 9614 mensagem de resposta da pr TEF Cont m os dados solicitados pelo SCOPE Client Como a mensagem 9604 esta diferir de acordo com o contexto da pr TEF A resposta da primeira a rede autorizadora a bandeira os servi os dispon veis e os atributos ex limite de parcelas data limite de agendamento etc dos produtos habilitados para o cart o capturado A da segunda define para o SCOPE Client como as mensagens das transa es dever o ser montadas 0200 mensagem de solicita o da transa o financeira Neste momento a men
195. eita 081 082 N2 Tamanho da trilha 2 083 119 A37 Trilha 2 sem as sentinelas alinhada esquerda com espa os direita 120 121 N2 Tamanho do PAN 122 139 A19 PAN alinhado esquerda com espa os direita 140 166 A26 Nome do propriet rio do cart o com espa os direita Prot tipo LONG EXPORT ScopePPGetCard WORD Id char MsgNotify WORD Len char Dados Par metros lin woRD ld Informa a op o do formato dos dados de sa da Inicialmente fixo com O zero lin String MsgNotify Mensagem de 32 caracteres a ser apresentada no 9 checkout caso a fun o retorne PP NOTIFY in WORD Len Tamanho do buffer alocado para os dados Dados Dados sobre o cart o finalizado Consulte a tabela abaixo out String Arda para a especifica o do formato Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal mal Significado 0x0002 2 Notificar o operador com a mensagem recebida do PIN Pad 0x000B 11 Par metro inv lido 0x00D3 211 PIN Pad n o foi aberto pela aplica o Exemplo char cartao 256 char mensagem 256 LONG retorno 0 if do ScopePPStartGetCard 99 printf nAguardando inserir ou passar o cartao if retorno 2 while retorno 0 if retorno Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 000 0 E retorno ScopeP
196. elas Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 194 OKI C digos Retorno Hexa Decimal Significado decimal OxFC96 64662 Coleta se a primeira parcela para 30 ou 60 dias OxFC97 64663 Uso interno do SCOPE e n o retornado para a aplica o OxFC98 64664 Uso interno do SCOPE e n o retornado para a aplica o OxFC99 64665 Uso interno do SCOPE e n o retornado para a aplica o OxFC9A 64666 Coleta o N mero do Cart o para a TEF Externa OxFC9B 64667 Coleta o c digo de servi o do posto transa o de conv nio combust vel Banrisul OxFC9C 64668 Coleta a matr cula transa o de conv nio combust vel Banrisul OxFC9D 64669 Coleta a quantidade do servi o transa o de conv nio combust vel Banrisul OxFC9E 64670 Coleta o hod metro transa o de conv nio combust vel Banrisul OxFC9F 64671 Coleta a placa do ve culo transa o de conv nio combust vel Banrisul OxFCA1 64673 Coleta o n mero do resgate de pr mio OxFCA2 64674 Op o de resgate de pr mio selecionada OxFCAS 64675 Solicita o a confirma o do resgate OxFCA4 64676 Coleta o n mero do resgate pr mio OxFCA5 64677 Coleta o n mero do Voucher OxFCA6 64678 Decide
197. elecimentos e as autoriza atrav s de um sistema autorizador Exemplos Visanet Redecard TecBan S 236 SCOPE O SCOPE a solu o Itautec para pagamentos eletr nicos ScopeCNF SCOPE Configurador o m dulo respons vel pela configura o e cadastramento de par metros para a solu o SCOPE SCOPE Client conjunto de bibliotecas localizadas na m quina em que a aplica o de frente de loja O conjunto de bibliotecas pode variar conforme o sistema operacional e a linguagem de programa o utilizada ScopeGW SCOPE Gateway funciona como um roteador de mensagens entre um ou mais servidores SCOPE e uma ou diversas redes ScopeSRV SCOPE Server o m dulo principal da solu o SCOPE respons vel por estabelecer o contato inicial de todos os contratos cadastrados na base de dados com as respectivas redes garantindo tamb m o fluxo de transa es com estas redes Servi o o termo servi o no contexto do SCOPE define o objetivo de uma transa o Exemplos compra com Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 OKI cart o de cr dito vista compra com cart o de cr dito parcelada pelo estabelecimento sem juros compra com cart o de cr dito parcelada de administradora com juros compra com cart o de d bito vista compra com cart o de d bito pr datado compra com cart o de d bito voucher consulta cheque estorno cr dito estorno d bito Ser
198. ente est participando de uma campanha promocional chamado tamb m de e cupom de participa o IMPORTANTE Todos os tipos de pr mios podem ou n o ocorrer simultaneamente em uma A mesma transa o Que tipos de transa es podem receber os pr mios e Cr dito e D bito e Voucher Alimenta o e Voucher Refei o poss vel restringir para tratar apenas pr mios n o monet rios ou seja n o permitir descontos Caso o segmento de atua o ou os estados do Brasil em que sua automa o utilizada possuam restri es fiscais concess o de descontos monet rios sugerimos consultar a empresa certificadora da CIELO e validar de antem o o tratamento que o tratamento que se pretende fazer na automa o ser adequado para a certifica o O que preciso configurar no SCOPE CNF necess rio habilitar o produto abaixo no Perfil de Servi os Iyf Consulta Resgate de Premios CIELO CIELO Bem como a bandeira CIELO na tela de Contrato Bandeira CIELO A Cielo precisa habilitar o Cielo Premia Sim a Inicializa o de Tabelas precisa contemplar tais produtos O Lojista precisa entrar em contato com a CIELO e negociar a implanta o do Cielo Premia poss vel integrar e testar atrav s do SCOPE Autorizador Sim No ScopeAut h uma Inicializa o de Tabelas que contempla o Cielo Premia chamada PP OnLine conforme mostrado abaixo Inicializa o
199. entes s quantidades de parcela 67 Decide se coleta pr autoriza o 68 Coleta pr autoriza o 69 Coleta se confirma o dia do m s fechado 70 Carrega os atributos de parcela sem parcela vista 71 Decide se coleta o cart o 72 Verifica o cheque 73 Imprime a nota promiss ria 74 Coleta a data da pr autoriza o 75 Coletao CEP 76 Coleta o n mero da resid ncia 77 Coleta o complemento do endere o 78 Decide se consulta saque 79 Consulta saque 80 Decide se coleta o n mero do item 81 Coleta o plano de pagamento 82 Coleta ciclos a pular 83 Coleta o n mero do item 84 Decide se coleta o c digo de seguran a 85 Coleta o c digo de seguran a 86 Coleta a autoriza o do supervisor 87 Coleta se o c digo de seguran a do cart o est ausente ou ileg vel 88 Carrega os atributos de garantia pr datado 89 Coleta se com ou sem garantia 90 Decide se aceita risco 92 Decide se coleta o valor do saque 93 Coleta o valor do saque 94 Consulta valores 95 Coleta o valor de recarga de celular 96 Verifica o valor de recarga 97 Coleta o c digo de localidade do telefone 98 Coleta o n mero de telefone 99 Carrega a sugest o de recarga de celular 100 Verifica a transa o 101 Coleta o d gito verificador do telefone 102 Decide se coleta a taxa de servi o 103 Coleta a taxa de servi o 104 Coleta data no formato DDMMAA 105 Decide se coleta data no fo
200. ento de servi o de cr dito o pr ximo estado poder ser coletar se vista ou n o o fluxo avan a at a impress o do comprovante Interfaces de intera o com o SCOPE Client Antes de come ar o desenvolvimento da integra o com o SCOPE de fundamental import ncia a decis o de como a aplica o ir interagir com o SCOPE Client escolhendo uma das interfaces dispon veis interface coleta ou interface HLAPI A escolha do tipo de interface depende de fatores tais como Tempo de implementa o flexibilidade e plataforma adotada Interface coleta Dispon vel para todos os sistemas operacionais com os quais o SCOPE Client executado a interface coleta do SCOPE Client o que apresenta uma maior intera o entre a aplica o de PDV e o SCOPE Atrav s desta interface a aplica o se torna respons vel pela coleta dos dados digitados pelo operador ou cliente conforme a solicita o a cada itera o do SCOPE Como a Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 16 OKI aplica o coletar os dados ela se responsabilizar pela exibi o da mensagem na tela e a entrada de dados para o operador sendo que para alguns casos dever tratar tamb m a limita o do tamanho do campo aceit vel ex para a coleta do n mero de seguran a do cart o a aplica o permitir a entrada de um valor com no m nimo 3 e no m ximo 5 d gitos Caracter sticas da interface co
201. eradora 211 Consulta operadora 212 Decide se confirma valor no PIN Pad 213 Transa o cancelada pelo cliente 214 Decide se cancela transa o 215 Coleta se cancela a transa o 216 Coleta em andamento 217 Retirar o cart o 218 Transa o aprovada 219 Decide se coleta a taxa de embarque 220 Coleta a taxa de embarque 221 Coleta de cart o em andamento 222 Exibe mensagem de saldo 225 Coleta cart o digitado 226 Obt m servi os 227 Exibe saldo no PIN Pad 228 Encerra transa o por erro 229 Coleta o c digo do produto 230 Exibe mensagem recebida do PIN Pad e retorna 231 Exibe mensagem de erro recebida do PIN Pad e retorna 232 Exibe menu 233 Encerra menu 234 Encerra transa o 235 Decide se INSS 236 Coleta contrato 237 Verifica CPF 238 Coleta data de membership do cliente 239 Recupera comprovante do servidor 240 Fornece valor 241 Recupera menu de cancelamento 242 Coleta dados da transa o original 243 Retorna dados da transa o original 244 Coleta n mero da autoriza o original 245 Coleta data da transa o original Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 209 OKI 246 Coleta NSU da transa
202. ervi os reatar aeeeaaarea aaa naannanaaa 187 Lista de Fornecedores sessantina niss aan nanea AET aPEDAD ap iam AGESLEn va san nas E 187 Lista de ProdUlOS arosai seanna AAAA A EESE O asa danpasaslant aa 188 Cielo Transa es Sem Contato Contactless er earaareenare aan nearananaa 190 ReQUISILOS aa 42qasrandifaasa gamas ia nas fassal ARANEA AAAA R EREN A AEA AA 190 Funcionamento sireisas eiiean a Aaa Aa RAT NA Gac a dana LI RR CASA nada A AE Eaa Eea eaaa E a Eaa 190 Ap ndice A Tabelas usa a ai aaa a RT a aa 192 C digos de retorno rrecaraaaaarraaaaana area near ra aaaa ana na aa araa aaa a aaa aa nara aaa anna anna ana 192 Coleta de dados DEEE 192 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 11 AULOTIZADOTAS e R E O E EOS 196 C digos de erros do SCOPE ssssseesseesseessresrnesnnernetnnetrnettnsttnstnnsttnatnstnatnastun renan aa anaa aaa nn aaa nnan nn nant 197 PIN Pad companilhadO sena T E E dadas pa Dani aaa 200 C digos de Retorno de Pr EF ssesseesseessesesrnernernetrnsrnstrnstnnsttnntnsstnnstnsstnnstnnstenatansnnnnnnnnnnn nnna nn ennt 202 Foma dos QadO Sane a a E E E EE 204 C digos das TeclaS sms E A T A A T 204 C digos d Fl XO mokuraieiiiriesiin irio aia n eneid aa aia iaaa Den Dada nai a Aaaa aaa aiaia 205 Estados para interrup o ereiivirin eien A EAEE EEE ENEA E AENEAN S 205 C digo das tedas surai ainni aiana aA aa ia ia a
203. esfazimento da s transa o s Para maiores detalhes dos c digos relacionados ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFB08 64264 Erro no arquivo de controle utilizado finaliza o no ciclo multi TEF OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente Exemplo BYTE acao defez Realiza a s transa o s desejada s Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 33 OKI acao 1 confirmar retorno ScopeFechaSessaoTEF acao defez if retorno 0 Erro no encerramento da sess o Tratando queda de energia A fun o que encerra a sess o tamb m utilizada para desfazer as transa es pendentes de uma sess o de TEF ap s uma queda de energia no PDV Se o par metro que permite que a aplica o interfira na conclus o de transa es em caso de quedas de energia estiver habilitado ver tabela de configura es gerais realizado o desfazimento ou a confirma o das transa es pendentes de acordo com o par metro de entrada escolhido pelo operador Se o par metro estiver desabilitado ap s a aplica o ter restabelecido a conex o com o servidor SCOPE ela dever chamar essa fun o para finalizar uma poss vel sess o que ainda esteja em aberto Nesse
204. eta quantidade de parcelas e aceita 1 parcela OxFC51 64593 Imprime cupom promocional OxFC52 64594 Coleta se utiliza saldo OxFC64 64612 Coleta RG OxFC66 64614 Coleta somente CPF OxFC7B 64635 Coleta o valor da primeira parcela OxFC7D 64637 Coleta se cancela ou n o a transa o OxFC7E 64638 Go On Chip OxFC7F 64639 Retira o cart o OxFC80 64640 Coleta o valor da taxa de embarque OxFC85 64645 Coleta o cart o digitado OxFC87 64647 Exibe o menu OxFC95 64661 Coleta o valor das parcelas OxFC96 64662 Coleta se a primeira parcela para 30 ou 60 dias OxFC9F 64671 Coleta a placa do ve culo transa o de conv nio combust vel Banrisul OxFCA5 64677 Coleta o n mero do Voucher OxFCBE 64702 Coleta dados ECF OXFCC1 64705 Coleta op o de pagamento de carn para GetnetLAC no servi o de d bito a vista para bandeira ELECTRON 0 N o para pagamento de carn 1 Sim para pagamento de carn OxFCCB 64715 Coleta da Lista de Mercadorias Consumidas OxFCFE 64766 Mostrar informa es e retornar fluxo para o cliente SCOPE OxFCFF 64767 Mostrar Informa es e aguardar confirma o do operador Poss veis Retornos de Erros Exemplo char valor 12 1 C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o
205. etros N o h par metro Retorno Pressionada tecla de confirma o OK ou ENTER Pressionada tecla de fun o 1 Pressionada tecla de fun o 2 Pressionada tecla de fun o 3 Pressionada tecla de fun o 4 Pressionada tecla de limpeza backspace Pressionada tecla de cancelamento Para os valores de retorno veja a tabela de c digo de retorno ONDA RO Exemplo LONG retorno 0 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 112 OKI if ScopePPStartGetkKey 0 se OK printf inAguardando tecla a ser pressionada no PIN Pad do retorno ScopePPGetKey while retorno 1 enquanto em processamento switch retorno case 0 printf nPressionada a tecla lt OK gt in break case 4 printf inPressionada a tecla de funcao 1 n break case 5 printf inPressionada a tecla de funcao 2in break case 6 printf inPressionada a tecla de funcao 3in break case 7 printf inPressionada a tecla de funcao 4An break case 8 printf inPressionada a tecla lt Limpa gt in break case 13 printf inPressionada a tecla lt Cancela gt in break default printf nERRO din retorno break Obtendo a senha aberta O conjunto ScopePPStartGetPIN ScopePPGetPIN tamb m n o blocantes respons vel pela captura da senha do usu rio A senha criptografada pelo PIN Pad com a Master Key da
206. etros da transa o Durante a itera o do processamento de uma transa o a aplica o deve obter informa es necess rias para solicitar a coleta do dado para o operador e ou cliente A fun o ScopeGetParam respons vel em descre o SCOPE Client retornar um estado de co ver os dados a coletar deve ser chamada sempre que leta correspondente a uma coleta de dados ver Status de transa o Com o retorno do SCOPE Client a aplica o de PDV dever atualizar as mensagens das telas do operador e ou cliente disponibilizar um meio de entrada de dado validar a entrada entre outras a es A aplica o cancelar retornar e continuar a coleta de d deve prover o operador de algum meio que ele possa ados da transa o As mensagens que o SCOPE Client disponibiliza para serem exibidas s o fundamentadas no fato de que no PDV haja dois visores displa apresentado ao operador do PDV Al m y um que apresentado ao cliente da loja e outro disso por padr o considera se que cada um desses visores possua 2 linhas de exibi o de mensagens com largura de 40 caracteres poss vel configurar o tamanho m ximo de colunas para at 20 ou 16 ver o cap tulo Configura o Estruturas de apoio Para a aplica o receber do SCOPE Client as informa es para coleta ela dever passar um endere o de mem ria de um buffer que representado em linguagem C pela estrutura ptPARAM COLETA definida n
207. feita na transa o de d bito no estado de coleta TC COLETA LISTA MERCADORIAS Informa es adicionais na se o Fornecendo informa es extras para a transa o e StructField dados fornecidos pela aplica o cujo formato para a constante utilizada na tabela abaixo Posi o Formato Descri o 001 004 an4 Header LMO1 Identificador do layout da lista 005 005 ni Quantidade de Casas Decimais para Valor Unit rio das mercadorias Enviado no ID126 Compreendido entre 0 e 7 inclusive 006 006 ni Quantidade de Casas Decimais para Quantidade das mercadorias Enviado no ID145 Compreendido entre O e 8 inclusive 007 008 n2 Ramo Atividade 01 Posto de Combust C digo do Ramo de Atividade do Checkout alinhado a direita e preenchidos com zeros esquerda caso necess rio 009 013 an5 ID SC101 Cont m identificador do formato do registro que ser passado 014 016 n3 Qtd Registros Todos os registros a seguir dever o ser do mesmo formato SC101 alinhado a direita e preenchidos com zeros esquerda caso necess rio 017 106 ans90 Registro SC101 Conforme descri o do formato 107 196 ans90 Registro SC101 Conforme descri o do formato A consulta aos c digos das mercadorias est descrita posteriormente no tem C digo das Mercadorias Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 171 OKI Descri o do formato
208. gistrador 5004 Par metro lib incorreto 5005 Erro Leitura Cartao Trilha PIN Pad compartilhado Para alguns casos o SCOPE poder retornar erros reportados pelo PIN Pad compartilhado cujos c digos se encontram descritos na tabela abaixo C digos Retorno Hexadeci Decimal Significado mal 0x0000 0 Opera o OK 0x0001 1 Opera o em processamento 0x0002 2 Notificar o operador com a mensagem recebida do PIN Pad 0x0004 4 Pressionada a tecla de fun o 1 0x0005 5 Pressionada a tecla de fun o 2 0x0006 6 Pressionada a tecla de fun o 3 0x0007 7 Pressionada a tecla de fun o 4 0x0008 8 Pressionada a tecla Limpar Clear 0x000A 10 Necess ria opera o previa 0x000B 11 Par metro inv lido 0x000C 12 Time out esgotado o tempo de resposta 0x000D 13 Opera o cancelada 0x000E 14 PIN Pad j foi aberto 0x000F 15 PIN Pad n o foi aberto 0x0010 16 Erro interno de execu o 0x0011 17 Fun o n o suportada 0x0012 18 Fun o n o dispon vel 0x0013 19 Aus ncia de dado mandat rio para o processamento 0x0014 20 Tabelas expiradas 0x0015 21 Erro ao tentar gravar tabelas falta de espa o por exemplo Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 200 OKI C digos Retorno Hexadeci Decimal Significa
209. he d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBO3 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line 0xFF1D 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Exemplo WORD CodBandeira abre sess o Obt m a bandeira do cart o retorno ScopeReimpressaoOnLine CodBandeira processa a transa o fecha a sess o IMPORTANTE para a certifica o da Visanet 4 1 esta fun o n o necess ria estar implementada IMPORTANTE a fun o ScopeReimpressaoOnLine substitui a anterior ScopeReimpressaoComprovantePagamento No entanto esta ltima ainda mantida por Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 90 OKI compatibilidade Imprimindo o comprovante correto Como acontece em qualquer outra transa o na reimpress o de comprovante os cupons s o recebidos pela fun o de cupons ver Comprovantes
210. i Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFF59 65369 Fun o de uso exclusivo na interface coleta Exemplo conex o com o scope server bem sucedida trabalhando com impressora carbonada retorno ScopeConfigura 16 1 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 39 OKI Configura o de PIN Pad Para evitar a substitui o de PIN Pad por um tipo incompat vel com a configura o do ScopeCNF h a possibilidade de informar o SCOPE o tipo do PIN Pad que est conectado e proibir a execu o de transa o A valida o est baseada nas seguintes op es e valor O n o possui PIN Pad conectado e valor 1 utilizando PIN Pad via biblioteca VISANET e valor 2 utilizando PIN Pad com biblioteca compartilhada Validando a interface de PIN Pad A valida o da interface utilizada pela aplica o de PDV versus a configurada no ScopeCNF somente ocorrer na chamada fun o ScopeOpent Sendo assim a aplica o de PDV deve solicitar a valida o antes da conex o com o servidor do SCOPE Prot tipo LONG EXPORT ScopeValidaInterfacePP BYTE IntPP Par metros informa ao SCOPE a interface de acesso in BYTE IntPP ao PIN Pad compartilhada utilizada pela Aplica o PDV Retorno Ver tabela de c digo de retorno
211. i aberto pela aplica o Exemplo char pin 40 LONG retorno 0 if ScopePPStartGetPINEx DIGITE A SENHA O 0 NULL NULL 0 printf n guardando digita o da senha do retorno ScopePPGetPINEx pin while retorno 1 enquanto em processamento if retorno 0 se OK printf nA senha digitada s n pin Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 116 OKI Lendo um cart o Como a leitura de senha e de teclas a captura de cart o tamb m se d com o uso de fun es n o blocantes ScopePPStartGetCard ScopePPGetCard Iniciando a leitura do cart o ScopePPStartGetCard a fun o que inicia o processo de leitura do cart o seja ele magn tico ou com chip Prot tipo LONG EXPORT ScopePPStartGetCard WORD TipoApl char ValorInicial Par metros Identifica o tipo de aplica o desejada cr dito 1 d bito 2 Tipo pl in WORD t POAp e para qualquer aplica o 99 Valor inicial da transa o Podendo ser O zero caso este in String Valorlnicial gado n o esteja dispon vel Este campo dever ter tamanho m ximo de 12 doze bytes sendo 2 duas casas decimais Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x00D3 211 PIN Pad
212. ibir mensagens Para este formato padr o existe a fun o ScopePPDisplay Prot tipo LONG EXPORT ScopePPDisplay char Msg Par metros in String Msg Mensagem de 32 caracteres 2 linhas x 16 colunas a ser apresentada no display do PIN Pad Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 108 OKI Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x00D1 209 PIN Pad n o configurado 0x00D2 210 Display n o permitido neste momento ou situa o 0x00D3 211 PIN Pad n o foi aberto pela aplica o Exemplo LONG retorno 0 Itautec S A e o retorno ScopePPDisplay Mensagens maiores Para aproveitar os recursos do visor de certos equipamentos o SCOPE Client disponibiliza a fun o ScopePPDisplayEx que recebe junto com a mensagem o tamanho desta O par metro uma String que obedece ao formato abaixo Posi o Formato Descri o 001 003 N3 Tamanho da mensagem a seguir xxx Mensagem a ser apresentada podendo conter caracteres de controle 004 279 AXXX aceitos pelo display do PIN Pad tal como o CR 0Dh para quebra de linha Prot tipo LONG EXPORT ScopePPDisplayEx char Msg Par metros in String MS9 String ASCII de caracteres com o formato abaixo Retorno
213. idas para transa o TicketCar 1 58 06 08 2013 Facti Juliana Bersi e Inclus o da rede e bandeira ELAVON 1 54 11 10 2018 Facti Camila M Dutra Facti Felipe M Schaden e Inclus o das bandeiras Bancred Senha e Vegas Card Senha 1 55 14 10 2013 Facti Felipe M Schaden e Inclus o da rede VR e das bandeiras VR e Multibeneficios e Descri o do ForneceCampo SCOPE DADOS APLIC CBD 1 56 13 01 2014 Jovelina M de Jesus e Inclus o de rede e bandeira PharmaSystem fun es Elegibilidade Pr Autoriza o Cancelamento de Pr Autoriza o layouts de lista de medicamentos fun o para recupera o de lista de projetos 1 57 11 02 2014 Jovelina M de Jesus e Inclus o das rotinas de PIN Pad para leitura e limpeza de comanda Inser o de dois c digos de retorno de erro para PIN Pad compartilhado 1 58 21 03 14 Jailton da S C Santana e Descri o da funcionalidade de transa o POS e Inclus o da configura o do scope ini para a transa o POS 1 59 25 03 2014 Edison Ogata Inclus o da bandeira FORTBRASIL 1 60 02 06 2014 Facti Felipe M Schaden Inserido item Consulta a saldo de cart o de d bito Corrigido c digo para TC COLETA DADOS ECF e Incluida informa o de Consulta das Mercadorias configuradas pela Inicializa o de Tabelas da Ticket Edenred e Complemento e corre o de informa es espec ficas para a rede Ticket
214. ido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFEOD 65037 N o h arquivo com dados da transa o anterior salvo OxFBO1 64257 N o foi poss vel criar a thread na coleta de dados OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line 0xFF1D 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFF36 65334 Erro no envio da confirma o ou desfazimento da transa o anterior OxFF3A 65338 Erro interno na execu o da coleta OxFF5E 65374 Erro ao desmontar a estrutura ISO OxFF60 65376 Fun o indispon vel OxFFFF 65535 Erro gen rico ScopeAtualizaParametrosChip Utilizada quando par metros do chip do cart o necessitam ser atualizados Esta fun o inicia o fluxo de coleta necess rio para a atualiza o de par metros do chip do cart o Redes que utilizam esta fun o s o Ticket Edenred e Cielo R2014 Coleta b sica da transa o e Solicita ao portador a inser o do cart o no pinpad e Soli
215. informa es sobre o Wow64 consulte a sess o Instala o do SCOPE em Sistemas Operacionais Microsoft Windows de 64 Bits no documento Scope Manual de Instala o e Configura o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 28 OKI Fun es b sicas da API do SCOPE Client Comunica o com o ScopeSRV O funcionamento correto da maior parte das fun es do SCOPE Client demanda a conex o com o ScopeSRV Esta conex o possui a finalidade de carregar inicialmente todos os par metros de configura o da aplica o para que o SCOPE Client consiga realizar as transa es b sicas Toda mensagem trocada entre o SCOPE Client e o ScopeSRYV deve utilizar o protocolo TCP IP Conex o Inicia o SCOPE Client procedendo aloca o dos recursos necess rios Essa fun o dever ser executada uma nica vez no in cio do aplicativo de PDV Antes de enviar o logon para o SCOPE Server o client gera um par de chaves p blica e privada Dependendo da configura o de hardware do PDV esse processo pode levar alguns segundos Isso necess rio para gerar uma chave de tamanho seguro e assegurar a conformidade com o PCI DSS Entretanto o estabelecimento pode definir um tempo m ximo de para gerar essas chaves configurando o par metro GenTimeout no arquivo scope ini do client ver t pico Sess o lt empresa gt lt filial gt N ATEN O a configura o do par metro GenTi
216. ito til obter esses dados j que o SCOPE quem coleta e ela n o conhece nenhum dado Ent o ao final da transa o a aplica o poder obter do SCOPE alguns dados que est o dispon veis J na interface coleta quase todos os dados da transa o a aplica o consegue obter uma vez que ela que prov a entrada de dados e repassa o que foi coletado para o SCOPE A aplica o pode conhecer o dado coletado a partir do c digo do estado de coleta que o SCOPE passa para ela coletar Para obter estes dados primeiramente a aplica o solicita um handle para a transa o Uma vez obtido este handle a aplica o solicita os dados da transa o um de cada vez ou todos de uma nica vez Obtendo handle A aplica o dever solicitar o handle com a fun o ScopeObtemHandle Dependendo do momento em que coletar os dados o par metro desta fun o ser diferente gt valor O este valor dever ser passado para uma refer ncia da ltima transa o ou da transa o em andamento ap s a solicita o de autoriza o gt valor 8 este valor utilizado para a obten o de dados de uma transa o ap s queda de energia gt valor 9 este valor usado quando o momento de obten o de algum dado acontecer durante o processamento da transa o antes da solicita o de autoriza o Prot tipo LONG EXPORT ScopeObtemHiandle LONG Desloc Par metros in LONG Desloc Momento de ob
217. itos do cart o 41 Verifica o do cart o e do servi o localmente 42 Decide se a ltima transa o 43 Recupera o do comprovante 44 Decide se consulta parcelas 45 Consulta de parcelas 46 Impress o de consulta 47 Decide de continua a transa o 48 Exibe mensagem de erro 49 Exibe autorizado 50 Decide se coleta vista 51 Decide se coleta o tipo de financiamento ou a quantidade de parcelas 52 Decide se pr datado ou parcelado 53 Decide se coleta se a parcela vista 54 Coleta cart o para resumo de vendas 55 Decide se continua ou termina 56 Exibe continua 57 Exibe fim 58 Coleta o n mero do cheque de entrada 59 Decide se imprime cheque 60 Coleta a quantidade de dias 61 Coleta a quantidade de dias para a primeira parcela 62 Coleta a data para a primeira parcela 63 Carrega os atributos para pr datado 64 Carrega os atributos de parcela com a primeira vista Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 206 OKI 65 Carrega os atributos dos dias entre parcelas 66 Carrega os atributos refer
218. ivo 45 Erro nas chaves de criptografia 46 Erro na parametriza o de trilhas da rede REDE pode indicar falha na inicializa o de tabelas Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 203 OKI 47 Erro na leitura da tarja do cart o Trilhas inconsistentes ou fora do padr o Pode indicar falha de leitura cart o corrompido ou fraudado 48 Falha na configura o da confirma o positiva da rede adquirente GetNetLac 49 Transa o por celular n o habilitada no contrato 50 Transa o por celular exige que a rede habilite transa o digitada 51 A rede est em processo de inicializa o Tente novamente 52 PINPad n o suportado em modo Multi Bandeira Estendido 53 N o representa erro Uso interno em modo Multi Bandeira Estendido 54 Erro de leitura PAN excede tamanho m ximo 55 Erro de leitura Trilha1 excede tamanho m ximo 56 Erro de leitura Trilha2 excede tamanho m ximo 57 Contactless n o habilitado na carga de tabelas 58 Chip Contactless sem dados adicionais pode indicar falha na carga de tabelas 59 Contactless sem produto habilitado na carga de tabelas 60 Excede valor limite definido para Contactless Formatos dos dados Utilizado na coleta do dado a aplica o valida a entrada de dado que o usu rio forneceu de acordo com o c digo do formato do dado recebido
219. l memset aux 0 sizeof aux ScopeObtemCampoExt2 h 0x00040000 0x00800000 0x00 0x00000001 r aux ArmazenaCampo aux exemplo de retorno 002 Mastercard else erro n o conseguiu o handle CUIDADO tente alocar um buffer razoavelmente grande conforme os dados que se deseja A recuperar pois o SCOPE n o alocar buffer Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 149 Fornecendo informa es extras para a transa o OKI Para passar alguma informa o que n o padr o do fluxo da transa o existe a fun o ScopeForneceCampo como meio de passar esses dados S o v rias as informa es que s o recebidas por esta fun o Descri o dos tipos de dados O SCOPE conhece cada tipo de dado pelo valor recebido no primeiro par metro pois cada tipo possui um significado diferente n o tendo rela o entre si Os dados s o esperados no segundo par metro buffer No arquivo ScopeApi h que segue com as bibliotecas do SCOPE Client existe uma enumera o contendo todos os valores que indicam cada tipo de dado cuja declara o SCO SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF SCOF p SCOPI p p SCOPI SCOPI SCOPI SCOPI SCOF m B DA typedef enum DO MIN E DA yoga M A H AG G A A
220. l 0x0001 01 Tecla cancela habilitada 0x0002 02 Tecla pr ximo habilitada 0x0004 04 Tecla retorna habilitada Ele dever ser verificado a cada itera o logo ap s a chamada fun o ver Obtendo os par metros da transa o N LEMBRETE utilizado apenas com a interface coleta A C digos de Fluxo Num determinado momento coletado o dado ou n o a aplica o dever informar ao SCOPE qual a o que ele dever tomar ver Passando o dado da coleta ao SCOPE Client Esta a o est associada s op es que o usu rio pode tomar avan ar para o pr ximo estado retornar para o estado anterior ou cancelar a transa o Cada a o tem um c digo amarrado a ela que se encontra na tabela que segue C digos Formato Hexadeci Decimal Significado mal 0x0000 00 Pr ximo estado 0x0001 01 Estado anterior 0x0002 02 Cancelar 0x0003 03 Erro na coleta de dados N LEMBRETE utilizado apenas com a interface coleta A Estados para interrup o Na tabela abaixo est o relacionados os c digos referentes aos estados de coleta nos quais o SCOPE poder ser suspenso ver Suspendendo a transa o ndice Exit Point 0 Coleta do cart o 1 Coleta da data de validade do cart o 2 Montagem e envio da mensagem 3 Exibi o de mensagens de n o autoriza o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 2
221. l do Desenvolvedor Note que o default se n o executar a fun o acima n o habilitado Neste caso a CIELO n o ir retornar nenhum tipo de pr mio e tudo deve funcionar como antes Tamb m poss vel chamar a mesma fun o dado passando N ou O para deixar o Cielo Premia desabilitado Enquanto n o executado o ScopeClose o SCOPE mant m a informa o se a AC est ou n o participando do Cielo Premia v lida para as pr ximas transa es Tamb m poss vel que a AC defina se participa ou n o do Cielo Premia a cada transa o Assim pode se chamar a ScopeForneceCampo passando SCOPE AUTOMACAO PARTICIPA PPONLINE com SIM ou N O antes de cada ScopeCompraCartaoCredito e ScopeCompraCartaoDebito Para saber se a Cielo premiou com desconto monet rio Tratar o novo c digo de retorno 263 0x107 retornado pela ScopeStatus para indicar que a transa o foi APROVADA COM DESCONTO Caso o retorno da transa o seja 000 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 176 OKI 0x000 indica que a transa o foi APROVADA pode ou n o ter recebido pr mio n o monet rio mas com certeza n o houve desconto Importante notar que ambos os retornos do ScopeStatus 000 e 263 indicam transa o APROVADA N o preciso esperar a finaliza o da transa o para saber se houve ou n o o desconto Normalmente essa informa o necess ria ao receber o cupom de TEF para decidir
222. l do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 156 OKI Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFEO1 65025 SCOPE API n o foi inicializada corretamente ScopeGarantiaDescontoCheque Aciona o SCOPE client para efetuar uma transa o de Garantia de Cheque ou de Desconto Antecipado de Cheque Factoring Prot tipo LONG EXPORT ScopeGarantiaDescontoCheque char Valor Par metros Valor Valor da transa o Deve ser uma string de in String at 12 bytes Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFEOS 65029 API ainda n o fez nenhuma transa o ap s a inicializa o A aplica o est tentando obter um handle sem ter feito nenhuma transa o desde ltima conex o com o ScopeSRV OxFEOD 65037 N o h arquivo com dados da transa o anterior salvo OxFF36 65334 Erro no envio da confirma o ou desfazimento da transa o anterior OxFF3A 65338 Erro interno na execu o da coleta Scop
223. leta Interceptar para uso da pr pria aplica o os dados coletados via digita o para o SCOPE N o interfere na interface gr fica do usu rio Dispon vel para qualquer linguagem e sistema operacional A aplica o deve ter um maior n vel de especializa o portanto maior l gica na integra o Interface HLAPI Esta interface exige um n vel menor de integra o com a aplica o pois toda a coleta de dado realizada pelo SCOPE atrav s de uma pequena janela do pr prio SCOPE que exibida na tela figura 2 Est dispon vel apenas para aplica es MS Windows de 32 bits aplica o HD jejtao SA Popopo popo popopopo pm 2 000 Unidades X R 2 50 Cartao Credito Insira ou Passe o Cartao Figura 2 janela do SCOPE Client na interface HLAPI Caracter sticas da interface HLAPI A coleta realizada pelo SCOPE portanto a aplica o n o sabe o que est sendo coletado Dispon vel apenas para aplica es Win32 Pode tratar perif rico CMC7 impressora etc desde que suportado pelo SCOPE Possui GUI pr pria que no momento da transa o fica aberta sobrepondo a interface da aplica o Padr es adotados neste documento Este documento descreve fun es padronizadas no seguinte formato Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 17 OKI LONG EXPORT ScopeNomedaFuncao argumentos As sess es que descreve
224. lizada quando os Pre os das Mercadorias do Estabelecimento necessitam ser atualizados na rede Ticket Edenred Esta fun o inicia o fluxo de coleta necess rio para a Atualiza o de Pre os das Mercadorias Redes que utilizam esta fun o s o Ticket Edenred Prot tipo LONG EXPORT ScopeAtualizaPrecosMercadorias WORD CodBandeira char UsoFuturol Par metros in WORD CodBandeira C digo da Bandeira Ex 228 Ticket Car lin char UsoFuturol Reservado para uso futuro Usar como par metro uma string vazia Retorno Ver tabela de c digo de retorno Estados de coleta A tabela abaixo mostra os estados de coleta que o fluxo poder retornar no modo coleta C digos Retorno Hexadeci Decimal Significado mal OxFCCA 64714 Coleta da Lista de Atualiza o de Pre os de Mercadorias Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 165 OKI Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFBO1 64257 N o foi poss vel criar a thread na coleta de dados OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFEO5 65029 API ainda n o fez nenhuma transa o ap s
225. m char Item Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 47 OKI Par metros in BYTE Nem ndice do item selecionado Retorno Ver tabela de c digo de retorno O uso destas novas fun es opcional Caso n o utilizadas o tratamento do Menu Din mico ser da mesma forma sem a chamada todos os itens exibidos As configura es relativas ao Menu Din mico existentes hoje no SCOPE INI do ScopeSRV ser o mantidas Caso seja necess rio alterar algum item ou comportamento do menu recomendamos antes entrar em contato com o representante da Cielo para solicitar aprova o das altera es e verificar a necessidade de recertifica o do software de frente de loja Interface HLAPI Sendo o SCOPE respons vel pela coleta de dados a aplica o possui menos trabalho durante a transa o Entretanto ainda s o necess rios 2 outros tratamentos obten o de dados para uso da aplica o e notifica o do SCOPE para impress o do cupom figura 6 Muitas vezes a aplica o necessita controlar a venda e seu meio de pagamento Para aquelas vendas que s o pagas com cart o a aplica o pode manter na informa o da venda alguns dados da TEF para controle de caixa As informa es da TEF que a aplica o poder precisar para esse controle s o v rias O SCOPE Client fornece a fun o ScopeObtemCampoExt para a obten o dos dados da transa o A impres
226. m fluxo de Autoriza o de Servi os Voucher recebendo o c digo de coleta TC COLETA PRODUTO SAV 0xFCD6 a aplica o dever obter a lista de produtos dispon veis atrav s da fun o ScopeRecuperaBufTabela Prot tipo LONG EXPORT ScopeRecuperaBufTabela BYTE TipoTabela char Qtd char ListaBuffer Manual do desenvo SCOPE Solu o Completa para Pagamento Eletr nico 2 27 188 OKI WORD TamLista Descri o finalidade e Esta rotina servir para disponibilizar para a aplica o de automa o comercial uma lista de informa es a serem exibidas na tela para facilitar a sele o da op o desejada e Ela servir para facilitar futuras implementa es que atendam a mesma e O par metro TipoTabela indicar o formato dos dados que ser o fornecidos Par metros out String Qtd Retorna a quantidade de elementos da lista out String ListaBuffer Retorna os registros da lista in WORD TamLista Tamanho em bytes do campo ListaBuffer Retorno Ver tabela de c digo de retorno ID layout Usar estrutura Descri o S ID 2 BUF TAB PRODUTOS SAV stREGISTRO PRODUTOS _SAVS Produtos SAVS Cont m os campos c digo descri o e valores conforme a especifica o do Autorizador Voucher Par metro ListaBuffer A lista formada por registros stREGISTRO_PRODUTOS_SAVS com os seguintes
227. m os argumentos ou par metros das fun es exibir o os mesmos numa tabela cujas linhas representam cada par metro e as colunas indicar o os seguintes dados e 1 coluna par metro de entrada in ou sa da out e 2 coluna tipo de dado que representa o par metro e 3 coluna nome da vari vel representada no par metro e 4 coluna significado do par metro Todos os exemplos de c digos relacionados neste documento est o seguindo a linguagem C com a seguinte formata o int main printf Hello SCOPEN s Programmers Para compatibilidade das fun es entre diversas linguagens e plataformas algumas conven es de tipos devem ser adotadas conforme a tabela a seguir Defini o de Tipo Tipo Tamanho Descri o BYTE 1 byte Valor sem sinal de 0 a 255 WORD 2 bytes Valor sem sinal de 0 a 65 535 SHORT 2 bytes Valor com sinal de 32 768 a 32 767 LONG 4 bytes Valor com sinal de 2 147 483 648 a 2 147 483 647 Analogamente como recurso de portabilidade algumas constantes devem ser criadas e definidas diferentemente em cada plataforma com o objetivo de utilizar os mesmos prot tipos de fun es conforme a tabela a seguir Constantes Tipo Descri o EXPORT Usada nos prot tipos das fun es que s o exportadas CALLBACK Fun o cujo endere o de entrada fornecido a outras fun es de modo que estas possam utilizar internamente da primeira
228. m zeros esquerda Fun es de consulta para recarga de celular O Scope Client n o disponibilizava fun es de consulta a planos de recarga de celular teis para sistemas de retaguarda que desejavam vender pacotes de recarga antecipadamente dentro de um pr pedido Para contornar isso foram adicionadas duas fun es uma para retornar as operadoras e outra para retornar os valores dispon veis para recarga de uma operadora de uma localidade espec fica Obtendo operadoras dispon veis fora do fluxo de recarga Para obter as operadoras dispon veis deve ser feita uma chamada a fun o ScopeObtemOperadorasRecCelOffTEF ela retornar um buffer com as operadoras dispon veis Prot tipo LONG EXPORT ScopeObtemOperadorasRecCelOffTEF BYTE TipoTabela char Buffer WORD TamBuffer Par metros Informa o formato da tabela que a in BYTE _TipoTabela aplica o deseja receber a lista de operadoras Aceita apenas o valor 2 out String _Buffer Buffer com a lista de operadoras Tamanho do buffer anterior previamente in WORD _TamBuffer alocado que deve ser maior ou igual a 2002 bytes Retorno Ver tabela de c digo de retorno Exemplo LONG RC StREC CEL OPERADORAS Lista0Oper 0 StREC CEL ID OPERADORA OPER Obtem as operadoras Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 81 RC ScopeObtem
229. mada se h transa es na sess o de TEF atual OxFF36 65334 Erro no envio da confirma o ou desfazimento da transa o anterior OxFF3A 65338 Erro interno na execu o da coleta OxFF60 65376 Fun o indispon vel OxFF5E 65374 Erro ao desmontar a estrutura ISO Exemplo char valor 12 1 char taxa 12 1 obt m o valor da compra e armazena em valor obt m a taxa de servi o armazena em taxa abre sess o retorno ScopeCompraCartaoCredito valor taxa processa a transa o fecha a sess o Consulta a financiamento de cart o de cr dito Antes de realizar uma compra financiada pela administradora de cart o de cr dito poss vel consulta das parcelas do financiamento A consulta seguir os moldes de uma transa o de compra sendo que em nenhum momento ser efetivada Portanto ap s a consulta necess rio realizar a compra que solicitar os mesmos dados da consulta Prot tipo LONG EXPORT ScopeConsultaCredito char Valor char TxServico Par metros String com o in m ximo de 12 Valor Valor da transa o com a v rgula impl cita exemplo R 123 00 12300 d gitos in String TxServico Valor da taxa de servi o Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal O
230. mal Significado mal OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFBO 0xFBg26 4263 Erro na totaliza o de TEF Exemplo WORD TamCupom char Cupom 2048 encerrando o Dia TamCupom sizeof Cupom if ScopeObtemTotalTEF 0 Cupom TamCupom WNn 0 EnviaCupomParaImpressora Cupom else Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 127 OKI erro ao obter o cupom com o relat rio Dados dos totais A outra maneira que o SCOPE fornece o relat rio para a aplica o por meio de um buffer com os campos de tamanho fixo H 3 tipos de layouts conforme as tabelas abaixo Layout Vers o 1 Tamanho Descri o 3 bytes Identifica o do buffer R01 2 bytes Quantidade de bandeiras retornadas que indica a quantidade de repeti es dos registros abaixo 1 byte Identifica a fun o C Cr dito D D bito H Cheque A CDC 2 bytes C digo da bandeira 17 bytes Descri o da bandeira 14 bytes Valor efetivado 2 casas decimais 14 bytes Valor cancelado 2 casas decimais Layout Vers o 2 Tamanho Descri o 3 bytes Identifica o do buffer R02 3 bytes Quantidade de bandeiras retornadas que indica a quantidade de repeti es dos registros abaixo 3 bytes C digo da bandeira 17 bytes Descri o da bandeir
231. mas de financiamento A Administradora E 0x00000100 Estabelecimento C digo espec fico da consulta AVS 0x00000200 Pontos adquiridos ou resgatados 0x00000400 Fator de compra 0x00000800 NSU do Host da transa o original estornada 0x00001000 Identifica o do cliente PBM junto autorizadora apenas 0x00002000 P Vidalink Mascara z C digo da operadora de celular 0x00004000 C digo de rea DDD 0x00008000 N mero do telefone 0x00010000 ULTRAGAZ dados do ValeG s 0x00020000 C digo IF Institui o Financeira 0x00040000 N mero do item da Fininvest ou Cetelem ou n mero do 0x00080000 contrato CPCHEQUE INSS do IBI Valor da taxa de embarque 0x00100000 Uso exclusivo do SONAE 0x00200000 Informa o contida no bit 124 CDC Orbital 0x00400000 C digo de servi o da transa o original estorno 0x00800000 C digo de barras 0x01000000 Permite desfazimento 0x02000000 Logo do PAN 0x04000000 C digo da Empresa 0x08000000 C digo de Autentica o 0x10000000 Dados do pagamento 0x20000000 UsoRes 63 0x40000000 N mero do PDV 0x80000000 Informa es sobre a quantidade e os e cupons dispon veis ao 0x00000001 cliente Informa o do desconto do resgate monet rio 0x00000002 M scara 3 a sobre a coleta de dados realizada na transa o 0x00000004 Modo de Entrada Entry Mode 0x00000008 Valor do Saque 0x00000010 Resposta da consulta Infocards bit 62 da 0110 0x00000020 Manual do desenvolvedor SCOPE Solu o Completa para
232. meout poder acarretar em n o conformidade AN com o PCI DSS Prot tipo LONG EXPORT ScopeOpen char Modo char Empresa char Filial char PDV Par metros in String constante Modo Modo de opera o igual 2 in String com quatro Empresa C digo de identifica o da empresa conforme d gitos cadastrado no ScopeCNF in String com quatro Filial C digo de identifica o da filial conforme cadastrado d gitos no ScopeCNF in String com tr s PDV N mero do PDV conforme cadastrado no ScopeCNF d gitos Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 29 OKI exit 0 Desconex o printf Erro ao conectar com o SCOPE Server C digos Retorno Hexadeci Decimal Significado mal OxFAO3 64003 Par metro 3 inv lido OxFEO2 65026 SCOPE API j foi inicializada corretamente OxFEO9 65033 Servidor n o configurado no arquivo scope ini Exemplo char empresa 0001 char filial 0001 char pdv 0001 retorno ScopeOpen 2 empresa filial pdv if retorno 0 Erro d retorno Encerra o SC
233. ministrativo C digos dos Servi os Al m dos grupos de servi os o SCOPE trabalha com o conceito de servi os Estes servi os est o na tabela abaixo C digo de Descri o servi o 006 Compra com cart o de d bito vista 009 Compra com cart o de cr dito vista 013 Pr Autoriza o com cart o de cr dito 017 Consulta de cheques a vista Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 221 OKI 018 Consulta de cheques pr datados 020 Compra com cart o de d bito vista for ada 021 Compra com cart o de d bito pr datada 022 Compra com cart o de d bito parcelada sem parcela vista 023 Compra com cart o de d bito parcelada parcela vista 024 Compra com cart o de d bito parcelada parcela vista for ada 027 Compra com cart o de cr dito parcelado pela administradora 028 Compra com cart o de cr dito parcelado pelo estabelecimento 091 Cancelamento de compra de d bito 032 Cancelamento de compra de cr dito 034 Compra CDC CNS 035 Garantia de cheques 036 Desconto de cheques 037 Solicita o de resumo de vendas 039 Compra com cart o de cr dito IATA 040 Compra com cart o de cr dito IATA parcelado com juros 041 Compra com cart o de cr di
234. n veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P0O1 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line 0xFF1D 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFF36 65334 Erro no envio da confirma o ou desfazimento da transa o anterior OxFFFF 65535 Erro gen rico ScopeVersao Esta fun o retorna a vers o do Scope Prot tipo LONG EXPORT ScopeVersao char VersaoScope int TamBufVersao Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 164 OKI Par metros Informa o valor da vers o do Scope em out char VersaoScope formato string e null terminated Em caso o de erro o buffer passado n o sofre altera o Cont m o valor do tamanho da rea que in int TambBufvVersao cont m a vers o Deve conter o valor m nimo de 12 bytes Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido ScopeAtualizaPrecosMercadorias Uti
235. na porta 1 e A os outros dois nas portas 2 e 3 Sess o PINPAD Aqui configura se item relacionado ao tamanho m nimo de dados permitidos para serem lidos pelo PIN Pad Tamanho m nimo de entrada de dados Valor num rico acima de 1 o TamMinDados permitidos pelo PIN Pad padr o 1 CUIDADO Caso o PIN Pad utilize a Biblioteca Compartilhada 1 07 e PCI 2 0 a quantidade A m nima de d gitos permitidos para serem lidos por coleta deve ser 4 d gitos sendo assim TamMinDados deve estar parametrizado com um valor de no m nimo 4 Se o SCOPEAPIPOS Essa se o permite configura es gerais como para habilitar a digita o dos c digos e acrescentar redes e ou bandeiras Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 25 OKI Configura se d a op o de outra rede no n o pergunta se outra rede DigitacaoCodigo ATEN O essa chave ignorada se a pergunta se outra coleta O chave Complementar existir c digo d rede da bandeira Configura se acrescenta rede tabela substitui as tabelas padr o pelas padr o ou as substitui que est o configuradas Complementar ATEN O a exist ncia dessa chave acrescenta a configura o de redes desconsidera a configura o chave e bandeiras que est o no arquivo a DigitacaoCodigo pois ela priorit ria listagem padr o Red Lista de at 7 c digos de redes distintas N meros de at 3 d gitos cada
236. nados na tabela Dados dispon veis das transa es na parte da m scara 3 in char FieldSeparator Caractere de separa o usado quando Masc1 e ou Masc2 forem do tipo bitwise recuperando mais de um campo no mesmo buffer out string Buffer Buffer de destino que conter os dados que o SCOPE retornar Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 148 OKI Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFAOS3 64003 Par metro 3 inv lido OxFAO4 64004 Par metro 4 inv lido OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFEO1 65025 SCOPE API n o foi inicializada corretamente Exemplo long h char aux 128 handle ScopeObtemHandle 0 if handle gt OxFFFF obtendo o nsu da transa o memset aux NO sizeof aux ScopeObtemCampoExt2 h 0x00000004 0x00 0x00 aux ArmazenaCampo aux exemplo de retorno 015236 obtendo o c digo da operadora de celular memset aux NO sizeof aux ScopeObtemCampoExt2 h 0x00 0x00004000 0x00 aux ArmazenaCampo aux exemplo de retorno 02 c digo e nome da bandeira e dados da plataforma promociona
237. naltem para indicar ao SCOPE qual item foi selecionado Desta forma o PDV poder por exemplo e Exibir todos os itens na mesma tela hoje pelo fluxo do SCOPE Client apresentado um item por vez e Excluir algum item da lista que eventualmente n o deva ser exibido ao operador e Alterar a descri o de algum item para melhor entendimento do operador e Fazer a sele o autom tica de um determinado item sem apresent lo ao operador Caso o aplicativo de automa o comercial opte por n o tratar este estado de coleta o SCOPE exibir os itens na forma de menu rotativo Vale ressaltar que este menu somente ser exibido se existir mais que um ramo principal a ser selecionado Caso exista apenas um item o SCOPE assume o automaticamente sem exibir o menu Lista de produtos e ou servi os secundarios Cielo Auto Cada ramo principal poder conter sua pr pria lista de produtos e ou servi os secund rios que atuam como mercadorias para automa o comercial Esta lista ser exibida de acordo com as informa es enviadas na Carga de Tabelas da CIELO e nas informa es habilitadas no chip do cart o Esta lista poder conter as seguintes mercadorias COMBUST VEL Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 181 Gasolina comum Etanol Diesel Gasolina Aditivada Gasolina Premium Etanol Aditivado Diesel S50 Diesel Aditivado GNV m3 Biodiesel OUTROS PRODUTOS E SERVI OS
238. necessitam tratamentos espec ficos pela automa o Basta que mostre a mensagem na tela do operador e aguarde a digita o Quando necess rio est descrito abaixo o tratamento espec fico que a automa o poder fazer ESTADO DE COLETA E DESCRI O TRATAMENTO HEX DECIMAL Exibe menu Obter a lista de op es do menu para a Para essa transa o esse estado exibi o de todas numa nica vez Ver OxFC87 64647 poder ser utilizado para coletar dois t pico espec fico dados diferentes Um para a coleta da rede Outro para a coleta da bandeira Coletar se a transa o a vista ou Padr o OxFCO9 64521 i n o Coletar se a transa o parcelada Padr o OxFCOA 64522 pela administradora ou pelo estabelecimento OxFCOE 64526 Coleta a quantidade de parcelas Padr o OxFC34 64564 Coleta o valor da transa o Padr o OxFCC7 64711 Coleta os 6 primeiros d gitos do cart o Padr o OxFC18 64536 Coleta os 4 ltimos d gitos do cart o Padr o Coleta a data da transa o no formato Padr o OxFC32 64562 DDMMAA OxFCC8 64712 Coleta o campo DOC NSU Padr o OxFC3A 64570 Coleta o campo CV NSU do host Padr o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 134 OKI Coleta o campo AUT c digo de Padr o OxFCC9 64713 e autoriza o Coleta em andamento Aguarda a troca de estado N o solicita OxFCFD 64765 dados ao
239. nforme o padr o descrito obtemos 02 2 campos no buffer 01 este campo representa o que est cadastrado como c digo 1 no ScopeCNF 014 o atributo que seguir cont m 14 bytes 11 6097 1234 valor do atributo de c digo 1 com 14 bytes 02 este campo representa o que est cadastrado como c digo 2 no ScopeCNF 006 o atributo que seguir cont m 6 bytes 123456 valor do atributo de c digo 2 com 6 bytes ScopeGetLastMsg Obt m as ltimas mensagens a serem mostradas para o operador e ou cliente Prot tipo LONG EXPORT ScopeGetLastMsg ptCOLETA MSG ptParamColetaMsg Par metros out Ponteiro para f Estrutura contendo as mensagens do uma rea com o formato da ptParamColetaMsg Operador e do cliente tanto a linha 1 estrutura como a linha 2 As mensagens s o SICOLETA MSG finalizadas pelo caractere nulo 0 Estruturas de apoio char Op1 64 char 0p2 64 char C11 64 char C12 64 typedef struct stCOLETA MSG r r r r StCOLETA MSG ptCOLETA MSG Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFBO1 64257 N o foi poss vel criar a thread na coleta de dados OxFEO1 65025 SCOPE API n o foi inicializada corretamente Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nic
240. nnnnnnnnn nnana 38 Co nfig ra s ge alS aus aaLiasiziasaini iai sosscavanha desbaniso CodiaDa abade doada i aiae ia adaha biaa aaminin aaka iaaa dad sand 38 Configurando em tempo de execu o stit tt tn ttnn ttnn at EnA En AEn AE En annn nn nn unnn nnmnnn ennan nnna 39 Configura o de PIN Pad i asi asas a oi seas cadadha crioagasiondaal ic befas dapunadio de doado Ma maash aro dad aiiai ianiai aanika 40 Validando a interface de PIN Pad oa a a E anna near aa near na near nanas 40 Fun es espec ficas das interfaces nn sn iiseescreeaseecenenaaeacennnaaaa 41 Interface coleta mais casta sasento si EE EEE EA TAa Lado 41 Definindo a interface coleta saziseisnessicorarisararsspstraidelceneadipaenarasj dera ass soaniasfdenaalspocaa a a 41 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 8 Obtendo os par metros da transa o rara naraearea unnn nnna Annn annn aaa aa aaa na nana nana 43 Passando o dado da coleta ao SCOPE Client erre eeeeaeraaaranaaraaaneans 45 interface LAR osia A E a a SS DE A OS O Ea 48 Suspendendo a transa o racer nsaan niana nana aaaera akaaka daenda aiaei kaawa dakianik 48 Retomando aitransa o e adssssssesisxinacassari des T 50 Abortando a transa o 22 2 2 2a css ib iscas soa co aissdidodo no S ces is fg ande dh na das TAN E Soda Nada da PASS deh ab dad p6S due E ea ia fS
241. nte antigo P00 P01 ou P02 OxFEOD 65037 N o h arquivo com dados da transa o anterior salvo OxFBO1 64257 N o foi poss vel criar a thread na coleta de dados OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line 0xFF1D 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFF36 65334 Erro no envio da confirma o ou desfazimento da transa o anterior OxFF3A 65338 Erro interno na execu o da coleta OxFF5E 65374 Erro ao desmontar a estrutura ISO OxFF60 65376 Fun o indispon vel OxFFFF 65535 Erro gen rico ScopeServicoTecnico Utilizada para execu o de um servi o t cnico dispon vel para determinada rede autorizadora Temos os seguintes servi os t cnicos Baixa de OS Teste de Comunica o Estatistica e Inje o de Chaves DUKPT O servi o t cnico de Inje o de Chaves DUKPT insere a senha DUKPT no pinpad atrav s de uma transa o 0900 0800 Inje o de Chaves e sua resposta 0910 0810 quando o pinpad n o possui a senha isto o servi o n o atualiza senha para isso utiliza se a fun o VerificaChaveDUKPT para verificar se o pinpad possu
242. nual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 35 OKI Status de transa o Durante o processamento da transa o a aplica o pode consultar o estado em que a transa o est e tomar alguma a o baseado no valor dela Esta a o pode estar entre uma das situa es abaixo conforme o intervalo de c digos retornado pelo SCOPE Client valor igual O transa o finalizada com sucesso valores entre 3 3h e 92 5B erro de algum par metro passado para o SCOPE valores entre 64001 FAO1 e 64005 FAOS5 erro de algum par metro passado para o SCOPE valores entre 64257 FBO1 e 64267 FBOB erro interno do SCOPE valores entre 64512 FC00 e 64767 FCFF coleta de algum dado necess rio transa o valores entre 65024 FE0O0 e 65535 FFFF erro reportado pelo SCOPE referente transa o Enquanto o SCOPE Client devolver o c digo de status igual a 65024 FEOO a aplica o dever aguardar algum tempo at que outro status seja fornecido Consultando o status A consulta do status da transa o deve ocorrer enquanto uma transa o cart o de cr dito cart o de d bito recarga de celular etc est em processamento Prot tipo LONG EXPORT ScopeStatus void Par metros N o h par metro Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decim
243. nual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 61 OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFOC 65292 Transa o n o implementada OxFFiD 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Exemplo char valor 12 1 char taxa 12 1 obt m o valor da compra e armazena em valor obt m a taxa de servi o armazena em taxa abre sess o retorno ScopeConsultaCDC valor taxa processa a transa o fecha a sess o N LEMBRETE a compra CDC efetuada no fluxo de d bito ou seja dever ser chamada a AT fun o ScopeCompraCartaoDebito para a realiza o de
244. num ricos que representam o valor m nimo do intervalo de valores vari veis com a v rgula impl cita exemplo caso o dado neste campo seja 000000001000 ent o ele est representando o valor R 10 00 ValorMaximo este campo uma cadeia com 12 caracteres num ricos que representam o valor m ximo do intervalo de valores vari veis com a v rgula impl cita exemplo caso o dado neste campo seja 000000001500 ent o ele est representando o valor R 15 00 Totvalor este campo bin rio e indica a quantidade de valores fixos que est o no campo TabValores TabValores cadeia de registros descrita abaixo com todos os valores fixos dispon veis para a recarga desta transa o que embora seja fixo com 10 registros deve se sempre observar a quantidade v lida representada pelo campo anterior MsgPromocional string contendo uma mensagem promocional a ser exibida com os valores de recarga CUIDADO como a estrutura de valores sempre fixa com dez registros de valores e por N esses v rios valores do dom nio do campo de tipo de valor extremamente recomend vel A que a aplica o sempre verifique a quantidade de valores fixos informada pelo campo TotValor dispon veis Como se pode notar pela defini o o campo TabValores do tipo da estrutura stREC_CEL_VALOR descrita abaixo stR typedef struct char Valor 12 char Bonus 12 char Custo 12 EC CEL VALOR ptREC CEL VALOR
245. o a aplica o deve aguardar OxFBO7 64263 Erro na totaliza o de TEF Manual do desenvolvedor Exemplo WORD TamBuffer char Buffer 2048 encerrando o Dia SCOPE Solu o Completa para Pagamento Eletr nico 2 27 129 TamBuffer sizeof Buffer if ScopeObtemDadosTotalTEF 0 Buffer TamBuffer 0 GeraRelatorioEmArquivo Buffer else erro ao obter o cupom com o relat rio CUIDADO Esta fun o somente aceita o layout Vers o 1 A Prot tipo LONG ScopeObtemDadosTotalTEFEx BYTE Versao BYTE Nivel char Buffer WORD TamBuffer Par metros lin BYTE Versao Vers o do layout a ser utilizado 1 2 ou 3 Indica a que n vel dever ser in BYTE Nivel inicializado os totais de TEF 0 PDV 1 Operador out char Buffer Retorna os dados de totais TEF lin WORD TamBuffer Tamanho da rea que a aplica o alocou pela vari vel Buffer Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0xFE00 65024 A transa o em andamento a aplica o deve aguardar OxFBO7 64263 Erro na totaliza o de TEF Exemplo WORD TamBuffer char Buffer 2048 encerrando o Dia TamBuffer sizeof Buffer if ScopeObtemDadosTotalTEFEx 3 0 Buffer TamBuffer 0 Manual do desenvolvedor
246. o par metro pode receber Atributos da aplica o Permite implementar atributos campos dinamicamente que s o vinculados as transa es efetuadas pelo SCOPE Existem tr s m dulos envolvidos por esta funcionalidade e ScopeCNF cadastrando os atributos ver no documento de instala o configura o e administra o informa es sobre cadastramento Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 152 OKI ScopeADM ir exibir as transa es vinculadas aos atributos cadastrados ver o Aplica o do PDV dever usar a fun o ScopeForneceCampo documento de instala o configura o e administra o para informa es sobre relat rio Exemplo voc poder consultar as transa es efetuadas pelo SCOPE vinculadas a outras informa es teis a empresa como n mero da nota fiscal do pedido da compra nome e telefone do cliente etc O formato dos dados deve ser uma string que obedece ao seguinte padr o nnclttlxx x1ic2tt2xx x2cnttnxx xn onde nn quantidade de atributos tamanho 2 c1 c digo do atributo 1 tamanho 2 ttf tamanho do atributo 1 tamanho 3 xx x1 atributo 1 tamanho tt1 c2 c digo do atributo 2 tamanho 2 tt2 tamanho do atributo 2 tamanho 3 xx x2 atributo 2 tamanho tt2 cn c digo do atributo n tamanho 2 ttn tamanho do atributo n tamanho 3 xx xn atributo n tamanho ttn IMPORTANTE por r
247. o 175 Coleta RG 176 Decide retentativa 177 Coleta CPF 178 Coleta endere o 179 Coleta andar 180 Coleta n mero do conjunto 181 Coleta o bloco 182 Coleta o bairro Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 208 OKI 183 Coleta c digo de autoriza o ou cart o 184 Coleta data da emiss o do cart o 185 Coleta o plano Infocards 186 Coleta o n mero do cupom fiscal 187 Coleta a operadora 188 Coleta dados SAB 189 Coleta o n mero do telefone com o d gito verificador 190 Coleta dados da transa o for ada SAB 191 Decide o tipo de servi o t cnico 194 Coleta o n mero da OS 195 Coleta o n mero de identifica o do t cnico 196 Coleta c digo da ocorr ncia 197 Coleta c digo da EPS credenciada 198 Go On Chip 200 Recupera as tabelas de PIN Pad 201 Coleta confirma o positiva 202 Decide se coleta o valor da entrada 203 Decide se coleta o valor da 1 parcela 204 Coleta o valor da 1 parcela 205 Salva servi o escolhido 206 Decide se consulta parcelas ou envia TEF 207 Decide se coleta Chip ou senha 208 Decide se coleta dados adicionais 209 Coleta dados adicionais 210 Decide se carrega bandeira ou consulta op
248. o 2 27 155 OKI ScopeGetCheque Obt m os par metros para impress o de cheque Prot tipo LONG EXPORT ScopeGetCheque ptPARAM CHEQUE ptParamCheque Par metros Ponteiro para uma out o ptParamCheque Dados para impress o do cheque ptPARAM CHEQUE Estruturas de apoio typedef struct stPARAM CHEQUE char Banco 4 n mero do banco char Agencial 5 n mero da ag ncia char NumCheque 13 n mero do cheque char Valor 13 valor do cheque char BomPara 9 data do cheque char CodAut 11 c d de autor retornado pelas autorizadoras char Municipio 41 munic pio short Ordem reservado StPARAM CHEQUE ptPARAM CHEQUE Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE04 65028 N o existe transa o suspensa ScopeAtualizaValor Atualiza ou fornece o novo valor da transa o Esta fun o deve ser executada ap s a fun o de transa o e antes do envio da solicita o de autoriza o para a Autorizadora Prot tipo LONG EXPORT ScopeAtualizaValor char Valor Par metros Valor Valor da transa o Deve ser uma string de lin String at 12 bytes Retorno Ver tabela de c digo de retorno Manua
249. o Eletr nico 2 27 92 OKI Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 93 OKI PBM Medicamentos Aqui trataremos do grupo de fun es que atendem a funcionalidade de PBM Consultando medicamento A fun o ScopeConsultaMedicamento aciona uma transa o no SCOPE para obter uma lista de medicamentos relacionados a uma autoriza o assim como a quantidade autorizada o PMC Pre o M ximo para o Consumidor e o pre o e Pharma para cada um destes O processamento segue a linha de uma transa o qualquer de TEF em que a aplica o deve processar atrav s das chamadas fun o de consulta status ver Status de transa o e coleta de dados O PDV deve esperar pelo estado 64580 para chamar a fun o espec fica e obter a lista de medicamentos ver Lista de medicamentos Lista de medicamentos com CRM e Lista de medicamentos Ex Prot tipo LONG EXPORT ScopeConsultaMedicamento BYTE TipoConvenio BYTE CodigoRede Par metros in BYTE TipoConvenio Tipo do conv nio 0 PBM 1 Empresa in BYTE CodigoRede C digo da rede ver Conv nios Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025
250. o arqu ivo ScopeApi h cuja declara o typedef struct stPARAM COLETA WORD Bandeira WORD FormatoDado WORD HabTeclas char MsgOp1 64 char MsgOp2 64 char MsgC11 64 char MsgC12 64 char WrkKey 16 1 ifdef _ linux char filler endif WORD PosMasterKey char PAN 19 1 BYTE UsaCriptoPinpad BYTE IdModoPagto BYTE AceitaCartaoDigitado char Reservado 105 StPARAM COLETA ptPARAM COLETA A descri o de cada campo encontra se abaixo bandeiras Bandeira a bandeira do cart o relativa opera o em andamento ver C digo das FormatoDado c digo respectivo ao formato do dado a ser coletado ver tabela de c digos em Formato dos dados HabTeclas teclas que est o dispon veis para a aplica o um campo com combina o de bits Exemplo se o campo estiver com o valor 6 2 4 6 significa que as teclas para prosseguir valor 2 e retornar valor 4 a coleta devem estar Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 43 OKI habilitadas desabilitando a tecla cancelar valor 1 ver c digos relacionados na tabela C digo das teclas MsgOp1 mensagem para exibi o na linha 1 do visor do operador string MsgOp2 mensagem para exibi o na linha 2 do visor do operador string MsgCl1 mensagem para exibi o na linha 1 do visor do cliente string MsgCI2 mensagem para exibi o na linha 2 do visor do client
251. o de cart o dinheiro A consulta ao saldo de cart o dinheiro e a respectiva impress o de cupom deve ser feita usando a fun o ScopeConsultaCartaoDinheiro como descrito abaixo Prot tipo LONG EXPORT ScopeConsultaCartaoDinheiro void Par metros N o h par metros Retorno Ver tabela de c digo de retorno Exemplo abre sess o retorno ScopeConsultaCartaoDinheiro processa a transa o fecha a sess o Estornos Tanto para realizar a opera o de estorno de compra carga do cart o dinheiro como a compra usando o cart o dinheiro d bito deve se usar a fun o gen rica de estorno chamada ScopeCancelamento A documenta o desta fun o esta descrita no cap tulo Estorno de transa es Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 67 OKI Fun es de Consulta Neste cap tulo falamos sobre as transa es de consultas que n o se referem aos cart es Cheque Outra funcionalidade que o SCOPE disp e a consulta de cheques no Serasa ou na ACSP Associa o Comercial de S o Paulo Nas consultas de cheques via PDVs as respostas s o baseadas no n mero do documento CPF CGC banco n mero do cheque do comprador valor e data de vencimento da compra O n mero do cheque composto por seis caracteres num ricos por defini o do Banco Central do Brasil com base na resolu o 885 de 22 12 1988 Consulta de cheques A
252. o de entrada como cart o digitado Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 235 Ap ndice G Gloss rio OKI A Acquirer veja Adquirente Adquirente a entidade ou associa o de entidades financeiras que a partir de transa es efetuadas com cart es nos estabelecimentos comerciais Merchant associados estabelece o devido v nculo com as entidades autorizadoras authorizing agent VISA MasterCard Amex Aplica o frente de caixa software executado no PDV com a finalidade de realizar a venda de produtos da empresa Aplica o de PDV veja Aplica o frente de caixa Authorizing agent veja Autorizador Autorizador a organiza o VISA MasterCard Amex que gerencia e controla opera es com cart es de cr dito passando informa es entre o Adquirente e o Banco emissor B Banco de dados tamb m conhecido como base de dados s o arquivos ou sistemas com uma estrutura regular que organizam informa es Essas estruturas podem ter a forma de uma tabela cada tabela composta por linhas e colunas As informa es utilizadas para um mesmo fim s o agrupadas em uma base de dados Bandeira entidade detentora de marcas e logotipos utilizados em cart es de cr dito d bito e outros meios de pagamentos Exemplos Visa Mastercard American Express Visa Electron Maestro Cheque Eletr nico Banco emissor a entidade financeira associada a uma ou mai
253. o desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 50 OKI Hexadeci Decimal mal OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE04 65028 N o existe transa o suspensa Exemplo SCOPE passou o controle para a aplica o suspendendo a transa o A aplica o fez o que desejava ex imprimiu o cupom retorno ScopeResume Abortando a transa o Em certos momentos a transa o n o pode ser conclu da Por problema na impressora desist ncia do cliente etc Enquanto a transa o estiver suspensa caso se deseje cancelar a transa o a aplica o poder continuar a transa o e fechar a sess o solicitando que o SCOPE desfa a a ou simplesmente aborte no ponto em que est suspensa A complica o em desfazer a transa o no momento do encerramento da sess o que todas as transa es ser o desfeitas A fun o ScopeAbort aborta o fluxo de execu o do SCOPE Client suspenso pela fun o ScopeSuspend ou quando o SCOPE Client est aguardando uma a o do aplicativo Prot tipo LONG EXPORT ScopeAbort void Par metros N o h par metro Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFEOO 65024
254. o valor da venda Exemplo char VlOperac 12 1 switch status scope Case 64579 RecebeValorDoOperador amp VlOperac iRet ScopeAtualizaValor VlOperac if iRet RCS SUCESSO Tratar erro break Compra de medicamento Para iniciar uma compra de medicamentos PBM deve se chamar a fun o ScopeCompraMedicamento O comportamento se assemelha consulta de medicamento e tamb m pode retornar no fluxo de coleta o c digo de coleta 64580 para obter a lista de medicamentos Prot tipo LONG EXPORT ScopeCompraMedicamento BYTE TipoConvenio BYTE CodigoRede char NumCpFiscal Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 95 OKI Par metros in BYTE TipoConvenio Tipo do conv nio 0 PBM 1 Empresa in BYTE CodigoRede C digo da rede ver Conv nios out String NumCpFiscal N mero do cupom fiscal para o PDV Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFAOS3 64003 Par metro 3 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de pr
255. obtendo o c digo da operadora de celular 147 else erro memset aux ScopeObtemCampol ArmazenaCampo aux memset aux ScopeObtemCampol ArmazenaCampo aux Prot tipo sizeof aux c digo e nome da bandeira sizeof aux Ext h 0x00040000 n o conseguiu o handle OKI Ext h 0x00 0x00004000 aux exemplo de retorno 02 0x00800000 0x00 aux exemplo de retorno 002 Mastercard LONG EXPORT ScopeObtemCampoExt2 LONG Handle LONG Mascl LONG Masc2 LONG Masc3 char FieldSeparator char Buffer Par metros in LONG Handle Handle da transa o uma refer ncia ao registro contendo os dados da transa o que deve ser um valor retornado pela fun o ScopeObtemHandle in LONG Masci M scara de bits indicando os campos de dados da transa o a serem recuperados que pode ser um valor tipo bitwise Ver bits relacionados na tabela Dados dispon veis das transa es na parte da m scara 1 in LONG Masc2 M scara de bits indicando os campos de dados da transa o a serem recuperados que pode ser um valor tipo bitwise Ver bits relacionados na tabela Dados dispon veis das transa es na parte da m scara 2 in LONG Masc3 M scara de bits indicando os campos de dados da transa o a serem recuperados que pode ser um valor tipo bitwise Ver bits relacio
256. oleta de quantidade a ser resgatada TC CONFIRMA OPCAO RESGATE PREMIO OxFCA2 e IMPORTANTE A quantidade de pr mios n o repassada para a Automa o Comercial A somente exibida no display Existe uma forma de tratar os itens do Menu Din mico pela aplica o de AC Sim Os itens exibidos pela fun o ScopeMenu podem ser manipulados pela AC Para isso existem as fun es e ScopeMenuRecuperaltens e ScopeMenuSelecionaltem Atrav s da fun o ScopeMenuRecuperaltens a AC pode tratar o estado TC EXIBE MENU para obter os itens de forma a exibi los todos de uma s vez ou ent o exibir apenas os que interesse para a Automa o Comercial A sele o tamb m pode ser controlada atrav s da ScopeMenuSelecionaltem A Automa o Comercial pode usar essa fun o ap s a sele o do operador de caixa ou ainda selecionar um item de forma autom tica sem exibir a lista ao operador Existe um c digo exemplo Sim Um c digo em C de exemplo TstColeta acompanha este documento Qual a vers o m nima do SCOPE que contempla Cielo Premia A vers o m nima 2 27 23 02 server e client embora o recomend vel seja o uso da vers o mais recente Cielo Auto Esta transa o efetuada com cart es do tipo voucher que permitem o pagamento do abastecimento de combust vel e outros servi os prestados aos ve culos automotivos em estabelecimentos como postos de gasolina Na especifica o CIELO Release 2014
257. olu o Completa para Pagamento Eletr nico 2 27 211 OKI C digos Rede Significado C digo SAT Decimal Decimal 30 SAB 999 31 E Pharma 999 32 Vidalink 999 33 PrevSa de 999 34 Hipercard 19 35 Interchange 999 36 Tecban especifica o 2 0 31 37 Nutricash 999 38 Losango 999 39 GoodCard 999 40 Cetelem 11 41 B nus 999 42 American Express AMEX especifica o 01 3 43 Banco do Brasil GCB 999 44 Sonae 999 45 Incomm reutiliza o do c digo da rede BankBoston 999 46 Portal Card 999 47 Valecard 999 48 Telenet 999 49 Evang lico 999 50 Funcional Card 18 51 Ediguay 999 52 CheckCheck 999 53 Banktec 999 54 Big 999 55 Big Card 8 56 SuperCard 999 57 Banese 999 58 TR Centre 999 59 TRN Card 999 60 Infocards 999 61 Valecash 999 62 Premium 999 63 CredSystem 999 64 Redecard especifica o L02 05 25 65 E Capture 999 66 Check Express 999 67 Conductor 999 68 ChequePre 999 69 Visanet 4 1 999 70 American Express especifica o 03 00 3 71 ECX Card 14 72 Ultragaz 999 73 GetNet 999 74 CentralCard 999 75 Orbitall 999 76 Recarga de Celular especifica o Itautec 999 77 IBI 999 78 DATASUS 999 79 Comprocard 999 80 Framaseg 999 81 Intellisys 999 82 Somar 999 83 Solucard 999 84 Obo 999 85 Da Casa 999 Manual do desenvolvedor SCO
258. onex o entre a aplica o e o Scope Cliente ScopeOpen e SCOPE COD TABELA PARCELE MAIS ID 18 Automa o pode fornecer um c digo de tabela a ser usado na transa o de Parcele Mais indicando o custo financeiro e SCOPE DADOS PAGAMENTO EX ID 19 dados do pagamento para transa es que necessitam do n mero do cart o confronte com SCOPE DADOS PAGAMENTO e SCOPE AUTOMACAO PARTICIPA PPONLINE ID 20 respons vel por informar se a automa o comercial est apta a trabalhar com a plataforma promocional e SCOPE PERMITIR SAQUE ID 21 em transa es de d bito vista com a rede Cielo ao fornecer o valor 1 indicar que o SCOPE pode pedir a digita o do valor do saque se configurado pela rede e ao fornecer 0 o SCOPE n o perguntar pelo saque mesmo configurado pela rede Cielo e no SCOPECNF e SCOPE RESULTADO VALIDACAO ID 22 ap s a valida o do saque pela automa o est passar o valor 1 aprovando o valor do saque digitado pelo portador do cart o no pinpad ou passar o valor 0 recusando o valor do saque solicitado e SCOPE DADOS ECF BENEFICIO ID 23 fornecer os dados da ECF e do comprovante para a transa o e SCOPE DADOS LISTA PRECOS ID 26 fornecer os dados da Lista de Atualiza o de Pre os das Mercadorias e SCOPE DADOS LISTA MERCADORIAS ID 27 fornecer os dados da Lista de Mercadorias Consumidas na Aplica o e SCOPE DADO MAX ID 29 limite superior do dom nio de valores que o primeir
259. onus Indica o valor do b nus que o cliente receber ao escolher a faixa e Custo Indica o custo da recarga Prot tipo LONG EXPORT ScopeRecuperaValoresRecCel BYTE TpTab char buffer WORD TamBuf Par metros Informa o formato da tabela que a in BYTE TpTab aplica o deseja receber a lista de operadoras Aceita apenas o valor 2 Buffer com a lista de valores de recarga out String Buffer dispon veis Tamanho do array buffer segundo in WORD TamBuf par metro alocado que deve ser igual a 427 bytes Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFAOS3 64003 Par metro 3 inv lido Exemplo StREC CEL VALORES tabVal ob switc ca E t m status do SCOPI h status scope se 64558 ScopeRecuperaValoresRecCel 2 char amp tabVal sizeof buffer Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 80 OKI ApresentaValoresAoOperador tabVal Obt m o valor de recarga escolhido pelo cliente break passa a informa o coletada para o SCOPE CUIDADO os campos de valores representados nas estruturas de recarga n o s o strings N terminadas com o caractere nulo mas s o cadeias de caracteres de tamanho fixo igual a 12 A co
260. ormato obedece tabela conforme a especifica o da PharmaSystem Posi o Formato Descri o 01 a 06 String C digo do Projeto 07 a 36 String Descri o do Projeto 37 a 56 String Operadora do Projeto Elegibilidade do Cart o PBM Para iniciar uma compra de medicamentos PDM sem a exist ncia de uma autoriza o previamente fornecida por uma aplica o de balc o de farm cia deve se chamar a fun o ScopeElegibilidadeCartao que far a valida o dos dados do cliente que deseja efetuar a compra Essa fun o suporta a bandeira PharmaSystem Prot tipo LONG EXPORT ScopeElegibilidadeCartao BYTE _TipoConvenio Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 102 OKI BYTE CodRede char NumCpFiscal Par metros in BYTE TipoConvenio Tipo do conv nio 0 PBM 1 Empresa in BYTE CodRede C digo da rede ver Conv nios Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros abre sess o retorno Scop Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 103 fecha a sess o C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve agu
261. ornado quando a aplica o passa o caractere H como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Exemplo char valor 12 1 char taxa 12 1 obt m o valor da compra e armazena em valor obt m a taxa de servi o armazena em taxa abre sess o retorno ScopeCancelamento valor taxa processa o cancelamento fecha a sess o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 85 OKI Comprovantes Comprovantes de transa es Qualquer transa o realizada com sucesso e com algum tipo de comprovante para a impress o deve ser obtido pela fun o ScopeGetCupomEx IMPORTANTE quando a aplica o utiliza a interface HLAPI ela sempre deve chamar a A fun o ScopeSuspend passando como par metro o valor inteiro 4 ver Suspendendo a transa o Obtendo os cupons de TEF Durante o processamento de uma transa o a aplica o
262. os C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 69 OKI OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFFOC 65292 Transa o n o implementada OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server 0xFE08 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere H como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBO3 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Exemplo abre sess o Manual do desenvolvedor processa a transa o fecha a sess o retorno ScopeConsultaAVS SCOPE Solu o Completa para Pagamento Eletr nico 2 27 70
263. otocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Exemplo BYTE TipoConvenio CodigoRede char NumCpFiscal abre sess o coleta o tipo do conv nio o c digo da rede e o n mero do cupom fiscal retorno ScopeCompraMedicamento TipoConvenio CodigoRede NumCpFiscal processa a transa o fecha a sess o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 96 OKI A mudan a para o layout 5 conforme descrito no documento Scope PBM Vers o Funcionamento a partir do layout 5 1 10 doc trouxe mudan as significativas no funcionamento da compra de medicamentos Para realizar uma compra de medicamentos preciso obrigatoriamente ter feito uma consulta de medicamentos antes e estar
264. para o SCOPE possui um significado que podem ser combinados de qualquer maneira A rela o completa de campos e os bits que representam estes campos podem ser encontrados na se o Dados dispon veis das transa es Para casos em que a aplica o solicitar v rios dados o SCOPE os retornar num nico buffer separado por um caractere separador que a aplica o passar para o SCOPE usar Mesmo que a aplica o solicitar um dado que n o exista na transa o o SCOPE separar o campo em que estaria o dado com o caractere separador A sequ ncia dos dados que ser o devolvidos para a aplica o ser a partir da m scara 1 depois para a m scara 2 e logo depois para a m scara 3 na sequ ncia do bit menos significativo para o mais significativo importante observar que a m scara 3 somente pode ser obtida atrav s da fun o ScopeObtemCampoExt2 juntamente com as m scaras 1 e 2 Prot tipo LONG EXPORT ScopeObtemCampoExt LONG Handle LONG Mascl LONG Masc2 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 146 OKI char FieldSeparator char Buffer Par metros in LONG Handle Handle da transa o uma refer ncia ao registro contendo os dados da transa o que deve ser um valor retornado pela fun o ScopeObtemHandle in LONG Masci M scara de bits indicando os campos de dados da transa o a serem recuperados que pode ser um valor
265. peCompraCartaoDebito para a realiza o dessa compra Quando configurada na inicializa o da Cielo tabela 7C de Produtos o SCOPE ir exibir um menu de sele o por exemplo D bito ou Credi rio Se selecionado D bito o SCOPE seguir o fluxo convencional de D bito Se selecionado Credi rio o SCOPE seguir o fluxo espec fico desta transa o Consulta a saldo de cart o de d bito Um dos motivos que uma transa o pode n o ser aprovada a falta de saldo suficiente do cliente no cart o de d bito Alguns cart es permitem esta consulta Prot tipo LONG EXPORT ScopeConsultaSaldoDebito char Valor Par metros String com o gt F O E Pa Valor da transa o com a v rgula impl cita in e dela Valor exemplo R 123 00 12300 Retorno Ver tabela de c digo de retorno Exemplo char valor 12 1 abre sess o fecha a sess o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 obt m o valor da compra e armazena em processa a transa o valor retorno ScopeConsultaSaldoDebito valor 64 OKI Cart o Dinheiro S o cart es ao portador protegido por senha semelhante ao cart o de d bito que adquirido comprado com um valor fixo e posteriormente pode ser recarregado utilizado principalmente para efetuar compras debitando esse valor do saldo do cart o cujo objetivo
266. pleta para Pagamento Eletr nico 2 27 65 OKI obt m o valor da compra e armazena em valor abre sess o retorno ScopeCartaoDinheiro servico valor processa a transa o fecha a sess o Compra usando o cart o dinheiro d bito Para realizar a opera o compra usando o cart o dinheiro isto debitar o valor da compra do saldo dispon vel pode ser feito de duas formas 1 Usar a fun o ScopeCompraCartaoDebito como se fosse um cart o de d bito normal vide item Compra com cart o de d bito 2 Usar a fun o ScopeCartaoDinheiro como descrito abaixo Como as outras transa es o fluxo de processamento similar Prot tipo LONG EXPORT ScopeCartaoDinheiro WORD servico char Valor Par metros Para efetuar a opera o de Compra Carga in WORD Servico de cart o dinheiro usar o servi o 98 S COMPRA CARTAO DINHEIRO lin o Ja Valor Valor da transa o com a v rgula impl cita d gitos exemplo R 123 00 12300 Retorno Ver tabela de c digo de retorno Exemplo Long servico S COMPRA CARTAO DINHEIRO valor de 98 char valor 12 1 obt m o valor da compra e armazena em valor abre sess o retorno ScopeCartaoDinheiro servico valor processa a transa o fecha a sess o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 66 Consulta ao sald
267. r nesse s o mapeados os campos de cupons da rede REDECARD com as constantes da fun o ScopeobtemCampol Ext2 do SCOPE Client e os campos do registro do arquivo de concilia o Na transa o POS o cupom utilizado dever ser a via do estabelecimento Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 141 REDECARD Debit ERROU o iI Kas AUTO a Ee N IV IL TAT ANDAI VIS 4 4 RE pl Ju 4 1 Figura 9 cupom da rede REDECARD Seguindo o exemplo do cupom de uma transa o da REDECARD da Figura 9 os campos ser o mapeados da forma conforme tabela OKI ARQUIVO CONCILIA O FUN O ScopeObtemCampoExt2 CUPOM DESCRI O POS TAM TIPO COMENT RIOS M SCARA 1 M SCARA 2 M SCARA 3 CAMPO Tipo de registro 1 1 N Constante 1 NA NA NA NA C digo do E A a Numero do PV 2 15 N Estabelecimento 0x00000800 NA NA NA Data da venda a Data da venda 17 8 D YYYYMMDD NA 0x00000008 NA Data NSU 25 6 A da seq encial 0x00000004 NA NA NA NSU do Host 31 15 A NSU complementar 0x00004000 NA NA CV C digo de 41 14 A C digo de 0x00000100 NA NA AUTO autoriza o autoriza o Valor da E TOT compra 51 15 2 N Valor da opera o 0x00000002 NA NA APROVADO 6 primeiros opcionais e 4 Ro 66 22 A N mero do cart o 0x00000001 NA NA ltimos obrigat rios d gitos do cart o Transa es OK
268. r do cart o ao pagar sua compra na loja com um dos cart es o funcion rio da loja encaminha o para o sistema que vai fazer o pagamento Uma vez paga o funcion rio poder registrar essa venda no PDV para a futura concilia o com a rede autorizadora Os dados da transa o ser o retornados para a automa o comercial pela fun o ScopeObtemCampoExt2 Assim esses dados poder o ser gravados em arquivo e exportados posteriormente para o m dulo SCOPECon Em outras palavras os dados da transa o para a concilia o n o feita pelo SCOPE de responsabilidade da automa o comercial a gera o do arquivo com os dados da transa o A participa o do SCOPE nesse processo est em dois momentos 1 A coleta dos dados do cupom pelo SCOPE Client para que a automa o tenha os dados para o arquivo Nessa situa o o SCOPE serve apenas como um guia ao operador para solicitar as informa es do cupom No final da coleta a automa o solicitar ao SCOPE Client tais dados para o arquivo 2 A concilia o da transa o pelo SCOPECon O arquivo gerado pela automa o comercial ser importado por esse m dulo Transa o POS Essa fun o inicia um fluxo padr o de coleta do SCOPE para coletar as informa es necess rias para que a automa o comercial gere um registro do arquivo de concilia o que este seja Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 132 OKI futurament
269. ra o com o SCOPE Client rara aeeenarea near aaa arenas 16 Intertace Coletal E A A re casilcoraa adia credadaa SEE ca dia cede N A ada doadas di paga dia paga dal rien le 16 menace ALAP czssaasrassaaooizas odagesdtn gaas de don EA SG DE gas ds Don aaa SON agas ds Don gaaD6 pipas do Deusas uadid as do heads So podas Gde nda tan pps dados 17 Padr es adotados neste documento anan naa Sa EAEAN A Nani AAEE a 17 Legenda de Abrevia es E a 19 INSIAla O sauanisusasasoinsiaiavatadenica ricos iaaaaiaidsa dao A a c a aa 20 Instala o do SCOPE Client para MS Windows eee ereta 20 Instala o do SCOPE Client para Linux reecare arara aaarnananaaaaraa near nanaaaaaaneanas 20 CONQUra O auiaassniasianiiaadidnadisecaiiindanasiasa aaaea anaa eRe usina das nada can none ada cana 22 Configura o do arquivo scope ini ii carra arara nanaaareaaaar aa aaaa ana aanaa ra aaaa anna nanaaa 22 Sess o lt empresa gt lt filial gt ira aaaarananaaaaera near aa nana aaa anar aa aaar anna anana aa 22 Sess o SCOPEAPI usa itiningin nnna c aaa Ros adia padio Eta da das Hand aa aaiding arado 24 Sess o PROOMP c zazwissstasteaitas seit tese dertkn urni iadi Gunn das itia aaaeaii idaan Sa Randstad ga da 24 Configura o de porta serial para Linux ar ereecarea arara aaaana na eeaaar aa aaar aa naaaananaaa 24 Sess o PINPAD ca massassi ias rsantio nos isola nao La
270. ra ISO Exemplo char valor 12 1 char taxa 12 1 obt m o valor da compra e armazena em valor obt m a taxa de servi o armazena em taxa abre sess o retorno ScopePreAutorizacaoCredito valor taxa processa a transa o fecha a sess o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 58 Cart o de d bito OKI Abrangendo diversos servi os como o cart o de d bito uma das transa es mais realizadas nos estabelecimentos Falando em servi os nos referimos a d bito vista d bito pr datado d bito parcelado com a 1 parcela agendada ou vista d bito Voucher saque e CDC Compra com cart o de d bito Para os servi os de d bito vista d bito pr datado d bito parcelado com a 1 parcela agendada ou vista e d bito Voucher deve se utilizar a fun o ScopeCompraCartaoDebito Como as outras transa es o fluxo de processamento similar Prot tipo LONG EXPORT ScopeCompraCartaoDebito char Valor Par metros String com o in m ximo de 12 d gitos Valor Valor da transa o com a v rgula impl cita exemplo R 123 00 12300 Retorno Ver tabela de c digo de retorno Estados de coleta A tabela abaixo mostra os estados de coleta que o fluxo poder retornar no modo coleta
271. ra parcela OxFC7C 64636 Coleta os dados adicionais OxFC7D 64637 Coleta se cancela ou n o a transa o OxFC7E 64638 Go On Chip OxFC7F 64639 Retira o cart o OxFC80 64640 Coleta o valor da taxa de embarque OxFC81 64641 Exibe a mensagem de saldo OxFC82 64642 Exibir a mensagem e retorna o fluxo n o mais utilizado OxFC83 64643 Exibir a mensagem aguarda confirma o do operador n o mais utilizado OxFC84 64644 Obt m os servi os OxFC85 64645 Coleta o cart o digitado OxFC86 64646 Coleta o c digo do produto OxFC87 64647 Exibe o menu OxFC88 64648 Coleta se INSS ou cheque OxFC89 64649 Coleta o contrato OxFC8A 64650 Coleta a data quando o cliente aderiu ao cart o OxFC8B 64651 Exibir o valor da consulta Vale G s OxFC8C 64652 Coleta data da transa o original no formato DDMMAA OxFC8D 64653 Coleta o NSU da transa o original n mero de 6 d gitos OxFC8E 64654 Exibir os dados do cancelamento n o mais utilizado OxFC8F 64655 Coletar qual a via da reimpress o 0 todas as vias 1 apenas da loja 2 apenas do cliente OxFC90 64656 Coleta o DDD no PINPad OxFC91 64657 Coleta o n mero de telefone no PINPad OxFC92 64658 Coleta o n mero de telefone com o d gito verificador no PINPad OxFC93 64659 Coleta a redigita o da recarga no PINPad OxFC94 64660 Transa o aprovada parcial OxFC95 64661 Coleta o valor das parc
272. rede SAVS trabalha com Carga de Tabelas algumas coletas podem ocorrer ou n o de acordo com a configura o enviada ao SCOPE na Inicializa o de Tabelas O SCOPE seleciona internamente o fluxo de coleta de acordo com a configura o enviada pela rede Autorizadora Para facilitar o entendimento seguem as coletas afetadas pela parametriza o da Carga de Tabelas e a descri o dos Estados de Coleta que ser o desviados pelo SCOPE e Parametriza o de Fornecedor De acordo com a parametriza o do Fornecedor selecionado as coletas solicitadas est o descritas na tabela a seguir e Coleta de Fornecedor Seleciona automaticamente Quantidade de o nico Fornecedor dispon vel e pula para Fornecedores Coleta de Produto Dispon veis no TC COLETA PRODUTO SAV 0xFCD6 Segmento Selecionado Coleta de Fornecedor Estado TC COLETA FORNECEDOR SAV 0xFCD5 e Coleta de c digos valor quantidade e Cliente Preferencial Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 185 Par metro da Carga Coleta C digo do Produto Estado TC COLETA PRODUTO SAV 0xFCD6 o Valor Estado TC COLETA VALOR 0xFC34 ou TC INFO AGU CONF OP OxFCFF Quantidade Estado TC COLETA QUANTIDADE 0xFCD7 C digo EAN Estado TC COLETA PRODUTO SAV 0xFCD6 Valor EstadoTC COLETA VALOR 0xFC34 ou TC INFO AGU CONF OP 0xFCFF C digo do Produto Estado TC COLETA PRODUTO SAV
273. rga para o valor 8 12 bytes Custo da recarga para o valor 8 12 bytes Valor fixo 9 da recarga com 2 casas decimais 12 bytes B nus da recarga para o valor 9 12 bytes Custo da recarga para o valor 9 12 bytes Valor fixo 10 da recarga com 2 casas decimais 12 bytes B nus da recarga para o valor 10 12 bytes Custo da recarga para o valor 10 41 bytes Mensagem promocional a ser exibida com os valores Estruturas de apoio Definidas no arquivo de cabe alho ScopeApi h est o as estruturas abaixo que s o utilizadas para o recebimento do buffer de valores A primeira delas typedef struct char TipoValor char ValorMinimo 12 char ValorMaximo 12 char Totvalor stREC CEL VALOR TabValores 10 char MsgPromocional 41 StREC CEL VALORES ptREC CEL VALORES onde Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 77 OKI TipoValor caractere que representa o tipo de valor permitido para a operadora e que define quais valores ser o exibidos O dom nio de valores para este campo o V valor vari vel entre o que est indicado no campo ValorMinimo e ValorMaximo desta mesma estrutura o F valores fixos que est o no campo TabValores o T dispon vel tanto o valor vari vel quanto o fixo ValorMinimo este campo uma cadeia com 12 caracteres
274. rial No entanto para ambiente Linux poss vel conectar um PIN Pad serial numa porta USB utilizando um conversor Serial gt USB Normalmente os drivers existentes para esse conversor criam dispositivos em dev nomeados ttyUSBx ao inv s dos ttySx Para o redirecionamento da porta de comunica o no SCOPE existem duas chaves a serem colocadas no arquivo scope ini configuradas conforme tabela abaixo Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 24 OKI SerialNumPorts N mero de portas a ser configuradas Valor entre 1 e 6 o padr o 6 Dispositivo com novo direcionamento para a SerialPortx Valores de 0 a 5 porta x 1 LEMBRETE a configura o pode ser alternada entre as diversas portas Exemplo suponhamos que possu mos 3 equipamentos seriais mas o computador que rodar a aplica o possui uma porta serial e duas USB Ser necess rio que dois equipamentos utilizem conversores Serial gt USB que ao serem conectados s o criados dois novos dispositivos ttyUSBO e ttyUSB1 os n meros terminais O e 1 podem variar Portanto em algum ponto do arquivo scope ini deve ser colocado a configura o abaixo para atender esta m quina SerialNumPorts 3 SerialPort0 dev ttySO porco serial SerialPortl dev ttyUSBO p porta 2 USB SerialPort2 dev ttyUSB1 7 porca SUS CUIDADO de acordo com a configura o acima conectamos um equipamento
275. ring CupomLoja via da loja que sempre estar dispon vel para a aplica o Tamanho reservado pelo aplicativo para in WORD CupomReduzLen receber o cupom reduzido Ponteiro para rea onde ser recebida a via cupom reduzido que poder substituir a out String CupomReduz via do cliente e que em alguns casos esta via pode n o estar dispon vel para a aplica o N mero de linhas que tem o cupom out WORD NroLinhasReduz reduzido Se o valor for zero n o h cupom reduzido dispon vel IMPORTANTE Os finalizadores de linha dos cupons retornados pela fun o ScopeGetCupomEx est o de acordo com a parametriza o do ScopeForneceCampo SCOPE DADO SEPARADOR LINHA Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE04 65028 N o existe transa o suspensa OxFF12 65298 Area reservada para o buffer insuficiente para o SCOPE Client x os dados solicitados Exemplo BYTE NroLnhReduzido 0 char Cabec 1024 CpCliente 2048 CpLoja 2048 CpReduzido 2048 LONG retorno obt m status do SCOPE switch status scope case 64582 case 64514 case 64539 case 64546 case 64593 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 87 OKI memset C
276. rmato DDMMAA 106 Decis o pr via do servi o 107 Decis o pr via do servi o de consulta 108 Decis o pr via do servi o de extrato 109 Decide se haver saque 110 Decide se haver simula o de saque 111 Decide se saldo ou extrato 112 Decide o extrato resumido ou segunda via 113 Decide se coleta valor 114 Coleta valor 116 Decide se coleta a quantidade de parcelas 117 Valida dados 118 Exibe mensagem de erro 119 Coleta se quer consultar ou resgatar 120 Decis o pr via do servi o de resgate 121 Coleta se resgate avulso 122 Desfazimento de risco pr datado 123 Decide se coleta data no formato DDMMAAAA 124 Coleta data no formato DDMMAAAA Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 207 OKI 125 Verifica mensagem de advert ncia 126 Exibe mensagem 127 Coleta c digo de autoriza o de medicamento 128 Coleta registro de medicamento 129 Obt m lista de medicamentos 130 Imprime cupom parcial 131 Coleta a quantidade de parcelas e aceita 1 parcela 132 Coleta o c digo de barras 133 Decide se coleta vencimento 134 Coleta vencimento 135 Coleta o c digo de consulta PBM 136 Coleta medicamento se receita 137 Coleta CRM do
277. rme exemplo abaixo VISA BANDEIRA MASTERCARD CARTAO DE CREDITO EFETUADO CANCELADO 167 00 0 00 564 80 0 00 CART O DE DEBITO EFETUADO CANCELADO ETRONIC 1650 00 0 00 18 00 4 00 CARTAO DE DEBITO CDC EFETUADO CANCELADO Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 126 OKI CONSULTA CHEQUE BANDEIRA CONSULTADO CUIDADO O valor efetuado cont m o valor cancelado Assim no exemplo anterior a A bandeira Electron indica uma receita de R 14 00 R 18 00 R 4 00 para a loja Prot tipo LONG ScopeObtemTotalTEF BYTE Nivel char Cupom WORD TamCupom char SeparadorLinhasCupom Par metros Indica a que n vel dever ser in BYTE Nivel inicializado os totais de TEF 0 PDV 1 operador out String Cupom Cupom com o relat rio de totais de TEF por bandeira lin WORD TamCupom Tamanho da rea que a aplica o alocou pela vari vel Cupom Caractere a ser usado na separa o das linhas do cupom Atualmente in char SeparadorLinhasCupom suporta apenas o caractere Q Para qualquer outro caractere ser utilizado Am Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Deci
278. ro ao desmontar a estrutura ISO Exemplo BYTE TipoConvenio CodigoRede coleta o tipo do conv nio o c digo da rede Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 104 processa a transa o fecha a sess o OKI retorno ScopePreAutorizacaoMedicamento TipoConvenio CodigoRede Cancelamento de Pre Autorizacao de Medicamentos PBM Para cancelar um produto da lista dos produtos autorizados deve se chamar a fun o ScopeCancelaPreAutMedicamento que excluir o produto e a quantidade da lista de produtos A fun o pode retornar no fluxo de coleta o c digo de coleta 64579 para fornecer a lista de medicamentos e o c digo de coleta 64580 para obter a lista de medicamentos Essa fun o suporta a bandeira PharmaSystem Prot tipo LONG EXPORT ScopeCancelaPreAutMedicamento Par metros in BYTE TipoConvenio Tipo do conv nio 0 PBM 1 Empresa in BYTE CodRede C digo da rede ver Conv nios Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFEO6 65030 Logon duplicado OxFEO7
279. rot tipo LONG EXPORT ScopePreAutorizacaoMedicamento BYTE TipoConvenio BYTE CodRede char NumCpFiscal Par metros in BYTE TipoConvenio Tipo do conv nio 0 PBM 1 Empresa in BYTE CodRede C digo da rede ver Conv nios Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros abre sess o C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFAO2 64002 Par metro 2 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEOS 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFFF 65535 Erro gen rico OxFF5E 65374 Er
280. rros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFEO5 65029 API ainda n o fez nenhuma transa o ap s a inicializa o A aplica o est tentando obter um handle sem ter feito nenhuma transa o desde ltima conex o com o ScopeSRV OxFE06 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFEOD 65037 N o h arquivo com dados da transa o anterior salvo OxFBO1 64257 N o foi poss vel criar a thread na coleta de dados OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line 0xFF1D 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser cham
281. rs o do SCOPE Client s 231 Verificando no SCOPE Server irc err aaarraaaaaaa nara aaar aa aaaa aan aaaaanra near anna annaaanas 231 Verificando no ambiente do PDV erre RTS aaa near aaa nana aaa aaaraa aa acanaaa 232 SCOPE Client para MS WindowsO errar ceeeaaaeaa nana renan anne nn nanten tennan annene 232 SCOPE Client para LiNUX ssaczmagaaszasdorersa rs srinisco a Aa aaa Aaa aa Aaaa ENEE aca 233 Ap ndice F Formato do C digo de Barras InComm ss seen 235 Ap ndice G Glossari uai anna ad ad Sadia usadas acabadas adac adas 236 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 12 OKI Pref cio A quem se destina O manual do integrador destina se aqueles que desenvolvem aplica o em que necess rio efetuar transa es com autorizadoras banco etc e para isso utilizar o o SCOPE como concentrador de TEF Requisitos Plataformas Compat veis Todos os m dulos da solu o SCOPE s o compat veis com as plataformas Windows 7 e Windows Server 2008 O m dulo SCOPE Client al m das plataformas acima tamb m compat vel com a plataforma Linux Librix RedHat SUSE e outros Requisitos de HW e PC com processador de 1 GHz ou mais de velocidade e 512 megabytes MB de RAM ou mais s o recomendados e 1 gigabyte GB de espa o dispon vel em disco r gido ou mais s o recomendados Requisitos de SW Banco
282. s o de cupons outro ponto de aten o que a aplica o deve tratar para compensar este tipo de interface Uma vez que na interface HLAPI o SCOPE Client coleta todos os dados e a aplica o n o t m conhecimento do que ele est fazendo num determinado momento ela deve pedir para o SCOPE suspender a transa o para que o cupom seja impresso Uma vez suspensa a aplica o obt m os cupons imprime os e informa ao SCOPE que ele poder continuar ou at mesmo cancelar a transa o Suspendendo a transa o A aplica o deve fazer isso ao menos uma vez na interface HLAPI antes de cada transa o A aplica o poder solicitar ao SCOPE Client para que ele suspenda em diversos momentos Mas ao menos uma vez porque primordial que a transa o esteja suspensa para imprimir o cupom Existem diversos c digos representando pontos ou estados de coleta em que o SCOPE Client pode suspender a transa o sendo feitos com a fun o ScopeSuspend Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 48 OKI ScopeAbreSessaoTEF O operador de selecionar a transa o a ser realizada Escolhe a transa o ScopeGetCupomEx Imprime cheque 0xFC08 Transa o em andamento 0xFE00 Imprime cupons 0xFC02 Figura 7 fluxo de processamento de uma transa o com a interface HLAPI Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 49 OKI
283. s o do SCOPE Client deseja se consultar e clicar no bot o PDV lt empresa gt lt filial gt lt PDV gt Eswesme TT as Score DRE DR AE e GATEWAY EM VMXPSP3 192 168 125 238 ON Copyright 1997 2010 Itautec m PDV s m Contratos Emp Filial Pdv Svc Hdw Status Address Emp Filial Contrato Status Rede 0001 0001 001 001 001 PDY OFF e 0001 0001 002 001 002 PDV OFF 0001 0001 000100010000002 AUT OK GETNET 6 0 e 0001 0001 003 001 003 PDV OFF lt gt 0001 0001 000100010000007 Gw ON SERASA e 0001 0001 004 001 001 PDY OFF 0001 0001 000100010000036 AUT OK TECBAN 2 0 gt RES 0001 0001 000100010000001 AUT OK SAB ep 0001 0001 005 001 001 PDV OFF 0001 0001 064064064064064 AUT OK REDECARD L0205 0001 0001 123456780000000 Gw ON VISANET 4 1 13 04 13 07 02 000009FO Kernel ScopeSry pronto para receber conex es diretas 13 04 13 07 01 000009FO Kernel ScopeSrv pronto para receber conex es dos Servidores Pr TEF 13 04 13 07 01 000009F0 Kemel ScopeSrv pronto para receber conex es dos POS 13 04 13 07 00 000009F0 Kerel Gateway iniciado 13 04 13 07 00 000009F0 PreT efMem SUCESSO na leitura das tabelas OnLine para Empresa 0007 Filial 0001 Rede 073 13 04 13 06 59 000007BC Collector 2010041311543993700000C6BC Tratamento iniciado Conte do O pacotes ISO 13 04 13 06 59 000007BC Collector Iniciado hd CnUs Al Mg Cache 0 IN OUT DE Pook ES Config 4 0 4 63 Pov 0420 0 Te o 0 pea elos
284. s a automa o comercial precisar tratar alguns campos formatando os para gravar no arquivo de concilia o Ser necess ria a formata o nos campos Tipo de registro preencher sempre com o d gito 1 Data da transa o o SCOPE Cliente fornece a data no formato DDMMAA e a automa o alterar para o formato AAAAMMDD NSU do host completar com espa os direita C digo de autoriza o completar com espa os direita Valor da transa o completar com zeros esquerda N mero do cart o completar com espa os direita Status da transa o preencher sempre com a letra O C digo da filial preencher com o c digo da filial usado na fun o ScopeOpen N mero de parcelas completar com zeros esquerda C digo da rede completar com zeros esquerda C digo da bandeira completar com zeros esquerda Reservado preencher sempre com espa os direita Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 144 OKI Fun es diversas Neste cap tulo abordamos diversas fun es de uso frequente por diversas empresas mas que n o conseguimos categoriz las Dados da transa o Ap s uma transa o ou at mesmo durante o processamento desta pode se querer guardar dados da transa o junto aos dados de venda utilizados pela aplica o para controle ou relat rio das vendas No caso da interface HLAPI mu
285. s da StREC CEL VALORES sendo adicionais e TotFaixaValores indica a quantidade total de faixas de valores dispon veis e TabFaixaValores cadeia de registros descrita abaixo com todos as faixas de valores dispon veis para a recarga desta transa o que embora seja fixo com 10 registros deve se sempre observar a quantidade v lida representada pelo campo anterior Existe uma diferen a na estrutura dos dados enviados pela GWCel dependendo a vers o de sua especifica o Para a rede GWCel vers o 003 a estrutura de Valores de Faixa a seguinte typedef struct char ValorMin 10 char ValorMax 10 stREC_CEL FAIXA VALORES ptREC CEL FAIXA VALORES e ValorMin indica o valor m nimo aceit vel para a recarga e ValorMax indica o valor m ximo aceit vel para a recarga Para a Gwcel vers o 005 as estruturas de Valores de Faixa tamb m possuem os campos Bonus e Custo antes s presentes na estrutura de valores fixos Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 79 OKI c c typedef struct char ValorMin 12 char ValorMax 12 har Bonus 12 har Custo 12 stREC_CEL_FAIXA_VALORES_2 ptREC_CEL FAIXA VALORES_2 e ValorMin indica o valor m nimo aceit vel para a recarga e ValorMax indica o valor m ximo aceit vel para a recarga e B
286. s do SCOPE switch status scope Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 91 case case case case case 64582 64514 64539 64546 64593 memset Cabec 0 sizeo if Manual do desenvolvedor f Cabec memset CpLoja 0 sizeof CpLoja retorno ScopeGetCupomEx sizeof Cabec OKI memset CpCliente 0 sizeof CpCliente memset CpReduzido 0 sizeof CpReduzido Cabec sizeof CpCliente CpCliente sizeof CpLoj a CpLoja sizeof CpReduzido CpReduzido amp NroLnhReduz retorno RCS SUCESSO ido retorno ScopeObtemTipoViaReimpressao amp EhReimpressao if EhReimpressao ImprimeCupomTEF amp ViaReimpressao CABECALHO Cabec ImprimeCupomTEF ImprimeCupomTEF CUPOM DO CLIENT E CpCliente CUPOM DA LOJA if NroLnhReduzido gt 0 ImprimeCupomTEF CUPOM REDUZI else switch ViaReimpressao case 0 e ImprimeCupom ni ImprimeCupom break case 1 break case 2 ImprimeCupomTI break break EF CUPOM DO CLI CpLoja DO CpReduzido ENTE CpCliente ImprimeCupomTEF CUPOM DO CLI EF CUPOM DA LOJA CpLoja ENTE CpCliente EF CUPOM DA LOJA CpLoja SCOPE Solu o Completa para Pagament
287. s organiza es autorizadoras e que respons vel pela emiss o de cart es para seus clientes BIN bank identification number n mero de identifica o do banco representado pelos primeiros 6 d gitos do cart o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 Endere o IP Internet Protocol trata se de uma tecnologia que permite a comunica o padronizada entre computadores mesmo que estes sejam de plataformas diferentes cada m quina possui um endere o IP que a diferencie das demais Estabelecimento ou estabelecimento comercial a entidade que aceita o cart o card acceptor como forma de pagamento referente comercializa o de um bem ou servi o prestado ao portador do cart o card holder G Grupo de servi o um servi o no SCOPE pertence sempre a um grupo que pode definir a forma de pagamento ou ainda a tecla finalizadora do PDV Exemplos cart o de cr dito cart o de d bito consulta de cheque recarga de celular estorno Ver Servi o GUI do ingl s Graphic User Interface que a interface gr fica exibida para o usu rio da aplica o Issuer Veja Banco emissor P PDV acr nimo para Ponto de Venda Terminal inteligente utilizado na opera o de pagamento Veja tamb m Pos PoS termo em ingl s Point of Sale Veja tamb m PDV R Rede autorizadora empresa que concentra o recebimento de transa es TEF de diversos estab
288. sagem vai at a rede autorizadora para que seja autorizada 0210 mensagem de resposta da transa o financeira A autorizadora responde a solicita o com esta mensagem que abrange a aprova o ou a rejei o da solicita o 0202 mensagem de confirma o da transa o financeira Esta mensagem a que confirma que a transa o foi realmente efetivada Ela indica por exemplo que o comprovante foi fisicamente impresso e que o processo como um todo foi conclu do Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 15 Figura 1 sequ ncia de mensagens numa transa o completa e bem sucedida Fluxo de estados de coleta O funcionamento do SCOPE Client baseia se em fluxos de estados de coleta para as diversas opera es dispon veis A cada itera o entre o aplicativo com o SCOPE Client este informa em qual estado de coleta se encontra qual informa o deve ser coleta qual mensagem deve ser exibida e quais op es de fluxo est o dispon veis retornar pr ximo e cancelar Desta forma o fluxo avan a at que seja poss vel efetuar a transa o desejada Exemplificando Ao iniciar uma transa o de cr dito o SCOPE estar no estado de coleta n mero do cart o Uma vez obtido o cart o o estado avan a e dependendo de uma s rie de vari veis poder migrar para o estado coleta os 4 ltimos d gitos do cart o Conforme as configura es poss veis para o tratam
289. seja receber a lista de operadoras Aceita apenas o valor 2 out String Buffer Buffer com a lista de operadoras Tamanho do buffer anterior previamente in WORD TamBuf alocado que deve ser maior ou igual a 2002 bytes Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 75 OKI OxFAO2 64002 Par metro 2 inv lido OxFAOS3 64003 Par metro 3 inv lido Exemplo StREC CEL OPERADORAS ListaOper obt m status do SCOPE switch status scope case 64624 ScopeRecupera0peradorasRecCel 2 char amp ListaOper sizeof buffer ApresentaListaAoOperador ListaOper Obt m c digo da operadora escolhido pelo cliente break passa a informa o coletada para o SCOPE Obtendo valores de recarga Com o status do SCOPE igual a 64558 a aplica o dever informar as op es de recarga dispon veis para a operadora escolhida que s o disponibilizadas pela fun o ScopeRecuperaValoresRecCel de maneira similar fun o que recupera as operadoras A estrutura do buffer recebido a seguinte 1 byte Um caractere representando o tipo de valor Valor ASCII Significado V Valor vari vel PF Valor Fixo T Todos valores
290. so de sucesso esta fun o retorna o valor 0 Prot tipo LONG EXPORT ScopePPLimpaComanda int TipoComanda Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 123 OKI Par metros lin lint TipoComanda Tipo de comanda Atualmente existe apenas o tipo Comanda Caf Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x000D 13 Opera o cancelada 0x0021 33 Mensagem recebida do PIN Pad possui formato inv lido 0x00D3 211 PIN Pad n o foi aberto pela aplica o 0x00D4 212 Time out do cliente usu rio 0x00D6 214 Comanda Vazia 0X00D7 215 Comanda Inv lida Exemplo LONG Retorno Retorno ScopePPStartLimpaComanda comanda cafe 1f Retorno 0 printf nCOMANDA INSIRA O CARTAO n Retorno ScopePPLimpaComanda comanda cafe while Retorno 1 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 124 OKI Totaliza o de TEF Esta sess o trata uma funcionalidade que o SCOPE disponibiliza para a aplica o de frente de loja a totaliza o de TEF Relat rio de TEF Pensando na facilidade de fazer o balan o dos valores de venda realizados no checkout o SCOPE Client prov aplica o um relat rio com informa es do total de TEF confirmadas e canceladas por bandeir
291. sobre o acesso a elas Normalmente o SCOPE Client colocado no mesmo diret rio da aplica o integradora No entanto h casos em que ele est dispon vel na pasta do sistema SwindirsiSystem32 CUIDADO devido perda de controle sobre qual biblioteca o MS Windows faz refer ncia A n o aconselh vel que as bibliotecas estejam no diret rio do MS Windows ou em qualquer subdiret rio No CD de instala o do SCOPE h possibilidade de instalar o SCOPE Client na m quina Esta instala o executar os seguintes passos e criar um diret rio com o SCOPE Client e copiar o execut vel do HotKey e seu atalho na rea de trabalho e alterar o registro do MS Windows com os itens de configura o O SCOPE se utiliza de alguns arquivos de controle no formato SXXXXYYYYZZZAAA sc gerados em tempo de execu o Assim em sistemas operacionais com conceito de multiusu rios como Linux e MS Windows existe a necessidade de permiss o para escrita e leitura no diret rio da aplica o No caso do MS Windows tais arquivos ser o gerados em C V Instala o do SCOPE Client para Linux Para a instala o do SCOPE Client em ambiente Linux disponibilizado um arquivo no formato RPM Este arquivo um pacote do sistema RPM Red Hat Package Manager utilizado em v rias distribui es Linux O nome do arquivo liberado segue o padr o itautec scope lt vers o gt 1 1386 rpm Onde lt vers o gt representa a
292. ssa compra Simula o Credi rio Atualmente esta transa o de uso exclusivo da rede Cielo Seu uso opcional j que a mesma transa o pode ser feita atrav s da ScopeMenu Quando feita atrav s desta ltima segue as regras de sele o de produtos da Cielo Prot tipo LONG EXPORT ScopeSimulacaoCrediario WORD CodGrupoServico char Valor char TxServico Par metros in Num rico CodGrupoServico Reservado para uso futuro H previs o de Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 62 OKI esta funcionalidade ser usada atrav s de cart es de Cr dito no futuro mas atualmente est dispon vel apenas para cart es de D bito Portanto usar fixo 1 D bito String com o E pn Em Valor da transa o com a v rgula impl cita di digitos dia a exemplo R 123 00 12300 in tring xServico alor da taxa de servi o Stri TxServi Valor d d i Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE06 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server
293. st o as chaves do scope ini com o registro do MS WindowsO Chave do arquivo Localiza o no editor do registro scope ini AtualizaDataHora HKEY LOCAL MACHINEISOFTWARE IScopeiSCOPEAPhAtualizaDataHora CupomReduzido HKEY LOCAL MACHINEISOFTWARE IScopeiSCOPEAPACupomReduzido Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 27 OKI MsgOperReduzida HKEY LOCAL MACHINEISOFTWARE iScopeiSCOPEAPAMsgOperReduzida Name HKEY LOCAL MACHINEISOFTWAREIScopeiSCOPESRViName NaoAbrirDigitado HKEY LOCAL MACHINEISOFTWAREIScopeiSCOPEAPANaoAbrirDigitado Port HKEY LOCAL MACHINEISOFTWAREIScopeiSCOPESRViPort ShowCupom HKEY LOCAL MACHINEISOFTWARE ScopeiSCOPEAPAShowCupom TimeOutAdm HKEY LOCAL MACHINEISOFTWAREIScopeiSCOPEAPANTimeOutAdm TimeOutLogon HKEY LOCAL MACHINEISOFTWAREIScopeiSCOPEAPI TimeOutLogon Versao Automacao HKEY LOCAL MACHINEISOFTWARE IScopeiSCOPEAPNVersaoAutomacao ScopeValidaSaque HKEY LOCAL MACHINEISOFTWARE ScopeiSCOPEAPNScopeValidaSaque Fontes de Dados do SCOPE no WoW64 No WoW64 as fontes de dados ou DSNs s o criadas por um Administrador de Fontes de Dados ODBC compat vel com 32 bits do WoW64 e n o o de 64 bits que acess vel por padr o a partir do Painel de Controle do Windows Assim ao instalar o Scope s o criados links com as bases de dados que podem depois ser alterados se necess rio em SystemRoot iSysWOW64odbcad32 exe Para maiores
294. ta de acordo com a parametriza o da Carga de Tabelas da CIELO e de acordo com as informa es habilitadas no chip do cart o Informa es Adicionais Captura da placa Za C digo do Motorista A aplica o de PDV n o necessita realizar qualquer tratamento para a coleta desses campos pois o SCOPE exibe de forma din mica tanto a mensagem quanto os dados coletados dependendo do cart o utilizado SAVS Esta se o trata da especifica o das transa es com a rede SAVS Sistema Autorizador de Vouchers e Servi os As transa es implementadas no SCOPE que podem ser realizadas com esta rede s o Autoriza o de Voucher Estorno de Autoriza o Voucher Associa o dos produtos e as fun es do SCOPE Abaixo est uma tabela onde s o relacionados os produtos da rede SAVS e as fun es da API do SCOPE que deve ser invocada para realizar a transa o Produto SAVS Fun o da API do SCOPE Autoriza o de Voucher ScopeServicosGenericos Estorno ScopeCancelamento Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 184 OKI Para a transa o de Autoriza o de Vouchers e Servi os a automa o dever chamar a fun o Autoriza o de Vouchers e Servi os ScopeServicosGenericos passando como par metro uma string contendo o c digo de Servi o e uma string vazia Durante transa o de Autoriza o de Voucher como a
295. tar de uma atua o do aplicativo como por exemplo coletar dados imprimir cupons e cheques mostrar mensagens para o operador e ou cliente entre outros Definindo a interface coleta Antes de realizar qualquer transa o a aplica o deve definir a interface coleta como meio de intera o o que realizado pela fun o ScopeSetApIColeta Isto dever ser feito ap s a conex o do SCOPE Client com o servidor Prot tipo LONG EXPORT ScopeSetAplColeta void Par metros N o h par metro Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFEO1 65025 SCOPE API n o foi inicializada corretamente Exemplo Conex o ao ScopeSRV bem sucedida retorno ScopeSetAplIColeta Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 41 OKI O operador de selecionar a transa o a ser realizada Sucesso 0x0000 ou emo Imprime cupons 0xFC02 Transa o em andamento 0xFEOO imprime cheque OxFC08 Mostra informa o e coleta dadas DxFCOO a OxFCFB PIN Pad em processamento DxFCFC a OxFCFD Mostra informa o e retoma fo fluxo OxFCFE Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 42 OKI Figura 6 fluxo de processamento de uma transa o com a interface coleta Obtendo os par m
296. ten o do handle Retorno Valores maiores que 0xFFFF significam valores v lidos de handle Qualquer outro valor significa um c digo de erro Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 145 OKI OxFAO1 64001 Par metro 1 inv lido OxFBO1 64257 N o foi poss vel criar a thread na coleta de dados OxFBO9 64265 Estourou o n mero m ximo de TEF numa sess o multi TEF OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFEO5 65029 API ainda n o fez nenhuma transa o ap s a inicializa o A aplica o est tentando obter um handle sem ter feito nenhuma transa o desde ltima conex o com o ScopeSRV OxFEOD 65037 N o h arquivo com dados da transa o anterior salvo Exemplo LONG handle processa a transa o handle ScopeObtemHandle 0 if handle gt OxFFFF obt m os dados desejados else erro n o conseguiu o handle fecha a sess o Obtendo os campos Ap s obter um handle v lido a aplica o est apta para o recebimento dos dados da transa o Estes dados podem ser obtidos de uma vez s ou campo a campo ou at mesmo agrupados em partes Isto conseguido atrav s de campos com combina o de bits Cada bit das vari veis de m scara passadas
297. tnex Com senha 0x0085 133 PratiCard 0x0086 134 PrestaServ 0x0087 135 Safra Amanco 0x0088 136 SimCred 0x0089 137 Premia o SONAE 0x008A 138 Presente SONAE 0x008B 139 ValeShop 0x008C 140 PREZUNIC 0x008D 141 FAI Orbital 0x008E 142 ConvCard 0x008F 143 Operadora Claro 0x0090 144 Operadora Ol 0x0091 145 Operadora TIM 0x0092 146 Operadora Telemig 0x0093 147 Operadora Amaz nia Celular 0x0094 148 Operadora Embratel 0x0095 149 Operadora Telefonica 0x0096 150 Operadora TELEMAR 0x0097 151 Operadora CTBC Celular 0x0098 152 Operadora CTBC Fixo 0x0099 153 Operadora SERCOMTEL Celular 0x009A 154 Operadora SERCOMTEL Fixo 0x009B 155 Operadora Telefonica Fam lia 0x009C 156 Operadora NEXTEL 0x009D 157 Operadora VIVO 0x009E 158 Cart o Parcele Mais REDECARD L0401 0x009F 159 BANPARA 0x00A0 160 NEUS 0x00A1 161 BANCRED SENHA 0x00A2 162 Credi Shop O0x00A3 163 Sapore 0x00A4 164 CB HSBC 0x00A5 165 Verocheque O0x00A6 166 Getnet 0x00A7 167 Pharmalink PBM 0x00A8 168 Aura FNAC 0x00A9 169 Aura BERGAMAIS Ox00AA 170 Com Voc 0x00AB 171 BANESCARD 0x00AG 172 Nokia Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 217 OKI C digos Bandeira Hexadeci Decimal Significado mal 0x00AD 173 Fala F cil Nexus 0x00B0 176 BRASIL CONV
298. to Atualiza o de par metros ScopeAtualizaParametrosChip vide item ScopeAtualizaParametrosChip Atualiza o de pre os ScopeAtualizaPrecosMercadorias Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 169 OKI vide item ScopeAtualizaPrecosMercadorias Dados coletados Abaixo est a rela o do que pode ser solicitado em cada transa o Transa o Coletas Cart o Dados do ECF veja mais abaixo Senha Imprimir cupons Dados Livres Dados Adicionais Compra online D bito Voucher N mero de controle da compra Cart o Imprimir cupons Estorno online Cart o Senha Imprimir cupom do cliente Consulta saldo Cart o Atualiza o de par metros Senha Atualiza o de pre os Nenhuma coleta Consulta saldo A fun o utilizada para esta transa o a ScopeConsultaSaldoDebito que como par metro espera receber um valor No entanto para os cart es Ticket Car n o utilizado este portanto a automa o pode passar uma string vazia Esta transa o n o possui cupom da loja mas apenas do cliente Dados do ECF Na transa o de compra online d bito Voucher necess rio enviar dados do cupom e do ECF O SCOPE retorna no modo coleta ent o o estado de coleta TC COLETA DADOS ECF FCBEh e a automa o deve invocar a fun o ScopeForneceCampo com os seguintes par metros e TypeField
299. to IATA parcelado sem juros 042 Cancelamento de compra de credito IATA 043 Cancelamento compra com cart o CDC 044 Consulta planos de pagamento para cart o CDC 045 Compra com cart o CDC 047 Consulta parcelas de cr dito 048 Consulta parcelas de d bito 050 Compra com cart o de d bito Voucher Alimenta o 051 Cancelamento de compra com cart o de d bito Voucher Alimenta o 056 Cancelamento de garantia de cheque 058 Consulta AVS 059 Cash 060 Cancelamento de Cash 061 Confirma o de Pr Autoriza o 062 Estorno de Pr Autoriza o 063 Fidelidade 064 Consulta saldo de cr dito 065 Consulta Cash 068 Consulta valores poss veis de recarga de celular 069 Recarga de celular 070 Consulta saldo 071 Consulta extrato resumido 072 Consulta extrato 073 Simula o de saque 074 Saque 075 Consulta saldo de investimento 076 Consulta extrato de investimento 077 Resgate avulso 078 Resgate 079 Cancelamento de saque 080 Cancelamento de resgate 081 Obt m cart o de investimento 082 Consulta medicamento 083 Compra medicamento 084 Estorno compra medicamento 085 Pagamento de conta com cart o 086 Solicita o de autoriza o 087 Pagamento de conta sem cart o 088 D bito Voucher parcelado 089 Consulta pagamento de conta 090 Estorno de pagamento de conta 091 Pagamento de fatura Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 222 OKI
300. to parcelado pela administradora Caso no fluxo de compra CDC for realizado uma consulta os cupons da consulta n o poder o ser impressos devido a problemas de controle fiscal Estes cupons dever o ser exibidos no visor para o cliente Somente os cupons da compra que dever o ser impressos caso haja interesse em continuar a compra ap s a consulta Consulta CDC Para uma simples consulta CDC independente da compra deve se utilizar a fun o espec fica para a transa o ScopeConsultaCDC O resultado desta transa o ser um cupom com valores do parcelamento com as taxas Quando a consulta for realizada por esta fun o os cupons da consulta dever o ser enviados para a impressora Prot tipo LONG EXPORT ScopeConsultaCDC char Valor char TxServico Par metros lin o da Valor Valor da transa o com a v rgula impl cita d gitos exemplo R 123 00 12300 in String TxServico Valor da taxa de servi o Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal OxFAO1 64001 Par metro 1 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server Ma
301. to retornar valor igual a 1 PIN Pad em processamento Em caso de sucesso esta fun o retorna o valor 0 Neste caso a comanda ser salva na rea de mem ria passada como par metro Existe a op o de permanecer com o cart o no PIN Pad proporcionando a limpeza do cart o logo depois da leitura sem necessidade de chamada separada dessa fun o Para essa op o deve ser passado o valor 0 no par metro RemoveComanda Prot tipo LONG EXPORT ScopePPObtemComanda int TipoComanda char Comanda int RemoveComanda Par metros lin lint TipoComanda Tipo de comanda Atualmente existe apenas o tipo Comanda Caf in char Comanda Buffer onde ser salva a comanda lida nessa opera o Op o de remover a comanda posteriormente leitura nt RemoveComanda 1 ou permanecer com o cart o para posterior limpeza 0 in Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0x000D 13 Opera o cancelada 0x0021 33 Mensagem recebida do PIN Pad possui formato inv lido 0x00D3 211 PIN Pad n o foi aberto pela aplica o 0x00D4 212 Time out do cliente usu rio 0x00D6 214 Comanda Vazia 0X00D7 215 Comanda Inv lida Exemplo char szComanda 4096 1 LONG Retorno Retorno ScopePPStartObtemComanda comanda cafe if Retorno 0 printf NnCOMANDA
302. torno retorno ScopeRecuperaOperadorasRecCel 2 buffer sizeof buffer if retorno 0 qtd_op short buffer for operadora 0 operadora lt gtd op operadora ind op operadora 1 23 3 Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 73 OKI int buffer ind op buffer ind op 1 printf inCod d Oper 21s No entanto de outra maneira mais iterativa e sem utilizar f rmulas matem ticas podemos obter a lista de operadoras como segue no exemplo abaixo short qgtd op char buffer 2002 int operadora ind op long retorno retorno ScopeRecuperaOperadorasRecCel 2 buffer sizeof buffer if retorno 0 qtd op short buffer ind op 3 for operadora 0 operadora lt gtd op operadora printf nCod d Oper 21s int buffer ind_op buffer ind op 1 ind op ind op 23 Estruturas de apoio Aplica es escritas em linguagem C podem usufruir de estruturas definidas no arquivo de cabe alho ScopeApi h O buffer recebido contendo a lista de operadoras resume se na estrutura abaixo typedef struct short NumOperCel char OperCel 2000 stREC_CEL OPERADORAS ptREC CEL OPERADORAS onde e NumOperCel n mero de operadoras de celular retornadas nesta transa o e OperCel tabela de operadoras No entanto o membro Oper
303. u P02 OxFBO3 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line 0xFF1D 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Exemplo abre sess o retorno ScopeConsultaSaldoCredito Como a consulta de saldo do cart o de cr dito n o est dispon vel para todos os cart es e por representar certo risco cart es roubados poder o ter todo o seu limite gasto sendo conhecido o seu saldo outras administradoras disponibilizam a op o de pr autoriza o Assim antes de fazer a compra poss vel realizar uma pr autoriza o para verificar se a compra proceder com Sucesso Prot tipo LONG EXPORT ScopePreAutorizacaoCredito char Valor char TxServico Par metros String com o gt gt o ana E Valor da transa o com a v rgula impl cita in E Bete yala exemplo R 123 00 12300 in String TxServico Valor da taxa de servi o Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 57 OKI C digos Retorno
304. ueado por n mero excessivo de senhas incorretas somente para Easy Entry TIBC v1 0x0040 64 Cart o TIBC v1 n o autenticado pelo m dulo SAM somente para Easy Entry TIBC v1 0x0041 65 Cart o TIBC v1 expirado somente para Easy Entry TIBC v1 0x0042 66 Cart o com erro de estrutura arquivos est o faltando 0x0043 67 Cart o foi invalidado Se o cart o for TIBC v1 quando sele o de arquivo ou ATR retornar status 6284 Se o cart o for EMV quando sele o de aplica o retornar status 6A81 0x0044 68 Cart o com problemas Esse status v lido para muitas ocorr ncias no processamento de cart es TIBC v1 e EMV onde o cart o n o se comporta conforme o esperado e a transa o deve ser finalizada 0x0045 69 O cart o seja TIBC v1 ou EMV comporta se corretamente por m possui dados inv lidos ou inconsistentes 0x0046 70 Cart o sem nenhuma aplica o dispon vel para as condi es pedidas ou cart o reconhecido como TIBC v1 ou EMV mas n o possui nenhuma aplica o compat vel com a requerida 0x0047 71 Somente para cart o EMV A aplica o selecionada n o pode ser utilizada neste terminal pois o Get Processing Options retornou status 6985 0x0048 72 Somente para aplica o de moedeiro O saldo do moedeiro insuficiente para a opera o 0x0049 73 Somente para aplica o de moedeiro O limite m ximo para a opera o foi excedido 0x004A 74 Cart o ain
305. uperaValoresRecCelOffTEF 1 67 26 08 2014 Marcelo Dionysio da Fonseca e Inclus o da rede Bin Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 6 OKI 1 68 27 08 2014 Facti Felipe M Schaden e Inclus o de se o especifica para detalhamento da rede SAVS e Descri o da fun o ScopeRecuperaBufTabelaGen para SAVS e Inclus o de C digos de retorno para SAVS e Inclus o de Estados para interrup o para SAVS e Inclus o de C digo de Rede e Bandeira SAVS e Inclus o de C digo de Servi o para SAVS e Inclus o de Constante Versao Carga Tabelas Host da m scara 3 da fun o ScopeObtemCampoExt2 1 69 28 08 2014 Edison M Ogata e Inclus o da rede CONDUCTOR PL e Inclus o da bandeira BAHAMAS CREDITO E e Inclus o da bandeira BAHAMAS ALIMENTA AO 1 70 23 09 2014 Facti Felipe M Schaden e Corre o de nome da fun o ScopeRecuperaBufTabelaGen e de par metro da fun o ScopeRecuperaBufTabela 1 71 19 12 2014 Regina Megumi e Inclus o de informa es sobre Cielo Auto 1 72 22 12 2014 Marcelo Dionysio da Fonseca e Atualiza o para Transa es Sem Contato Contactless e Inclus o da tabela C digos de Retorno de Pr TEF no Ap ndice A 1 73 27 01 2015 Edison Ogata e Acr scimo da bandeira CABAL VOUCHER na lista de bandeiras 1 74 19 02 2015 Edison Ogata e Reitrada da bandeira CA
306. v off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Exemplo abre sess o Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 72 OKI retorno ScopeRecargaCelular processa a transa o fecha a sess o Obtendo operadoras dispon veis Recebendo o c digo de coleta 64624 da fun o ScopeStatus a aplica o dever obter as operadoras dispon veis atrav s da fun o ScopeRecuperaOperadorasRecCel A lista disponibilizada no segundo par metro da fun o cont m o formato abaixo Posi o Formato Descri o 01 at 02 Short Quantidade de operadoras dispon veis 03 Byte C digo da operadora 1 04 at 25 String Nome da operadora 1 26 Byte C digo da operadora 2 27 at 48 String Nome da operadora 2 Pos n 1 x23 3 Byte C digo da operadora n Pos 1 at Pos 21 String Nome da operadora n Exemplo Quando houver 5 operadoras as posi es dos c digos de cada operadora no buffer ser o Pos 1 1 x23 3 3 Pos 2 1 x23 3 26 Pos 3 1 x23 3 49 Pos 4 1 x23 3 72 Pos 5 1 x23 3 95 Portanto codificando de maneira simples em linguagem C temos short qtd_op char buffer 2002 int operadora ind op long re
307. vidor o computador que administra e fornece programas e informa es para os outros computadores conectados em rede SGBD Sistema de Gerenciamento de Banco de Dados o conjunto de programas de computador softwares que controlam a cria o manuten o e uso de Bases de Dados T TSR abrevia o do termo em ingl s Terminate and Stay Resident Veja M dulo residente 237 OKI 2014 Este documento de propriedade da OKI Brasil Ind stria e Com rcio de Produtos e Tecnologia em Automa o S A Todos os direitos reservados As informa es aqui contidas t m car ter t cnico informativo e n o poder o ser copiadas fotocopiadas reproduzidas traduzidas ou reduzidas a qualquer meio eletr nico ou forma leg vel por m quina sem a autoriza o pr via da OKI Brasil Ind stria e Com rcio de Produtos e Tecnologia em Automa o S A Esta se reserva por outro lado o direito de alterar seu conte do e forma sem qualquer aviso pr vio Produzido no Brasil Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 238
308. xFAO1 64001 Par metro 1 inv lido OxFEOO 65024 A transa o em andamento a aplica o deve aguardar OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE0O6 65030 Logon duplicado Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 55 OKI OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server OxFEO8 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere H como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 ou P02 OxFBOS 64259 Erro ao verificar mensagem mensagem inv lida OxFFOO 65280 ScopeSrv off line ou o IP configurado no arquivo scope ini est apontando para a m quina errada OxFFOA 65290 Banco de dados off line OxFFiD 65309 Sess o em andamento a transa o solicitada deve ser nica numa sess o de TEF ou seja n o pode ser chamada se h transa es na sess o de TEF atual OxFFFF 65535 Erro gen rico OxFF5E 65374 Erro ao desmontar a estrutura ISO Exemplo char valor 12 1 char taxa 12 1 obt m o valor da compra e armazena em valor obt m a taxa de servi o armazena em ta
309. xa abre sess o retorno ScopeConsultaCredito valor taxa processa a transa o fecha a sess o Consulta a saldo de cart o de cr dito Um dos motivos que uma transa o pode n o ser aprovada a falta de saldo suficiente do cliente no cart o de cr dito Alguns cart es permitem esta consulta Prot tipo LONG EXPORT ScopeConsultaSaldoCredito void Par metros N o h par metros Retorno Ver tabela de c digo de retorno Poss veis Retornos de Erros C digos Retorno Hexadeci Decimal Significado mal 0xFE00 65024 A transa o em andamento a aplica o deve aguardar Manual do desenvolvedor SCOPE Solu o Completa para Pagamento Eletr nico 2 27 56 OKI Pr autoriza o de cr dito processa a transa o fecha a sess o OxFEO1 65025 SCOPE API n o foi inicializada corretamente OxFE0O6 65030 Logon duplicado OxFEO7 65031 Protocolo n o suportado SCOPE Client com vers o de protocolo superior ao SCOPE Server 0xFE08 65032 POS n o cadastrado OxFEOA 65034 N o h mais PDV s dispon veis Erro retornado quando a aplica o passa o caractere como PDV para que o SCOPE Server lhe d um n mero de PDV v lido mas n o h mais PDV s dispon veis OxFEOB 65035 Protocolo incompat vel SCOPE Client com vers o de protocolo extremamente antigo P00 P01 o

Manual Desenvolvedor

Contents

Download Pdf Manuals

Related Search

Related Contents