IN CIGAM Integrador - Histórico de revisão

Camila.Oliveira: /* Estoque */

2026-10-09T15:20:04Z

Estoque

← Edição anterior		Edição das 15h20min de 9 de outubro de 2026
Linha 74:		Linha 74:
	:*[[IN_CadastroSubGrupos.integrador\|CadastroSubGrupos.integrador]]		:*[[IN_CadastroSubGrupos.integrador\|CadastroSubGrupos.integrador]]
	:*[[IN_CadastroUnidadeMedida.integrador\|CadastroUnidadeMedida.integrador]]		:*[[IN_CadastroUnidadeMedida.integrador\|CadastroUnidadeMedida.integrador]]
	~~:*[[IN_ModificarPesosEVolume.integrador\|ModificarPesosEVolume.integrador]]~~

	== Faturamento ==		== Faturamento ==

Camila.Oliveira: /* Estoque */

2026-10-09T14:44:19Z

Estoque

← Edição anterior		Edição das 14h44min de 9 de outubro de 2026
Linha 74:		Linha 74:
	:*[[IN_CadastroSubGrupos.integrador\|CadastroSubGrupos.integrador]]		:*[[IN_CadastroSubGrupos.integrador\|CadastroSubGrupos.integrador]]
	:*[[IN_CadastroUnidadeMedida.integrador\|CadastroUnidadeMedida.integrador]]		:*[[IN_CadastroUnidadeMedida.integrador\|CadastroUnidadeMedida.integrador]]
	~~:*[[IN_CadastroPosicaoEstoque.integrador\|CadastroPosicaoEstoque.integrador]]~~
	:*[[IN_ModificarPesosEVolume.integrador\|ModificarPesosEVolume.integrador]]		:*[[IN_ModificarPesosEVolume.integrador\|ModificarPesosEVolume.integrador]]

Camila.Oliveira: /* Genérico */

2026-10-06T17:24:45Z

Genérico

← Edição anterior		Edição das 17h24min de 6 de outubro de 2026
Linha 110:		Linha 110:
	:*[[IN_CadastroTiposEmpresa.integrador\|CadastroTiposEmpresa.integrador]]		:*[[IN_CadastroTiposEmpresa.integrador\|CadastroTiposEmpresa.integrador]]
	-->		-->
			:*[[IN_CadastroAcompanhamento.integrador\|CadastroAcompanhamento.integrador]]
	:*[[IN_CadastroCategoriasTg.integrador\|CadastroCategoriasTg.integrador]]		:*[[IN_CadastroCategoriasTg.integrador\|CadastroCategoriasTg.integrador]]
	:*[[IN_CadastroColaboradores.integrador\|CadastroColaboradores.integrador]]		:*[[IN_CadastroColaboradores.integrador\|CadastroColaboradores.integrador]]

Camila.Oliveira: /* Utilizando o retorno dos Serviços */

2026-03-12T19:27:36Z

Utilizando o retorno dos Serviços

← Edição anterior		Edição das 19h27min de 12 de março de 2026
Linha 631:		Linha 631:
	:'''Exemplo 2'''		:'''Exemplo 2'''
	[[Arquivo:IN 007.jpg\|580×267px\|Exemplo 2]]		[[Arquivo:IN 007.jpg\|580×267px\|Exemplo 2]]
			{{VoltarInicio}}

Camila.Oliveira: /* Utilizando o retorno dos Serviços */

2026-03-12T19:27:13Z

Utilizando o retorno dos Serviços

