ER_PCREQ-8286_Reenvia_e-mail_por_documento

Reenvia e-mail por documento

(Obrigatório)

Informações Gerais

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

(Obrigatório)

Objetivo

Disponibilizar uma API com a finalidade de reenviar e-mail de um documento.

(Obrigatório)

Definição da Regra de Negócio

A API será na estrutura WS REST com o nome RestEnvMail e com apenas o método GET, que receberá a mensagem JSON codificada em base64 e chamará a função EnvMailTss() passando a mensagem JSON decodificada.

Através da API de reenviar e-mail por documento, os clientes do TSS poderão reenviar o e-mail do documento.

O envio será para um documento.

O critério para o envio do e-mail será com base nos dados de entrada.

A API terá como retorno verdadeiro, caso envie o e-mail e falso caso não consiga enviar o e-mail.

O consumo da API deverá ser realizado através de mensagens JSON definidas na função EnvMailTss().

O processo de Deserialização de mensagens deverá ser realizado através da função FwJsonDeserialize().

Os códigos de status serão baseados no formato padrão de mensagens HTTP, conforme o link:

https://pt.wikipedia.org/wiki/Lista_de_c%C3%B3digos_de_status_HTTP

WebService: RestEnvMail
WebService responsável pela definição da Interface da API de busca reenvia e-mail por documento.
O WebService deverá receber mensagens na estrutura JSON codificado em base64, onde serão decodificadas e passadas como parâmetro para a função EnvMailTss().
O retorno do WebService será uma mensagem JSON.
Todos os parâmetros da mensagem serão obrigatórios.

Parâmetros:

JSon = ew0KImVtcHJlc2EiOg0KeyJFbnRpZGFkZSI6ICIwMDAwMDIifSwNCiAidGlwZG9jIjoibmZlIiwNCiAicGFyYW1ldHJvcyI6eyJkb2NpZCI6IjAwMDAwMSJ9DQp9

Mensagem JSON decodificada:
{

"empresa":

{"Entidade": "000002"},

 "tipdoc":"nfe",

 "parametros":{"docid":"000001"}

}
 

Retorno:

Retorno negativo -

{

  "result":

   {

    "retproc": ""

   },

  "error": "Estrutura do objeto inválida."

}

Retorno positivo –

{

  "result": "T", //ou "F"

  "error": ""

}
 

Função:EnvMailTss()

Função responsável pela definição da Interface da API retorna xml por documento.

A função EnvMailTss definirá a estrutura da API. A função deverá ser definida em um fonte.prw definido com o mesmo nome da função.

A função EnvMailTss deverá ser implementada apenas como função de interface para a API. Deverá ser totalmente desacoplada de qualquer definição de instrução de processamento, devendo apenas realizar as devidas validações das mensagens. Todo o processamento deverá estar definido em funções auxiliares.

A função EnvMailTss() deverá receber mensagens na estrutura JSON, onde serão convertidas em objeto pela função fwJsonDeserialize().

Caso não haja erro na deserialização de JSON para objeto, será chamada a rotina ValDadosEmail(), passando como parâmetro o objeto.

A função ValDadosEmail () retornará verdadeiro caso envie o e-mail e falso caso não consiga enviar o e-mail. Essa informação será passada como parâmetro na chamada da função getJSONResp() junto com o código de status e mensagem de erro (caso exista). O retorno da função getJSONResp() é a mensagem  já na estrutura JSON.

Todos os parâmetros da mensagem serão obrigatórios.

A rotina EnvMailTss() será finalizada e como retorno será passado a mensagem na estrutura JSON.

Parâmetros:

cJsonRequest=

{

"empresa":

{"Entidade": "000002"},

 "tipdoc":"nfe",

 "parametros":{"docid":"000001"}

}
 

Retorno:

Retorno negativo -

{

  "result":

   {

    "retproc": ""

   },

  "error": "Estrutura do objeto inválida."

}

Retorno positivo –

{

  "result": "T", //ou "F"

  "error": ""

}

Função: ValDadosEmail()

