Histórico da Página

<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/IntegracaoSALESFORCE/GravarAluno</div>

Realiza a gravação do aluno no SGE, conforme dados enviados pela API.

Authorization - Basic Auth

Username <username>

Password <password>

Body

{
  "Nome": "Teste Api 2 ",
  "EstadoNatal": "MG",
  "Naturalidade": "Belo Horizonte",
  "DataNascimento": "05/07/1978",
  "Cpf": "85763425022",
  "Cep": "38700412",
  "Rua": "Pascoal Soares",
  "Numero": 10,
  "Complemento": "102",
  "Bairro": "Savassi",
  "Estado": "SP",
  "Cidade": "São Paulo",
  "Pais": "Brasil",
  "Tel_Residencial": "3333333333333",
  "Tel_Celular": "2312321312",
  "Tel_3": "13123132313",
  "Fax": "312321313131",
  "SitOcupacional": 1,
  "TipoEscola": 3,
  "CodColigada": 3,
  "IdMatrizAplicada": 4
}

Content

• Nome: Nome do Aluno no SGE (Campo Obrigatório);

• EstadoNatal: Estado Natal do Aluno no SGE (Campo Obrigatório);

• Naturalidade: Naturalidade do Aluno no SGE (Campo Obrigatório);
• DataNascimento: Data de Nascimento do Aluno no SGE (Campo Obrigatório);
• Cpf: CPF do Aluno no SGE (Campo Obrigatório);
• Cep: CEP do Aluno no SGE;
• Rua: Rua do Aluno no SGE;
• Numero: Número do Aluno no SGE;
• Complemento: Complemento do Aluno no SGE;
• Bairro: Nome do bairro do Aluno;
• Estado: Sigla do Estado do Aluno;
• Cidade: Nome da Cidade do Aluno;
• Pais: Nome do País do Aluno;
• Tel_Residencial: Telefone Residencial do Aluno no SGE;
• Tel_Celular: Telefone Celular do Aluno no SGE;
• Tel_3: Telefone 3 do Aluno no SGE;
• Fax: Fax do Aluno no SGE;
• SitOcupacional: Situação ocupacional do Aluno no SGE;

       Valores possíveis:
               1 = Empregado
               2 = Desempregado
               3 = Empregador
               4 = Autônomo/Conta Própria
               5 = Profissional Liberal
               6 = 1º Emprego
               7 = Aposentado

               8 = Microempreendedor Individual - MEI
               9 = Aprendiz com contrato

• TipoEscola: Tipo de escola de Origem do Aluno no SGE;

             Valores possíveis:
               1 = Particular
               2 = Pública - Municipal
               3 = Pública - Estadual
               4 = Pública - Federal
               9 = Não Declarado

• IdMatrizAplicada: Identificador da Matriz Aplicada (Curso/Habilitação e Período Letivo) (Campo Obrigatório);
• CodColigada: Código da Coligada no SGE (Campo Obrigatório);
• NomeMae:  Nome da mãe do aluno, que será gravado em campo complementar do cadastro do aluno (não obrigatório na API).

Retorno

{
   "Message": "Aluno: 205, existente em base, atualizado com Sucesso!\r\n",
   "Status": "Sucesso",
   "StatusCode": 200
}

Content

• Message: Mensagem de retorno do consumo da requisição;
• Status: Situação do processamento da requisição;
• StatusCode: Código de status do processamento da requisição;

<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/IntegracaoSALESFORCE/RealizarMatricula</div>

Realiza a matrícula do aluno no SGE, conforme dados enviados pela API.

Authorization - Basic Auth

Username <username>

Password <password>

Body

{
    "IdMatrizAplicada": 5,
    "RA": "00000018",
    "Turma": "123|TEC.001.006",
    "DataMatricula": "20/12/2021",
    "DataPrevSaida": "01/01/2022",
    "CondicaoAluno": 0,
    "CodFinSCAE": 1,
    "Articulacao": 2,
    "CodColigada": 3,        
    "Contrato": {
        "NomeRespFin": "Responsavel Rafaela",
        "CodColCfo": 2,
        "CodCFO": "9989098600001",
        "ValorTotal": 600.0,
        "QuantidadeParc": 5,
        "DataVencimento": "12/02/2022",
        "DiaVencimento": 12,
        "DescontoInstitucional": 8.0,
        "DescontoAdicional": 1.0,
        "MotivoDesconto": "Desconto funcionário da indústria",
        "DataVenda": "30/12/2021",
        "IdOportunidade": 1,
        "FormaPagtoPrimeiraParc": "CACCAR",
        "FormaPagtoDemaisParc": "BOL",
        "ReceberBoletoEmail": "Sim",
        "PedidoFiscal": null,
        "Ecommerce": "SIM",
        "DadosCartao": {
            "Cod_Loja": 0,
            "Agencia": "TESTE",
            "Cod_Banco": "158",
            "Conta": "000001",
            "AdquirenteCartao": null,
            "MeioPagamento": "Crédito",
            "BandeiraCartao": "Elo",
            "NSU": "123",
            "ValorTotalCartao": 120.0,
            "ParcelasCartao": 1
        }
    },
    "Disciplinas": [],
    "CodColigada": 2,
    "CamposValoresChaveGrupo": null
}

