PHSYS - Wiki

Conceito

Os anexos associados aos tipos de documentos, permitem a geração de relatórios específicos junto ao e-mail enviado para o destinatário na emissão do documentos fiscais. Esses relatórios serão anexados sempre que houver a geração do e-mail a partir do faturamento.

O objeto dos anexos, é possibilitar o envio de documentos de origem da nota fiscal, como os pedidos de venda ou ordens de serviço.

Para inclusão de um relatório como anexo, é necessário o preenchimento das informações:

• Formato: Será o formato do relatório que será gerado para envio junto ao e-mail.
• Comando SQL: O comando SQL tem o objetivo de recuperar os IDs dos documentos necessários para gerar o formato do relatório especificado.
  • OBS: Para que o comando SQL seja executado com precisão, é necessário ter um parâmetro nomeado como "ID", e o resultado dessa consulta SQL deve retornar as informações relacionadas a esse "ID".

Exemplo de comando SQL para o Pedido de Venda

 SELECT ATE.PEDIDO AS ID  
 FROM DOCUMENTOS DOC 
 INNER JOIN ITENS ITE ON ITE.DOCUMENTO = DOC.ID
 INNER JOIN PEDIDOITEMATENDIMENTOS ATE ON ATE.DOCUMENTOITEM = ITE.ID
 WHERE DOC.ID = :ID
 GROUP BY ATE.PEDIDO

Exemplo de comando SQL para a Ordem de Serviço

 SELECT ATE.ORDEMSERVICO AS ID
 FROM DOCUMENTOS DOC
 INNER JOIN ITENS ITE ON ITE.DOCUMENTO = DOC.ID 
 INNER JOIN ORDEMSERVICOITEMATENDIMENTOS ATE ON ATE.DOCUMENTOITEM = ITE.ID
 WHERE DOC.ID = :ID
 GROUP BY ATE.ORDEMSERVICO

Exemplo de comando SQL para Contrato

 SELECT A.ID 
 FROM DOCUMENTOS A
 INNER JOIN ITENS B ON B.DOCUMENTO = A.ID 
 INNER JOIN CONTRATOITEMFATURAMENTOS C ON C.DOCUMENTOITEM = B.ID 
 INNER JOIN CONTRATOITEMFATURAMENTOS E ON E.CONTRATO = C.CONTRATO
                                       AND E.COMPETENCIA = C.COMPETENCIA
 INNER JOIN ITENS F ON F.ID = E.DOCUMENTOITEM                                     
 WHERE F.DOCUMENTO = 285
 AND A.TIPODOCUMENTO = 148
 AND A.ORIGEM = '9'
 AND TIPOMOVIMENTO = 'S'
 GROUP BY A.ID

Identificação do Arquivo

O nome do arquivo anexado será gerado com base em dois critérios:

Padrão: Será utilizada a legenda do formato de relatório em conjunto com a legenda do relatório vinculado ao formato.

Configuração Específica: Caso esteja configurada uma identificação no registro do formato de relatório, esta será priorizada. Para que a identificação seja gerada de forma dinâmica, podem ser utilizados os seguintes campos no SQL da configuração do anexo:

• DOCUMENTO
• PESSOA
• APELIDO

Exemplo

SELECT ATE.ORDEMSERVICO AS ID,
       OS.NUMERO        AS DOCUMENTO  
FROM DOCUMENTOS DOC
INNER JOIN ITENS ITE ON ITE.DOCUMENTO = DOC.ID 
INNER JOIN ORDEMSERVICOITEMATENDIMENTOS ATE ON ATE.DOCUMENTOITEM = ITE.ID
INNER JOIN ORDENSSERVICO OS ON OS.ID = ATE.ORDEMSERVICO
WHERE DOC.ID = :ID
GROUP BY ATE.ORDEMSERVICO,
         OS.NUMERO

No exemplo acima, a configuração da identificação no formato de relatório pode incluir a seguinte estrutura:

Identificação: Ordem de Serviço Nº $DOCUMENTO

Com isso, o sistema preencherá a identificação do formato de relatório de forma dinâmica, substituindo a tag $DOCUMENTO pelo valor correspondente do campo DOCUMENTO.

Conclusão

Podemos concluir que com a configuração dos anexos por tipo de documento, o destinatário pode receber de forma automática os documentos que deram origem a nota fiscal, no mesmo e-mail onde constam os arquivos PDF e XML.