Função: Informar ao TOTVS Services Sped qual o repositório do certificado digital, no formato ( KeyStore ), que deverá ser utilizado para assinatura de documentos eletrônicos e/ou comunicação com as entidades do respectivos documentos. Lembre-se que o certificado de comunicação foi importado na instalação do mesmo e seu gerenciamento é feito pelo sistema operacional.  

Uso do Banco de dados: Persistente ou volátil.



<soap:Body>
<CFGKEYSTORE>

<USERTOKEN>STRING</USERTOKEN>

<ID_ENT>STRING</ID_ENT>

<RETCFGKEYSTORE>

<HOSTNAME>STRING</HOSTNAME>

<ISSUER>STRING</ISSUER>

<PASSWORD>BASE64BINARY</PASSWORD>

<PATH>STRING</PATH>

<SUBJECT>STRING</SUBJECT>

<SYSTEM>STRING</SYSTEM>

<TYPE>STRING</TYPE>

</RETCFGKEYSTORE>

</CFGKEYSTORE>

</soap:Body>

ParâmetroTipoTamPaiObservação
USERTOKENAlfanumérico06-Token de bilhetagem para execução do serviço.
ID_ENTAlfanumérico06-Código da entidade retornado pelo WS SpedAdm/AdmEmpresas.
HOSTNAMEAlfanumérico1-10-

Informar o nome do computador onde foi instalado o TSS e deve ser o mesmo onde encontrasse o repositório keystore.

ISSUERAlfanumérico1-50-

Informar o emissor na ordem do formato keystore e somente quando houver conteúdo na chave separando por ','
Exemplo: BR,ICP-Brasil,Autenticado por CERTIFICADORA,Assinatura Tipo A1,EMPRESA SA,empresa.keystore@email.com.br

Formato : C,O,OU,OU,CN,E

PASSWORDBinário1-250-Informe a senha da private key. O formato base64binary somente foi utilizado neste parâmetro para proteger a senha do usuário, considerando que a comunicação pode ser http.
PATHAlfanumérico1-Informar um caminho onde foi instalado do repositório 1 - MY , 2 - Root, 3 - Trust, 4 - CA
SUBJECTAlfanumérico1-50-

Informar o requerente na ordem do formato keystore e somente quando houver conteúdo na chave separando por ','
Exemplo: BR,ICP-Brasil,Autenticado por CERTIFICADORA,Assinatura Tipo A1,EMPRESA SA,empresa.keystore@email.com.br

Formato : C,O,OU,OU,CN,E

SYSTEMAlfanumérico1
-Preencher com um sistema de arquivo válido 1 - LocalMachine , 2 - Default
TYPEAlfanumérico1-Preencher com um tipo de sistema de repositório válido 1 - winstore , 2 - linuxstore




<soap:Body>
<MSG>STRING</MSG>
</soap:Body>


ParâmetroTipoTamPaiObservação
MSGAlfanumérico1-250-

Em caso de sucesso, retorna o Alfanumérico:

Registrado para: EMPRESA SA/emailAddress=empresa.keystore@email.com.br
Validade de DD/MM/AAAA ate DD/MM/AAAA
keystore:ok

MSGAlfanumérico1-250-

Em caso de fracasso, retorna o Alfanumérico:

KeyStore não encontrado !!!

keystore:nok

MSGAlfanumérico1-250-

Em caso de fracasso, retorna o Alfanumérico:

Certificado vencido

keystore:nok





FaultDescrição
Invalid TokenO parâmetro USERTOKEN foi passado incorretamente.
TOTVS Service SOA TSS : 001Código da entidade inválida.
TOTVS Service SOA TSS : 002Código da entidade em branco.
TOTVS Service SOA TSS : 003Nome do computador não informado: | hostname |
Informar o nome do computador
TOTVS Service SOA TSS : 004

Emissor invalido | issuer | formato: C,O,OU,OU,CN,E

Informar na ordem do formato keystore e somente quando houver conteudo na chave separando por " , "

Exemplo: BR,ICP-Brasil,Autenticado por CERTIFICADORA,Assinatura Tipo A1,EMPRESA SA,empresa.keystore@email.com.br

TOTVS Service SOA TSS : 005PASSWORD invalido.
TOTVS Service SOA TSS : 006Preencher com um caminho válido:  | path | 1 - MY , 2 - Root, 3 - Trust, 4 - CA
TOTVS Service SOA TSS : 007

Requerente invalido | Subject | formato: C,O,OU,OU,CN,E
Informar na ordem do formato keystore e somente quando houver conteudo na chave separando por " , "

Exemplo: BR,ICP-Brasil,Autenticado por CERTIFICADORA,Assinatura Tipo A1,EMPRESA SA,empresa.keystore@email.com.br

TOTVS Service SOA TSS : 008Preencher com um sistema de arquivo válido:  | system | 1 - LocalMachine , 2 - Default
TOTVS Service SOA TSS : 009Preencher com um tipo válido:  | type | 1 - winstore , 2 - linuxstore
TOTVS Service SOA TSS : 010

KeyStore não aceito em servidor Linux para esta versão de binário