CRM INTERFACE DE COMUNICAÇÃO PDV

Transcrição

1 CRM INTERFACE DE COMUNICAÇÃO PDV

2 RMS Software S.A. - Uma Empresa TOTVS Todos os direitos reservados. A RMS Software é a maior fornecedora nacional de software de gestão corporativa para o mercado de comércio e varejo. Este documento contém informações conceituais, técnicas e telas do produto que são confidenciais, podendo ser utilizadas somente pelos clientes RMS no projeto de utilização do RMS/Retail. A reprodução deste material, por qualquer meio, em todo ou em parte, sem a autorização prévia e por escrito da RMS Software S.A., ou envio do mesmo a outras empresas terceirizadas não pertencentes ao grupo da RMS, sujeita o infrator aos termos da Lei número 6895 de 17/10/80 e as penalidades previstas nos artigos 184 e 185 do Código Penal. Para solicitar a autorização de reprodução parcial ou total desde documento, ou ainda necessitar enviá-lo à outra empresa, é necessário enviar uma solicitação assinada e com firma reconhecida para o departamento de controle de manuais da RMS, que fica situado à Al. Rio Negro, º andar, Alphaville, Barueri, São Paulo, ou se necessário o cliente poderá entrar em contato pelo Telefone (0xx11) A RMS Software S.A. reserva-se o direito de alterar o conteúdo deste manual, no todo ou em parte, sem prévio aviso. O nome RMS e os logotipos RMS, RMS/Retail são marcas registradas da RMS Software e suas empresas afiliadas no Brasil. Todos os demais nomes mencionados podem ser marcas registradas e comercializadas pelos seus proprietários. RMS Software S.A. - Uma empresa TOTVS

3 ÍNDICE CRM Interface de Comunicação PDV... 4 Objetivo... 4 Descrição do processo... 4 Padrões e Considerações... 4 Layout da Chamada ( PDV Retaguarda )... 5 Layout do Retorno com Erro ( Retaguarda PDV )... 6 Layout do Retorno de Aprovação ( Retaguarda PDV )

4 CRM Interface de Comunicação PDV Objetivo Permitir a comunicação entre PDV x retaguarda RMS para consultar o cadastro de clientes. Descrição do processo Padrões e Considerações 1. Todos os delimitadores devem ser o caracter pipe - 2. Os comandos possíveis a serem enviados são: CC Consulta de cheques (autorização de venda). CS Consulta de saldos disponíveis (consulta de clientes). NV Notificação de Venda. CL Cadastro do Cliente. CN Cancelamento do cheque. CV Convênio. CT Carnê. FD Crédito Rotativo. FI Consulta Clientes Fidelidade. PL Private Label. CP Consulta parcela pagamento. PG Notificação do Pagamento. EO Estoque Online. AS Troca de Senha. HC Cancelamento de Cupom. DC Cancelamento de item do cupom. AC - Autorização de cancelamento. 3. O número de autorização criado em uma consulta CC, deve ser o mesmo número para a operação NV correspondente e o mesmo para o cancelamento. 4. O código de retorno 00 significa que a solicitação foi processada com sucesso. Qualquer outro código indica retorno com erro. 5. Cada transação é equivalente a uma parcela. Por exemplo, em uma compra em três parcelas o PDV deverá enviar uma transação CC com o valor total da compra e três transações NV com os dados de cada parcela. 6. A transação NV respeita a transação anterior a ela. Por exemplo, uma transação CC seguida de NV significa uma finalização em cheque. Uma transação FD seguida de NV significa uma finalização em crédito rotativo. 7. Para as finalizações que não sejam em cheque, deverá ser enviado no campo CH-CHEQUE o conteúdo do campo CH-CUPOM na transação NV. 8. Para cancelar uma transação o PDV deverá enviar uma transação CN com o número de autorização, número de sequência e número do PDV da NV que será cancelada. 4

