Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

3 - Período Letivo de Ingresso

...

      Serão apresentados 3 2 métodos, os quais foram implementados na API do Período de Letivo de Ingresso vinculada à Tabela de Preços, são eles:

  • GETPUT
  • DELETE

3.1 - GET

...

3.1.1 - Get All (Recuperar todos períodos de letivo de ingresso)

...

Expandir
Informações
titleParâmetros

Page: Página que será apresentada.

PageSize: Quantidade máxima de registros por página que serão apresentados.

Exemplo: ?page=1&pageSize=1

Valores padrão: Caso não sejam preenchidos os parâmetros evidenciados acima serão preenchidos com valores padrão.

Page: 1

PageSize: 20

Informações
iconfalse
titlePaginação

Máscara de Url: http://{domínio}:{porta}/api/educational/financial/v1/pricetableterms?page={valor1}&pageSize={valor2}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Valor1: 1

Valor2: 5

Url Utilizada: http://localhost:8051/api/educational/financial/v1/pricetableterms?page=1&pageSize=5

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...

{
    "hasNext": false,
    "items": [
        {
            "internalId": "1|3|73|1",
            "companyCode": 1,
            "priceTableCode": 3,
            "termId": 73,
            "levelEducationCode": 1,
            "termCode": "2024/1",
            "branchCode": 1,
            "branchName": "Filial Belo Horizonte - Fantasia"
        },
        {
            "internalId": "1|3|74|1",
            "companyCode": 1,
            "priceTableCode": 3,
            "termId": 74,
            "levelEducationCode": 1,
            "termCode": "2024/2",
            "branchCode": 1,
            "branchName": "Filial Belo Horizonte - Fantasia"
        },
        {
            "internalId": "1|3|75|1",
            "companyCode": 1,
            "priceTableCode": 3,
            "termId": 75,
            "levelEducationCode": 1,
            "termCode": "2025/1",
            "branchCode": 1,
            "branchName": "Filial Belo Horizonte - Fantasia"
        }
    ]
}

...

3.1.5 - Fields (Retorno de campos específicos no resultado)

Expandir
Informações
titleParâmetros

Fields: parâmetro responsável pela especialização de campos em um resultado, ou seja, o usuário define quais campos serão apresentados no resultado.

Exemplo: ?fields=campo1

Múltiplos campos de ordenação: ?fields=campo1, campo2, campo3 ...

Informações
iconfalse
titleFields

Máscara de Url: http://{domínio}:{porta}/api/educational/financial/v1/pricetableterms?fields={campos}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Campo 1: termCode

Campo 2: branchName

Url Utilizada: http://localhost:8051/api/educational/financial/v1/pricetableterms?fields=termCode,branchName

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...

{
    "hasNext": false,
    "items": [
        {
            "termCode": "2024/1",
            "branchName": "Filial Belo Horizonte - Fantasia"
        },
        {
            "termCode": "2024/2",
            "branchName": "Filial Belo Horizonte - Fantasia"
        },
        {
            "termCode": "2025/1",
            "branchName": "Filial Belo Horizonte - Fantasia"
        }
    ]
}

...

3.1.6 - GetOne (Recuperar período letivo de ingresso pelo identificador)

Expandir
Informações
iconfalse
titleGetOne

Máscara de Url: http://{domínio}:{porta}/api/educational/financial/v1/pricetableterms/{internalId}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

internalId: 1|1|3|132

