Histórico da Página

Aviso

title	Aviso!

Produto ainda em fase de piloto.

CONTEÚDO

Visão Geral
Exemplo de utilização
Campos
Tabelas utilizadas
Demais informações

...

Modelo a ser seguido para a integração de Títulos a Pagar e/ou Receber realizados, sem previsão futura, enviados do sistema Gesplan para o Protheus.

...

O atributo typeindica o evento a ser executado no ERP. O job FWTotvsLinkJob identifica uma nova mensagem e executa a classe TITreadXGsp, responsável pela inclusão/exclusão/alteração dos títulos via rotina automática (FINA040 ou FINA050, conforme especificado no atributo OperationType). O fonte que contém a classe TITreadXGsp é o FINITITG.prw.

Bloco de código

language	java
title	Body da requisição de inclusão
collapse	true

	{
    "specversion": "1.0",
    "type": "TITreadXGsp",
    "tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
    "time": "2023-07-19T15:18:08.367574Z",
    "data": [
        {
            "CompanyId": "T1",
            "BranchId": "D MG 01",
            "OperationType" : "R",
			"OperationAction" : "I",
			"E1_NUM":   "10",
			"E1_PREFIXO": "GES",
			"E1_PARCELA": "A",
			"E1_TIPO": "NF",
			"E1_NATUREZ": "REC001",
		    "E1_EMISSAO":  "19/07/2023",
			"E1_VENCTO": "20/08/2023",
			"E1_MOEDA": 1,
			"E1_TXMOEDTXMOEDA": 0,
			"E1_CLIENTE": "000001",
			"E1_LOJA": "01",
            "E1_VALOR": 10500.50,
            "E1_HIST": "CAMPO LIVRE", 
            "ID": "ID001",
            "SYSCODE": "ID001" 
         },          
		 {
            "CompanyId": "T1",
            "BranchId": "D MG 02",
            "OperationType" : "P",			
			"OperationAction" : "I",
			"E1E2_NUM": "20",
			"E2_PREFIXO": "GES",
			"E2_PARCELA": "",
			"E2_TIPO": "NF",
			"E2_NATUREZ": "PAG001",
		    "E2_EMISSAO":  "19/07/2023",
			"E2_VENCTO": "20/08/2023",
			"E2_MOEDA": "2",
			"E2_TXMOEDTXMOEDA": 4.5,
			"E2_FORNECE": "000001",
			"E2_LOJA": "01",
            "E2_VALOR": 1000,
            "E2_HIST": "TITULO PAGAR MOEDA 2 - TAXA 4.5", 
            "ID": "ID002",
            "SYSCODE": "ID002" 
         }
     ]
}

Bloco de código

language	java
title	Body da requisição de exclusão
collapse	true

	{
    "specversion": "1.0",
    "type": "TITreadXGsp",
    "tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
    "time": "2023-07-19T15:18:08.367574Z",
    "data": [
        {
            "CompanyId": "T1",
            "BranchId": "D MG 01",
            "OperationType" : "R",
			"OperationAction" : "E",
			"E1_NUM":   "10",
			"E1_PREFIXO": "GES",
			"E1_PARCELA": "A",
			"E1_TIPO": "NF",
            "ID": "ID001",
            "SYSCODE": "ID001" 
         },          
		 {
            "CompanyId": "T1",
            "BranchId": "D MG 02",
            "OperationType" : "P",			
			"OperationAction" : "E",
			"E2_NUM": "20",
			"E2_PREFIXO": "GES",
			"E2_PARCELA": "",
			"E2_TIPO": "NF",
			"E2_FORNECE": "000001",
			"E2_LOJA": "01",
            "ID": "ID002",
            "SYSCODE": "ID002" 
         }
     ]
}

03. Outras Informações

a. Principais Campos e Parâmetros

Bloco de código

language	java
title	Body da requisição de alteração
collapse	true

	{
    "specversion": "1.0",
    "type": "TITreadXGsp",
    "tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
    "time": "2023-07-19T15:18:08.367574Z",
    "data": [
        {
            "CompanyId": "T1",
            "BranchId": "D MG 01",
            "OperationType" : "R",
			"OperationAction" : "A",
			"E1_NUM":   "10",
			"E1_PREFIXO": "GES",
			"E1_PARCELA": "A",
			"E1_TIPO": "NF",
			"E1_NATUREZ": "REC001",
		    "E1_EMISSAO":  "19/07/2023",
			"E1_VENCTO": "20/08/2023",
			"E1_MOEDA": 1,
			"E1_TXMOEDA": 0,
			"E1_CLIENTE": "000001",
			"E1_LOJA": "01",
            "E1_VALOR": 10600.50,
            "E1_HIST": "CAMPO LIVRE", 
            "ID": "ID001",
            "SYSCODE": "ID001" 
         },          
		 {
            "CompanyId": "T1",
            "BranchId": "D MG 02",
            "OperationType" : "P",			
			"OperationAction" : "A",
			"E2_NUM": "20",
			"E2_PREFIXO": "GES",
			"E2_PARCELA": "",
			"E2_TIPO": "NF",
			"E2_NATUREZ": "PAG001",
		    "E2_EMISSAO":  "19/07/2023",
			"E2_VENCTO": "20/08/2023",
			"E2_MOEDA": "2",
			"E2_TXMOEDA": 4.5,
			"E2_FORNECE": "000001",
			"E2_LOJA": "01",
            "E2_VALOR": 800,
            "E2_HIST": "TITULO PAGAR MOEDA 2 - TAXA 4.5", 
            "ID": "ID002",
            "SYSCODE": "ID002" 
         }
     ]
}

Card documentos

Informacao	Para o processo de alteração ("OperationAction" : "A") os únicos campos que serão atualizados são de Acréscimo e Decréscimo sendo para Pagar (E2_ACRESC, E2_DECRESC) e para Receber (E1_ACRESC, E1_DECRESC).
Titulo	IMPORTANTE!

03. Outras Informações

a. Principais Campos e Parâmetros

Campo	Descrição	Tipo	Tamanho(MAX)	Obrigatório	Observação
CompanyId	Código do Grupo de Empresas
Campo	Descrição	Tipo	Tamanho(MAX)	Obrigatório	Observação
CompanyId	Código da empresa	Caractere	2	x	Grupo de Empresa do Protheus. Todos os movimentos da mensagem devem pertencer ao mesmo Grupo de Empresa. Caso existam movimentos de Grupos de Empresa diferentes, deverão ser enviados em mensagens separadas.
BranchId	Código da Filial	Caractere	8	x	Filial do Protheus do Protheus. Identificação da filial do sistema onde ocorrerá a operação. Em ambientes com Gestão de Empresas o BranchId é composto pela Empresa + Unidade de Negócio + Filial
OperationType	Operação a ser realizada "P" ou "R"	Caractere	1	x	"P" = Título a Pagar "R" = Título a Receber
OperationAction	Ação de integração a ser realizada	Caractere	1	x	"I" = Inclusão "E" = Exclusão "A" = Alteração
E1_NUM (para OperationType="R") E2_NUM (para OperationType="P")	Número do documento	Caractere	9	x	Será complementado com "0" (zeros) a esquerda, quando o conteúdo passado for inferior ao tamanho do campo na base de dados.
E1_PREFIXO (para OperationType="R") E2_PREFIXO (para OperationType="P")	Prefixo de identificação do título	Caractere	3	x	N/A
E1_PARCELA (para OperationType="R") E2_PARCELA (para OperationType="P")	Parcela do título	Caractere	1	x	Pode ser enviado conteúdo vazio.
E1_TIPO (para OperationType="R") E2_TIPO (para OperationType="P")	Tipo	Caractere	3	x	Conforme tabela SX5 - NF, BOL, FT, etc.
E1_NATUREZ (para OperationType="R") E2_NATUREZ (para OperationType="P")	Natureza financeira	Caractere	10x	Somente para OperationAction igual a "I"	N/A
E1_EMISSAO (para OperationType="R") E2_EMISSAO (para OperationType="P")	Emissão do título	Caractere	10	x	Somente para OperationAction igual a "I"	A data deverá ser informada no formato "DD/MM/AAAA".N/A
E2_VENCTO (para OperationType="R") E2_VENCTO (para OperationType="P")	Vencimento do título	Caractere	10	x		10	Somente para OperationAction igual a "I"	A data deverá ser informada no formato "DD/MM/AAAA". Integração irá calcular o vencimento Real conforme a data informada.
E1_MOEDA (para OperationType="R") E2_MOEDA (para OperationType="P")	Moeda	Numérico	1x		N/A
E1_TXMOEDA (para OperationType="R") E2_TXMOEDA (para OperationType="P")	Taxa da moeda	Numérico	5	x		Para moeda 1-Real, indicar taxa 0
E1_CLIENTE (para OperationType="R") E2_FORNECE (para OperationType="P")	Código do Cliente ou Código de Fornecedor	Caractere	6	x	Indicar código válido de cliente ou fornecedor, conforme operação especificada no OperationType
E1_LOJA (para OperationType="R") E2_LOJA (para OperationType="P")	Loja do Cliente ou Fornecedor	Caractere	2	x	Conforme operação especificada no OperationType
E1_VALOR (para OperationType="R") E2_VALOR (para OperationType="P")	Valor do título	Numérico	16	x	Somente para OperationAction igual a "I"	O valor dos decimais deverá ser separado por "." (ponto). Ex: 1234.56 N/A
E1_HIST (para OperationType="R") E2_HIST (para OperationType="P")	Histórico	Caractere	40x		Pode ser enviado conteúdo vazio.
ID	Código de Controle Gesplan	Caractere		x	N/A
SYSCODE	Chave identificadora Gesplan	Caractere		x	N/A
Específico	Campo específico do ERP	Variável			Ver mais detalhes da utilização de campos específicos no "item b" abaixo.

