OpCortesDiarios

El método OpCortesDiarios permite consultar información de cortes diarios registrados en el Gateway de Pagos de OEL.

Mediante esta operación, el comercio puede solicitar los registros correspondientes a un intervalo de fechas y obtener información resumida de las transacciones, incluyendo cantidades de operaciones, importes, comisiones, IVA, devoluciones y saldos.

Este método resulta útil para desarrollar reportes administrativos, consultar los totales registrados y apoyar los procesos de conciliación financiera.

A diferencia de OpTransacciones, que devuelve información individual de cada operación, OpCortesDiarios devuelve registros de corte con información agregada.

Información del servicio

Se recomienda utilizar TLS 1.2 o superior, conforme a los requisitos de seguridad aplicables a la integración.

Autenticación

La operación utiliza la cabecera SOAP OpHeader, mediante las credenciales asignadas al comercio por OEL.

Adicionalmente, el cuerpo de la solicitud contempla comercioId y contrasena, utilizados para identificar al comercio que realiza la consulta.

Las credenciales deben mantenerse protegidas y no incorporarse en repositorios públicos, registros de diagnóstico ni ejemplos de documentación.

Parámetros de solicitud (Request)

El método recibe un objeto request de tipo cCortesReq, compuesto por 4 parámetros.

Consideraciones sobre los parámetros

comercioId

Identifica al comercio que realiza la consulta. Debe utilizarse el identificador asignado por OEL.

contrasena

Corresponde a la contraseña de autenticación del comercio. Debe mantenerse protegida y transmitirse exclusivamente mediante conexiones seguras.

FechaInicio y FechaFin

Ambos parámetros utilizan el tipo XML Schema dateTime.

Ejemplo de representación:

2026-10-01T00:00:00

Ejemplo XML Request — SOAP 1.1

El siguiente ejemplo muestra una solicitud de cortes diarios para un intervalo de fechas, utilizando credenciales ficticias y simbólicas.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns="https://servidorseguro.operacionesenlinea.com/">

  <soap:Header>
    <OpHeader>
      <OpKey1>CLAVE_1_ASIGNADA</OpKey1>
      <OpKey2>CLAVE_2_ASIGNADA</OpKey2>
    </OpHeader>
  </soap:Header>

  <soap:Body>
    <OpCortesDiarios>
      <request>
        <comercioId>12345</comercioId>
        <contrasena>CLAVE_COMERCIO</contrasena>
        <FechaInicio>2026-10-01T00:00:00</FechaInicio>
        <FechaFin>2026-10-03T00:00:00</FechaFin>
      </request>
    </OpCortesDiarios>

Los valores son exclusivamente ilustrativos y no representan credenciales válidas.

Las fechas del ejemplo no establecen una regla oficial sobre la inclusión de los extremos del intervalo.

Para enviar la solicitud mediante SOAP 1.1, utiliza las siguientes cabeceras HTTP:

Estructura de respuesta (Response)

El servicio devuelve un mensaje SOAP que contiene el elemento OpCortesDiariosResponse.

Dentro de este elemento se encuentra OpCortesDiariosResult, de tipo ArrayOfCorteDiario.

La colección puede contener cero o más elementos CorteDiario, cada uno compuesto por 10 parámetros.

La estructura conceptual es:

El WSDL permite que la colección esté ausente o vacía y que sus elementos individuales sean nulos.

Los integradores deben contemplar estas posibilidades al procesar la respuesta.

Parámetros de cada corte diario

Identificación y fecha

Información de transacciones

Información de devoluciones y saldo

Tipos numéricos

El WSDL utiliza dos tipos numéricos diferentes para los importes:

Los integradores deben respetar estos tipos al deserializar las respuestas.

Para cálculos financieros posteriores se recomienda utilizar representaciones decimales de precisión adecuada, evitando introducir errores de redondeo derivados de la aritmética de punto flotante.

Ejemplo XML Response — Cortes diarios

El siguiente ejemplo representa una respuesta ficticia que contiene dos registros de corte diario.

Los importes, fechas y cantidades son ilustrativos y no representan tarifas, reglas de liquidación ni fórmulas oficiales.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns="https://servidorseguro.operacionesenlinea.com/">

  <soap:Body>
    <OpCortesDiariosResponse>
      <OpCortesDiariosResult>

Los valores utilizados son exclusivamente ilustrativos.

En particular:

• ID no debe asumirse como el identificador del comercio.

• Nombre contiene un valor ficticio.

• Fecha no establece la hora oficial de corte del servicio.

• Comision e Iva no representan una tarifa oficial.

• SaldoTrans no establece una fórmula de cálculo validada por OEL.

Respuesta sin registros

El contrato permite que la colección no contenga elementos CorteDiario.

Una representación estructuralmente válida de una colección vacía es:

<OpCortesDiariosResponse
  xmlns="https://servidorseguro.operacionesenlinea.com/">
  <OpCortesDiariosResult />
</OpCortesDiariosResponse>

Este ejemplo ilustra una colección vacía conforme al esquema, pero no garantiza que el servicio utilice exactamente esta representación cuando no existen cortes para el intervalo solicitado.

Interpretación de la respuesta

Identificación del corte

Cada elemento CorteDiario contiene un identificador ID, un campo opcional Nombre y una fecha Fecha.

Totales de transacciones

Los parámetros NumTransacciones y MontoTotal permiten conocer las cantidades e importes reportados en cada corte.

Comisiones e impuestos

Los campos Comision e Iva proporcionan importes asociados a estos conceptos.

Devoluciones

Los campos NumDevoluciones y MontoDevoluciones contienen las cantidades e importes registrados como devoluciones.

Saldo

El parámetro SaldoTrans corresponde al importe neto del día que se acreditará al comercio.

Consideraciones técnicas

• Intervalos de fechas: El rango máximo permitido son 3 dias naturales.

• Periodicidad: Los Cortes se generan de forma diaria y no pueden modificarse después de su creación.

• Agrupación: Cada registro corresponde a un comercio/dia

• Colecciones vacías: manejar correctamente respuestas sin elementos CorteDiario.

• Precisión numérica: respetar los tipos definidos en el WSDL y utilizar aritmética decimal apropiada para los cálculos financieros.

• Conciliación: no asumir que SaldoTrans equivale a un depósito o liquidación bancaria.

• Seguridad: proteger las credenciales de autenticación y utilizar conexiones HTTPS seguras.

• Trazabilidad: conservar los identificadores, fechas e importes necesarios para relacionar los cortes con los registros administrativos del comercio.

Relación con otros métodos