Manuales de Recargas

Última actualización: ENERO 2020

Descripción

La presente página tiene como finalidad proporcionar la información necesaria para la correcta implementación y conexión entre el WebService del portal con el desarrollo de un cliente consumidor para la correcta operación de Recargas electrónicas y consulta de Saldos. De ésta forma todas las consultas provenientes de la cuenta del cliente del portal 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 para el cliente consumidor.

Bajo ninguna circunstancia se podrá solicitar el reembolso de recargas realizadas exitosas desde la cuenta del cliente consumidor.

El tiempo máximo de respuesta por parte del WebService será de 90 Segundos para realizar una recarga electrónica de tiempo aire.

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

Manual del Webservice:

https://www.ventatelcel.com/ws/index.php?wsdl

El servicio contiene 4 funciones que son:

ObtenSaldo
RecargaEWS
Paquetes (ver manual de Webservice de Paquetes)
ProductosPDV

Para realizar pruebas puedes usar nuestro usuario demo:

Usuario	demo123456
Passwd	Demo123456

ObtenSaldo(string).

La función recibe un valor de tipo String: Dicho String corresponde a la cadena XML que será enviada al servidor del portal para su procesamiento. Ésta función regresará un valor de tipo String como respuesta correspondiente a una cadena XML. Estructura de cadena de envío para obtener el saldo del usuario:

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:

RecargaEWS(string).

Estructura de cadena de envío para obtener una recarga electrónica 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.
Telefono	String de 10 caracteres del número telefónico al que se realizará la recarga.
Carrier	Compañía (Telcel, Movistar, Unefon, Iusacell (para AT&T también mandar como Iusacell), Nextel, Virgin, Cierto, Maztiempo, Alo).
Monto	Cantidad a recargar al número telefónico.

Estructura de cadena de respuesta POSITIVA para obtener una recarga electrónica de tiempo aire:

VARIABLE	TIPO
Folio	Número Entero de hasta 15 dígitos comprobante de folio de recarga.
Cantidad	Número Entero de la cantidad abonada al número telefónico.
Telefono	Número telefónico al que se realizó la recarga.
Carrier	Compañía de Telefonía a la que pertenece el número telefónico.

Estructura de cadena de respuesta de ERROR para obtener una recarga electrónica de tiempo aire:

VerificaRecarga(string).

La función VerificaRecarga se utiliza para verificar una recarga que por problema de timeout o error desconocido no se conozca el status.

La verificación de la recarga se debe realizar en caso de no haber recibido respuesta después de 90 segs (máximo a 100segs).
Si la recarga es exitosa la función devolverá el número de autorización, en caso contrario devolverá el tag de ERROR.

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

Estructura de cadena de envío para verificar una recarga electrónica del cliente:

VARIABLE	TIPO
Usuario	String proporcionado con el nombre de usuario de acceso al Portal.
Passwd	String proporcionado correspondiente a la contraseña de acceso.
Telefono	String de 10 caracteres del número telefónico al que se realizó la recarga.
Carrier	String del nombre del carrier al cual se hizo la recarga.
Fecha	Fecha en formato AAAA-MM-DD de la fecha en que se desea consultar una recarga.
Monto	Cantidad entera del monto de la recarga a consultar.

Estructura de cadena de respuesta POSITIVA para una recarga electrónica realizada:

VARIABLE	TIPO
Exito	Número de folio/autorización de la recarga consultada.

Estructura de cadena de respuesta de ERROR para obtener una recarga electrónica no realizada:

ProductosPDV(string).

VARIABLE	TIPO
Usuario	String proporcionado con el nombre de usuario de acceso al Portal.
Passwd	String proporcionado correspondiente a la contraseña de acceso.
Catalogo	0 para obtener Recargas y paquetes disponibles. 2 para obtener únicamente los paquetes disponibles.

Estructura de cadena de respuesta POSITIVA para obtener los productos disponibles:

