Árvore de páginas

Versões comparadas

Chave

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

...

Deck of Cards
iddk1
Card
idcard1
labelDescrição dos campos e regras
InformaçãoColunaObrigatórioTipoTamanhoDescrição
Nome

nome

Sim

Texto

50

Descrição do perfil do qual estará associado ao usuário, como por exemplo:

  • Vendedor
  • Caixa
  • Supervisor
Situação do perfilsituacaoSimInteiro

Define se o perfil em questão está ativo ou inativo.

  • 0 - Inativo
  • 1 - Ativo
Data cadastrodata_cadastroSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Data atualizaçãodata_atualizacaoSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.
Identificação no retaguardaid_retaguardaNãoTexto100
Tipo de Perfiltipo_perfilSimInteiro
  • 1 - Administrativo
  • 2 - Caixa
  • 3 - Vendedor
Percentual máximo de desconto no itemdesconto_maximo_itemNãoNumérico
O percentual máximo de desconto que o usuário associado ao perfil poderá aplicar no item. 
Percentual máximo de desconto no totaldesconto_maximo_totalNãoNumérico
O percentual máximo de desconto que o usuário associado ao perfil poderá aplicar no total da venda. 
Card
idcard2
labelMicrosserviço Integração

Este método é responsável pela criação de um novo perfil

  • Endpoint: /api/retaguarda/v2/perfis
  • Método: Post
  • Autenticação: Bearer token
  • Permissão: Retaguarda

Este endpoint recebe uma lista de perfis para que possam ser enviados vários na mesma requisição

Aviso

Para que a baixa do Perfil criado ocorra no PDV Omni é necessário realizar a abertura de um lote do tipo 3 = perfil

Deck of Cards
idversções
Card
labelV3.1 (V2)

Requisição

Section
Column
width40%

Exemplo de body da requisição

[
    {
        "nome": "string",
        "tipoPerfil": "string",
        "idInquilino": "string",
        "idRetaguarda": "string",
        "idProprietario": "string",
        "loteOrigem": "string",
        "situacao": 1
    }
]


Column
width60%

Definições dos campos do body

Campo

Tipo

Descrição

Obrigatório

Observações

nome

string

Nome dado ao perfil

Sim

Tamanho máximo: 50 caracteres

tipoPerfilintTipo do perfilSim
CódigoTipo
1Administrador
2Operador
3Vendedor
4Profissional
idInquilinostringIdentificador do inquilinoSim
idRetaguardastringIdentificador do perfil na retaguarda Sim
idProprietariostringIdentificador do proprietárioSim
loteOrigemstringLote vinculado ao dadoSim
situacaointSituação do perfil Não

0 - Inativo, 1 - Ativo 

Caso não enviado será cadastrado com 0 

Retorno

Deck of Cards
idretornos
Card
label200 - Ok
Column
width40%

Exemplo de body de retorno

{
    "success": true,
    "message": "Requisição inserida com sucesso!",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

Column
width60%

Definições dos campos do retorno

Campo

Tipo

Descrição

SuccessboolIndica se a criação do compartilhamento foi feita com sucesso
MessagestringCaso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo
DataobjetoObjeto compartilhamento criado
ErrorsListaListas com os erros encontrados no processo
TotalTimeinttempo da requisição
NumberOfRecordsintnúmero de dados inseridos
Card
label400 - Bad Request
Column
width40%

Exemplo de body de retorno

{
    "code": "string",
    "message": "string",
    "detailedMessage": "string",
    "helpUrl": "string",
    "details": [
        {
            "guid": "string",
            "code": "string",
            "message": "string",
            "detailedMessage": "string"
        }
    ]
}

Column
width60%

Definições dos campos do retorno

Campo

Tipo

Descrição

codestringCódigo de erro
messagestringMensagem do erro
detailedMessagestringDetalhamento do erro
helpUrlstringurl de ajuda
TotalTimestringTempo total de busca
detailslista de objetoLista de objeto de erros
details.guidstringIdentificador do erro
details.codestringCódigo do erro
details.messagestringMensagem do erro 
details.detailedMessagestringDetalhamento do erro
Card
labelV3.2
Informações

Este endpoint ainda está em processo de manutenção, as informações estão disponibilizadas apenas para consulta, não sendo possível realizar a requisição.

Requisição

Section
Column
width40%

Exemplo de body da requisição

[
    {
        "idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "loteOrigem": "string",
        "nome": "string",
        "descontoMaximoItem": "string",
        "descontoMaximoTotal": "string",
        "situacao": 1,
        "tipoPerfil": "string"
    }
]

Column
width60%

Definições dos campos do body

Campo

Tipo

Descrição

Obrigatório

Observações

nomestringNome dado ao perfil

Sim

Tamanho máximo: 50 caracteres

tipoPerfilintTipo do perfilSim
CódigoTipo
1Administrador
2Operador
3Vendedor
4Profissional
idInquilinostringIdentificador do inquilinoSim
idRetaguardastringIdentificador do perfil na retaguarda SimTamanho máximo: 100 caracteres
idProprietariostringIdendtificador do proprietárioSim
loteOrigemstringLote vinculado ao dadoSim
situacaointSituação do perfilSim0 - Inativo, 1 - Ativo
descontoMaximoItemnuméricoO percentual máximo de desconto que o usuário associado ao perfil poderá aplicar no item.Não
descontoMaximoTotalnuméricoO percentual máximo de desconto que o usuário associado ao perfil poderá aplicar no total da venda.Não


Retornos

Deck of Cards
idretornos
Card
label200 - Ok
Column
width40%

Exemplo de body de retorno

{
    "success": true,
    "message": "Requisição inserida com sucesso!",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

Column
width60%

Definições dos campos do retorno

Campo

Tipo

Descrição

SuccessboolIndica se a criação do compartilhamento foi feita com sucesso
MessagestringCaso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo
DataobjetoObjeto compartilhamento criado
ErrorsListaListas com os erros encontrados no processo
TotalTimeinttempo da requisição
NumberOfRecordsintnúmero de dados inseridos
Card
label400 - Bad Request
Column
width40%

Exemplo de body de retorno

{
    "code": "string",
    "message": "string",
    "detailedMessage": "string",
    "helpUrl": "string",
    "details": [
        {
            "guid": "string",
            "code": "string",
            "message": "string",
            "detailedMessage": "string"
        }
    ]
}

Column
width60%

Definições dos campos do retorno

Campo

Tipo

Descrição

codestringCódigo de erro
messagestringMensagem do erro
detailedMessagestringDetalhamento do erro
helpUrlstringurl de ajuda
TotalTimestringTempo total de busca
detailslista de objetoLista de objeto de erros
details.guidstringIdentificador do erro
details.codestringCódigo do erro
details.messagestringMensagem do erro 
details.detailedMessagestringDetalhamento do erro

...