SpedFiscalPisCofinsAdicionaRegistro0200

Tipo de Retorno

Boolean

Pacote

A função SpedFiscalPisCofinsAdicionaRegistro0200 está defiinida no pacote SpedFiscalPisCofinsAdicionaRegistro0200.pkg.

Para que serve

A função SpedFiscalPisCofinsAdicionaRegistro0200 é usada para fazer a adição de um registro 0200 no vetor de registros 0200. Ela irá verificar se já existe um registro 0200 com o mesmo valor de campo COD_ITEM. Se não houver, irá acrescentar o novo registro no array. Se já existir, o que fará depende dos parâmetros informados.

Sintaxe

Move (SpedFiscalPisCofinsAdicionaRegistro0200({vtRegistro0200Adicionar}, ;
(&{vtRegistros0200}, {bPISCOFINS}, {bExibeErro}, ;
(&{sMsgErro}))) to {bRetorno}

Onde:

  • {vtRegistro0200Adicionar} é uma variável do tipo tSpedFiscalPisCofinsRegistro0200 com o novo registro que será adicionado em vtRegistros0200.
  • &{vtRegistros0200} é uma variável do tipo tSpedFiscalPisCofinsRegistro0200[] que precisa ser passada via referência. Esta variável do tipo array, contém todos os registros 0200 já acrescentados na estrutura do arquivo que está sendo gerado.
  • {bPISCOFINS} é usado para indicar para a função qual é o tipo de arquivo que deve ser gerado:
    • True: será gerado o arquivo do EFD-Contribuições.
    • False: será gerado o arquivo do Sped Fiscal.

Se este parâmetro for True, quando já existe um registro com o mesmo valor de COD_ITEM do registro que está sendo adicionado, a função não fará mais nada, pois o Sped Fiscal-PIS/COFINS não prevê a geração dos registros 0220 de fatores de conversão.

Se este parâmetro for False, quando já existe um registro com o mesmo valor de COD_ITEM do registro que está sendo adicionado, a função irá verificar se há os registros 0220 passados e adicionará aqueles que ainda não existem.

  • {bExibeErro} é usado para indicar se a função deve exibir ou não os erros que ocorrerem na execução.
  • &{sMsgErro} é uma variável do tipo String que precisa ser passada via referência. No caso de ocorrer algum erro durante a execução a função devolverá nesta variável a mensagem do erro ocorrido.
  • &{sCOD_ITEMs} é uma variável do tipo String[] que precisa ser passada por referência. Este parâmetro é opcional, mas sua utilização é extremamente recomendada, pois irá melhorar em muito a performance desta função. A primeira vez que a função for chamada, esta variável estará "limpa". A cada chamada, a função irá adicionar o valor do COD_ITEM dos registros que forem adicionados. Desta forma, internamente, a função irá verificar se um registro já está ou não no array de registros 0200 consultando somente esta variável. A consulta desta variável é muito mais rápida do que consultar o array. Portanto, você deve manter o valor desta variável inalterado do início da geração até o final da geração do arquivo. No caso do Sped Fiscal-PIS/COFINS, a variável terá de ser reinicializada sempre que mudar o registro 0140, que é pai dos registros 0200.
  • {bRetorno} indica se a função foi executada com sucesso (True) ou não (False).

Exemplo

 SpedFiscalPisCofinsAdicionaRegistro0200

O exemplo acima contém particularidades específicas do sistema onde foi implementado para chegar à informação desejada. O objetivo do exemplo é mostrar o preenchimento da estrutura vtRegistro0200 e a chamada da função.

Observações

  • Para que esta função funcione, todos os registros 0200 devem ser adicionados através de sua utilização.
  • Veja mais detalhes sobre o processo completo de geração do arquivo em "Gerando o arquivo".