Introdução

Nesta seção apresentamos o roteiro de vendas para o produto Tele Sena, para obter as informações do produto utilizado na venda realize a operação Consultar Produtos disponível no anexo de Consultas, esse produto necessita de informações mais específicas para solicitar sua venda, nesse caso deve se consumir a operação Consultar Sorteio

Consultar sorteio

Utilize esse operação para obter as informações do sorteio do produto Telesena. Deve se atentar ao campo "valor" da resposta pois seu valor deverá ser utilizado em todas as solicitações de venda: Solicitar Venda no campo "edicao".

Exemplo de REQUEST:

curl --request GET \
     --url https://sandbox.grupocard.com.br/venda/sorteio/telesena/consulta-dinamica/81AA1C20B1688E4C7424C4E000334DD4 \
     --header 'Accept: application/json'

Exemplo de RESPONSE:

{
  "tipoValor": 1,
  "valores": [
    {
      "chave": "SAO JOAO/2022 - R$15,00",
      "valor": "1500;583"
    }
  ]
}

Fluxo de sucesso

1 - Consumir a operação Solicitar Venda

Utilize essa operação para solicitar a venda de qualquer produto disponível no estabelecimento. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação a seguir: Confirmar Venda

Obs. 1: Se ao invocar essa operação o cliente não obter uma resposta, é ALTAMENTE RECOMENDADO que seja realizado o cancelamento da solicitação.

Obs. 2: A representação dos centavos no campo "valor" não deve ter separação por virgula. Ex: R$10,99 = 1099

Obs. 3: No ambiente de homologação(sandbox) deve se utilizar somente cpfs válidos(reais) no campo "cpf".

Obs.4: O campo "idExterno" é o identificador da requisição, sendo assim, deve ser enviado com um valor DIFERENTE a cada requisição.

Exemplo de REQUEST:

POST /venda/sorteio/telesena/solicitar HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczpcL1wvc2FuZGJveC5ncnVwb2NhcmQuY29tLmJyIiwic3ViIjoiNmQwZjQyYzQtMWNjOS01ODNmLWE3N2QtZDI0ZmI0NGFjYTdhIiwiaWF0IjoxNjU2MzQxNTM2LCJleHAiOjE2NTY1MTQzMzYsIm5hbWUiOiJBZG1pbmlzdHJhdG9yIn0.-dnblIvspnmVnS-IQGjZkU3gZcKOr_vX4z1dG_a92hA
Host: sandbox.grupocard.com.br
Content-Length: 183

{"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4","edicao":"1500;595","idExterno":"1022","cpf":"{cpf do cliente}","telefone":"67999999999","dataHoraCliente":"2022-06-27T13:09:40.244Z"}

{
   "estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
   "edicao":"1500;595",
   "idExterno":"1022",
   "cpf":"{cpf do cliente}",
   "telefone":"67999999999",
   "dataHoraCliente":"2022-06-27T13:09:40.244Z"
}

Exemplo de RESPONSE:

