Manual de Integração WS. Notanet. NF-e. Integração via WebService

Transcrição

1 MANUAL DE INTEGRAÇÃO Notanet NF-e Integração via WebService 1

2 Histórico de Revisões Data Versão Descrição 15/07/ Primeira versão 25/07/ Correção da tabela de Status da Nota item /08/ Inclusão do registro de resposta Lote de Requisições inválido 16/01/ Adequação à Nota Técnica 2008/ Inclusão dos tipos de emissão 4 e 5 (DPEC e FS-DA). 16/03/ Inclusão da pasta para Fila de Contingência do Montador TXT. 25/03/ Inclusão de requisição para re-consulta de NF-e; Inclusão de parametrização dos caminhos para as pastas de comunicação. Índice 3 1 OBJETIVO 3 2 VISÃO GERAL DA SOLUÇÃO 3 3 SERVIÇOS 3 4 INTEGRAÇÃO MONTADOR WS 3 5 LAYOUT DOS DADOS WS1 RECEBER NF-E 4 2

3 5.2 WS2 CONSULTA NF-E 5.3 WS3 RECEBE NF-E CANCELAMENTO 5.4 WS4 RECEBE NF-E INUTILIZAÇÃO 5.5 WS4 RESPOSTA Definições/Abreviações ERP (Enterprise Resource Planning) Sistemas Integrados de Gestão Empresarial. 1 Objetivo Este documento tem por finalidade servir de referência para as atividades de integração entre o ERP do cliente e o Notanet para o caso de emissão de NF-e. 2 Visão geral da solução Este documento descreverá os fluxos de comunicação entre os sistemas. Destacando o meio de comunicação e o layout dos dados. Este documento trata detalhadamente as interfaces de integração via webservices. Este documento não trata do que será implementado internamente em cada sistema. 3 Serviços Através desta integração o ERP obterá acesso às seguintes funcionalidades oferecidas pela SEFAZ: O envio de NF-e, o cancelamento de NF-e e a inutilização de numeração. Apesar de o cancelamento e a inutilização serem executados de forma síncrona entre o Notanet e a SEFAZ, todos os serviços estarão sujeitos à comunicação assíncrona entre o ERP e o Notanet. Ou seja, o tempo de resposta a uma requisição sempre estará sujeito à leitura do lote de requisições pelo Notanet e à leitura da resposta pelo ERP. 4 Integração Montador WS Esse modelo de integração exige que o ERP do cliente emissor de NF-e gere as notas nos modelos descritos na próxima seção deste manual e envie-os para os WS s (Web Services) do Notanet. Os acessos aos WS s estão listados abaixo em cada ambiente Acessos 3

4 Homologação: Produção: Layout dos Dados Esta sessão descreve em detalhes as interfaces de comunicação. As interfaces via web não são detalhadas porque não são consideradas interfaces de integração. Maiores detalhes como utilizá-las podem ser encontradas no manual do usuário do Cockpit do NotaNet. 5.1 WS1 Receber NF-e Interface: ERP -> Notanet Tipo de Comunicação: webservice Método: recebernfe Estrutura dos Dados de Entrada Parâmetro Descrição Tipo Ocorrência strin XML de envio String 1 Este web service receberá um parâmetro string contendo um XML. Confira na tabela Estrutura do XML. 4

