Função: Método destinado a distribuição de Documentos Eletrônicos processados pelo TSS. O ERP poderá habilitar ou desabilitar a distribuição automática via e-mail.
Os parâmetros utilizados para definir qual o modelo de documento eletrônico será habilitado/desabilitado são "AUTDIST" e "AUTDCTE" disponíveis no método "CFGPARAMSPED" para o serviço "SPEDCFGNFE".
Quando o parâmetro estiver desabilitado, o TSS aguardará que o ERP faça a solicitação da distribuição.
Este serviço visa atender as seguintes demandas:
- Permitir que os ERP enviem o arquivo impresso (PDF) para a distribuição;
- Permitir a redistribuição dos Documentos (XML e DANFE ou DACTE) a qualquer momento;
- Permitir o envio da lista de destinatários para a distribuição.
Obs.: A lista de destinatários informada será utilizada apenas para o envio do e-mail de Distribuição, não alterando o destinatário registrado na base de dados do TSS (tabela SPED050).
<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>
<!--Optional:-->
<nfs:GRVDOCAUX>?</nfs:GRVDOCAUX>
<nfs:LISTADOCUMENTOS>
<!--Zero or more repetitions:-->
<nfs:DOCUMENTOS>
<!--Optional:-->
<nfs:EMAIL>?</nfs:EMAIL>
<nfs:NFE_ID>?</nfs:NFE_ID>
<!--Optional:-->
<nfs:PDF>cid:1621588639427</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> |
Parâmetro | Tipo | Tam | Pai | Observação | USERTOKEN | Alfanumérico | 6 | - | Token de bilhetagem para execução do serviço. | ID_ENT | Alfanumérico | 6 | - | Código da entidade retornado pelo WS SpedAdm/AdmEmpresas. | DISTEMAIL | Estrutura | - | - | Tag Raiz. | | LISTADOCUMENTOS | Estrutura | - | DISTEMAIL | Tag Raiz. | DOCUMENTOS | Estrutura | - | LISTADOCUMENTOS |
| EMAIL | Alfanumérico | 250 | LISTADOCUMENTOS | Contas de e-mail. Separar endereço(s) por ponto-e-vírgula. Ex: [email protected];nfe2@totvs.com.br. | NFE_ID | Alfanumérico | - | LISTADOCUMENTOS | ID da nota fiscal eletrônica. | PDF | Base64Binary | - | LISTADOCUMENTOS | PDF a ser utilizado na distribuição via e-mail. | | RETRANSMITIR | Lógico | - | LISTADOCUMENTOS | Forçar envio do e-mail, independente do status de envio de e-mail atual. | | TIPOCOMPRESSAO | Alfanumérico |
| LISTADOCUMENTOS | Tipo de compressão a ser utilizado. Fixo "zip". Obs. Caso informado, o nome do arquivo deverá ser o Id documento informado no parâmetro NFE_ID da requisição. | | MODELO | Alfanumérico | 10 | DISTEMAIL | Modelo do documento eletrônico. Modelos válidos: 55 (NFe) 57 (CTe) | | GRVDOCAUX | Alfanumérico | 1 | DISTEMAIL | Valores
1- Danfe não será persistido no TSS (Padrão)
2- Danfe será persistido no TSS Obs. Caso valor informado seja "2" será gravado registro na tabela SPED059. |
|
<soap:Body>
<DISTRIBUICAODEDOCUMENTOSRESPONSE>
<DISTRIBUICAODEDOCUMENTOSRESULT>
<RETDOCUMENTSDIST>
<MSG>BASE64BINARY</MSG>
<NFE_ID>STRING</NFE_ID>
<RESULT>INTEGER</RESULT>
</RETDOCUMENTSDIST>
</DISTRIBUICAODEDOCUMENTOSRESULT>
</DISTRIBUICAODEDOCUMENTOSRESPONSE>
</soap:Body> |
Parâmetro | Tipo | Tam | Pai | Observação | DISTRIBUICAODEDOCUMENTOSRESPONSE | Estrutura | - |
| Tag Raiz. | DISTRIBUICAODEDOCUMENTOSRESULT | Estrutura | - | DISTRIBUICAODEDOCUMENTOSRESPONSE | Tag Raiz. | RETDOCUMENTSDIST | Estrutura | - | DISTRIBUICAODEDOCUMENTOSRESULT |
| MSG | Alfanumérico | - | RETDOCUMENTSDIST | Mensagem com o status da distribuição do documento. | NFE_ID | Inteiro | 1-250 | RETDOCUMENTSDIST | Id de identificação do documento no TSS. | | RESULT | Lógico | - | RETDOCUMENTSDIST | Indica se o pedido de distribuição foi aceito pelo TSS. |
|
| Fault | Descrição | | Invalid Token | O parâmetro USERTOKEN foi passado incorretamente. | | 001 | Código da entidade inválida. | | 002 | Código da entidade em branco. | | 003 | Modelo inválido. Modelos permitidos: 55, 57 |
|
| Código | Descrição |
|---|
| 100 | Solicitação Recebida. Processo de envio de Email enviado para fila de processamento. | | 200 | Já existe uma solicitação pendente para distribuição. Aguarde o Processamento. | | 300 | Processo de Distribuição já executado. Utilize a opção "retransmitir" para uma nova transmissão. | | 400 | Documento não encontrado na base de dados do TSS. |
|
Envio: 
Retorno: 
|
|