Validar dados da Emissão

valida-dados-emissao

POST <base_url>/webservice/valida-dados-emissao

Retorna as informações sobre a solicitação, informando se é válida ou não para início da emissão

Path Parameters

Name	Type	Description
Accept	string	application/json

Request Body

Name	Type	Description
solicitacao*	string	Número do usuário
mensagem*	string	mensagem JSON para o Servidor
nonce1*	string	Nonce calculado pelo Cliente
hmac*	string	Hmac calculado pelo Cliente

200

{
    "mensagem": {
        "certificado": {
            "categoria": "AC SOLUTI MULTIPLA V5",
            "nome": "ACS PJ A1 V5",
            "idpolitica": "0",
            "politica": "Política padrão",
            "perfiliti": "A1 PJ",
            "midia": "A1",
            "CN": "EMPRESA DE TESTE:33954432000190",
            "validade": "12",
            "cnpj": "33954432000190",
            "email": "[e-mail]",
            "senhausuario": "0"
        },
        "emissao": {
            "status": "0",
            "obs": "Aguardando CSR.",
            "digitalterm_hash": "302f300b060960864801650304020104208ff977daa2d88ca9519401d0a7c2136dbbba105b5240ae801b04d9f26305432b"
        },
        "kaspersky": {
            "direito": false
        },
        "datetime": "Mon, 24 Aug 2020 12:51:13 -0300"
    },
    "hmac": "2018a708f85f0d2ab9bca22d1deec5a98abfba6fdb92c0450ce9a40d37e2b858"
}

403

422

Os dados devem ser enviados como form-data.

Este serviço requer autenticação hmac sem sessão.

O conteúdo do parâmetro mensagem deverá estar no formato JSON com os seguintes itens:

• mensagem : Deverá conter o número do usuário (código da solicitação).

Código de exemplo

PHP

<?php
   
    $baseUrl = "https://arsolutihom.acsoluti.com.br";
    
    //Setando o código da solicitação (Número do usuário)
    $solicitacao = "113D2008243B64AE 33954432000190";

    //Setando o conteúdo da chave mensagem
    $mensagem = json_encode(array("mensagem" => $solicitacao));

    //Setando a senha de emissão do Certificado Digital
    $senhaEmissao = "96acdian22";

    //Setando o nonce do Cliente
    $nonce1 = rand(1000, 9999) . time();

    //Montando o hkey
    //Hmac sem sessão
    $hkey = hash("sha256", $nonce1 . $senhaEmissao);
    
    //Montando o hmac
    $hmac = hash("sha256", $hkey . $mensagem);

    require_once 'HTTP/Request2.php';
    $request = new HTTP_Request2();
    $request->setUrl($baseUrl . "/webservice/valida-dados-emissao");
    $request->setMethod(HTTP_Request2::METHOD_POST);
    $request->setHeader(array(
        'Accept' => 'application/json'
    ));

    $request->addPostParameter(array(
        'solicitacao' => $solicitacao,
        'mensagem' => $mensagem,
        'hmac' => $hmac,
        'nonce1' => $nonce1
    ));

    $response = $request->send();
    
    $body = json_decode($response->getBody(),true);
    
    //Verifica se digitalterm_hash esta presente na resposta
    if(isset($body["mensagem"]["emissao"]["digitalterm_hash"])) {
        //Armazenando o hash do Termo Digital
        $digitalterm_hash = $body["mensagem"]["emissao"]["digitalterm_hash"];
    }
    
    echo $response->getBody();

O código da solicitação(número do usuário) é informado ao cliente via e-mail após a aprovação do Certificado Digital, já a senha de emissão é cadastrada pelo cliente no momento da solicitação na AR.

Resposta esperada

{
    "mensagem": {
        "certificado": {
            "categoria": "AC SOLUTI MULTIPLA V5",
            "nome": "ACS PJ A1 V5",
            "idpolitica": "0",
            "politica": "Política padrão",
            "perfiliti": "A1 PJ",
            "midia": "A1",
            "CN": "EMPRESA DE TESTE:33954432000190",
            "validade": "12",
            "cnpj": "33954432000190",
            "email": "[e-mail]",
            "senhausuario": "0"
        },
        "emissao": {
            "status": "0",
            "obs": "Aguardando CSR.",
            "digitalterm_hash": "302f300b060960864801650304020104208ff977daa2d88ca9519401d0a7c2136dbbba105b5240ae801b04d9f26305432b"
        },
        "kaspersky": {
            "direito": false
        },
        "datetime": "Mon, 24 Aug 2020 12:51:13 -0300"
    },
    "hmac": "2018a708f85f0d2ab9bca22d1deec5a98abfba6fdb92c0450ce9a40d37e2b858"
}

Se for uma emissão online de aprovação direta não terá o digitalterm_hash presente na resposta. Portanto na emissão não haverá validação de assinatura do digitalterm_hash.

Guarde o conteúdo da chave digitalterm_hash, será necessário assiná-lo e enviá-lo para o serviço de emissão.

Utilize o valor da chave status no array de emissao para definir qual será o fluxo a ser seguido:

0	1	2	8	9
Aguardando CSR	Par de chaves gerado	Certificado já emitido	Erro ao enviar solicitação de emissão	Erro ao emitir certificado

Emitir Certificado