Árvore de páginas

Versões comparadas

Chave

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

Produto ainda em fase de piloto.

...

CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilizaçãoOutras Informações 
  3. Principais Campos e Parâmetros
    Moeda do Movimento Bancário
  4. Tabelas utilizadas
  5. Demais informações


01. VISÃO GERAL


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

...

O job FwTotvsLinkJob deve ser configurado no schedule, ele é responsável pela leitura das mensagens recebidas na fila do SmartLink.


02. EXEMPLO DE UTILIZAÇÃO

Abaixo temos o modelo de mensagem enviada pela Gesplan.

O atributo typeindica o evento a ser executado no ERP. O job FWTotvsLinkJob identifica uma nova mensagem e excuta executa a classe TITreadXGsp, responsável pela inclusão/exclusã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
languagejava
titleJson de envio Movimento BancárioBody da requisição de inclusão
collapsetrue
	{
    "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" : "P"R",
			"OperationAction" : "I",
			"DocumentNumberE1_NUM":   "10",
			"DocumentPrefixE1_PREFIXO": "GES",
			"DocumentParcelE1_PARCELA": "A",
			"DocumentTypeCodeE1_TIPO": "NF",
			"FinancialNatureIDE1_NATUREZ": "PAG001REC001",
		    "IssueDateE1_EMISSAO":  "2023071919/07/2023",
			"DueDateE1_VENCTO": "2023081820/08/2023",
			"CurrencyE1_MOEDA": "1",
			"CurrencyRateE1_TXMOEDA": "0",
			"EntityIdE1_CLIENTE": "000001",
			"EntityBranchE1_LOJA": "01",
            "ValueE1_VALOR": 10500.50,
            "HistoryE1_HIST": "IntegraçãoCAMPO GesplanLIVRE", 
            "ID": "ID001",
            "SYSCODE": "ID001" 
         },          
		 {
            "CompanyId": "T2T1",
            "BranchId": "D MG 0102",
            "OperationType" : "RP",			
			"OperationAction" : "I",
			"DocumentNumberE2_NUM": "1020",
			"DocumentPrefixE2_PREFIXO": "GES",
			"DocumentParcelE2_PARCELA": "",
			"DocumentTypeCodeE2_TIPO": "NF",
			"FinancialNatureIDE2_NATUREZ": "REC001PAG001",
		    "IssueDateE2_EMISSAO":  "2023071919/07/2023",
			"DueDateE2_VENCTO": "2023081820/08/2023",
			"CurrencyE2_MOEDA": "2",
			"CurrencyRateE2_TXMOEDA": "4.5",
			"EntityIdE2_FORNECE": "000001",
			"EntityBranchE2_LOJA": "01",
            "Value": 10500,
"E2_VALOR": 1000,
            "E2_HIST": "TITULO PAGAR MOEDA 2 - TAXA 4.5", 
            "ID": "ID002",
            "SYSCODE": "ID002" 
         }
     ]
}
Bloco de código
languagejava
titleBody da requisição de exclusão
collapsetrue
	{
    "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"  "History: "R",
			"OperationAction" : "E",
			"E1_NUM":   "10",
			"E1_PREFIXO": "Integração Gesplan", "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

CampoDescriçãoTipoTamanho(MAX)ObrigatórioObservação
CompanyIdCódigo do Grupo de EmpresasCaractere2x

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.

BranchIdCódigo da FilialCaractere8x

Filial 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"

Caractere1x

"P" = Título a Pagar

"R" = Título a Receber

OperationAction

Ação de integração a ser realizada

Caractere1x

"I" = Inclusão

"E" = Exclusão

E1_NUM (para OperationType="R")

E2_NUM (para OperationType="P")

Número do documentoCaractere9xSerá 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ítuloCaractere3xN/A

E1_PARCELA (para OperationType="R")

E2_PARCELA (para OperationType="P")

Parcela do títuloCaractere1xPode ser enviado conteúdo vazio. 

E1_TIPO (para OperationType="R")

E2_TIPO (para OperationType="P")

Tipo 

Caractere3xConforme tabela SX5 - NF, BOL,  FT,  etc.

E1_NATUREZ (para OperationType="R")

E2_NATUREZ (para OperationType="P")

Natureza financeiraCaractere10Somente para OperationAction igual a "I"N/A

E1_EMISSAO (para OperationType="R")

E2_EMISSAO (para OperationType="P")

Emissão do títuloCaractere10Somente para OperationAction igual a "I"A data deverá ser informada no formato "DD/MM/AAAA".

E2_VENCTO (para OperationType="R")

E2_VENCTO (para OperationType="P")

Vencimento do títuloCaractere10Somente 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")

MoedaNumérico1
N/A

E1_TXMOEDA (para OperationType="R")

E2_TXMOEDA (para OperationType="P")

Taxa da moedaNumérico5
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 FornecedorCaractere6xIndicar 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  FornecedorCaractere2xConforme operação especificada no OperationType

E1_VALOR (para OperationType="R")

E2_VALOR (para OperationType="P")

Valor do títuloNumérico16Somente para OperationAction igual a "I"

O valor dos decimais deverá ser separado por "." (ponto).

Ex: 1234.56

E1_HIST (para OperationType="R")

E2_HIST (para OperationType="P")

HistóricoCaractere40
Pode ser enviado conteúdo vazio.
ID

Código de Controle Gesplan

Caractere
xN/A
SYSCODEChave identificadora GesplanCaractere
xN/A
EspecíficoCampo específico do ERPVariável

Ver mais detalhes da utilização de campos específicos no "item b" abaixo.

b. Campo específico/customizado

Existe a possibilidade de enviar qualquer outro campo existente no dicionário de dados da tabela SE1 (Contas a Receber) para OperationType do tipo "R" ou SE2 (Contas a Pagar) para OperationType do tipo "P" do ambiente onde está sendo processada a mensagem.

Esse campo pode ser um campo padrão (não exemplificado na tabela acima) ou um campo customizado (criado especificamente para o ambiente Protheus em que a integração está ativa). Nesse caso, basta que seja inserida uma nova linha no conteúdo da mensagem, com o mesmo formato Chave/Valor, conforme exemplo abaixo, onde inserimos os campos E1_CCUSTO (campo padrão do produto) e E1_XDTCLI (campo específico do ERP do cliente) no movimento com OperationType do tipo "R" e E2_CCUSTO (campo padrão do produto) e E2_XDTCLI (campo específico do ERP do cliente) no movimento com OperationType do tipo "P".

Bloco de código
languagejava
titleBody da requisição de inclusão com campo específico
collapsetrue
	{
    "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_TXMOEDA": 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_TXMOEDA": 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" 
         }
     ]
}


Card documentos
InformacaoOs campos SysCode e ID não serão gravados no ERP, eles são somente informações de controle da Gesplan, que chegará na requisição e serão enviados na resposta do processamento, indicando sucesso ou falha da inclusão desse Movimento Bancáriotítulo. Além dos índices de pesquisas disponíveis, é possível listar os registros gerados através do campo origem, com conteúdo FINI100GFINITITG.
TituloIMPORTANTE!


04. TABELAS UTILIZADAS

...

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

05. DEMAIS INFORMAÇÕES

Ponto de Entrada FiTitGsp para permitir a alteração do conteúdo do execauto do FINA040/FINA050