5 Exemplo do XML de: <NotaFiscal> <cabecalho> <nfsaida>1</nfsaida> <numero>34</numero> <serie>1</serie> <naturezaoperacao>venda prod. estabel. orig. de encomenda para entr. fut.</naturezaoperacao> <cfop>5116</cfop> <InscEstSubstTributario></InscEstSubstTributario> <dataemissao> </dataemissao> <dataentradasaida> </dataentradasaida> <codigouf>35</codigouf> <formapagamento>0</formapagamento> <codigomodelofiscal>55</codigomodelofiscal> <finalidadeemissao>1</finalidadeemissao> <NFref> <ref> <chave> </chave> <cuf>41</cuf> <AAMM>0803</AAMM> <CNPJ> </CNPJ> <mod>55</mod> <serie>1</serie> </ref> </NFref> </cabecalho> <emitente> <razaosocial>copagra-coop.agroindustrial DO NOROESTE PARANAENSE</razaoSocial> <nomefantasia>destilaria</nomefantasia> <cnpj> </cnpj> <inscricaoestadual> </inscricaoestadual> <inscricaomunicipal></inscricaomunicipal> <inscricaoestadualst></inscricaoestadualst> <cnae>1931-4/00</cnae> <endereco> <rua>br KM 36 - LOTE 04-A</rua> <numero>s/n</numero> <cep> </cep> <complemento></complemento> <bairro>zona RURAL</bairro> <cidade>nova LONDRINA</cidade> <codigomunicipio> </codigomunicipio> <codigopais>1058</codigopais> <uf>sp</uf> <codigouf>35</codigouf> <pais>brasil</pais> <fone> </fone> </endereco> 5

6 </emitente> <destinatario> <nome>petrobras DISTRIBUIDORA S/A</nome> <cnpj> </cnpj> <cpf></cpf> <inscricaoestadual> </inscricaoestadual> <isuf></isuf> <endereco> <rua>rod. XISTO BR 476 KM 15440</rua> <numero>s/n</numero> <cep> </cep> <complemento></complemento> <bairro>zona INDUSTRIAL</bairro> <cidade>araucaria</cidade> <codigomunicipio> </codigomunicipio> <codigopais>1058</codigopais> <uf>pr</uf> <pais>brasil</pais> <fone> </fone> </endereco> </destinatario> <produtos> <produto> <codigo>313124</codigo> <descricao>alcool ETIL.N.DESNAT.VOL.ALCOOLICO=>80% HIDRATADO</descricao> <classfisc>5116</classfisc> <aliqicms>18.000</aliqicms> <baseicms> </baseicms> <valoricms>936.00</valoricms> <genero></genero> <extipi> </extipi> <ncm> </ncm> <quantidadecomercial> </quantidadecomercial> <quantidadetributavel> </quantidadetributavel> <unidadecomercial>lt</unidadecomercial> <unidadetributavel>lt</unidadetributavel> <valordesconto>0.00</valordesconto> <valorfrete>0.00</valorfrete> <valorbrutoproduto> </valorbrutoproduto> <valorseguro>0.00</valorseguro> <informacoesadicionais></informacoesadicionais> <valorunitariocomercializacao>0.7800</valorunitariocomercializacao> <valorunitariotributacao>0.7800</valorunitariotributacao> <imposto> <cofins> <cofinsnt>07</cofinsnt> </cofins> <icms> <cst>00</cst> <modbc>3</modbc> <origemmercadoria>0</origemmercadoria> <aliquotaicms>18.000</aliquotaicms> 6

7 <valorbc> </valorbc> <valoricms>936.00</valoricms> <modbcst>0</modbcst> <aliquotaicmsst>0.0</aliquotaicmsst> <percentualmargemvaloradicionado>0</percentualmargemvaloradicionado> <percentualreducaobcst>0</percentualreducaobcst> <percentualreducaobc>0.0000</percentualreducaobc> <valorbcst>0.00</valorbcst> <valoricmsst>0.00</valoricmsst> </icms> <pis> <pisnt> <cst>07</cst> </pisnt> </pis> </imposto> </produto> </produtos> <total> <icmstotal> <totbcicms> </totbcicms> <totbcicmsst>0.00</totbcicmsst> <totcofins>0.00</totcofins> <totdesconto>0.00</totdesconto> <totfrete>0.00</totfrete> <toticms>936.00</toticms> <totimpostoimportacao>0</totimpostoimportacao> <totipi>0.00</totipi> <totnota> </totnota> <totoutrasdespesasacessorias>0.00</totoutrasdespesasacessorias> <totpis>0.00</totpis> <totprodutos> </totprodutos> <totseguro>0.00</totseguro> <toticmsst>0.00</toticmsst> </icmstotal> <rettribtotal> <bcirrf>0</bcirrf> <bcretencaoprevidenciasocial>0</bcretencaoprevidenciasocial> <valorretidoirrf>0</valorretidoirrf> <valorretidocofins>0.00</valorretidocofins> <valorretidocsll>0.00</valorretidocsll> <valorretidopis>0.00</valorretidopis> <valorretidoprevidenciasocial>0</valorretidoprevidenciasocial> </rettribtotal> </total> <transporte> <freteporconta>0</freteporconta> <transportador> <nome>transportadora MATSUDA LTDA.</nome> 7

