Árvore de páginas

APIMYPENDINGAPPROVAL - Informações para Aplicativo MLA

Produto:

Datasul

Ocorrência:

Documentação de API

Nome físico:

lap/apiMyPendingApproval.p


Objetivo

Esta API tem como objetivo de fornecedor informações para apresentações de dados para o aplicativo do MLA, assim como realização das aprovações.


Funcionamento

A API fornece uma série de métodos que podem ser executados individualmente para apresentação de dados no aplicativo MLA, assim como realização de aprovações de pendências.

A sintaxe para a chamada da API, que deve ser de forma persistente:


run lap/apiMyPendingApproval.p persistent set h-handle.


A variável denominada h-handle irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da API.

Método Negócio


Quando a API estiver executada em modo persistente, os seguintes métodos estarão disponíveis para execução:


pi-get-defaults-v1

Requisito

Nenhum.

Descrição

Retorna dados principais para carregamento inicial do APP: empresas, estabelecimentos e documentos do aprovador com seus layouts.

Parâmetros

Tipo

Input/Output

Descrição

oInput

JsonObject

INPUT

Parâmetros para a busca dos dados iniciais:

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


queryParams →  expand: Utilizando este parâmetro com as opções abaixo permite retornar também as informações de:
  • visualConfigurations: Configurações Visuais
  • groupCompanies: Grupo de empresas
  • documents: Documentos 
  • documents.fields: Componentes de cada docmento
  • establishments: Estabelecimentos


Exemplo
{
    "queryParams": {
    "expand": [     "visualConfigurations,groupsCompanies,documents,documents.fields,establishments"
    ]
  },
    "pathParams": [
       "getDefaults",
       "super"
    ],
}
oOutputJsonObjectOUTPUT

Informações iniciais para o APP:


