Introdução
Nesta seção apresentamos o roteiro de vendas para os produtos de Tv-Pré e Streaming, para obter as informações dos produtos utilizados na venda realize a operação Consultar Produtos disponível no anexo de Consultas.
Fluxo de sucesso
1 - Consumir a operação Consultar Produtos e Valores disponíveis
Utilize essa operação para obter os valores e os produtos negociados. Até o momento essa operação está disponível somente para o produto SKY TV.
Obs. 1: O único valor a ser utilizado na Solicitar Venda é o do campo "valor" do array "valores":
Exemplo:
"valor": "4847304;1190"
Exemplo de REQUEST:
GET /venda/tv/consulta-dinamica/81AA1C20B1688E4C7424C4E000334DD4/SKY%20TV HTTP/1.1
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczpcL1wvc2FuZGJveC5ncnVwb2NhcmQuY29tLmJyIiwic3ViIjoiNzk3OGI0MzItYzdhYS01MzJhLTgyMjAtMDIxNzlkZWUyZmMwIiwiaWF0IjoxNjUzMDY0NTY0LCJleHAiOjE2NTMyMzczNjQsIm5hbWUiOiJhZG1pbiJ9.Sl6ztTqG4CvHs-QnL6ldIlB31N1bE6-Tautv7BMwn7I
Host: sandbox.grupocard.com.br
Exemplo de RESPONSE:
{
"tipoValor": "1",
"valores": [
{
"chave": "11,90 REC SMART - 3 DI",
"valor": "4847304;1190"
},
{
"chave": "18,90 REC ADVANCED - 7",
"valor": "4847321;1890"
},
{
"chave": "18,90 REC DIGITAL - 30",
"valor": "4847301;1890"
},
{
"chave": "19,90 REC SMART - 7 DI",
"valor": "4847305;1990"
},
{
"chave": "21,90 REC SMART3D + TL",
"valor": "4847309;2190"
},
{
"chave": "33,90 REC NEW MASTER -",
"valor": "4847310;3390"
},
{
"chave": "35,90 REC NEW MASTER 0",
"valor": "4847311;3590"
},
{
"chave": "36,90 REC SMART - 15 D",
"valor": "4847319;3690"
},
{
"chave": "44,90 REC SMART7D+ FUT",
"valor": "4847307;4490"
},
{
"chave": "48,90 REC NEW MASTER 0",
"valor": "4847313;4890"
},
{
"chave": "52,90 REC SMART 7D + C",
"valor": "4847317;5290"
},
{
"chave": "55,90 REC NEW MASTER -",
"valor": "4847299;5590"
},
{
"chave": "57,90 REC SMART15D+TLC",
"valor": "4847303;5790"
},
{
"chave": "58,90 REC NEW MASTER 0",
"valor": "4847312;5890"
},
{
"chave": "65,90 REC NEW MASTER 7",
"valor": "4847318;6590"
},
{
"chave": "69,90 REC SMART15D+ FU",
"valor": "4847306;6990"
},
{
"chave": "81,90 REC SMART 30D + ",
"valor": "4847316;8190"
},
{
"chave": "84,90 REC SMART 30D + ",
"valor": "4847315;8490"
},
{
"chave": "86,90 REC NEW MASTER- ",
"valor": "4847300;8690"
},
{
"chave": "96,90 REC SMART30D+ FU",
"valor": "4847308;9690"
},
{
"chave": "98,90 REC SMART - 60 D",
"valor": "4847320;9890"
},
{
"chave": "142,80 REC DIGITAL 12 M",
"valor": "4847302;14280"
}
]
}
2 - 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: O campo "idExterno" é o identificador da requisição, sendo assim, deve ser enviado com um valor DIFERENTE a cada requisição.
Obs. 4: Para o produto "SKY TV" o campo "valor" não é enviado no payload de requisição, ao invés disso utlizaremos o campo "id_valor" e o seu valor será o obtido na requisição anterior: Consultar Produtos e Valores disponíveis do campo "valor". Os demais produtos de Tv Pré Paga não utilizam o campo "id_valor" em sua requisição. Conforme exemplos abaixo:
Payload de requisição: SKY TV
{
"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
"idExterno":"1002",
"produto":"SKY TV",
"fornecedor":"SKY TV",
"tipoProduto":"ONLINE",
"id_valor":"4847304;1190",
"dataHoraCliente":"2022-06-27T13:09:40.244Z"
}
Payload de requisição: Demais Produtos de Tv Pré Paga
{
"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
"idExterno":"1003",
"produto":"MIX HD - 15d",
"fornecedor":"OI TV",
"tipoProduto":"ONLINE",
"dataHoraCliente":"2022-06-27T13:09:40.244Z",
"cpf":"317.520.441-42",
"valor":"9000"
}
Exemplo de REQUEST:
POST /venda/tv/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: 208
{"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4","idExterno":"1002","produto":"SKY TV","fornecedor":"SKY TV","tipoProduto":"ONLINE","id_valor":"4847304;1190","dataHoraCliente":"2022-06-27T13:09:40.244Z"}
{
"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
"idExterno":"1002",
"produto":"SKY TV",
"fornecedor":"SKY TV",
"tipoProduto":"ONLINE",
"id_valor":"4847304;1190",
"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": "SKY TV"
}
},
"transacao": {
"valor": 1190,
"status": "AUTORIZADA",
"instrucao": "{\"recargaTV\":{\"nsuFornecedor\":\"623445740\",\"mensagens\":\"Recarga feita com sucesso.\",\"mensagem_validade\":\"validos por 3 dias\"}}",
"idTransacao": "35356039710622",
"dataHora": "2022-06-27T09:31:50.000-04:00"
},
"idExterno": "1002"
}
}
3 - 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/tv/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: 149
{"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4","idTransacao":"35356039710622","produto":"SKY TV","dataHoraCliente":"2022-06-27T13:09:40.244Z"}
{
"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
"idTransacao":"35356039710622",
"produto":"SKY TV",
"dataHoraCliente":"2022-06-27T13:09:40.244Z"
}
Exemplo de RESPONSE:
{
"transacao": {
"status": "EFETIVADA",
"idTransacao": "35356039710622"
}
}
Fluxo de cancelamento
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 desfazimento 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: O campo "idExterno" é o identificador da requisição, sendo assim, deve ser enviado com um valor DIFERENTE a cada requisição.
Obs. 4: Para o produto "SKY TV" o campo "valor" não é enviado no payload de requisição, ao invés disso utlizaremos o campo "id_valor" e o seu valor será o obtido na requisição anterior: Consultar Produtos e Valores disponíveis do campo "valor". Os demais produtos de Tv Pré Paga não utilizam o campo "id_valor" em sua requisição. Conforme exemplos abaixo:
Payload de requisição: SKY TV
{
"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
"idExterno":"1002",
"produto":"SKY TV",
"fornecedor":"SKY TV",
"tipoProduto":"ONLINE",
"id_valor":"4847304;1190",
"dataHoraCliente":"2022-06-27T13:09:40.244Z"
}
Payload de requisição: Demais Produtos de Tv Pré Paga
{
"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
"idExterno":"1003",
"produto":"MIX HD - 15d",
"fornecedor":"OI TV",
"tipoProduto":"ONLINE",
"dataHoraCliente":"2022-06-27T13:09:40.244Z",
"cpf":"317.520.441-42",
"valor":"9000"
}
Exemplo de REQUEST:
POST /venda/tv/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: 225
{"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4","idExterno":"1003","produto":"MIX HD - 15d","fornecedor":"OI TV","tipoProduto":"ONLINE","dataHoraCliente":"2022-06-27T13:09:40.244Z","cpf":"317.520.441-42","valor":"9000"}
{
"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
"idExterno":"1003",
"produto":"MIX HD - 15d",
"fornecedor":"OI TV",
"tipoProduto":"ONLINE",
"dataHoraCliente":"2022-06-27T13:09:40.244Z",
"cpf":"317.520.441-42",
"valor":"9000"
}
Exemplo de RESPONSE:
{
"venda": {
"estabelecimento": {
"cnpjCpf": "75.862.116/0001-39",
"nome": "Homologação Plataforma WS recarga Multiproduto - NÃO MEXER"
},
"produto": {
"fornecedor": {
"nome": "SKY TV"
}
},
"transacao": {
"valor": 1190,
"status": "AUTORIZADA",
"instrucao": "{\"recargaTV\":{\"nsuFornecedor\":\"623445740\",\"mensagens\":\"Recarga feita com sucesso.\",\"mensagem_validade\":\"validos por 3 dias\"}}",
"idTransacao": "35356039710622",
"dataHora": "2022-06-27T09:31:50.000-04:00"
},
"idExterno": "1002"
}
}
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/tv/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
{"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4","idExterno":"1003","dataHoraCliente":"2022-06-27T13:09:40.244Z"}
{
"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
"idExterno":"1003",
"dataHoraCliente":"2022-06-27T13:09:40.244Z"
}
Exemplo de RESPONSE:
{
"transacao": {
"status": "CANCELADA"
}
}