MANUAL DE API

SMS Broadcaster TIGO

1
Contenido
1 Objetivo .................................................................................................................... 4

2 Caractersticas Generales ....................................................................................... 4

3 Web Service para envo y Recepcin de SMS ....................................................... 5

3.1 Mtodo: enviarSMS.........................................................................................................5

3.1.1 Parmetros ................................................................................................................. 6

3.1.2 Ejemplo de Solicitud SOAP ........................................................................................ 7

3.1.3 Ejemplo Solicitid GET ................................................................................................. 7

3.1.4 Objeto de Respuesta: clRespuesta ............................................................................ 7

3.2 Mtodo enviarBulkSms ...................................................................................................8

3.2.1 Parmetros ................................................................................................................. 8

3.2.2 Sub-objeto: clMensajes .............................................................................................. 8

3.2.3 Ejemplo de Solicitud SOAP ........................................................................................ 9

3.2.4 Objeto de Respuesta: clRespuestaBulksms ............................................................ 10

3.3 Mtodo enviarBulkSmsXML ..........................................................................................10

3.3.1 Parmetros ............................................................................................................... 10

3.3.2 Ejemplo de Solicitud SOAP ...................................................................................... 11

3.3.3 Objeto de Respuesta: clRespuestaBulksmsXML ..................................................... 12

3.4 Mtodo: Confirmacin SMS ..........................................................................................13

3.4.1 Parmetros ............................................................................................................... 13

3.4.2 Objeto de Respuesta: clConfirmacionSMS .............................................................. 14

3.4.3 Sub-objeto de respuesta: clListadoEnvios ............................................................... 14

3.5 Mtodo: RespuestaSMS ...............................................................................................15

3.5.1 Parmetros ............................................................................................................... 15

3.5.2 Objeto de Respuesta: clRespuestasSMS ................................................................ 15

3.5.3 Sub-objeto de respuesta: clListaRespuestas ........................................................... 16

3.6 Cdigos de Estado ........................................................................................................16

4 Envo y Recepcin SMS por Insercin a Base de Datos ..................................... 18

4.1 Envo de Mensajes ........................................................................................................18

2
 4.2 Consulta de Respuestas ...............................................................................................19

4.3 Opcional: Consulta de Estado de envo........................................................................19

3
1 Objetivo
El objetivo de este documento es explicar los distintos puntos de conectividad disponibles para el
envo y recepcin de mensajes SMS a travs de la herramienta SMS Broadcaster de TIGO.

2 Caractersticas Generales
El SMS Broadcaster cuenta con varios puntos de conexin para el envo y recepcin de mensajes
SMS:

Web Service SOAP, GET y POST

Inserciones y lecturas de base de datos SQL Server

E-Mail to SMS

SMPP

La finalidad de este documento es describir en detalla la forma de utilizar:

Web Service SOAP, GET y POST

Inserciones y lecturas de base de datos SQL Server

El resto de modalidades por considerarse estndar no se mencionan en este manual:

1. E-Mail to SMS: Consiste nicamente en generar un correo electrnico a la direccin:

[celular destino]@ smscorp.tigobusiness.cr

2. SMPP: Se refiere al protocolo estndar para recepcin y envo de SMS. Se recomienda

que solo sea utilizada por empresas que ya cuenten con este protocolo implementado en
sus sistemas internos.

4
3 Web Service para envo y Recepcin de SMS
El Web Service utilizado es bastante sencillo y consta nicamente con cinco mtodos:

enviarSMS: Mtodo utilizado para enviar un SMS a cualquier operadora de Centroamrica

a travs del SMS Broadcaster de TIGO

enviarBulkSms: Mtodo utilizado para enviar uno o ms SMS a cualquier operadora de

Centroamrica a travs del SMS Broadcaster de TIGO. La lista de mensajes a enviar se
especifica como un arreglo de objetos.

enviarBulkSmsXml: Mtodo utilizado para enviar uno o ms SMS a cualquier operadora

de Centroamrica a travs del SMS Broadcaster de TIGO. La lista de mensajes a enviar se
especifica en una cadena de caracteres en formato XML.

confirmacionSMS: Mtodo para consultar el estado de uno o varios SMS enviados a

travs del mtodo enviarSMS

respuestaSMS1: Mtodo utilizado para extraer las respuestas recibidas (SMS entrantes)

Para la utilizacin del API es necesario que el cliente tenga configurado en el SMS
Broadcaster un SENDER con permisos para utilizacin de API. Es necesario solicitar
dichos permisos a TIGO.

El API soporta los siguientes formatos de peticin al Web Service (se utiliza la misma URL para
todos):

SOAP

HTTP GET

HTTP POST

3.1 Mtodo: enviarSMS

El mtodo enviarSMS es utilizado para enviar un SMS a destinos en cualquier operadora de
Centroamrica a travs del SMS Broadcaster de TIGO.

El mtodo puede llamarse va SOAP, HTTP GET o HTTP POST.

1 Los mensajes entrantes solo estn disponibles si el cliente solicito la funcionalidad de recibir respuestas en el SMS
Broadcaster

5
3.1.1 Parmetros

Parmetro Descripcin Tipo de dato

usuario Usuario utilizado para autenticarse en el SMS Broadcaster, Cadena de

este usuario ser proporcionado por TIGO. caracteres

contrasena Contrasea utilizada para autenticarse en el SMS Broadcaster, Cadena de

ser proporcionado por TIGO. Caracteres

numero Nmero de telfono del destinatario del mensaje. Debe Cadena de

incluirse el cdigo de pas (503 en el caso de El Salvador, ej.: caracteres
50378870000)

mensaje El mensaje que se desea enviar por SMS. Cadena de

caracteres
Nota importante: El estndar requiere que cada SMS tenga
un mximo de 160 caracteres. Es posible enviar mensajes de
tamao mayor pero esto implica que:

Se generaran varios SMS concatenados para enviar

el mensaje

Aun cuando es un solo mensaje su costo depender

de la cantidad de SMS requeridos para el envo del
mismo

Remitente Es el nmero origen del SMS (longitud mxima 11 Cadena de texto

caracteres). Se aceptan remitentes alfanumricos. Los
remitentes alfanumricos solo son compatibles con la red
TIGO y Claro de El Salvador para otras redes el remitente
alfanumrico es sustituido de manera automtica por un
nmero.

6
3.1.2 Ejemplo de Solicitud SOAP

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tigo="https:// tigo.com.sv/wsAPIBulkSMS">
<soapenv:Header/>
<soapenv:Body>
< enviarSMS >
<!Mandatory -->
< usuario>?</ usuario>
< contrasea >?</ contrasea >
< numero >?</ numero >
<mensaje >?</ mensaje >
<remitente >?</ remitente >
</ enviarSMS >
</soapenv:Body>
</soapenv:Envelope>

3.1.3 Ejemplo Solicitid GET

http://apisms.tigobusiness.com.ni/wsAPISmsCorp.asmx/wsAPISmsCorp.asmx/enviarSMS?usuario
=generico&contrasena=xxxxxx&numero=50379872374&mensaje=test&remitente=Tigo

3.1.4 Objeto de Respuesta: clRespuesta

Una vez invocado el mtodo enviarSMS se retornar un objeto de tipo clRespuesta.

El formato en que se retorna este objeto por defecto es XML, pero puede solicitarse en JSON
usando el header HTTP:

Accept: application/json

El objeto cuenta con las siguientes propiedades:

Parmetro Descripcin Tipo de dato

codigoEstado Cdigo de estado del resultado de la transaccin, referirse a Entero de 32bits

la seccin 3.6 para ver los posibles cdigos de estado

esEnvioExitoso Si el cliente no desea manejar los distintos estados de Bolean

transaccin (codigoEstado) basta utilizar este valor para
determinar si el mensaje se encolo exitosamente

7
MensajeRespuesta Mensaje descriptivo relacionado con el codigoEstado Cadena de
caracteres

referencia Referencia nica para identificar el mensaje al momento de Entero 32 bits

consultar la confirmacin de entrega

3.2 Mtodo enviarBulkSms

Mtodo utilizado para enviar uno o ms SMS a cualquier operadora de Centroamrica a travs del
SMS Broadcaster de TIGO.

La lista de mensajes a enviar se especifica como un arreglo de objetos clMensajes.

3.2.1 Parmetros

Parmetro Descripcin Tipo de dato

usuario Usuario utilizado para autenticarse en el SMS Broadcaster, Cadena de

este usuario ser proporcionado por TIGO. caracteres

contrasena Contrasea utilizada para autenticarse en el SMS Broadcaster, Cadena de

ser proporcionado por TIGO. Caracteres

mensajes Arreglo de la clase clMensaje Array de la clases

clMensaje

3.2.2 Sub-objeto: clMensajes

Parmetro Descripcin Tipo de dato

Numero Nmero de telfono del destinatario del mensaje. Debe Cadena de

incluirse el cdigo de pas (503 en el caso de El Salvador, caracteres
ej.: 50378870000)

Mensaje El mensaje que se desea enviar por SMS. Cadena de

caracteres
Nota importante: El estndar requiere que cada SMS
tenga un mximo de 160 caracteres. Es posible enviar
mensajes de tamao mayor pero esto implica que:

Se generaran varios SMS concatenados para

enviar el mensaje

8
 An cuando es un solo mensaje su costo
depender de la cantidad de SMS requeridos para
el envo del mismo

Remitente Es el nmero por el cual enviara el SMS (longitud mxima Cadena de

11 caracteres). Se aceptan remitentes alfanumricos. Los texto
remitentes alfanumricos solo son compatibles con la red
TIGO y Claro de El Salvador para otras redes el remitente
alfanumrico es sustituido de manera automtica por un
nmero.

3.2.3 Ejemplo de Solicitud SOAP

<soap:Envelopexmlns: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:Body>

<enviarBulkSms xmlns="http://tempuri.org/">

<!Mandatory -->
<usuario>?</usuario>

<contrasena>?</contrasena>

<Mensajes>

<clMensajes>

<numero>999999</numero>

<mensaje>xxx</mensaje>

<remitente>xxx</remitente>

</clMensajes>

<clMensajes>

<numero>999999</numero>

<mensaje>xxx</mensaje>

<remitente>xxx</remitente>

</clMensajes>

</Mensajes>

</enviarBulkSms>

</soap:Body>

</soap:Envelope>

9
3.2.4 Objeto de Respuesta: clRespuestaBulksms

Una vez invocado el mtodo enviarBulkSms se retornar un objeto de tipo clRespuestaBulksms.

El formato en que se retorna este objeto por defecto es XML, pero puede solicitarse en JSON
usando el header HTTP:

Accept: application/json

El objeto cuenta con las siguientes propiedades:

Parmetro Descripcin Tipo de dato

codigoEstado Cdigo de estado del resultado de la transaccin, referirse a Entero de 32bits

la seccin 4 para ver los posibles cdigos de estado

esEnvioExitoso Si el cliente no desea manejar los distintos estados de Bolean

transaccin (codigoEstado) basta utilizar este valor para
determinar si el mensaje se encolo exitosamente

MensajeRespuesta Mensaje descriptivo relacionado con el codigoEstado Cadena de

caracteres

3.3 Mtodo enviarBulkSmsXML

Mtodo utilizado para enviar uno o ms SMS a cualquier operadora de Centroamrica a travs del
SMS Broadcaster de TIGO.

La lista de mensajes a enviar se especifica en una cadena de caracteres en formato XML.

3.3.1 Parmetros

Parmetro Descripcin Tipo de dato

usuario Usuario utilizado para autenticarse en el SMS Broadcaster, Cadena de

este usuario ser proporcionado por TIGO. caracteres

contrasena Contrasea utilizada para autenticarse en el SMS Broadcaster, Cadena de

ser proporcionado por TIGO. Caracteres

mensajes Contiene una cadena de caracteres en formato XML listando Cadena de

los mensajes a enviar. Estructura del XML requerido: Caracteres

10
 <?xml version="1.0" encoding="UTF-8" ?>

<mensajes>

<clMensajes>

<numero>9999999</numero>

<mensaje>test</mensaje>

<remitente>XX</remitente>

</clMensajes>

<clMensajes>

<numero>88888888</numero>

<mensaje>Hola test</mensaje>

<remitente>Mundial</remitente>

</clMensajes>

</mensajes>

3.3.2 Ejemplo de Solicitud SOAP

