Integração DAV via Stored Procedure

Interface de Integração de Orçamento via Stored Procedure.

O processo de integração de orçamentos (DAVs e Pré-vendas) via stored procedure serve para que sistemas parceiros similares ao Totall Order possam enviar DAVs para serem resgatadas pelo Commerce Checkout.

A partir da versão 01.08 do PAF-ECF (2011) passam a vigorar as seguintes regras para a retaguarda:

• Gravação do DAV no banco de dados deve ser de forma concomitante, ou seja a cada novo item inserido deve-se gravar no banco de dados.
• O DAV não pode ser impresso mais de uma vez.
• Após impresso o DAV não pode ser alterado.
• Não é permitir exclusão de itens de orçamento, podendo apenas cancelar os mesmos.
• Não permitir alterar a quantidade de um item.
• Os itens cancelados precisam ser enviados para o Checkout com um campo para definir que ele foi cancelado.
• Não será permitido incluir novos itens de DAV se o mesmo tiver algum item vendido.

As imagens abaixo ilustram a principal mudança de conceito. Antes o DAV poderia ser todo criado na retaguarda para depois ser passado ao banco de dados. Agora, essas duas etapas se fundiram porque o DAV precisa ser o tempo todo gravado no banco.

• 

  Antes

• 

  Depois

A imagem abaixo ilustra o uso das stored procedures para enviar um pedido de venda para o banco de dados.

Método responsável pela inserção ou atualização de uma DAV ou Pré-venda. Quando o orçamento é novo ele não ficará disponível para ser vendido enquanto não for executado o método VALIDA_DAV. Caso alguma inconsistência seja verificada o método gerará exceção. Para PostgreSQL foi implementado como uma função que retorna o campo NUMPED. No Oracle deve-se chamar como Stored Procedure passando os valores por parâmetro e pegando o retorno no parâmetro NUMPED.

Método responsável pela inserção ou atualização de um item de DAV ou Pré-venda. Somente pode ser executado após ter sido incluso o DAV pelo método ENVIA_DAV. Caso alguma inconsistência seja verificada gerará exceção.

   Método responsável por cancelar um item de DAV.

Caso não encontre o item ou o mesmo não possa ser cancelado gerará uma exceção.

Método responsável pela verificação do DAV e liberação para o Checkout. Realizando validações entre o DAV e seus itens. Caso a validação não gere exceção o DAV ficará disponível para ser resgatado na Venda. Caso alguma inconsistência seja verificada gerará exceção.

Função responsável pelo cancelamento de uma DAV.

Obs.: Função não existente para Pré-Venda por obrigação do PAF. Caso não seja possível o cancelamento gerará exceção.

Os métodos de integração de DAV devem ser executados em uma sessão de banco de dados assinada.
Isso quer dizer que os comandos de integração de DAV devem ser precedidos do comando RegistraAcesso. O método está descrito no artigo Integração de Banco via Rotinas de Importação.

   Não é permitido que o DAV/Pré-venda seja impresso mais de uma vez.

Com isso, quem quiser implementar a rotina de impressão deve se preocupar em mandar o parâmetro ORCIMP = 'T' no ENVIA_DAV.
No caso de uma tentativa de reimpressão o sistema deve apresentar a seguinte mensagem:

    PAF Req VI item 11 - É vedada a reimpressão de DAV.    

Versão 5.2A

• Inclusão do campo LOTEXT no ENVIAITEM_DAV.

Versão 5.0G

• Inclusão do campo ORCIMP no ENVIA_DAV.
• Inclusão do campo FLGEST no ENVIAITEM_DAV.
• Substituição da função EXCLUIITEM_DAV por CANCELAITEM_DAV.
• Inclusão de comentários Procedimentos para Assinatura explicando como utilizar RegistraAcesso ao invés de ASSINA_DAV.
• Inclusão de novas colunas nos parâmetros de ConcatenaIOR.
• Bloqueio para reimpressão de DAV.