Última modificação em: 03/03/2023

Lançamentos Contábeis

Arquivo para Importação dos Lançamentos Contábeis

Abaixo segue instruções para geração do arquivo de importação do Lançamento Contábil. O objetivo deste documento é facilitar a integração dos Lançamentos Contábeis de outros programas (softwares) com o Questor.

Formato do Arquivo: 

  • O arquivo pode conter informações de vários estabelecimentos (matriz e filiais)
  • O arquivo deve conter um registro por linha sucedido de “; ” (ponto e vírgula).
  • 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

C

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

LctoCtb (nCtb)

Lançamento Contábil

Um registro para cada lançamento contábil.

XX

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

LctoGer (nCtb)

Lançamento Gerencial

Pode haver vários lançamentos para um lançamento contábil.

 

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:

  • ; - 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 (LAYOUT VARIÁVEL)

LANÇAMENTOS CONTÁBEIS:

 

Tipo Registro

C

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

Descrição

Cadastro dos lançamentos contábeis. Informe apenas os campos solicitados os que não forem necessários serão ignorados.

Ix

Nome do Campo

Nome Curto

Tipo

Tam.

Requerido

Observação

1

 

Identificador

Texto

1

Sim

Fixar Letra C

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

2

CODIGOESTAB

Filial

Caractere

20

Sim

Informe o CNPJ da matriz ou filial, com ou sem máscara

3

DATALCTOCTB

Data

Data

10

Sim

Data do lançamento contábil

4

CODIGOLOTECTB

Número do Lote

Caractere

10

Não

Número do Lote

5

NUMERODCTOERODCTO

Número Documento

Caractere

10

Não

Número do documento

6

CONTACTBDEB

Debite

Numérico

20

Sim

Conta Contábil ERP

Informar neste campo o código da conta contábil conforme o plano de contas do Sistema ERP.

Exemplo:

13 - Banco do Brasil

Neste campo deve conter a informação da Conta: 13

 

Conta Contábil Questor

Em casos em que o sistema ERP possua a informação do Plano de Contas Questor, e no ERP já é efetuado um De-Para de algum dado para a conta do Questor. É possivel que seja enviado direto a conta deste De-Para

Exemplo:

13 - Banco do Brasil

Conta "13" no ERP, feito De-Para para conta Questor, conta 10

Neste campo deve conter a informação da Conta: Q10

Note que neste cenário é enviado o código da conta Questor, antecendendo com a Letra Q

 

Importante:

Nos casos de contas envolvendo CLIENTES ou FORNECEDORES este campo deverá ser preenchido com a informação do CNPJ/CPF do Cliente ou do Fornecedor antecedendo um identificador se o CNPJ/CPF trata-se de Cliente (C) ou de Fornecedor (F), uma vez que por meio deste identificador + CNPJ/CPF o Questor consegue fazer a busca da reserva da conta contábil deste respectivo Cliente/Fornecedor

  • Exemplo Cliente:

C01.234.546/0001-00

C123.456.789-00

  • Exemplo Fornecedor:

F09.876.543/0001-00

F987.654.321-00

 

Em caso de contas de Clientes Diversos ou de Fornecedores Diversos, que são clientes que muitas vezes os Sistemas ERP tratam com uma conta genérica, é possível tratar esta integração no sistema da seguinte maneira:

Enviar um CNPJ Genérico, antecendendo com C - Clientes ou F - Fornecedores. Exemplo

  • C999.999.999/99
  • C99.999.999/9999-99
  • F999.999.999/99
  • F99.999.999/9999-99

 

7

DESCRIÇÃO CONTA DEBITO

DESCRCONTA

Caractere

50

Não

Descrição da Conta Débito.

Este campo não é obrigatório.

Entretanto caso o ERP não faça o envio da carga inicial do Plano de Contas, leiaute P, é sugerido que seja enviada a descrição da conta para que o Usuário faça o respectivo De-Para no produto Gestão Contábil.

Caso enviada a conta contábil do plano do Questor, ou seja, já foi efetuado o De-Para no ERP, não se faz necessário o envio desta informação, reforçando que neste caso na posição 6 deve vir com um Q antecendendo o código da Conta. Ex.: Q10

8

CONTACTBCRED

Credite

Numérico

20

Sim

Conta Contábil ERP

Informar neste campo o código da conta contábil conforme o plano de contas do Sistema ERP.

Exemplo:

13 - Banco do Brasil

Neste campo deve conter a informação da Conta: 13

 

Conta Contábil Questor

Em casos em que o sistema ERP possua a informação do Plano de Contas Questor, e no ERP já é efetuado um De-Para de algum dado para a conta do Questor. É possivel que seja enviado direto a conta deste De-Para

Exemplo:

13 - Banco do Brasil