Url Utilizada: http://localhost:8051/api/educational/financial/v1/pricetableterms/1|1|3|132

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "companyCode": 1,
    "branchCode": 1,
    "levelEducationCode": 1,
    "appliedMatrixCode": 132,
    "priceTableCode": 3,
    "branchName": "Filial Belo Horizonte - Fantasia",
    "courseCode": "1-1",
    "courseName": "Curso Tabela de Preços",
    "curriculumGridCode": "1",
    "curriculumGridName": "Matriz Tabela de Preços",
    "majorCode": "1",
    "majorName": "Habilitação  Tabela de Preços",
    "classShiftCode": 11,
    "classShiftName": "INTEGRAL",
    "status": 0,
    "disciplines": [
        {
            "internalId": "1|3|132|1|0001_ES",
            "companyCode": 1,
            "priceTableCode": 3,
            "appliedMatrixCode": 132,
            "levelEducationCode": 1,
            "disciplineCode": "0001_ES",
            "periodCode": 0,
            "periodDescription": "Período fixo",
            "disciplineName": "Estágio Supervisionado",
            "workload": 8.0000,
            "actionState": 1
        },
        {
            "internalId": "1|3|132|1|001Wal",
            "companyCode": 1,
            "priceTableCode": 3,
            "appliedMatrixCode": 132,
            "levelEducationCode": 1,
            "disciplineCode": "001Wal",
            "periodCode": 0,
            "periodDescription": "Período fixo",
            "disciplineName": "6.Wal ",
            "workload": 5.0000,
            "actionState": 1
        },
        {
            "internalId": "1|3|132|1|146-1",
            "companyCode": 1,
            "priceTableCode": 3,
            "appliedMatrixCode": 132,
            "levelEducationCode": 1,
            "disciplineCode": "146-1",
            "periodCode": 1,
            "periodDescription": "Período 1",
            "disciplineName": "7.DIREITO COMERCIAL I",
            "workload": 50.0000,
            "actionState": 1
        },
        {
            "internalId": "1|3|132|1|147-1",
            "companyCode": 1,
            "priceTableCode": 3,
            "appliedMatrixCode": 132,
            "levelEducationCode": 1,
            "disciplineCode": "147-1",
            "periodCode": 1,
            "periodDescription": "Período 1",
            "disciplineName": "DIREITO COMERIAL II",
            "workload": 50.0000,
            "actionState": 1
        },
        {
            "internalId": "1|3|132|1|148-1",
            "companyCode": 1,
            "priceTableCode": 3,
            "appliedMatrixCode": 132,
            "levelEducationCode": 1,
            "disciplineCode": "148-1",
            "periodCode": 1,
            "periodDescription": "Período 1",
            "disciplineName": "DIREITO PENAL II",
            "actionState": 1
        }
    ],
    "actionState": 0
}

...

3.2 -

...

DELETE

...

3.2.1 -

...

Delete (Excluir um período letivo de ingresso)

Expandir

