Última modificação em: 22/09/2022
Pagamentos
Arquivo para Importação de Pagamentos de Duplicatas
Abaixo segue instruções para geração do arquivo de importação do movimento fiscal referente às duplicatas a pagar. 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 |
|
P Importante: O identificador do registro não pode vir com aspas duplas |
DuplicataEntPgto (nFis) |
Pagamentos das Parcelas |
Um registro para cada cadastro de Pagamento 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 virgula. 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 dentro da Descrição da string, os seguintes Caracteres:
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 PAGAMENTOS
|
Tipo Registro |
P |
||||||
|
Descrição |
Pagamentos das Parcelas das Duplicatas a Receber. Cada registro do tipo B, descrito anteriormente, pode ter vários Pagamentos. |
||||||
|
Ix |
Nome do Campo |
Nome Curto |
Tipo |
Tam . |
Requerido |
Observação |
|
|
1 |
|
Identificador |
Texto |
1 |
Sim |
Fixar letra P 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 |
NUMERODUPLICATAENT |
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 numero da parcela deve obrigatóriamente ser formado de 3 caracteres. Exemplo: Em caso de parcela Numérica
Em caso de AlfaNumérico
|
|
|
7 |
DATAPGTO |
Data do Pagamento |
Data |
10 |
Sim |
Informe a data em que ocorreu o Pagamento 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 Pagamento * |
|
|
10 |
VALORJUROS |
Valor Juros |
Numérico |
14,2 |
Sim |
Informe o valor dos juros do Pagamento * |
|
|
11 |
VALORDESCONTO |
Valor Desconto |
Numérico |
14,2 |
Sim |
Informe o valor do desconto do Pagamento * |
|
|
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 Pagamento.
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 Inventário:
|
P;03.788.529/0001-00;06.191.869/0001-47;04/08/2020;15456;001;04/09/2020;0000000001500,00;0000000000100,00;0000000000200,00;00000000000015,00;0000000000000,00;; |
|
P;03.788.529/0001-00;06.278.750/0001-06;01/01/2020;100;001;10/02/2020;0000000001500,00;0000000000100,00;0000000000200,00;00000000000015,00;0000000000000,00;; |
|
P;03.788.529/0001-00;10.677.468/0001-79;01/01/2020;2;001;10/02/2020;0000000001500,00;0000000000100,00;0000000000200,00;00000000000015,00;0000000000000,00;; |
|
P;03.788.529/0001-00;04.737.552/0001-38;01/01/2020;1234;001;10/02/2020;0000000001500,00;0000000000100,00;0000000000200,00;00000000000015,00;0000000000000,00;; |
|
P;03.788.529/0001-00;04.737.552/0001-38;01/01/2020;1234;002;12/02/2020;0000000001500,00;0000000000100,00;0000000000200,00;00000000000015,00;0000000000000,00;; |
|
P;03.788.529/0001-00;06.191.869/0001-47;04/08/2020;15456;001;04/09/2020;0000000001500,00;0000000000100,00;0000000000200,00;00000000000015,00;0000000000000,00;; |
|
P;03.788.529/0001-00;06.278.750/0001-06;01/01/2020;100;001;10/02/2020;0000000001500,00;0000000000100,00;0000000000200,00;00000000000015,00;0000000000000,00;; |
|
P;03.788.529/0001-00;10.677.468/0001-79;01/01/2020;2;001;10/02/2020;0000000001500,00;0000000000100,00;0000000000200,00;00000000000015,00;0000000000000,00;; |
|
P;03.788.529/0001-00;04.737.552/0001-38;01/01/2020;1234;001;10/02/2020;0000000001500,00;0000000000100,00;0000000000200,00;00000000000015,00;0000000000000,00;; |
|
P;03.788.529/0001-00;04.737.552/0001-38;01/01/2020;1234;002;12/02/2020;0000000001500,00;0000000000100,00;0000000000200,00;00000000000015,00;0000000000000,00;; |