Conta "13" no ERP, feito De-Para para conta Questor, conta 10

Neste campo deve conter a informação da Conta: Q10

Note que neste cenário é enviado o código da conta Questor, antecendendo com a Letra Q

 

Importante:

Nos casos de contas envolvendo CLIENTES ou FORNECEDORES este campo deverá ser preenchido com a informação do CNPJ/CPF do Cliente ou do Fornecedor antecedendo um identificador se o CNPJ/CPF trata-se de Cliente (C) ou de Fornecedor (F), uma vez que por meio deste identificador + CNPJ/CPF o Questor consegue fazer a busca da reserva da conta contábil deste respectivo Cliente/Fornecedor

  • Exemplo Cliente:

C01.234.546/0001-00

C123.456.789-00

  • Exemplo Fornecedor:

F09.876.543/0001-00

F987.654.321-00

 

Em caso de contas de Clientes Diversos ou de Fornecedores Diversos, que são clientes que muitas vezes os Sistemas ERP tratam com uma conta genérica, é possível tratar esta integração no sistema da seguinte maneira:

Enviar um CNPJ Genérico, antecendendo com C - Clientes ou F - Fornecedores. Exemplo

  • C999.999.999/99
  • C99.999.999/9999-99
  • F999.999.999/99
  • F99.999.999/9999-99

9

DESCRIÇÃO CONTA CRÉDITO

DESCRCONTA

Caractere

50

Não

Descrição da Conta Crédito.

Este campo não é obrigatório.

Entretanto caso o ERP não faça o envio da carga inicial do Plano de Contas, leiaute P, é sugerido que seja enviada a descrição da conta para que o Usuário faça o respectivo De-Para no produto Gestão Contábil.

Caso enviada a conta contábil do plano do Questor, ou seja, já foi efetuado o De-Para no ERP, não se faz necessário o envio desta informação, reforçando que neste caso na posição 8 deve vir com um Q antecendendo o código da Conta. Ex.: Q10

10

VALORLCTOCTB

Valor

Numérico

16

Sim

Valor do Lançamento Contábil

11

CODIGOHISTCTB

Histórico

Inteiro

5

Não

Código Histórico


Informar neste campo o Código do Histórico, conforme códigos de histórico do Sistema ERP.

 

Exemplo:

'13' - Pagamento Referente:
Desta forma o Questor irá requisitar um De-Para do código do histórico do ERP com o código do histórico do Questor.


Caso no sistema ERP já possua um De-Para

Informar neste campo o Código do Histórico, conforme códigos de histórico do Questor, antecedendo com a letra Q antes do código do histórico.

 

Exemplo:

'Q22' - Pagamento Referente:'

Desta forma o Questor irá importar direto com o código do histórico Questor.

12

COMPLHIST

Complemento

Caractere

300

Não

Complemento do histórico contábil

 

LANÇAMENTOS CENTRO DE CUSTOS:

 

Tipo Registro

XX

Descrição

Cadastro dos lançamentos Gerenciais. Informe apenas o campos solicitados os que não forem necessários serão ignorados.

Ix

Nome do Campo

Nome Curto

Tipo

Tam.

Requerido

Observação

1

 

Identificador

Texto

1

Sim

Fixar Letras XX.

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

2

NATURLCTOCTB

Natureza

Inteiro

2

Sim

Natureza do lançamento contábil

Valores Possíveis:

Débito=1;

Crédito=-1;

 

Observação:

É de extrema importancia que seja identificado de qual respectiva conta contábil trata-se o respectivo lançamento gerencial, sendo que 1 significa que a distribuição é do lançamento a debito imediatamente informado na linha anterior (Layout C)

sendo que -1 significa que a distribuição é do lançamento a Crédito imediatamente informado na linha anterior (Layout C)

 

3

CODIGOCENTROCUSTO

Centro de Custo

Numérico

11

Sim

Informe o código do Centro de Custo

4

VALORLCTOGER

Valor

Numérico

16

Sim

Valor do lançamento gerencia

 

Exemplo de arquivo de lançamento contábil, com Centro de Custos e Movimentação de Clientes e Fornecedores:

Exemplos:

1) Arquivo Lançamentos Contábeis (Com contas do Plano de Contas do ERP + Centro de Custos)