Exemplo
{
  "status": 200,
  "payload": {
    "total": 1,
    "hasNext": false,
    "items": [
      {
        "userCode": "super",
        "userName": "Super Usuário",
        "eMail": "",
        "sendEmail": true,
        "receiveEmail": true,
        "masterUser": false,
        "currency": 0,
        "currencyAbbrev": "R$",
        "automaticApproval": true,
        "automaticApprovalApprover": true,
        "siteCode": "1",
        "allocationCode": "10702",
        "releaseAmount": false,
        "configuratorUser": true,
        "companyCode": "10",
        "language": "pt",
        "_expandables": [
          "visualConfigurations",
          "groupsCompanies",
          "documents",
          "documents.fields",
          "establishments"
        ],
        "visualConfigurations": [
          {
            "ordination": 3,
            "allCompanies": false,
            "approveWithoutReason": true,
            "undoTime": 5,
            "rightSwipeAction": 1,
            "leftSwipeAction": 1,
            "initialView": 1,
            "pageRecordsNumber": 50
          }
        ],
        "groupsCompanies": [
          {
            "sequence": 1,
            "name": "Grupo de Empresas 1",
            "companies": [
              {
                "code": "002",
                "name": "TOTVS SA - E-kanban"
              },
              {
                "code": "10",
                "name": "10 TOTVS S.A"
              },
              {
                "code": "11",
                "name": "TOTVS"
              }
           }
         ],
         "documents": [
          {
            "documentCode": 1,
            "documentDescription": "Solicitação de Compra - Item",
            "defaultLayout": false,
            "shortName": "SC",
            "fields": [
              {
                "id": "doc-nr-requisicao",
                "componentType": 1,
                "label": "",
                "description": "Número da Solicitação de Compra",
                "visible": true,
                "size": 100
              },
              {
                "id": "pend-valor-doc",
                "componentType": 1,
                "label": "",
                "description": "Valor da Pendência de Aprovação",
                "visible": true,
                "size": 100
              }
            ]
          },
          {
            "documentCode": 5,
            "documentDescription": "Cotação de Materiais",
            "defaultLayout": false,
            "shortName": "CO",
            "fields": [
              {
                "id": "pend-chave-doc",
                "componentType": 1,
                "label": "Chave",
                "description": "Chave do Documento da Pendência de Aprovação",
                "visible": true,
                "size": 100
              },
              {
                "id": "pend-valor-doc",
                "componentType": 1,
                "label": "Valor",
                "description": "Valor da Pendência de Aprovação",
                "visible": true,
                "size": 100
              }
            ]
          }
        ],
        "establishments": [
          {
            "code": "A1",
            "name": "Estabelecimento TOTVS",
            "codeCompany": "10"
          },
          {
            "code": "10000",
            "name": "Estab 10000",
            "codeCompany": "10"
          }
         ]         
      }
    ]
  }
}

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

  • tt-aprovador: contém as informações principais do aprovador
  • tt-config-visual (visualConfigurations): contém as informações de configuração visual do usuário.
  • groupsCompanies
    • sequencia: sequência do grupo de empresa;
    • name: Nome do grupo de empresa;
    • ttCompany (companies): contém informações de empresas
  • tt-document (documents): contém informações dos documentos
    • tt-layout (fields): contém informações de campos do layout de documento
  • ttEstablishments (establishments): contém informações dos estabelecimentos
RowErrorsTemp-tableOUTPUTInformações sobre os erros ocorridos durante o processo de busca dos dados

Retorno

Dados principais para inicialização do APP ou erros ocorridos durante o processo de busca.



pi-get-document-abrev

Requisito

Nenhum.

Descrição

Retorna a sigla do documento

Parâmetros

Tipo

Input/Output

Descrição

piDocumentCodeINTEGERINPUTCódigo do documento
pcDocumentDescriptionCHARACTERINPUTDescrição do documento
pcSiglaCHARACTEROUTPUTSigla do documento

Retorno

Sigla do documento.



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 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.


Exemplo
{
    "pathParams": [
    "validateUserInfo",
    "super"
  ],
}
oOutputJsonObjectOUTPUT

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


Exemplo
{
  "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-query-app-list-v1

Requisito

Nenhum.

Descrição

Realiza a busca de pendências a ser apresentada na listagem do APP.

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 a busca das pendências:

pathParams:  Informar: getPendingApprovalToList

queryParams

  • company: Empresa, se não informar o parâmetro serão consideradas todas as empresas
  • establishment: Estabelecimento, se não informar o parâmetro serão considerados todos os estabelecimentos
  • inicialGenerationDate: Data de geração inicial no formato yyyy-mm-dd (se enviar no formato inválido é desconsiderado)
  • finalGenerationDate: Data de geração final no formato yyyy-mm-dd (se enviar no formato inválido é desconsiderado)
  • mainPendencies: Indica se devem ser apresentadas as pendências principais
  • alternativePendencies: Indica se devem ser apresentadas as pendências alternativas
  • masterPendencies: Indica se devem ser apresentadas as pendências como mestre
  • documents: Documentos a serem considerados (separados por vírgula)
  • pendingPendencies: Indica se devem ser apresentadas pendências "pendentes"
  • approvedPendencies: Indica se devem ser apresentadas pendências "aprovadas"
  • rejectedPendencies: Indica se devem ser apresentadas pendências "reprovadas"
  • reApprovedPendencies: Indica se devem ser apresentadas pendências "reaprovadas"
  • order: 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: Estabelecimento
    • documentType: Documento
  • pageSize: Tamanho da página (número de registros retornados)
  • nextRowid: Rowid do registro da próxima página (que será buscado os registros)


Exemplo
{
   "pathParams": [
      "getPendingApprovalToList"
   ],
   "queryParams": {
      "mainPendencies": [
         ""
      ],
      "pendingPendencies": [
         ""
      ],
      "approvedPendencies": [
         ""
      ],
      "rejectedPendencies": [
         ""
      ],
      "reApprovedPendencies": [
         ""
      ],
      "documents": [
         "3,8"
      ],
      "order": [
         "-price"
      ],
      "pageSize": [
         "30"
      ]
  },
}
oOutputJsonObjectOUTPUT

Informações das pendências:


Exemplo
{
  "status": 200,
  "payload": {
    "total": 3,
    "hasNext": false,
    "items": [
      {
        "transactionNumber": 88912,
        "documentType": 8,
        "documentKey": "994344",
        "generateDate": "2021-03-03",
        "approver": "super",
        "status": 2,
        "company": "10",
        "site": "1",
        "pendencyType": 1,
        "price": 109989000.00,
        "fields": [
          {
            "id": "pend-cod-tip-doc-desc",
            "value": "Pedido Emergencial - Total"
          },
          {
            "id": "pend-chave-doc",
            "value": "994344"
          },
          {
            "id": "pend-cod-usuar-doc",
            "value": "super"
          },
          {
            "id": "pend-valor-doc",
            "value": "R$ 109.989.000,00"
          }
        ]
      },
      {
        "transactionNumber": 88967,
        "documentType": 3,
        "documentKey": "12345707710 .compras",
        "generateDate": "2021-03-04",
        "approver": "super",
        "status": 1,
        "company": "10",
        "site": "1",
        "pendencyType": 1,
        "price": 12.45,
        "fields": [
          {
            "id": "doc-nr-requisicao",
            "value": "123457077"
          },
          {
            "id": "doc-sequencia",
            "value": "10"
          },
          {
            "id": "doc-it-codigo",
            "value": ".compras"
          },
          {
            "id": "doc-dt-requisicao",
            "value": "04\/03\/2021"
          },
          {
            "id": "doc-nome-abrev",
            "value": "super"
          },
          {
            "id": "pend-valor-doc",
            "value": "R$ 12,45"
          }
        ]
      },
      {
        "transactionNumber": 89469,
        "documentType": 3,
        "documentKey": "12345708510 .compras-copia",
        "generateDate": "2021-03-22",
        "approver": "super",
        "status": 4,
        "company": "10",
        "site": "1",
        "pendencyType": 1,
        "price": 9.09,
        "fields": [
          {
            "id": "doc-nr-requisicao",
            "value": "123457085"
          },
          {
            "id": "doc-sequencia",
            "value": "10"
          },
          {
            "id": "doc-it-codigo",
            "value": ".compras-copia"
          },
          {
            "id": "doc-dt-requisicao",
            "value": "22\/03\/2021"
          },
          {
            "id": "doc-nome-abrev",
            "value": "super"
          },
          {
            "id": "pend-valor-doc",
            "value": "R$ 9,09"
          }
        ]
      }
    ]
  },
  "nextRowid": null
}

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

  • tt-mla-doc-pend-aprov: contém as informações gerais da pendência
    • tt-fields (fields): contém as informações de campos e valores da pendência
  • nextRowid: Rowid do registro da próxima página (para utilizar na próxima busca de dados)


RowErrorsTemp-tableOUTPUTInformaçõ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-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

ttParamPendingApprovalTEMP-TABLEINPUTParâmetros para busca dos registros de pendências
tt-mla-doc-pend-aprovTEMP-TABLEOUTPUTListagem com informações das pendências
lHasNextLOGICALOUTPUTIndica que existem mais registros a serem mostrados
rNextRowidROWIDOUTPUTPróximo rowid para busca de novos registros 
RowErrorsTEMP-TABLEOUTPUTInformaçõ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.


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

Lista de rejeições:


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


RowErrorsTemp-tableOUTPUTInformaçõ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.


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

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


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


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-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.


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

Informações de histórico:


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


RowErrorsTemp-tableOUTPUTInformaçõ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

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


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

Informações da aprovação:


Exemplo
{
  "status": 200,
  "payload": {
    "sucessProcess": true
  }
}
RowErrorsTemp-tableOUTPUTInformaçõ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


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

Informações da reprovação:


Exemplo
{
  "status": 500,
  "payload": {
    "sucessProcess": false,
    "errors": {
      "errorMessage": [
        {
          "code": 2609,
          "message": "Código de rejeição não cadastrado",
          "detailedMessage": ".\n",
          "type": "ERROR"
        }
      ]
    }
  }
}
RowErrorsTemp-tableOUTPUTInformaçõ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


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

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


Exemplo
{
  "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-query-attachments-v2

Requisito

Nenhum.

Descrição

Retorna a lista de anexos disponíveis para determinado documento.

Parâmetros

Tipo

Input/Output

Descrição

oInput

JsonObject

INPUT

Parâmetros para retornar a lista de anexos:

pathParams:  Informar: attachments  e o número da transação


Exemplo
{
    "pathParams": [
    "attachments",
    "19308"
  ],
}
oOutputJsonObjectOUTPUT

listagem dos anexos do documento:


Exemplo
{
    "payload": {
        "total": 3,
        "hasNext": false,
        "items": [
            {
                "internalId": "1",
                "transactionNumber": "412297",
                "name": "arquivo1.png",
                "description": "anexo de teste",
                "creationDatetime": "2020-02-01T08:00:00.000",
                "group": ""
            },
            {
                "internalId": "2",
                "transactionNumber": "412297",
                "name": "arquivo2.pdf",
                "description": "anexo de teste 2",
                "creationDatetime": "2022-02-01T08:00:00.000",
                "group": "teste"
            },
            {
                "internalId": "3",
                "transactionNumber": "412297",
                "name": "arquivo3.doc",
                "description": "anexo de teste 3",
                "creationDatetime": "2022-05-13T08:00:00.000",
                "group": "teste3"
            }
        ]
    },
    "status": 200
}

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

  • tt-anexo: contém a lista de anexos com as informações de identificação do arquivo, sem o seu conteúdo.


RowErrorsTemp-tableOUTPUTInformações sobre os erros ocorridos na busca dos anexos do documento.

Retorno

Informação de sucesso ou erros ocorridos no processo de criação da listagem dos anexos.



pi-get-attach-content-v2

Requisito

Nenhum.

Descrição

Retorna objeto com o conteúdo do anexo de um determinado documento.

Parâmetros

Tipo

Input/Output

Descrição

oInput

JsonObject

INPUT

Parâmetros para retornar o conteúdo do anexo:

pathParams:  Informar:

  • attachmentContent 
  • número da transação
  • número do ID do anexo


Exemplo
{
    "pathParams": [
    "attachmentContent",
    "412297",
	"2"
  ],
}
oOutputJsonObjectOUTPUT

Objeto com o conteúdo do anexo solicitado:


Exemplo
{    
    "internalId": 1,
    "transactionNumber": 412297,
    "name": "arquivo1.png",
    "contentType": "image/png",
    "content": "iVBORw0KGgoAAAANSUhEUgAAAMkAAADJCAYAAAH+wSaTAAAAAXNSR0IArs4c6QAAAARnQU1BAA"
}

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

  • tt-anexo-conteudo: contém as informações de conteúdo do anexo consultado.
RowErrorsTemp-tableOUTPUTInformações sobre os erros ocorridos na busca do conteúdo do anexo de determinado documento.

Retorno

Informação de sucesso ou erros ocorridos no processo de consulta ao conteúdo do anexo.

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:


RowErrors

Entrada/Saída

Temp-table com dados dos erros ocorridos durante o processo

Saída

Atributo

Tipo

Descrição

Obrigatório

Evolução

ErrorSequence

 INTEGER

Número da sequência do erro

Sim

Não se aplica

ErrorNumber

INTEGER Código do erro 

Sim

Não se aplica

ErrorDescriptionCHARACTER Descrição do erro SimNão se aplica
ErrorParametersCHARACTER Parâmetros da mensagem de erro SimNão se aplica
ErrorTypeCHARACTER Tipo do erro SimNão se aplica
ErrorHelpCHARACTER Texto de ajuda da mensagem de erro SimNão se aplica
ErrorSubTypeCHARACTERSubtipo do erroSimNão se aplica



tt-aprovador

Entrada/Saída

Temp-table com dados dos aprovadores

Saída

Atributo

Nome no objeto

Tipo

Descrição

Obrigatório

Evolução

cod-usuar

userCode

CHARACTER 

Código do aprovador

Não

Não se aplica

nome-usuar

userNameCHARACTER Nome do aprovador

Não

Não se aplica

e-maileMailCHARACTER E-mail do aprovadorNãoNão se aplica
envia-emailsendEmailLOGICALIndica se envia e-mailNãoNão se aplica
recebe-emailreceiveEmailLOGICALIndica se recebe e-mailNãoNão se aplica
usuar-mestremasterUserLOGICALIndica se o usuário é mestreNãoNão se aplica
mo-codigocurrencyINTEGERMoeda do aprovadorNãoNão se aplica
sigla-moedacurrencyAbbrevCHARACTER Sigla da moeda do usuárioNãoNão se aplica
aprova-autoautomacticApprovalLOGICALIndica se o aprovador aprova automaticamenteNãoNão se aplica
aprova-auto-aprovautomacticApprovalApproverLOGICALIndica se o aprovador aprova automaticamente pendências do aprovadorNãoNão se aplica
cod-estabelsiteCodeCHARACTER Estabelecimento do aprovadorNãoNão se aplica
cod-lotacaoallocationCodeCHARACTER Lotação do aprovadorNãoNão se aplica
libera-verbareleaseAmountLOGICALIndica se o aprovador libera verbaNãoNão se aplica
log-usuar-configconfiguratorUserLOGICALIndica se o aprovador é configurador visualNãoNão se aplica
empresacompanyCodeCHARACTER Empresa do aprovadorNãoNão se aplica
idiomalanguageCHARACTER Idioma do aprovadorNãoNão se aplica



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 de deslizar (Direita)

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


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

Ação de deslizar (Esquerda)

(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



ttCompany

Entrada/Saída

Temp-table com dados de empresas

Saída

Atributo

Nome no objeto

Tipo

Descrição

Obrigatório

Evolução

seqGroup


INTEGER

Sequência da empresa

Sim

Não se aplica

cCodecodeCHARACTERCódigo da empresaSimNão se aplica
cNamenameCHARACTERNome da empresaSimNão se aplica



ttEstablishments

Entrada/Saída

Temp-table com dados de estabelecimentos

Saída

Atributo

Nome no objeto

Tipo

Descrição

Obrigatório

Evolução

cCodecodeCHARACTERCódigo do estabelecimentoSimNão se aplica
cNamenameCHARACTERNome do estabelecimentoSimNão se aplica
cCodeCompanycodeCompanyCHARACTERCódigo da empresaSimNão se aplica.



tt-document

Entrada/Saída

Temp-table com dados de documentos

Saída

Atributo

Nome no objeto

Tipo

Descrição

Obrigatório

Evolução

cod-usuar

userCode

CHARACTER 

Código do aprovador

Sim

Não se aplica

idi-interfacinterfaceINTEGERInterface (1 - Lista / 2 - Detalhe)SimNão se aplica
cod-tip-docdocumentCodeINTEGERCódigo do documentoSimNão se aplica
desc-tip-docdocumentDescriptionCHARACTER Descrição do documentoNãoNão se aplica
layout-padraodefaultLayoutLOGICALLayout padrãoNãoNão se aplica
siglashortNameCHARACTERSigla do documentoNãoNão se aplica



tt-layout

Entrada/Saída

Temp-table com campos de layout

Saída

Atributo

Nome no objeto

Tipo

Descrição

Obrigatório

Evolução

cdn-docto
INTEGERCódigo do documentoSimNão se aplica

cod-usuar


CHARACTER 

Código do aprovador

Sim

Não se aplica

idi-interfac
INTEGERInterface (1 - Lista / 2 - Detalhe)SimNão se aplica
cod-id-campoidCHARACTER Identificador do campoSimNão se aplica
idi-componcomponentTypeINTEGERTipo de componente (1 - Campo / 2 - Lista / 3 - Separador)SimNão se aplica
nom-rotu-campolabelCHARACTER Rótulo do campoNãoNão se aplica
des-campodescriptionCHARACTER Descrição do campoSimNão se aplica
log-visivelvisibleLOGICALVisibilidade do campoSimNão se aplica
cdn-tamanhosizeINTEGERTamanho do campoSimNão se aplica
cdn-ord
INTEGEROrdem do campoSimNão se aplica
cod-entid-pai
CHARACTER Identificação da entidade paiNãoNão se aplica
Índice: visivel-ordem, log-visivel, cdn-ord



tt-mla-doc-pend-aprov

Entrada/Saída

Temp-table com dados de pendências

Saída

Atributo

Nome no objeto

Tipo

Descrição

Obrigatório

Evolução

nr-transtransactionNumberINTEGERNúmero da transaçãoSimNão se aplica
cod-tip-docdocumentTypeINTEGERCódigo do documentoSimNão se aplica
chave-docdocumentKeyCHARACTER Chave do documentoSimNão se aplica
dt-geracaogenerateDateDATEData de geraçãoSimNão se aplica

cod-usuar

approver

CHARACTER 

Código do aprovador

Sim

Não se aplica

ind-situacaostatusINTEGER

Situação da pendência

1 - Pendente 

2 - Aprovada

3 - Reprovada

4 - Reaprovada

SimNão se aplica
ep-codigocompanyCHARACTER EmpresaSimNão se aplica
cod-estabelsiteCHARACTER EstabelecimentoSimNão se aplica
tipopendencyTypeINTEGER

Tipo

1 - Principal

2 - Alternativa

3 - Mestre

SimNão se aplica
valor-docpriceDECIMALValor do documento



tt-fields

Entrada/Saída

Temp-table com informações de campos e valores das pendências

Saída

Atributo

Nome no objeto

Tipo

Descrição

Obrigatório

Evolução

nr-trans


INTEGER

Número da transação

Sim

Não se aplica

id-campoidCHARACTER ID do campoSimNão se aplica
valor-campovalueCHARACTER Valor do campoSimNã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: Estabelecimento
  • 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



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

cCodRejeitadescriptionCHARACTER DescriçãoSimNão se aplica
obriga-narrativareasonIsRequiredLOGICALIndica se o código de rejeição obriga narrativaSimNã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 aprovaçã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

tt-anexo

Entrada/Saída

Temp-table com a lista de anexos. Possui as informações de identificação do arquivo, sem o seu conteúdo.

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

idinternalIdCHARACTERId interno do anexoSimNão se aplica
nomenameCHARACTERNome do anexoSimNão se aplica
descricaodescriptionCHARACTERDescrição do anexoNãoNão se aplica
dt-hra-criacao creationDatetimeDATETIMEData e hora de criação do anexoNãoNão se aplica
grupo  groupCHARACTERGrupo de ordenação ao qual o anexo pertenceNãoNão se aplica

tt-anexo-conteudo

Entrada/Saída

Temp-table com as informações do conteúdo do anexo.

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

idinternalIdCHARACTERId interno do anexoSimNão se aplica
nomenameCHARACTERNome do anexoNãoNão se aplica
tipo-conteudocontentTypeCHARACTERTipo do conteúdo usado para a abertura do arquivoNãoNão se aplica
conteudocontentCLOBConteúdo do arquivo em Base64SimNão se aplica