Árvore de páginas

Documento de API

Produto:

Datasul

Ocorrência:

Documentação de API

Nome Físicoexp/exapi023.p

 

Considerações Gerais

 

Objetivo

Realizar a busca das informações das Comissões de Representantes calculadas no Contas a Receber para os títulos do módulo de Exportação do COMEX..

 

Funcionamento

A API irá receber como parâmetros as informações referentes à empresa do estabelecimento, e chave da tabela de Faturas da Nota Fiscal de Exportação e irá retornar a temp-table “tt-dados-comissao”.

 

A sintaxe para sua execução é realizada conforme abaixo:

 

run exp/exapi023.p (input i-empresa,

                                 input fat-duplic.cod-estabel,

                                 input fat-duplic.cod-esp,

                                 input fat-duplic.serie,

                                 input <número_fatura>,

                                 input string(fat-duplic),

                                 output table tt-dados-comissao).

 

Importante: <número_fatura>

Com relação ao número da fatura, passado como parâmetro para a EXAPI023, caso o cliente gere o Título no Contas a Receber pelo Número do Processo de Exportação, deverá ser passado como parâmetro o número do Processo de Exportação. Caso contrário deve passar o próprio número da fatura.

 

Importante 2: fat-duplic.cod-esp

Sobre a Espécie da Fatura, em situações que o Cliente realize a contabilização do módulo de Exportação pela data do embarque, e log de Geração do Título no Contas a Receber estiver Processado com Sucesso, deverá passar como parâmetro a Espécie de Exportações não embarcadas existente no programa EX0180.

Caso o log de Geração de Título no Contas a Receber ainda não estiver Processado com Sucesso, deverá passar como parâmetro a Espécie da fatura;

 

Tabelas Temporárias

 

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

tt-dados-comissao

Entrada/Saída

Temp-table contendo os dados da Comissão do Representante dos Títulos de Exportação do COMEX

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

cdn_motiv_movto_comis    

Inteiro  

>>>9               Inicial 0           

Código Motiv Movto

 

 

cdn-repres               

Inteiro  

>>>,>>9            Inicial 0           

Representante    

 

 

cod_empresa              

Caracter

x(3)                                   

Empresa          

 

 

cod-espec-docto-cr       

Caracter

x(3)                                   

Espécie Documento

 

 

cod-estab-cr             

Caracter

x(5)                                   

Estabelecimento  

 

 

cod_estab_tit_ap         

Caracter

x(5)                                   

Estabel APB      

 

 

cod-moeda                

Caracter

x(8)                                   

Moeda            

 

 

cod_livre_1              

Caracter

x(100)                                 

Livre 1          

 

 

cod_livre_2              

Caracter

x(100)                                 

Livre 2          

 

 

cod-parcela-cr           

Caracter

x(02)                                  

Parcela          

 

 

cod_refer                

Caracter

x(10)                                  

Referência       

 

 

cod-ser-docto-cr         

Caracter

x(3)                                   

Série Documento  

 

 

cod-tit-acr              

Caracter

x(10)                                  

Título           

 

 

cod_unid_negoc           

Caracter

x(3)                                   

Unid Negócio     

 

 

cod_usuario              

Caracter

x(12)                                  

Usuário          

 

 

dat_atualiz_movto_comis  

Data     

99/99/9999         Inicial today       

Atualização Movto

 

 

dat_emis_docto           

Data     

99/99/9999         Inicial today       

Data  Emissão    

 

 

dat_gerac_movto          

Data     

99/99/9999         Inicial today       

Data Geração Movto

 

 

dat_livre_1              

Data     

99/99/9999         Inicial ?           

Livre 1          

 

 

dat_livre_2              

Data     

99/99/9999         Inicial ?           

Livre 2          

 

 

dt-trans                 

Data     

99/99/9999         Inicial today       

Data Transação   

 

 

dat_trans_origin         

Data     

99/99/9999         Inicial today       

Dt Trans Original

 

 

des_histor_movto_comis   

Caracter

x(40)                                  

Histórico        

 

 

hra_gerac_movto          

Caracter

99:99:99                               

Hora Geração Movto

 

 

natureza                 

Caracter

X(02)              Inicial "DB"        

Natureza         

 

 

orig-movto               

Caracter

X(10)              Inicial "Sistema"   

Origem Movto     

 

 

situacao                 

Caracter

X(18)              Inicial "Liberado"  

Situação         

 

 

comis-ext                

Caracter

X(15)              Inicial "Nenhum"    

Tipo Comis Externo

 

 

tipo                     

Caracter

X(20)                                  

Tipo Movimento   

 

 

ind_trans_acr            

Caracter

X(29)              Inicial "Implantação"

Transação        

 

 

trans-comis              

Caracter

X(40)                                  

Transação Comissão

 

 

log_consid_movto_pagto   

Lógico  

Sim/Não            Inicial yes         

Considera Pagto  

 

 

log_estorn_comis_atraso  

Lógico  

Sim/Não            Inicial no          

Estorno Atraso   

 

 

log_livre_1              

Lógico  

Sim/Não            Inicial no          

Livre 1          

 

 

log_livre_2              

Lógico  

Sim/Não            Inicial no          

Livre 2          

 

 

envdo                    

Lógico  

Sim/Não            Inicial no          

Enviado          

 

 

nom_abrev                

Caracter

x(15)                                  

Nome Abreviado   

 

 

num_id_movto_tit_acr     

Inteiro  

9999999999         Inicial 0           

Token Movto Tit  AC

 

 

num_id_tit_acr           

Inteiro  

9999999999         Inicial 0           

Token Cta Receber

 

 

num_id_tit_ap            

Inteiro  

9999999999         Inicial 0           

Token Tit AP     

 

 

num_id_tit_ap_prev       

Inteiro  

9999999999         Inicial 0           

Id Titulo APB Prev

 

 

num_livre_1              

Inteiro  

>>>>>9             Inicial 0           

Livre 1          

 

 

num_livre_2              

Inteiro  

>>>>>9             Inicial 0           

Livre 2          

 

 

num-proces               

Inteiro  

>>>>,>>9           Inicial 0           

Nro Proces Integr

 

 

num_seq_movto_comis      

Inteiro  

>>>>,>>9           Inicial 0           

Sequência        

 

 

val-base-calc-comis      

Decimal  

>>>,>>>,>>9.99     Inicial 0           

Base Calc Comis  

 

 

val_livre_1              

Decimal  

>>>,>>>,>>9.9999   Inicial 0           

Livre 1          

 

 

val_livre_2              

Decimal  

>>>,>>>,>>9.9999   Inicial 0           

Livre 2          

 

 

valor                    

Decimal  

->>,>>>,>>>,>>9.99 Inicial 0           

Valor Movimento  

 

 

ttv_rec_movto_comis_repres

recid    

>>>>>>9            Inicial ?             

                   

 

 

cdn-cliente-cr           

Inteiro  

>>>,>>>,>>9        Inicial 0             

Cliente          

 

 

nome-cliente-cr          

Caracter

x(40)                                    

Nome Cliente     

 

 

nome-repres              

Caracter

x(15)                                    

Nome Representante

 

 

val-perc-comis-repres    

Decimal  

>>9.99 Decimais 2  Inicial 0             

% Comissão       

 

 

impresso

Lógico

                                           

                   

 

 

 

Índice: tt_id                      is primary unique

              cod_empresa                ascending        

              cdn-repres                 ascending        

              ttv_rec_movto_comis_repres as