Histórico da Página

Aviso

title	Aviso

Producto aún en etapa piloto.

Fomato de respuesta:

ÍNDICE

Visión general
Ejemplo de utilización
Datos enviados
1. Principales campos y parámetros
2. Moneda del movimiento bancario
3. Campo específico/pesonalizado
4. Entes contables
Tablas

CONTEÚDO

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

01.

...

VISIÓN GENERAL

Modelo a ser seguido para a integração de Movimentos Bancários enviados do sistema Gesplan para o Protheus.

Modelo que se seguirá para la integración de Movimientos bancarios enviados del sistema Gesplan al Protheus.

El envío de datos debe realizarse vía SmartLink utilizando el Estándar CloudEventspara envío de mensajes en el formato Json.

El job FwTotvsLinkJob debe configurarse en el schedule, este es responsable por la lectura de los mensajes recibidos en la cola del O envio de dados deve ser realizado via SmartLink utilizando o Padrão CloudEventspara envio de mensagens no formato Json.O job FwTotvsLinkJob deve ser configurado no schedule, ele é responsável pela leitura das mensagens recebidas na fila do SmartLink.

02.

...

EJEMPLO DE

...

UTILIZACIÓN

A continuación tenemos el modelo de mensaje enviado por Abaixo temos o modelo de mensagem enviada pela Gesplan.

O El atributo type indica o evento a ser executado no el evento que se ejecutará en el ERP. O El job FWTotvsLinkJob identifica uma nova mensagem e excuta a classe MOVreadXGsp, responsável pela inclusão do Movimento Bancário (FINA100) via rotina automática. O fonte que contém a classe MOVreadXGsp é o un nuevo mensaje y ejecuta la clase MOVreadXGsp, responsable por la inclusión del Movimiento bancario (FINA100) vía rutina automática. El fuente que contiene la clase MOVreadXGsp es el FINI100G.prw.

Bloco de código

language	java
title	Json de envio Movimento Bancárioenvío Movimiento bancario
collapse	true

{
	"specversion": "1.0",
	"type": "MOVreadXGsp",
	"tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
	"time": "2022-11-08T15:18:08.367574Z",
	"data": [
			{ 
           	"COD_EMPCompanyId":"T1" ,
       		"E5_FILIALBranchId":  "D MG 01",
            "E5_VALOR":  100 ,
            "E5_MOEDA":"M1" ,
            "E5_DATA":"08/11/2022" ,
            "E5_NATUREZ":"AUT0000001" ,
			"E5_CCUSTO": "CTBXATUC"
            "E5_BANCO":"004" ,
            "E5_AGENCIA":"001" ,
            "E5_CONTA":"04001" ,        
            "E5_RECPAG": "S",
 			"E5_BENEF":"001" ,
 			"E5_DOCUMEN": "DOC ID002", 
              "E5_HISTOR": "MOV BANC PAGAR", 
            "SYSCODE": "SYSCODE001",
			"ID"	: "ID001"
        	},
        	{ 
            "COD_EMPCompanyId":"T1" ,
            "E5_FILIALBranchId":  "D MG 02",
            "E5_VALOR":  200 ,
            "E5_MOEDA":"M1" ,
            "E5_DATA":"08/11/2022" ,
            "E5_NATUREZ":"AUT0000001" ,
			"E5_CCUSTO": "CTBXATUC"
            "E5_BANCO":"004" ,
            "E5_AGENCIA":"001" ,
            "E5_CONTA":"04001" ,        
	        "E5_RECPAG": "E",
			"E5_BENEF":"001" ,
			"E5_DOCUMEN": "DOC ID002",
            "E5_HISTOR": "MOV BANC ENTRADA",
            "SYSCODE": "SYSCODE002",
 			"ID"	: "ID002" 
        	}
			]
}

Bloco de código

language	java
title	Json de envío Transferencia bancaria
collapse	true

03. Outras Informações

Principais Campos e Parâmetros

{
	"specversion": "1.0",
	"type": "MOVreadXGsp",
	"tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
	"time": "2024-06-17T13:18:08.367577Z",
	"data": [
			{              
			"CompanyId":"T1" ,
			"BranchId":"D MG 01",
			"CBCOORIG":"001",
			"CAGENORIG":"001",
			"CCTAORIG":"001",
			"CNATURORI":"VIN001",
			"CBCODEST":"SMS",
			"CAGENDEST":"001",
			"CCTADEST":"001",
			"CNATURDES":"VND001",
			"CTIPOTRAN":"CH",
			"CDOCTRAN":"2024002", 
			"NVALORTRAN":99.99 ,
			"CHIST100":"TRANSFERENCIA CUENTA",
			"CBENEF100":"TOTVS",
			"DDATACRED":"17/06/2024",
			"NCTBONLINE":2,
			"E5_RECPAG":"T",
			"SYSCODE":"SYSCODE001",
			"ID":"ID001"          
			}
			]
}

Bloco de código

language	java
title	Json de envÍo Reversión Transferencia
collapse	true