{
  "venda": {
    "estabelecimento": {
      "cnpjCpf": "75.862.116/0001-39",
      "nome": "Homologação Plataforma WS recarga Multiproduto - NÃO MEXER"
    },
    "produto": {
      "fornecedor": {
        "nome": "TELE SENA"
      }
    },
    "transacao": {
      "valor": 1500,
      "status": "AUTORIZADA",
      "instrucao": "<!DOCTYPE html><script type=\\\"text/javascript\\\" src=\\\"https://integrati.solutions/js/infra/jquery.min.js\\\"></script><script type=\\\"text/javascript\\\" src=\\\"https://integrati.solutions/js/infra/jquery.qrcode.min.js\\\"></script><head><style>table {height: 50px;margin-left: auto;margin-right: auto;width: 360px;}.qrCodeContent {text-align: center;}</style></head><body bgcolor=\\\"f7f0de\\\"><table><tr><td align=\\\"center\\\"><b>Lideranca Capitalizacao S/A.</b></td></tr><tr><td align=\\\"center\\\"><b>CNPJ: 60.853.264/0001-10</b></td></tr><tr><td align=\\\"center\\\">--------------------------------------------</td></tr></table><table><tbody><tr><td align=\\\"left\\\">27/06/2022 13:53</td><td align=\\\"right\\\">POS: 0000000001191874</td></tr><tr><td align=\\\"left\\\"><b>No do Pedido</b>:</td><td align=\\\"right\\\">595-7031558-6</td></tr></tbody></table><br /><table><tbody><tr><td>Este e o comprovante de aquisicao da sua Tele Sena digital. Nao e o titulo de capitalizacao. Para visualiza-lo acesse o site www.telesena.com.br</td></tr><tr><td><b>Este comprovante nao possui valor comercial.</b></td></tr></tbody></table><br /><table><tbody><tr><td align=\\\"center\\\"><b>CONFIRA SEUS DADOS:</b></td></tr><tr><td align=\\\"left\\\"><b>CPF</b>: 02837981141</td></tr><tr><td align=\\\"left\\\"><b>Cliente</b>: LEONARDO ELIAN DE CARVALHO DE ALMEIDA</td></tr><tr><td align=\\\"left\\\"><b>Telefone</b>: (67) 99999-9999</td></tr><tr><td align=\\\"center\\\">--------------------------------------------</td></tr></tbody></table><table><tbody><tr><td align=\\\"center\\\"><b>TELE SENA DE PAIS/2022</b></td></tr><tr><td align=\\\"center\\\">Proc. SUSEP No 15414.609513/2022-18</td></tr><tr><td align=\\\"center\\\">Data de Resgate: 26/06/2023</td></tr><tr><td><br /></td></tr></tbody></table><table><thead><tr><td>PRODUTO</td><td>SERIE</td><td>TITULO</td><td>DV</td></tr></thead><tbody><tr><td>8</td><td>8</td><td>3.797.713</td><td align=\\\"right\\\">8</td></tr><tr><td><br /></td></tr><tr><td align=\\\"left\\\" colspan=\\\"2\\\">Quantidade</td><td align=\\\"right\\\" colspan=\\\"2\\\">1</td></tr><tr><td align=\\\"left\\\" colspan=\\\"2\\\">Valor Unitario</td><td align=\\\"right\\\" colspan=\\\"2\\\">R$ 15,00</td></tr><tr><td align=\\\"left\\\" colspan=\\\"2\\\"><b>Valor Total</b></td><td align=\\\"right\\\" colspan=\\\"2\\\"><b>R$ 15,00</b></td></tr><tr><td align=\\\"center\\\" colspan=\\\"4\\\">--------------------------------------------</td></tr></tbody></table><table><tr><td>Aprovado pela Superintendencia de Seguros Privados - SUSEP</td></tr><tr><td>Consulte as condicoes gerais e preencha a Ficha de Cadastro obrigatoria no site www.telesena.com.br</td></tr><tr><td align=\\\"center\\\">--------------------------------------------</td></tr></table><table><tbody><tr><td align=\\\"center\\\">Acesse o link abaixo ou utilize o QR Code para conferir suas Tele Senas.</td></tr><tr><td><br/></td></tr><tr><td align=\\\"center\\\">stg.telesena.digital/LaqGB</td></tr><tr><td align=\\\"center\\\">--------------------------------------------</td></tr></tbody></table><div id=\\\"qrCodeContent\\\" class=\\\"qrCodeContent\\\"></div><script>jQuery(\\\"#qrCodeContent\\\").qrcode({ width: 150, height: 150, text: \\\"https://stg.telesena.digital/kLaqGB\\\" });</script></body></html>",
      "complemento": "{\"edicao\":\"1500;595\",\"cpf\":\"{cpf do cliente}\",\"telefone\":\"67999999999\"}",
      "idTransacao": "2d75619f-d500-4445-b2d2-018162bd8f7f",
      "dataHora": "2022-06-27T13:53:48.000-04:00"
    },
    "idExterno": "1022"
  }
}

2 - Consumir a operação Confirmar Venda

Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação Solicitar Venda.

Obs. 1: A transação uma vez sendo Confirmada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!

Exemplo de REQUEST:

