Informações Gerais 

Índice:

• Objetivo

• Regras de Negócio

• Web Services e Métodos do TSS

Objetivo

Demonstrar as implementações no Envio de DANFE do ERP por E-mail disparado pelo TSS.

Este documento tem por objetivo a definição das especificações e critérios técnicos necessários para a implementação dos métodos "StatusDistribuicaoDeDocumentos" e "DistribuicaoDeDocumentos"

Atualmente estes métodos serão implementados inicialmente para a NF-e (modelo 55).

Regras de Negócio

O Método de "StatusDistribuicaoDeDocumentos " foi criado para verificação do Status do Email de Distribuição de Documentos Eletrônicos (Modelo 55).

O serviço carrega apenas os documentos autorizados e emitidos dentro do período de 30 dias para os Status de envio de E-Mail 0, 1, 2 e 3.

Legenda Status:

• 0 - Aguardando envio do E-MAIL da DANFE do ERP
• 1 - Aguardando envio do E-MAIL TSS (XML ou XML e PDF)
• 2 - E-mail enviado com sucesso
• 3 - Erro no envio do E-mail

O Método de "DistribuicaoDeDocumentos " foi criado para o envio de E-mail de Distribuição dos Documentos Eletrônicos processados pelo TSS. Através da utilização dos parâmetros "MV_AUTDIST",

disponibilizado no método "CFGPARAMSPED" para o serviço "SPEDCFGNFE", os ERP´s poderão habilitar e desabilitar a distribuição automática feita pelo TSS.

Quando o parâmetro estiver desabilitado, o TSS aguarda que o ERP faça a solicitação da distribuição.

Este serviço visa atender as seguintes  demandas:

• Permitir que os ERP´s enviem o arquivo impresso (PDF)  para a distribuição;
• Permitir a redistribuição dos Documentos (XML e DANFE) a qualquer momento conforme o documento enviado na DistribuicaodeDocumentos;
• Permitir o envio da lista de destinatários para a distribuição.

Importante: Se o parâmetro NFEDISD estiver setado 1 (um) e AUTDIST estiver desativado igual á 0 (zero), o TSS irá ficar aguardando a requisição do ERP para disparo do e-mail.

Web Services e Métodos do TSS

Serão utilizados os métodos dos Web Services abaixo:

Serviço: SPEDCFGNFE

• Método: CFGPARAMSPED

Este método deve ser utilizado para informar qual a configuração dos parâmetros de funcionamento do TSS. 

Os parâmetros de entrada do método são:

<soap:Body>

<USERTOKEN>STRING</USERTOKEN>

<ID_ENT>STRING</ID_ENT>

<USACOLAB>STRING</USACOLAB>

<NUMRETNF>INTEGER</NUMRETNF>

<AMBIENTE>INTEGER</AMBIENTE>

<MODALIDADE>INTEGER</MODALIDADE>

<VERSAONFE>STRING</VERSAONFE>

<VERSAONSE>STRING</VERSAONSE>

<VERSAODPEC>STRING</VERSAODPEC>

<VERSAOCTE>STRING</VERSAOCTE>

<USERNEOG>STRING</USERNEOG>

<PASSWORD>BASE64BINARY</PASSWORD>

<CONFALL>STRING</CONFALL>

<DOCSCOL>STRING</DOCSCOL>

<AMBNFECOLAB>INTEGER</AMBNFECOLAB>

<AMBCTECOLAB>INTEGER</AMBCTECOLAB>

<CFGPARAMDOC>

<PARAMDOC>

<CFGDOC>

<DOCUMENTOAMBIENTE>INTEGER</DOCUMENTOAMBIENTE>

<DOCUMENTOMODELO>INTEGER</DOCUMENTOMODELO>

</CFGDOC>

<CFGDOC>

<DOCUMENTOAMBIENTE>INTEGER</DOCUMENTOAMBIENTE>

<DOCUMENTOMODELO>INTEGER</DOCUMENTOMODELO>

</CFGDOC>

</PARAMDOC>

</CFGPARAMDOC>

<NFECANCEVENTO>BOOLEAN</NFECANCEVENTO>

<NFEDISTRDANFE>STRING</NFEDISTRDANFE>

<NFEENVEPEC>STRING</NFEENVEPEC>

<AUTODISTR>STRING</AUTODISTR>

</soap:Body>

Os parâmetros de saída do método são:

<soap:Body>

<MSG>STRING</MSG>

</soap:Body>

</soap:Envelope>

Serviço: NFESBRA

• Método: DISTRIBUICAODEDOCUMENTOS

      Método destinado ao envio de E-mail de Distribuição dos Documentos Eletrônicos processados pelo TSS. Através da utilização do parâmetro "MV_AUTDIST" disponível no método "CFGPARAMSPED" para o serviço "SPEDCFGNFE",
os ERP´s poderão desabilitar a distribuição automática feita pelo TSS.

Os parâmetros de entrada do método são:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:nfs="http://webservices.totvs.com.br/nfsebra.apw">
  <soapenv:Header/>
  <soapenv:Body>
    <nfs:DISTRIBUICAODEDOCUMENTOS>
      <nfs:USERTOKEN>?</nfs:USERTOKEN>
      <nfs:ID_ENT>?</nfs:ID_ENT>
      <nfs:DISTEMAIL>
        <nfs:LISTADOCUMENTOS>
          <!--Zero or more repetitions:-->
          <nfs:DOCUMENTOS>
            <!--Optional:-->
            <nfs:EMAIL>?</nfs:EMAIL>
            <nfs:NFE_ID>?</nfs:NFE_ID>
            <!--Optional:-->
            <nfs:PDF>cid:1076726658018</nfs:PDF>
            <!--Optional:-->
            <nfs:RETRANSMITIR>?</nfs:RETRANSMITIR>
            <!--Optional:-->
            <nfs:TIPOCOMPRESSAO>?</nfs:TIPOCOMPRESSAO>
          </nfs:DOCUMENTOS>
        </nfs:LISTADOCUMENTOS>
        <nfs:MODELO>?</nfs:MODELO>
      </nfs:DISTEMAIL>
    </nfs:DISTRIBUICAODEDOCUMENTOS>
  </soapenv:Body>
</soapenv:Envelope>

Soap Fault

Exemplos: 

Envio:                                                                                                                                         

 Retorno:

Serviço: NFESBRA

• Método: STATUSDISTRIBUICAODEDOCUMENTOS

     Método destinado a verificação do Status do Email de Distribuição de Documentos Eletrônicos (Modelo 55).

Os parâmetros de entrada do método são:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:nfs="http://webservices.totvs.com.br/nfsebra.apw">
  <soapenv:Header/>
  <soapenv:Body>
    <nfs:STATUSDISTRIBUICAODEDOCUMENTOS>
      <nfs:USERTOKEN>Character</nfs:USERTOKEN>
      <nfs:ID_ENT>Numérico</nfs:ID_ENT>  
      <nfs:STATUSDISTMAIL>
        <nfs:MODELO>Alfanumérico</nfs:MODELO>
        <nfs:SEQUENCIA>Numérico</nfs:SEQUENCIA>
        <!--Optional:-->
        <nfs:STATUS>Numérico</nfs:STATUS>
      </nfs:STATUSDISTMAIL>
    </nfs:STATUSDISTRIBUICAODEDOCUMENTOS>
  </soapenv:Body>
</soapenv:Envelope>

Exemplos:

 Envio:

Retorno: