Integração DAV via Stored Procedure

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

O processo de integração de pré-venda (DAVs) via stored procedure serve para que sistemas parceiros similares ao Totall Order possam enviar DAVs para serem resgatadas pelo Commerce Checkout.
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 pela exclusão de um item de DAV. Caso não encontre o item ou o mesmo não possa ser excluído 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.

Método serve para gravar a coluna ASSINA da TT_ORC em caso de inclusão de um novo orçamento. Isto porque é necessário executar ENVIA_DAV para obter o NUMPED. E o NUMPED faz parte da assinatura.

Assinatura de DAV

1. Chamar a função conecta para o código da empresa parceira na Totall:

SELECT Conecta(:CodigoEmpresa, path_ttsegur) AS pConecta, path_ttsegur AS pPathSegur
  FROM tt_cfg

CodigoEmpresa:
0 - TOTALL
1 - INTERSYS
2 - ADVANCE
3 - SARAIVA
4 - MODERNA

2. Gerar Hash:

pSenhaFixa: ÿ uma constante de segurança enviada parceiro por e-mail.

pHashConexao := md5(pConecta || pSenhaFixa)

3. Enviar a DAV:

SELECT ENVIA_DAV(...) as pNumped
  FROM dual  

ou

DECLARE
BEGIN
  ENVIA_DAV(..., pNumped);
END;

4. Gerar texto a ser criptografado:

SELECT ConcatenaORC(CODFIL,
                    TIPPED,
                    NUMPED,
                    NUMPED,
                    PED_EM,
                    VLRTOT,
                    CODEMP) as pTexto
  FROM tt_orc
 WHERE CODFIL = :CODFIL
   AND TIPPED = :TIPPED
   AND NUMPED = :NUMPED

ÿ importante concatenar os campos da TT_ORC da forma indicada para garantir que os dados concatenados sejam idênticos aos gravados.

5. Assinar os dados da DAV:

SELECT AssinaTab('TT_ORC' 
                 :pTexto
                 :pConecta IN NUMBER,
                 :pHashConexao IN VARCHAR2,
                 '',
                 :CodigoEmpresa,
                 path_ttsegur)
  FROM tt_cfg;

6. Gravar Assinatura:

DECLARE
BEGIN
  ASSINA_DAV(:CODFIL,
             :NUMPED,
             :TIPPED,
             :ASSINA)
END;

ou

SELECT ASSINA_DAV(:CODFIL,
                  :NUMPED,
                  :TIPPED,
                  :ASSINA);

Assinatura de Item de DAV

1. Chamar a função conecta:

SELECT Conecta (:CodigoEmpresa, path_ttsegur) as pConecta, path_ttsegur as pPathSegur
  FROM tt_cfg

CodigoEmpresa: N ? Empresa

2. Gerar Hash da mesma forma como foi feita na assinatura da DAV.

3. Gerar texto a ser criptografado:

SELECT ConcatenaIOR(:CODFIL,
                    :TIPPED,
                    :NUMPED,
                    :NUMITE,
                    :COOVEN) as pTexto
  FROM dual

Parâmetro COOVEN é gravado pelo Checkout. Deve-se passar null.

4. Assinar os dados do item:

SELECT AssinaTab('TT_IOR', 
                 :pTexto,
                 :pConecta IN NUMBER,
                 :pHashConexao IN VARCHAR2,
                 '',
                 :CodigoEmpresa,
                 path_ttsegur)
  FROM tt_cfg

5. Gravar Item da DAV.