POST /venda/sorteio/telesena/confirmar HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczpcL1wvc2FuZGJveC5ncnVwb2NhcmQuY29tLmJyIiwic3ViIjoiNmQwZjQyYzQtMWNjOS01ODNmLWE3N2QtZDI0ZmI0NGFjYTdhIiwiaWF0IjoxNjU2MzQxNTM2LCJleHAiOjE2NTY1MTQzMzYsIm5hbWUiOiJBZG1pbmlzdHJhdG9yIn0.-dnblIvspnmVnS-IQGjZkU3gZcKOr_vX4z1dG_a92hA
Host: sandbox.grupocard.com.br
Content-Length: 174

{"idTransacao":"2d75619f-d500-4445-b2d2-018162bd8f7f","estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4","produto":"TELE SENA","dataHoraCliente":"2022-06-27T13:09:40.244Z"}

{
   "idTransacao":"2d75619f-d500-4445-b2d2-018162bd8f7f",
   "estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
   "produto":"TELE SENA",
   "dataHoraCliente":"2022-06-27T13:09:40.244Z"
}

Exemplo de RESPONSE:

{
  "transacao": {
    "status": "EFETIVADA",
    "idTransacao": "2d75619f-d500-4445-b2d2-018162bd8f7f"
  }
}

Fluxo de cancelamento

1 - Consumir a operação Solicitar Venda:

Obs. 1: Se ao invocar essa operação o cliente não obter uma resposta, é ALTAMENTE RECOMENDADO que seja realizado o cancelamento da solicitação.

Obs. 2: A representação dos centavos no campo "valor" não deve ter separação por virgula. Ex: R$10,99 = 1099

Obs. 3: No ambiente de homologação(sandbox) deve se utilizar somente cpfs válidos(reais) no campo "cpf".

Obs.4: O campo "idExterno" é o identificador da requisição, sendo assim, deve ser enviado com um valor DIFERENTE a cada requisição.

Exemplo de REQUEST:

POST /venda/sorteio/telesena/solicitar HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: sandbox.grupocard.com.br
Content-Length: 183

{"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4","edicao":"1500;595","idExterno":"1025","cpf":"{cpf do cliente}","telefone":"67999999999","dataHoraCliente":"2022-06-27T13:09:40.244Z"}

{
   "estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
   "edicao":"1500;595",
   "idExterno":"1025",
   "cpf":"{cpf do cliente}",
   "telefone":"67999999999",
   "dataHoraCliente":"2022-06-27T13:09:40.244Z"
}

Exemplo de RESPONSE:

