Histórico da Página

...

pi-query-pending-approval
Requisito	Nenhum.
Descrição	Realiza a busca de pendências a ser apresentada na listagem do APP.
	Parâmetros	Tipo	Input/Output	Descrição
	ttParamPendingApproval	TEMP-TABLE	INPUT	Parâmetros para busca dos registros de pendências
	tt-mla-doc-pend-aprov	TEMP-TABLE	OUTPUT	Listagem com informações das pendências
	lHasNext	LOGICAL	OUTPUT	Indica que existem mais registros a serem mostrados
	rNextRowid	ROWID	OUTPUT	Próximo rowid para busca de novos registros
	RowErrors	TEMP-TABLE	OUTPUT	Informações sobre os erros ocorridos durante o processo de busca das pendências.
Retorno	Informações de pendências a serem apresentadas ou erros ocorridos durante a busca.

pi-query-rejection-options-v1

Requisito

Nenhum.

Descrição

Realiza a busca de códigos de rejeição disponíveis

Parâmetros

Tipo

Input/Output

Descrição

oInput

JsonObject

INPUT

Parâmetros para busca dos códigos de rejeição:

pathParams: Informar: rejectionOptions.

Bloco de código

title	Exemplo

{
    "pathParams": [
    "rejectionOptions"
  ],
}

oOutput

JsonObject

OUTPUT

Lista de rejeições:

Bloco de código

title	Exemplo

{
  "status": 200,
  "payload": {
    "total": 3,
    "hasNext": false,
    "items": [
      {
        "code": 6,
        "description": "Rejeição comum",
        "reasonIsRequired": true
      },
      {
        "code": 7,
        "description": "Pedido suspenso",
        "reasonIsRequired": true
      },
      {
        "code": 8,
        "description": "Rejeição sem narrativa",
        "reasonIsRequired": false
      }
    ]
  }
}

Para verificar o que significa cada campo, conferir nas temp-tables no final desta documentação:

ttRejectionCode : contém as informações dos códigos de rejeição

RowErrors

Temp-table

OUTPUT

Informações sobre os erros ocorridos durante a busca dos códigos de rejeição.

Retorno

Informações dos códigos de rejeição ou erros ocorridos durante a busca.

pi-get-detail-pending-v1

Requisito

Nenhum.

Descrição

Realiza a busca dos detalhes de uma pendência de aprovação.

Obs.: Os campos são retornados conforme layout configurado para cada usuário e documento.

Parâmetros

Tipo

Input/Output

Descrição

oInput

JsonObject

INPUT

Parâmetros para detalhamento da pendência:

pathParams: Informar na ordem: detailPending e o número da transação.

Bloco de código

title	Exemplo

{
    "pathParams": [
       "detailPending",
       "90667"
    ],
}

oOutput

JsonObject

OUTPUT

Informações de layouts e dados da pendência solicitada:

Bloco de código

title	Exemplo

{
  "status": 200,
  "payload": {
    "total": 1,
    "hasNext": false,
    "items": [
      {
        "layout": [
          {
            "id": "doc-nr-requisicao",
            "componentType": 1,
            "label": "Requisição",
            "description": "Número da  Requisição de Estoque",
            "visible": true,
            "size": 50
          },
          {
            "id": "doc-dt-requisicao",
            "componentType": 1,
            "label": "Data Requisição",
            "description": "Data da  Requisição de Estoque",
            "visible": true,
            "size": 50
          },
          {
            "id": "pend-valor-doc",
            "componentType": 1,
            "label": "Valor do Documento",
            "description": "Valor da Pendência de Aprovação",
            "visible": true,
            "size": 100
          }
         ],
         "fieldValues": [
          {
            "id": "doc-nr-requisicao",
            "value": "123457111"
          },
          {
            "id": "doc-dt-requisicao",
            "value": "14\/04\/2021"
          },
          {
            "id": "pend-valor-doc",
            "value": "R$ 1,25"
          }
         ]
      }
    ]
  }
}

Para verificar o que significa cada campo, conferir nas temp-tables no final desta documentação:

tt-layout (layout): contém as informações dos campos do layout
tt-fields (fieldValues): contém as informações de campos e valores da pendência

RowErrors

Temp-table

OUTPUT

Informações sobre os erros ocorridos durante a busca de detalhes da pendência.

Retorno