Content

• IdMatrizAplicada: Identificador da Matriz Aplicada (Curso/Habilitação e Período Letivo) (Campo Obrigatório);
• RA: Registro acadêmico do aluno no SGE (Campo Obrigatório);
• Turma: Código da Turma do SGE onde o aluno será matriculado (Campo Obrigatório). O código da turma enviado contém o identificador do período letivo seguido do código da turma do SGE, concatenados por '|'. 
• DataMatricula: Data da Matrícula do aluno (Campo Obrigatório);
• DataPrevSaida: Data final do Curso;
• CondicaoAluno: Condição do Aluno (SENAI);

    Valores possíveis:
      0 = Não Gratuita.
      1 = Gratuidade regimental
      2 = Bolsa de estudos
      3 = Convênio

• CodFinSCAE: Código Financiamento SCAE;
  • Valorespossíveis:

        0 = Não Gratuita
        2 = Gratuidade Regulamentar
        3 = Gratuidade Não Regulamentar

• Articulacao: Código de Articulação.
  • Valores possíveis:
         1 = Há Articulação Sesi/Senai
         2 = Não há Articulação Sesi/Senai
         3 = Há Articulação entre outras instituições

• CodColigada: Código da Coligada no SGE (Campo Obrigatório);
• Contrato:  
  • CodCFO: Código identificador do cliente no RM/Salesforce/Protheus (Campo Obrigatório);
  • CodColCfo: Código da Coligada do cliente Fornecedor. Se for global, enviar 0 - zero (Campo obrigatório);
  • NomeRespFin: Nome do responsável financeiro no SGE (Campo Obrigatório);
  • ValorTotal: Valor total da venda (sem descontos de bolsas);
  • QuantidadeParc: Quantidade de parcelas do contrato de venda;
  • DataVencimento: Data do vencimento da primeira parcela do contrato;
  • DiaVencimento: Dia fixo do vencimento que será utilizado na geração da segunda parcela em diante. A data será gerada com o dia fixo informado do mês subsequente do início da turma, até atingir a quantidade de parcelas;
  • DescontoInstitucional: Valor do desconto institucional, com base no valor total do contrato. Quando informado, será criada uma bolsa Institucional ao contrato (conforme código de bolsa informado nos parâmetros da customização).
  • DescontoAdicional: Valor do desconto adicional, com base no valor total do contrato. Quando informado, será criada uma bolsa Adicional ao contrato (conforme código de bolsa informado nos parâmetros da customização).
  • MotivoDesconto: Descrição do Motivo do desconto adicional ou institucional (obrigatório no caso de desconto concedido);
  • DataVenda: Data corrente do recebimento da matrícula;
  • IdOportunidade: Identificador da oportunidade fechada no SALESFORCE ;
  • FormaPagtoPrimeiraParc: Forma De pagamento - Primeira parcela (Campo Obrigatório);

                                  Valores possíveis:;

                                    BOLETO: BOL (Mensalidade Boleto)
                                    Cartão crédito: CAC (Mensalidade Cartão de crédito)
                                    Cartão débito: CAR (Mensalidade Cartão de débito)
                                    Dinheiro: ESP (Mensalidade dinheiro)

• • FormaPagtoDemaisParc: Forma De pagamento - Demais parcelas (Campo Obrigatório);
  •              Valores possíveis:
                   BOLETO: BOL (Mensalidade Boleto)
                   Cartão crédito: CAC (Mensalidade Cartão de crédito)
                   Cartão débito: CAR (Mensalidade Cartão de débito)
                   Dinheiro: ESP (Mensalidade dinheiro)
  • ReceberBoletoEmail: Recebe Boleto por E-mail (Campo Obrigatório);
  •             Valores possíveis: Sim ou Não - se o boleto foi enviado por e-mail
  • ECommerce: Identificação de E-Commerce

                                 Valores possíveis: Sim ou Não

• • Dados Cartão:  
    • Esse bloco só deve ser enviado para pagamento com cartão através do E-commerce. Só é permitido enviar dados de um cartão de crédito. Essas informações são enviadas no complemento do pedido de venda do Protheus.  
    • ParcelasCartao: Quantidade de Parcelas junto a operadora do cartão. Informação enviada para Protheus para geração de títulos a receber para operadora do cartão. 
• Disciplinas: Lista de códigos da Disciplinas onde o aluno deverá ser matriculado no SGE. Caso este campo não seja informado, o aluno será matriculado em todas as disciplinas da turma/matriz aplicada.

Retorno

{
   "Message": "Matrícula realizada com sucesso!\r\n",
   "Status": "Sucesso",
   "StatusCode": 200
}

Content

• Message: Mensagem de retorno do consumo da requisição;
• Status: Situação do processamento da requisição;
• StatusCode: Código de status do processamento da requisição;