...
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "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_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" }, { "CompanyId":"T1" , "BranchId": "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 | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"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 | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"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 | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "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": "DescriçãoDescripción dodel erroerror casosi houverhubiera" } ] } |
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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "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.
...