Recebimentos

Arquivo para Importação de Recebimento de Duplicatas:

Abaixo segue instruções para geração do arquivo de importação do movimento fiscal referente às duplicatas a receber. O objetivo deste documento é facilitar a integração do movimento fiscal de outros programas (softwares) com o Questor.

Formato do Arquivo:

O arquivo deve conter informações de vários estabelecimentos (matriz e filiais)
O arquivo pode ser composto por vários tipos de registros, dependendo das configurações de cada estabelecimento.
O arquivo deve conter um registro por linha. Cada registro deverá ser identificado por uma letra na primeira posição da linha, sucedido de ; (ponto e vírgula), conforme tabela;
Cada linha deve terminar com os caracteres de fim de linha ASC 13 + ASC 10
O arquivo deve estar formatado em JSON String quando enviado pelo método Post na API SYN.

Formato do Registro:

Os registros são formados por campos separados por ; (ponto e vírgula).
A quantidade de campos de um registro é fixa, conforme o tipo de registro. Deve ser respeitada a quantidade de ; (ponto e vírgula) no registro, caso contrário o mesmo será considerado incompleto.
Os registros terão seu tamanho variável, conforme o conteúdo de cada campo.

Tabela 1: Tipo de registro identificado por letra

Tipo

Tabela

Descrição

Instrução

Importante: O identificador do registro não pode vir com aspas duplas

DuplicataSaiPgto (nFis)

Recebimentos das

Parcelas

Um registro para cada cadastro de recebimento das parcelas

Formato do Campo:

Cada campo tem um tipo que determina o formato de seu conteúdo, conforme a tabela 2.
Cada campo possui um tamanho máximo para seu conteúdo. Os excessos serão desconsiderados.

Tabela 2: Formatação dos Campos do Arquivo

Tipo	Instrução
Inteiro	Formato Padrão: 1234 São aceitos números inteiros e positivos, apenas dígitos de 0 a 9.
Numérico	Padrão: 1234,56 São aceitos números reais e positivos, dígitos de 0 a 9, sempre com separador decimal, o separador decimal deve ser “,” (vírgula). A quantidade de casas decimais deve ser de duas casas após a vírgula. O separador do milhar não deve constar nos números.
Data	Padrão: 31/01/2020 São aceitos datas compostas por (dia, mês e ano), dígitos de 0 a 9, com separador. O separador deve ser: “/”
Lógico	Padrão: 0;1 São aceitos 0, para representar Falso ou Não, e, 1, para representar Verdadeiro ou Sim. Obs.: Outros formatos válidos, sem alteração no leiaute do importador variável são: N;S.
Texto	Padrão: “NF Cancelada” São aceitos Caracteres como: letras, dígitos e símbolos. Não são aceitos na Descrição da string, os seguintes Caracteres: ; - Ponto e Virgula \| - Pipe " - Aspas Duplas Obs.: É importante ter o delimitador para não separar os campos indevidamente. Importante: É extremamente importante que os campos em texto venham com o identificador de string (“) – Aspas Duplas, para evitar que ocorram erros no processo de importação do arquivo

Importante: Ao final do Arquivo deixar uma linha em branco

LEIAUTE DOS REGISTROS (LEIAUTE VARIÁVEL)

LANÇAMENTOS DE RECEBIMENTOS

Tipo Registro		R
Descrição		Recebimentos das Parcelas das Duplicatas a Receber. Cada registro do tipo B, descrito anteriormente, pode ter vários recebimentos.
Ix	Nome do Campo		Nome Curto	Tipo	Tam.	Requerido	Observação
1			Identificador	Texto	1	Sim	Fixar letra R Importante: O identificador do registro não pode vir com aspas duplas
2	CODIGOESTAB		Estabelecimento	Texto	18	Sim	Informe o CNPJ/CPF do estabelecimento (matriz ou filial) **
3	CODIGOPESSOA		Cliente	Texto	18	Sim	Informe o CNPJ
4	DATALCTOFIS		Data do Documento Fiscal	Data	10	Sim	Informe a data do Documento Fiscal. Importante: Esta data deve ser a mesma data informada na nota escriturada.
5	NUMERODUPLICATASAI		Número Duplicata	Inteiro	9	Sim	Informe o número da duplicata a receber.
6	NUMEROPARCELA		Número Parcela	Texto	5	Sim	Informe o número da parcela: Importante: O número da parcela deve obrigatoriamente ser formado de 3 caracteres. Exemplo: Em caso de parcela Numérica "001" Em caso de Alfanumérico "AAA" " A"
7	DATAPGTO		Data do Recebimento	Data	10	Sim	Informe a data em que ocorreu o recebimento da Duplicata.
8	VALORPAGO		Valor Pago	Numérico	14,2	Sim	Informe o valor nominal pago da parcela, desconsiderando juros, multas e descontos.
9	VALORMULTA		Valor Multas	Numérico	14,2	Sim	Informe o valor das multas do recebimento *
10	VALORJUROS		Valor Juros	Numérico	14,2	Sim	Informe o valor dos juros do recebimento *
11	VALORDESCONTO		Valor Desconto	Numérico	14,2	Sim	Informe o valor do desconto do recebimento *
12	VALORTARIFA		Tarifas	Numérico	14,2	Sim	Informe apenas o Valor das Tarifas Bancárias.
13	CODIGOTABCTBFIS		Tabela Contábil	Inteiro	4	Sim	Informe a tabela contábil para o recebimento. Importante:Este Código de Tabela Contábil é o código da tabela contábil internamente utilizada pela Empresa que utiliza o Questor.

* Use zero (0.00) quando não houver.

Exemplo de arquivo de Lançamentos de Recebimentos:

R;03.788.529/0001-00;10.677.468/0001-79;01/01/2020;" 2";"002";04/04/2020;0000000001500,00;0000000000000,00;0000000000000,00;0000000000000,00;0000000000000,00;;

R;03.788.529/0001-00;10.677.468/0001-79;01/01/2020;" 2";"001";12/02/2020;0000000002500,00;0000000000000,00;0000000000000,00;0000000000000,00;0000000000000,00;;

R;03.788.529/0001-00;10.677.468/0001-79;01/01/2020;" 2";"002";04/04/2020;0000000001500,00;0000000000000,00;0000000000000,00;0000000000000,00;0000000000000,00;;

R;03.788.529/0001-00;10.677.468/0001-79;01/01/2020;" 2";"001";12/02/2020;0000000002500,00;0000000000000,00;0000000000000,00;0000000000000,00;0000000000000,00;;

R;03.788.529/0001-00;10.677.468/0001-79;01/01/2020;" 2";"002";04/04/2020;0000000001500,00;0000000000000,00;0000000000000,00;0000000000000,00;0000000000000,00;;