Objetivo

Método de consulta de grupos de promoções cadastradas no ERP.

Chamada

GET [URLAPI]/PromocaoAPI/api/v1/GrupoPromocao

Permissionamento

Antes de prosseguir, certifique-se de que o usuário está com as devidas permissões no Sistema/Módulo/Aplicações e na empresa desejada.

Para isso, acesse o módulo SegurançaWeb > Permissões > Associação de Permissão Usuário / Grupo >  Sistemas/Módulo/Aplicações > Comercial Web > API Promoções > API Promoções Normais do ERP


image-2024-5-2_9-24-11.png

Imagem 01 - Configurações de Sistemas/Módulos/Aplicações


ATENÇÃO: Para saber mais sobre permissionamentos acesse aqui .

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)

SeqGrupoPromoc

Código para filtrar um grupo específico.

integer($int32)

Opcional

Descricao

Para filtrar grupos com descrição específica.

string

Opcional

DtaHoraAlteracao

Filtro para buscar grupos alterados a partir de uma data e hora.

string($date-time)

Opcional
FieldsCamposstringNão há
OrderOrdenaçãostringNão há
PagePágina

integer($int32)

Não há
PageSizeTamanho da Página

integer($int32)

Não há

Parâmetros do Corpo (Body Parameters)

Não há.

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

Formatos de Resposta (Response Formats)

application/json, text/json

CODE 200 - SUCCESS

GrupoPromocaoDtoIListDto

Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
seqGrupoPromoc

Código do grupo cadastrado.

integer($int32)Não há.
descricao

Descrição do grupo cadastrado.

stringNão há.
dtaHoraAlteracao

Data/Hora de alteração do grupo.

string($date-time)Não há.
indGeraAbastAuto

Indica que o grupo será utilizado como filtro no processo de Abastecimento Automático, no módulo Compras.

stringNão há.
indPromocaoConcorrente

Indica que se trata de promoção para ações de concorrência.

stringNão há.
expandablesPropriedade de expandir os campos.stringNão há.
{
  "hasNext": true,
  "items": [
    {
      "seqGrupoPromoc": 0,
      "descricao": "string",
      "dtaHoraAlteracao": "2020-12-14T19:24:28.902Z",
      "indGeraAbastAuto": "string",
      "indPromocaoConcorrente": "string",
      "expandables": [
        "string"
      ]
    }
  ]
}

application/json, text/json

CODE 400 - BAD

{
  "code": "string",
  "message": "string",
  "detailedMessage": "string",
  "helpUrl": "string",
  "details": [
    {
      "guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "notificationType": 0,
      "code": "string",
      "message": "string",
      "detailedMessage": "string",
      "status": 0
    }
  ]
}