A tabela grupo_cliente foi criado no TOTVS Varejo PDV Omni para receber o vínculo de grupo de cliente com os cadastros de cliente.

Assim no processo de precificação os dados poderão ser utilizados para validação da regra.

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

Endpoint: /api/retaguarda/v3/dadosdinamicos/down/21/{versão}
Método: Post
Autenticação: Bearer token
Permissão: Retaguarda
Microserviço: PDVSync.Core.Cliente

Este endpoint recebe uma lista de grupos permitindo vários em uma mesma requisição

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

É necessário que o inquilino tenho o parametro 21 - grupo cadastrado no controle.

Todo grupo deve estar vinculado a um cliente cadastro no PDV para que seja baixado, caso não foi feito o envio do cliente, clique aqui para acessar a documentação do envio de cliente.

Informação	Campo Banco PV	Campo Json API	Obrigatório	Tipo	Tamanho	Descrição	Observação
~~Grupo~~	~~id_grupo~~	N/A	Não	Texto	2	Identificação do grupo da retaguarda	Campo descontinuado
Situação	situacao	situacao	Sim	Inteiro		Define se o perfil em questão está ativo ou inativo. 0 - Inativo 1 - Ativo
Data cadastro	data_cadastro	dataAtualizacao	Sim	Data		Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.	Gerado automaticamente pelo Server
Data atualização	data_atualizacao	dataCadastro	Sim	Data		Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.	Gerado automaticamente pelo Server
Identificação no retaguarda	id_retaguarda	idRetaguarda	Sim	Texto	100	Identificador do grupo na retaguarda
idInquilino	N/A	idInquilino	Sim	Texto		Identificador do inquilino
idProprietario	N/A	idProprietario	Sim	Texto		Identificador do proprietário
Identificação no retaguarda	id_retaguarda_loja	idRetaguardaLoja	Não	Texto	100	Identificador da loja na retaguarda
Identificação no Server	N/A	loteOrigem	Sim	Texto		Identificador do lote
Identificação no retaguarda	id_cliente	idRetaguardaCliente	Sim	Texto		Identificador do cliente na retaguarda	Este cliente deve estar cadastrado no PDV para que o grupo seja baixado.

Requisição

Exemplo de body da requisição

[
{
"idInquilino": "string",
"idProprietario": "string",
"idRetaguarda": "string",
"idRetaguardaCliente": "string",
"idRetaguardaLoja": "string",
"loteOrigem": "string",
"situacao": 1
}
]

Definições dos campos do body

Campo	Tipo	Descrição	Obrigatório	Observações
idInquilino	string	Identificador do inquilino	Sim
idProprietario	string	Identificador do proprietário	Sim
idRetaguarda	string	Identificador do grupo na retaguarda	Sim	Tamanho máximo: 100 caracteres
idRetaguardaCliente	string	Identificador do cliente na retaguarda	Sim	Este cliente deve estar cadastrado no PDV para que o grupo seja baixado.
idRetaguardaLoja	string	Identificador da loja na retaguarda	Não	Tamanho máximo: 100 caracteres
loteOrigem	string	Identificador do lote	Sim
situacao	Int	Situação do grupo	Sim	0 - Inativo , 1 - ativo

Retorno

Exemplo de body de retorno

{
"data": null,
"errors": null,
"message": null,
"numberOfRecords": 8,
"success": true,
"totalTime": 2061
}

Definições dos campos do retorno

Campo	Tipo	Descrição
data	Objeto	Retorno dos dados caso tenha
errors	Objeto	Objeto contendo todos os erros encontrados.
message	String	Descrição do erro
numberOfRecords	Int	Número de arquivos processados
success	Bool	Status da requisição
totalTime	Int	Tempo total

Exemplo de body de retorno

{
"data": null,
"errors": {
"0": {
"IdRetaguarda": [
""
]
}
},
"message": null,
"numberOfRecords": 9,
"success": false,
"totalTime": 4077
}

Definições dos campos do retorno

Campo	Tipo	Descrição
data	Objeto	Retorno dos dados caso tenha
errors	Objeto	Objeto contendo todos os erros encontrados. Cada propriedade desse objeto é o índice do grupo enviado que está com erro.
message	String	Descrição do erro
numberOfRecords	Int	Número de arquivos processados
success	Bool	Status da requisição
totalTime	Int	Tempo total