TOTVS Varejo Franquias e Redes

Atalhos

Árvore de páginas


01. DADOS GERAIS

Produto:

TOTVS Varejo Franquias e Redes

Linha de Produto:

PDV Sync

Segmento:

Varejo

Módulo:Sync Server
Função:Adição objeto observacaoAdicionalValor
País:Brasil
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DVARINT1-14349


02. SITUAÇÃO/REQUISITO

  • Adicionar o objeto observacaoAdicionalValor no contrato de request de PreVendaMensagens , permitindo o envio de dados adicionais dinâmicos relacionados ao cliente, conforme estrutura definida na tabela observacao_adicional_valor.

03. SOLUÇÃO

  • Neste desenvolvimento foi incluído um novo objeto no contrato JSON do cliente, denominado observacaoAdicionalValor, para transmitir informações complementares configuradas de forma dinâmica no PDV.
  • Esses dados serão obtidos a partir da tabela observacao_adicional_valor, considerando as seguintes relações:
    • 🔗 Regras de Amarração
      • A tabela observacao_adicional_valor possui ligação com:
        • observacao_adicional_campo → identifica o campo configurado no PDV.
        • observacao_adicional_capa → define o contexto da informação.
      • O vínculo com o cliente ocorre quando:
        • O tipo_rotina da tabela observacao_adicional_capa é igual a 1 → indica que a rotina se refere ao cliente. 
      • A identificação do cliente específico é feita pelo campo:
        • id_operacao, que referencia a PK da tabela de cliente, quando tipo_rotina = 1.
  • Com base nisso, os valores contidos na tabela observacao_adicional_valor serão incluídos no envio de vendaMensagem no conteúdo associado ao cliente, permitindo que a retaguarda receba também os dados adicionais configurados dinamicamente no PDV.

Estrutura da observacao_adicional_valor

CampoTipoDescrição
idserialIdentificador único
id_retaguardavarchar(100)ID de referência do dado na retaguarda
data_cadastrotimestampData de criação
data_atualizacaotimestampData da última atualização
situacaoint4Status do registro
tipo_rotinaint4Identifica a rotina (1 = Cliente)
id_operacaotextRelaciona-se ao ID do cliente
id_observacao_adicional_campoint4Chave estrangeira para o campo configurado
valortextValor dinâmico inserido no PDV

📦 Novo objeto no contrato do clienteMensagem

  • Devemos adicionar o novo objeto observacaoAdicionalValor no atributo conteudo.
    • Segue o novo objeto que deve ser adicionado:
      •     "ObservacaoAdicionalValor": [
                {
                    "idOperacao": "24695",
                    "idRetaguardaObservacaoAdicionalCampo": 16,
                    "valor": "11/11/2025",
                    "situacao": 1,
                    "idRetaguarda": "2aacc6e2-44c9-4b73-9ae5-ee3679d6dcdd",
                    "id": 49,
                    "dataCadastro": "2025-11-11T11:28:27.291376",
                    "dataAtualizacao": "2025-11-11T11:28:27.390273",
                    "_expandables": []
                }
      • ]