← Edição anterior		Edição das 19h27min de 12 de março de 2026
Linha 579:		Linha 579:

	==Utilizando o retorno dos Serviços ==		==Utilizando o retorno dos Serviços ==
	=== ~~Xml ==~~=		Os serviços disponibilizados podem retornar dados nos formatos '''XML''' ou '''JSON''', dependendo do protocolo utilizado. A manipulação dessas respostas pode ser feita utilizando classes utilitárias disponibilizadas pelo próprio CIGAM ou pelas bibliotecas padrão do .NET.
	~~<p align~~=~~"justify" style~~=~~"margin-left: 0.32in; text-indent: 0.45in; margin-bottom: 0.08in; font-weight: normal; line-height: 150%;">~~
	Os serviços que utilizam o protocolo SOAP~~, tem como retorno~~ uma ~~String~~ no formato ~~Xml, para melhor visualização destes dados~~, está disponível na classe ~~“Xml”~~, do namespace Cigam.Utils, um método estático ~~chamado “XmlStringToDataTable”. Este retorna~~ um objeto do tipo System.Data.DataTable~~. Segue abaixo um exemplo de implementação.~~<br/>		=== XML ===
			Os serviços que utilizam o protocolo '''SOAP''' retornam os dados em uma '''string no formato XML'''.

			Para facilitar a manipulação dessas informações, está disponível na classe <code>Xml</code>, do namespace <code>Cigam.Utils</code>, o método estático <code>XmlStringToDataTable</code>, que converte o conteúdo XML retornado em um objeto do tipo <code>System.Data.DataTable</code>, permitindo trabalhar com os dados de forma estruturada.

			'''Exemplo de utilização (Exemplo 1)'''
	<br/>		<br/>
	[[Arquivo:IN_001.jpg\|580×267px\|Exemplo 1]]		[[Arquivo:IN_001.jpg\|580×267px\|Exemplo 1]]
	<~~br/~~><br/>
	~~Também pode ser utilizada a classe XmlDocument~~, do namespace System.Xml ~~para fazer~~ a manipulação ~~dos dados~~. ~~Segue abaixo um exemplo~~ de ~~implementação.<br/>~~
			Outra alternativa é utilizar a classe <code>XmlDocument</code>, do namespace <code>System.Xml</code>, que permite realizar a leitura e manipulação manual da estrutura do XML.

			'''Exemplo de utilização (Exemplo 2)'''
	<br/>		<br/>
	[[Arquivo:IN 002.jpg\|580×267px\|Exemplo 2]]		[[Arquivo:IN 002.jpg\|580×267px\|Exemplo 2]]
	~~<br/>~~

	=== ~~Json~~ ===		=== JSON ===
			Os serviços que utilizam o protocolo '''REST''' retornam os dados em uma '''string no formato JSON'''.

			Para trabalhar com essas informações, está disponível a classe <code>JSonDocument</code>, no namespace <code>Cigam.Utils</code>. Essa classe interpreta automaticamente a string retornada e disponibiliza propriedades e métodos para manipulação dos dados.

	Os serviços que utilizam o protocolo REST, tem como retorno uma String no formato JSon, para trabalhar com estes dados, está disponível a classe “JSonDocument” no namespace Cigam.Utils. Esta classe fornece a interpretação da string retornada além de propriedades e ~~métodos para manipulação dos dados. Seguem abaixo exemplos de como instanciar e alimentar~~ a classe.<br/>		'''Instanciando e alimentando a classe'''<br>
	~~<br/>~~		:'''Exemplo 1'''
	~~   <b><u>~~Exemplo 1~~:</u></b><br/>~~
	[[Arquivo:IN 003.jpg\|580×267px\|Exemplo 1]]		[[Arquivo:IN 003.jpg\|580×267px\|Exemplo 1]]
	<br/>		<br/>
	~~<br/>~~		:'''Exemplo 2'''
	~~   <b><u>~~Exemplo 2~~:</u></b><br/>~~
	[[Arquivo:IN 004.jpg\|580×267px\|Exemplo 2]]		[[Arquivo:IN 004.jpg\|580×267px\|Exemplo 2]]
	<br/>		<br/>
	~~<br/>~~		:'''Exemplo 3'''
	~~   <b><u>~~Exemplo 3~~:</u></b><br/>~~
	[[Arquivo:IN 005.jpg\|580×267px\|Exemplo 3]]		[[Arquivo:IN 005.jpg\|580×267px\|Exemplo 3]]
	<~~br/~~><br/>
	~~Esta~~ classe também ~~fornece uma propriedade contendo~~ uma lista genérica ~~que guarda~~ objetos do tipo Cigam.Utils.JSonObject, ~~e esta lista fornece~~ informações ~~sobre os registros da~~ consulta, ~~como o~~ nome da coluna ~~e o~~ valor. ~~Através desta~~ classe ~~também~~ é possível obter o nome original das colunas, ~~caso~~ a consulta ~~possua um cabeçalho de~~ apelidos~~, ou saber~~ se a consulta ~~retornou exception,~~ success ~~ou query. Veja os exemplos abaixo:~~<br/>
	~~   ~~<b>~~<u>Exemplo 1:~~</u></b><br/>		'''<font size=4>Manipulação dos dados retornados</font>'''

			A classe <code>JSonDocument</code> também disponibiliza uma '''lista genérica de objetos do tipo''' <code>Cigam.Utils.JSonObject</code>, que contém as informações de cada registro retornado na consulta, incluindo:
			* nome da coluna
			* valor do campo

			Essa estrutura permite percorrer facilmente os dados retornados pelos serviços.

			Além disso, através dessa classe é possível:
			* obter o '''nome original das colunas''', quando a consulta utiliza cabeçalhos com apelidos
			* identificar se o retorno da consulta foi <code>success</code>, <code>exception</code> ou <code>query</code>

			'''Exemplo de acesso aos registros'''
			:'''Exemplo 1'''
	[[Arquivo:IN 006.jpg\|580×267px\|Exemplo 1]]		[[Arquivo:IN 006.jpg\|580×267px\|Exemplo 1]]
	<br/>		<br/>
	~~   <b><u>~~Exemplo 2~~:</u></b><br/>~~		:'''Exemplo 2'''
	~~<br/>~~
	[[Arquivo:IN 007.jpg\|580×267px\|Exemplo 2]]		[[Arquivo:IN 007.jpg\|580×267px\|Exemplo 2]]
	~~<br/>~~

