Webservice SMS
Debido a la baja de comisiones de Movistar a nivel nacional a partir del 21 de Enero se te cobrará una comisión del 0.005% por cada Recarga Movistar. Así, de una recarga de $10 pesos se te cobrará $10.05 en saldo, de una recarga de $100 se te cobrará $100.50 por lo que deberás cobrarle los centavos extra al usuario final.
Preguntas Frecuentes
¿A quién va dirigido éste manual?
A todos los usuarios que deseen realizar envíos y recepción a través de mensajes de texto (SMS) mediante 2 vías.
¿Quiénes pueden realizar SMS por 2 vías?Todos los usuarios registrados dentro del sistema podrán realizar operaciones de VSMS por 2 vías.
¿Por dónde empiezo?El primer paso es solicitar a su Distribuidor le active un número de celular para operaciones por SMS, deberá proporcionar un número celular a 10 dígitos para activar las operaciones a dicho número celular (no importa la compañía), el alta es inmediata por lo que no deberá esperar confirmaciones.
¿Cuánto cuesta cada operación?Cada operación le costará 15 centavos de su saldo en el sistema.
Consideraciones Generales
Todas las transacciones que reciban una respuesta exitosa por parte del WebService generarán un costo (0.15 centavos) para el cliente consumidor.
Bajo ninguna circunstancia se podrá solicitar el reembolso de paquetes de datos realizados exitosas.
El tiempo máximo de respuesta por parte del WebService será de 90 segundos para realizar una consulta o transferencia.
Cada usuario es responsable de sus claves de acceso al WebService.
URL del Webservice:
https://www.ventatelcel.com/ws/smsapp.php?wsdlEl servicio contiene 3 funciones que son:
- SaldoSMS
- EnviarSMS
- RecibirSMS
SaldoSMS (string)
La función recibe un valor de tipo String: Dicho String corresponde a la cadena XML que será enviada al servidor 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:
EnviarSMS (string).
La función recibe un valor de tipo String:
Dicho String corresponde a la cadena XML que será enviada al servidor 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 enviar SMS:
TAG | DESCRIPCIÓN |
Usuario | Usuario proporcionado por el sistema. |
Clave | Clave de acceso. |
Mensaje | Texto a enviar enviado en BASE64. |
Telefono | Número telefónico a 10 dígitos adonde se enviará el SMS. |
Estructura de cadena de respuesta POSITIVA:
PARÁMETROS DE RESPUESTA | |
TAG | DESCRIPCIÓN |
Folio | Folio único de la transacción por cada SMS enviado a la plataforma. |
Telefono | Número telefónico al que fue enviado el SMS. |
Estructura de cadena de respuesta de ERROR:
RecibirSMS (string).
La función recibe un valor de tipo String:
Dicho String corresponde a la cadena XML que será enviada al servidor para su procesamiento.
Ésta función regresará un valor de tipo String como respuesta correspondiente a una cadena XML.
La función RecibirSMS depende de la función EnviarSMS pues requiere se le envíe
el tag
Nota:La función RecibirSMS se deberá mandar llamar en un ciclo por un lapso de 60 a 90 segundos hasta encontrar como respuesta el Folio de la transacción, esto significa que el mensaje de 2 vías ha sido enviado y procesado satisfactoriamente.
Estructura de cadena de envío:
PARÁMETROS DE ENVÍO | |
TAG | DESCRIPCIÓN |
Usuario | Usuario proporcionado por el sistema. |
Clave | Clave de acceso. |
Folio | Folio obtenido por la función EnviarSMS. |
Estructura de cadena de respuesta POSITIVA:
PARÁMETROS DE RESPUESTA | |
TAG | DESCRIPCIÓN |
Folio | Folio único de la transacción por cada SMS enviado a la plataforma. |
Mensaje | Mensaje de respuesta. |
FechaRespuesta | Fecha en la que fue guardado el mensaje de respuesta. |
Estructura de cadena de respuesta de ERROR: