Descripción

El presente documento tiene como finalidad proporcionar la información necesaria para la correcta implementación y conexión entre el WebService del portal Multimarca con el desarrollo de un cliente consumidor para la correcta operación de cobro de servicios y consulta de saldos de servicios.

De ésta forma todas las consultas provenientes de la cuenta del cliente del portal multimarca son total responsabilidad del cliente y del sistema desde donde se realizan las peticiones.

Consideraciones Generales

Todas las peticiones que reciban una respuesta exitosa por parte del WebService generarán un costo por el monto solicitado por el cliente consumidor.

Bajo ninguna circunstancia se podrá solicitar el reembolso de cobro de servicios realizados exitosamente desde la cuenta del cliente consumidor.

El tiempo máximo de respuesta por parte del WebService será de 90 Segundos para realizar un cobro de servicio.

Cada cliente consumidor es responsable de sus claves de acceso al WebService proporcionadas por el portal multimarca.

URL del Webservice:

https://www.recargamarcas.com/wsServicios/index.php

URL del WSDL:

https://www.recargamarcas.com/wsServicios/index.php?WSDL

El servicio contiene 3 funciones que son:

  • SaldoServicios
  • RecargaServicios
  • Paquetes (ver manual de Webservice de Paquetes)

Para realizar pruebas puedes usar nuestro usuario demo:

Usuario demo123456
Passwd Demo123456

SaldoServicios (string).

La función recibe un valor de tipo String: Dicho String corresponde a la cadena XML que será enviada al servidor del portal multimarca para su procesamiento. Ésta función regresará un valor de tipo String como respuesta correspondiente a una cadena en formato XML.

Estructura de cadena de envío para obtener el saldo de servicios del usuario:

El cliente deberá enviar el siguiente string con el siguiente formato:

VARIABLE TIPO
Usuario String proporcionado con el nombre de usuario de acceso al Portal.
Passwd String proporcionado correspondiente a la contraseña de acceso.
Referencia La referencia es un entero siempre con el valor 0 cero.

Estructura de cadena de respuesta POSITIVA para obtener el saldo del cliente consumidor:

Estructura de cadena de respuesta de ERROR para obtener el saldo del cliente consumidor:

RecargaServicios (string).

La función recibe un valor de tipo String:

Dicho String corresponde a la cadena XML que será enviada al servidor del portal multimarca para su procesamiento.

Ésta función regresará un valor de tipo String como respuesta correspondiente a una cadena en formato XML.

Estructura de cadena de envío para realizar un pago de servicio del cliente consumidor:

VARIABLE TIPO
Usuario String proporcionado con el nombre de usuario de acceso al Portal.
Passwd String proporcionado correspondiente a la contraseña de acceso.
Referencia String con la referencia de número de cuenta del servicio.
Dígito verificador Dígito verificador del recibo, es un número entero.
Compania String en mayúsculas de la compañía a la que se requiere pagar el servicio.
Monto Cantidad a pagar por el servicio.
Email String proporcionado con formato de correo electrónico en donde se enviará el comprobante de pago.
Extra Valor numérico siempre con valor de 0 cero.

El dígito verificador solo es para el caso de Telmex, en caso de no requerirse se debe poner un 0 (cero) en el espacio.

Listado de compañías disponibles dentro del webservice.

  • ADOSAPACO (AGUA OAXACA).
  • AGUAKAN (AGUA DE QUINTANA ROO).
  • AMD (AGUA DE DURANGO).
  • AXTEL.
  • CFE.
  • CMAPAS (AGUA DE SALAMANCA).
  • COMAPA (AGUA DE NUEVO LAREDO).
  • CREDISCOTIA (PRESTAMOS PERSONALES).
  • DISH.
  • GAS (GAS NATURAL).
  • CHIHUAHUA (GOBIERNO CHIHUAHUA).
  • ZACATECAS (GOBIERNO ZACATECAS).
  • INFONAVIT.
  • INTERPAS (AGUA DE SAN LUIS POTOSI).
  • JMAS (AGUA DE CHIHUAHUA).
  • JUMAPA (AGUA DE CELAYA).
  • MEGACABLE.
  • MULTIMEDIOS.
  • NEXTEL (FACTURAS NEXTEL).
  • AGUA Y DRENAJE DE MONTERREY.
  • SIAPA (AGUA DE GUADALAJARA).
  • SKY.
  • TELEFONICA (FACTURAS MOVISTAR).
  • TELMEX.
  • TELNOR (TELEFONOS DE BAJA CALIFORNIA).
  • ARABELA.
  • AVON.
  • BELCORP.
  • CABLEMAS.
  • CABLEVISION.
  • FULLER.
  • ILUSION.
  • IUSACELL.
  • IVES.
  • MAXCOM.
  • NATURA.
  • PRET.
  • QUERETARO (QUERETARO PEGASSO).
  • TOTAL PLAY.
  • TUPPERWARE.

Estructura de cadena de respuesta POSITIVA para obtener un pago de servicio:

VARIABLE TIPO
Folio Número entero de comprobante de folio de pago del servicio.
Cantidad Monto del pago del servicio.
Referencia Número de referencia del servicio a pagar.
Compania Compañía a la que se realizó el pago de servicio.

Estructura de cadena de respuesta de ERROR para un pago de servicio:

Para cualquier duda y obtener soporte técnico por favor contacta a tu distribuidor.
Ir al Inicio