Inicio
Pagos Presenciales
Tokenización
Aliados
Ambientes
Referencia API
Recursos
2
2
min read
El método detalleComercio permite consultar la información registrada de un establecimiento afiliado a Operaciones en Línea (OEL), utilizando su identificador comercioId.
La operación devuelve datos de identificación, información comercial, domicilio fiscal, representante legal, cuenta bancaria, comisiones, productos configurados y contactos del establecimiento.
También contempla las credenciales transaccionales del comercio y las credenciales de acceso al portal.
Este método es exclusivamente de consulta. Su contrato no contempla parámetros para modificar los datos del establecimiento ni ejecutar operaciones financieras.
Información del servicio
Propiedad | Valor |
|---|---|
Método |
|
Servicio |
|
Categoría | Administración de comercios |
Operación | Consulta de información de un comercio |
Protocolo | SOAP 1.1 / SOAP 1.2 |
Transporte | HTTPS |
Estilo |
|
Namespace |
|
SOAPAction |
|
Tipo Request |
|
Tipo Response |
|
Parámetros Request | 3 |
Parámetros Response | 51 |
Endpoint de producción
Endpoint de desarrollo
Autenticación
El método utiliza dos mecanismos de identificación:
Cabecera SOAP
OpHeader.Credenciales del aliado dentro del objeto
request.
Cabecera SOAP
Parámetro | Tipo | Descripción |
|---|---|---|
| string | Primera llave de autenticación asignada por OEL. |
| string | Segunda llave de autenticación asignada por OEL. |
<soap:Header> <OpHeader xmlns="https://servidorseguro.operacionesenlinea.com/"> <OpKey1>CLAVE_1_ASIGNADA</OpKey1> <OpKey2>CLAVE_2_ASIGNADA</OpKey2> </OpHeader>
Credenciales del aliado
Los parámetros claveAliado y contrasena identifican al aliado que solicita la información.
No deben confundirse con las credenciales del comercio que pueden aparecer en la respuesta.
Parámetros de solicitud (Request)
La operación recibe un objeto request de tipo cDetalleReq, compuesto por tres parámetros.
Parámetro | Tipo WSDL | Requerido | Descripción |
|---|---|---|---|
| string | Sí | Clave o identificador del aliado asignado por OEL. |
| string | Sí | Contraseña de acceso del aliado. |
| int | Sí | Identificador del comercio cuya información se desea consultar. |
Consideraciones de los parámetros
claveAliado
Identifica al aliado que realiza la consulta.
Se establece para esta credencial un máximo de diez caracteres alfanuméricos sin espacios.
contrasena
Corresponde a la contraseña del aliado.
Se establece un máximo de doce caracteres alfanuméricos sin espacios.
comercioId
Identifica al establecimiento que se desea consultar.
Este valor puede obtenerse de la respuesta de afiliacionComercio, una vez confirmada la afiliación.
Restricciones operativas
El aliado puede consultar únicamente comercios afiliados por él.
No existe ninguna posibilidad o permisos para consultar comercios de terceros.
No pueden consultarse comercios suspendidos, inactivos o dados de baja.
Ejemplo XML Request — SOAP 1.1
Petición HTTP
Cuerpo SOAP
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<OpHeader xmlns="https://servidorseguro.operacionesenlinea.com/">
<OpKey1>CLAVE_1_ASIGNADA</OpKey1>
<OpKey2>CLAVE_2_ASIGNADA</OpKey2>
</OpHeader>
</soap:Header>
<soap:Body>
<detalleComercio xmlns="https://servidorseguro.operacionesenlinea.com/">
<request>
<claveAliado>ALIADO_DEMO</claveAliado>
<contrasena>CLAVE_ALIADO</contrasena>
<comercioId>12345</comercioId>
</request>
</detalleComercio>
Los valores de autenticación son simbólicos y el identificador del comercio es ficticio. Para ejecutar la solicitud deben sustituirse por credenciales y datos válidos del ambiente correspondiente.
Parámetros de respuesta (Response)
El servicio devuelve un objeto detalleComercioResult, de tipo cDetalleResp, dentro del elemento detalleComercioResponse.
La respuesta contiene 51 parámetros, organizados a continuación por categorías funcionales.
Las tablas conservan el orden exacto de los elementos establecido por el WSDL.
1. Identificación y credenciales
Parámetro | Tipo | Descripción |
|---|---|---|
| int | Identificador del aliado asociado al comercio. |
| string | Nombre del aliado. |
| int | Identificador del comercio consultado. |
| string | Contraseña transaccional del comercio. |
| string | Información de afiliación registrada. |
| string | Usuario de acceso al portal. |
| string | Contraseña de acceso al portal. |
Consideraciones
El campo comercioId permite relacionar la información devuelta con el establecimiento solicitado.
Los campos contrasena y contrasenaPortal contienen potencialmente información de autenticación y deben tratarse como secretos.
2. Información comercial
Parámetro | Tipo | Descripción |
|---|---|---|
| int | Tipo de comercio registrado. |
| string | Giro o actividad comercial. |
| string | Nombre comercial del establecimiento. |
| string | Dirección operativa. |
| string | Colonia del establecimiento. |
| string | Ciudad del establecimiento. |
| string | Entidad federativa. |
| string | Código postal. |
| string | Teléfono de contacto. |
| string | Correo electrónico principal. |
Interpretación de tipo
Se describe los siguientes valores para el campo tipo :
Valor | Descripción |
|---|---|
| Persona física |
| Persona moral |
Interpretación de giro
Contiene la clave de actividad comercial registrada.
El catálogo de giros debe consultarse para obtener su descripción.
3. Información operativa y facturación estimada
Parámetro | Tipo | Descripción |
|---|---|---|
| decimal | Facturación mensual estimada registrada. |
| decimal | Importe promedio por transacción. |
| decimal | Importe máximo esperado por transacción. |
| int | Horario de apertura registrado. |
| int | Horario de cierre registrado. |
Estos campos describen información comercial registrada durante el proceso de afiliación.
No deben interpretarse como indicadores financieros calculados a partir de las transacciones realmente procesadas.
Por ejemplo, facturacionMensual corresponde a la información registrada del comercio, no necesariamente a la facturación efectiva del mes.
Los horarios se representan como enteros.
4. Información fiscal
Parámetro | Tipo | Descripción |
|---|---|---|
| string | Registro Federal de Contribuyentes. |
| string | Razón social del comercio. |
| string | Dirección fiscal. |
| string | Colonia fiscal. |
| string | Ciudad fiscal. |
| string | Entidad federativa del domicilio fiscal. |
| string | Código postal fiscal. |
| string | Teléfono de contacto para facturación. |
| string | Persona de contacto para facturación. |
5. Representante legal
Parámetro | Tipo | Descripción |
|---|---|---|
| string | Nombre del representante legal. |
| string | Apellidos del representante legal. |
| string | Fecha de nacimiento del representante legal. |
Estos datos corresponden a la información registrada durante la afiliación.
Los datos del representante legal se requieren para el procesamiento de tarjetas American Express.
6. Información bancaria
Parámetro | Tipo | Descripción |
|---|---|---|
| int | Identificador de la institución bancaria. |
| string | CLABE de la cuenta bancaria de liquidación. |
| string | Nombre del titular de la cuenta bancaria. |
La información bancaria corresponde a la cuenta registrada para la liquidación de ventas.
7. Comisiones registradas
Parámetro | Tipo | XSD | Descripción |
|---|---|---|---|
| decimal | R | Comisión registrada para tarjetas de débito. |
| decimal | R | Comisión registrada para tarjetas de crédito. |
| decimal | R | Comisión registrada para American Express. |
| decimal | R | Comisión registrada para tarjetas internacionales. |
| decimal | R | Comisión registrada para tarjetas de valeras. |
Se describen las comisiones como porcentajes.
Por ejemplo:
<debito>2.50</debito> <credito>3.00</credito> <amex>3.50</amex> <internacional>4.00</internacional> <valeras>2.00</valeras>
Estos valores son ficticios.
8. Productos configurados
Parámetro | Tipo | XSD | Descripción |
|---|---|---|---|
| boolean | R | Configuración de Link de Pago. |
| boolean | R | Configuración de terminal punto de venta. |
| boolean | R | Configuración de comercio electrónico. |
Los valores son booleanos.
Valor | Interpretación |
|---|---|
| Producto marcado como habilitado en la configuración consultada. |
| Producto marcado como no habilitado en la configuración consultada. |
Importante: estos campos reflejan la configuración devuelta por el servicio.
No permiten determinar por sí solos si existen validaciones pendientes, restricciones comerciales o condiciones adicionales que impidan operar el producto.
9. Contacto técnico
Parámetro | Tipo | XSD | Descripción |
|---|---|---|---|
| string | O | Nombre del contacto técnico. |
| string | O | Teléfono del contacto técnico. |
| string | O | Correo electrónico del contacto técnico. |
Estos campos permiten identificar al responsable técnico registrado para el comercio.
10. Resultado de la operación
Parámetro | Tipo | XSD | Descripción |
|---|---|---|---|
| int | R | Código funcional del resultado de la consulta. |
| int | R | Código complementario de error. |
| string | O | Mensaje descriptivo del resultado. |
La aplicación debe evaluar estos campos conforme a los códigos confirmados por OEL.
Ejemplo XML Response — SOAP 1.1
El siguiente ejemplo representa una respuesta ficticia que incluye los 51 campos definidos en cDetalleResp, respetando su orden.
Las contraseñas, los datos bancarios y los datos personales son exclusivamente simbólicos.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<detalleComercioResponse
xmlns="https://servidorseguro.operacionesenlinea.com/">
Nota: el ejemplo ilustra la estructura XML, no una respuesta real. Los valores simbólicos de giro, RFC, CLABE, credenciales y fecha de nacimiento no deben interpretarse como datos válidos para operaciones productivas.
Asimismo, los valores 0 utilizados en los campos de resultado no establecen una equivalencia oficial entre ese código y una consulta exitosa.
Interpretación de la respuesta
Para procesar la respuesta, el integrador debe considerar los siguientes elementos.
Identificación del comercio
El campo comercioId permite relacionar la información recibida con el comercio solicitado.
Es recomendable comprobar que el identificador devuelto corresponda al comercio consultado, siempre que la operación haya concluido satisfactoriamente.
Resultado funcional
Los campos codigoRespuesta, ccErrorCode y mensajeRespuesta permiten interpretar el resultado del procesamiento.
La aplicación no debe asumir que una respuesta HTTP 200 OK equivale a una consulta funcionalmente satisfactoria.
Información registrada
Cuando el resultado indique una consulta satisfactoria, los campos de la respuesta podrán utilizarse para presentar o verificar la información registrada del comercio.
El contrato no garantiza que todos los campos opcionales contengan valores.
Credenciales
La respuesta puede incluir credenciales transaccionales y de acceso al portal.
El integrador debe evitar mostrarlas automáticamente, incluso cuando la consulta se realice desde un panel administrativo.
Flujo operativo de consulta
El flujo recomendado es el siguiente.
Paso 1. Identificar al aliado
El sistema integrador obtiene las credenciales del aliado autorizado para realizar la consulta.
Paso 2. Identificar al comercio
Se determina el valor comercioId del establecimiento que se desea consultar.
Paso 3. Construir la solicitud SOAP
Se prepara el mensaje con la cabecera OpHeader y los tres parámetros del objeto request.
Paso 4. Enviar la solicitud
El integrador invoca detalleComercio mediante HTTPS.
Paso 5. Procesar la respuesta
El servicio devuelve el objeto detalleComercioResult, con la información disponible y los campos de resultado.
Paso 6. Validar el resultado
La aplicación interpreta los códigos funcionales y comprueba la correspondencia del comercio consultado.
Paso 7. Utilizar la información
Los datos podrán utilizarse para tareas administrativas, visualización, validación de configuración o conciliación de información.
Paso 8. Proteger la información confidencial
El integrador aplica controles para evitar la exposición de contraseñas, información bancaria y datos personales.
Este flujo es una recomendación de integración. No implica que OEL ejecute necesariamente validaciones adicionales no descritas en el contrato.
Casos de uso
Consulta posterior a una afiliación
Después de ejecutar afiliacionComercio, el sistema puede utilizar el identificador recibido para consultar los datos registrados.
Esto permite comprobar la información devuelta por OEL y relacionarla con el expediente administrativo del comercio.
Visualización de información administrativa
Un sistema autorizado puede utilizar detalleComercio para mostrar información del establecimiento en un panel de administración.
Se recomienda presentar únicamente los campos necesarios para cada perfil de usuario.
Verificación de comisiones
La operación permite consultar las comisiones registradas para débito, crédito, American Express, tarjetas internacionales y valeras.
Esta información puede utilizarse para verificar las condiciones comerciales asociadas al establecimiento.
Consulta de productos configurados
Los campos linkPago, tpv y eCommerce permiten conocer la configuración de productos devuelta por el servicio.
Validación de información bancaria
El método permite recuperar la información bancaria contemplada en el contrato.
Por su sensibilidad, esta funcionalidad debe limitarse a procesos administrativos autorizados.
Verificación posterior a un cambio de comisiones
Después de ejecutar cambioComisiones, puede utilizarse detalleComercio para consultar los valores registrados.
La posibilidad de verificar un cambio no implica que el método garantice por sí mismo la fecha de aplicación o vigencia de las nuevas comisiones.
Códigos de respuesta y errores
La operación utiliza tres campos de resultado:
Campo | Tipo | Descripción |
|---|---|---|
| int | Resultado funcional de la consulta. |
| int | Código de error complementario. |
| string | Descripción del resultado. |
El WSDL no define un catálogo de códigos de error para detalleComercio.
Escenarios que deben contemplarse
Durante las pruebas de integración se recomienda verificar:
Escenario | Consideración |
|---|---|
Comercio existente | Confirmar el código de éxito y la información devuelta. |
Comercio inexistente | Identificar el código y mensaje correspondientes. |
Credenciales incorrectas | Verificar el comportamiento de autenticación. |
Comercio no autorizado | Confirmar cómo responde el servicio ante restricciones de acceso. |
Identificador inválido | Verificar la validación de |
Información incompleta | Confirmar cómo se representan los campos opcionales sin valor. |
Error interno | Identificar códigos y mensajes devueltos. |
Error de comunicación | Diferenciar fallas HTTP, tiempos de espera y errores SOAP. |
Estos son escenarios de prueba recomendados, no respuestas funcionales confirmadas.
Condiciones y limitaciones operativas
1. Consulta de un comercio por solicitud
El método recibe un único parámetro comercioId.
El contrato no contempla una lista de identificadores ni una operación de consulta masiva dentro de este método.
2. Requiere identificación del aliado
La consulta utiliza claveAliado y contrasena, además de la cabecera OpHeader.
3. No modifica información
detalleComercio es basicamente una operación de consulta. No permite modificar directamente los datos comerciales, fiscales, bancarios o las comisiones del establecimiento.
4. Puede devolver información confidencial
La respuesta contempla contraseñas, datos bancarios, información fiscal y datos personales.
Por ello, no debe exponerse directamente desde aplicaciones públicas ni utilizarse sin controles de autorización.
5. Los campos opcionales pueden estar ausentes
El WSDL define numerosos campos con minOccurs="0". El integrador debe contemplar que esos elementos puedan no aparecer en la respuesta.
6. Algunos campos admiten valores nulos
Los campos facturacionMensual, ticketPromedio, ticketMaximo, horarioApertura y horarioCierre admiten xsi:nil="true".
La aplicación debe diferenciar entre un valor numérico válido y un valor nulo.
7. No incluye un indicador explícito de estatus
El objeto cDetalleResp no define un campo específico denominado estatus, activo o fechaActivacion.
Por tanto, el método no permite identificar directamente mediante esos campos si un comercio se encuentra activo, suspendido o pendiente de activación.
8. No devuelve historial de cambios
La respuesta contiene valores de configuración, pero no incorpora un historial de modificaciones, fechas de cambio o usuarios responsables.
9. No garantiza vigencia inmediata de productos
Los campos booleanos de productos representan la configuración devuelta.
El contrato no permite determinar si existen restricciones adicionales para operar cada producto.
10. No establece paginación ni filtros
La consulta se realiza mediante comercioId.
No existen parámetros de paginación, búsqueda por RFC, nombre comercial o filtrado por estado dentro de cDetalleReq.
11. No define límites de frecuencia
No existe un número máximo de consultas por día ni otras cuotas de consumo.
12. No define políticas de actualización
La información devuelta proviene directamente del registro operativo, por ello es que la información devuelte es completamente información actualizada.
Recomendaciones de seguridad
Debido al tipo de información que devuelve este método, se recomienda implementar medidas adicionales a la autenticación SOAP.
Control de acceso
Permitir la consulta únicamente a sistemas y usuarios autorizados.
Protección de credenciales
No mostrar ni registrar los valores de contrasena y contrasenaPortal.
Protección bancaria
Enmascarar la CLABE cuando se presente en interfaces administrativas, salvo que exista una necesidad operativa autorizada de visualizarla completa.
Minimización de datos
Evitar almacenar copias completas de la respuesta cuando únicamente se necesiten algunos campos.
Registros de auditoría
Conservar información de trazabilidad, como el identificador del comercio consultado, el sistema solicitante y el resultado de la operación, sin registrar contraseñas ni otros datos sensibles.
Seguridad de transporte
Consumir el servicio mediante HTTPS y utilizar las versiones de TLS admitidas por OEL.
Manejo de errores
Evitar que los mensajes de error expongan credenciales, información bancaria o datos personales.
Estas medidas son recomendaciones de implementación de OEL para sus integradores; no constituyen garantías técnicas proporcionadas por el WSDL.
Relación con otros métodos
Método | Relación |
|---|---|
| Registra un comercio y devuelve su identificador. |
| Permite solicitar modificaciones de las comisiones registradas. |
| Consulta el saldo disponible del establecimiento. |
| Consulta los cortes diarios asociados al comercio. |
| Consulta información financiera del establecimiento. |
| Permite solicitar una venta automática para un comercio autorizado. |
| Permite solicitar una cancelación automática conforme a las condiciones del servicio. |
detalleComercio complementa especialmente a afiliacionComercio y cambioComisiones, porque permite consultar la información registrada después de esas operaciones.
Diferencias importantes respecto a afiliacionComercio
Aunque ambos métodos comparten numerosos campos, sus estructuras no son idénticas.
Característica |
|
|
|---|---|---|
Propósito | Registrar un nuevo comercio | Consultar un comercio existente |
Parámetros Request | 45 | 3 |
Parámetros Response | 18 | 51 |
Identificador del comercio | Se genera y devuelve | Se proporciona para realizar la consulta |
Datos comerciales | Se envían para el registro | Se recuperan de OEL |
Datos fiscales | Se envían para el registro | Se recuperan de OEL |
Datos bancarios | Se envían para el registro | Se recuperan de OEL |
Comisiones | Se envían las tasas solicitadas | Se devuelven las tasas registradas |
Productos | Se solicita su configuración | Se consulta su configuración |
Credenciales | Puede devolver credenciales generadas | Contempla la devolución de credenciales registradas |
Modifica información | Sí, solicita un alta | No, operación de consulta |
Diferencia de nombres en comisiones
La respuesta de afiliacionComercio utiliza:
<comision_debito>2.50</comision_debito> <comision_credito>3.00</comision_credito>
La respuesta de detalleComercio utiliza:
<debito>2.50</debito> <credito>3.00</credito>
Esta diferencia debe considerarse al implementar los modelos de datos y deserializadores de cada operación.
Las recomendaciones de seguridad, los escenarios de prueba y las validaciones pendientes se identifican como orientación para la integración, no como comportamientos confirmados del servicio.
El método detalleComercio permite consultar la información registrada de un establecimiento afiliado a Operaciones en Línea (OEL), utilizando su identificador comercioId.
La operación devuelve datos de identificación, información comercial, domicilio fiscal, representante legal, cuenta bancaria, comisiones, productos configurados y contactos del establecimiento.
También contempla las credenciales transaccionales del comercio y las credenciales de acceso al portal.
Este método es exclusivamente de consulta. Su contrato no contempla parámetros para modificar los datos del establecimiento ni ejecutar operaciones financieras.
Información del servicio
Propiedad | Valor |
|---|---|
Método |
|
Servicio |
|
Categoría | Administración de comercios |
Operación | Consulta de información de un comercio |
Protocolo | SOAP 1.1 / SOAP 1.2 |
Transporte | HTTPS |
Estilo |
|
Namespace |
|
SOAPAction |
|
Tipo Request |
|
Tipo Response |
|
Parámetros Request | 3 |
Parámetros Response | 51 |
Endpoint de producción
Endpoint de desarrollo
Autenticación
El método utiliza dos mecanismos de identificación:
Cabecera SOAP
OpHeader.Credenciales del aliado dentro del objeto
request.
Cabecera SOAP
Parámetro | Tipo | Descripción |
|---|---|---|
| string | Primera llave de autenticación asignada por OEL. |
| string | Segunda llave de autenticación asignada por OEL. |
<soap:Header> <OpHeader xmlns="https://servidorseguro.operacionesenlinea.com/"> <OpKey1>CLAVE_1_ASIGNADA</OpKey1> <OpKey2>CLAVE_2_ASIGNADA</OpKey2> </OpHeader>
Credenciales del aliado
Los parámetros claveAliado y contrasena identifican al aliado que solicita la información.
No deben confundirse con las credenciales del comercio que pueden aparecer en la respuesta.
Parámetros de solicitud (Request)
La operación recibe un objeto request de tipo cDetalleReq, compuesto por tres parámetros.
Parámetro | Tipo WSDL | Requerido | Descripción |
|---|---|---|---|
| string | Sí | Clave o identificador del aliado asignado por OEL. |
| string | Sí | Contraseña de acceso del aliado. |
| int | Sí | Identificador del comercio cuya información se desea consultar. |
Consideraciones de los parámetros
claveAliado
Identifica al aliado que realiza la consulta.
Se establece para esta credencial un máximo de diez caracteres alfanuméricos sin espacios.
contrasena
Corresponde a la contraseña del aliado.
Se establece un máximo de doce caracteres alfanuméricos sin espacios.
comercioId
Identifica al establecimiento que se desea consultar.
Este valor puede obtenerse de la respuesta de afiliacionComercio, una vez confirmada la afiliación.
Restricciones operativas
El aliado puede consultar únicamente comercios afiliados por él.
No existe ninguna posibilidad o permisos para consultar comercios de terceros.
No pueden consultarse comercios suspendidos, inactivos o dados de baja.
Ejemplo XML Request — SOAP 1.1
Petición HTTP
Cuerpo SOAP
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<OpHeader xmlns="https://servidorseguro.operacionesenlinea.com/">
<OpKey1>CLAVE_1_ASIGNADA</OpKey1>
<OpKey2>CLAVE_2_ASIGNADA</OpKey2>
</OpHeader>
</soap:Header>
<soap:Body>
<detalleComercio xmlns="https://servidorseguro.operacionesenlinea.com/">
<request>
<claveAliado>ALIADO_DEMO</claveAliado>
<contrasena>CLAVE_ALIADO</contrasena>
<comercioId>12345</comercioId>
</request>
</detalleComercio>
Los valores de autenticación son simbólicos y el identificador del comercio es ficticio. Para ejecutar la solicitud deben sustituirse por credenciales y datos válidos del ambiente correspondiente.
Parámetros de respuesta (Response)
El servicio devuelve un objeto detalleComercioResult, de tipo cDetalleResp, dentro del elemento detalleComercioResponse.
La respuesta contiene 51 parámetros, organizados a continuación por categorías funcionales.
Las tablas conservan el orden exacto de los elementos establecido por el WSDL.
1. Identificación y credenciales
Parámetro | Tipo | Descripción |
|---|---|---|
| int | Identificador del aliado asociado al comercio. |
| string | Nombre del aliado. |
| int | Identificador del comercio consultado. |
| string | Contraseña transaccional del comercio. |
| string | Información de afiliación registrada. |
| string | Usuario de acceso al portal. |
| string | Contraseña de acceso al portal. |
Consideraciones
El campo comercioId permite relacionar la información devuelta con el establecimiento solicitado.
Los campos contrasena y contrasenaPortal contienen potencialmente información de autenticación y deben tratarse como secretos.
2. Información comercial
Parámetro | Tipo | Descripción |
|---|---|---|
| int | Tipo de comercio registrado. |
| string | Giro o actividad comercial. |
| string | Nombre comercial del establecimiento. |
| string | Dirección operativa. |
| string | Colonia del establecimiento. |
| string | Ciudad del establecimiento. |
| string | Entidad federativa. |
| string | Código postal. |
| string | Teléfono de contacto. |
| string | Correo electrónico principal. |
Interpretación de tipo
Se describe los siguientes valores para el campo tipo :
Valor | Descripción |
|---|---|
| Persona física |
| Persona moral |
Interpretación de giro
Contiene la clave de actividad comercial registrada.
El catálogo de giros debe consultarse para obtener su descripción.
3. Información operativa y facturación estimada
Parámetro | Tipo | Descripción |
|---|---|---|
| decimal | Facturación mensual estimada registrada. |
| decimal | Importe promedio por transacción. |
| decimal | Importe máximo esperado por transacción. |
| int | Horario de apertura registrado. |
| int | Horario de cierre registrado. |
Estos campos describen información comercial registrada durante el proceso de afiliación.
No deben interpretarse como indicadores financieros calculados a partir de las transacciones realmente procesadas.
Por ejemplo, facturacionMensual corresponde a la información registrada del comercio, no necesariamente a la facturación efectiva del mes.
Los horarios se representan como enteros.
4. Información fiscal
Parámetro | Tipo | Descripción |
|---|---|---|
| string | Registro Federal de Contribuyentes. |
| string | Razón social del comercio. |
| string | Dirección fiscal. |
| string | Colonia fiscal. |
| string | Ciudad fiscal. |
| string | Entidad federativa del domicilio fiscal. |
| string | Código postal fiscal. |
| string | Teléfono de contacto para facturación. |
| string | Persona de contacto para facturación. |
5. Representante legal
Parámetro | Tipo | Descripción |
|---|---|---|
| string | Nombre del representante legal. |
| string | Apellidos del representante legal. |
| string | Fecha de nacimiento del representante legal. |
Estos datos corresponden a la información registrada durante la afiliación.
Los datos del representante legal se requieren para el procesamiento de tarjetas American Express.
6. Información bancaria
Parámetro | Tipo | Descripción |
|---|---|---|
| int | Identificador de la institución bancaria. |
| string | CLABE de la cuenta bancaria de liquidación. |
| string | Nombre del titular de la cuenta bancaria. |
La información bancaria corresponde a la cuenta registrada para la liquidación de ventas.
7. Comisiones registradas
Parámetro | Tipo | XSD | Descripción |
|---|---|---|---|
| decimal | R | Comisión registrada para tarjetas de débito. |
| decimal | R | Comisión registrada para tarjetas de crédito. |
| decimal | R | Comisión registrada para American Express. |
| decimal | R | Comisión registrada para tarjetas internacionales. |
| decimal | R | Comisión registrada para tarjetas de valeras. |
Se describen las comisiones como porcentajes.
Por ejemplo:
<debito>2.50</debito> <credito>3.00</credito> <amex>3.50</amex> <internacional>4.00</internacional> <valeras>2.00</valeras>
Estos valores son ficticios.
8. Productos configurados
Parámetro | Tipo | XSD | Descripción |
|---|---|---|---|
| boolean | R | Configuración de Link de Pago. |
| boolean | R | Configuración de terminal punto de venta. |
| boolean | R | Configuración de comercio electrónico. |
Los valores son booleanos.
Valor | Interpretación |
|---|---|
| Producto marcado como habilitado en la configuración consultada. |
| Producto marcado como no habilitado en la configuración consultada. |
Importante: estos campos reflejan la configuración devuelta por el servicio.
No permiten determinar por sí solos si existen validaciones pendientes, restricciones comerciales o condiciones adicionales que impidan operar el producto.
9. Contacto técnico
Parámetro | Tipo | XSD | Descripción |
|---|---|---|---|
| string | O | Nombre del contacto técnico. |
| string | O | Teléfono del contacto técnico. |
| string | O | Correo electrónico del contacto técnico. |
Estos campos permiten identificar al responsable técnico registrado para el comercio.
10. Resultado de la operación
Parámetro | Tipo | XSD | Descripción |
|---|---|---|---|
| int | R | Código funcional del resultado de la consulta. |
| int | R | Código complementario de error. |
| string | O | Mensaje descriptivo del resultado. |
La aplicación debe evaluar estos campos conforme a los códigos confirmados por OEL.
Ejemplo XML Response — SOAP 1.1
El siguiente ejemplo representa una respuesta ficticia que incluye los 51 campos definidos en cDetalleResp, respetando su orden.
Las contraseñas, los datos bancarios y los datos personales son exclusivamente simbólicos.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<detalleComercioResponse
xmlns="https://servidorseguro.operacionesenlinea.com/">
Nota: el ejemplo ilustra la estructura XML, no una respuesta real. Los valores simbólicos de giro, RFC, CLABE, credenciales y fecha de nacimiento no deben interpretarse como datos válidos para operaciones productivas.
Asimismo, los valores 0 utilizados en los campos de resultado no establecen una equivalencia oficial entre ese código y una consulta exitosa.
Interpretación de la respuesta
Para procesar la respuesta, el integrador debe considerar los siguientes elementos.
Identificación del comercio
El campo comercioId permite relacionar la información recibida con el comercio solicitado.
Es recomendable comprobar que el identificador devuelto corresponda al comercio consultado, siempre que la operación haya concluido satisfactoriamente.
Resultado funcional
Los campos codigoRespuesta, ccErrorCode y mensajeRespuesta permiten interpretar el resultado del procesamiento.
La aplicación no debe asumir que una respuesta HTTP 200 OK equivale a una consulta funcionalmente satisfactoria.
Información registrada
Cuando el resultado indique una consulta satisfactoria, los campos de la respuesta podrán utilizarse para presentar o verificar la información registrada del comercio.
El contrato no garantiza que todos los campos opcionales contengan valores.
Credenciales
La respuesta puede incluir credenciales transaccionales y de acceso al portal.
El integrador debe evitar mostrarlas automáticamente, incluso cuando la consulta se realice desde un panel administrativo.
Flujo operativo de consulta
El flujo recomendado es el siguiente.
Paso 1. Identificar al aliado
El sistema integrador obtiene las credenciales del aliado autorizado para realizar la consulta.
Paso 2. Identificar al comercio
Se determina el valor comercioId del establecimiento que se desea consultar.
Paso 3. Construir la solicitud SOAP
Se prepara el mensaje con la cabecera OpHeader y los tres parámetros del objeto request.
Paso 4. Enviar la solicitud
El integrador invoca detalleComercio mediante HTTPS.
Paso 5. Procesar la respuesta
El servicio devuelve el objeto detalleComercioResult, con la información disponible y los campos de resultado.
Paso 6. Validar el resultado
La aplicación interpreta los códigos funcionales y comprueba la correspondencia del comercio consultado.
Paso 7. Utilizar la información
Los datos podrán utilizarse para tareas administrativas, visualización, validación de configuración o conciliación de información.
Paso 8. Proteger la información confidencial
El integrador aplica controles para evitar la exposición de contraseñas, información bancaria y datos personales.
Este flujo es una recomendación de integración. No implica que OEL ejecute necesariamente validaciones adicionales no descritas en el contrato.
Casos de uso
Consulta posterior a una afiliación
Después de ejecutar afiliacionComercio, el sistema puede utilizar el identificador recibido para consultar los datos registrados.
Esto permite comprobar la información devuelta por OEL y relacionarla con el expediente administrativo del comercio.
Visualización de información administrativa
Un sistema autorizado puede utilizar detalleComercio para mostrar información del establecimiento en un panel de administración.
Se recomienda presentar únicamente los campos necesarios para cada perfil de usuario.
Verificación de comisiones
La operación permite consultar las comisiones registradas para débito, crédito, American Express, tarjetas internacionales y valeras.
Esta información puede utilizarse para verificar las condiciones comerciales asociadas al establecimiento.
Consulta de productos configurados
Los campos linkPago, tpv y eCommerce permiten conocer la configuración de productos devuelta por el servicio.
Validación de información bancaria
El método permite recuperar la información bancaria contemplada en el contrato.
Por su sensibilidad, esta funcionalidad debe limitarse a procesos administrativos autorizados.
Verificación posterior a un cambio de comisiones
Después de ejecutar cambioComisiones, puede utilizarse detalleComercio para consultar los valores registrados.
La posibilidad de verificar un cambio no implica que el método garantice por sí mismo la fecha de aplicación o vigencia de las nuevas comisiones.
Códigos de respuesta y errores
La operación utiliza tres campos de resultado:
Campo | Tipo | Descripción |
|---|---|---|
| int | Resultado funcional de la consulta. |
| int | Código de error complementario. |
| string | Descripción del resultado. |
El WSDL no define un catálogo de códigos de error para detalleComercio.
Escenarios que deben contemplarse
Durante las pruebas de integración se recomienda verificar:
Escenario | Consideración |
|---|---|
Comercio existente | Confirmar el código de éxito y la información devuelta. |
Comercio inexistente | Identificar el código y mensaje correspondientes. |
Credenciales incorrectas | Verificar el comportamiento de autenticación. |
Comercio no autorizado | Confirmar cómo responde el servicio ante restricciones de acceso. |
Identificador inválido | Verificar la validación de |
Información incompleta | Confirmar cómo se representan los campos opcionales sin valor. |
Error interno | Identificar códigos y mensajes devueltos. |
Error de comunicación | Diferenciar fallas HTTP, tiempos de espera y errores SOAP. |
Estos son escenarios de prueba recomendados, no respuestas funcionales confirmadas.
Condiciones y limitaciones operativas
1. Consulta de un comercio por solicitud
El método recibe un único parámetro comercioId.
El contrato no contempla una lista de identificadores ni una operación de consulta masiva dentro de este método.
2. Requiere identificación del aliado
La consulta utiliza claveAliado y contrasena, además de la cabecera OpHeader.
3. No modifica información
detalleComercio es basicamente una operación de consulta. No permite modificar directamente los datos comerciales, fiscales, bancarios o las comisiones del establecimiento.
4. Puede devolver información confidencial
La respuesta contempla contraseñas, datos bancarios, información fiscal y datos personales.
Por ello, no debe exponerse directamente desde aplicaciones públicas ni utilizarse sin controles de autorización.
5. Los campos opcionales pueden estar ausentes
El WSDL define numerosos campos con minOccurs="0". El integrador debe contemplar que esos elementos puedan no aparecer en la respuesta.
6. Algunos campos admiten valores nulos
Los campos facturacionMensual, ticketPromedio, ticketMaximo, horarioApertura y horarioCierre admiten xsi:nil="true".
La aplicación debe diferenciar entre un valor numérico válido y un valor nulo.
7. No incluye un indicador explícito de estatus
El objeto cDetalleResp no define un campo específico denominado estatus, activo o fechaActivacion.
Por tanto, el método no permite identificar directamente mediante esos campos si un comercio se encuentra activo, suspendido o pendiente de activación.
8. No devuelve historial de cambios
La respuesta contiene valores de configuración, pero no incorpora un historial de modificaciones, fechas de cambio o usuarios responsables.
9. No garantiza vigencia inmediata de productos
Los campos booleanos de productos representan la configuración devuelta.
El contrato no permite determinar si existen restricciones adicionales para operar cada producto.
10. No establece paginación ni filtros
La consulta se realiza mediante comercioId.
No existen parámetros de paginación, búsqueda por RFC, nombre comercial o filtrado por estado dentro de cDetalleReq.
11. No define límites de frecuencia
No existe un número máximo de consultas por día ni otras cuotas de consumo.
12. No define políticas de actualización
La información devuelta proviene directamente del registro operativo, por ello es que la información devuelte es completamente información actualizada.
Recomendaciones de seguridad
Debido al tipo de información que devuelve este método, se recomienda implementar medidas adicionales a la autenticación SOAP.
Control de acceso
Permitir la consulta únicamente a sistemas y usuarios autorizados.
Protección de credenciales
No mostrar ni registrar los valores de contrasena y contrasenaPortal.
Protección bancaria
Enmascarar la CLABE cuando se presente en interfaces administrativas, salvo que exista una necesidad operativa autorizada de visualizarla completa.
Minimización de datos
Evitar almacenar copias completas de la respuesta cuando únicamente se necesiten algunos campos.
Registros de auditoría
Conservar información de trazabilidad, como el identificador del comercio consultado, el sistema solicitante y el resultado de la operación, sin registrar contraseñas ni otros datos sensibles.
Seguridad de transporte
Consumir el servicio mediante HTTPS y utilizar las versiones de TLS admitidas por OEL.
Manejo de errores
Evitar que los mensajes de error expongan credenciales, información bancaria o datos personales.
Estas medidas son recomendaciones de implementación de OEL para sus integradores; no constituyen garantías técnicas proporcionadas por el WSDL.
Relación con otros métodos
Método | Relación |
|---|---|
| Registra un comercio y devuelve su identificador. |
| Permite solicitar modificaciones de las comisiones registradas. |
| Consulta el saldo disponible del establecimiento. |
| Consulta los cortes diarios asociados al comercio. |
| Consulta información financiera del establecimiento. |
| Permite solicitar una venta automática para un comercio autorizado. |
| Permite solicitar una cancelación automática conforme a las condiciones del servicio. |
detalleComercio complementa especialmente a afiliacionComercio y cambioComisiones, porque permite consultar la información registrada después de esas operaciones.
Diferencias importantes respecto a afiliacionComercio
Aunque ambos métodos comparten numerosos campos, sus estructuras no son idénticas.
Característica |
|
|
|---|---|---|
Propósito | Registrar un nuevo comercio | Consultar un comercio existente |
Parámetros Request | 45 | 3 |
Parámetros Response | 18 | 51 |
Identificador del comercio | Se genera y devuelve | Se proporciona para realizar la consulta |
Datos comerciales | Se envían para el registro | Se recuperan de OEL |
Datos fiscales | Se envían para el registro | Se recuperan de OEL |
Datos bancarios | Se envían para el registro | Se recuperan de OEL |
Comisiones | Se envían las tasas solicitadas | Se devuelven las tasas registradas |
Productos | Se solicita su configuración | Se consulta su configuración |
Credenciales | Puede devolver credenciales generadas | Contempla la devolución de credenciales registradas |
Modifica información | Sí, solicita un alta | No, operación de consulta |
Diferencia de nombres en comisiones
La respuesta de afiliacionComercio utiliza:
<comision_debito>2.50</comision_debito> <comision_credito>3.00</comision_credito>
La respuesta de detalleComercio utiliza:
<debito>2.50</debito> <credito>3.00</credito>
Esta diferencia debe considerarse al implementar los modelos de datos y deserializadores de cada operación.
Las recomendaciones de seguridad, los escenarios de prueba y las validaciones pendientes se identifican como orientación para la integración, no como comportamientos confirmados del servicio.
El método detalleComercio permite consultar la información registrada de un establecimiento afiliado a Operaciones en Línea (OEL), utilizando su identificador comercioId.
La operación devuelve datos de identificación, información comercial, domicilio fiscal, representante legal, cuenta bancaria, comisiones, productos configurados y contactos del establecimiento.
También contempla las credenciales transaccionales del comercio y las credenciales de acceso al portal.
Este método es exclusivamente de consulta. Su contrato no contempla parámetros para modificar los datos del establecimiento ni ejecutar operaciones financieras.
Información del servicio
Propiedad | Valor |
|---|---|
Método |
|
Servicio |
|
Categoría | Administración de comercios |
Operación | Consulta de información de un comercio |
Protocolo | SOAP 1.1 / SOAP 1.2 |
Transporte | HTTPS |
Estilo |
|
Namespace |
|
SOAPAction |
|
Tipo Request |
|
Tipo Response |
|
Parámetros Request | 3 |
Parámetros Response | 51 |
Endpoint de producción
Endpoint de desarrollo
Autenticación
El método utiliza dos mecanismos de identificación:
Cabecera SOAP
OpHeader.Credenciales del aliado dentro del objeto
request.
Cabecera SOAP
Parámetro | Tipo | Descripción |
|---|---|---|
| string | Primera llave de autenticación asignada por OEL. |
| string | Segunda llave de autenticación asignada por OEL. |
<soap:Header> <OpHeader xmlns="https://servidorseguro.operacionesenlinea.com/"> <OpKey1>CLAVE_1_ASIGNADA</OpKey1> <OpKey2>CLAVE_2_ASIGNADA</OpKey2> </OpHeader>
Credenciales del aliado
Los parámetros claveAliado y contrasena identifican al aliado que solicita la información.
No deben confundirse con las credenciales del comercio que pueden aparecer en la respuesta.
Parámetros de solicitud (Request)
La operación recibe un objeto request de tipo cDetalleReq, compuesto por tres parámetros.
Parámetro | Tipo WSDL | Requerido | Descripción |
|---|---|---|---|
| string | Sí | Clave o identificador del aliado asignado por OEL. |
| string | Sí | Contraseña de acceso del aliado. |
| int | Sí | Identificador del comercio cuya información se desea consultar. |
Consideraciones de los parámetros
claveAliado
Identifica al aliado que realiza la consulta.
Se establece para esta credencial un máximo de diez caracteres alfanuméricos sin espacios.
contrasena
Corresponde a la contraseña del aliado.
Se establece un máximo de doce caracteres alfanuméricos sin espacios.
comercioId
Identifica al establecimiento que se desea consultar.
Este valor puede obtenerse de la respuesta de afiliacionComercio, una vez confirmada la afiliación.
Restricciones operativas
El aliado puede consultar únicamente comercios afiliados por él.
No existe ninguna posibilidad o permisos para consultar comercios de terceros.
No pueden consultarse comercios suspendidos, inactivos o dados de baja.
Ejemplo XML Request — SOAP 1.1
Petición HTTP
Cuerpo SOAP
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<OpHeader xmlns="https://servidorseguro.operacionesenlinea.com/">
<OpKey1>CLAVE_1_ASIGNADA</OpKey1>
<OpKey2>CLAVE_2_ASIGNADA</OpKey2>
</OpHeader>
</soap:Header>
<soap:Body>
<detalleComercio xmlns="https://servidorseguro.operacionesenlinea.com/">
<request>
<claveAliado>ALIADO_DEMO</claveAliado>
<contrasena>CLAVE_ALIADO</contrasena>
<comercioId>12345</comercioId>
</request>
</detalleComercio>
Los valores de autenticación son simbólicos y el identificador del comercio es ficticio. Para ejecutar la solicitud deben sustituirse por credenciales y datos válidos del ambiente correspondiente.
Parámetros de respuesta (Response)
El servicio devuelve un objeto detalleComercioResult, de tipo cDetalleResp, dentro del elemento detalleComercioResponse.
La respuesta contiene 51 parámetros, organizados a continuación por categorías funcionales.
Las tablas conservan el orden exacto de los elementos establecido por el WSDL.
1. Identificación y credenciales
Parámetro | Tipo | Descripción |
|---|---|---|
| int | Identificador del aliado asociado al comercio. |
| string | Nombre del aliado. |
| int | Identificador del comercio consultado. |
| string | Contraseña transaccional del comercio. |
| string | Información de afiliación registrada. |
| string | Usuario de acceso al portal. |
| string | Contraseña de acceso al portal. |
Consideraciones
El campo comercioId permite relacionar la información devuelta con el establecimiento solicitado.
Los campos contrasena y contrasenaPortal contienen potencialmente información de autenticación y deben tratarse como secretos.
2. Información comercial
Parámetro | Tipo | Descripción |
|---|---|---|
| int | Tipo de comercio registrado. |
| string | Giro o actividad comercial. |
| string | Nombre comercial del establecimiento. |
| string | Dirección operativa. |
| string | Colonia del establecimiento. |
| string | Ciudad del establecimiento. |
| string | Entidad federativa. |
| string | Código postal. |
| string | Teléfono de contacto. |
| string | Correo electrónico principal. |
Interpretación de tipo
Se describe los siguientes valores para el campo tipo :
Valor | Descripción |
|---|---|
| Persona física |
| Persona moral |
Interpretación de giro
Contiene la clave de actividad comercial registrada.
El catálogo de giros debe consultarse para obtener su descripción.
3. Información operativa y facturación estimada
Parámetro | Tipo | Descripción |
|---|---|---|
| decimal | Facturación mensual estimada registrada. |
| decimal | Importe promedio por transacción. |
| decimal | Importe máximo esperado por transacción. |
| int | Horario de apertura registrado. |
| int | Horario de cierre registrado. |
Estos campos describen información comercial registrada durante el proceso de afiliación.
No deben interpretarse como indicadores financieros calculados a partir de las transacciones realmente procesadas.
Por ejemplo, facturacionMensual corresponde a la información registrada del comercio, no necesariamente a la facturación efectiva del mes.
Los horarios se representan como enteros.
4. Información fiscal
Parámetro | Tipo | Descripción |
|---|---|---|
| string | Registro Federal de Contribuyentes. |
| string | Razón social del comercio. |
| string | Dirección fiscal. |
| string | Colonia fiscal. |
| string | Ciudad fiscal. |
| string | Entidad federativa del domicilio fiscal. |
| string | Código postal fiscal. |
| string | Teléfono de contacto para facturación. |
| string | Persona de contacto para facturación. |
5. Representante legal
Parámetro | Tipo | Descripción |
|---|---|---|
| string | Nombre del representante legal. |
| string | Apellidos del representante legal. |
| string | Fecha de nacimiento del representante legal. |
Estos datos corresponden a la información registrada durante la afiliación.
Los datos del representante legal se requieren para el procesamiento de tarjetas American Express.
6. Información bancaria
Parámetro | Tipo | Descripción |
|---|---|---|
| int | Identificador de la institución bancaria. |
| string | CLABE de la cuenta bancaria de liquidación. |
| string | Nombre del titular de la cuenta bancaria. |
La información bancaria corresponde a la cuenta registrada para la liquidación de ventas.
7. Comisiones registradas
Parámetro | Tipo | XSD | Descripción |
|---|---|---|---|
| decimal | R | Comisión registrada para tarjetas de débito. |
| decimal | R | Comisión registrada para tarjetas de crédito. |
| decimal | R | Comisión registrada para American Express. |
| decimal | R | Comisión registrada para tarjetas internacionales. |
| decimal | R | Comisión registrada para tarjetas de valeras. |
Se describen las comisiones como porcentajes.
Por ejemplo:
<debito>2.50</debito> <credito>3.00</credito> <amex>3.50</amex> <internacional>4.00</internacional> <valeras>2.00</valeras>
Estos valores son ficticios.
8. Productos configurados
Parámetro | Tipo | XSD | Descripción |
|---|---|---|---|
| boolean | R | Configuración de Link de Pago. |
| boolean | R | Configuración de terminal punto de venta. |
| boolean | R | Configuración de comercio electrónico. |
Los valores son booleanos.
Valor | Interpretación |
|---|---|
| Producto marcado como habilitado en la configuración consultada. |
| Producto marcado como no habilitado en la configuración consultada. |
Importante: estos campos reflejan la configuración devuelta por el servicio.
No permiten determinar por sí solos si existen validaciones pendientes, restricciones comerciales o condiciones adicionales que impidan operar el producto.
9. Contacto técnico
Parámetro | Tipo | XSD | Descripción |
|---|---|---|---|
| string | O | Nombre del contacto técnico. |
| string | O | Teléfono del contacto técnico. |
| string | O | Correo electrónico del contacto técnico. |
Estos campos permiten identificar al responsable técnico registrado para el comercio.
10. Resultado de la operación
Parámetro | Tipo | XSD | Descripción |
|---|---|---|---|
| int | R | Código funcional del resultado de la consulta. |
| int | R | Código complementario de error. |
| string | O | Mensaje descriptivo del resultado. |
La aplicación debe evaluar estos campos conforme a los códigos confirmados por OEL.
Ejemplo XML Response — SOAP 1.1
El siguiente ejemplo representa una respuesta ficticia que incluye los 51 campos definidos en cDetalleResp, respetando su orden.
Las contraseñas, los datos bancarios y los datos personales son exclusivamente simbólicos.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<detalleComercioResponse
xmlns="https://servidorseguro.operacionesenlinea.com/">
Nota: el ejemplo ilustra la estructura XML, no una respuesta real. Los valores simbólicos de giro, RFC, CLABE, credenciales y fecha de nacimiento no deben interpretarse como datos válidos para operaciones productivas.
Asimismo, los valores 0 utilizados en los campos de resultado no establecen una equivalencia oficial entre ese código y una consulta exitosa.
Interpretación de la respuesta
Para procesar la respuesta, el integrador debe considerar los siguientes elementos.
Identificación del comercio
El campo comercioId permite relacionar la información recibida con el comercio solicitado.
Es recomendable comprobar que el identificador devuelto corresponda al comercio consultado, siempre que la operación haya concluido satisfactoriamente.
Resultado funcional
Los campos codigoRespuesta, ccErrorCode y mensajeRespuesta permiten interpretar el resultado del procesamiento.
La aplicación no debe asumir que una respuesta HTTP 200 OK equivale a una consulta funcionalmente satisfactoria.
Información registrada
Cuando el resultado indique una consulta satisfactoria, los campos de la respuesta podrán utilizarse para presentar o verificar la información registrada del comercio.
El contrato no garantiza que todos los campos opcionales contengan valores.
Credenciales
La respuesta puede incluir credenciales transaccionales y de acceso al portal.
El integrador debe evitar mostrarlas automáticamente, incluso cuando la consulta se realice desde un panel administrativo.
Flujo operativo de consulta
El flujo recomendado es el siguiente.
Paso 1. Identificar al aliado
El sistema integrador obtiene las credenciales del aliado autorizado para realizar la consulta.
Paso 2. Identificar al comercio
Se determina el valor comercioId del establecimiento que se desea consultar.
Paso 3. Construir la solicitud SOAP
Se prepara el mensaje con la cabecera OpHeader y los tres parámetros del objeto request.
Paso 4. Enviar la solicitud
El integrador invoca detalleComercio mediante HTTPS.
Paso 5. Procesar la respuesta
El servicio devuelve el objeto detalleComercioResult, con la información disponible y los campos de resultado.
Paso 6. Validar el resultado
La aplicación interpreta los códigos funcionales y comprueba la correspondencia del comercio consultado.
Paso 7. Utilizar la información
Los datos podrán utilizarse para tareas administrativas, visualización, validación de configuración o conciliación de información.
Paso 8. Proteger la información confidencial
El integrador aplica controles para evitar la exposición de contraseñas, información bancaria y datos personales.
Este flujo es una recomendación de integración. No implica que OEL ejecute necesariamente validaciones adicionales no descritas en el contrato.
Casos de uso
Consulta posterior a una afiliación
Después de ejecutar afiliacionComercio, el sistema puede utilizar el identificador recibido para consultar los datos registrados.
Esto permite comprobar la información devuelta por OEL y relacionarla con el expediente administrativo del comercio.
Visualización de información administrativa
Un sistema autorizado puede utilizar detalleComercio para mostrar información del establecimiento en un panel de administración.
Se recomienda presentar únicamente los campos necesarios para cada perfil de usuario.
Verificación de comisiones
La operación permite consultar las comisiones registradas para débito, crédito, American Express, tarjetas internacionales y valeras.
Esta información puede utilizarse para verificar las condiciones comerciales asociadas al establecimiento.
Consulta de productos configurados
Los campos linkPago, tpv y eCommerce permiten conocer la configuración de productos devuelta por el servicio.
Validación de información bancaria
El método permite recuperar la información bancaria contemplada en el contrato.
Por su sensibilidad, esta funcionalidad debe limitarse a procesos administrativos autorizados.
Verificación posterior a un cambio de comisiones
Después de ejecutar cambioComisiones, puede utilizarse detalleComercio para consultar los valores registrados.
La posibilidad de verificar un cambio no implica que el método garantice por sí mismo la fecha de aplicación o vigencia de las nuevas comisiones.
Códigos de respuesta y errores
La operación utiliza tres campos de resultado:
Campo | Tipo | Descripción |
|---|---|---|
| int | Resultado funcional de la consulta. |
| int | Código de error complementario. |
| string | Descripción del resultado. |
El WSDL no define un catálogo de códigos de error para detalleComercio.
Escenarios que deben contemplarse
Durante las pruebas de integración se recomienda verificar:
Escenario | Consideración |
|---|---|
Comercio existente | Confirmar el código de éxito y la información devuelta. |
Comercio inexistente | Identificar el código y mensaje correspondientes. |
Credenciales incorrectas | Verificar el comportamiento de autenticación. |
Comercio no autorizado | Confirmar cómo responde el servicio ante restricciones de acceso. |
Identificador inválido | Verificar la validación de |
Información incompleta | Confirmar cómo se representan los campos opcionales sin valor. |
Error interno | Identificar códigos y mensajes devueltos. |
Error de comunicación | Diferenciar fallas HTTP, tiempos de espera y errores SOAP. |
Estos son escenarios de prueba recomendados, no respuestas funcionales confirmadas.
Condiciones y limitaciones operativas
1. Consulta de un comercio por solicitud
El método recibe un único parámetro comercioId.
El contrato no contempla una lista de identificadores ni una operación de consulta masiva dentro de este método.
2. Requiere identificación del aliado
La consulta utiliza claveAliado y contrasena, además de la cabecera OpHeader.
3. No modifica información
detalleComercio es basicamente una operación de consulta. No permite modificar directamente los datos comerciales, fiscales, bancarios o las comisiones del establecimiento.
4. Puede devolver información confidencial
La respuesta contempla contraseñas, datos bancarios, información fiscal y datos personales.
Por ello, no debe exponerse directamente desde aplicaciones públicas ni utilizarse sin controles de autorización.
5. Los campos opcionales pueden estar ausentes
El WSDL define numerosos campos con minOccurs="0". El integrador debe contemplar que esos elementos puedan no aparecer en la respuesta.
6. Algunos campos admiten valores nulos
Los campos facturacionMensual, ticketPromedio, ticketMaximo, horarioApertura y horarioCierre admiten xsi:nil="true".
La aplicación debe diferenciar entre un valor numérico válido y un valor nulo.
7. No incluye un indicador explícito de estatus
El objeto cDetalleResp no define un campo específico denominado estatus, activo o fechaActivacion.
Por tanto, el método no permite identificar directamente mediante esos campos si un comercio se encuentra activo, suspendido o pendiente de activación.
8. No devuelve historial de cambios
La respuesta contiene valores de configuración, pero no incorpora un historial de modificaciones, fechas de cambio o usuarios responsables.
9. No garantiza vigencia inmediata de productos
Los campos booleanos de productos representan la configuración devuelta.
El contrato no permite determinar si existen restricciones adicionales para operar cada producto.
10. No establece paginación ni filtros
La consulta se realiza mediante comercioId.
No existen parámetros de paginación, búsqueda por RFC, nombre comercial o filtrado por estado dentro de cDetalleReq.
11. No define límites de frecuencia
No existe un número máximo de consultas por día ni otras cuotas de consumo.
12. No define políticas de actualización
La información devuelta proviene directamente del registro operativo, por ello es que la información devuelte es completamente información actualizada.
Recomendaciones de seguridad
Debido al tipo de información que devuelve este método, se recomienda implementar medidas adicionales a la autenticación SOAP.
Control de acceso
Permitir la consulta únicamente a sistemas y usuarios autorizados.
Protección de credenciales
No mostrar ni registrar los valores de contrasena y contrasenaPortal.
Protección bancaria
Enmascarar la CLABE cuando se presente en interfaces administrativas, salvo que exista una necesidad operativa autorizada de visualizarla completa.
Minimización de datos
Evitar almacenar copias completas de la respuesta cuando únicamente se necesiten algunos campos.
Registros de auditoría
Conservar información de trazabilidad, como el identificador del comercio consultado, el sistema solicitante y el resultado de la operación, sin registrar contraseñas ni otros datos sensibles.
Seguridad de transporte
Consumir el servicio mediante HTTPS y utilizar las versiones de TLS admitidas por OEL.
Manejo de errores
Evitar que los mensajes de error expongan credenciales, información bancaria o datos personales.
Estas medidas son recomendaciones de implementación de OEL para sus integradores; no constituyen garantías técnicas proporcionadas por el WSDL.
Relación con otros métodos
Método | Relación |
|---|---|
| Registra un comercio y devuelve su identificador. |
| Permite solicitar modificaciones de las comisiones registradas. |
| Consulta el saldo disponible del establecimiento. |
| Consulta los cortes diarios asociados al comercio. |
| Consulta información financiera del establecimiento. |
| Permite solicitar una venta automática para un comercio autorizado. |
| Permite solicitar una cancelación automática conforme a las condiciones del servicio. |
detalleComercio complementa especialmente a afiliacionComercio y cambioComisiones, porque permite consultar la información registrada después de esas operaciones.
Diferencias importantes respecto a afiliacionComercio
Aunque ambos métodos comparten numerosos campos, sus estructuras no son idénticas.
Característica |
|
|
|---|---|---|
Propósito | Registrar un nuevo comercio | Consultar un comercio existente |
Parámetros Request | 45 | 3 |
Parámetros Response | 18 | 51 |
Identificador del comercio | Se genera y devuelve | Se proporciona para realizar la consulta |
Datos comerciales | Se envían para el registro | Se recuperan de OEL |
Datos fiscales | Se envían para el registro | Se recuperan de OEL |
Datos bancarios | Se envían para el registro | Se recuperan de OEL |
Comisiones | Se envían las tasas solicitadas | Se devuelven las tasas registradas |
Productos | Se solicita su configuración | Se consulta su configuración |
Credenciales | Puede devolver credenciales generadas | Contempla la devolución de credenciales registradas |
Modifica información | Sí, solicita un alta | No, operación de consulta |
Diferencia de nombres en comisiones
La respuesta de afiliacionComercio utiliza:
<comision_debito>2.50</comision_debito> <comision_credito>3.00</comision_credito>
La respuesta de detalleComercio utiliza:
<debito>2.50</debito> <credito>3.00</credito>
Esta diferencia debe considerarse al implementar los modelos de datos y deserializadores de cada operación.
Las recomendaciones de seguridad, los escenarios de prueba y las validaciones pendientes se identifican como orientación para la integración, no como comportamientos confirmados del servicio.
¿Listo para integrar?
Comienza en ambiente de desarrollo, valida tus primeras operaciones y prepara tu integración para certificación. Cuando el flujo este completo, podrás solicitar el paso a produccion.
¿Listo para integrar?
Comienza en ambiente de desarrollo, valida tus primeras operaciones y prepara tu integración para certificación. Cuando el flujo este completo, podrás solicitar el paso a produccion.
© 2026 Derechos Reservados
© 2026 Derechos Reservados