Árvore de páginas

Versões comparadas

Chave

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

...

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:

    "ObservacaoAdicionalValorobservacaoAdicionalValor": [
            {
                "IdOperacaoidOperacao": "24695",
                "IdRetaguardaObservacaoAdicionalCampoidRetaguardaObservacaoAdicionalCampo": 16,
                "Valorvalor": "11/11/2025",
                "Situacaosituacao": 1,
                "IdRetaguardaidRetaguarda": "2aacc6e2-44c9-4b73-9ae5-ee3679d6dcdd",
                "Idid": 49,
                "DataCadastrodataCadastro": "2025-11-11T11:28:27.291376",
                "DataAtualizacaodataAtualizacao": "2025-11-11T11:28:27.390273"            
            }
    ]

...