01. DADOS GERAIS

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

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