Informações dos detalhes da pendência ou erros ocorridos durante a busca.

pi-get-detail-historic-pending-v1

Requisito

Nenhum.

Descrição

Realiza a busca do histórico de aprovação de uma pendência.

Parâmetros

Tipo

Input/Output

Descrição

oInput

JsonObject

INPUT

Parâmetros para busca do histórico de aprovação:

pathParams: Informar na ordem: detailHistoricPending e o número da transação.

Bloco de código

title	Exemplo

{
    "pathParams": [
       "detailHistoricPending",
       "89469"
    ],
}

oOutput

JsonObject

OUTPUT

Informações de histórico:

Bloco de código

title	Exemplo

{
  "status": 200,
  "payload": {
    "total": 1,
    "hasNext": false,
    "items": [
      {
        "approveType": "Faixa",
        "approverCode": "super",
        "approverDescription": "Super Usuario",
        "approveDate": "2021-03-29",
        "approveHour": "18:06:13",
        "text": "Pendência aprovada!",
        "status": 4
      }
    ]
  }
}

Para verificar o que significa cada campo, conferir nas temp-tables no final desta documentação:

ttHistoricPending: contém as informações dos históricos de aprovação

RowErrors

Temp-table

OUTPUT

Informações sobre os erros ocorridos durante a busca de histórico.

Retorno

Informações dos históricos ou erros ocorridos durante a busca.

pi-approve-v1

pi-reprove-v1

...

Requisito

Nenhum.

Descrição

Realiza a aprovação de pendência(s).

Parâmetros

Tipo

Input/Output

Descrição

oInput

JsonObject

INPUT

Parâmetros para aprovação de pendência(s):

pathParams: Informar: approve

payload:

transactions: Transações de pendências que devem ser aprovadas (pode ser uma ou várias):
- transactionNumber: Número da transação
- approveText: Comentário da aprovação

Bloco de código

title	Exemplo

{
    "pathParams": [
       "approve"
    ],
    "payload": {
       "transactions": [
          {
             "transactionNumber": 90390
          }
       ],
       "approveText": "Aprovada!"
    },
}

oOutput

JsonObject

OUTPUT

Informações da aprovação:

Bloco de código

title	Exemplo

{
  "status": 200,
  "payload": {
    "sucessProcess": true
  }
}

RowErrors

Temp-table

OUTPUT

Informações sobre os erros ocorridos durante a aprovação das pendências.

Retorno

Informação de sucesso ou erros ocorridos no processo de aprovação.

pi-reprove-v1

Requisito

Nenhum.

Descrição

Realiza a reprovação de pendência(s).

Parâmetros

Tipo

Input/Output

Descrição

oInput

JsonObject

INPUT

Parâmetros para reprovação de pendência(s):

pathParams: Informar: reprove

payload:

transactions: Transações de pendências que devem ser reprovadas (pode ser uma ou várias):
- transactionNumber: Número da transação
reproveText: Comentário da reprovação
rejectCode: Código de rejeição

Bloco de código

title	Exemplo

{
    "pathParams": [
       "reprove"
    ],
    "payload": {
       "transactions": [
          {
             "transactionNumber": 90390
          }
        ],
       "reproveText": "Reprovada por falta de orçamento",
       "rejectCode": 8
    },
}

oOutput

JsonObject

OUTPUT

Informações da reprovação:

Bloco de código

title	Exemplo

{
  "status": 500,
  "payload": {
    "sucessProcess": false,
    "errors": {
      "errorMessage": [
        {
          "code": 2609,
          "message": "Código de rejeição não cadastrado",
          "detailedMessage": ".\n",
          "type": "ERROR"
        }
      ]
    }
  }
}

RowErrors

Temp-table

OUTPUT

Informações sobre os erros ocorridos durante a reprovação das pendências.

Retorno

Informação de sucesso ou erros ocorridos no processo de reprovação.

pi-reapprove-v1

Requisito

Nenhum.

Descrição

Realiza a re-aprovação de pendência(s).

Parâmetros

Tipo

Input/Output

Descrição

oInput

JsonObject

INPUT

Parâmetros para re-aprovação de pendência(s):

pathParams: Informar: reapprove

payload:

transactions: Transações de pendências que devem ser aprovadas (pode ser uma ou várias):
- transactionNumber: Número da transação
- approveText: Comentário da aprovação

Bloco de código

title	Exemplo