<Resultado><Servicio>TELCEL SIN LIMITE<Producto><Nombre>10 x 1 HORA SOLO INTERNET</Nombre><Tipo>Paquetes</Tipo><Montos>10006</Montos></Producto><Producto><Nombre>SIN LIMITE 20 - 100MB 200MB SMS LLAMADAS ILIM 1d</Nombre><Tipo>Paquetes</Tipo><Montos>20006</Montos></Producto><Producto><Nombre>SIN LIMITE 30 - 120MB 300MB SMS LLAMADAS ILIM 3d</Nombre><Tipo>Paquetes</Tipo><Montos>30006</Montos></Producto><Producto><Nombre>SIN LIMITE 50 - 400MB 500MB SMS LLAMADAS ILIM 7d</Nombre><Tipo>Paquetes</Tipo><Montos>50006</Montos></Producto><Producto><Nombre>SIN LIMITE 80 - 500MB 1000MB SMS LLAMADAS ILIM 13d</Nombre><Tipo>Paquetes</Tipo><Montos>80006</Montos></Producto><Producto><Nombre>SIN LIMITE 100 - 1400MB SMS LLAMADAS ILIM 15d</Nombre><Tipo>Paquetes</Tipo><Montos>100006</Montos></Producto><Producto><Nombre>SIN LIMITE 150 - 2000MB SMS LLAMADAS ILIM26d</Nombre><Tipo>Paquetes</Tipo><Montos>150006</Montos></Producto><Producto><Nombre>SIN LIMITE 200 - 3000MB SMS LLAMADAS ILIM 30d</Nombre><Tipo>Paquetes</Tipo><Montos>200006</Montos></Producto><Producto><Nombre>SIN LIMITE 300 - 4000MB SMS LLAMADAS ILIM 33d</Nombre><Tipo>Paquetes</Tipo><Montos>300006</Montos></Producto><Producto><Nombre>SIN LIMITE 500 - 6000MB SMS LLAMADAS ILIM 33d</Nombre><Tipo>Paquetes</Tipo><Montos>500006</Montos></Producto></Servicio><Servicio>TELCEL INTERNET AMIGO<Producto><Nombre>15 x 2 HORAS SOLO INTERNET</Nombre><Tipo>Paquetes</Tipo><Montos>15</Montos></Producto><Producto><Nombre>AMIGO 20 - 120MB y 200MB REDES 1d</Nombre><Tipo>Paquetes</Tipo><Montos>20005</Montos></Producto><Producto><Nombre>AMIGO 30 - 150MB y 300MB REDES 3d</Nombre><Tipo>Paquetes</Tipo><Montos>30005</Montos></Producto><Producto><Nombre>AMIGO 50 - 500MB y 750MB REDES 7d</Nombre><Tipo>Paquetes</Tipo><Montos>50005</Montos></Producto><Producto><Nombre>AMIGO 100 - 1.6GB y Redes ilimitado 15d</Nombre><Tipo>Paquetes</Tipo><Montos>100005</Montos></Producto><Producto><Nombre>AMIGO 150 - 2.5G y redes ilimitado 26d</Nombre><Tipo>Paquetes</Tipo><Montos>150005</Montos></Producto><Producto><Nombre>AMIGO 200 - 3.5G y redes ilimitado 30d</Nombre><Tipo>Paquetes</Tipo><Montos>200005</Montos></Producto><Producto><Nombre>AMIGO 300 - 5GB y redes ilimitado 30d</Nombre><Tipo>Paquetes</Tipo><Montos>300005</Montos></Producto><Producto><Nombre>AMIGO 500 - 8G y redes ilimitado 30d</Nombre><Tipo>Paquetes</Tipo><Montos>500005</Montos></Producto></Servicio><Servicio>TELCEL<Producto><Nombre>RECARGA 10</Nombre><Tipo>Recargas</Tipo><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Tipo>Recargas</Tipo><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Tipo>Recargas</Tipo><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Tipo>Recargas</Tipo><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 80</Nombre><Tipo>Recargas</Tipo><Montos>80</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Tipo>Recargas</Tipo><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Tipo>Recargas</Tipo><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Tipo>Recargas</Tipo><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Tipo>Recargas</Tipo><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Tipo>Recargas</Tipo><Montos>500</Montos></Producto></Servicio><Servicio>MOVISTAR PAQUETE<Producto><Nombre>MOVISTAR 1D 150MB 50MIN 50SMS $10</Nombre><Tipo>Paquetes</Tipo><Montos>10007</Montos></Producto><Producto><Nombre>MOVISTAR 3D 300MB 50MIN 50SMS $30</Nombre><Tipo>Paquetes</Tipo><Montos>30007</Montos></Producto><Producto><Nombre>MOVISTAR 7D 600MB MIN Y SMS ILIM $50</Nombre><Tipo>Paquetes</Tipo><Montos>50007</Montos></Producto><Producto><Nombre>MOVISTAR 15D 1.5G REDES MIN Y SMS ILIM $100</Nombre><Tipo>Paquetes</Tipo><Montos>100007</Montos></Producto><Producto><Nombre>MOVISTAR 30D 3.5GB MIN Y SMS ILIM $200</Nombre><Tipo>Paquetes</Tipo><Montos>200007</Montos></Producto></Servicio><Servicio>MOVISTAR<Producto><Nombre>RECARGA 10</Nombre><Tipo>Recargas</Tipo><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Tipo>Recargas</Tipo><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Tipo>Recargas</Tipo><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 40</Nombre><Tipo>Recargas</Tipo><Montos>40</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Tipo>Recargas</Tipo><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 60</Nombre><Tipo>Recargas</Tipo><Montos>60</Montos></Producto><Producto><Nombre>RECARGA 70</Nombre><Tipo>Recargas</Tipo><Montos>70</Montos></Producto><Producto><Nombre>RECARGA 80</Nombre><Tipo>Recargas</Tipo><Montos>80</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Tipo>Recargas</Tipo><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 120</Nombre><Tipo>Recargas</Tipo><Montos>120</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Tipo>Recargas</Tipo><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Tipo>Recargas</Tipo><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 250</Nombre><Tipo>Recargas</Tipo><Montos>250</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Tipo>Recargas</Tipo><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 400</Nombre><Tipo>Recargas</Tipo><Montos>400</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Tipo>Recargas</Tipo><Montos>500</Montos></Producto></Servicio><Servicio>BAIT<Producto><Nombre>BAIT 50 (Cobra $51)</Nombre><Tipo>Recargas</Tipo><Montos>50</Montos></Producto><Producto><Nombre>BAIT 65 (Cobra $66)</Nombre><Tipo>Recargas</Tipo><Montos>65</Montos></Producto><Producto><Nombre>BAIT 125 (Cobra $126)</Nombre><Tipo>Recargas</Tipo><Montos>125</Montos></Producto><Producto><Nombre>BAIT 200 (Cobra $201)</Nombre><Tipo>Recargas</Tipo><Montos>200</Montos></Producto><Producto><Nombre>BAIT 300 (Cobra $301)</Nombre><Tipo>Recargas</Tipo><Montos>300</Montos></Producto></Servicio><Servicio>FLASH<Producto><Nombre>RECARGA 10</Nombre><Tipo>Recargas</Tipo><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Tipo>Recargas</Tipo><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Tipo>Recargas</Tipo><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 40</Nombre><Tipo>Recargas</Tipo><Montos>40</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Tipo>Recargas</Tipo><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 60</Nombre><Tipo>Recargas</Tipo><Montos>60</Montos></Producto><Producto><Nombre>RECARGA 70</Nombre><Tipo>Recargas</Tipo><Montos>70</Montos></Producto><Producto><Nombre>RECARGA 80</Nombre><Tipo>Recargas</Tipo><Montos>80</Montos></Producto><Producto><Nombre>RECARGA 120</Nombre><Tipo>Recargas</Tipo><Montos>120</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Tipo>Recargas</Tipo><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Tipo>Recargas</Tipo><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 250</Nombre><Tipo>Recargas</Tipo><Montos>250</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Tipo>Recargas</Tipo><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 400</Nombre><Tipo>Recargas</Tipo><Montos>400</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Tipo>Recargas</Tipo><Montos>500</Montos></Producto></Servicio><Servicio>IUSACELL / ATT<Producto><Nombre>RECARGA 15</Nombre><Tipo>Recargas</Tipo><Montos>15</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Tipo>Recargas</Tipo><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Tipo>Recargas</Tipo><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Tipo>Recargas</Tipo><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 70</Nombre><Tipo>Recargas</Tipo><Montos>70</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Tipo>Recargas</Tipo><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 120</Nombre><Tipo>Recargas</Tipo><Montos>120</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Tipo>Recargas</Tipo><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Tipo>Recargas</Tipo><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Tipo>Recargas</Tipo><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Tipo>Recargas</Tipo><Montos>500</Montos></Producto></Servicio><Servicio>JESNER<Producto><Nombre>JESNER 30</Nombre><Tipo>Recargas</Tipo><Montos>30</Montos></Producto><Producto><Nombre>JESNER 45</Nombre><Tipo>Recargas</Tipo><Montos>45</Montos></Producto><Producto><Nombre>JESNER 50</Nombre><Tipo>Recargas</Tipo><Montos>50</Montos></Producto><Producto><Nombre>JESNER 75</Nombre><Tipo>Recargas</Tipo><Montos>75</Montos></Producto><Producto><Nombre>JESNER 99 (30 DIAS)</Nombre><Tipo>Recargas</Tipo><Montos>99</Montos></Producto><Producto><Nombre>JESNER 100</Nombre><Tipo>Recargas</Tipo><Montos>100</Montos></Producto><Producto><Nombre>JESNER 140</Nombre><Tipo>Recargas</Tipo><Montos>140</Montos></Producto><Producto><Nombre>JESNER 150</Nombre><Tipo>Recargas</Tipo><Montos>150</Montos></Producto><Producto><Nombre>JESNER 200</Nombre><Tipo>Recargas</Tipo><Montos>200</Montos></Producto><Producto><Nombre>JESNER 300</Nombre><Tipo>Recargas</Tipo><Montos>300</Montos></Producto></Servicio><Servicio>NEXTEL<Producto><Nombre>RECARGA 30</Nombre><Tipo>Recargas</Tipo><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Tipo>Recargas</Tipo><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Tipo>Recargas</Tipo><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Tipo>Recargas</Tipo><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Tipo>Recargas</Tipo><Montos>500</Montos></Producto></Servicio><Servicio>UNEFON<Producto><Nombre>RECARGA 10</Nombre><Tipo>Recargas</Tipo><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 15</Nombre><Tipo>Recargas</Tipo><Montos>15</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Tipo>Recargas</Tipo><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Tipo>Recargas</Tipo><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Tipo>Recargas</Tipo><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 70</Nombre><Tipo>Recargas</Tipo><Montos>70</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Tipo>Recargas</Tipo><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 120</Nombre><Tipo>Recargas</Tipo><Montos>120</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Tipo>Recargas</Tipo><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Tipo>Recargas</Tipo><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Tipo>Recargas</Tipo><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Tipo>Recargas</Tipo><Montos>500</Montos></Producto><Producto><Nombre>RECARGA 750</Nombre><Tipo>Recargas</Tipo><Montos>750</Montos></Producto></Servicio><Servicio>VIRGIN<Producto><Nombre>RECARGA 20</Nombre><Tipo>Recargas</Tipo><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Tipo>Recargas</Tipo><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 40</Nombre><Tipo>Recargas</Tipo><Montos>40</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Tipo>Recargas</Tipo><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Tipo>Recargas</Tipo><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Tipo>Recargas</Tipo><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Tipo>Recargas</Tipo><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Tipo>Recargas</Tipo><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Tipo>Recargas</Tipo><Montos>500</Montos></Producto></Servicio><Servicio>WEEX<Producto><Nombre>RECARGA 10</Nombre><Tipo>Recargas</Tipo><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Tipo>Recargas</Tipo><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Tipo>Recargas</Tipo><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 40</Nombre><Tipo>Recargas</Tipo><Montos>40</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Tipo>Recargas</Tipo><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 60</Nombre><Tipo>Recargas</Tipo><Montos>60</Montos></Producto><Producto><Nombre>RECARGA 70</Nombre><Tipo>Recargas</Tipo><Montos>70</Montos></Producto><Producto><Nombre>RECARGA 80</Nombre><Tipo>Recargas</Tipo><Montos>80</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Tipo>Recargas</Tipo><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 120</Nombre><Tipo>Recargas</Tipo><Montos>120</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Tipo>Recargas</Tipo><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Tipo>Recargas</Tipo><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 250</Nombre><Tipo>Recargas</Tipo><Montos>250</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Tipo>Recargas</Tipo><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 400</Nombre><Tipo>Recargas</Tipo><Montos>400</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Tipo>Recargas</Tipo><Montos>500</Montos></Producto></Servicio></Resultado>

Estructura de cadena de respuesta de ERROR para obtener los productos disponibles: