Histórico

Versão Publicado Alterado Por Comentar
ATUAL (v. 1) mar 08, 2023 11:30
Usuário desconhecido (t_marcos.silva)


Consultar Produto Garantia Estendida (7C)

Para realizar uma consulta de produto para pegar suas garantias estendidas, deve-se utilizar o método: ConsultaProdutoGarantia7C


Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

codigoLoja

String

4

Código da loja

Deve-se completar com zeros a esquerda.

Ex: Loja 1 deve ser passado 0001

pdv

String

3

Número do PDV

Deve-se completar com zeros a esquerda.

Ex: PDV 1 deve ser passado 001

estabelecimento

String

15

Representa o código do estabelecimento

codigoProduto

String

20

Código do produto a ser consultado

valorTransacao

Double

12,2

Valor da transação / Valor do produto

Para realizar o cálculo dinâmico do valor das garantias / RFs, deve-se passar o valor do produto neste campo. Caso contrário passar 0.01.

  

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU Safe

String

9

NSU do SAFE

Mensagem PDV

String

12

Mensagem a ser exibida no PDV

Saldo Disponível

Double

12,2

Saldo disponível da lista

Bit62

String

999

Retorno do SAFE:

DadosConsultaProdutoGE

Tipo Complexo


Dados da Consulta

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação

  

Exemplo de XML de Resposta

<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://grupolinx.com.br/">
  <CodigoResposta>00</CodigoResposta>
  <NSUSafe>000000000</NSUSafe>
  <MensagemPDV>TRANSAC APROVADA</MensagemPDV>
  <SaldoDisponivel>0</SaldoDisponivel>
  <Bit62> SAFE00021542002068003          7896409503777       CORRIGIR       LIQUIDIFICADOR PARIS W. BRANCO 110 VOLTS                                        0242014111311510204SAFE00030570000033884TROCA               012000000056820141114110933SAFE00030570000033885TROCA               024000000066720141114221027SAFE00170570000033886ROUBOS E FURTOS     012000000049420141113090548SAFE00170570000033881ROUBOS E FURTOS     024000000074120141113103648TRANSAC APROVADA</Bit62>
  <TempoResposta>381</TempoResposta>
  <DataHoraTransacao>0914120000</DataHoraTransacao>
  <ValorTotalTransacao>0</ValorTotalTransacao>
  <DadosConsultaProdutoGE>
    <Produto>
      <CodigoInterno>2002068003          </CodigoInterno>
      <CodigoEAN>7896409503777       </CodigoEAN>
      <Descricao>LIQUIDIFICADOR PARIS W. BRANCO 110 VOLTS                                        </Descricao>
      <Marca>CORRIGIR       </Marca>
      <GarantiaFabricante>024</GarantiaFabricante>
      <DataHoraInclusao>20141113115102</DataHoraInclusao>
    </Produto>
    <Planos>
      <Plano>
        <Id>0000033884</Id>
        <Tipo>TROCA               </Tipo>
        <Prazo>012</Prazo>
        <ValorVenda>5.68</ValorVenda>
        <DataHoraInclusaoPlano>20141114110933</DataHoraInclusaoPlano>
        <Ramo>
          <Id>710</Id>
          <Descricao>Garantia Estendida</Descricao>
        </Ramo>
        <Default>true</Default>
      </Plano>
      <Plano>
        <Id>0000033885</Id>
        <Tipo>TROCA               </Tipo>
        <Prazo>024</Prazo>
        <ValorVenda>6.67</ValorVenda>
        <DataHoraInclusaoPlano>20141114221027</DataHoraInclusaoPlano>
        <Ramo>
          <Id>710</Id>
          <Descricao>Garantia Estendida</Descricao>
        </Ramo>
        <Default>false</Default>
      </Plano>
      <Plano>
        <Id>0000033886</Id>
        <Tipo>ROUBOS E FURTOS     </Tipo>
        <Prazo>012</Prazo>
        <ValorVenda>4.94</ValorVenda>
        <DataHoraInclusaoPlano>20141113090548</DataHoraInclusaoPlano>
        <Ramo>
          <Id>810</Id>
          <Descricao>Roubos e Furtos</Descricao>
        </Ramo>
        <Default>false</Default>
      </Plano>
      <Plano>
        <Id>0000033881</Id>
        <Tipo>ROUBOS E FURTOS     </Tipo>
        <Prazo>024</Prazo>
        <ValorVenda>7.41</ValorVenda>
        <DataHoraInclusaoPlano>20141113103648</DataHoraInclusaoPlano>
        <Ramo>
          <Id>810</Id>
          <Descricao>Roubos e Furtos</Descricao>
        </Ramo>
        <Default>false</Default>
      </Plano>
    </Planos>
  </DadosConsultaProdutoGE>
</RespostaSAFE>



Compra de Garantia Estendida (9C)

Para realizar uma venda de garantia estendida, deve-se utilizar o método: CompraGarantia9C


Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

codigoLoja

String

4

Código da loja

Deve-se completar com zeros a esquerda.

Ex: Loja 1 deve ser passado 0001

pdv

String

3

Número do PDV

Deve-se completar com zeros a esquerda.

Ex: PDV 1 deve ser passado 001

valorTransacao

Double

12,2

Valor da transação

valorProdutoCupom

Double

12,2

Valor do produto no cupom

codigoProduto

String

20

Código Interno do Produto

dataHoraInclusaoGarantia

String

14

Data/Hora da Inclusão do Produto, retornada na consulta 7C.

Formato: AAAAMMDDHHMMSS

idPlano

String

10

Id do plano, retornado na consulta.

dataHoraInclusaoGarantia

String

14

Data/Hora da Inclusão do Plano da garantia, retornada na consulta 7C.

Formato: AAAAMMDDHHMMSS

codigoVendedor

String

30

Código do Vendedor, completando com zeros a esquerda.

cpfCliente

String

11

CPF do cliente, completando com zeros a esquerda.


rgCliente

String

10

RG do cliente, completando com zeros a esquerda.

codigoFormaPagamento

String

2

Código do Meio de Pagamento

numeroCupom

String

6

Número do Cupom

matriculaOperador

String

6

Matrícula do Operador


Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU Safe

String

9

NSU do SAFE

Mensagem PDV

String

12

Mensagem a ser exibida no PDV

Saldo Disponível

Double

12,2

Saldo disponível da lista

TextoCupom

String

999

Texto do Cupom para o PDV imprimir

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação

DadosVendaGE

Tipo Complexo


Dados da venda da garantia

  

Exemplo de XML de Resposta

<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://grupolinx.com.br/">
  <CodigoResposta>00</CodigoResposta>
  <NSUSafe>152062034</NSUSafe>
  <MensagemPDV>TRANSAC APROVADA</MensagemPDV>
  <SaldoDisponivel>0</SaldoDisponivel>
  <TextoCupom>GE                                                                                                                008651474180005691150666666000000152062034781000105000103LIQUIDIFICADOR PARIS WALITA           024TROCA               201909142020091400000001234500000000084804316000000005328                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    </TextoCupom>
  <TempoResposta>281</TempoResposta>
  <DataHoraTransacao>0914120000</DataHoraTransacao>
  <ValorTotalTransacao>0</ValorTotalTransacao>
  <DadosVendaGE>
    <TipoBilhete>GE</TipoBilhete>
    <Cliente>
      <Nome />
      <Endereco />
      <Cidade />
      <UF />
      <CPF>00865147418</CPF>
      <RG>0005691150</RG>
    </Cliente>
    <Cupom>666666</Cupom>
    <NsuCtf>000000</NsuCtf>
    <NsuSafe>152062034</NsuSafe>
    <Garantia>
      <Certificado>781000105000103</Certificado>
      <DescricaoProduto>LIQUIDIFICADOR PARIS WALITA</DescricaoProduto>
      <MesesGarantiaFabricante>24</MesesGarantiaFabricante>
      <Tipo>TROCA</Tipo>
      <Inicio>20190914</Inicio>
      <Fim>20200914</Fim>
      <ValorGarantia>123.45</ValorGarantia>
      <ValorIOF>8.48</ValorIOF>
      <PercentualRemuneracao>43.16</PercentualRemuneracao>
      <ValorRemuneracao>53.28</ValorRemuneracao>
    </Garantia>
  </DadosVendaGE>
</RespostaSAFE>



Consulta para Resgate de Garantia Estendida (7D)

Para realizar uma consulta antes do resgate de garantia estendida (vender um produto utilizando uma garantia estendida como forma de pagamento), deve-se utilizar o método: ConsultaResgateGarantia7D


Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

codigoLoja

String

4

Código da loja

Deve-se completar com zeros a esquerda.

Ex: Loja 1 deve ser passado 0001

pdv

String

3

Número do PDV

Deve-se completar com zeros a esquerda.

Ex: PDV 1 deve ser passado 001

estabelecimento

String

15

Representa o código do estabelecimento

codigoAprovacao

String

10

Código de Aprovação gerado pela seguradora

cpfCliente

String

11

CPF do cliente que efetuou a compra da garantia


Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU Safe

String

9

NSU do SAFE

Mensagem PDV

String

12

Mensagem a ser exibida no PDV

Saldo Disponível

Double

12,2

Saldo disponível da lista

Bit62

String

999

Retorno do Autorizador

DadosConsultaResgateGE

Tipo Complexo


Dados detalhados da consulta de resgate

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação


Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns="http://grupolinx.com.br/">
    <CodigoResposta>00</CodigoResposta>
    <NSUSafe/>
    <MensagemPDV>TRANSAC APROVADA</MensagemPDV>
    <SaldoDisponivel>0</SaldoDisponivel>
    <Bit62>
SAFE000615510003521457810001050000477896409503777 2002068003 LIQUIDIFICADOR PARIS W. BRANCO 110 VOLTS 0000001499
</Bit62>
    <TempoResposta>110</TempoResposta>
    <DataHoraTransacao>0905120000</DataHoraTransacao>
    <ValorTotalTransacao>0</ValorTotalTransacao>
    <DadosConsultaResgateGE>
        <CodigoAutorizacao>1000352145</CodigoAutorizacao>
        <NumeroCertificado>781000105000047</NumeroCertificado>
        <ValorAutorizado>14.99</ValorAutorizado>
        <Produto>
            <CodigoInterno>2002068003</CodigoInterno>
            <CodigoEAN>7896409503777</CodigoEAN>
            <Descricao>LIQUIDIFICADOR PARIS W. BRANCO 110 VOLTS</Descricao>
        </Produto>
    </DadosConsultaResgateGE>
</RespostaSAFE>



Resgate de Garantia Estendida (9F)

Para realizar uma venda e utilizar uma garantia estendida como pagamento, deve-se utilizar o método: CompraComResgateGarantia9F


Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

codigoLoja

String

4

Código da loja

Deve-se completar com zeros a esquerda.

Ex: Loja 1 deve ser passado 0001

pdv

String

3

Número do PDV

Deve-se completar com zeros a esquerda.

Ex: PDV 1 deve ser passado 001

estabelecimento

String

15

Representa o código do estabelecimento

codigoAprovacao

String

10

Código de Aprovação gerado pela seguradora

cpfCliente

String

11

CPF do cliente que efetuou a compra da garantia

numeroCupom

String

6

Número do Cupom

codigoProduto

String

20

Código Interno do Produto

codigoProdutoEAN

String

20

Código EAN do produto

valorTransacao

Double

12,2

Código de Aprovação gerado pela seguradora

numeroCertificado

String

15

Número do certificado de garantia


Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU Safe

String

9

NSU do SAFE

Mensagem PDV

String

12

Mensagem a ser exibida no PDV

Saldo Disponível

Double

12,2

Saldo disponível da lista

TextoCupom

String

999

Texto do cupom a ser impresso

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação

  

Exemplo de XML de Resposta

<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://grupolinx.com.br/">
<CodigoResposta>00</CodigoResposta>
<NSUSafe/>
<MensagemPDV>TRANSAC APROVADA</MensagemPDV>
<SaldoDisponivel>0</SaldoDisponivel>
<Bit62>
SAFE000615510003521457810001050000477896409503777 2002068003 LIQUIDIFICADOR PARIS W. BRANCO 110 VOLTS 0000001499
</Bit62>
<TempoResposta>418</TempoResposta>
<DataHoraTransacao>0905120000</DataHoraTransacao>
<ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>



Reimpressão de Cupom de Garantia Estendida

Para reimprimir um cupom de venda de garantiaestendida, deve-se utilizar o método: ReimpressaoCupomGE.


Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

certificado

String

15

Número do certificado de garantia


Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

Saldo Disponível

Double

12,2

Saldo disponível da lista

Valor Total Transação

Double

12,2

Valor da transação

DadosVendaGE

Tipo Complexo


Dados da Venda da garantia


Exemplo de XML de Resposta

 <RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://grupolinx.com.br/">
  <SaldoDisponivel>0</SaldoDisponivel>
  <TempoResposta>0</TempoResposta>
  <ValorTotalTransacao>0</ValorTotalTransacao>
  <DadosVendaGE>
    <TipoBilhete>GE</TipoBilhete>
    <Cliente>
      <Nome />
      <Endereco />
      <Cidade />
      <UF />
      <CPF>00865147418</CPF>
      <RG>0005691150</RG>
    </Cliente>
    <Cupom>666666</Cupom>
    <NsuCtf>000000</NsuCtf>
    <NsuSafe>152062007</NsuSafe>
    <Garantia>
      <Certificado>781000105000102</Certificado>
      <DescricaoProduto>LIQUIDIFICADOR PARIS WALITA</DescricaoProduto>
      <MesesGarantiaFabricante>24</MesesGarantiaFabricante>
      <Tipo>TROCA</Tipo>
      <Inicio>20190913</Inicio>
      <Fim>20200913</Fim>
      <ValorGarantia>10000</ValorGarantia>
      <ValorIOF>687.27</ValorIOF>
      <PercentualRemuneracao>43.16</PercentualRemuneracao>
      <ValorRemuneracao>4316</ValorRemuneracao>
    </Garantia>
  </DadosVendaGE>
</RespostaSAFE>

Consultar os valores de premio por faixa de valor de produto

Para consultar os valores de prêmio por faixa de valor de produto , deve-se utilizar o método: ConsultarValorCategoriaPremio

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigoCategoria

String

3

N

Código da Categoria

codigoRamo

String

3

N

Código do Ramo.
Ex: 710 - Garantia Estendida

quantidadeMeses

String

2

N

Quantidade de Meses

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

ValoresDePremio

Array of ValorDePremio




ValorDePremio

Nome

Tipo

Tamanho

Descrição

CodigoCategoria

String

2

Codigo da Categoria

DescricaoCategoria

Sting

255

Descrição da Categoria

CodigoRamo

String3

Codigo do Ramo

DescricaoRamo

String

255

Descrição do Ramo

QuantidadeMeses

String

2

Quantidade de Meses

ValorInicialFaixa

Double

12,2

Valor Inicial da Faixa

ValorFinalFaixa

Double

12,2

Valor Final da Faixa


Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <SaldoDisponivel>0</SaldoDisponivel>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
    <ValoresDePremio>
        <ValorDePremio>
            <CodigoCategoria>TV </CodigoCategoria>
            <DescricaoCategoria>TELEVISAO</DescricaoCategoria>
            <CodigoRamo>710</CodigoRamo>
            <DescricaoRamo>GARANTIA ESTENDIDA</DescricaoRamo>
            <QuantidadeMeses>12</QuantidadeMeses>
            <ValorInicialFaixa>300.01</ValorInicialFaixa>
            <ValorFinalFaixa>450.00</ValorFinalFaixa>
        </ValorDePremio>
        <ValorDePremio>
            <CodigoCategoria>TV </CodigoCategoria>
            <DescricaoCategoria>TELEVISAO</DescricaoCategoria>
            <CodigoRamo>710</CodigoRamo>
            <DescricaoRamo>GARANTIA ESTENDIDA</DescricaoRamo>
            <QuantidadeMeses>12</QuantidadeMeses>
            <ValorInicialFaixa>0.01</ValorInicialFaixa>
            <ValorFinalFaixa>300.00</ValorFinalFaixa>
        </ValorDePremio>
        <ValorDePremio>
            <CodigoCategoria>TV </CodigoCategoria>
            <DescricaoCategoria>TELEVISAO</DescricaoCategoria>
            <CodigoRamo>710</CodigoRamo>
            <DescricaoRamo>GARANTIA ESTENDIDA</DescricaoRamo>
            <QuantidadeMeses>23</QuantidadeMeses>
            <ValorInicialFaixa>300.01</ValorInicialFaixa>
            <ValorFinalFaixa>450.00</ValorFinalFaixa>
        </ValorDePremio>
        <ValorDePremio>
            <CodigoCategoria>TV </CodigoCategoria>
            <DescricaoCategoria>TELEVISAO</DescricaoCategoria>
            <CodigoRamo>710</CodigoRamo>
            <DescricaoRamo>GARANTIA ESTENDIDA</DescricaoRamo>
            <QuantidadeMeses>23</QuantidadeMeses>
            <ValorInicialFaixa>450.01</ValorInicialFaixa>
            <ValorFinalFaixa>1000.00</ValorFinalFaixa>
        </ValorDePremio>
        <ValorDePremio>
            <CodigoCategoria>TV </CodigoCategoria>
            <DescricaoCategoria>TELEVISAO</DescricaoCategoria>
            <CodigoRamo>710</CodigoRamo>
            <DescricaoRamo>GARANTIA ESTENDIDA</DescricaoRamo>
            <QuantidadeMeses>23</QuantidadeMeses>
            <ValorInicialFaixa>0.01</ValorInicialFaixa>
            <ValorFinalFaixa>300.00</ValorFinalFaixa>
        </ValorDePremio>
    </ValoresDePremio>
</RespostaSAFE>


Adicionar Valor Categoria Prêmio

Para adicionar uma faixa de valor por categoria, deve-se utilizar o método: AdicionarValorCategoriaPremio

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigoCategoria

String

3

S

Código da Categoria

codigoRamo

String

3

S

Código do Ramo.
Ex: 710 - Garantia Estendida

quantidadeMeses

String

2

S

Quantidade de Meses

valorFaixaInicial

Double

12,2

S

Valor Inicial da Faixa

valorFinalFaixa

Double

12,2

S

Valor Final da Faixa

valorGarantia

Double

12,2

S

Valor do Prêmio (Garantia)

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

CodigoResposta

String

2

Codigo da Resposta

MensagemWS

String

255

Detalhamento do processamento

Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <CodigoResposta>00</CodigoResposta>
    <SaldoDisponivel>0</SaldoDisponivel>
    <MensagemWS>Operação realizada com sucesso</MensagemWS>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>


Excluir Valor Categoria Prêmio

Para excluir uma faixa de valor por categoria, deve-se utilizar o método: ExcluirValorCategoriaPremio

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigoCategoria

String

3

S

Código da Categoria

codigoRamo

String

3

S

Código do Ramo.
Ex: 710 - Garantia Estendida

quantidadeMeses

String

2

S

Quantidade de Meses

valorFaixaInicial

Double

12,2

S

Valor Inicial da Faixa

valorFinalFaixa

Double

12,2

S

Valor Final da Faixa

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

CodigoResposta

String

2

Codigo da Resposta

MensagemWS

String

255

Detalhamento do processamento

Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <CodigoResposta>00</CodigoResposta>
    <SaldoDisponivel>0</SaldoDisponivel>
    <MensagemWS>Operação realizada com sucesso</MensagemWS>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>

Alterar Valor Categoria Prêmio

Para alterar uma faixa de valor por categoria, deve-se utilizar o método: AlterarValorCategoriaPremio

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigoCategoria

String

3

S

Código da Categoria

codigoRamo

String

3

S

Código do Ramo.
Ex: 710 - Garantia Estendida

quantidadeMeses

String

2

S

Quantidade de Meses

valorFaixaInicial

Double

12,2

S

Valor Inicial da Faixa

valorFinalFaixa

Double

12,2

S

Valor Final da Faixa

valorGarantia

Double

12,2

S

Valor do Prêmio (Garantia)

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

CodigoResposta

String

2

Codigo da Resposta

MensagemWS

String

255

Detalhamento do processamento

Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <CodigoResposta>00</CodigoResposta>
    <SaldoDisponivel>0</SaldoDisponivel>
    <MensagemWS>Operação realizada com sucesso</MensagemWS>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>

Enquadrar um Produto

Para enquadrar um produto, deve-se utilizar o método: EnquadrarProduto

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigoCategoria

String

3

S

Código da Categoria

codigoRamo

String

3

S

Código do Ramo.
Ex: 710 - Garantia Estendida

quantidadeMeses

String

2

S

Quantidade de Meses

codigoTipoPlano

String

3

S

Código do Tipo do Plano

codigoPacote

String

3

S

Código do Pacote

codigoServico

String

3

S

Código do Serviço

codigoProduto

String

13

S

Código do Produto

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

CodigoResposta

String

2

Codigo da Resposta

MensagemWS

String

255

Detalhamento do processamento

Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <CodigoResposta>00</CodigoResposta>
    <SaldoDisponivel>0</SaldoDisponivel>
    <MensagemWS>Operação realizada com sucesso</MensagemWS>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>

Excluir um Enquadramento

Para excluir um enquadramento, deve-se utilizar o método: ExcluirEnquadramento

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigoProduto

String

13

S

Código do produto

idPlano

String

13

S

ID do Plano

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

CodigoResposta

String

2

Codigo da Resposta

MensagemWS

String

255

Detalhamento do processamento

Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <CodigoResposta>00</CodigoResposta>
    <SaldoDisponivel>0</SaldoDisponivel>
    <MensagemWS>Operação realizada com sucesso</MensagemWS>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>

Roubo ou Furto - Alterar Percentual para Categoria e Meses 

Para adicionar percentual para categoria e meses na modalidade Seguro Roubo ou Furto, deve-se utilizar o método: AlterarPercentualCategoriaRouboFurto

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigoCategoria

String

3

S

Código da Categoria

quantidadeMeses

String

2

S

Quantidade de Meses

percentualValorVenda

Double

12,2

S

Percentual do valor de venda

percentualValorCusto

Double

12,2

N

Percentual do valor de custo

opcaoDefault

Boolean


N

Indica se a opção será default ou não

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

CodigoResposta

String

2

Codigo da Resposta

MensagemWS

String

255

Detalhamento do processamento

Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <CodigoResposta>00</CodigoResposta>
    <SaldoDisponivel>0</SaldoDisponivel>
    <MensagemWS>Operação realizada com sucesso</MensagemWS>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>

Roubo ou Furto - Adicionar Percentual para Categoria e Meses 

Para adicionar percentual para categoria e meses na modalidade Seguro Roubo ou Furto, deve-se utilizar o método: AdicionarPercentualCategoriaRouboFurto

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigoCategoria

String

3

S

Código da Categoria

quantidadeMeses

String

2

S

Quantidade de Meses

percentualValorVenda

Double

12,2

S

Percentual do valor de venda

percentualValorCusto

Double

12,2

N

Percentual do valor de custo

opcaoDefault

Boolean


N

Indica se a opção será default ou não

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

CodigoResposta

String

2

Codigo da Resposta

MensagemWS

String

255

Detalhamento do processamento

Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <CodigoResposta>00</CodigoResposta>
    <SaldoDisponivel>0</SaldoDisponivel>
    <MensagemWS>Operação realizada com sucesso</MensagemWS>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>

Roubo ou Furto - Excluir Percentual para Categoria e Meses 

Para excluir percentual para categoria e meses na modalidade Seguro Roubo ou Furto, deve-se utilizar o método: ExcluirPercentualCategoriaRouboFurto

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigoCategoria

String

3

S

Código da Categoria

quantidadeMeses

String

2

S

Quantidade de Meses

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

CodigoResposta

String

2

Codigo da Resposta

MensagemWS

String

255

Detalhamento do processamento

Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <CodigoResposta>00</CodigoResposta>
    <SaldoDisponivel>0</SaldoDisponivel>
    <MensagemWS>Operação realizada com sucesso</MensagemWS>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>

Roubo ou Furto - Excluir Percentual para Categoria e Meses 

Para consultar os percentuais por categoria e meses, deve-se utilizar o método: ConsultarPercentualCategoriaRouboFurto

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigoCategoria

