CTeEnviaCECTe

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-e’s 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.