Árvore de páginas

Versões comparadas

Chave

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

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

  • 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

titleexpandtitleDefinição de requisição
Deck of Cards
idversções
Card
labelV3.1 (V2)

Requisição

Section
Column
width50%
Expandir

Exemplo de body da requisição

[
    {
        "nome": "string",
        "tipoPerfil": "string",
        "idInquilino": "string",
        "idRetaguarda": "string",
        "idProprietario": "string",
        "loteOrigem": "string",
       

"lote": "string

"

,
        "

situacao": 1
    }
]


Column
width
50%

Definições dos campos

do body

Campo

Tipo

Descrição

Obrigatório

Observações

nome

string

Nome dado ao perfil

Obrigatório

Sim

Tamanho máximo: 50 caracteres

tipoPerfilintTipo do perfil
(Definição abaixo)
Sim
CódigoTipo
1Administrador
2Operador
3Vendedor
Obrigatório
idInquilinostringIdentificador do inquilino
Obrigatório
Sim
idRetaguardastringIdentificador do perfil na retaguarda 
Obrigatório
Sim
idProprietariostring
Idendtificador
Identificador do proprietário
Obrigatório
Sim
loteOrigemstringLote vinculado ao dado
lotestringLote vinculado ao dado
Sim
situacaointSituação do
perfil (
perfil Não

0 - Inativo, 1 -

Ativo)

Ativo 

Opcional -

Caso não enviado será cadastrado com 0 

expand

Retorno

title
Deck of Cards
Tipo Perfil
id
Código
retornos
Tipo
Card
1
label
Administrador
200 - Ok
2
Column
Operador
Expandir
title200 - Ok
width
3Vendedor Expandir
titleRetorno da requisição
title
50%

Exemplo de body de retorno

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

Expandir

Column
width50%

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
label
400 - Bad Request
Column
width50%

Exemplo de body de retorno

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

Column
width50%

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
width50%

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
expand
width
title
Expandir
title200 - Ok
50%
Definição dos campos de retornoexpandtitle

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
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
width50%

Exemplo de body de retorno

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

Column
width50%

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
width50%

Exemplo de body de retorno

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

Column
width50%

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