Mudanças entre as edições de "Integração DAV via Stored Procedure"

Edição das 15h24min de 3 de dezembro de 2010

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

ENVIA_DAV

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.

ENVIAITEM_DAV

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.

EXCLUIITEM_DAV

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.

VALIDA_DAV

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.

CANCELA_DAV

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.

ASSINA_DAV

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.

Procedimentos para Assinatura

Assinatura de DAV

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

CodigoEmpresa: N ? Empresa

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

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

Para os parceiros, os dois parâmetros NUMPED devem ser exatamente iguais.

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:

CodigoEmpresa: N ? Empresa

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

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

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.