<soap:Envelopexmlns: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:Body>

<enviarBulkSmsXML xmlns="http://tempuri.org/">

<!Mandatory -->

<usuario>?</usuario>

<contrasena>?</contrasena>

<Mensajes>

Cadena de caracteres en formato XML de acuerdo a lo especificado en la tabla anterior (tabla 3.3.1)

</Mensajes>

</enviarBulkSmsXML>

</soap:Body>

</soap:Envelope>

11
3.3.3 Objeto de Respuesta: clRespuestaBulksmsXML

Una vez invocado el mtodo enviarBulkSmsXML se retornar un objeto de tipo

clRespuestaBulksms.

El formato en que se retorna este objeto por defecto es XML, pero puede solicitarse en JSON
usando el header HTTP:

Accept: application/json

El objeto cuenta con las siguientes propiedades:

Parmetro Descripcin Tipo de dato

codigoEstado Cdigo de estado del resultado de la transaccin, referirse a Entero de 32bits

la seccin 4 para ver los posibles cdigos de estado

esEnvioExitoso Si el cliente no desea manejar los distintos estados de Bolean

transaccin (codigoEstado) basta utilizar este valor para
determinar si el mensaje se encolo exitosamente

MensajeRespuesta Mensaje descriptivo relacionado con el codigoEstado Cadena de

caracteres

12
3.4 Mtodo: Confirmacin SMS
Mtodo para consultar el estado de uno o varios SMS enviados a travs del mtodo enviarSMS.
Los posibles estados de un SMS son:

CON= confirmacin lectura (mensaje enviados exitosamente, que cuenta con confirmacin
de entrega del dispositivo mvil, no todas las operadoras son compatibles con esta
funcionalidad)

ENV=Enviado (mensaje enviado exitosamente, el envo exitoso se determina por una

confirmacin del SMSC no del celular)

ERR= Entrega fallida

PEN= Pendiente de enviar, es decir an esta encolado (normalmente un mensaje no pasa

encolado nunca por ms de 10 segundos)

Nota Importante: La confirmacin de entrega no es posible en todos los casos debido a

limitantes en algunas operadoras.

El mtodo puede llamarse va SOAP, HTTP Get o HTTP POST.

3.4.1 Parmetros

Parmetro Descripcin Tipo de dato

usuario Usuario utilizado para autenticarse en el SMS Broadcaster, Cadena de

este usuario ser proporcionado por TIGO. caracteres

contrasena Contrasea utilizada para autenticarse en el SMS Broadcaster, Cadena de

ser proporcionado por TIGO. Caracteres

referencias Lista de referencias divididas por comas para identificar los Cadena de
mensajes SMS para los que se desea consultar su estado. caracteres

La referencia se obtiene de la propiedad referencia del objeto

clRespuesta retornado por el mtodo enviarSMS (ver
seccin 3.1.3).

Nota importante: Para lograr que el sistema sea ms

eficiente se sugiere consultar ms de una referencia a la vez.

13
3.4.2 Objeto de Respuesta: clConfirmacionSMS

Una vez invocado el mtodo confirmacionSMS se retornar un objeto de tipo

clConfirmacionSMS.

El formato en que se retorna este objeto por defecto es XML, pero puede solicitarse en JSON
usando el header HTTP:

Accept: application/json

El objeto cuenta con las siguientes propiedades:

Parmetro Descripcin Tipo de dato

codigoEstado Cdigo de estado del resultado de la transaccin, referirse a Entero de 32bits

la seccin 3.5 para ver los posibles cdigos de estado

MensajeRespuesta Mensaje descriptivo relacionado con el codigoEstado Cadena de

caracteres

Lista Arreglo de objetos de tipo clListadoEnvios. El arreglo tiene Arreglo de tipo

un elemento por cada referencia enviada en la propiedad clListadoEnvios
referencia del mtodo confirmacionSMS.

El arreglo viene vacio si la consulta no fue exitosa segn lo

reflejado en la propiedad codigoEstado

3.4.3 Sub-objeto de respuesta: clListadoEnvios

Parmetro Descripcin Tipo de dato

referencia Referencia nica para identificar el mensaje, es la misma Entero 32 bits

referencia retornada en la propiedad del objeto clRespuesta
del mtodo enviarSMS