Camila.Oliveira: /* Aplicação de Integração */

2026-03-12T19:07:07Z

Aplicação de Integração

← Edição anterior		Edição das 19h07min de 12 de março de 2026
Linha 570:		Linha 570:

	= Aplicação de Integração =		= Aplicação de Integração =
	~~<p align="justify" style="margin-left: 0.32in; text-indent: 0.45in; margin-bottom: 0.08in; font-weight: normal; line-height: 150%;">~~		A camada de serviços e/ou de banco de dados tem como responsabilidade '''garantir apenas que os dados sejam gravados na tabela de integração'''. A efetiva importação desses dados para o ERP CIGAM é realizada por um programa específico da aplicação de integração denominado [[GE_Integrador\|Integrador]].
	A camada de serviços e ou de banco de dados ~~garantem “apenas”~~ que ~~o dado chegue até à~~ tabela de integração. A importação ~~dos~~ dados é ~~feita~~ por um programa específico da aplicação de integração ~~chamado~~ [[GE_Integrador\|Integrador]].~~</p>~~

	~~Ao indicar statusRegistro igual a pendente o~~ registro enviado não será ~~integrado ao~~ ERP CIGAM até que ~~tenha~~ seu status ~~igual a liberado~~. ~~Sendo possível sua~~ liberação ~~através~~ do método LiberarPendentes. Também é possível criar o registro com o status Liberado ~~sem~~ a necessidade de ~~requisitar~~ um ~~novo~~ método para liberação.		Quando um registro é enviado com o campo <code>statusRegistro</code> definido como '''Pendente''', ele permanece na tabela de integração e '''não será importado pelo ERP CIGAM''' até que seu status seja alterado para '''Liberado'''.

			A liberação desses registros pode ser realizada por meio do método <code>LiberarPendentes</code>, que altera o status permitindo que o Integrador processe o registro.

			Também é possível criar o registro diretamente com o status '''Liberado''', dispensando a necessidade de chamar posteriormente um método específico para liberação.

	==Utilizando o retorno dos Serviços ==		==Utilizando o retorno dos Serviços ==

Camila.Oliveira: /* Configurações especiais do banco de dados */

2026-03-12T18:46:18Z

Configurações especiais do banco de dados

← Edição anterior		Edição das 18h46min de 12 de março de 2026
Linha 497:		Linha 497:

	Também é importante verificar se o '''Web Server''' que hospeda os serviços está executando em modo 32 bits (x86). Se esse modo estiver habilitado, será necessário configurar igualmente o parâmetro <code>nls_language</code> no '''Oracle Client 32 bits''', assegurando que as sessões utilizem o mesmo padrão de idioma e formatação de datas.		Também é importante verificar se o '''Web Server''' que hospeda os serviços está executando em modo 32 bits (x86). Se esse modo estiver habilitado, será necessário configurar igualmente o parâmetro <code>nls_language</code> no '''Oracle Client 32 bits''', assegurando que as sessões utilizem o mesmo padrão de idioma e formatação de datas.
			{{VoltarInicio}}

	== Validação do Integrador pelo IIS ==		== Validação do Integrador pelo IIS ==

