Linha Microsiga Protheus

Árvore de páginas

CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Outras Informações 
    1. Principais Campos e Parâmetros
  4. Tabelas utilizadas


01. VISÃO GERAL

Modelo de dados a ser seguido para a integração de lançamentos contábeis enviados do sistema Gesplan para Protheus.


02. EXEMPLO DE UTILIZAÇÃO

Envio de dados deve ser realizado via SmartLink utilizando o Padrão CloudEvents/Modo Estruturado para envio de mensagens no formato Json de acordo com o modelo a seguir :

Json de envio Lançamento contábil
{
     "specversion": "1.0",
     "type": "CT2readXGsp",
     "tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
     "time": "2021-06-08T15:18:08.367574Z",        
     "data":[{ 
			"COD_EMP":"T1" ,
		 	"CT2_FILIAL":  "D MG 01",
            "CT2_DATA":"15/04/2023" ,
		  	"ID": "1271",
			"EST":"REV",
			"ITENS":[{
				"CT2_DC" :  "3",
				"CT2_CREDIT":  "CTBXATUC",
            	"CT2_DEBITO":  "CTBXATUD",
				"CT2_VALOR":  1500.60 ,
				"CT2_HIST": "PARTIDA DOBRADA VALOR COM DECIMAL E CONTINUACAO DE HISTORICO",
				"CT2_KEY":  "IDENTIFICADOR UNICO GESPLAN",
            	"CT2_ROTINA": "WFNCASH",			
				"CT2_EMPORI":  "T2",
				"CT2_FILORI":  "M PR 02",
		 		"CT2_CONVER": "1"
			},
			{
            "CT2_MOEDLC":  "01",
            "CT2_DC" :  "2",
            "CT2_CREDIT":  "CTBXATUC",
            "CT2_KEY":  "ITEM 1",
            "CT2_ROTINA": "WFNCASH",
            "CT2_VALOR":  3000 ,
            "CT2_HIST": "MSEXECCT2 ITEM1 ",
            "CT2_EMPORI":  "T2",
            "CT2_FILORI":  "M PR 02"
        	},
			{
            "CT2_MOEDLC":  "01",
            "CT2_DC" :  "1",
            "CT2_DEBITO":  "CTBXATUD",
            "CT2_KEY":  "ITEM 2",
            "CT2_ROTINA": "WFNCASH",
            "CT2_VALOR":  3000 ,
            "CT2_HIST": "MSEXECCT2 ITEM2 ",
            "CT2_EMPORI":  "T2",
            "CT2_FILORI":  "M PR 02"
        	}]
    },
	{ 
			"COD_EMP":"T1" ,
		 	"CT2_FILIAL":  "M SP  01",
            "CT2_DATA":"15/04/2023" ,
 			"ID": "1271",
			"EST":"REV"	, 
			"ITENS":[{
				"CT2_DC" :  "3",
				"CT2_CREDIT":  "CTBXATUC",
            	"CT2_DEBITO":  "CTBXATUD",
				"CT2_VALOR":  5000.50 ,
				"CT2_HIST": "PARTIDA DOBRADA ",
				"CT2_KEY":  "IDENTIFICADOR UNICO",
            	"CT2_ROTINA": "WFNCASH",			
				"CT2_EMPORI":  "T2",
				"CT2_FILORI":  "M PR 02",
		 		"CT2_CONVER": "1"
			}]
	}]
}

OBS: propriedade "data" deverá ser enviado formato array onde cada item desse array deverá conter os dados do lançamento contábil a ser cadastrado.


Fomato de resposta:

Exemplo de resposta 
{
    "specversion": "1.0",
    "time": "2022-10-18T11:04:03-03:00",
    "type": "CT2respXGsp",
    "tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
    "data": [
        {
			"ID": "1271"
			"EST":"REV"	
            "COD_EMP": "T1",
            "CT2_FILIAL": "D MG 01",
            "CT2_DOC": "000004",
            "CT2_KEY": "ITEM 1",
            "error": ""
        }
    ]
}

OBS: Caso houver algum erro a propriedade "error" será preenchida informando o motivo do erro no cadastro, nesses casos a propriedade "CT2_DOC" retornará em branco pois o lançamento não foi cadastrado.

IMPORTANTE!

Para melhor visualizar os motivos de não efetivação de lançamento, utilizar o parâmetro MV_CT105MS com conteúdo = "S"

03. Outras Informações_

Principais Campos e Parâmetros


Capa do Lote

CampoDescriçãoTipoTamanho(MAX)ObrigatórioObservação
COD_EMPCódigo da empresaCaractere2XGrupo de Empresa 
CT2_FILIALCódigo da FilialCaractere8XConcatenação dos campos  Empresa , Unidade de Negócio e Filial
CT2_DATAData LançamentoCaractere10XData enviada em formato caractere ddmmaaaa ex: "29/08/2022"
IDIdentificador de controle GesplanCaractere10
Conteúdo apenas será retornado
ESTIdentificador de controle GesplanCaractere10
Conteúdo apenas será retornado

OBS: O código do Lote reservado para os lançamentos contábeis oriundos do Sistema Gesplan para o Protheus é 008950. 

Itens do Lote

CampoDescriçãoTipoTamanho(MAX)ObrigatórioObservação
CT2_DCTipo do LançamentoCaractere1X1 → Débito 2 → Crédito 3→ Partida Dobrada
CT2_KEYChave identificadoraCaractere200XSYSCODE (GESPLAN)
CT2_ROTINARotina GeradoraCaractere10XWFNFIN ou WFNCASH ou WFNLEAS
CT2_VALORValor do LançamentoNumérico16Xdecimal deve ser enviado com o caractere ponto
CT2_HISTHistórico LançamentoCaractere512X

** tamanho Default no Protheus 40

CT2_EMPORICódigo da empresa de origemCaractere2XN/A
CT2_FILORICódigo da Filial de origemCaractere8XN/A
CT2_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 SaldoCaractere1
Conteúdo default = '1'
CT2_CCD   Centro de Custo Débito   Caractere9
N/A
CT2_CCC   Centro de Custo CréditoCaractere9
N/A
CT2_ITEMDItem DébitoCaractere9
N/A
CT2_ITEMCItem CréditoCaractere9
N/A
CT2_CLVLDBClasse de Valor DébitoCaractere9
N/A
CT2_CLVLCRClasse de Valor CréditoCaractere9
N/A
CT2_EC05DBEntidade Adicional (Sem Nomenclatura)Caractere20
N/A
CT2_EC05CREntidade Adicional (Sem Nomenclatura)Caractere20
N/A
CT2_EC06DBEntidade Adicional (Sem Nomenclatura)Caractere20
N/A
CT2_EC06CREntidade Adicional (Sem Nomenclatura)Caractere20
N/A
CT2_EC07DBEntidade Adicional (Sem Nomenclatura)Caractere20
N/A
CT2_EC07CREntidade Adicional (Sem Nomenclatura)Caractere20
N/A
CT2_EC08DBEntidade Adicional (Sem Nomenclatura)Caractere20
N/A
CT2_EC08CREntidade Adicional (Sem Nomenclatura)Caractere20
N/A
CT2_EC09DBEntidade Adicional (Sem Nomenclatura)Caractere20
N/A
CT2_EC09CREntidade Adicional (Sem Nomenclatura)Caractere20
N/A
CT2_CONVERCritério de Conversão  Caractere5
Default = '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.


IMPORTANTE!

** 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_HIST


04. TABELAS UTILIZADAS

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