mu - integrao_v4.01_v2.6.7

Download MU - Integrao_v4.01_v2.6.7

Post on 20-Jul-2015

101 views

Category:

Documents

1 download

Embed Size (px)

TRANSCRIPT

G2KA NF-e Software Emissor de NF-eManual de Integrao

Verso 2.6.7 (15/02/2012)

Av. Martin Luther, 816 - sala 301 - Victor Konder - Blumenau/SC - Telefone: (47)3035-7882 Pgina 1 de 72

NDICE1 INTRODUO ............................................................................. 4 1.1 REVISES ..................................................................................................................... 4 2 ESCALABILIDADE E PERFORMANCE ............................................ 6 3 SOLICITAES DO ERP ............................................................... 7 3.1 Envio de nf-e .................................................................................................................. 7 3.2 Cancelamento ................................................................................................................. 7 3.3 Inutilizao ..................................................................................................................... 8 3.4 Carta de Correo ........................................................................................................... 8 3.5 Impresso de DANFE .................................................................................................... 8 3.6 Escriturao Fiscal Digital ............................................................................................. 9 4 FORMAS DE INTEGRAO ......................................................... 10 4.1 PADRES DAS SOLICITAES DE ENVIO ......................................................... 11 4.1.1 4.1.2 4.1.3 4.1.4 Arquivo TEXTO ................................................................................................. 11 Arquivo XML...................................................................................................... 12 WEBSERVICES ................................................................................................. 12 Banco de Dados ................................................................................................... 13

4.2 PADRES DAS SOLICITAES DE RETORNO ................................................... 14 4.2.1 4.2.2 4.2.3 4.2.4 4.2.5 4.2.6 Arquivo TEXTO ................................................................................................. 14 Arquivo XML...................................................................................................... 15 WEBSERVICES ................................................................................................. 16 Banco de Dados ................................................................................................... 16 URL ..................................................................................................................... 17 Banco de Dados VIA SCRIPT ............................................................................ 18

4.3 FLUXO DE INTEGRAO ....................................................................................... 20 5 LAYOUT DE INTEGRAO MODELO TEXTO ................................ 21 5.1 GRUPOS ...................................................................................................................... 21 5.2 CAMPOS ..................................................................................................................... 21 5.3 EXPRESSES ............................................................................................................. 21 5.4 SOLICITAO DE ENVIO DE NF-e ........................................................................ 22 5.4.1 5.4.2 PSEUDOCDIGO .............................................................................................. 22 TABELA DE INFORMAES ......................................................................... 27

Av. Martin Luther, 816 - sala 301 - Victor Konder - Blumenau/SC - Telefone: (47)3035-7882 Pgina 2 de 72

5.5 SOLICITAO DE CANCELAMENTO ................................................................... 53 5.6 SOLICITAO DE CORREO .............................................................................. 54 5.7 SOLICITAO DE INUTILIZAO ....................................................................... 56 5.8 SOLICITAO DE CONSULTA DE CADASTRO.................................................. 57 5.9 SOLICITAO DE REIMPRESSO DE DANFE.................................................... 58 5.10 RETORNO PARA O ERP ........................................................................................... 59 5.10.1 Retorno de ENVIO de NF-e ................................................................................ 59 5.10.2 Retorno de ENVIO de NF-e layout XML ........................................................... 60 5.10.3 Retorno de envio de CANCELAMENTO .......................................................... 61 5.10.4 Retorno de envio de CANCELAMENTO layout XML...................................... 62 5.10.5 Retorno de envio de CARTA DE CORREO ................................................. 63 5.10.6 Retorno de envio de CARTA DE CORREO LAYOUT XML...................... 65 5.10.7 Retorno de envio de INUTILIZAO ............................................................... 66 5.10.8 Retorno de envio de INUTILIZAO layout XML .......................................... 66 6 LAYOUT DE INTEGRAO MODELO XML .................................... 69 6.1 SOLICITAO DE ENVIO DE NF-e ........................................................................ 69 6.1.1 Informaes adicionais ........................................................................................ 69

