Linha Datasul

Árvore de páginas

Linha de Produto:

Datasul

Módulo:

MEX

Função:

Importação/exportação de notas fiscais referenciadas para itens da DU-E

Nome Físicoexp/exapi027.p

Considerações gerais


Objetivo 

Realizar a importação / exportação das informações das notas fiscais referenciadas dos itens da DU-E.

Funcionamento 

A API deve ser executada de forma persistente. Isso deve ser feito através da chamada de um comando RUN conforme exemplo a seguir.

A sintaxe para executar a API em modo persistente é: 

RUN exp/exapi027.p PERSISTENT SET h-handle.

A variável denominada h-handle irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da API.

 

Método Negócio 

Quando a API for executada em modo persistente, os seguintes métodos estarão disponíveis para execução: 


pi-exporta

Requisito

DU-E cadastrada no sistema com itens.

Sintaxe

RUN pi-exporta in handle (INPUT <character>,

                                          INPUT TABLE <tt-due-item>,

                                          OUTPUT TABLE <RowErrors>).

Descrição

Realiza a exportação das informações das notas fiscais referenciadas dos itens da DU-E no formato CSV.

  • Gera um arquivo no formato TXT (padrão CSV com separador ";") no diretório informado no parâmetro de entrada c-arquivo-exportado.

Parâmetros

Descrição

c-arquivo-exportado

Caminho e nome do arquivo exportado que contém as informações do processamento realizado.

tt-due-itemTemp-table com as informações dos itens da DU-E
RowErrorsTemp-table com os erros do processamento

Retorno

Temp-table com os erros do processamento.

pi-importa

Requisito

DU-E cadastrada no sistema com itens.

Sintaxe

RUN pi-importa in handle (INPUT <character>,

                                          INPUT TABLE <tt-due-item>,

                                          OUTPUT TABLE <RowErrors>).

Descrição

Realiza a importação das informações das notas fiscais referenciadas dos itens da DU-E no formato csv.

  • A extensão do arquivo pode ser CSV ou TXT
  • Faz as validações das informações importadas
  • Realiza a importação das informações
  • Gera um arquivo CSV com o resultado do processamento (Importado com sucesso, ou os erros que ocorreram durante o processamento)

Parâmetros

Descrição

c-arquivo-importado

Caminho e nome do arquivo a ser importado que contém as informações que serão processadas.

tt-due-itemTemp-table com as informações dos itens da DU-E e suas notas fiscais referenciadas
RowErrorsTemp-table com os erros do processamento

Retorno

Temp-table com os erros do processamento.


Tabelas temporárias


tt-due-itemEntrada/Saída
Temp-table contendo os dados dos itens da DU-E e suas notas fiscais referenciadasEntrada
AtributoTipoFormatoDescriçãoObrigatórioEvolução
cdd-due-ems    decimal>>>>>>>>>>>>>>>9Número Interno DU-ESim
num-versao-dueinteger>>>>,>>9Número Versão DU-ENão
num-seq-it-dueinteger>>9Sequência do Item na DU-ESim
cod-estabel-nfcharacterx(5)Estab NFSim
cod-serie-nfcharacterx(5)Série Nota Fiscal      Sim
cod-nota-fisccharacterx(16)Nr Nota Fiscal         Sim
num-seq-faturaminteger>>,>>9Sequencia Faturamento  Sim
cod-itemcharacterx(16)Item                   Sim
cdn-emitenteinteger>>>>>>>>9Exportador             Sim
cdn-destaqueinteger99999Destaque NCM           Não
idi-tratam-prioritinteger>9Tratamento Prioritário  Não
des-compl-itemcharacterx(255)Descrição Compl Mercad  Não
cod-un-estatischaracterxxUnidade de Medida Estatística  Não
qtd-estatisdecimal>>>,>>>,>>>,>>9.99999Quantidade Estatística  Não
val-peso-liq-itemdecimal>>>,>>>,>>>,>>9.99999Peso Líquido (KG)       Sim
cod-incotermcharacterX(3)Código Condição de Venda  Não
val-cond-vdadecimal>>>,>>>,>>>,>>>,>>9.99999Valor Mercadoria Cond   Não
val-local-embarqdecimal>>>,>>>,>>>,>>>,>>9.99999Valor Mercadoria Local  Não
val-perc-comis-agentdecimal>>9.99% Comissão Agente       Não
cod-enquad-1integer>>,>>9Primeiro Enquadramento  Não
cod-enquad-2integer>>,>>9Segundo Enquadramento   Não
cod-enquad-3integer>>,>>9Terceiro Enquadramento  Não
cod-enquad-4integer>>,>>9Quarto Enquadramento    Não
qtd-diasdecimal>>,>>9Quantidade de Dias      Não
cod-procescharacterx(20)Processo Exportação Não
cod-pais-dest-finalcharacterx(02)Pais de Destino         Não
qtd-estatis-pais-destdecimal>>>,>>>,>>>,>>9.99999Qtde Estatística Pais   Não
des-justif-valorescharacterx(2000)Justificativa Valores   Não
cod-estab-proces-exportcharacterx(5)Estab Proc Exp          Não
cod-proces-exportcharacterx(12)Processo Exportação     Não
cod-livre-1characterx(500)Livre 1                 Não
cod-livre-2characterx(500)Livre 2                 Não
dat-livre-1date99/99/9999Livre 1                 Não
dat-livre-2date99/99/9999Livre 2                 Não
log-livre-1logicalSim/NãoLivre 1                 Não
log-livre-2logicalSim/NãoLivre 2                 Não
num-livre-1integer>>>>>>>>9Livre 1                 Não
num-livre-2integer>>>>>>>>9Livre 2                 Não
val-livre-1decimal->>>>>>>>>>>9.99999999Livre 1                 Não
val-livre-2decimal->>>>>>>>>>>9.99999999Livre 2                 Não

RowErrors

Entrada/Saída

Erros ocorridos durante a execução do programa.

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

ErrorSequence  

INTEGER 


Sequência

Sim


ErrorNumber    

INTEGER 


Número

Sim


ErrorDescription

CHARACTER


Descrição

Não


ErrorParameters

CHARACTER


Parãmetros

Não


ErrorType      

CHARACTER


Tipo de erro

Não


ErrorHelp      

CHARACTER


Texto de ajuda

Não


ErrorSubType   

CHARACTER


Sub-tipo do erro

Não



Formato do arquivo importado/exportado

O arquivo exportado será um arquivo com a extensão TXT no padrão CSV (separador ";").

O arquivo importado será um arquivo com a extensão TXT ou CSV no padrão CSV (separador ";").

Obs: a primeira linha importada/exportada contém os labels dos campos. 

Ex: Nro Interno DU-E;DU-E Siscomex;Estab NF Fatura;Série NF Fatura;Nro Fatura;Seq It Fatura;Código It Fatura;Peso Fiscal Item Fatura (KG);Peso Físico Item Fatura (KG);Estab NF Refer;Série NF Refer;Nro NF Refer;Emitente NF Refer;Nat NF Refer;Seq NF Refer;Unidade Estatística;Qtde Associada (Unidade Estatística);


Nro Interno DU-EDU-E SiscomexEstab NF FaturaSérie NF FaturaNro FaturaSeq It FaturaCódigo It FaturaPeso Fiscal Item Fatura (KG)Peso Físico Item Fatura (KG)Estab NF ReferSérie NF ReferNro NF ReferEmitente NF ReferNat NF ReferSeq NF ReferUnidade EstatísticaQtde Associada (Unidade Estatística)Mensagem importação