5 9. Para incluir um cliente através do PDV, deverá ser enviada uma transação CL e aguardar um retorno 00 para a confirmação da transação. Após isso, pode-se utilizar o sistema normal de autorização enviando uma transação CC seguida de NV. 10. Para as consultas de fidelidade e private label, o código enviado de identificação do cliente deverá ser o número do cartão. A mensagem terá como código de identificação FI (fidelidade) ou PL (private label) e o PDV deverá enviar à retaguarda: Código de identificação da mensagem. Código da Transação = FI ou PL. Tipo do código = 2. Código informado no PDV = número do cartão. Código da Loja. Número do PDV. 11. A transação de pagamento PG deverá conter os campos código do cliente (Código, CPF ou Cartão), Loja, PDV, Fiscal, Usuário e Valor. Ela possui um retorno como todas as outras, porém não gera número de autorização e nem requer uma transação NV para sua confirmação. 12. Para a modalidade Carnê, antes de enviar uma transação PG, deverá ser enviada uma CP. Esta informação CP será a solicitação da informação a ser paga pelo cliente. Deverá ser enviado os campos código do cliente (Código, CPF ou Cartão), Loja, PDV, Fiscal e Usuário. Para emissão do carnê pelo PDV, ao ser enviada uma mensagem CC, será retornado o número do carnê a ser gerado. No entanto, a confirmação só será mesmo quando recebida a transação NV com as parcelas. 13. Para troca de senha AS : Somente é necessário o PDV enviar para a retaguarda os campos abaixo: Código de identificação da mensagem. Código da Transação = AS. Tipo do código = 0- Código/ 1- CPF/ 2-Cartão. Código informado no PDV = Documento. Senha (Nova Senha). Layout da Chamada ( PDV Retaguarda ) Campo Descrição Início Final Tipo Tam. Dec. CH-FILLER Código de identificação da mensagem 1 4 Num 4 PIPE-00 Delimitador 5 5 Alfa 1 CH-TRANSACAO Código da Transação: CS, CC, NV, FI Alfa 2 PIPE-00 Delimitador 8 8 Alfa 1 CH-TIPCOD Tipo do código: 0 Código de Cliente 9 9 Num 1 1 C.P.F. / C.G.C. 2 Número Cartão PIPE-01 Delimitador Alfa 1 CH-CODIGO Código informado no PDV Num 16 PIPE-02 Delimitador Alfa 1 CH-LOJA Código da Loja Num 3 PIPE-03 Delimitador Alfa 1 CH-PDV Número do PDV Num 3 PIPE-04 Delimitador Alfa 1 CH-CUPOM Número do cupom Num 6 PIPE-05 Delimitador Alfa 1 CH-FINAL Número da finalizadora Num 3 PIPE-06 Delimitador Alfa 1 CH-DATA-VENC Data para vencimento Num 8 PIPE-07 Delimitador Alfa 1 CH-DIAS-VENC Número de dias para vencimento Num 4 PIPE-08 Delimitador Alfa 1 CH-VALOR Valor do cheque Num 17 2 PIPE-09 Delimitador Alfa 1 CH-BANCO Número do banco do cheque Num 3 5

6 PIPE-10 Delimitador Alfa 1 CH-AGENCIA Código da agência do cheque Num 5 PIPE-11 Delimitador Alfa 1 CH-CONTA Número da conta corrente do cheque Num 11 PIPE-12 Delimitador Alfa 1 CH-CHEQUE Número do cheque Num 7 PIPE-13 Delimitador Alfa 1 CH-CPF C.P.F. do cheque Num 14 PIPE-14 Delimitador Alfa 1 CH-USUARIO Identificação do caixa Alfa 8 PIPE-15 Delimitador Alfa 1 CH-FISCAL Identificação do fiscal Alfa 8 PIPE-16 Delimitador Alfa 1 CH-AUTORIZACAO Número de autorização da venda Num 9 PIPE-17 Delimitador Alfa 1 CH-SEQUENCIA Número de sequência do PDV Num 5 PIPE-18 Delimitador Alfa 1 CH-CMC7 CMC7 DO CHEQUE Alfa 35 PIPE-19 Delimitador Alfa 1 CH-CMC7-LIDA CMC7 DO CHEQUE - LIDA (1) OU DIGITADA (0) Num 1 PIPE-20 Delimitador Alfa 1 CH-PEDIDO Nrº do Pedido do Vendas Assistidas Num 7 PIPE-21 Delimitador Alfa 1 CH-SENHA Nova senha Alfa 6 PIPE-22 Delimitador Alfa 1 CH-DT-LANC Data de lançamento vale Alfa 8 PIPE-22 Delimitador Alfa 1 CH-SEQ-VALE Nrº Sequencia vale Num 7 PIPE-22 Delimitador Alfa 1 PIPE-23 Delimitador Alfa 1 Layout do Retorno com Erro ( Retaguarda PDV ) Campo Descrição Início Final Tipo Tam. Dec. RE-CODIGO Código do Erro 1 2 Num 2 PIPE-E01 Delimitador 3 3 Alfa 1 RE-MENS Mensagem para PDV 4 23 Alfa 20 PIPE-E02 Delimitador Alfa 1 RE-MENS-ERRO Mensagem de Erro Alfa 50 PIPE-E03 Delimitador Alfa 1 RE-NOME Nome do Cliente Alfa 40 PIPE-E04 Delimitador Alfa 1 RE-SEQUENCIA Número da Sequência Alfa 5 PIPE-E05 Delimitador Alfa 1 PIPE-E06 Delimitador Alfa 1 Layout do Retorno de Aprovação ( Retaguarda PDV ) Campo Descrição Início Final Tipo Tam. Dec. RT-CODIGO Código de retorno 1 2 Num 2 PIPE-R01 Delimitador 3 3 Alfa 1 RT-AUTORIZ Número da autorização 4 12 Num 9 PIPE-R02 Delimitador Alfa 1 RT-SALDO Saldo disponível Num 17 2 PIPE-R03 Delimitador Alfa 1 RT-SINAL Sinal do saldo disponível Alfa 1 PIPE-R04 Delimitador Alfa 1 RT-NOME Nome do cliente Alfa 40 PIPE-R05 Delimitador Alfa 1 RT-CPF C.P.F. do cliente Num 14 PIPE-R06 Delimitador Alfa 1 RT-RG R.G. do cliente Alfa 15 PIPE-R07 Delimitador Alfa 1 RT-FONE Telefone do cliente Alfa 11 PIPE-R08 Delimitador Alfa 1 RT-ENDERECO Endereço do cliente Alfa 40 PIPE-R09 Delimitador Alfa 1 6

