Inserir sugestão de uso

Esse serviço quando consumido, verifica os parâmetros e insere/altera a sugestão de uso do voucher.

Sugestaodeusovoucher

POST https://sdealhom.soluti.com.br/GVS/webservices/GVSServices.jws?wsdl

Método utilizado para inserir sugestão de uso para o voucher.

Headers

Name	Type	Description
Content-Type*	String	text/xml
SOAPAction	String	sugestaodeusovoucher

Request Body

Name	Type	Description
usuario*	String	Usuário de acesso
senha*	String	Senha gerada através da aplicação web(Gerador de senha)
voucher*	String	Número do voucher que deseja inserir a sugestão de uso
nome*	String	Nome da sugestão de uso
cpfcnpj*	String	CPF/CNPJ da sugestão de uso
restrito*	String	Uso restrito para sugestão de uso

Conteúdo dos parâmetros a serem enviados:

1. usuario: Usuário utilizado para acessar a aplicação web.

2. senha : Senha gerada através da aplicação web(Gerador de senha).

3. voucher : Número do voucher que deseja inserir a sugestão de uso.

4. nome : Nome da sugestão de uso.

5. cpfcnpj : CPF/CNPJ informado na dugsetão de uso.

6. restrito : Informe "false" para que o voucher não seja de uso restrito (uso restrito foi descontinuado).

Código de exemplo

<?php

i$usuario  = "jorge.justino";
$senha    = "e9ebc6f0a8debddbd95ddbf74gf9h660a0327d63c87892c58544540ea73d188a3cc";
$voucher  = "001fd7d28f18";
$nome     = "Jorge Justino";
$cpfcnpj  = "72925515134";
$restrito = "false";

$key             = $senha;
$nonce           = time() . rand(1000, 9999);
$hkey            = $nonce . $key;
$hash_hkey       = hash("sha256", $hkey);
$dados           = $usuario . $nonce . $voucher . $nome . $cpfcnpj . $restrito;
$hash_hkey_dados = hash("sha256", $hkey . $dados);
$hmac            = hash("sha256", $hash_hkey . $hash_hkey_dados);

try {
            $soap = new SoapClient("https://gvshom.ca.inf.br/GVS/webservices/GVSServices.jws?wsdl", array(

        'trace' => 1,
        'soap_version' => SOAP_1_2,
        'cache_wsdl' => WSDL_CACHE_NONE,
        'stream_context' => stream_context_create(
                array(
                    'ssl' => array(
                        'verify_peer' => false,
                        'verify_peer_name' => false
   ))))
                        );

    $jsonReq = array(
        'usuario'  => $usuario,
        'nonce'    => $nonce,
        'voucher'  => $voucher,
        'sugestao' => $nome,
        'cpf-cnpj' => $cpfcnpj,
        'restrito' => $restrito,
        'Hmac'     => $hmac
    );
    $resposta = call_user_func_array(array($soap, 'sugestaodeusovoucher'), $jsonReq);


    echo ($resposta);

} catch (Exception $e) {
    echo $e->getMessage();
}

Tipos de respostas

status : 0

Retorna esse status quando o cálculo do Hmac for inválido.

{
    "status": "0",
    "mensagem": "Autenticação inválida/HMAC inválido."
}

status : 1

Retorna esse status quando o voucher não for encontrado.

{
    "status":"1",
    "mensagem":"Voucher não encontrado."
}

status : 2

Retorna esse status quando o voucher já foi utilizado.

{
    "status":"2",
    "mensagem":"Voucher já utilizado."
}    

status : 3

Retorna esse status quando o CPF/CNPJ não foi informado.

{
    "status":"3",
    "mensagem":"Informe o CPF/CNPJ da sugestão de uso."
}

status : 10

Retorna esse status quando a sugestão de uso for informada.

{
  "status": "10",
  "mensagem": "Sugestão de uso atualizada com sucesso."
}