MANUAL DE INTEGRAÇÃO Notanet NF-e Integração via WebService 1
Histórico de Revisões Data Versão Descrição 15/07/2008 1.0 Primeira versão 25/07/2008 1.1 Correção da tabela de Status da Nota item 6.1.4 18/08/2008 1.2 Inclusão do registro de resposta 400 - Lote de Requisições inválido 16/01/2009 1.3 Adequação à Nota Técnica 2008/006. - Inclusão dos tipos de emissão 4 e 5 (DPEC e FS-DA). 16/03/2009 1.4 Inclusão da pasta para Fila de Contingência do Montador TXT. 25/03/2009 1.5 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 4 5.1 WS1 RECEBER NF-E 4 2
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 9 9 10 10 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. 4.1. Acessos 3
Homologação: http://nfe2.boldcron.com.br/montador/services/processadornota http://nfe2.boldcron.com.br/montador/services/processadornota?wsdl Produção: https://asp.notanet.com.br/montador/services/processadornota https://asp.notanet.com.br/montador/services/processadornota?wsdl 5 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
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>2008-03-31</dataemissao> <dataentradasaida>2008-03-31</dataentradasaida> <codigouf>35</codigouf> <formapagamento>0</formapagamento> <codigomodelofiscal>55</codigomodelofiscal> <finalidadeemissao>1</finalidadeemissao> <NFref> <ref> <chave>41080381034993001781550010000000330000138931</chave> <cuf>41</cuf> <AAMM>0803</AAMM> <CNPJ>81034993001781</CNPJ> <mod>55</mod> <serie>1</serie> </ref> </NFref> </cabecalho> <emitente> <razaosocial>copagra-coop.agroindustrial DO NOROESTE PARANAENSE</razaoSocial> <nomefantasia>destilaria</nomefantasia> <cnpj>00776574000156</cnpj> <inscricaoestadual>492513778117</inscricaoestadual> <inscricaomunicipal></inscricaomunicipal> <inscricaoestadualst></inscricaoestadualst> <cnae>1931-4/00</cnae> <endereco> <rua>br 376 - KM 36 - LOTE 04-A</rua> <numero>s/n</numero> <cep>87960000</cep> <complemento></complemento> <bairro>zona RURAL</bairro> <cidade>nova LONDRINA</cidade> <codigomunicipio>3550308</codigomunicipio> <codigopais>1058</codigopais> <uf>sp</uf> <codigouf>35</codigouf> <pais>brasil</pais> <fone>4434321113</fone> </endereco> 5
</emitente> <destinatario> <nome>petrobras DISTRIBUIDORA S/A</nome> <cnpj>34274233026241</cnpj> <cpf></cpf> <inscricaoestadual>1070205005</inscricaoestadual> <isuf></isuf> <endereco> <rua>rod. XISTO BR 476 KM 15440</rua> <numero>s/n</numero> <cep>83700000</cep> <complemento></complemento> <bairro>zona INDUSTRIAL</bairro> <cidade>araucaria</cidade> <codigomunicipio>4101804</codigomunicipio> <codigopais>1058</codigopais> <uf>pr</uf> <pais>brasil</pais> <fone>0416421313</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>7800.00</baseicms> <valoricms>936.00</valoricms> <genero></genero> <extipi>2207.10.00</extipi> <ncm>2207.10.00</ncm> <quantidadecomercial>10000.0000</quantidadecomercial> <quantidadetributavel>10000.0000</quantidadetributavel> <unidadecomercial>lt</unidadecomercial> <unidadetributavel>lt</unidadetributavel> <valordesconto>0.00</valordesconto> <valorfrete>0.00</valorfrete> <valorbrutoproduto>7800.00</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
<valorbc>7800.00</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>7800.00</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>7800.00</totnota> <totoutrasdespesasacessorias>0.00</totoutrasdespesasacessorias> <totpis>0.00</totpis> <totprodutos>7800.00</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
<cnpj>79139762000123</cnpj> <cpf></cpf> <inscricaoestadual>7010401121</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>04430279000</fone> </endereco> </transportador> <volume> <quantidade>0</quantidade> <especie></especie> <marca></marca> <numero>0</numero> <pesobruto>10000.000</pesobruto> <pesoliquido>10000.000</pesoliquido> </volume> </transporte> <dadosadicionais>op.int.: 2444 SIMPLES REMESSA ENTREGA FUTURA - PRODUCAO PROPRIA</dadosAdicionais> </NotaFiscal> 8
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>82653726000198</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>35080303906304000100550020000141990000006349</chave> <justificativa>a justificativa deve conter no mínimo 15 caracteres</justificativa> </cancelamento> 9
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>31-01-2010</ano> <cnpj>08030390627935</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
<resposta> <notafiscal> <identificador>686</identificador> <data>2008-03-25 08:21:29</data> <finalizada>true</finalizada> <chave>35080303906304000100550020000141990000006349</chave> <protocoloautorizacao>333080000701738</protocoloautorizacao> <codigo>6</codigo> <descricao>autorizado o uso da NF-e</descricao> <nfe><![cdata[xml da NF-e]]></nfe> </notafiscal> </resposta> 11