Documento de API

Objetivo: Esta API será executada na cdapi184.p. Seu objetivo é fazer a leitura das tabelas Ordem de Compra, Cotação Item e Prazo de Compra.

Definição Temp-Table:

def temp-table tt-retorno-bgc no-undo

    field funcao               as char    format "x(20)"

    field empresa            as integer format ">>9"

    field conta-contabil    as char    format "x(17)"

    field cod-estabel        as char    format "x(03)"

    field data-entrega      as date    format "99/99/9999"

    field finalidade          as integer format ">9"

    field valor-movto        as decimal format ">>>>>,>>>,>>9.99999"

    field quantidade        as integer format ">>>>,>>9.9999"

    field origem              as integer format ">9"

    field id-movto            as char    format "x(40)"

    FIELD cod-unid-negoc AS CHAR    FORMAT "x(3)".

Considerações Gerais:

-       Devem ser passados 2 (dois) campos de rowid, referente as tabelas, ordem-compra e cotação-item, respectivamente, e 1 (uma) temp-table de saída com informações para a Execução Orçamentária.

-    A temp-table é passada como parâmetro através do comando OUTPUT TABLE.

 Exemplo:  run ccp/ccapi320.p (Input r-rowid-ordem,

                             Input r-rowid-cotacao,

                             Output table tt-retorno-bgc).

-       A API funciona da seguinte forma: Recebe os parâmetros, faz a busca nas tabelas a partir do rowid passado como parâmetro e retorna a tt-retorno-bgc com as informações necessárias de Materiais.

-       Essa API será executa somente a partir de um ponto específico dentro da cdapi184.p.

-    A partir da release 2.062 um novo campo foi adicionado a temp-table tt-retorno-bgc.

O campo cod-unid-negoc receberá o código da unidade de negócio localizado no:

 à Item da Requisição (it-requisicao.cod-unid-negoc) ou;

 à Unidade de Negócio da Requisição (unid-neg-requis.cod_unid_neg) ou;

 à Ordem de Compra (ordem-compra.cod-unid-negoc) ou;

 à Unidade de Negócio da Ordem de Compra (unid-neg-ordem.cod_unid_neg).

Além disso, na atualização dos campos valor-movto e quantidade deve considerar o percentual da unidade de negócio através dos campos (unid-neg-requis.perc-unid-neg ou unid-neg-ordem.perc-unid-neg) quando existir, caso contrário aplicar 100%.

-    A tt-retorno-bgc retorna os seguintes campos:

tt-retorno-bgc.funcao         (Estorna / Verifica e Atualiza)

tt-retorno-bgc.empresa        (ordem-compra.ep-codigo)

tt-retorno-bgc.conta-contabil (ordem-compra.conta-contabil)

tt-retorno-bgc.cod-estabel    (ordem-compra.cod-estabel)

tt-retorno-bgc.data-entrega   (prazo-compra.data-entrega)

tt-retorno-bgc.finalidade     (ordem-compra.mo-codigo)

tt-retorno-bgc.valor-movto    (prazo-compra.quantidade * cotacao-item.preco-fornec)

tt-retorno-bgc.quantidade     (0)

tt-retorno-bgc.origem         (7 / 18)

tt-retorno-bgc.id-movto       ( string(ordem-compra.nr-requisicao) + chr(10) +

                          string(ordem-compra.sequencia)     + chr(10) +

                                ordem-compra.it-codigo /

                                string(prazo-compra.numero-ordem) + chr(10) +

                                string(prazo-compra.parcela) )

tt-retorno-bgc.cod-unid-negoc (código da unidade de negócio)