Função: Método destinado ao retorno das remessas de NF-e processadas pela SEFAZ. Este método retorna um máximo de 500kbytes de informação. Caso o lote solicitado gere um valor maior que este, o sistema limitará o retorno em 500kbytes e a aplicação deve verificar que há itens faltantes e realizar nova chamada até não haver mais itens. Uma opção eficiente é verificar se houve retorno, sempre que houver, existirá dados a transmitir, isto é, se não houver retorno não haverá mais dados.
Uso do Banco de dados: Persistente.
<soap:Body> <USERTOKEN>STRING</USERTOKEN> <ID_ENT>STRING</ID_ENT> <NFEID> <NOTAS> <NFESID2> <ID>STRING</ID> </NFESID2> </NOTAS> </NFEID> <DIASPARAEXCLUSAO>INTEGER</DIASPARAEXCLUSAO> </soap:Body>
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. | NFeID | Estrutura | - | - | - | NOTAS | Matrix[n] | - | NFeID | - | NFESID2 | - | - | NOTAS | - | ID | Alfanumérico | 1-250 | NOTAS | Id de identificação do XML da NF-e com o ERP. Este número será sempre informado ou solicitado pelo TOTVS Services Sped para fornecer informações sobre o status atual da NF-e. É recomendado para o ERP enviar o número da chave de acesso da NF-e, caso utilize uma base de dados 100% volátil. | DIASPARAEXCLUSAO | Inteiro | 2 | - | Informe o número de dias que este dado deverá ser persistido no TOTVS Service Sped. Caso o valor informado seja zero, não haverá exclusão. |
|
<soap:Body> <NFEAUTORIZADANX> <NOTAS> <NFES5> <DPEC> <NFEPROTOCOLO> <PROTOCOLO>STRING</PROTOCOLO> <XML>STRING</XML> <XMLPROT>STRING</XMLPROT> <WS01CONSUMOINDEVIDO> <OBSERVACAO>STRING</OBSERVACAO> <TENTATIVAS>STRING</TENTATIVAS> </WS01CONSUMOINDEVIDO> </NFEPROTOCOLO> </DPEC> <ID>STRING</ID> <MODALIDADETRANS>Numérico<MODALIDADETRANS> <NFE> <PROTOCOLO>STRING</PROTOCOLO> <XML>STRING</XML> <XMLPROT>STRING</XMLPROT> <WS01CONSUMOINDEVIDO> <OBSERVACAO>STRING</OBSERVACAO> <TENTATIVAS>STRING</TENTATIVAS> </WS01CONSUMOINDEVIDO> </NFE> <NFECANCELADA> <PROTOCOLO>STRING</PROTOCOLO> <XML>STRING</XML> <XMLPROT>STRING</XMLPROT> <WS01CONSUMOINDEVIDO> <OBSERVACAO>STRING</OBSERVACAO> <TENTATIVAS>STRING</TENTATIVAS> </WS01CONSUMOINDEVIDO> </NFECANCELADA> </NFES5> </NOTAS> </NFEAUTORIZADANX> </soap:Body>
Parâmetro | Tipo | Tam | Pai | Observação | NFEAUTORIZADANX | Estrutura | - | - | - | NOTAS | Estrutura | - | NFEAUTORIZADA | - | NFES5 | Matriz[n] | - | NOTAS | - | DPEC | Estrutura | - | NFeS5 | - | NFEPROTOCOLO | Estrutura | - | DPEC | - | XML | Binário | 500k | NFEPROTOCOLO | XML da DPEC no formato da SEFAZ assinado. | PROTOCOLO | Alfanumérico | 15 | NFEPROTOCOLO | Número do Registro do DPEC. | XMLPROT | Binário | 500k | NFEPROTOCOLO | Este campo não é preenchido, pois o DPEC não tem um XML do Protocolo. | WS01CONSUMOINDEVIDO | Estrutura | - | NFEPROTOCOLO | Estrutura referente a Consumo Indevido. | OBSERVACAO | Alfanumérico | 200 | WS01CONSUMOINDEVIDO | Mensagem de retorno do TSS caso ocorra o atingimento do máximo de tentativas de execução do método em questão. | TENTATIVAS | Alfanumérico | 5 | WS01CONSUMOINDEVIDO | Retorna a contagem de tentativas de execução do método em questão. | ID | Alfanumérico | 1-250 | NFES5 | Id de identificação do XML da NF-e com o ERP. | MODALIDADETRANS | Inteiro | 1 | NFeS5 | Modalidade de Transmissão do documento. | NFE | Estrutura |
| NFES5 | - | XML | Binário | 500k | NFE | XML da NF-e no formato da SEFAZ assinado. | PROTOCOLO | Alfanumérico | 15 | NFE | Número do protocolo da SEFAZ. | XMLPROT | Binário | 500k | NFE | XML do protocolo no formato da SEFAZ assinado. | WS01CONSUMOINDEVIDO | Estrutura | - | NFE
| Estrutura referente a Consumo Indevido. | OBSERVACAO | Alfanumérico | 200 | WS01CONSUMOINDEVIDO | Mensagem de retorno do TSS caso ocorra o atingimento do máximo de tentativas de execução do método em questão. | TENTATIVAS | Alfanumérico | 5 | WS01CONSUMOINDEVIDO | Retorna a contagem de tentativas de execução do método em questão. | NFECANCELADA | Estrutura |
| NFES5 | - | XML | Binário | 500k | NFECANCELADA | XML da NF-e no formato da SEFAZ assinado. | PROTOCOLO | Alfanumérico | 15 | NFECANCELADA | Número do protocolo da SEFAZ. | XMLPROT | Binário | 500k | NFECANCELADA | XML do protocolo no formato da SEFAZ assinado. | WS01CONSUMOINDEVIDO | Estrutura | - | NFECANCELADA | Estrutura referente a Consumo Indevido. | OBSERVACAO | Alfanumérico | 200 | WS01CONSUMOINDEVIDO | Mensagem de retorno do TSS caso ocorra o atingimento do máximo de tentativas de execução do método em questão. | TENTATIVAS | Alfanumérico | 5 | WS01CONSUMOINDEVIDO | Retorna a contagem de tentativas de execução do método em questão. |
|
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 | Número máximo de notas excedido – 50 notas. |
|
|
Processos:
1) Valida o UserToken enviado;
2) Inicializa a conexão com o SGBD e cria as tabelas do sistema se necessário;
3) Valida os parâmetros recebidos;
4) Realiza a leitura das tabelas de NF-e, Lotes e Nf-e x Lotes;
5) Monta mensagem de recomendação, conforme os códigos de retorno da SEFAZ;
6) Retorna para a aplicação.