Árvore de páginas

Versões comparadas

Chave

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

...

pi-delete-v1

Requisito

Nenhum.

Descrição

Repassa os parâmetros recebidos pela API de comunicação (cdp/supplyDocuments) para a API de documentos (hubapi/apiDocuments) chamando o método pi-delete-v1. Também realiza validações de restrição dos usuários em relação a menu e processos.

Retorna informações relacionadas a exclusão dos anexos.

Parâmetros

Tipo

Input/Output

Descrição

oInput

JsonObject

INPUT

Parâmetros para eliminação de anexo individual:

pathParams:  Informar: ID do anexo.


Bloco de código
titleExemplo
{
    "pathParams": [
       "1234"
    ],
}


Parâmetros para eliminação de anexo em lote:

Payload: Informar os IDs a serem eliminados:


Bloco de código
titleExemplo
[
   {"documentId": 552, 
   {"documentId": 553},
   {"documentId": 554}
]
oOutputJsonObjectOUTPUT

Informações da exclusão:

Não há retorno direto via Output nesse método. Em caso de sucesso na exclusão individual ou lote, será retornado vazio.

A montagem do JsonObject e seu retorno ocorrerá na API de comunicações, cdp/supplyDocuments com base no conteúdo vindo da temp-table RowErrors. Para mais informações vide documentação : supplyDocuments - Anexos de Suprimentos (Compras, Contratos, entre outros).

RowErrorsTemp-tableOUTPUT 

Informações sobre os erros ocorridos durante o processo:

A temp-table vem populada com registros criados na API de documentos (hubapi/apiDocuments), devido a erros ocorridos durante o processo de exclusão de anexos.

Esses registros serão usados para a montagem da mensagem de erro que será retornada via OUTPUT de um JsonObject, na API de comunicação (cdp/supplyDocuments), conforme cada caso específico. 

  • Caso haja erro na tentativa de excluir um único registro inexistente, serão repassados para a API de comunicação (cdp/supplyDocuments) valores na temp-table RowErrors para montagem e retorno do objeto Json. Exemplo do modelo da mensagem utilizando o registro 553:


Bloco de código
titleExemplo
{
  "detailedMessage": "Registro não encontrado na tabela anexo_docto - Id: 553.\n",
  "code": "57401",
  "message": "Registro não encontrado.",
  "type": "error"
}


  • Caso haja erro na tentativa de excluir registros inexistentes em lote, serão repassados para a API de comunicação (cdp/supplyDocuments) valores na temp-table RowErrors para montagem e retorno do objeto Json. Exemplo do modelo da mensagem utilizando os registros 552, 553 e 554:


Bloco de código
titleExemplo
{
    "detailedMessage": "Registro não encontrado na tabela anexo_docto - Id: 552.\n",
    "code": "57401",
    "details": [
        {
            "detailedMessage": "Registro não encontrado na tabela anexo_docto - Id: 553.\n",
            "code": "57401",
            "message": "Registro não encontrado.",
            "type": "error"
        },
        {
            "detailedMessage": "Registro não encontrado na tabela anexo_docto - Id: 554.\n",
            "code": "57401",
            "message": "Registro não encontrado.",
            "type": "error"
        }
    ],
    "message": "Registro não encontrado.",
    "type": "error"
}


  • Caso haja erro na eliminação de registros juntamente com sucesso na exclusão registros em lote, serão repassados para a API de comunicação (cdp/supplyDocuments) valores na temp-table RowErrors para montagem e retorno do objeto Json. Exemplo do modelo da mensagem utilizando os registros 637, 404 e 554:


Bloco de código
titleExemplo
{
    "_messages": [
        {
            "detailedMessage": "Registro não encontrado na tabela anexo_docto - Id: 554.\n",
            "code": 57401,
            "type": "error",
            "message": "Registro não encontrado."
        }
    ],
    "idList": "404,637"
}
  • No caso de nenhum registro ter sido excluído com sucesso, é retornado o parâmetro ListaIdsExcluidos vazio, assim como um Output e o código do retorno da requisição é 404.


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

  • RowErrors: Contém os erros e informações sobre os erros ocorridos durante o processo.
  • Outros campos retornado no Json: 
    • detailedMessage: Mensagem detalhada do erro ocorrido.
    • code: Número do código do erro ocorrido.
    • message: Mensagem simplificada do erro.
    • type: Tipo da mensagem.
    • idList: Lista de IDs eliminados com sucesso em uma exclusão em lote com erros.


ListaIdsExcluidosCharacterOUTPUT IDs que foram eliminados com sucesso. Serão apresentado apresentados na mensagem de retorno caso aconteça de ter erros e sucessos em uma mesma eliminação em lote.
RetornoErros ocorridos durante a eliminação via temp-table RowErrors.exclusão individual ou em lote identificando qual o id com erro e id's dos documentos excluídos com sucesso. 



pi-create-v1

Requisito

Nenhum.

Descrição

Repassa os parâmetros recebidos pela API de comunicação (cdp/supplyDocuments) para a API de documentos (hubapi/apiDocuments) chamando o método pi-create-v1. Também realiza validações de restrição dos usuários em relação a menu e processos.

Retorna informações sobre o anexo criado.

Parâmetros

Tipo

Input/Output

Descrição

oInput

JsonObject

INPUT

Parâmetros para criação:

Payload:


Bloco de código
titleExemplo
{
         "processType":1,
         "processKey":"12345|10",
         "documentName":"testeArquivo.txt",
         "documentDescription":"teste de arquivo",
         "documentFile": "JC9CVVNJTkVTU0hVQi9Gb250ZXNfRG9jL1N1c3RlbnRhY2FvL1YxMS9WMTEv..."
 }

Descrição dos campos do payload:

  • processType: Tipo do processo ao qual o documento está vinculado.
  • processKey: Código da chave do processo podendo ser composta (separado por pipes).
  • documentName : Nome do arquivo.
  • documentDescription: Descrição do Documento.
  • documentFile: Conteúdo do arquivo, convertido para base64.
oOutputJsonObjectOUTPUT

Informações do anexo criado:


Bloco de código
oOutputJsonObjectOUTPUT

Informações do anexo criado:

Bloco de código
titleExemplo
{
    "items": [
        {
            "creationUserName": "Super",
            "documentDir": "\\\\moitas\\tmp\\ERP\\1\\12345\\10\\3c3bbcd88a4f01fb34fb63ae7f845f6c.txt",
            "creationUser": "super",
            "documentDescription": "teste de arquivo",
            "processKey": "12345|10",
            "documentId": 725,
            "processType": 1,
            "documentName": "testeArquivo.txt",
            "documentSize": "74 Bytes",
            "processTypeDescription": "Ordem de Compra",
            "creationDatetime": "2022-03-29T10:59:46.376"
        }
    ]
}

Para verificar o que significa cada campo conferir nas temp-tables no final desta documentação o detalhamento dos campos da temp-table :

  • ttDocumentFile: Contém os campos a serem retornados na busca dos documentos do processo.

ttDocumentFile .

RowErrorsTemp-RowErrorsTemp-tableOUTPUTInformações sobre os erros ocorridos durante a criação de arquivo.

Retorno

Informações do anexo criado ou erros ocorridos durante o processo.

...

pi-valida

Requisito

Nenhum.

Descrição

Realiza a verificação dos parâmetros passados na queryParams da no queryParams e pathParams dos métodos: pi-query-v1, para restrição de consulta, permitindo buscar apenas todos os documentos do tipo e chave de processo informadospi-create-v1, pi-delete-v1 e pi-download-v1, validando se o tipo de processo é um processo válido e existente, caso contrário, a execução do método será interrompida já no começo.

Parâmetros

Tipo

Input/Output

Descrição

cTypeCharacterINPUT

Identificação do endpoint:

  • create : inclusão de anexo.
  • query: consulta dos anexos.
  • download: download do anexo.
  • delete: exclução dos anexos.
iDocumentIdIntegerINPUTId (campo num-id-docto da tabela arquivo-docto do documento a ser verificado.

iProcessType

Integer

INPUT

Tipo do processo vindo da queryParams. Caso não tenha sido passado, e for o endpoint de "create" será retornado um erro.

cProcessKey CharacterINPUTChave do processo vindo da queryParams. Caso não tenha sido passado, e for o endpoint de "create" será retornado um erro.
RowErrorsTemp-tableOUTPUTInformações sobre os erros ocorridos durante o processo.

Retorno

Informações sobre os erros ocorridos durante o processo.

...

Chave
pi-valida-ordem

Requisito

Nenhum.

Descrição

Realiza a verificação das permissões do usuário logado em relação ao programa de ordens de compra.

Parâmetros

Tipo

Input/Output

Descrição

iProcessType

Integer

INPUTTipo do processo vindo da queryParams.cProcessKey CharacterINPUT do processo vindo da queryParams.
RowErrorsTemp-tableOUTPUTInformações sobre os erros ocorridos durante o processo.

Retorno

Informações sobre os erros ocorridos durante o processo.

...