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?wsdl

El 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 obtenido en la función EnviarSMS.

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:

Ir al Inicio