String

3

N

Código da Categoria

quantidadeMeses

String

2

N

Quantidade de Meses

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

PercentuaisDePremio

Array of PercentualDePremio




PercentualDePremio

Nome

Tipo

Tamanho

Descrição

CodigoCategoria

String

2

Codigo da Categoria

DescricaoCategoria

Sting

255

Descrição da Categoria

CodigoRamo

String3

Codigo do Ramo

DescricaoRamo

String

255

Descrição do Ramo

QuantidadeMeses

String

2

Quantidade de Meses

PercentualValorVenda

Double

12,2

Percentual do valor de venda

PercentualValorCusto

Double

12,2

Percentual do valor de custo

OpcaoDefault

Bool


Indicador de opção default


Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <SaldoDisponivel>0</SaldoDisponivel>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
    <PercentuaisDePremio>
        <PercentualDePremio>
            <CodigoCategoria>CEL</CodigoCategoria>
            <DescricaoCategoria>CELULAR</DescricaoCategoria>
            <CodigoRamo>810</CodigoRamo>
            <DescricaoRamo>SEGURO ROUBO OU FURTO</DescricaoRamo>
            <QuantidadeMeses>12</QuantidadeMeses>
            <PercentualValorVenda>15.00</PercentualValorVenda>
            <PercentualValorCusto>20.00</PercentualValorCusto>
            <OpcaoDefault>false</OpcaoDefault>
        </PercentualDePremio>
    </PercentuaisDePremio>
</RespostaSAFE>

Consultar Enquadramento de um Produto

Para realizar uma consulta de produto para pegar suas garantias estendidas, deve-se utilizar o método: ConsultarEnquadramentoProduto

Obs: Esse método sempre retornará o atributo ValorVenda com valor 0.

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

codigoProduto

String

20

Código do produto a ser consultado

  

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU Safe

String

9

NSU do SAFE

Mensagem PDV

String

12

Mensagem a ser exibida no PDV

Saldo Disponível

Double

12,2

Saldo disponível da lista

Bit62

String

999

Retorno do SAFE:

DadosConsultaProdutoGE

Tipo Complexo


Dados da Consulta

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação

  

Exemplo de XML de Resposta

<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://grupolinx.com.br/">
  <CodigoResposta>00</CodigoResposta>
  <NSUSafe>000000000</NSUSafe>
  <MensagemPDV>TRANSAC APROVADA</MensagemPDV>
  <SaldoDisponivel>0</SaldoDisponivel>
  <Bit62> SAFE00021542002068003          7896409503777       CORRIGIR       LIQUIDIFICADOR PARIS W. BRANCO 110 VOLTS                                        0242014111311510204SAFE00030570000033884TROCA               012000000056820141114110933SAFE00030570000033885TROCA               024000000066720141114221027SAFE00170570000033886ROUBOS E FURTOS     012000000049420141113090548SAFE00170570000033881ROUBOS E FURTOS     024000000074120141113103648TRANSAC APROVADA</Bit62>
  <TempoResposta>381</TempoResposta>
  <DataHoraTransacao>0914120000</DataHoraTransacao>
  <ValorTotalTransacao>0</ValorTotalTransacao>
  <DadosConsultaProdutoGE>
    <Produto>
      <CodigoInterno>2002068003          </CodigoInterno>
      <CodigoEAN>7896409503777       </CodigoEAN>
      <Descricao>LIQUIDIFICADOR PARIS W. BRANCO 110 VOLTS                                        </Descricao>
      <Marca>CORRIGIR       </Marca>
      <GarantiaFabricante>024</GarantiaFabricante>
      <DataHoraInclusao>20141113115102</DataHoraInclusao>
    </Produto>
    <Planos>
      <Plano>
        <Id>0000033884</Id>
        <Tipo>TROCA               </Tipo>
        <Prazo>012</Prazo>
        <ValorVenda>0</ValorVenda>
        <DataHoraInclusaoPlano>20141114110933</DataHoraInclusaoPlano>
        <Ramo>
          <Id>710</Id>
          <Descricao>Garantia Estendida</Descricao>
        </Ramo>
        <Default>true</Default>
      </Plano>
      <Plano>
        <Id>0000033885</Id>
        <Tipo>TROCA               </Tipo>
        <Prazo>024</Prazo>
        <ValorVenda>0</ValorVenda>
        <DataHoraInclusaoPlano>20141114221027</DataHoraInclusaoPlano>
        <Ramo>
          <Id>710</Id>
          <Descricao>Garantia Estendida</Descricao>
        </Ramo>
        <Default>false</Default>
      </Plano>
      <Plano>
        <Id>0000033886</Id>
        <Tipo>ROUBOS E FURTOS     </Tipo>
        <Prazo>012</Prazo>
        <ValorVenda>4.94</ValorVenda>
        <DataHoraInclusaoPlano>20141113090548</DataHoraInclusaoPlano>
        <Ramo>
          <Id>810</Id>
          <Descricao>Roubos e Furtos</Descricao>
        </Ramo>
        <Default>false</Default>
      </Plano>
      <Plano>
        <Id>0000033881</Id>
        <Tipo>ROUBOS E FURTOS     </Tipo>
        <Prazo>024</Prazo>
        <ValorVenda>0</ValorVenda>
        <DataHoraInclusaoPlano>20141113103648</DataHoraInclusaoPlano>
        <Ramo>
          <Id>810</Id>
          <Descricao>Roubos e Furtos</Descricao>
        </Ramo>
        <Default>false</Default>
      </Plano>
    </Planos>
  </DadosConsultaProdutoGE>
</RespostaSAFE>

Adicionar Categoria

Para adicionar uma categoria, deve-se utilizar o método: AdicionarCategoria

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigo

String

3

S

Código da Categoria

descricao

String

100

S

Descrição da Categoria

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

CodigoResposta

String

2

Codigo da Resposta

MensagemWS

String

255

Detalhamento do processamento

Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <CodigoResposta>00</CodigoResposta>
    <SaldoDisponivel>0</SaldoDisponivel>
    <MensagemWS>Operação realizada com sucesso</MensagemWS>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>

Alterar Categoria

Para alterar uma categoria, deve-se utilizar o método: AlterarCategoria

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigo

String

3

S

Código da Categoria

descricao

String

100

S

Descrição da Categoria

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

CodigoResposta

String

2

Codigo da Resposta

MensagemWS

String

255

Detalhamento do processamento

Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <CodigoResposta>00</CodigoResposta>
    <SaldoDisponivel>0</SaldoDisponivel>
    <MensagemWS>Operação realizada com sucesso</MensagemWS>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>

Excluir Categoria

Para excluir uma categoria, deve-se utilizar o método: ExcluirCategoria

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigo

String

3

S

Código da Categoria

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

CodigoResposta

String

2

Codigo da Resposta

MensagemWS

String

255

Detalhamento do processamento

Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <CodigoResposta>00</CodigoResposta>
    <SaldoDisponivel>0</SaldoDisponivel>
    <MensagemWS>Operação realizada com sucesso</MensagemWS>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>

Consultar as Categorias

Para consultar os valores de prêmio por faixa de valor de produto , deve-se utilizar o método: ConsultarValorCategoriaPremio

Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

codigoCategoria

String

3

N

Código da Categoria

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

SaldoDisponivel

Double

12,2

Depracated

TempoResposta

Numeric

6

Tempo de resposta da transação

ValorTotalTransacao

Double12,2

Depracated

ValoresDePremio

Array of Categorias




Categorias

Nome

Tipo

Tamanho

Descrição

CodigoCategoria

String

2

Codigo da Categoria

DescricaoCategoria

Sting

255

Descrição da Categoria


Exemplo de XML de Resposta

<RespostaSAFE
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://grupolinx.com.br/">
    <SaldoDisponivel>0</SaldoDisponivel>
    <TempoResposta>0</TempoResposta>
    <ValorTotalTransacao>0</ValorTotalTransacao>
    <Categorias>
        <Categoria>
                        <CodigoCategoria>TV </CodigoCategoria>
                        <DescricaoCategoria>TELEVISAO</DescricaoCategoria>
                    </Categoria>
                </Categorias>
</RespostaSAFE>


  • Sem rótulos