Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

CONTEÚDO

  1. Visão Geral
  2. Campos
  3. Tabelas utilizadas


01. VISÃO GERAL

Essa documentação visa demonstrar o modelo de dados que será enviado para a integração de lançamentos contábeis do sistema Protheus para o sistema Gesplan.

02. EXEMPLO DE UTILIZAÇÃO

Principais Campos e Parâmetros


CampoDescriçãoTipoTamanho(MAX)
Obrigatório
Observação
CT2
QLX_
DC
FILIAL
Tipo
Filial do
Lançamento
Lançamento Caractere
1X1 → Débito 2 → Crédito 3→ Partida DobradaCT2_KEYChave identificadoraCaractere200XSYSCODE (GESPLAN)CT2_ROTINARotina GeradoraCaractere10XWFNFIN ou WFNCASH ou WFNLEASCT2_VALORValor do LançamentoNumérico16Xdecimal deve ser enviado com o caractere pontoCT2_HISTHistórico LançamentoCaractere512X

** tamanho Default no Protheus 40

CT2_EMPORICódigo da empresa de origemCaractere2XN/ACT2_FILORICódigo da Filial de origemCaractere8XN/ACT2_DEBITOConta Debito             Caractere20XObrigatório para tipos de lançamento: Débito e Partida dobrada CT2_CREDITConta Credito            Caractere20XObrigatório para tipos de lançamento: Crédito e Partida dobrada CT2_TPSALDTipo de SaldoCaractere1Conteúdo default = '1'CT2_CCD   Centro de Custo Débito   Caractere9N/ACT2_CCC   Centro de Custo CréditoCaractere9N/ACT2_ITEMDItem DébitoCaractere9N/ACT2_ITEMCItem CréditoCaractere9N/ACT2_CLVLDBClasse de Valor DébitoCaractere9N/ACT2_CLVLCRClasse de Valor CréditoCaractere9N/ACT2_EC05DBEntidade Adicional (Sem Nomenclatura)Caractere20N/ACT2_EC05CREntidade Adicional (Sem Nomenclatura)Caractere20N/ACT2_EC06DBEntidade Adicional (Sem Nomenclatura)Caractere20N/ACT2_EC06CR
12Personalizável via grupo de campos 
QLX_DATA Data do LançamentoCaractere8Padrão Protheus (YYYYMMDD) ex: 20251021
QLX_LOTELote do LançamentoCaractere6N/A
QLX_SBLOTESub Lote do LançamentoCaractere3N/A
QLX_DOCDocumento do LançamentoCaractere6N/A
QLX_LINHALinha do LançamentoCaractere3N/A
QLX_MOEDAMoeda do LançamentoCaractere10N/A
QLX_TIPOTipo do LançamentoCaractere1

'1' → Débito

'2' → Crédito

OBS: Lançamentos tipo '3' (Partida Dobrada) serão enviados em duas linhas de partida simples com seu devido valor: '1' e '2'

QLX_CONTAConta ContábilCaractere70Personalizável via grupo de campos 
QLX_CCUSTCentro de Custo Caractere20Personalizável via grupo de campos 
QLX_ITEMItem ContábilCaractere20Personalizável via grupo de campos 
QLX_CLVLClasse de ValorCaractere20Personalizável via grupo de campos 
QLX_TPSALDTipo de SaldoCaractere1N/A
QLX_DCTipo do Lançamento Contábil OrigemCaractere1'1' → Débito '2' → Crédito '3'→ Partida Dobrada
QLX_PARTIDPartida do Lançamento 
70Personalizável via grupo de campos 
QLX_HISTHistórico do LançamentoCaractere254

** tamanho Default no Protheus 40

QLX_SEQHISSequência do HistóricoCaractere3N/A
QLX_SEQLANSequência Auxiliar do LançamentoCaractere3

N/A

QLX_EMPORICódigo da empresa de origemCaractere2N/A
QLX_FILORICódigo da Filial de origemCaractere12Personalizável via grupo de campos 
QLX_ENT05Entidade Adicional (Sem Nomenclatura)Caractere20
N/ACT2_EC07DB
Personalizável via grupo de campos 
QLX_ENT06Entidade Adicional (Sem Nomenclatura)Caractere20
N/ACT2_EC07CR
Personalizável via grupo de campos 
QLX_ENT07Entidade Adicional (Sem Nomenclatura)Caractere20
N/ACT2_EC08DB
Personalizável via grupo de campos 
QLX_ENT08Entidade Adicional (Sem Nomenclatura)Caractere20
N/ACT2_EC08CR
Personalizável via grupo de campos 
QLX_ENT09Entidade Adicional (Sem Nomenclatura)Caractere20
N/ACT2_EC09DBEntidade Adicional (Sem Nomenclatura)Caractere20N/ACT2_EC09CREntidade Adicional (Sem Nomenclatura)Caractere20N/ACT2_CONVERCritério de Conversão  Caractere5Default = '1' . Define se será gerado lançamento contábil em outras moedas convertidos de acordo com o critério

OBS: Para cada capa de lote deve ser enviado 1 ou mais itens.

Personalizável via grupo de campos 
QLX_VALORValor do LançamentoNumérico16decimal enviado com o caractere ponto ex: 99.99
QLX_IDLANCIdentificador Único do lançamento Caractere37

ID lançamento na CT2 (MSUIDT) 

Lançamento a Débito → CT2 (MSUIDT) + 'D'

Lançamento a Crédito→ CT2 (MSUIDT) + 'C

*Usar como chave única na integração

QLX_DELET Identificador de Deleção do Lançamento Caractere1

'*' → Lançamento Deletado

' ' → Lançamento não Deletado (vazio)

company_groupGrupo de Empresa do lançamentoCaractere2

Enviado pelo framework por padrão

OBS: *Documentação interna.
         ** Além dos campos acima documentados campos adicionais podem ser enviados pela camada de framework que não necessariamente fazem parte da integração.
Card documentosInformacao** Caso o conteúdo do campo CT2_HIST enviado seja maior que o tamanho campo no Protheus o sistema irá gerar de forma automática, linhas de continuação de histórico (CT2_DC = 4) de acordo com o tamanho do campo CT2_HISTTituloIMPORTANTE!

04. TABELAS UTILIZADAS

  • CT2- Lançamentos Contábeis
  • CT1- Plano de Contas
  • CTT- Centro de Custo
  • CTH- Classe de Valor
  • CTD - Item Contábil

...