{
    "pathParams": [
       "reapprove"
    ],
    "payload": {
       "transactions": [
          {
             "transactionNumber": 90390
          }
       ],
       "approveText": "Re-aprovada!"
    },
}

oOutput

JsonObject

OUTPUT

Informações da re-aprovação:

Bloco de código

title	Exemplo

{
  "status": 200,
  "payload": {
    "sucessProcess": true
  }
}

RowErrors

Temp-table

OUTPUT

Informações sobre os erros ocorridos durante a re-aprovação das pendências.

Retorno

Informação de sucesso ou erros ocorridos no processo de re-aprovação.

pi-process-pending-v1

Definição de temp-tables:

...

ttParamPendingApproval				Entrada/Saída
Temp-table com parâmetros para busca de pendências				Saída
Atributo	Tipo	Descrição	Obrigatório	Evolução
company	CHARACTER	Empresa, se deixar em branco serão consideradas todas as empresas	Não	Não se aplica
establishment	CHARACTER	Estabelecimento, se deixar em branco serão considerados todos os estabelecimentos	Não	Não se aplica
initialGenerationDate	DATE	Data de geração inicial	Não	Não se aplica
finalGenerationDate	DATE	Data de geração final	Não	Não se aplica
mainPendencies	LOGICAL	Indica se devem ser apresentadas as pendências principais	Sim	Não se aplica
alternativePendencies	LOGICAL	Indica se devem ser apresentadas as pendências alternativas	Sim	Não se aplica
masterPendencies	LOGICAL	Indica se devem ser apresentadas as pendências como mestre	Sim	Não se aplica
documents	CHARACTER	Documentos a serem considerados (separados por vírgula)	Sim	Não se aplica
pendingPendencies	LOGICAL	Indica se devem ser apresentadas pendências "pendentes"	Sim	Não se aplica
approvedPendencies	LOGICAL	Indica se devem ser apresentadas pendências "aprovadas"	Sim	Não se aplica
rejectedPendencies	LOGICAL	Indica se devem ser apresentadas pendências "reprovadas"	Sim	Não se aplica
reApprovedPendencies	LOGICAL	Indica se devem ser apresentadas pendências "reaprovadas"	Sim	Não se aplica
sortType	CHARACTER	Ordenação: Opções possíveis (se não informado será utilizado: -generationDate): -generationDate: Data de geração, decrescente generationDate: Data de geração, crescente -price: Valor, decrescente price: Valor, crescente company: Empresa establishment: Estabelicemento documentType: Documento	Não	Não se aplica
pageSize	INTEGER	Tamanho da página (número de registros retornados). Se não informado será considerado: 20.	Não	Não se aplica
nextPageRowid	ROWID	Rowid do registro da próxima página	Não	Não se aplica

ttRejectionCode					Entrada/Saída
Temp-table com informações de códigos de rejeição					Saída
Atributo	Nome no objeto	Tipo	Descrição	Obrigatório	Evolução
iCodRejeita	code	INTEGER	Código de rejeição	Sim	Não se aplica
cCodRejeita	description	CHARACTER	Descrição	Sim	Não se aplica
obriga-narrativa	reasonIsRequired	LOGICAL	Indica se o código de rejeição obriga narrativa	Sim	Não se aplica

ttHistoricPending					Entrada/Saída
Temp-table com informações dos históricos de aprovação					Saída
Atributo	Nome no objeto	Tipo	Descrição	Obrigatório	Evolução
nivel		INTEGER	Nível de parovação	Sim	Não se aplica
desc-nivel	approveType	CHARACTER	Descrição do nível de aprovação	Sim	Não se aplica
cod-aprovador	approverCode	CHARACTER	Código do aprovador	Sim	Não se aplica
nome-aprovador	approverDescription	CHARACTER	Nome do aprovador	Sim	Não se aplica
data-aprovacao	approveDate	DATE	Data da aprovação	Sim	Não se aplica
hora-aprovacao	approveHour	CHARACTER	Hora da aprovação	Sim	Não se aplica
narrativa	text	CHARACTER	Narrativa	Sim	Não se aplica
situacao	status	INTEGER	Situação 1 - Pendente 2 - Aprovada 3 - Reprovada 4 - Reaprovada	Sim	Não se aplica

Árvore de páginas

Versões comparadas

Versão antiga 7

Nova versão 8

Chave