destino Nmero de telfono del destinatario a quien fue dirigido el Cadena de

mensaje. caracteres

senderId Identificador del senderID (remitente) que se utiliz para Cadena de

enviar el mensaje. Esto es equivalente al remitente del caracteres
mensaje.

Para el API comnmente se utilizas el SenderID genrico

estado El estado en que se encuentra el mensaje, los posibles Cadena de

14
 valores son: caracteres

CON= confirmacin lectura

ENV=Enviado

ERR= Entrega fallida

PEN= Pendiente de enviar, es decir an encolado

descripcion Descripcin relacionada con el estado definido en la Cadena de

propiedad estado caracteres

3.5 Mtodo: RespuestaSMS

En algunas ocasiones la plataforma se configura de tal manera que el cliente puede responder a
los mensajes enviados. Este mtodo permite al cliente extraer esas respuestas para procesarlas
como le parezca conveniente.

3.5.1 Parmetros

Parmetro Descripcin Tipo de dato

usuario Usuario utilizado para autenticarse en el SMS Broadcaster, Cadena de

este usuario ser proporcionado por TIGO. caracteres

contrasena Contrasea utilizada para autenticarse en el SMS Broadcaster, Cadena de

ser proporcionado por TIGO. Caracteres

3.5.2 Objeto de Respuesta: clRespuestasSMS

Una vez invocado el mtodo respuesSMS se retornar un objeto de tipo clRespuestasSMS que
cuenta con las siguientes propiedades:

Parmetro Descripcin Tipo de dato

codigoEstado Cdigo de estado del resultado de la transaccin, referirse a Entero de 32bits

la seccin 3.5 para ver los posibles cdigos de estado

MensajeRespuesta Mensaje descriptivo relacionado con el codigoEstado Cadena de

caracteres

Lista Arreglo de objetos de tipo clListaRespuestas. El arreglo Arreglo de tipo

tiene un elemento por cada respuesta extrada. clListaRespuest

15
 as
El arreglo viene vaci si la consulta no fue exitosa segn lo
reflejado en la propiedad codigoEstado

Referirse a la siguiente seccin para ver el detalle del objeto

clListaRespuestas.

3.5.3 Sub-objeto de respuesta: clListaRespuestas

Parmetro Descripcin Tipo de dato

codigo Referencia nica para identificar el mensaje respuesta Entero 64 bits

remitente Nmero de telfono se utiliz para enviar el mensaje. Cadena de

caracteres

destinatario Nmero de telfono que recibi el mensaje de texto. Cadena de

caracteres

mensaje Texto que el remitente envi. Cadena de

caracteres

fechaIngreso Fecha que se registr la respuesta en el sistema Fecha

3.6 Cdigos de Estado

Cdigo de Mensaje Aplica para Aplica para Aplica para Aplica para Aplica para
estado enviarSMS enviarBulkS enviarBulkSMS confirmacionSM respuestaSM
MSXML S S

0 Mensaje colocado SI SI SI SI No
exitosamente

1 Parmetro USUARIO vaco SI SI SI SI Si

2 Parmetro CONTRASENA SI SI SI SI Si
vaco

3 Parmetro NUMERO vaco SI SI SI SI No

4 Formato de NUMERO no valido SI SI SI SI No

5 Parmetro MENSAJE vaco SI SI SI SI No

16
 6 Usuario o contrasea invalida SI SI SI SI Si

7 Usuario est inactivo SI SI SI SI Si

8 API no configurada para la SI SI SI NO No

cuenta del usuario

9 Error al conectarse a la base SI SI SI SI Si

de Datos

10 Error no controlado SI SI SI SI Si

11 Parmetro REFERENCIAS NO NO NO SI No
vacio

12 Listado de referencias exitoso NO NO NO SI No

13 Parmetro Remitente vacio SI SI SI NO No

14 Parmetro Remitente pasa los Si Si Si No No

11 caracteres

15 El nmero de telfono Si Si Si No No
ingresado no es valido,
recuerde utilizar el formato
[codigoPas] +
[numeroTelefono], solo son
aceptado telfonos de El
Salvador. En el caso de
nmeros para El Salvador el
[codigoPas] es opcional

