Modelo de dados a ser seguido para a integração de lançamentos contábeis enviados do sistema Gesplan para Protheus.
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" ,
"CT2_LOTE": "998877",
"CT2_SBLOTE": "001",
"CT2_LINHA": "001",
"CT2_DC" : "3",
"CT2_CREDIT": "CTBXATUC",
"CT2_DEBITO": "CTBXATUD",
"CT2_VALOR": 1500.60 ,
"CT2_HIST": "PARTIDA DOBRADA VALOR COM DECIMAL E CONTINUACAO DE HISTORICO TIPO DE LANCAMENTO IGUAL A 4 CONTINUACAO DE HISTORICO",
"CT2_KEY": "ITEM 1",
"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": [
{
"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.
Principais Campos e Parâmetros
| Campo | Descrição | Tipo | Tamanho(MAX) | Obrigatório | Observação |
|---|---|---|---|---|---|
| COD_EMP | Código da empresa | Caractere | 2 | X | N/A |
| CT2_FILIAL | Código da Filial | Caractere | 8 | X | N/A |
| CT2_LOTE | Número do Lote | Caractere | 6 | X | Sequencial |
| CT2_SBLOTE | Sub Lote | Caractere | 3 | X | Sequencial |
| CT2_DATA | Data Lançamento | Caractere | 8 | X | Data enviada em formato caractere ddmmaaaa ex: "29/08/2022" |
| CT2_LINHA | Numero da Linha | Caractere | 3 | X | Sequencial |
| 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_CCD | Centro de Custo Débito | Caractere | 9 | N/A | |
| CT2_CCC | Centro de Custo Credor | Caractere | 9 | 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 |