8 <cnpj> </cnpj> <cpf></cpf> <inscricaoestadual> </inscricaoestadual> <endereco> <rua>rod.pr 317 KM 02-LOTE 341</rua> <numero>s/n</numero> <complemento></complemento> <bairro></bairro> <cidade>maringa</cidade> <uf>pr</uf> <fone> </fone> </endereco> </transportador> <volume> <quantidade>0</quantidade> <especie></especie> <marca></marca> <numero>0</numero> <pesobruto> </pesobruto> <pesoliquido> </pesoliquido> </volume> </transporte> <dadosadicionais>op.int.: 2444 SIMPLES REMESSA ENTREGA FUTURA - PRODUCAO PROPRIA</dadosAdicionais> </NotaFiscal> 8

9 5.2 WS2 Consulta NF-e Interface: ERP -> Notanet Tipo de Comunicação: webservice Método: consultanfe Estrutura dos Dados de Entrada Parâmetro Descrição Tipo Ocorrência strin XML de consulta String 1 Este web service receberá um parâmetro string contendo um XML. Confira na tabela Estrutura do XML. <consulta> <cnpj> </cnpj> <NotaFiscal> <numero>686</numero> </NotaFiscal> </consulta> 5.3 WS3 Recebe NF-e Cancelamento Interface: ERP -> Notanet Tipo de Comunicação: webservice Método: recebernfecancelamento Estrutura dos Dados de Entrada Parâmetro Descrição Tipo Ocorrência strin XML de cancelamento String 1 Este web service receberá um parâmetro string contendo um XML. Confira na tabela Estrutura do XML. Exemplo do XML: <cancelamento> <chave> </chave> <justificativa>a justificativa deve conter no mínimo 15 caracteres</justificativa> </cancelamento> 9

10 5.4 WS4 Recebe NF-e Inutilização Interface: ERP -> Notanet Tipo de Comunicação: webservice Método: recebernfeinutilizacao Estrutura dos Dados de Entrada Parâmetro Descrição Tipo Ocorrência strin Recebe o XML de Inutilização String 1 Este web service receberá um parâmetro string contendo um XML. Confira a Estrutura do XML. Exemplo do XML de saída: <inutiliza> <cuf>35</cuf> <ano> </ano> <cnpj> </cnpj> <modelo>1</modelo> <serie>55</serie> <seriede>9</seriede> <serieate>19</serieate> <justificativa> A justificativa deve conter no mínimo 15 caracteres </justificativa> </inutiliza> 5.5 WS4 Resposta Interface: ERP -> Notanet Tipo de Comunicação: WebService Estrutura dos Dados de Saida Parâmetro Descrição Tipo Ocorrência resposta XML de resposta String 1 Este web service enviará um XML de resposta a solicitação feita pelo o usuário. Confira a Estrutura do XML Exemplo do XML de saída: 10

11 <resposta> <notafiscal> <identificador>686</identificador> <data> :21:29</data> <finalizada>true</finalizada> <chave> </chave> <protocoloautorizacao> </protocoloautorizacao> <codigo>6</codigo> <descricao>autorizado o uso da NF-e</descricao> <nfe><![cdata[xml da NF-e]]></nfe> </notafiscal> </resposta> 11