Tempo aproximado para leitura: 8 minutosÍNDICE
01. VISÃO GERAL
A rotina realiza a importação de arquivos da Software Express e das adquirentes Amex, Cielo e Rede para conciliação de vendas e pagamentos.
Atualmente temos os seguintes layouts homologados para importação:
Layout: - Documentação Versão homologada até o momento: 3.6 Especificacao_arquivo_retorno_detalhado.3.6.pdf
Estrutura do Layout
- Registro 0 – Header
- Registro 1 – Detalhes Venda
- Registro 8 – Detalhes Rejeitado (Registro não processados pela rotina de importação - FINA914)
- Registro 10 – Detalhes Crédito
- Registro 2 – Ajustes (Registro não processados pela rotina de importação - FINA914)
- Registro 100 – Lote de Antecipação
- Registro 200 – Transações Antecipadas
- Registro 9 – Trailer
Obs: O arquivo para ser importado pela rotina FINA914 é obtido pelo site SiteWeb onde é possível escolher as informações que serão geradas no arquivo, mas como o arquivo com extensão .CSV não possui identificador de colunas, não recomendamos que seja realizada qualquer tipo de alteração no layout, pois poderá ocasionar problemas na importação/conciliação.
Importante
A funcionalidade de Conciliação de Pagamentos efetuados via PIX, foi liberada à partir da Expedição Contínua do módulo Financeiro com data posterior à 28/10/22 na versão 12.1.33 (e posteriores).
02. PRÉ-REQUISITO
O funcionamento da rotina Importação (FINA914) depende do prévio cadastro dos diretórios que vão armazenar os arquivos que serão importados, que foram importados com sucesso e as importações que tiveram falha em seu resultado. O cadastro de diretório para ter esse controle é realizado a partir da rotina Código Administradores SITEF (LOJA075) e se faz necessário apenas para as adquirente homologadas (Amex, Cielo e Rede) e para importação dos arquivos gerados pela Software Express.
Arquivo de Log para avaliação de divergências.
Campos importantes para serem cadastrados para o uso da rotina Importação (FINA914):
Dir.Arq.Tef: indica o diretório onde o arquivo será lido.
Dir.Arq.Proc: indica o diretório onde o arquivo será movido após o processamento com sucesso.
Dir.Inc.Proc: indica o diretório onde o arquivo será movido após o processamento com falha.
Tipo Retorno: RD - Rede (utilizar sempre essa opção para o correto funcionamento da rotina de importação)
Descrição: Utilizar letras maiúsculas para o Cadastro da Administradora, se não existir na base de dados.
Outro pré-requisito importante é o cadastro das filiais que permitirão a importação de arquivos para conciliação.
Para mais informações acesse o documento de referência a partir do link FINA913 - Filiais a Considerar
03. EXEMPLO DE UTILIZAÇÃO
- Ao acessar a rotina Importação clicar em TEF
- Tela de importação dos arquivos de pagamento/vendas das Operadoras / Administradoras.
- Detalhe dos diretórios de onde os arquivos serão lidos.
A importação não leva em consideração a filial em que está sendo feito o processo, visto que os arquivos podem conter mais de um estabelecimento. Sendo assim o controle de filiais é independente do compartilhamento da tabela em questão.
- Após a importação será detalhado um log de críticas por arquivo, sendo possível a identificação de problemas.
Descrição das colunas:
As Legendas possíveis para essa tela, o texto do campo Status segue os detalhes da legenda
Nome do arquivo: Detalha o arquivo que foi importado. (O nome do arquivo é usado como forma de controle para evitar duplicidade de processamento)
Data Processamento: Data em que foi feita a operação
Hora Processamento: Hora em que foi feita a operação
Reg. Incluído: Quantidade de registro incluídos na tabela de controle de vendas/pagamentos. (Dependendo do layout/operadora podemos ter conjuntos de linhas para formar uma venda/pagamento)
Não Processa: Quantidade de linhas que não foram processadas por problemas/críticas.(Detalhe desses processamento pode ser avaliado através do log de importação - FINA917)
Linhas lidas: Quantidade de linhas lidas, soma de todas as linha avaliadas pelo programa, considerando inclusive o header, trailer ou qualquer outra linha que não seja processada pela rotina.
Tot Lin Arq: Total de linhas do arquivo, refere-se a soma das linhas não processadas com as linhas lidas.
Cod. Usuário: Código do usuário que fez o processo de importação.
Cod. Adm: Código da Administradora/Operadora envolvida na operação. (De acordo com a pasta em que o arquivo foi disponibilizado é definida essa informação)
04. PARÂMETROS
Importante
O parâmetro obrigatoriamente precisa ser configurado exclusivo por filial e o conteúdo do parâmetro contendo o código da loja cadastrada na maquininha de passar o cartão para que a importação faça a gravação dos campos Filial TEF (FIF_CODFIL) e Loja SITEF (FIF_CODLOJ) para posterior conciliação na respectiva filial de inclusão do título.
Obs: O número/código de estabelecimento que é o cadastro que identifica uma empresa em cada adquirente, e que são configurados nos parâmetros: MV_EMPTCIE, MV_EMPTAME, MV_EMPTRED, MV_FCONCSE deve obrigatoriamente respeitar a configuração de um CNPJ por Filial. O produto padrão (Protheus) não atende a configuração de mais de um código de estabelecimento para a mesma filial (CNPJ)
| Nome da Variável | MV_EMPTEF |
|---|---|
| Tipo | Caractere |
| Descrição | Código do estabelecimento para importação do arquivo TEF Software Express. |
| Valor Padrão |
| Nome da Variável | MV_EMPTCIE |
|---|---|
| Tipo | Caractere |
| Descrição | Código do estabelecimento para importação do arquivo TEF Cielo. |
| Valor Padrão |
| Nome da Variável | MV_EMPTAME |
|---|---|
| Tipo | Caractere |
| Descrição | Código do estabelecimento para importação do arquivo TEF Amex. |
| Valor Padrão |
| Nome da Variável | MV_EMPTRED |
|---|---|
| Tipo | Caractere |
| Descrição | Código do estabelecimento para importação do arquivo TEF Rede. |
| Valor Padrão |
| Nome da Variável | MV_FCONCSE |
|---|---|
| Tipo | Caractere |
| Descrição | Define os modos de conciliação da Software Express onde .T. = Venda e Pagamento ou .F. = Só Conciliação de Pagamento (default) |
| Valor Padrão | .F. |
05. PONTOS DE ENTRADA
Pontos de entrada utilizados no processo de importação do arquivo de pagamento (Especifico Software Express)
- FINFIF - Permite a inclusão de campos no momento da importação do arquivo Software Express
Documento de apoio: FINFIF
- FIN910FIL - Permite alterar o conteúdo do campo filial no momento da importação do arquivo Software Express
Documento de apoio: FIN910FIL
06. TABELAS UTILIZADAS
- FIF - Arquivo de Conciliação
- MDE - Códigos de Retorno TEF
- FVR - Logs importação TEF
- FV3 - Detalhe Log de Importação TEF
- FVZ - Filiais a Considerar
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas