Histórico da Página

...

A API tem como objetivo realizar a geração de um documento no conversor de NF-e (notas fiscais eletrônicas) e se parametrizado, também realizar a efetivação deste documento no recebimento físico ou fiscal.

Funcionamento

A API REP/REAPI320.P recebe como parâmetro um valor lógico para indicar se deve processar a nota para o recebimento, as temp-tables que contem as informações no XML da NF-e e retorna uma temp-table com os erros ocorridos durante esse processo.

O primeiro parâmetro deve conter o valor “NO” quando a nota fiscal deve ser criada no Conversor de NF-e, porém não deve ser efetivado no recebimento. Neste caso a nota ficará como em “Em validação”. Se informado o valor “YES”, a nota será criada no recebimento e a API tentará efetivá-la no recebimento físico ou fiscal (conforme regras estabelecidas para a recepção de NF-e)

Na forma padrão, realiza-se a chamada através de um comando RUN normal, passando-se os parâmetros necessários.

A sintaxe para a chamada da API é:

 RUN rep/reapi320.p (INPUT < YES/NO >, /* YES – Processar o document para o recebimento*/

                     INPUT TABLE tt-doc-orig-nfe,

                     INPUT TABLE tt-doc-orig-duplic-nfe,

                     INPUT TABLE tt-doc-orig-lacre-nfe,

                     INPUT TABLE tt-doc-orig-refer-nfe,

                     INPUT TABLE tt-doc-orig-proc-ref-nfe,

                     INPUT TABLE tt-doc-orig-volume-nfe,

                     INPUT TABLE tt-item-doc-orig-nfe,

                     INPUT TABLE tt-item-doc-orig-adic-nfe,

                     INPUT TABLE tt-item-doc-orig-arma-nfe,

                     INPUT TABLE tt-item-doc-orig-di-nfe,

                     INPUT TABLE tt-item-doc-orig-med-nfe,

                     INPUT TABLE tt-doc-orig-for-dia-cana,

                     INPUT TABLE tt-doc-orig-deduc-cana,

                     INPUT-OUTPUT TABLE tt-erro).

...

sugestão dos CST (Código de Situação Tributária) para os tributos IPI (Imposto Sobre Produto Industrialização), PIS (Programa Integração Social) e COFINS (Contribuição para o Financiamento da Seguridade Social) na entrada de notas fiscais no recebimento.

Ressaltamos que essa funcionalidade está disponível a partir da release 12.1.27 do sistema Datasul.

Funcionamento

A API pode ser executada de várias formas dependendo da necessidade. Por exemplo, se houver a necessidade de se sugerir apenas o CST de um dos tributos, é possível.

Abaixo colocamos a sintaxe para a chamada das procedures da REAPI414, para sugerir o CST de todos os tributos:

RUN rep\reapi414.p PERSISTENT SET h-reapi414.

RUN setTipoNota IN h-reapi414 (INPUT 1). /*1-Entrada, 2-Saida*/
RUN setCodEstabel IN h-reapi414 (INPUT docum-est.cod-estabel).
RUN setCodNatOperacao IN h-reapi414 (INPUT IF item-doc-est.nat-of <> "" THEN item-doc-est.nat-of ELSE item-doc-est.nat-operacao).
RUN setNcm IN h-reapi414 (INPUT item-doc-est.class-fiscal).
RUN setItCodigo IN h-reapi414 (INPUT item-doc-est.it-codigo).
RUN setCodGrupEmit IN h-reapi414 (INPUT emitente.cod-gr-forn).
RUN setCodEmitente IN h-reapi414 (INPUT item-doc-est.cod-emitente).
RUN setDtEmissao IN h-reapi414 (INPUT docum-est.dt-emissao).

RUN calcCSTCD0303 IN h-reapi414.

RUN posicionarRegistros IN h-reapi414 (INPUT ROWID(item-doc-est)).

RUN calcCSTICMS IN h-reapi414.

RUN getCodOrigemItem IN h-reapi414 (OUTPUT c-cod-origem-item).
RUN getCodSitTribICMS IN h-reapi414 (OUTPUT c-cod-sit-tribut-icms).

RUN calcCSTIPI IN h-reapi414 (INPUT item-doc-est.cd-trib-ipi, INPUT item-doc-est.aliquota-ipi).

RUN getCodSitTribIPI IN h-reapi414 (OUTPUT c-cod-sit-tribut-ipi).

RUN getAliqPISCOFINSItDoc IN h-reapi414 (INPUT ROWID(item-doc-est), OUTPUT de-aliq-pis, OUTPUT de-aliq-cofins).
RUN calcCSTPIS IN h-reapi414 (INPUT item-doc-est.idi-tributac-pis, INPUT de-aliq-pis).
RUN calcCSTCOFINS IN h-reapi414 (INPUT item-doc-est.idi-tributac-cofins, INPUT de-aliq-cofins).
RUN getCodSitTribPIS IN h-reapi414 (OUTPUT c-cod-sit-tribut-pis).
RUN getCodSitTribCOFINS IN h-reapi414 (OUTPUT c-cod-sit-tribut-cofins).

DELETE PROCEDURE h-reapi414.

A seguir iremos detalhar a funcionalidade de cada procedure:

setTipoNota

setCodEstabel

setCodNatOperacao

setNcm

setItCodigo

setCodGrupEmit

setDtEmissao

calcCSTCD0303

posicionarRegistros

calcCSTICMS

getCodOrigemItem

getCodSitTribICMS

calcCSTIPI

getCodSitTribIPI

getAliqPISCOFINSItDoc

calcCSTPIS

calcCSTCOFINS

getCodSitTribPIS

getCodSitTribCOFINS

Tabelas Temporárias

Definição das tabelas temporárias de entrada e saída:

DEF TEMP-TABLE tt-doc-orig-nfe                 LIKE doc-orig-nfe.

DEF TEMP-TABLE tt-doc-orig-duplic-nfe      LIKE doc-orig-duplic-nfe.

DEF TEMP-TABLE tt-doc-orig-lacre-nfe        LIKE doc-orig-lacre-nfe.

DEF TEMP-TABLE tt-doc-orig-refer-nfe         LIKE doc-orig-refer-nfe.

DEF TEMP-TABLE tt-doc-orig-proc-ref-nfe    LIKE doc-orig-proc-ref-nfe.

DEF TEMP-TABLE tt-doc-orig-volume-nfe     LIKE doc-orig-volume-nfe.

DEF TEMP-TABLE tt-item-doc-orig-nfe          LIKE item-doc-orig-nfe.

DEF TEMP-TABLE tt-item-doc-orig-adic-nfe  LIKE item-doc-orig-adic-nfe.

DEF TEMP-TABLE tt-item-doc-orig-arma-nfe LIKE item-doc-orig-arma-nfe.

DEF TEMP-TABLE tt-item-doc-orig-di-nfe      LIKE item-doc-orig-di-nfe.

DEF TEMP-TABLE tt-item-doc-orig-med-nfe  LIKE item-doc-orig-med-nfe.

DEF TEMP-TABLE tt-doc-orig-for-dia-cana    LIKE doc-orig-for-dia-cana.

DEF TEMP-TABLE tt-doc-orig-deduc-cana    LIKE doc-orig-deduc-cana.

DEF TEMP-TABLE tt-erro NO-UNDO

    FIELD identif-segment AS CHAR

    FIELD cd-erro         AS INTEGER

    FIELD desc-erro       AS CHAR FORMAT "x(80)".