16 El nmero Corto de la No No No No Si
Campaa no permite
Respuestas

17 Listado de Respuestas exitoso No No No No Si

18 Arraglo de mensajes vacio No SI SI No No

19 Formato Error XML NO NO Si No No

17
4 Envo y Recepcin SMS por Insercin a Base de Datos
Por su facilidad de implementacin el SMS Broadcaster permite enviar SMS mediante la insercin
de los mensajes en una tabla de SQL Server. Adicionalmente se provee una vista donde el cliente
puede consultar los mensajes entrantes 2 y estado de mensajes enviados.

Todos los objetos de SQL Server descritos en este documento se encuentran en la base de datos
bulkSMS, esta ser la base de datos por defecto para el usuario de SQL Server que se
entregar al cliente.

El usuario de SQL Server entregado al cliente tiene los permisos restringidos y nicamente puede:

Hacer INSERT en la tabla bandejaSalidaSMS los SELECT a esa tabla no son permitidos

Hacer SELECT a la vista vwBandejaEntrada[nombreCliente]

Hacer SELECT a la vista vwBandejaSalida[nombreCliente]

4.1 Envo de Mensajes

Para enviar mensajes el cliente tiene que hacer INSERT con los mensajes en la tabla
bulksms_nc.dbo.bandejaSalidaSMS, al hacer el insert es necesario completar los siguientes
campos:

Usuario: dato enviado con las credenciales de la empresa

Password: Dato enviado con las credenciales de la empresa

Celular: celular destino del mensaje

Remitente: Nmero de telfono o nombre del remitente del mensaje3

Mensaje: Contenido del mensaje. Cada SMS puede contener un mximo de 160
caracteres. El sistema permite enviar mensajes ms grandes pero estos se envan por
medio de mensajes concatenados (un SMS por cada 160 se caracteres, al llegar al celular
todos los SMS se unen en un solo mensaje y el proceso es transparente para el usuario
final). El cobro al cliente es por SMS no por mensaje.

2 Los mensajes entrantes solo estn disponibles si el cliente solicito la funcionalidad de recibir respuestas en el SMS
Broadcaster

3 Solo se pueden utilizar remitentes asignados por TIGO

18
Al insertar el mensaje se puede utilizar el comando @@identity de SQL server para obtener el
cdigo del mensaje y de esta manera consultar su estado posteriormente.

4.2 Consulta de Respuestas

Para consultar las respuestas recibidas (mensajes entrantes) basta con hacer una consulta a la
vista: bulksms_NC.dbo.vwBandejaEntrada[nombreCliente].

La vista retorna los siguientes campos:

Codigo: Identificador nico del mensaje entrante

Mensaje: Contenido del mensaje entrante

numeroDestino: Numero adonde el usuario envi el mensaje (generalmente este es el

mismo nmero que se utiliza como remitente en el mensaje saliente)

numeroAutor: Numero del celular desde donde se origin el mensaje

campana: Es posible que se tenga activo el servicio de envo de campaas desde la

interfaz web del Broadcaster. En ese caso esta consulta extraer tambin los mensajes
entrantes generados a partir de los mensajes salientes de las campaas. Este campo
muestra la campaa relacionada al mensaje entrante.

Accountid: Cdigo de la operadora desde donde se origin el mensaje

OutgoingId: cdigo del mensaje saliente relacionado con este mensaje entrante

FechaIngreso: Fecha y hora en que se recibi el mensaje entrante.

4.3 Opcional: Consulta de Estado de envo

Para consultar el envo el cliente debe haber obtenido al momento de insertar el mensaje el cdigo
auto-numrico del mismo por medio del comando @@identity. Para efectos prcticos de este
documento denominaremos dicho cdigo como @codigo.

Para saber el estado del mensaje basta consultar el campo exitoso de la vista
bulksms_NC.dbo.vwBandejaSalida[nombreCliente]

. Los posibles valores de este campo son:

Nulo: El mensaje an no se ha procesado (esta en cola)

True: El mensaje fue exitoso

False: El mensaje fallo.

Un ejemplo de consulta seria:

19
SELECT exitoso FROM bulksms_NC.dbo.vwBandejaSalidaAsesuisa where
codigo=@codigo

20