Versões comparadas

Chave

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

...

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/pricetableappliedmatrixes/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
}

2 - Matriz Aplicada

...

      Serão apresentados 4 métodos, os quais foram implementados na API da Matriz Aplicada vinculada à Tabela de Preços, são eles:

  • GET
  • PUT
  • DELETE

2.1 - GET

...

2.1.1 - Get All (Recuperar todas as matrizes aplicadas)

Expandir
Informações
iconfalse
titleGetAll

Recupera todas as matrizes aplicadas sem retornar a listagem das disciplinas vinculadas por questão de performance. Essas informações serão retornadas com a utilização do GetOne para a matriz aplicada informada.

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

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Url Utilizada: http://localhost:8051/api/educational/financial/v1/pricetableappliedmatrixes

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

{
    "hasNext": false,
    "items": [
        {
            "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": [],
            "actionState": 0
        }
    ]
}

2.1.2 - Order (Retorna os dados ordenados)

Expandir
Informações
titleParâmetros

Order: parâmetro responsável pela ordenação do resultado, podendo ser ascendente ou descendente. O resultado com a ordem descendente deve ser precedida do caractere "-" (menos).

Exemplo 1: ?order=campo1 (Ascendente)

Exemplo 2: ?order=-campo1 (Descendente)

Múltiplos campos de ordenação: ?order=[-]campo1, [-]campo2, [-]campo3 ...

Informações
iconfalse
titleOrder (Asc)

Máscara de Url: http://{domínio}:{porta}/api/educational/financial/v1/pricetableappliedmatrixes?order={campo}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Campo: courseName

Tipo de Ordenação: Ascendente

Url Utilizada:  http://localhost:8051/api/educational/financial/v1/pricetableappliedmatrixes?order=courseName

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

{
    "hasNext": false,
    "items": [
        {
            "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": [],
            "actionState": 0
        },
        {
            "companyCode": 1,
            "branchCode": 1,
            "levelEducationCode": 1,
            "appliedMatrixCode": 132,
            "priceTableCode": 24,
            "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": [],
            "actionState": 0
        }
    ]
}

Informações
iconfalse
titleOrder (Desc)

Máscara de Url: http://{domínio}:{porta}/api/educational/financial/v1/pricetable?order=-{campo}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Campo: courseName

Tipo de Ordenação: Descendente

Url Utilizada: http://localhost:8051/api/educational/financial/v1/pricetableappliedmatrixes?order=-courseName

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
	"hasNext": false,
	"items": [
		{
			"companyCode": 1,
			"levelEducationCode": 1,
			"id": 3,
			"internalId": "1|1|3",
			"code": "00001",
			"name": "Tabela de Precos Um",
			"recCreatedOn": "2025-02-04T11:01:30.617-03:00",
			"active": false,
			"priceTableInUse": false,
			"appliedMatrixes": [],
			"terms": [],
			"termBranches": []
		},
		{
			"companyCode": 1,
			"levelEducationCode": 1,
			"id": 4,
			"internalId": "1|1|4",
			"code": "00002",
			"name": "Tabela de Precos Dois",
			"recCreatedOn": "2025-02-04T11:07:16.693-03:00",
			"active": false,
			"priceTableInUse": false,
			"appliedMatrixes": [],
			"terms": [],
			"termBranches": []
		}
	]
}

2.1.3 - Filter (Resultado filtrado)

Expandir
Informações
iconfalse
titleFilter

Máscara de Url: http://{domínio}:{porta}/api/educational/financial/v1/pricetableappliedmatrixes?{campo}={valor}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Campo: courseCode

Valor: 1-1

Url Utilizada:  http://localhost:8051/api/educational/financial/v1/pricetableappliedmatrixes?courseCode=1-1

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
	"hasNext": false,
	"items": [
		{
			"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": [],
			"actionState": 0
		}
	]
}
Informações
titleFiltros Complexos - OData

Para realizar filtros complexos na API da Tabela de Preços é possível adotar o padrão OData. Para entender melhor sobre a utilização desse padrão, acesse o link da documentação Utilizando filtros complexos - Exemplos do guia de API - ODATA.

2.1.4 - Paginação

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/pricetableappliedmatrixes?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/pricetableappliedmatrixes?page=1&pageSize=5

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