C;"03.788.529/0001-00";07/06/2020;" ";"143457 ";C04.737.552/0001-38 ;"Cliente ";2655 ;"Descrição Conta ";0000000002000,00;"22 ";"143457 - VENDA COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"143457 ";20 ;"Descrição Conta ";C04.737.552/0001-38 ;"Cliente ";0000000001000,00;"22 ";"143457 - Recebimento PARCELA 1 COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"143457 ";20 ;"Descrição Conta ";C04.737.552/0001-38 ;"Cliente ";0000000001000,00;"22 ";"143457 - Recebimento PARCELA 2 COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142996 ";5 ;"Descrição Conta ";10 ;"Descrição Conta ";0000000001500,00;"22 ";"142996 - SAQUE ";;
XX; 1;"3 ";0000000001500,00;
XX;-1;"3 ";0000000001500,00;
C;"03.788.529/0001-00";01/06/2020;" ";"142998 ";1375 ;"Descrição Conta ";11 ;"Descrição Conta ";0000000000089,09;"22 ";"142998 - GUIA ST ";;
XX; 1;"2 ";0000000000089,09;
XX;-1;"3 ";0000000000089,09;
C;"03.788.529/0001-00";01/06/2020;" ";"142970 ";3035 ;"Descrição Conta ";F04.737.552/0001-38 ;"Fornecedor ";0000000001000,00;"22 ";"142970 - Compra COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142970 ";F04.737.552/0001-38 ;"Fornecedor ";20 ;"Descrição Conta ";0000000000500,00;"22 ";"142970 - Pagamento COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142970 ";F04.737.552/0001-38 ;"Fornecedor ";20 ;"Descrição Conta ";0000000000500,00;"22 ";"142970 - Pagamento COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142996 ";5 ;"Descrição Conta ";10 ;"Descrição Conta ";0000000001500,00;"22 ";"142996 - SAQUE ";;
XX; 1;"3 ";0000000001500,00;
XX;-1;"3 ";0000000001500,00;
C;"03.788.529/0001-00";01/06/2020;" ";"142998 ";1375 ;"Descrição Conta ";11 ;"Descrição Conta ";0000000000089,09;"22 ";"142998 - GUIA ST ";;
XX; 1;"2 ";0000000000089,09;
XX;-1;"3 ";0000000000089,09;


2) Arquivo Lançamentos Contábeis (Com contas do Plano de Contas do ERP sem Centro de Custos)

C;"03.788.529/0001-00";07/06/2020;" ";"143457 ";C04.737.552/0001-38 ;"Cliente ";2655 ;"Descrição Conta ";0000000002000,00;"22 ";"143457 - VENDA COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"143457 ";20 ;"Descrição Conta ";C04.737.552/0001-38 ;"Cliente ";0000000001000,00;"22 ";"143457 - Recebimento PARCELA 1 COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"143457 ";20 ;"Descrição Conta ";C04.737.552/0001-38 ;"Cliente ";0000000001000,00;"22 ";"143457 - Recebimento PARCELA 2 COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142996 ";5 ;"Descrição Conta ";10 ;"Descrição Conta ";0000000001500,00;"22 ";"142996 - SAQUE ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142998 ";1375 ;"Descrição Conta ";11 ;"Descrição Conta ";0000000000089,09;"22 ";"142998 - GUIA ST ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142970 ";3035 ;"Descrição Conta ";F04.737.552/0001-38 ;"Fornecedor ";0000000001000,00;"22 ";"142970 - Compra COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142970 ";F04.737.552/0001-38 ;"Fornecedor ";20 ;"Descrição Conta ";0000000000500,00;"22 ";"142970 - Pagamento COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142970 ";F04.737.552/0001-38 ;"Fornecedor ";20 ;"Descrição Conta ";0000000000500,00;"22 ";"142970 - Pagamento COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142996 ";5 ;"Descrição Conta ";10 ;"Descrição Conta ";0000000001500,00;"22 ";"142996 - SAQUE ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142998 ";1375 ;"Descrição Conta ";11 ;"Descrição Conta ";0000000000089,09;"22 ";"142998 - GUIA ST ";;

3) Arquivo Lançamentos Contábeis (Com contas do Plano de Contas do Questor)

C;"03.788.529/0001-00";07/06/2020;" ";"143457 ";C04.737.552/0001-38 ;;Q2655 ;;0000000002000,00;"22 ";"143457 - VENDA COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"143457 ";Q20 ;;C04.737.552/0001-38 ;;0000000001000,00;"22 ";"143457 - Recebimento PARCELA 1 COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"143457 ";Q20 ;;C04.737.552/0001-38 ;;0000000001000,00;"22 ";"143457 - Recebimento PARCELA 2 COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142996 ";Q5 ;;Q10 ;;0000000001500,00;"22 ";"142996 - SAQUE ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142970 ";F04.737.552/0001-38 ;;Q20 ;;0000000000500,00;"22 ";"142970 - Pagamento COMERCIAL INTERNACIONAL LTDA ";;
C;"03.788.529/0001-00";01/06/2020;" ";"142970 ";F04.737.552/0001-38 ;;Q20 ;;0000000000500,00;"22 ";"142970 - Pagamento COMERCIAL INTERNACIONAL LTDA ";;

 

CCQ Blog
© Questor Sistemas 2025