Árvore de páginas

Versões comparadas

Chave

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

...

Definição dos Parâmetros Recebidos:

 

def var v_num_vers_integr_api as integer   format ">>>>,>>9" no-undo.
def var v_cod_empresa         as character format "x(03)"    no-undo.
def var v_cod_empresa_ext     as character format "x(03)"    no-undo.
def var v_cod_estab           as character format "x(03)"    no-undo.
def var v_cod_estab_ext       as character format "x(08)"    no-undo.
def var v_num_dias_max_atr    as integer   format ">>>9"     no-undo.
def var v_num_dias_max_atr_ad as integer   format ">>>9"     no-undo.

Tabelas Temporárias

Nos atributos das tabelas temporárias de entrada e saída:

...

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

cod-emitente

integer

>>>>>>9

Atributo Chave no qual será feita a pesquisa dos Saldos no EMS5. Poderá ser feita em todas as Empresas/Estabelecimentos conforme parametrização especificada. O Código do Emitente (utilizado no EMS2) deve ser compatível com o Código do Cliente (utilizado no EMS5), ou seja, deve existir a Integração Cliente/Fornecedor EMS2 x EMS5.

Sim

 

nome-abrev

character

x(12)

Esse Atributo não é utilizado na API, usado apenas no programa CDAPI013 do EMS2 (caso a API seja chamada por outro programa, não existe a necessidade deste atributo ser preenchido.

Não

 

nr-mesina

integer

>9

Mesmo caso que o citado acima.

Não

 

cod-gr-cli

integer

>9

Mesmo caso que o citado acima.

Não

 

nr-peratr

integer

>9

Mesmo caso que o citado acima.

Não

 

nr-cheque-devol

integer

>>9

Atributo utilizado para comparar o número máximo de cheques devolvidos (caso o número real de cheques devolvidos no período compreendido por qtd-dias seja maior ou igual ao nr-cheque-devol, a API retornará ERRO!

(conforme EMS2, se emitente.nr-cheque-devol = 0

então nr-cheque-devol = param-ped.nr-cheque-devol

senão nr-cheque-devol = emitente.nr-cheque-devol)

Sim

 

qtd-dias

integer

>>9

Atributo utilizado para indicar o número de dias à considerar na Análise de Número/Valor Total de Cheques Devolvidos (conforme EMS2,

se emitente.periodo-devol = 0

então qtd-dias = param-ped.periodo-devol

senão qtd-dias = emitente.periodo-devol)

Sim

 

vl-max-devol

decimal

>>>,>>>,>>9.99

Atributo utilizado para comparar o valor total em moeda de cheques devolvidos (caso o número valor total de cheques devolvidos no período compreendido por qtd-dias seja maior ou igual ao vl-max-devol, a API retornará ERRO! (conforme EMS2, se emitente.vl-max-devol = 0

Então vl-max-devol = param-ped. vl-max-devol

senão vl-max-devol = emitente. vl-max-devol)

Sim

 

moeda-credito

integer

>9

Atributo que contém a moeda externa na qual devem ser retornados os valores da Análise de Crédito para determinado emitente.

Sim

 

de-saldo-cr

decimal

->>>,>>>,>>>,>>9.99

Retorna o Saldo em Aberto (Saldo Total - Antecipação) ACR

Não

 

de-saldo-ap

decimal

->>>,>>>,>>>,>>9.99

Retorna o Saldo em Aberto (Saldo Total - Antecipação) APB

Não

 

de-tot-tit-atr-cr

decimal

>>>,>>>,>>>,>>9.99

Retorna o Saldo em Aberto Atrasado

Não

 

de-tot-ad-cr

decimal

>>>,>>>,>>>,>>9.99

Retorna o Total de Aviso de Débito ACR em Atraso

Não

 

de-cr-ant-aberto

decimal

>>>,>>>,>>>,>>9.99

Retorna o Total de Antecipações em Aberto ACR

Não

 

de-ap-ant-aberto

decimal

>>>,>>>,>>>,>>9.99

Retorna o Total de Antecipações em Aberto APB

Não

 

 

define temp-table tt-emitente no-undo
    field cod-emitente      as integer   format ">>>>>>9"
    field nome-abrev        as character format "x(12)"
    field nr-mesina         as integer   format ">9"
    field cod-gr-cli        as integer   format ">9"
    field nr-peratr         as integer   format ">9"
    /* ****    Atributos utilizados na integra‡Æo com o EMS 5.0     *****/
    field nr-cheque-devol   as integer   format ">>9"                 /* Número de Cheques Devolvidos */
    field qtd-dias          as integer   format ">>9"
    field vl-max-devol      as decimal   format ">>>,>>>,>>9.99"      /* Valor Máximo do Total de Cheques Devolvidos */
    field moeda-credito     as integer   format ">9"
    field de-saldo-cr       as decimal   format "->>>,>>>,>>>,>>9.99" /* Saldo em Aberto (Saldo Total - Antecipa‡Æo) ACR */
    field de-saldo-ap       as decimal   format "->>>,>>>,>>>,>>9.99" /* Saldo em Aberto (Saldo Total - Antecipa‡Æo) APB */
    field de-tot-tit-atr-cr as decimal   format ">>>,>>>,>>>,>>9.99"
    field de-tot-ad-cr      as decimal   format ">>>,>>>,>>>,>>9.99"  /* Total de Aviso de D‚bito ACR */
    field de-cr-ant-aberto  as decimal   format ">>>,>>>,>>>,>>9.99"  /* Total de Antecipaçäes em Aberto ACR */
    field de-ap-ant-aberto  as decimal   format ">>>,>>>,>>>,>>9.99"  /* Total de Antecipaçäes em Aberto APB */
    index cod-emitente is primary cod-emitente.

 

Tabela Temporária

Descrição

Entrada/Saída

tt-erros-analise-credito

Conterá as informações dos erros gerados na Análise de Crédito.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

cod-emitente

integer

>>>>>>9

Retorna o Código do Emitente em que ocorreu o erro. (Caso retorne “”, significa que o erro não é referente ao Emitente.

 

 

cod-mensagem

integer

>>>>,>>9

Retorna o Código da Mensagem.

 

 

des-msg

character

x(50)

Retorna a Descrição da Mensagem.

 

 

help-msg

character

x(50)

Retorna a Ajuda da Mensagem.

 

 

 

def temp-table tt-erros-analise-credito no-undo
    field cod-emitente      as integer   format ">>>>>>9"
    field cod-mensagem      as integer   format ">>>>,>>9"
    field des-msg           as character format "x(50)"  
    field help-msg          as character format "x(50)".

 

Possíveis erros que podem retornar da API de Análise de Crédito

MENSAGENS DE ERRO

 360

Tradução da Empresa &1 não encontrada na Matriz &2 !

 735

Tipo de Unidade Organizacional Estabelecimento Desconhecido!

1733

Empresa Externa informada não possui Tradução!

4315

Estabelecimento informado não foi encontrado!

4672

Estabelecimento Externo não possui Tradução!

6783

Empresa informada não foi encontrada!

8239

Versão da API de Integração é inválida!

8877

A Matriz de Tradução informada nos parâmetros gerais de integração (Análise Crédito 2.00) é inválido!

8878

Não existe Integração de Análise Crédito 2.00! É necessário criar a integração através dos Parâmetros Gerais de Integração.

8882

Número/Valor Total de Cheques Devolvidos ultrapassou o limite!

8884

Emitente não foi informado! Pelo menos um Emitente é necessário para fazer a Análise de Crédito

...

Observações

  • Caso não seja informado a Empresa, Empresa Externa, Estabelecimento e Estabelecimento Externo, será feita a Análise de Crédito em todas as Empresas/Estabelecimentos existentes no EMS5.
  • Caso seja informado o Estabelecimento, serão desconsiderados os valores informados para Empresa, Empresa Externa e Estabelecimento Externo, ou seja, a Análise de Crédito será verificada apenas para o Estabelecimento informado, na sua respectiva Empresa.
  • Caso seja informado o Estabelecimento Externo (e não seja informado o Estabelecimento), serão desconsiderados os valores informados para Empresa e Empresa Externa. Através da Matriz de Tradução informada na integração de Análise Crédito 2.00 (integração criada através dos Parâmetros de Integração do EMS), será feita a Análise de Crédito apenas para o Estabelecimento correspondente, na sua respectiva Empresa.
  • Caso seja informado a Empresa (e não seja informado o Estabelecimento e Estabelecimento Externo) será desconsiderado o valor informado para Empresa Externa, ou seja, será feita a Análise de Crédito com base em todos os Estabelecimentos  da Empresa informada.
  • Caso seja informado a Empresa Externa (e não seja informado a Empresa, o Estabelecimento e o Estabelecimento Externo), através da Matriz de Tradução informada na integração de Análise Crédito 2.00 (criada através dos Parâmetros de Integração do EMS), será feita a Análise de Crédito com base em todos os Estabelecimentos da Empresa correspondente.
  • O cliente teve ter cadastrado o parâmetro de integração 'Análise de Crédito'.

...