6.2 SOLICITAO DE CANCELAMENTO ................................................................... 70 6.3 SOLICITAO DE ENVIO DE CARTA DE CORREO ..................................... 70 6.4 SOLICITAO DE INUTILIZAO ....................................................................... 71 6.5 SOLICITAO DE REIMPRESSO DO DANFE ................................................... 71 6.6 RETORNO PARA O ERP ........................................................................................... 72 6.6.1 6.6.2 6.6.3 Retorno de Envio de NF-e ................................................................................... 72 Retorno de envio de CANCELAMENTO .......................................................... 72 Retorno de envio de INUTILIZAO ............................................................... 72

Av. Martin Luther, 816 - sala 301 - Victor Konder - Blumenau/SC - Telefone: (47)3035-7882 Pgina 3 de 72

1 INTRODUOO G2KA NF-e um software que presta suporte completo transmisso, recepo e gerenciamento de Notas Fiscais eletrnicas. Por ser desenvolvido com tecnologias avanadas, ele permite a integrao com qualquer sistema ERP de forma simples e flexvel. Sua arquitetura e funcionalidades atendem plenamente as necessidades dos contribuintes e das legislaes das Secretarias da Fazenda (SEFAZ) dos estados brasileiros. O produto foi desenvolvido com o objetivo de abstrair das empresas a preocupao com detalhes tcnicos e regras de negcio especficas da Nota Fiscal eletrnica. Desta forma, as empresas podem continuar a desempenhar as atividades que so realmente seu foco, deixando com o G2KA NF-e a responsabilidade pelos tratamentos de comunicao com a SEFAZ. Este documento visa especificar os layouts de integrao que permitem a comunicao entre o Sistema de Gesto e o G2KA NF-e. Os layouts apresentados determinam modelos de formatao das informaes das Notas Fiscais emitidas pelo ERP, e enviadas ao G2KA NF-e. Seguindo esses modelos, possvel a troca dos dados atravs da exportao de arquivos texto, arquivos XML, webservices ou banco de dados.

1.1 REVISESNo quadro abaixo so listadas as revises deste documento.

Verso1.0

Autor

Data

ObservaoCriao - Incluso do Quadro de revises - Incluso do item 4.2.6, retorno via Script - Includo Observao nas TAGs X18 e X22 conforme NT2011.005 - 4.1.4 e 4.2.4 Incluso de parmetro TIPDOC = 6 - 4.2.5 Alterado campo chNFe que retornar sem o prefixo NFE - 5.4.2 Includo Tabela de Situao Tributria para os grupos Q e S. - 5.10.5 Includo retorno de envio de CC-e layout Texto. - 5.10.6 Includo retorno de envio de CC-e layout XML 6.1.1 Correo no layout XML - 5.6 Retirado o literal NFE da chave da nota para Carta de Correo.

2.6.5.3

Ester Tsch

04/11/2011

2.6.6

Ester Tsch

15/12/2011

2.6.7

Ester Tsch

22/02/2012

Av. Martin Luther, 816 - sala 301 - Victor Konder - Blumenau/SC - Telefone: (47)3035-7882 Pgina 4 de 72

Av. Martin Luther, 816 - sala 301 - Victor Konder - Blumenau/SC - Telefone: (47)3035-7882 Pgina 5 de 72

2 ESCALABILIDADE E PERFORMANCESituaes que demandam de um alto desempenho podem ser identificadas em clientes que possuam um processo operacional de faturamento com inmeros faturistas e/ou uma quantidade elevada de emisso de Notas Fiscais. Nessas situaes, o software emissor de NFe precisa atender ao volume de requisies, assim como fazer o balanceamento de carga da execuo. O G2KA NF-e foi preparado para atender situaes como essa sem perder performance nas execues. Isso possvel atravs de um recurso denominado de filas de impresso. As filas de impresso so processos de execuo paralela, que criam diferentes monitores de processamento de NF-e. Esses monitores so responsveis por enviar solicitaes para a SEFAZ e, posteriormente, direcionar a impresso do DANFE (Documento Auxiliar da Nota Fiscal eletrnica) para diferentes impressoras, cadastradas previamente. Ao cadastrar uma fila de impresso, informado um cdigo, um diretrio de monitoramento e uma impressora padro para a impresso do DANFE. A partir dessas informaes, o G2KA NFe sabe qual local monitorar e para qual impressora enviar o DANFE. Uma fila de impresso pode atender a vrios faturistas, assim como cada faturista (ou grupo de faturistas) pode possuir sua prpria fila de impresso. Em resumo,