{
    "hasNext": true,
    "items": [
        {
            "companyCode": 1,
            "branchCode": 1,
            "levelEducationCode": 1,
            "appliedMatrixCode": 7,
            "priceTableCode": 3,
            "branchName": "Filial Belo Horizonte - Fantasia",
            "courseCode": "3-1",
            "courseName": "ADMINISTRAÇÃO",
            "curriculumGridCode": "4",
            "curriculumGridName": "2004/1",
            "majorCode": "1",
            "majorName": "COMÉRCIO EXTERIOR",
            "classShiftCode": 1,
            "classShiftName": "MANHÃ",
            "status": 0,
            "disciplines": [],
            "actionState": 0
        },
        {
            "companyCode": 1,
            "branchCode": 1,
            "levelEducationCode": 1,
            "appliedMatrixCode": 8,
            "priceTableCode": 3,
            "branchName": "Filial Belo Horizonte - Fantasia",
            "courseCode": "3-1",
            "courseName": "ADMINISTRAÇÃO",
            "curriculumGridCode": "4",
            "curriculumGridName": "2004/1",
            "majorCode": "1",
            "majorName": "COMÉRCIO EXTERIOR",
            "classShiftCode": 2,
            "classShiftName": "TARDE",
            "status": 0,
            "disciplines": [],
            "actionState": 0
        },
        {
            "companyCode": 1,
            "branchCode": 1,
            "levelEducationCode": 1,
            "appliedMatrixCode": 9,
            "priceTableCode": 3,
            "branchName": "Filial Belo Horizonte - Fantasia",
            "courseCode": "3-1",
            "courseName": "ADMINISTRAÇÃO",
            "curriculumGridCode": "4",
            "curriculumGridName": "2004/1",
            "majorCode": "1",
            "majorName": "COMÉRCIO EXTERIOR",
            "classShiftCode": 3,
            "classShiftName": "NOITE",
            "status": 0,
            "disciplines": [],
            "actionState": 0
        },
        {
            "companyCode": 1,
            "branchCode": 1,
            "levelEducationCode": 1,
            "appliedMatrixCode": 10,
            "priceTableCode": 3,
            "branchName": "Filial Belo Horizonte - Fantasia",
            "courseCode": "3-1",
            "courseName": "ADMINISTRAÇÃO",
            "curriculumGridCode": "4",
            "curriculumGridName": "2004/1",
            "majorCode": "4",
            "majorName": "RECURSOS HUMANOS",
            "classShiftCode": 1,
            "classShiftName": "MANHÃ",
            "status": 0,
            "disciplines": [],
            "actionState": 0
        },
        {
            "companyCode": 1,
            "branchCode": 1,
            "levelEducationCode": 1,
            "appliedMatrixCode": 11,
            "priceTableCode": 3,
            "branchName": "Filial Belo Horizonte - Fantasia",
            "courseCode": "3-1",
            "courseName": "ADMINISTRAÇÃO",
            "curriculumGridCode": "4",
            "curriculumGridName": "2004/1",
            "majorCode": "4",
            "majorName": "RECURSOS HUMANOS",
            "classShiftCode": 2,
            "classShiftName": "TARDE",
            "status": 0,
            "disciplines": [],
            "actionState": 0
        },
        {
            "companyCode": 1,
            "branchCode": 1,
            "levelEducationCode": 1,
            "appliedMatrixCode": 12,
            "priceTableCode": 3,
            "branchName": "Filial Belo Horizonte - Fantasia",
            "courseCode": "3-1",
            "courseName": "ADMINISTRAÇÃO",
            "curriculumGridCode": "4",
            "curriculumGridName": "2004/1",
            "majorCode": "4",
            "majorName": "RECURSOS HUMANOS",
            "classShiftCode": 3,
            "classShiftName": "NOITE",
            "status": 0,
            "disciplines": [],
            "actionState": 0
        }
    ]
}

2.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/pricetableappliedmatrixes?fields={campos}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Campo 1: code

Campo 2: name

Url Utilizada: http://localhost:8051/api/educational/financial/v1/pricetableappliedmatrixes?fields=courseName,courseCode

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
	"hasNext": false,
	"items": [
		{
			"code": "00001",
			"name": "Tabela de Precos Um"
		},
		{
			"code": "00002",
			"name": "Tabela de Precos Dois"
		}
	]
}

2.1.6 - GetOne (Recuperar matriz aplicada pelo identificador)

Expandir
Informações
iconfalse
titleGetOne

Nessa requisição será retornada a listagem das disciplinas vinculadas à matriz aplicada.

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/pricetableappliedmatrixes/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
}

2.2 - PUT

...

2.2.1 - Put (Atualização de uma matriz aplicada)

Expandir
Informações
iconfalse
titlePatch

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

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/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/pricetableappliedmatrixes/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
}

4 - Descrição dos campos JSON de entrada/retorno

...

Prospeção

  • prospectionCode: Código da prospecção
  • description: Descrição da prospecção


  • prospects: Lista de prospects da prospecção

...