A função CTeEnviaCECTe é usada para enviar uma CECTe (Comprovante de Entrega Eletrônico) do CT-e.
Tipo de Retorno
Boolean
Pacote
A função CTeEnviaCECTe está definida no pacote CTeEnviaCECTE.pkg.
Sintaxe
Move (CTeEnviaCECTe(&{vParam})) to bRetorno
Onde:
- &{vParam} é uma variável do tipo tEnviaCECTE_Parametros que deve ser passada por referência contendo os parâmetros para execução da função e possui também alguns campos de retorno, conforme abaixo:
- sSiglaWS: é a sigla do Web Service para o qual será enviada a solicitação;
- iAmbiente: 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: é a versão da consulta a ser feita. Informe "3.00" ou "4.00", caso esteja utilizando a versão 2024/01 ou superior;
- nroCECTe: é o número sequencial do comprovante de entrega;
- sChaveCTe: deve ser informado a chave do CT-e correspondete ao comprovante de entrega;
- snProtocoloCTe: é o número do protocolo de autorização do CT-e;
- sdhEntrega: é a data e hora da Conclusão da Entrega no formato "AAAA-MM-DDTHH:MM:SS-HH:00";
- snDoc: é o número do documento de identificação da pessoa que recebeu a entrega da carga;
- sxNome: é o nome da pessoa que recebeu a entrega da carga;
- nlatitude: é a latitude do ponto da entrega;
- nlongitude: é a longitude do ponto da entrega;
- sPathComprovanteEntrega: é o caminho completo onde está salva a imagem do comprovante de entrega que será utilizado na geração do parâmetro shashEntrega. Parâmetro adicionado na versão 2024/01;
- shashEntrega: é o hash (SHA1) no formato Base64. Será gerado automaticamente pela função;
- sdhHashEntrega: é a data e hora da geração do hash da entrega no formato "AAAA-MM-DDTHH:MM:SS-HH:00". Será gerado automaticamente pela função;
- ndhHashEntregaTZ: é o TimeZone da hash de entrega;
- sChavesNFe: informar as chaves das NF-es do CT-e;
- sdhEvento: é a data e hora do evento.
- sProxy: é o endereço do servidor proxy que deve ser usado para realizar a consulta;
- sUsuarioProxy: é o usuário que será autenticado no servidor proxy para realizar a consulta;
- sSenhaProxy: é a senha do usuário que será autenticado no servidor proxy para realizar a consulta;
- sLicencaCTeDLL: é a chave da DLL que será verificada para permitir a consulta em ambiente de produção;
- sArquivoRetorno: é o caminho do arquivo onde será gerado o XML de retorno;
- iRetcStat: é o código do retorno da função;
- sRetMsgDados: retorna a mensagem XML do evento comprovante de entrega;
- sRetMsgRetWS: retorna a mensagem XML de resposta do WS;
- sRetMsgResultado: retorna a literal do resultado da chamada do WS;
- sRetNroProtocolo: retorna o número do protocolo do registro do evento;
- sRetdhProtocolo: retorna a data e hora do registro do evento;
- sRetornoXML: retorna o XML com o protocolo do registro do evento que é anexado no CT-e. Parâmetro adicionado na versão 2024/01;
- iRetCodigoSalvaArq: retorna o código referente a tentativa de salvar o arquivo XML de retorno. Retorna 0 (zero), se salvo com sucesso ou 1, caso ocorra algum erro. Neste caso, será necessário consultar o parâmetro sRetMsgResultadoSalvaArq. Parâmetro adicionado na versão 2024/01;
- sRetMsgResultadoSalvaArq: retorna o literal com o resultado da tentativa de salvar o XML com o protocolo do evento. Parâmetro adicionado na versão 2024/01.
- {bRetorno} será True se a CeCTe foi vinculado com sucesso (iRetcStat=135). E será False para qualquer outro retorno. A função irá tratar qualquer retorno difente de 135 como erro e irá exibir o erro se o parâmetro bExibeErro for True. Se desejar fazer seus próprios tratamentos para códigos de retorno específicos, configure o parâmetro bExibeErro como False.
Observações
- Para mais detalhes sobre a sigla do Web Service a ser usada, clique aqui.
- A função CTeCeCTe está disponível a partir da versão 2019/01 da CTeLibrary.
Não encontrou o que precisava, entre em contato conosco.