Á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-14287


02. SITUAÇÃO/REQUISITO

  • Adicionar o objeto observacaoAdicionalValor no payload do retorno da API processoOnlinePreVenda, dentro do objeto cliente, permitindo o recebimento das observações adicionais configuradas e associadas ao cliente no PDVSync. Atualmente, o processo da API processoOnlinePreVenda não contempla as observações adicionais configuradas para o cliente.

03. SOLUÇÃO

  • Nesta implementação foi incluído um novo objeto no contrato JSON do cliente, denominado observacaoAdicionalValor, para retornar 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 retorno da pré-venda no conteúdo associado ao cliente.

Estrutura da observacao_adicional_valor

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 cliente

  • O novo objeto observacaoAdicionalValor foi adicionado dentro do objeto cliente:

    "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"            
            }
    ]