Árvore de páginas

Versões comparadas

Chave

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

...

pi-validate-user-info-v1

Requisito

Nenhum.

Descrição

Realiza validações do usuário para acesso:

  • Se é aprovador;
  • Se possui algum documento configurado para aprovação;
  • Se o existe estabelecimento configurado para aprovação (MLA0000)

Parâmetros

Tipo

Input/Output

Descrição

oInput

JsonObject

INPUT

Parâmetros para a validação do aprovador:

pathParams:  Informar na seguinte ordem: validateUserInfo e código do aprovador.


Bloco de código
titleExemplo
{
    "pathParams": [
    "validateUserInfo",
    "super"
  ],
}
oOutputJsonObjectOUTPUT

Campo indicando se o usuário está válido:


Bloco de código
titleExemplo
{
  "status": 200,
  "payload": {
    "total": 1,
    "hasNext": false,
    "items": [
      {
        "passed": true       
      }
    ]
  }
}
RowErrorsTemp-tableOUTPUTInformações sobre os erros ocorridos durante o processo de validação.

Retorno

Indica se o usuário está válido e caso não esteja, os erros de validação.

...

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
titleExemplo
{
    "pathParams": [
       "detailPending",
       "90667"
    ],
}
oOutputJsonObjectOUTPUT

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


Bloco de código
titleExemplo
{
  "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


RowErrorsTemp-tableOUTPUTInformaçõ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-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
titleExemplo
{
    "pathParams": [
       "reapprove"
    ],
    "payload": {
       "transactions": [
          {
             "transactionNumber": 90390
          }
       ],
       "approveText": "Re-aprovada!"
    },
}
oOutputJsonObjectOUTPUT

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


Bloco de código
titleExemplo
{
  "status": 200,
  "payload": {
    "sucessProcess": true
  }
}
RowErrorsTemp-tableOUTPUTInformaçõ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

Requisito

Nenhum.

Descrição

Realiza a aprovação, reprovação ou re-aprovação de pendências.

Parâmetros

Tipo

Input/Output

Descrição

iActionINTEGERINPUT

Ação 

1 - Aprovação

2 - Reprovação

3 - Reaprovação

ttTransactionsTEMP-TABLEINPUTLista de transações a serem processadas
cTextCHARACTERINPUTComentário de aprovação/reprovação
iRejectionCodeINTEIROINPUTCódigo de rejeição
sucessProcessLOGICALOUTPUTIndica o processamento com sucesso (de pelo menos uma pendência)
RowErrorsTEMP-TABLEOUTPUTInformações sobre os erros ocorridos durante o processo de aprovação/reprovação.

Retorno

Informação de sucesso ou erros ocorridos no processamento das pendências.



Definição de temp-tables:

...

tt-config-visual

Entrada/Saída

Temp-table com dados de configurações visuais de aprovadores

Saída

Atributo

Nome no objeto

Tipo

Descrição

Obrigatório

Evolução

cod-usuar


CHARACTER 

Código do aprovador

Não

Não se aplica

idi-ordenacao

ordinationINTEGER

Ordenação padrão:

(1 - Mais recentes / 2 - Mais antigas / 3 - Maior valor / 4 - Menor valor / 5 - Tipo de documento / 6 - Empresa / 7 - Estabelecimento)

Não

Não se aplica

log-mostra-todas-empresasallCompaniesLOGICALIndica apresentação de pendências de todas as empresasNãoNão se aplica
log-aprova-sem-motivapproveWithoutReasonLOGICALIndica aprovação sem informar motivoNãoNão se aplica
cdn-tempo-desfundoTimeINTEGERTempo de desfazerNãoNão se aplica
idi-acao-swip-direrightSwipeActionINTEGER

Ação do swipe de deslizar (DireitoDireita)

(1 - Aprovar / 2 - Rejeitar / 3 - Nenhum)


Não se aplica
idi-acao-swip-esqleftSwipeActionINTEGER

Ação do swipe de deslizar (EsquerdoEsquerda)

(1 - Aprovar / 2 - Rejeitar / 3 - Nenhum)

NãoNão se aplica
idi-visualiz-inicialinitialViewINTEGER

Visualização inicial

(1 - Todas as pendências / 2 - Pendências principais / 3 - Pendências alternativas / 4 - Pendências como mestre)

NãoNão se aplica
num-registro-paginacpageRecordsNumberINTEGERNúmero de registros por páginaNãoNão se aplica

...

ttParamPendingApproval

Entrada/Saída

Temp-table com parâmetros para busca de pendências

Saída

Atributo

Tipo

Descrição

Obrigatório

Evolução

companyCHARACTER Empresa, se deixar em branco serão consideradas todas as empresasNãoNão se aplica
establishmentCHARACTER Estabelecimento, se deixar em branco serão considerados todos os estabelecimentosNãoNão se aplica
initialGenerationDateDATEData de geração inicialNãoNão se aplica
finalGenerationDateDATEData de geração finalNãoNão se aplica
mainPendenciesLOGICALIndica se devem ser apresentadas as pendências principaisSimNão se aplica
alternativePendenciesLOGICALIndica se devem ser apresentadas as pendências alternativasSimNão se aplica
masterPendenciesLOGICALIndica se devem ser apresentadas as pendências como mestreSimNão se aplica
documentsCHARACTER Documentos a serem considerados (separados por vírgula)SimNão se aplica
pendingPendenciesLOGICALIndica se devem ser apresentadas pendências "pendentes"SimNão se aplica
approvedPendenciesLOGICALIndica se devem ser apresentadas pendências "aprovadas"SimNão se aplica
rejectedPendenciesLOGICALIndica se devem ser apresentadas pendências "reprovadas"SimNão se aplica
reApprovedPendenciesLOGICALIndica se devem ser apresentadas pendências "reaprovadas"SimNão se aplica
sortTypeCHARACTER 

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: EstabelicementoEstabelecimento
  • documentType: Documento
NãoNão se aplica
pageSizeINTEGERTamanho da página (número de registros retornados). Se não informado será considerado: 20.NãoNão se aplica
nextPageRowidROWID

Rowid do registro da próxima página

NãoNã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çãoaprovação

Sim

Não se aplica

desc-nivelapproveTypeCHARACTER Descrição do nível de aprovaçãoSimNão se aplica
cod-aprovadorapproverCodeCHARACTER Código do aprovadorSimNão se aplica
nome-aprovadorapproverDescriptionCHARACTER Nome do aprovadorSimNão se aplica
data-aprovacaoapproveDateDATEData da aprovaçãoSimNão se aplica
hora-aprovacaoapproveHourCHARACTER Hora da aprovaçãoSimNão se aplica
narrativatextCHARACTER NarrativaSimNão se aplica
situacaostatusINTEGER

Situação

1 - Pendente 

2 - Aprovada

3 - Reprovada

4 - Reaprovada

SimNão se aplica



ttTransactions

Entrada/Saída

Temp-table com números de transações de pendências

Saída

Atributo

Nome no objeto

Tipo

Descrição

Obrigatório

Evolução

nr-trans

transactionNumber

INTEGER

Número da transação

Sim

Não se aplica