01. VISIÓN GENERAL

Configuraciones necesarias para el registro de boletas online del banco Santander.

El servicio que utilizamos para comunicación con el banco es la cobranza por XML.

Este registro de boletas (Santander) estará disponible solamente para el binario 20.3.0.3 o superior.


Red interna

Para la comunicación del Protheus con el banco es necesario configurar la seguriedad de red, si fuera necesario aceptar la salida del rango de IP referente al DNS: 

https://ymbdlb.santander.com.br/

https://ymbcash.santander.com.br/

02. ÍTEMS NECESARIOS (HABILITAR SERVICIO EN LA CUENTA)

Debe solicitar a su gerente la utilización del producto Cobranza por XML (registro de boletas XML).

.

Se solicitará el envío del certificado E-CNPJ o SSL, este mismo certificado debe utilizarse en la configuración del layout del NGF.

El certificado debe convertirse utilizando el Wizard de conversión de certificado - CFGX060 en el módulo configurador - SIGACFG y debe grabarse dentro de la carpeta cert/ngf (protheus_data).

Por el banco se encaminará su Código de estación y Código de convenio.

03. CONFIGURACIÓN DE CUENTAS

Para habilitar la configuración de un layout para el Santander, en el campo A6_BCOOFI (Banco oficial) debe informarse el código del Santander 033.

El layout exige que la agencia tenga 4 posiciones (sin dígito) y la cuenta 7 posiciones (sin dígito). 

Importante

Es necesario el registro correcto del dígito verificador de la cuenta en el campo Dv Cuenta (A6_DVCTA).

Si el registro estuviera incorrecto en la tabla de bancos (SA6), el ajuste debe realizarse en su subcuenta en el Registro Parámetros de bancos (tabla SEE) en los campos Age. Oficial (EE_AGEOFI), Cta. Oficial (EE_CTAOFI) y DV Cta.Ofic. (EE_DVCTOFI).

Ejemplo de cuenta que debe adecuarse: Cuenta 12345-6

En el registro del banco, campo Nº Cuenta (A6_NUMCOM) = 123456 y DV Cuenta (A6_DVCTA) = vacío, el ajuste en su subcuenta debe ser Cta. Oficial (EE_CTAOFI) = 12345 y DV Cta.Ofic. (EE_DVCTOFI) = 6

04. CONFIGURACIÓN DE LA SUBCUENTA

  • El código del Beneficiario de la cobranza se configura en la subcuenta (tabla SEE) por la rutina Parámetros del banco (FINA130) en el campo Cód. Empresa (EE_CODEMP).
  • Si nuestro número fuera generado por el sistema, este debe configurarse en la subcuenta (tabla SEE) por la rutina Parámetros del banco (FINA130) en los campos Rango inicial (EE_FAXINI), Rango final (EE_FAXFIM) y Rango actual (EE_FAXATU).
  • La dirección del cliente debe tener el número separado por coma para que se encamine correctamente al sistema del banco.
  • La configuración para "PROTESTO" de boletas tendrá como base el campo EE_DIASPRT (Días para protesto), si este campo estuviera completado con valor mayor que 0 (cero) el layout se configurará como "PROTESTAR" y el número de días será el valor del campo. En caso contrario se configurará con "DEVOLVER" en 02 días.

05. CONFIGURACIÓN DEL LAYOUT

En la etapa de Credenciales se solicitará el Código de estación suministrado por el banco y el nombre del Certificado y clave importado en el Protheus.

También deben observarse las siguientes reglas, en la transmisión por el API del banco :

  • Nuestro número: se enviará al banco una secuencia de 13 posiciones, que está compuesta por la siguiente regla:  secuencia (12 posiciones) + dígito verificador de secuencia (1 posición)

Ej.: Nuestro número con secuencia 999999999999 se enviará como 9999999999996 siendo el número 6 el dígito verificador.


  • Número del documento: En este campo debe informarse cuál será el número del documento que se transmitirá al banco y posteriormente se imprimirá en la boleta.

      Donde puede ser:

    1. Número del título (E1_NUM)
    2. ID CNAB (E1_IDCNAB)
    3. Expresión definida por el usuario.
      • El resultado de la expresión se atribuirá al campo “Número del documento”. Para las macroejecuciones la expresión que se ejecutará debe ser válida. Para informar una expresión, haga clic en el “Engranaje” que está al lado del campo.



  • Aceptación: Este campo indica el reconocimiento formal de la deuda (firma en el documento) por el pagador, deben informarse los valores:
    • - Cuando existe la necesidad de que el pagador reconozca/acepte la cobranza.
    • No - Cuando no existe la necesidad de reconocimiento de la cobranza.

  • Beneficiario sucursal: En este campo debe informarse la sucursal que se utilizará para la transmisión e impresión de la boleta. 

Los datos registrados en esta sucursal se utilizarán en la transmisión y en la impresión:


Atención

Si este campo no estuviera informado, la Sucursal actual (Sucursal conectada o Sucursal configurada en la agenda) se utilizará en los datos de la transmisión e impresión de la boleta.


  • Valor descuento: En este campo se podrá informar o no un valor de descuento para la boleta.

Donde podrá ser:

a. Vacío - Si el valor nominal ya está calculado con la deducción de los valores de descuento o no exista descuento para la boleta.

b. Valor Descuento (SomaAbat() - Cálculo estándar del sistema según la expresión:

    "SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)" .

c. Expresión definida por el usuario.

    •  El resultado de la expresión se atribuirá al campo "Valor Descuento". Para las macro ejecuciones, la expresión que se ejecutará debe tener validez. Para informar una expresión haga clic en "Engrenaje" que está al lado del campo.


Se puede informar el valor nominal ya deducido el valor del descuento. Simplemente haga clic en el engrenaje en el campo "Valor Nominal" e informe una expresión válida:

Ejemplo:

    • "SE1->E1_SALDO - SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)"

Importante

Si el valor nominal ya está calculado con la deducción de los valores de descuento, el campo "Valor Descuento" no se debe informar para que no ocurra una duplicación en el valor del descuento.

Si el campo "Valor Descuento" se informa, el campo "Valor Nominal" debe contener el valor completado (Sin la deducción del descuento). Si existiera descuento aparecerá un mensaje en el cuerpo de la boleta informando el valor del descuento ya calculado.