Visão Geral dos processos WebServices de Bolsas
O objetivo deste DataServer é possibilitar a busca, inclusão, alteração e exclusão de bolsas através de WebService. Tudo o que for realizado, poderá ser visualizado no cadastro de bolsas no TOTVS Gestão Educacional.
Através do dataserver "EduBolsaData" e por meio dos métodos ReadRecord, SaveRecord e DeleteRecord, é possível realizar busca, inclusão, manutenção e exclusão das informações de bolsas no TOTVS Gestão Educacional.
Se necessário clique aqui para obter ajuda na configuração do Host.
Método ReadRecord
Este método realiza a consulta de uma bolsa. Algumas informações são obrigatórias e devem ser informadas: o código da coligada e o código da bolsa.
O sistema irá realizar a consulta de bolsa, caso as informações passadas estejam de acordo com alguma bolsa já existente no sistema.
Consulta de bolsa
Para realizar a consulta de uma bolsa, deve ser utilizado a operação de ReadRecord.
Deve ser passado um XML contendo todos os campos de chave primária.
Caso a chave informada não retorne registro, o resultado será o nome do DataSet. Caso contrário, a mesma terá suas informações exibidas através de um XML.
O XML deve conter os campos CODCOLIGADA e CODBOLSA como informações da chave para busca da bolsa.
<tot:ReadRecord>
<!--Optional:-->
<tot:DataServerName>EduBolsaData</tot:DataServerName>
<!--Optional:-->
<tot:PrimaryKey>1;69</tot:PrimaryKey>
<!--Optional:-->
<tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=1</tot:Contexto>
</tot:ReadRecord>
<ReadRecordResult><![CDATA[<EduBolsa>
<SBolsa>
<CODCOLIGADA>1</CODCOLIGADA>
<CODBOLSA>69</CODBOLSA>
<NOME>Teste Automatizado T</NOME>
<VALOR>15.0000</VALOR>
<CODTIPOCURSO>1</CODTIPOCURSO>
<VALIDADELIMITADA>1</VALIDADELIMITADA>
<BOLSAFUNC>0</BOLSAFUNC>
<TIPOSAC>N</TIPOSAC>
<ATIVA>S</ATIVA>
<TIPODESC>P</TIPODESC>
<PERMITEALTERARVALOR>S</PERMITEALTERARVALOR>
<VERIFICAINADIMPLENCIA>S</VERIFICAINADIMPLENCIA>
<CONTABCOMPETENCIA>S</CONTABCOMPETENCIA>
<ORDEMAPLICDESCANTECIPACAO>A</ORDEMAPLICDESCANTECIPACAO>
<AFETABASECALCULO>N</AFETABASECALCULO>
</SBolsa>
<SBOLSACOMPL>
<CODCOLIGADA>1</CODCOLIGADA>
<CODBOLSA>69</CODBOLSA>
<TESTE>Teste</TESTE>
</SBOLSACOMPL>
</EduBolsa>]]></ReadRecordResult>
<ReadRecordResult><EduBolsa /></ReadRecordResult>
Método SaveRecord
Este método realiza a inclusão ou alteração de uma bolsa. Algumas informações são obrigatórias e devem ser informadas: o código da coligada e o código da bolsa, além dos outros campos que estão configurados como obrigatórios no sistema.
O sistema irá realizar a inclusão de uma bolsa, caso o código da bolsa informado no XML não exista no sistema. O valor do código da bolsa presente no XML serve apenas para identificar a bolsa dentro do próprio XML. O sistema irá criar um código para a bolsa inserida.
Se o código da bolsa existir na coligada informada, essa terá as informações alteradas de acordo com o que será passado no arquivo XML.
Observação: Caso sejam passadas para o dataserver informações para campos complementares, devem ser utilizados os mesmos códigos obrigatórios para que o sistema consiga entender que se referem à bolsa que se deseja alterar.
Inclusão de bolsa
Para realizar inclusão de uma bolsa, deve ser utilizado a operação de SaveRecord.
Deve ser passado um XML contendo todos os campos que serão cadastrados, como informação, para a bolsa.
Caso o Código da Bolsa informado exista as informações serão atualizadas.
O XML deve conter a tabela SBOLSA com os campos CODCOLIGADA e CODBOLSA como informações da chave para o cadastro de bolsa e, também, os campos obrigatórios para seu cadastro.
<tot:SaveRecord>
<!--Optional:-->
<tot:DataServerName>EduBolsaData</tot:DataServerName>
<!--Optional:-->
<tot:XML><![CDATA[
<EduBolsa>
<SBOLSA>
<CODCOLIGADA>1</CODCOLIGADA>
<CODBOLSA>68</CODBOLSA>
<CODCFO></CODCFO>
<NOME>Teste Automatizado T</NOME>
<VALOR>15</VALOR>
<CODTIPOCURSO>1</CODTIPOCURSO>
<CODCOLCFO></CODCOLCFO>
<ORDEMPERDA></ORDEMPERDA>
<RENOVACAOAUTOMATICA></RENOVACAOAUTOMATICA>
<VALIDADELIMITADA>1</VALIDADELIMITADA>
<FIES></FIES>
<BOLSAFUNC>0</BOLSAFUNC>
<TIPOSAC>N</TIPOSAC>
<ATIVA>S</ATIVA>
<TIPODESC>P</TIPODESC>
<PERMITEALTERARVALOR>S</PERMITEALTERARVALOR>
<NOMERESPONSAVELBOLSACRED></NOMERESPONSAVELBOLSACRED>
<CODCLASSIFICACAO></CODCLASSIFICACAO>
<VERIFICAINADIMPLENCIA>S</VERIFICAINADIMPLENCIA>
<CONTABCOMPETENCIA>S</CONTABCOMPETENCIA>
<APLICFORMULA></APLICFORMULA>
<CODFORMULAPERCENTUAL></CODFORMULAPERCENTUAL>
<CODFORMULAVALOR></CODFORMULAVALOR>
<ORDEMAPLICDESCANTECIPACAO>A</ORDEMAPLICDESCANTECIPACAO>
<AFETABASECALCULO>N</AFETABASECALCULO>
</SBOLSA>
<SBOLSACOMPL>
<CODCOLIGADA>1</CODCOLIGADA>
<CODBOLSA>68</CODBOLSA>
<TESTE>Teste</TESTE>
</SBOLSACOMPL>
</EduBolsa>
]]></tot:XML>
<!--Optional:-->
<tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=1</tot:Contexto>
</tot:SaveRecord>
<SaveRecordResult>1;78</SaveRecordResult>
Alteração de bolsa
Para realizar alteração de uma bolsa, deve ser utilizado a operação de SaveRecord.
Deve ser passado um XML contendo todos os campos que serão atualizados no cadastro de bolsa.
O XML deve conter a tabela SBOLSA com os campos CODCOLIGADA e CODBOLSA como informações da chave para a atualização do cadastro de bolsa.
<tot:SaveRecord>
<!--Optional:-->
<tot:DataServerName>EduBolsaData</tot:DataServerName>
<!--Optional:-->
<tot:XML><![CDATA[
<EduBolsa>
<SBOLSA>
<CODCOLIGADA>1</CODCOLIGADA>
<CODBOLSA>78</CODBOLSA>
<CODCFO></CODCFO>
<NOME>Teste Automatizado</NOME>
<VALOR>20</VALOR>
<CODTIPOCURSO>1</CODTIPOCURSO>
<CODCOLCFO></CODCOLCFO>
<ORDEMPERDA></ORDEMPERDA>
<RENOVACAOAUTOMATICA></RENOVACAOAUTOMATICA>
<VALIDADELIMITADA>1</VALIDADELIMITADA>
<FIES></FIES>
<BOLSAFUNC>0</BOLSAFUNC>
<TIPOSAC>N</TIPOSAC>
<ATIVA>S</ATIVA>
<TIPODESC>P</TIPODESC>
<PERMITEALTERARVALOR>S</PERMITEALTERARVALOR>
<NOMERESPONSAVELBOLSACRED></NOMERESPONSAVELBOLSACRED>
<CODCLASSIFICACAO></CODCLASSIFICACAO>
<VERIFICAINADIMPLENCIA>S</VERIFICAINADIMPLENCIA>
<CONTABCOMPETENCIA>S</CONTABCOMPETENCIA>
<APLICFORMULA></APLICFORMULA>
<CODFORMULAPERCENTUAL></CODFORMULAPERCENTUAL>
<CODFORMULAVALOR></CODFORMULAVALOR>
<ORDEMAPLICDESCANTECIPACAO>A</ORDEMAPLICDESCANTECIPACAO>
<AFETABASECALCULO>N</AFETABASECALCULO>
</SBOLSA>
<SBOLSACOMPL>
<CODCOLIGADA>1</CODCOLIGADA>
<CODBOLSA>78</CODBOLSA>
<TESTE>Teste</TESTE>
</SBOLSACOMPL>
</EduBolsa>
]]></tot:XML>
<!--Optional:-->
<tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=1</tot:Contexto>
</tot:SaveRecord>
<SaveRecordResult>1;78</SaveRecordResult>
Método DeleteRecord
Este método realiza a exclusão de uma bolsa. Algumas informações são obrigatórias e devem ser informadas: o código da coligada e o código da bolsa, além dos outros campos que estão configurados como obrigatórios no sistema.
O sistema irá realizar a exclusão de uma bolsa caso encontre o registro.
Exclusão de bolsa
Para realizar exclusão de uma bolsa, deve ser utilizado a operação de DeleteRecord.
Deve ser passado um XML contendo todos os campos que fazem parte do registro de bolsa.
O XML deve conter a tabela SBOLSA com os campos CODCOLIGADA e CODBOLSA como informações da chave para o cadastro de bolsa e, também, os campos obrigatórios para seu cadastro.
<tot:DeleteRecord>
<!--Optional:-->
<tot:DataServerName>EduBolsaData</tot:DataServerName>
<!--Optional:-->
<tot:XML>
<![CDATA[<EduBolsa>
<SBOLSA>
<CODCOLIGADA>1</CODCOLIGADA>
<CODBOLSA>78</CODBOLSA>
<CODCFO></CODCFO>
<NOME>Teste Automatizado T</NOME>
<VALOR>15</VALOR>
<CODTIPOCURSO>1</CODTIPOCURSO>
<CODCOLCFO></CODCOLCFO>
<ORDEMPERDA></ORDEMPERDA>
<RENOVACAOAUTOMATICA></RENOVACAOAUTOMATICA>
<VALIDADELIMITADA>1</VALIDADELIMITADA>
<FIES></FIES>
<BOLSAFUNC>0</BOLSAFUNC>
<TIPOSAC>N</TIPOSAC>
<ATIVA>S</ATIVA>
<TIPODESC>P</TIPODESC>
<PERMITEALTERARVALOR>S</PERMITEALTERARVALOR>
<NOMERESPONSAVELBOLSACRED></NOMERESPONSAVELBOLSACRED>
<CODCLASSIFICACAO></CODCLASSIFICACAO>
<VERIFICAINADIMPLENCIA>S</VERIFICAINADIMPLENCIA>
<CONTABCOMPETENCIA>S</CONTABCOMPETENCIA>
<APLICFORMULA></APLICFORMULA>
<CODFORMULAPERCENTUAL></CODFORMULAPERCENTUAL>
<CODFORMULAVALOR></CODFORMULAVALOR>
<ORDEMAPLICDESCANTECIPACAO>A</ORDEMAPLICDESCANTECIPACAO>
<AFETABASECALCULO>N</AFETABASECALCULO>
</SBOLSA>
</EduBolsa>]]>
</tot:XML>
<!--Optional:-->
<tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=1</tot:Contexto>
</tot:DeleteRecord>
<DeleteRecordResult>Exclusão de registro(s) realizado com sucesso</DeleteRecordResult>