6. Consulta Contas a Receber

É possível realizar a consulta de contas a receber no retaguarda, através do código externo do cliente ou o número da chave da parcela do cliente, para isso o retaguarda tera que gerar um arquivo de retorno conforme o leiaute.

Configurando o DJMonitor

Em Cadastro → Lojas → Aba Parâmetros → Aba Integração, clicar no botão “Liberar acesso” e digitar a senha do dia (pode ser obtida através do nosso site) e habilitar a opção "Consultar Contas a Receber no Retaguarda";
Em Cadastro → Lojas → Caixas (PDV) → Selecione o caixa desejado → Alterar ou F3 → Habilite a opção "Recebimentos de Contas" → Gravar ou F3;

Configurando o DJIntegração

No DJIntegração clique no botão “Configurar” → Aba Integração → Aba DJIntegração, informe o caminho onde está o aplicativo externo que realizará a consulta de contas a receber no retaguarda.

Leiaute de Contas a Receber

O DJPDV utilizara dois parâmetros para a consulta de contas no retaguarda, podendo efetuar a consulta das seguintes formas:

Consulta Genérica: Será disparado um comando sem nenhum dos parâmetros, este tipo de consulta poderá ser utilizado para listar todos as contas em aberto, ou somente contas em atraso por exemplo, sendo assim possível personalizar conforme a necessidade do parceiro.

Consulta por Cliente: Será disparado um comando utilizando apenas o primeiro parâmetro de código externo do cliente.

Consulta por Chave: A chave representa o número da conta no retaguarda. Será disparado um comando utilizando os dois parâmetros, porém, o primeiro parâmetro (Cod.Externo do Cliente) será informado com valor '-1' invalidando este parâmetro e realizando a consulta apenas da chave.

A empresa responsável pelo desenvolvimento do retaguarda precisa criar um aplicativo, onde ira realizar as consultas que desejar em sua base de dados e retornar para o DJPDV um arquivo TXT, onde o nome do arquivo deve ser: ContasReceber+cod. Externo cliente +.txt.

Exemplo: ContasReceber00003.txt

O arquivo deve ser salvo no mesmo diretório configurado no DJIntegração, ou seja, mesmo diretório onde está o executável do programa que faz a busca de contas a receber em seu retaguarda. O programa a ser desenvolvido pode fazer uso de códigos de retorno de erro ou “ErrorLevel” seguindo as tabelas abaixo:

CONSULTA GENÉRICA
ErrorLevel	DESCRIÇÃO
-4	Nenhuma informação foi retornada.
1	Parâmetros Incorretos.
2	Erro na criação dos arquivos de retorno.
3	Erro na abertura dos arquivos do retaguarda.

CONSULTA POR CLIENTE
ErrorLevel	DESCRIÇÃO
-3	Código externo do cliente não encontrado no retaguarda.
-2	Cliente não possui nenhuma duplicata.
1	Parâmetros incorretos.
2	Erro na criação dos arquivos de retorno.
3	Erro na abertura dos arquivos do retaguarda.

CONSULTA POR CHAVE
ErrorLevel	DESCRIÇÃO
-3; -2	Chave não encontrada no retaguarda.
1	Parâmetros incorretos.
2	Erro na criação dos arquivos de retorno.
3	Erro na abertura dos arquivos do retaguarda.

O arquivo de resposta a ser gerado, deve conter as seguintes informações:

SEQ.	NOME CAMPO	DESCRIÇÃO	TIPO	BYTES
1	CHAVE_PARCELA	Chave da parcela do cliente.	AN	19
2	VENCIMENTO	Data de vencimento da parcela. Formato (DDMMAAAA).	D	8
3	SALDO	Valor da parcela a ser pago. Com 2 casas decimais.	N	12
4	DIAS_ANTECIPACAO	Dias de antecipação para conceder desconto.	N	3
5	PROC_DESCONTO	Porcentagem de desconto a ser concedido, pelos dias de antecipação. Com 3 casas decimais.	N	6
6	DIAS_CARENCIA	Dias de carência após o vencimento.	N	3
7	PORC_MULTA	Porcentagem de multa cobrada após o vencimento. Com 3 casas decimais.	N	6
8	PORC_MORA_DIA	Porcentagem de mora cobrada por dia após vencimento. Com 3 casas decimais.	N	6
9	PORC_PAGTO_MIN	Porcentagem do pagamento mínimo permitido para a parcela. Com 3 casas decimais.	N	6
10	PORC_DESC_MAX	Porcentagem de desconto máximo permitido. Com 3 casas decimais.	N	6
11	NOME_CLIENTE	Nome do cliente.	AN	50
12	EMISSAO	Data de emissão da parcela. Formato (DDMMAAAA).	D	8
13	DESCRICAO	Descrição ou Observações	AN	30
14	FPAGTO	Código da Forma dePagamento	AN	10
15	TOTAL_PAGO	Total já pago da parcela. Com 2 casas decimais.	N	12

Poderá verificar arquivos TXT de exemplo em nosso site em Painel Administrativo > Downloads > 6-Úteis > Arquivos de Exemplo do DJIntegração ou clique aqui para efetuar o download.

Após a consulta de contas realizada no DJPDV, as informações de contas são exibidas na tela do DJPDV, conforme imagem 23.

Imagem 23 - Contas a Receber.

Notas:

Após o recebimento será gerado o registro DRE no arquivo de exportação, contendo os dados de pagamento para a realização da baixa da duplicata no retaguarda.