...

Bloco de código

language	java
title	Body da requisição de inclusão com campo específico
collapse	true

	{
    "specversion": "1.0",
    "type": "TITreadXGsp",
    "tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
    "time": "2023-07-19T15:18:08.367574Z",
    "data": [
        {
            "CompanyId": "T1",
            "BranchId": "D MG 01",
            "OperationType" : "R",
			"OperationAction" : "I",
			"E1_NUM":   "10",
			"E1_PREFIXO": "GES",
			"E1_PARCELA": "A",
			"E1_TIPO": "NF",
			"E1_NATUREZ": "REC001",
		    "E1_EMISSAO":  "19/07/2023",
			"E1_VENCTO": "20/08/2023",
			"E1_MOEDA": 1,
			"E1_TXMOEDTXMOEDA": 0,
			"E1_CLIENTE": "000001",
			"E1_LOJA": "01",
            "E1_VALOR": 10500.50,
            "E1_HIST": "CAMPO LIVRE",
            "E1_CCUSTO": "CC001",
            "E1_XDTCLI": "01/07/2023",
            "ID": "ID001",
            "SYSCODE": "ID001" 
         },          
		 {
            "CompanyId": "T1",
            "BranchId": "D MG 02",
            "OperationType" : "P",			
			"OperationAction" : "I",
			"E1_NUM": "20",
			"E2_PREFIXO": "GES",
			"E2_PARCELA": "",
			"E2_TIPO": "NF",
			"E2_NATUREZ": "PAG001",
		    "E2_EMISSAO":  "19/07/2023",
			"E2_VENCTO": "20/08/2023",
			"E2_MOEDA": "2",
			"E2_TXMOEDTXMOEDA": 4.5,
			"E2_FORNECE": "000001",
			"E2_LOJA": "01",
            "E2_VALOR": 1000,
            "E2_HIST": "TITULO PAGAR MOEDA 2 - TAXA 4.5",
            "E2_CCUSTO": "CC001",
            "E2_XDTCLI": "01/07/2023",
            "ID": "ID002",
            "SYSCODE": "ID002" 
         }
     ]
}

...

SE1- Títulos a Receber
SE2- Títulos a Pagar

05. DEMAIS INFORMAÇÕES

Ponto de Entrada FiTitGsp para permitir a inclusão de campo/conteúdo específicoalteração do conteúdo do execauto do FINA040/FINA050

Árvore de páginas

Versões comparadas

Versão antiga 28

Nova versão Atual

Chave

CONTEÚDO

03. Outras Informações

03. Outras Informações

05. DEMAIS INFORMAÇÕES