ndice
1. 2. 3. 4. 5. 6. 7. 8. Viso Geral .............................................................................................................................. Mtodos Oferecidos ................................................................................................................... Informaes sobre o Webservice .................................................................................................. Interface do Webservice - Enviar Arquivo ..................................................................................... Interface do Webservice - Consultar Status .................................................................................... Interface do Webservice - Consultar Erros ..................................................................................... Especificaes Tcnicas ............................................................................................................. Dvidas e Questionamentos ........................................................................................................ 1 1 2 2 4 5 6 7
1. Viso Geral
Uma das fundaes do WebService a interoperabilidade entre plataformas. Isso significa que o WebService envia e recebe mensagens de uma forma padronizada. Tipicamente, o formato do protocolo SOAP . SOAP, originado do acrnimo ingls Simple Object Access Protocol, e em portugus Protocolo Simples de Acesso a Objetos, um protocolo para troca de informaes estruturadas em uma plataforma descentralizada e distribuda (Wikipdia). H vrias maneiras de utilizar (consumir) o WebService. Inmeras linguagens de computao buscam nveis ideais de abstrao para facilitar o uso do protocolo SOAP; o benefcio dessas abstraes que os programadores de aplicativos passam a focar mais nas regras do negcio do que nos rigores do protocolo SOAP. O WebService ArquivoECF tem por finalidade prover funcionalidades que automatizem o procedimento de envio de arquivos de cupons fiscais gerados por ECF (vide Instruo Nomativa n 015/2011/GAB/CRE/SEFIN/RO). Para isso, prev as funcionalidades de: envio de arquivos de cupons fiscais para processamento; consulta assncrona do resultado do processamento de arquivos; consulta assncrona de erro gerados pelo processamento de arquivos - procedures ( servios banco de dados);
2. Mtodos Oferecidos
A fim de prover as funcionalidades supracitadas sero oferecidos trs mtodos para uso pelos contribuintes: Wsenviararquivo(): Mtodo para enviar arquivo de cupons fiscais; Wsconsultarstatusarquivo() : Mtodo para consultar status do arquivo enviado; Wsconsultarerrosarquivo() : Mtodo para consulta de erros dos arquivos enviados;
MesAnoReferencia DataInicio
String String
DataFim
String
Segue exemplo de retorno do mtodo Wsconsultarerrosarquivo: <ns1:WsconsultarerrosarquivoResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/ soap/encoding/" xmlns:ns1="http://DefaultNamespace"> <WsconsultarerrosarquivoReturn href="#id0"/> </ns1:WsconsultarerrosarquivoResponse> <multiRef id="id0" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" soapenc:arrayType="xsd:anyType[2]" xsi:type="soapenc:Array" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"> <multiRef href="#id1"/ > <multiRef href="#id2"/> </multiRef> <multiRef id="id2" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" soapenc:arrayType="xsd:anyType[2]" xsi:type="soapenc:Array" xmlns:soapenc="http:// schemas.xmlsoap.org/soap/encoding/"> <multiRef xsi:type="soapenc:decimal">0</multiRef>
Manual para Envio de Arquivo de Cupons Fiscais via WebService <multiRef xsi:type="soapenc:string">Registro E02 no encontrado.</multiRef> </multiRef> <multiRef id="id1" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/ soap/encoding/" soapenc:arrayType="xsd:anyType[2]" xsi:type="soapenc:Array" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"> <multiRef xsi:type="soapenc:decimal">0</multiRef> <multiRef xsi:type="soapenc:string">Registro E01 no encontrado.</multiRef> </multiRef>
7. Especificaes Tcnicas
Tabela 7. Propriedades da Interface
Property Name Url Definition Binding Soap Version Style Builder Value NPJServicesSoapBinding https://notalegal.sefin.ro.gov.br/contribuinte/webservices/NPJServices.jws?wsdl {https://notalegal.sefin.ro.gov.br/contribuinte/webservices/NPJServices.jws}NPJServicesSoapBinding SOAP 1.1 RPC Apache Axis version: 1.4 Built on Apr 22, 2006 (06:55:48 PDT)
8. Dvidas e Questionamentos
Em caso de necessidade de esclarecimentos tcnicos sobre este manual, dever ser utilizado o Fale Conosco do Portal da Nota Legal Rondoniense ( https://notalegal.sefin.ro.gov.br/notalegal/ ), com a identificao detalhada do problema ocorrido. As dvidas sero encaminhadas ao setor competente. Para o esclarecimento de dvidas sobre o Projeto Nota Legal Rondoniense, dever ser utilizado o Call Center da Secretaria de Finanas do Estado de Rondnia (0800-647 4700). Esta obra distribuda por meio da Licena Pblica Geral (Creative Commons): Atribuio/Uso No-Comercial/Vedada a Criao de Obras Derivadas / 3.0 / Brasil