{
  "venda": {
    "estabelecimento": {
      "cnpjCpf": "75.862.116/0001-39",
      "nome": "Homologação Plataforma WS recarga Multiproduto - NÃO MEXER"
    },
    "produto": {
      "fornecedor": {
        "nome": "TELE SENA"
      }
    },
    "transacao": {
      "valor": 1500,
      "status": "AUTORIZADA",
      "instrucao": "<!DOCTYPE html><script type=\\\"text/javascript\\\" src=\\\"https://integrati.solutions/js/infra/jquery.min.js\\\"></script><script type=\\\"text/javascript\\\" src=\\\"https://integrati.solutions/js/infra/jquery.qrcode.min.js\\\"></script><head><style>table {height: 50px;margin-left: auto;margin-right: auto;width: 360px;}.qrCodeContent {text-align: center;}</style></head><body bgcolor=\\\"f7f0de\\\"><table><tr><td align=\\\"center\\\"><b>Lideranca Capitalizacao S/A.</b></td></tr><tr><td align=\\\"center\\\"><b>CNPJ: 60.853.264/0001-10</b></td></tr><tr><td align=\\\"center\\\">--------------------------------------------</td></tr></table><table><tbody><tr><td align=\\\"left\\\">27/06/2022 14:04</td><td align=\\\"right\\\">POS: 0000000001191874</td></tr><tr><td align=\\\"left\\\"><b>No do Pedido</b>:</td><td align=\\\"right\\\">595-7031561-0</td></tr></tbody></table><br /><table><tbody><tr><td>Este e o comprovante de aquisicao da sua Tele Sena digital. Nao e o titulo de capitalizacao. Para visualiza-lo acesse o site www.telesena.com.br</td></tr><tr><td><b>Este comprovante nao possui valor comercial.</b></td></tr></tbody></table><br /><table><tbody><tr><td align=\\\"center\\\"><b>CONFIRA SEUS DADOS:</b></td></tr><tr><td align=\\\"left\\\"><b>CPF</b>: 02837981141</td></tr><tr><td align=\\\"left\\\"><b>Cliente</b>: LEONARDO ELIAN DE CARVALHO DE ALMEIDA</td></tr><tr><td align=\\\"left\\\"><b>Telefone</b>: (67) 99999-9999</td></tr><tr><td align=\\\"center\\\">--------------------------------------------</td></tr></tbody></table><table><tbody><tr><td align=\\\"center\\\"><b>TELE SENA DE PAIS/2022</b></td></tr><tr><td align=\\\"center\\\">Proc. SUSEP No 15414.609513/2022-18</td></tr><tr><td align=\\\"center\\\">Data de Resgate: 26/06/2023</td></tr><tr><td><br /></td></tr></tbody></table><table><thead><tr><td>PRODUTO</td><td>SERIE</td><td>TITULO</td><td>DV</td></tr></thead><tbody><tr><td>8</td><td>8</td><td>3.797.716</td><td align=\\\"right\\\">2</td></tr><tr><td><br /></td></tr><tr><td align=\\\"left\\\" colspan=\\\"2\\\">Quantidade</td><td align=\\\"right\\\" colspan=\\\"2\\\">1</td></tr><tr><td align=\\\"left\\\" colspan=\\\"2\\\">Valor Unitario</td><td align=\\\"right\\\" colspan=\\\"2\\\">R$ 15,00</td></tr><tr><td align=\\\"left\\\" colspan=\\\"2\\\"><b>Valor Total</b></td><td align=\\\"right\\\" colspan=\\\"2\\\"><b>R$ 15,00</b></td></tr><tr><td align=\\\"center\\\" colspan=\\\"4\\\">--------------------------------------------</td></tr></tbody></table><table><tr><td>Aprovado pela Superintendencia de Seguros Privados - SUSEP</td></tr><tr><td>Consulte as condicoes gerais e preencha a Ficha de Cadastro obrigatoria no site www.telesena.com.br</td></tr><tr><td align=\\\"center\\\">--------------------------------------------</td></tr></table><table><tbody><tr><td align=\\\"center\\\">Acesse o link abaixo ou utilize o QR Code para conferir suas Tele Senas.</td></tr><tr><td><br/></td></tr><tr><td align=\\\"center\\\">stg.telesena.digital/LdqGB</td></tr><tr><td align=\\\"center\\\">--------------------------------------------</td></tr></tbody></table><div id=\\\"qrCodeContent\\\" class=\\\"qrCodeContent\\\"></div><script>jQuery(\\\"#qrCodeContent\\\").qrcode({ width: 150, height: 150, text: \\\"https://stg.telesena.digital/kLdqGB\\\" });</script></body></html>",
      "complemento": "{\"edicao\":\"1500;595\",\"cpf\":\"{cpf do cliente}\",\"telefone\":\"67999999999\"}",
      "idTransacao": "719885cf-c83b-41de-9aa7-6a4a68ab3d67",
      "dataHora": "2022-06-27T14:04:38.000-04:00"
    },
    "idExterno": "1025"
  }
}

2 - Consumir a operação Cancelar Venda

Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação Solicitar Venda.

Obs. 1: A transação uma vez sendo Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!

Exemplo de REQUEST:

POST /venda/sorteio/telesena/cancelar HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczpcL1wvc2FuZGJveC5ncnVwb2NhcmQuY29tLmJyIiwic3ViIjoiNmQwZjQyYzQtMWNjOS01ODNmLWE3N2QtZDI0ZmI0NGFjYTdhIiwiaWF0IjoxNjU2MzQxNTM2LCJleHAiOjE2NTY1MTQzMzYsIm5hbWUiOiJBZG1pbmlzdHJhdG9yIn0.-dnblIvspnmVnS-IQGjZkU3gZcKOr_vX4z1dG_a92hA
Host: sandbox.grupocard.com.br
Content-Length: 118

{"idExterno":"1025","estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4","dataHoraCliente":"2022-06-27T13:09:40.244Z"}

{
   "idExterno":"1025",
   "estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
   "dataHoraCliente":"2022-06-27T13:09:40.244Z"
}

Exemplo de RESPONSE:

{
  "transacao": {
    "status": "CANCELADA"
  }
}