A função ValDadosEmail() receberá como parâmetro o objeto da requisição, validará todos os campos quanto a obrigatoriedade, tamanho e tipo de dados. Se algum dado estiver inconsistente, deverá retorna a mensagem de validação correspondente informando.

Os dados contidos no objeto recebido como parâmetro, serão validados afim de identificar quais foram preenchidos, todos os campos são necessários para o retorno.

A função validará o tipo de documento, afim de identificar se é válida, esta informação estará contida dentro do objeto recebido como parâmetro.

Com as informações tipo de documento e número da entidade, será chamada a função PrepEnvMail(), para essa função serão passados como parâmetros: o número da entidade do cliente, o tipo de documento, número do documento e série do documento. O retorno desta função será verdadeiro caso consiga enviar o e-mail ou falso caso não consiga enviar o e-mail.

Após obter o retorno da rotina PrepEnvMail (), a função ValDadosEmail () será encerrada, retornando verdadeiro ou falso.

Parâmetros: 

GetXml(oDados,cError)

oDados – Objeto contendo as informações da requisição: entidade, Nfe_Id e série do documento.

cError – Mensagem de erro, caso exista.

Retorno:

lOk – Verdadeiro caso consiga enviar o e-mail e falso caso não consiga enviar o e-mail.

Função: PrepEnvMail()

A função receberá como parâmetro, a entidade do cliente, o tipo de documento, Nfe_Id, mensagem de erro e código do status.

Hoje o TSS só envia e-mail quando o tipo de documento for “NFE”, caso contrário não enviará o e-mail.

A função por meio de Query, localizará o documento na tabela correspondente, obtendo o RECNO do registro, este RECNO será passado como parâmetro para as funções: TSSSendNfE caso o tipo de documento esteja na SPED050 e TSSSendNfS caso o tipo de documento esteja na SPED051.

Parâmetros: 

(cEnt,cTipo,cDoc,cSerie,cError)

cEnt – Código da entidade do cliente.

cTipo – Tipo de documento: ‘NFE’;’NFSE’, etc.

cDoc – Nfe_Id.// Série + número do documento

cError – Mensagem de erro, caso exista.

Retorno:

lRet - Verdadeiro caso consiga enviar o e-mail e falso caso não consiga enviar o e-mail.

Função: TSSSendNFe()

A função receberá como parâmetro, o RECNO do registro da tabela SPED050.

A função validará os dados do documento.

A rotina busca os anexos para o e-mail, .pdf e .xml.

Após obter os anexos, a rotina chamará a função NFeSendMail, passando como parâmetro o RECNO do registro na SPED050, o assunto do e-mail, arquivo .xml e arquivo .pdf, o seu retorno será lógico.

A rotina TSSSendNFE retornará verdadeiro, caso não consiga enviar o e-mail, a rotina retornará falso.

Parâmetros: 

cRECNO – Número RECNO do registro na tabela SPED050.

Retorno:

lRet - Verdadeiro caso consiga enviar o e-mail e falso caso não consiga enviar o e-mail.

Função: NFESendMail()

A função receberá como parâmetro, o RECNO do registro na SPED050, o assunto do e-mail, arquivo .xml e arquivo .pdf.

A função validará os dados do documento.

Após validar os dados a função chamará a rotina SMTPConnecte. Com o retorno desta rotina, a função NFeSendMail validará se o e-mail foi enviado ou não.

Se o e-mail foi enviado a função NFeSendMail retornará verdadeiro, se o e-mail não for enviado, a função retornará falso.

Parâmetros: 

nRECNO – Número RECNO do registro na tabela SPED050.

cAssunto – Assunto do e-mail

cAnexo – caminho mais nome do arquivo .xml

cAnexo2 – caminho mais nome do arquivo .pdf

Retorno:

lRet - Verdadeiro caso consiga enviar o e-mail e falso caso não consiga enviar o e-mail.

Função: GetJSONResp()

A rotina consiste em obter os dados de entrada e gerar a mensagem em estrutura JSON.

A rotina retornará uma string na estrutura JSON

Parâmetros: 

cHttpStatus – Código do Status.

lOk – Variável lógica.

cError – Mensagem de erro.

Retorno:

cJSONResponse – String na estrutura JSON.