7 RT-NUM Número do endereço do cliente Num 5 PIPE-R10 Delimitador Alfa 1 RT-COMPLE Complemento do endereço do cliente Alfa 20 PIPE-R11 Delimitador Alfa 1 RT-SEQUENCIA Número de sequência do PDV Num 5 PIPE-R12 Delimitador Alfa 1 RT-SITU-CLIE Situação do Cliente Num 2 PIPE-R13 Delimitador Alfa 1 RT-TIPO-CLIE Tipo de Cliente Num 2 PIPE-R14 Delimitador Alfa 1 RT-PONTOS-DISP Pontos disponíveis dos clientes Num 7 PIPE-R15 Delimitador Alfa 1 RT-EVENTO-01 Se a data de nascimento do cliente estiver na Num 2 semana gravar 01 se não gravar 00 PIPE-R16 Delimitador Alfa 1 RT-EVENTO-02 Se a data de nascimento do cônjuge do cliente Num 2 estiver na semana gravar 01, se a data de nascimento de qualquer dependente do cliente estiver na semana gravar 02 se não gravar 00 PIPE-R17 Delimitador Alfa 1 RT-EVENTO-03 Premiação Num 2 PIPE-R18 Delimitador Alfa 1 RT-PONTO-EXTRA-1 Ponto Extra Por período de compra Num 7 PIPE-R19 Delimitador Alfa 1 RT-PONTO-EXTRA-2 Ponto Extra Por estabelecimento de compra Num 7 PIPE-R20 Delimitador Alfa 1 RT-MENSAGEM Espaço para qualquer tipo de mensagem que a Alfa 30 retaguarda deseje enviar para PDV sobre o cliente PIPE-R21 Delimitador Alfa 1 RT-CATEGORIA Categoria do Cliente Informa o tipo de cliente. Se Num 2 for funcionário será = 1. PIPE-R22 Delimitador Alfa 1 RT-DIAS-CHEQUE Número Dias Cheque Pré Num 3 PIPE-R23 Delimitador Alfa 1 RT-NOME-EMPR Nome Empresa Conveniada Alfa 30 PIPE-R24 Delimitador Alfa 1 RT- COD CONVENIO Código do convênio Num 3 PIPE-R25 Delimitador Alfa 1 RT-SENHA Senha Alfa 10 PIPE-R26 Delimitador Alfa 1 RT-CARNET Número do carnê Num 1 PIPE-R27 Delimitador Alfa 1 RT-PARCELA Número da parcela do carnê Num 2 PIPE-R28 Delimitador Alfa 1 RT-VALOR Valor parcela Num 17 2 PIPE-R29 Delimitador Alfa 1 RT-VENCIMENTO Data vencimento parcela Num 8 PIPE-R30 Delimitador Num 1 RT-CH-DEVOL Ocorrência de Cheques Devolvidos Alfa 1 S/N PIPE-R31 Delimitador Alfa 1 RT-CH-QT-COMP Quantidade de Cheques Compensados Num 6 PIPE-R31 Delimitador Alfa 1 PIPE-R32 Delimitador Alfa 1 7

8 8