CONTEÚDO
- Visão Geral
- Exemplo de utilização
- Outras Informações
- Principais Campos e Parâmetros
- Principais Campos e Parâmetros
- 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 :
{ "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:
{ "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.
Para melhor visualizar os motivos de não efetivação de lançamento, utilizar o parâmetro MV_CT105MS com conteúdo = "S" IMPORTANTE!
03. Outras Informações_
Principais Campos e Parâmetros
Capa do Lote
Campo | Descrição | Tipo | Tamanho(MAX) | Obrigatório | Observação |
---|---|---|---|---|---|
COD_EMP | Código da empresa | Caractere | 2 | X | Grupo de Empresa |
CT2_FILIAL | Código da Filial | Caractere | 8 | X | Concatenação dos campos Empresa , Unidade de Negócio e Filial |
CT2_DATA | Data Lançamento | Caractere | 10 | X | Data enviada em formato caractere ddmmaaaa ex: "29/08/2022" |
ID | Identificador de controle Gesplan | Caractere | 10 | Conteúdo apenas será retornado | |
EST | Identificador de controle Gesplan | Caractere | 10 | 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
Campo | Descrição | Tipo | Tamanho(MAX) | Obrigatório | Observação |
---|---|---|---|---|---|
CT2_DC | Tipo do Lançamento | Caractere | 1 | X | 1 → Débito 2 → Crédito 3→ Partida Dobrada |
CT2_KEY | Chave identificadora | Caractere | 200 | X | SYSCODE (GESPLAN) |
CT2_ROTINA | Rotina Geradora | Caractere | 10 | X | WFNFIN ou WFNCASH ou WFNLEAS |
CT2_VALOR | Valor do Lançamento | Numérico | 16 | X | decimal deve ser enviado com o caractere ponto |
CT2_HIST | Histórico Lançamento | Caractere | 512 | X | ** tamanho Default no Protheus 40 |
CT2_EMPORI | Código da empresa de origem | Caractere | 2 | X | N/A |
CT2_FILORI | Código da Filial de origem | Caractere | 8 | X | N/A |
CT2_DEBITO | Conta Debito | Caractere | 20 | X | Obrigatório para tipos de lançamento: Débito e Partida dobrada |
CT2_CREDIT | Conta Credito | Caractere | 20 | X | Obrigatório para tipos de lançamento: Crédito e Partida dobrada |
CT2_TPSALD | Tipo de Saldo | Caractere | 1 | Conteúdo default = '1' | |
CT2_CCD | Centro de Custo Débito | Caractere | 9 | N/A | |
CT2_CCC | Centro de Custo Crédito | Caractere | 9 | N/A | |
CT2_ITEMD | Item Débito | Caractere | 9 | N/A | |
CT2_ITEMC | Item Crédito | Caractere | 9 | N/A | |
CT2_CLVLDB | Classe de Valor Débito | Caractere | 9 | N/A | |
CT2_CLVLCR | Classe de Valor Crédito | Caractere | 9 | N/A | |
CT2_EC05DB | Entidade Adicional (Sem Nomenclatura) | Caractere | 20 | N/A | |
CT2_EC05CR | Entidade Adicional (Sem Nomenclatura) | Caractere | 20 | N/A | |
CT2_EC06DB | Entidade Adicional (Sem Nomenclatura) | Caractere | 20 | N/A | |
CT2_EC06CR | Entidade Adicional (Sem Nomenclatura) | Caractere | 20 | N/A | |
CT2_EC07DB | Entidade Adicional (Sem Nomenclatura) | Caractere | 20 | N/A | |
CT2_EC07CR | Entidade Adicional (Sem Nomenclatura) | Caractere | 20 | N/A | |
CT2_EC08DB | Entidade Adicional (Sem Nomenclatura) | Caractere | 20 | N/A | |
CT2_EC08CR | Entidade Adicional (Sem Nomenclatura) | Caractere | 20 | N/A | |
CT2_EC09DB | Entidade Adicional (Sem Nomenclatura) | Caractere | 20 | N/A | |
CT2_EC09CR | Entidade Adicional (Sem Nomenclatura) | Caractere | 20 | N/A | |
CT2_CONVER | Critério de Conversão | Caractere | 5 | 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.
** 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_HISTIMPORTANTE!
04. TABELAS UTILIZADAS
- CT2- Lançamentos Contábeis
- CT1- Plano de Contas
- CTT- Centro de Custo
- CTH- Classe de Valor
- CTD - Item Contábil