O web service NFS-e é um modelo de processamento, surgiu da necessidade de um intermédio entre o ERP e o NFS-e Connector (Solução de processamento de RPS e NFS-e), pois por medidas de segurança o ERP não disponibiliza os documentos à serem processados em um diretório ou banco de dados, somente através do processo via web service. Para isso a NDDigital desenvolveu o NFS-e Web Service, que possibilita a emissão de RPS e NFS-e.
O NFS-e Web Service terá apenas um Web Service denominado “ExchangeMessage.asmx”, contendo processos e métodos diferentes. Após a Instalação do NFS-e Web Service, será criado o endereço: http://localhost/NFSeWebService/ExchangeMessage.asmx
Métodos do Web Service NFS-e |
•CompressedSend.
Envio de mensagens compactadas.
a.Cabeçalho CrossTalk - Xml
b.Array de bytes contendo os dados compactados
c.Retorna um CrossTalk – Xml
•CompressedSendWithCompressedResponse.
Envio e Retorno de mensagens compactadas.
a.Cabeçalho CrossTalk - Xml
b.Array de bytes contendo os dados compactados
c.Retorna um Array de bytes contendo os dados e um CrossTalk – Xml
•GetGuid.
Solicitação e retorno do GUID que é utilizado pelo web service do NFS-e.
<?xml version="1.0" encoding="UTF-8"?> <string xmlns="http://tempuri.org/">0db0c9de-c996-4ca0-b9a9-237791243f0d</string> |
•Send.
Envio de mensagens.
a.Cabeçalho CrossTalk – Xml
b.Cadeia de caracteres contendo os dados
c.Retorna um CrossTalk – Xml
Message: Mensagem do processo do Web Service.
RawData: Documento do RPS ou Cancelamento da NFS-e.
Exemplo de chamada e envio de documento para o web service do NFS-e:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/"> <soapenv:Header/> <soapenv:Body> <tem:Send> <!--Optional:--> <tem:message><![CDATA[Cabeçalho da chamada]></tem:message> <!--Optional:--> <tem:rawData><![CDATA[Preencher com o arquivo de XML ou TXT do layout da nddigital]]></tem:rawData> </tem:Send> </soapenv:Body> </soapenv:Envelope> |
•SendWithCompressedResponse.
Envio de mensagens com a resposta compactada.
a.Cabeçalho CrossTalk - Xml
b.Cadeia de caracteres contendo os dados
c.Retorna um Array de bytes contendo os dados compactados e um CrossTalk – Xml
Message: Mensagem do processo do Web Service.
RawData: Documento do RPS ou Cancelamento da NFS-e.
O que irá identificar o tipo de processo que será realizado pelo NFS-e Web Service são códigos de processos informados na mensagem.
Todos os métodos de envio contém dois parâmetros, sendo a Message (Mensagem do Processo) e o Rawdata que refere-se ao documento do RPS ou Cancelamento da NFS-e dentro do layout 5.0 NDDigital.