Requisitos RFW.SEFAZ - Histórico de revisão

Rodrigogml em 00h07min de 14 de fevereiro de 2025

2025-02-14T00:07:03Z

← Edição anterior		Edição das 00h07min de 14 de fevereiro de 2025
Linha 38:		Linha 38:

	Por isso é comum termos os nomes das classes precedidas com a letra "T" (embora não seja uma regra), já que a SEFAZ batiza o 'type' dentro do schema com o mesmo nome da tag precedida da letra 'T".}}		Por isso é comum termos os nomes das classes precedidas com a letra "T" (embora não seja uma regra), já que a SEFAZ batiza o 'type' dentro do schema com o mesmo nome da tag precedida da letra 'T".}}


			= Resumo de Informações que Você Deve Saber =

			== Estrutura das Tags da NFe ==

			=== Definição do Documento Fiscal ===

			* A estrutura de informações de uma NFe é inteiramente escrita dentro de uma tag '''<NFe>''', e a documentação do seu conteúdo está descrito no Anexo I do Manual de Orientações ao Contribuinte (MOC).
			** Dentro dessa estrutura existem duas tags: '''<infNFe>''' e '''<Signature> que respecitivamente contém as informações do documento fiscal, e a assinatura digital dos dados dessa nota.

			A estrutura simplificada fica assim:
			<pre>
			<NFe>
			<infNFe>
			[dados da NFe]
			</infNFe>
			<Signature>
			[assinatura digital]
			</Signature>
			</NFe>
			</pre>


			=== Envio da NFe para Autorização ===

			Para solicitar a autorização da NFe no WebService da SEFAZ enviamos a tag '''<NFe>''' encapsulada dentro da tag '''<enviNFe>''', que aceita uma lista de até 50 tags '''<NFe>''' para autorização em Lote. Montando a seguinte estrutura:

			<pre>
			<enviNFe>
			<NFe>
			<infNFe>
			[dados da NFe]
			</infNFe>
			<Signature>
			[assinatura digital]
			</Signature>
			</NFe>
			<NFe>
			<infNFe>
			[dados da NFe]
			</infNFe>
			<Signature>
			[assinatura digital]
			</Signature>
			</NFe>
			...
			</enviNFe>
			</pre>

			No método assíncrono, temos de consultar a autorização do lote com outro método do WebService, cujo retorno tem a seguinte estrutura:

			<pre>
			<retConsReciNFe>
			<protNFe>
			[protocolo de autorização da NFe]
			</protNFe>
			<protNFe>
			[protocolo de autorização da NFe]
			</protNFe>
			...
			</retConsReciNFe>
			</pre>

			Note que há uma tag '''<protNFe>''' para cada tag '''<NFe>''' enviada para autorização.


			=== Layout de Distribuição ===

			Por fim, o Manual de Orientações ao Contribuinte, define o '''Layout de Distribuição'''. Este layout define como os arquivos .XML da NFe devem ser compatilhado entre as pontas. E sua estrutura, de forma simplificada, é a seguinte:


			<pre>
			<nfeProc>
			<NFe>
			<infNFe>
			[dados da NFe]
			</infNFe>
			<Signature>
			[assinatura digital]
			</Signature>
			</NFe>
			<protNFe>
			[protocolo de autorização da NFe]
			</protNFe>
			</nfeProc>
			</pre>


			Note que o arquivo final .XML da NFe contém a tag '''<NFe>''' com a assinatura que foi enviada no começo para a autorização, seguida da tag '''<protNFe>''' que contém os dados da sua autorização.

Rodrigogml: /* Pendêncis da Implementação (Próximos passos e melhorias) */

2025-02-12T21:12:51Z

Pendêncis da Implementação (Próximos passos e melhorias)

← Edição anterior		Edição das 21h12min de 12 de fevereiro de 2025
Linha 24:		Linha 24:

	=== Pendêncis da Implementação (Próximos passos e melhorias) ===		=== Pendêncis da Implementação (Próximos passos e melhorias) ===
	* Métodos Aguardando Implementação
	** nfeAutorizacaoLoteZip


			* Próximos Passos de Implementação:
			# Implementar suporte aos demais servidores
			# Implementação dos métodos restantes:
			#:* nfeAutorizacaoLoteZip

	== Objetos de Representação do XML ==		== Objetos de Representação do XML ==

Rodrigogml: /* Requisitos */

2025-02-12T21:09:42Z

Requisitos

← Edição anterior		Edição das 21h09min de 12 de fevereiro de 2025
Linha 6:		Linha 6:

	Para atingir este objetivo o módulo fornece objetos com a estrutura de dados defina nos Schemas dos XMLs da SEFAZ. Desta forma o desenvolvedor pode abstrair toda a preocupação escrita e tratamento do XML. O módulo recebe esses objetos e faz toda a conversão e comunicação com a SEFAZ internamente.		Para atingir este objetivo o módulo fornece objetos com a estrutura de dados defina nos Schemas dos XMLs da SEFAZ. Desta forma o desenvolvedor pode abstrair toda a preocupação escrita e tratamento do XML. O módulo recebe esses objetos e faz toda a conversão e comunicação com a SEFAZ internamente.

			== Status do Desenvolvimento ==

			=== Métodos Implementados ===

			* WebServices Suportados
			** Homologação SP
			** Produção SP


			* Métodos Implementados
			** consultaCadastro - Layout v2.00
			** nfeAutorizacaoLote - Layout v4.00
			** nfeRetAutorizacao - Layout v4.00
			** nfeStatusServicoNF - Layout v4.00


			=== Pendêncis da Implementação (Próximos passos e melhorias) ===
			* Métodos Aguardando Implementação
			** nfeAutorizacaoLoteZip



	== Objetos de Representação do XML ==		== Objetos de Representação do XML ==

Rodrigogml: /* Objetos de Representação do XML */

2025-02-12T21:04:23Z

Objetos de Representação do XML

← Edição anterior		Edição das 21h04min de 12 de fevereiro de 2025
Linha 15:		Linha 15:

	Por isso é comum termos os nomes das classes precedidas com a letra "T" (embora não seja uma regra), já que a SEFAZ batiza o 'type' dentro do schema com o mesmo nome da tag precedida da letra 'T".}}		Por isso é comum termos os nomes das classes precedidas com a letra "T" (embora não seja uma regra), já que a SEFAZ batiza o 'type' dentro do schema com o mesmo nome da tag precedida da letra 'T".}}


	Esses objetos de representação do XML são organizados dentro do package '''br.eng.rodrigogml.rfw.sefaz.xsdobjects''', com subpackages nomeados de acordo com o nome e versão do schema de solicitação:

	* '''br.eng.rodrigogml.rfw.sefaz.xsdobjects.conscadv200.*''' - Objetos to serviço '''Web Service – NfeConsultaCadastro'''.
	** '''Root Solicitação:''' TConsCad
	** '''Root Resposta:''' TRetConsCad
	* '''br.eng.rodrigogml.rfw.sefaz.xsdobjects.envinfev400.*''' - Objetos to serviço '''Web Service – NfeAutorizacao'''.
	** '''Root Solicitação:''' TEnviNFe
	** '''Root Resposta:''' TRetEnviNFe

Rodrigogml: /* Documentação e Informação Oficial */

2025-02-08T22:30:24Z

Documentação e Informação Oficial

← Edição anterior		Edição das 22h30min de 8 de fevereiro de 2025
Linha 25:		Linha 25:
	** '''Root Solicitação:''' TEnviNFe		** '''Root Solicitação:''' TEnviNFe
	** '''Root Resposta:''' TRetEnviNFe		** '''Root Resposta:''' TRetEnviNFe

	~~= Documentação e Informação Oficial =~~
	* '''Site Oficial:''' [https://www.nfe.fazenda.gov.br/portal/principal.aspx Portal da Nota Fiscal Eletrônica] - Na sessão de download é possível encontrar os manuais e outros documentos técnicos sobre a emissão da NFe e NFCe. Como:
	** '''Manual de Orientação ao Contribuinte''' - Trás informações gerais sobre o sistema, definições de tabelas e regras de comunicação com o WebService.
	*** '''Anexo I''' - trás o layout do arquivo XML de representação da NFe e NFCe.
	*** '''Anexo IV''' - trás o manual de contigência da NFCe.

	~~== Legislação de São Paulo ==~~

	~~=== Credenciamento para Emissão de NFCe ===~~
	~~Fonte: [https://legislacao.fazenda.sp.gov.br/Paginas/Portaria-SRE-40-de-2024.aspx PORTARIA SRE 40, DE 5 DE JULHO DE 2024]~~

	~~'''Artigo 2°''' - Para a emissão da NFC-e o contribuinte deverá efetuar previamente seu credenciamento junto à Secretaria da Fazenda e Planejamento (Ajuste SINIEF 19/16, cláusula segunda).~~

	''§ 1º'' - Para o credenciamento de que trata o “caput”, o contribuinte deverá acessar o sistema de credenciamento disponível na Internet, no endereço eletrônico http://nfce.fazenda.sp.gov.br/NFCePortal/ - opção “Credenciamento”, e preencher os dados solicitados no formulário eletrônico.

Rodrigogml: /* Credenciamento do Contribuinte para emissão de NFCe */

2025-02-08T22:26:43Z

Credenciamento do Contribuinte para emissão de NFCe

← Edição anterior		Edição das 22h26min de 8 de fevereiro de 2025
Linha 34:		Linha 34:
	== Legislação de São Paulo ==		== Legislação de São Paulo ==

	=== Credenciamento ~~do Contribuinte~~ para ~~emissão~~ de NFCe ===		=== Credenciamento para Emissão de NFCe ===
	Fonte: [https://legislacao.fazenda.sp.gov.br/Paginas/Portaria-SRE-40-de-2024.aspx PORTARIA SRE 40, DE 5 DE JULHO DE 2024]		Fonte: [https://legislacao.fazenda.sp.gov.br/Paginas/Portaria-SRE-40-de-2024.aspx PORTARIA SRE 40, DE 5 DE JULHO DE 2024]

Rodrigogml: /* Documentação e Informação Oficial */

2025-02-08T22:26:27Z

Documentação e Informação Oficial

← Edição anterior		Edição das 22h26min de 8 de fevereiro de 2025
Linha 32:		Linha 32:
	*** '''Anexo IV''' - trás o manual de contigência da NFCe.		*** '''Anexo IV''' - trás o manual de contigência da NFCe.

	== ~~PORTARIA SRE 40, DE 5 DE JULHO DE 2024~~ ==		== Legislação de São Paulo ==

	Fonte: https://legislacao.fazenda.sp.gov.br/Paginas/Portaria-SRE-40-de-2024.aspx		=== Credenciamento do Contribuinte para emissão de NFCe ===
			Fonte: [https://legislacao.fazenda.sp.gov.br/Paginas/Portaria-SRE-40-de-2024.aspx PORTARIA SRE 40, DE 5 DE JULHO DE 2024]

	'''Artigo 2°''' - Para a emissão da NFC-e o contribuinte deverá efetuar previamente seu credenciamento junto à Secretaria da Fazenda e Planejamento (Ajuste SINIEF 19/16, cláusula segunda).		'''Artigo 2°''' - Para a emissão da NFC-e o contribuinte deverá efetuar previamente seu credenciamento junto à Secretaria da Fazenda e Planejamento (Ajuste SINIEF 19/16, cláusula segunda).

	''§ 1º'' - Para o credenciamento de que trata o “caput”, o contribuinte deverá acessar o sistema de credenciamento disponível na Internet, no endereço eletrônico http://nfce.fazenda.sp.gov.br/NFCePortal/ - opção “Credenciamento”, e preencher os dados solicitados no formulário eletrônico.		''§ 1º'' - Para o credenciamento de que trata o “caput”, o contribuinte deverá acessar o sistema de credenciamento disponível na Internet, no endereço eletrônico http://nfce.fazenda.sp.gov.br/NFCePortal/ - opção “Credenciamento”, e preencher os dados solicitados no formulário eletrônico.

Rodrigogml: /* Documentação e Informação Oficial */

2025-02-08T22:24:38Z

Documentação e Informação Oficial

← Edição anterior		Edição das 22h24min de 8 de fevereiro de 2025
Linha 31:		Linha 31:
	*** '''Anexo I''' - trás o layout do arquivo XML de representação da NFe e NFCe.		*** '''Anexo I''' - trás o layout do arquivo XML de representação da NFe e NFCe.
	*** '''Anexo IV''' - trás o manual de contigência da NFCe.		*** '''Anexo IV''' - trás o manual de contigência da NFCe.

			== PORTARIA SRE 40, DE 5 DE JULHO DE 2024 ==

			Fonte: https://legislacao.fazenda.sp.gov.br/Paginas/Portaria-SRE-40-de-2024.aspx

			'''Artigo 2°''' - Para a emissão da NFC-e o contribuinte deverá efetuar previamente seu credenciamento junto à Secretaria da Fazenda e Planejamento (Ajuste SINIEF 19/16, cláusula segunda).

			''§ 1º'' - Para o credenciamento de que trata o “caput”, o contribuinte deverá acessar o sistema de credenciamento disponível na Internet, no endereço eletrônico http://nfce.fazenda.sp.gov.br/NFCePortal/ - opção “Credenciamento”, e preencher os dados solicitados no formulário eletrônico.

Rodrigogml: /* Documentação e Informação Oficial */

2025-02-08T22:07:53Z

Documentação e Informação Oficial

← Edição anterior		Edição das 22h07min de 8 de fevereiro de 2025
Linha 30:		Linha 30:
	** '''Manual de Orientação ao Contribuinte''' - Trás informações gerais sobre o sistema, definições de tabelas e regras de comunicação com o WebService.		** '''Manual de Orientação ao Contribuinte''' - Trás informações gerais sobre o sistema, definições de tabelas e regras de comunicação com o WebService.
	*** '''Anexo I''' - trás o layout do arquivo XML de representação da NFe e NFCe.		*** '''Anexo I''' - trás o layout do arquivo XML de representação da NFe e NFCe.
			*** '''Anexo IV''' - trás o manual de contigência da NFCe.

Rodrigogml em 22h07min de 8 de fevereiro de 2025

2025-02-08T22:07:04Z

← Edição anterior		Edição das 22h07min de 8 de fevereiro de 2025
Linha 1:		Linha 1:
			= Requisitos =
	= Objetivo Principal =		== Objetivo Principal ==

	O objetivo deste módulo é permitir uma integração transparente com os serviços da SEFAZ (WebServices) de forma mais transparente possível e integrada ao framework RFW para facilitar sua utilização.		O objetivo deste módulo é permitir uma integração transparente com os serviços da SEFAZ (WebServices) de forma mais transparente possível e integrada ao framework RFW para facilitar sua utilização.
Linha 7:		Linha 7:
	Para atingir este objetivo o módulo fornece objetos com a estrutura de dados defina nos Schemas dos XMLs da SEFAZ. Desta forma o desenvolvedor pode abstrair toda a preocupação escrita e tratamento do XML. O módulo recebe esses objetos e faz toda a conversão e comunicação com a SEFAZ internamente.		Para atingir este objetivo o módulo fornece objetos com a estrutura de dados defina nos Schemas dos XMLs da SEFAZ. Desta forma o desenvolvedor pode abstrair toda a preocupação escrita e tratamento do XML. O módulo recebe esses objetos e faz toda a conversão e comunicação com a SEFAZ internamente.

	= Objetos de Representação do XML =		== Objetos de Representação do XML ==

	Os objetos que representam as tags do XML são criados com o JAXB a partir do Schema fornecido pela própria SEFAZ.		Os objetos que representam as tags do XML são criados com o JAXB a partir do Schema fornecido pela própria SEFAZ.
Linha 25:		Linha 25:
	** '''Root Solicitação:''' TEnviNFe		** '''Root Solicitação:''' TEnviNFe
	** '''Root Resposta:''' TRetEnviNFe		** '''Root Resposta:''' TRetEnviNFe

			= Documentação e Informação Oficial =
			* '''Site Oficial:''' [https://www.nfe.fazenda.gov.br/portal/principal.aspx Portal da Nota Fiscal Eletrônica] - Na sessão de download é possível encontrar os manuais e outros documentos técnicos sobre a emissão da NFe e NFCe. Como:
			** '''Manual de Orientação ao Contribuinte''' - Trás informações gerais sobre o sistema, definições de tabelas e regras de comunicação com o WebService.
			*** '''Anexo I''' - trás o layout do arquivo XML de representação da NFe e NFCe.