Camila.Oliveira: /* Requisição e resposta dos Webservices */

2026-03-12T18:45:56Z

Requisição e resposta dos Webservices

← Edição anterior		Edição das 18h45min de 12 de março de 2026
Linha 385:		Linha 385:

	Para validar estruturas no formato JSON, pode-se utilizar ferramentas de validação online, como o JSONLint em http://jsonlint.com.		Para validar estruturas no formato JSON, pode-se utilizar ferramentas de validação online, como o JSONLint em http://jsonlint.com.
			{{VoltarInicio}}
	== Tipos especiais ==		== Tipos especiais ==
	Alguns dados utilizam '''formatos específicos''' nas requisições e respostas dos serviços. Esses formatos variam conforme o tipo de dado e a tecnologia utilizada (XML ou JSON).		Alguns dados utilizam '''formatos específicos''' nas requisições e respostas dos serviços. Esses formatos variam conforme o tipo de dado e a tecnologia utilizada (XML ou JSON).

Camila.Oliveira: /* Requisição e resposta dos Webservices */

2026-03-12T18:45:15Z

Requisição e resposta dos Webservices

← Edição anterior		Edição das 18h45min de 12 de março de 2026
Linha 566:		Linha 566:
	[[Image: Integrador6.png\|900px\|centro]]<br/>		[[Image: Integrador6.png\|900px\|centro]]<br/>
	[[Image: Integrador8.png\|900px\|centro]]<br/>		[[Image: Integrador8.png\|900px\|centro]]<br/>
			{{VoltarInicio}}

	= Aplicação de Integração =		= Aplicação de Integração =

Camila.Oliveira: /* Segurança */

2026-03-12T18:44:51Z

Segurança

← Edição anterior		Edição das 18h44min de 12 de março de 2026
Linha 291:		Linha 291:
	:* A alteração da chave deve ser coordenada em todos os pontos de integração.		:* A alteração da chave deve ser coordenada em todos os pontos de integração.
	:* '''Mantenha a chave em sigilo''' e compartilhe somente com equipes autorizadas.		:* '''Mantenha a chave em sigilo''' e compartilhe somente com equipes autorizadas.
			{{VoltarInicio}}

	= Requisição e resposta dos Webservices =		= Requisição e resposta dos Webservices =

← Edição anterior		Edição das 14h44min de 9 de outubro de 2026
Linha 74:		Linha 74:
	:*[[IN_CadastroSubGrupos.integrador\|CadastroSubGrupos.integrador]]		:*[[IN_CadastroSubGrupos.integrador\|CadastroSubGrupos.integrador]]
	:*[[IN_CadastroUnidadeMedida.integrador\|CadastroUnidadeMedida.integrador]]		:*[[IN_CadastroUnidadeMedida.integrador\|CadastroUnidadeMedida.integrador]]
	~~:*[[IN_CadastroPosicaoEstoque.integrador\|CadastroPosicaoEstoque.integrador]]~~
	:*[[IN_ModificarPesosEVolume.integrador\|ModificarPesosEVolume.integrador]]		:*[[IN_ModificarPesosEVolume.integrador\|ModificarPesosEVolume.integrador]]

← Edição anterior		Edição das 17h24min de 6 de outubro de 2026
Linha 110:		Linha 110:
	:*[[IN_CadastroTiposEmpresa.integrador\|CadastroTiposEmpresa.integrador]]		:*[[IN_CadastroTiposEmpresa.integrador\|CadastroTiposEmpresa.integrador]]
	-->		-->
			:*[[IN_CadastroAcompanhamento.integrador\|CadastroAcompanhamento.integrador]]
	:*[[IN_CadastroCategoriasTg.integrador\|CadastroCategoriasTg.integrador]]		:*[[IN_CadastroCategoriasTg.integrador\|CadastroCategoriasTg.integrador]]
	:*[[IN_CadastroColaboradores.integrador\|CadastroColaboradores.integrador]]		:*[[IN_CadastroColaboradores.integrador\|CadastroColaboradores.integrador]]