{
	"specversion": "1.0",
	"type": "MOVreadXGsp",
	"tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
	"time": "2024-06-17T13:18:08.367577Z",
	"data": [
			{  
			"CompanyId":"T1" ,
			"BranchId":"D MG 01",
			"AUTNRODOC":"2024002",
			"AUTDTMOV":"17/06/2024",
			"AUTBANCO":"001",
			"AUTAGENCIA":"001",
			"AUTCONTA":"001",
			"E5_RECPAG":"X",
			"SYSCODE":"SYSCODE001",
			"ID":"ID001"          
			}
			]
}

Fomato de respuesta:

Bloco de código

language	java
title	Ejemplo de respuesta
collapse	true

{
	"specversion": "1.0",
	"type": "MOVrespXGsp",
	"tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
	"time": "2022-11-08T15:18:08.367574Z",
	"data": [
			{
   		    "CompanyId":"T1" ,
       		"BranchId":  "D MG 01",
            "SYSCODE": "SYSCODE001", 
		 	"ID"	: "ID001"  ,
			"error": "Descripción del error si hubiera"       
			}
			]
}

03. DATOS ENVIADOS

a. Principales campos y parámetros

a1. Movimiento bancario por pagar o cobrar

Campo

Descripción

Tipo

Tamaño(MÁX)

Obligatorio

Observación

CompanyId

Código del grupo de empresas

Carácter

2

X

Grupo de empresa del Protheus.

BranchId

Código de la sucursal

Carácter

8

X

Sucursal del Protheus.

Identificación de la sucursal del sistema donde ocurrirá el movimiento bancario. En entornos con Gestión de empresas, el BranchId está compuesto por Empresa + Unidad de negocio + Sucursal

E5_MOEDA

Dinero

Carácter

...

	2	X	N/A
E5_VALOR	Valor

...

del movimiento

Numérico

16

X

...

Decimal debe enviarse con el carácter punto

E5_DATA

...

Fecha del movimiento

...

Carácter

10

X

...

Fecha enviada

...

en formato

...

carácter ddmmaaaa

...

ej: "08/09/2022"

E5_NATUREZ

...

Modalidad

...

Carácter	10	X	N/A
E5_BANCO	Código

...

del banco

...

Carácter	3	X	N/A
E5_AGENCIA	Agencia

...

del banco

...

Carácter	5	X	N/A
E5_CONTA

...

Cuenta corriente en el banco

...

Carácter	10	X	N/A
E5_RECPAG

...

Cobranza o Pago

Carácter

...

1

X

Enviar:

"S" →

...

Movimiento por pagar (

...

salida)

"E" →

...

Movimiento por cobrar (entrada)
E5_CCUSTO	Centro de

...

costo

...

Carácter	9		N/A
E5_BENEF

...

Beneficiario

...

Carácter	30		N/A
E5_DOCUMEN	Número del documento	Carácter	50	N/A
E5_HISTOR

...

Historial del movimiento

Carácter

...

	40		N/A
SYSCODE

...

Clave identificadora Gesplan

...

Carácter		X	N/A
ID	Código de control Gesplan	Carácter		X	N/A
Específico	Variable				Ver más detalles de la utilización de campos específicos en el "ítem c" siguiente.

a2. Transferencia bancaria

Campo

Descripción

Tipo

Tamaño(MAX)

Obligatorio

Observación

CompanyId

Código del Grupo de empresas

Carácter

2

X

Grupo de empresa del Protheus.

BranchId

Código de la sucursal

Carácter

8

X

Sucursal del Protheus.

Identificación de la sucursal del sistema donde ocurrirá el movimiento bancario. En entornos con Gestión de empresas el BranchId está compuesto por la Empresa + Unidad de negócio + Sucursal

CBCOORIG

Código

...

del banco origen	Carácter	3	X	N/A
CAGENORIG	Código de la agencia origen	Carácter	5	X	N/A
CCTAORIG	Cuenta corriente origen	Carácter	10	X	N/A
CNATURORI	Modalidad origen	Carácter	10	X	N/A
CBCODEST	Código del banco destino	Carácter	3	X	N/A
CAGENDEST	Código de la agencia destino	Carácter	5	X	N/A
CCTADEST	Conta corrente destino	Carácter	10	X	N/A
CNATURDES	Modalidad destino	Carácter	10	X	N/A
CTIPOTRAN	Tipo da transferencia	Carácter	6	X	N/A
CDOCTRAN	Número del documento	Carácter	15	X	N/A
NVALORTRAN	Valor que será transferido del banco origen al banco destino.	Numérico	16	X	Decimal debe enviarse con el carácter punto
CHIST100	Historial de la transferencia	Carácter	40	X	Historial referente a la transferencia efectuada.
CBENEF100	Beneficiario	Carácter	30	X	Nombre del favorecido en el caso de emitirse un cheque referente a transferencia.
NCTBONLINE	¿Contabiliza On Line?	Numérico	1		1=Sí;2=No
DDATACRED	Fecha de crédito	Carácter	10	X	Fecha enviada en formato carácter ddmmaaaa ej: "08/09/2022"
E5_RECPAG	Cobranza o pago	Carácter	1	X	Enviar: "T" → Transferencia bancaria (salida)
SYSCODE	Clave identificadora Gesplan	Carácter