A atualização da matriz aplicada é realizada somente para atualizar as disciplinas vinculadas à matriz aplicada. E importante no corpo da requisição informar a propriedade "actionState" na tag "disciplines" . Os valores possíveis para a propriedade "actionState" na tag "disciplines" pode ser:

  • 0: Sem modificação na disciplina
  • 1: Adicionando uma disciplina
  • 2: Removendo uma disciplina
  • 3: Modificando uma disciplina
    Informações
    iconfalse
    titlePatch
    Delete

    Máscara de Url: http://{domínio}:{porta}/api/educational/financial/v1/pricetableappliedmatrixespricetableterms/{internalId}

    Informações
    iconfalse
    titleExemplo de Configuração

    Domínio: localhost

    Porta: 8051

    internalId: 1|1|3|132

    Url Utilizada: http://localhost:8051/api/educational/financial/v1/pricetableappliedmatrixes/1|1|3|132

    Informações
    iconfalse
    titleExemplo de Entrada
    Expandir
    titleVer resultado JSON...
    Bloco de código
    languagejs
    firstline1
    titleResultado (JSON)
    linenumberstrue
    {
    	"companyCode": 1,
    	"branchCode": 1,
    	"levelEducationCode": 1,
    	"appliedMatrixCode": 132,
    	"priceTableCode": 3,
    	"branchName": "Filial Belo Horizonte - Fantasia",
    	"courseCode": "1-1",
    	"courseName": "Curso Tabela de Preços",
    	"curriculumGridCode": "1",
    	"curriculumGridName": "Matriz Tabela de Preços",
    	"majorCode": "1",
    	"majorName": "Habilitação  Tabela de Preços",
    	"classShiftCode": 11,
    	"classShiftName": "INTEGRAL",
    	"status": 0,
    	"disciplines": [
    		{
    			"internalId": "1|3|132|1|0001_ES",
    			"companyCode": 1,
    			"priceTableCode": 3,
    			"appliedMatrixCode": 132,
    			"levelEducationCode": 1,
    			"disciplineCode": "0001_ES",
    			"periodCode": 0,
    			"periodDescription": "Período fixo",
    			"disciplineName": "Estágio Supervisionado",
    			"workload": 8.0,
    			"actionState": 1,
    			"creditsvalue": 10
    		}
    	]
    }
    Informações
    iconfalse
    titleExemplo de Resultado Positivo
    Expandir
    titleVer resultado JSON...
    Bloco de código
    languagejs
    firstline1
    titleResultado (JSON)
    linenumberstrue
    {
    	"companyCode": 1,
    	"branchCode": 1,
    	"levelEducationCode": 1,
    	"appliedMatrixCode": 132,
    	"priceTableCode": 3,
    	"branchName": "Filial Belo Horizonte - Fantasia",
    	"courseCode": "1-1",
    	"courseName": "Curso Tabela de Preços",
    	"curriculumGridCode": "1",
    	"curriculumGridName": "Matriz Tabela de Preços",
    	"majorCode": "1",
    	"majorName": "Habilitação  Tabela de Preços",
    	"classShiftCode": 11,
    	"classShiftName": "INTEGRAL",
    	"status": 0,
    	"disciplines": [
    		{
    			"internalId": "1|3|132|1|0001_ES",
    			"companyCode": 1,
    			"priceTableCode": 3,
    			"appliedMatrixCode": 132,
    			"levelEducationCode": 1,
    			"disciplineCode": "0001_ES",
    			"creditsValue": 10.0,
    			"periodCode": 0,
    			"periodDescription": "Período fixo",
    			"disciplineName": "Estágio Supervisionado",
    			"workload": 8.0,
    			"actionState": 1
    		}
    	],
    	"actionState": 0
    }
    Informações
    iconfalse
    titleExemplo de Resultado Negativo
    Expandir
    titleVer resultado JSON...

    {
        "code": null,
        "message": "Não foi possível incluir/editar a tabela de preços. Existe(m) matriz(es) aplicada(s) com id da matriz aplicada inválido.",
        "detailedMessage": null,
        "helpUrl": null,
        "details": null
    }

    2.3 - DELETE

    2.3.1 - Delete (Excluir uma matriz aplicada)

    Expandir
    Informações
    iconfalse
    titleDelete

    Máscara de Url: http://{domínio}:{porta}/api/educational/financial/v1/pricetableappliedmatrixes/{internalId}

    Informações
    iconfalse
    titleExemplo de Configuração

    Domínio: localhost

    Porta: 8051

    internalId: 1|1|3|132

    Url Utilizada: http://localhost:8051/api/educational/financial/v1/pricetableappliedmatrixespricetableterms/1|1|3|132

    Informações
    iconfalse
    titleExemplo de Resultado Positivo Postman

    Obs.: Em caso de sucesso, será retornado o respondeCode = 204 e a resposta em branco.

    Informações
    iconfalse
    titleExemplo de Resultado Negativo
    Expandir
    titleVer resultado JSON...
    Bloco de código
    languagejs
    firstline1
    titleResultado (JSON)
    linenumberstrue
    {
    	"code": null,
    	"message": "Não existe um cadastro de Matriz Aplicada vinculado a Tabela de Preços com o ID informado para exclusão",
    	"detailedMessage": null,
    	"helpUrl": null,
    	"details": null
    }

    ...