Gerar voucher negociação

Getvouchernegociacao

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

Retorna um voucher para utilização.

Exemplo: A instituição possui uma negociação que permite a geração de voucher ilimitado. É um serviço pós pago.

Headers

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

Request Body

Name	Type	Description
usuario*	String	Usuário de acesso
senha*	String	Senha gerada através da aplicação web(Gerador de senha)
codProduto*	String	Código do Produto
CodVenda*	String	Código de Venda
negociacao*	String	Código da Negociação
sequencia*	String	Contador sequencial
sugestao	String	Sugestão de uso
cpfcnpj	String	Sugestão de uso
restrito	String	Uso restrito para sugestão de uso
Hmac*	String	Cálculo para autenticação
Serial	string	Serial do certificado a ser renovado. O usuário possui um certificado com data de expiração em 20/07/2025. O gestor responsável na instituição informa previamente o serial number do certificado, por exemplo: 11DE465SF.... Regras de validação: Regra 1: Caso o usuário tente importar o voucher utilizando um certificado diferente do serial informado, o processo será bloqueado com erro de validação. Regra 2: A validação do serial somente será aplicada se o campo serial for preenchido. Se não informado, qualquer certificado será aceito.
Email	string	E-mail que receberá o voucher

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. nonce: O número nonce deve ser composto pelo timestamp (Unix Timestamp sem microssegundos) concatenado com uma parte pseudoaleatória de 4 (quatro) números.

4. codproduto: Código do produto no qual o voucher está vinculado. Os códigos dos produtos serão fornecidos pela SOLUTI no momento da integração.

5. codvenda: Código da venda do seu CRM/ERP. Caso não possua CRM/ERP, envie um número sequencial.

6. negociacao : Código da negociação no qual o voucher está vinculado. Os códigos de negociação serão fornecidos pela SOLUTI no momento da integração.

7. sequencia: Contador sequencial.

8. sugestao: Nome completo do cliente que irá receber o voucher. Enviar em branco caso não deseja informar a sugestão de uso.

9. cpf-cnpj: CPF/CNPJ do cliente que irá receber o voucher. Enviar em branco caso envie o campo sugestao em branco.

10. restrito: Informe true para que o voucher seja de uso restrito para o cpf-cnpj informado ou informe false para que o voucher não seja de uso restrito.

11. hmac: Valor utilizado para autenticação e validação dos dados enviados. O valor de m é composto pela concatenação de todos os parâmetros anteriores (usuario, nonce, codproduto, codvenda, sugestão, cpf-cnpj, restrito, serial, email). Clique aqui para verificar como é calculado o valor da chave hmac.

12. serial : Será informado o serial do certificado.

13. email : E-mail que receberá o voucher

Código de Exemplo

PHP

<?php

$usuario = 'central.integracoes';
$senha   = '7b780f0c0d021d68f86ce602se9f90gfdec0eefaa7b32a3abef85dd6b7f6';

$codProduto = '10';
$codVenda   = '1234';
$negociacao = '123456';
$sequencia  = '1';
$sugestao   = '';
$cpfcnpj    = '';
$restrito   = '';
$serial     = '';
$email      = '';

$key             = $senha;
$nonce           = time() . rand(1000, 9999);
$hkey            = $nonce . $key;
$hash_hkey       = hash("sha256", $hkey);
$dados           = $usuario . $nonce . $codProduto . $codVenda . $negociacao . $sequencia . $sugestao . $cpfcnpj . $restrito . $serial . $email;
$hash_hkey_dados = hash("sha256", $hkey . $dados);
$hmac            = hash("sha256", $hash_hkey . $hash_hkey_dados);

try {
        $soap = new SoapClient("https://sdealhom.soluti.com.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,
        'Codproduto'   => $codProduto,
        'Codvenda'     => $codVenda,
        'Negociacao'   => $negociacao,
        'sequencia'    => $sequencia,
        'sugestao'     => $sugestao,
        'cpf-cnpj'     => $cpfcnpj,
        'restrito'     => $restrito,
        'hmac'         => $hmac,
        'serial'       => $serial,
        'Emailcliente' => $email
        
    );

    $resposta = call_user_func_array(array($soap, 'getVoucherNegociacao'), $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 o voucher para utilização.

{
    "status":"1",
    "mensagem":"0003a53a6b02"
}

status : 2

Retorna esse status quando a negociação não for encontrada.

{
    "status":"2",
    "mensagem":"Negociação não encontrada."
}

status : 3

Retorna esse status quando a negociação não está ativa.

{
    "status":"3",
    "mensagem":"A Negociação não está ativa, favor entrar em contato com o Departamento Comercial da Soluti."
}

status : 4

Retornará esse status quando o produto não estiver disponível ou inexistente

{
    "status":"4",
    "mensagem":"Produto não disponível/inexistente."
}

status : 5

Retorna esse status quando o número da sequência não for informado.

{
    "status":"5",
    "mensagem":"Número da sequência não informado."
}

status : 6

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

{
    "status":"6",
    "mensagem":"Informe a sugestão de uso."
}

status : 7

Retorna esse status quando né informado o CPF/CNPJ da sugestão de uso.

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

status : 8

Retorna esse status quando deve ser informado se o voucher será de uso restrito ou não.

{
    "status":"8",
    "mensagem":"Informe se o voucher será de uso restrito ou não."
}

status : 9

Retorna esse status quando não é informado as opções "true" ou "false"

{
    "status":"9",
    "mensagem":"Informe true para voucher restrito ou false para não restrito."
}

status : 10

Retorna esse status quando o CNPJ informado for inválido.

{
    "status":"10",
    "mensagem":"O CNPJ informado é inválido."
}

status : 11

Retorna esse status quando o CPF informado for inválido.

{
    "status":"11",
    "mensagem":"O CPF informado é inválido."
}