...

X

N/A

...

a3. Reversión de transferencias

Campo	Descripción	Tipo	Tamaño(MAX)	Obligatorio	Observación
CompanyId	Código del Grupo de empresas	Carácter	2	X	Grupo de Empresa do Protheus.
BranchId	Código de la sucursal	Carácter	8	X	Sucursal del Protheus. Identificación de la sucursal del sistema donde ocurrirá el movimiento bancario. En entornos con Gestión de empresas el BranchId está compuesto por la Empresa + Unidad de negocio + Sucursal
AUTNRODOC	Número del documento	Carácter	15	X	N/A
AUTDTMOV	Fecha del movimiento	Carácter	10	X	Fecha enviada en formato carácter ddmmaaaa ej: "08/09/2022"
AUTBANCO	Código del banco	Carácter	3	X	Código del banco al que se refiere al documento que será revertido
AUTAGENCIA	Agencia del banco	Carácter	5	X	Agencia del banco al que se refiere el documento que será revertido
AUTCONTA	Cuenta corriente en el banco	Carácter	10	X	Cuenta a la que se refiere el documento que se revertirá
E5_RECPAG	Tipo de movimiento	Carácter	1	X	Enviar: "X" → Reversión de la transferencia
SYSCODE	Clave identificadora Gesplan	Carácter		X	N/A
ID	Código de control Gesplan	Carácter		X	N/A

b. Moneda del movimento bancario

El Movimiento bancario se generará en la moneda del banco informado. De esta manera, al presentarse en informes y consultas, solamente tendrá su valor convertido si la moneda solicitada en los parámetros fuera diferente de la moneda del registro del banco.

c. Campo específico/personalizado

Existe la posibilidad de enviar cualquier otro campo existente en el diccionario de datos de la tabla SE5 del entorno donde se está procesando el mensaje. Este campo puede ser un campo estándar (no ejemplificado en la tabla anterior) o un campo personalizado (creado específicamente para el entorno Protheus donde la integración está activa). En este caso, basta que se inscluya una nueva línea en el contenido del mensaje, con el mismo formato Clave/Valor, de acuerdo con el siguiente ejemplo, donde incluimos los campos E5_DEBITO (campo estándar del producto) y E5_XDTCLI (campo específico del ERP del cliente).

Bloco de código

language	java
title	Campos específicos
linenumbers	true
collapse	true

{
	"specversion": "1.0",
	"type": "MOVreadXGsp",
	"tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
	"time": "2022-11-08T15:18:08.367574Z",
	"data": [
			{ 
           	"CompanyId":"T1" ,
       		"BranchId":  "D MG 01",
            "E5_VALOR":  100 ,
            "E5_MOEDA":"M1" ,
            "E5_DATA":"08/11/2022" ,
            "E5_NATUREZ":"AUT0000001" ,
            "E5_BANCO":"004" ,
            "E5_AGENCIA":"001" ,
            "E5_CONTA":"04001" ,        
            "E5_RECPAG": "S",
			"E5_DEBITO": "DEB000001"
			"E5_XDTCLI ": "09/11/2022",
			"E5_RECPAG": "S",
            "SYSCODE": "SYSCODE001",
			"ID"	: "ID001"
        	}
			]
}

d. Entes contables

A continuación se muestran los principales campos representando los entes contables que pueden utilizarse para clasificación del movimiento.

E5_DEBITO - Cuenta débito
E5_CREDITO - Cuenta crédito
E5_CCD - Centro de costo débito
E5_CCC - Centro de costo crédito
E5_ITEMD - Ítem contable débito
E5_ITEMC - Ítem contable crédito
E5_CLVLDB - Clase valor débito
E5_CLVLCR - Clase valor crédito

Card documentos

Informacao

Los campos SysCode y ID no se grabarán en el ERP, estos solamente son informaciones de control de Gesplan, que llegará en la requisición y se enviarán en la respuesta del procesamiento, indicando éxito o falla de la inclusión de este Movimiento bancario. Además de los índices consultados a disposición, es posible listar los registros generados por medio del campo origen, con contenido FINI100G.

Titulo

IMPORTANTE

04. TABLAS UTILIZADAS

SE5- Movimiento bancario
FK5- Movimientos bancarios
FK8- Datos contables

O Movimento Bancário será gerado na moeda do banco informado. Sendo assim, quando apresentado em relatórios e consultas, somente terá seu valor convertido se a moeda solicitada nos parâmetros for diferente da moeda do cadastro do banco.

Card documentos

Informacao	Os 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ário. Além dos índices de pesquisas disponíveis, é possível listar os registros gerados através do campo origem, com conteúdo FINI100G.
Titulo	IMPORTANTE!

04. TABELAS UTILIZADAS

SE5- Movimentação Bancária
FK5- Movimentos Bancários

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Fomato de respuesta:

ÍNDICE

CONTEÚDO

01.

VISIÓN GENERAL

02.

EJEMPLO DE

UTILIZACIÓN

03. Outras Informações

03. DATOS ENVIADOS

04. TABLAS UTILIZADAS

04. TABELAS UTILIZADAS