A função CTeOSEnviarGTV é usada para registrar o evento de GTV de emitente de CT-e OS de serviço Transporte de Valores.
Tipo de Retorno
Boolean
Pacote
A função CTeOSEnviarGTV está definida no pacote CTeOSEnviarGTV.pkg.
Sintaxe
Move (CTeOSEnviarGTV(&{vParams})) to {bRetorno}
Onde:
- &{vParams} é uma variável do tipo tEnviarGTV, passada por referência, contendo os parâmetros para execução da função e campos de retorno, conforme abaixo:
- sSiglaWS: é a sigla do Web Service para o qual será enviada a solicitação;
- iTipoAmbiente: indica o ambiente onde a consulta será feita, sendo 1-Produção e 2-Homologação;
- sNomeCertificado: é a string que representa o certificado digital que será usado na transmissão dos dados. Se não for informado, uma tela será exibida para o usuário escolher um dos certificados instalados para o usuário corrente. Veja mais detalhes sobre como informar este parâmetro clicando aqui;
- sVersao: versão do evento. Caso não seja informado será atribuído "3.00" ou "4.00", caso esteja utilizando a versão 2024/01 ou superior;
- sChaveCTe: informar a chave do CT-e OS ao qual o GTV será registrado e vinculado;
- iNroInfGTV: informar o número sequencial da informação do GTV. Deve ser iniciada com 1 e o valor máximo é 99. É um campo de controle do usuário, o Web Service não permite a duplicidade desta numeração por CT-e OS e nem controla a ordem crescente.
- vtXMLInfGTV: é um array de estrutura do tipo tCTeOSinfGTV onde deverão ser informadas as tags refente ao grupo infGTV;
- sdhEvento: informar a data e hora do evento (data e hora com fuso horário): "AAAA-MM-DDTHH:MM:SS-HH:00";
- sProxy: endereço do servidor proxy que deve ser usado para realizar a consulta;
- sUsuario: usuário que será autenticado no servidor proxy para realizar a consulta;
- sSenha: senha do usuário que será autenticado no servidor proxy para realizar a consulta;
- sLicenca: chave da DLL. Obrigatório para uso no ambiente de produção;
- bExibeErro: indica se as mensagens de erro do processo devem ser mostradas (True) ou não (False);
- sArquivoXML: caminho onde será criado o arquivo XML;
- snProtocolo: retorna o número do protocolo de registro do evento;
- sdProtocolo: retorna a data e hora de registro do evento do CT-e pela SEFAZ;
- sXMLProtocol: retorna o XML protEvento (XML do evento registro de evento mais o protocolo de registro da SEFAZ);
- sMsgDados: retorna a mensagem XML do evento que foi enviado ao WS;
- sMsgRetWS: retorna a mensagem XML de resposta do WS;
- icStat: retorna o código numérico que representa o retorno da consulta realizada na SEFAZ;
- sMsgResultado: retorna a literal do resultado da chamada do WS.
- {bRetorno} é o retorno da chamada da função. True indica que o evento GTV foi registrado. Um retorno False indica que o evento GTV não foi registrado. Neste caso, consulte o valor de icStat e sMsgResultado para saber o motivo.
Não encontrou o que precisava, entre em contato conosco.