Windows Communication Foundation (WCF) es un marco de trabajo para la creación de aplicaciones orientadas a servicios. Con WCF, es posible enviar datos como mensajes asincrónicos de un extremo de servicio a otro. Un extremo de servicio puede formar parte de un servicio disponible continuamente hospedado por IIS, o puede ser un servicio hospedado en una aplicación. Un extremo puede ser un cliente de un servicio que solicita datos de un extremo de servicio. Los mensajes pueden ser tan simples como un carácter o una palabra que se envía como XML, o tan complejos como una secuencia de datos binarios.
Ventas SOAP nace en este contexto, de manera que desarrolladores y clientes lo podrán utilizar, para crear sus propias aplicaciones.
| Table of Contents | ||
|---|---|---|
|
Preguntas Frecuentes
¿Qué es Venta SOAP?
Venta SOAP es la API que Defontana ofrece a sus clientes, para que estos puedan realizar las aplicaciones que más le acomoden, interactuando de una manera estandarizada. Este contiene una gran cantidad de métodos que permiten realizar un proceso dentro del sistema Defontana.
EL Venta SOAP está compuesto por un conjunto de funciones (métodos), los cuales se presentan un documento técnico en detalle.
¿Con que parte de Defontana me Conecto?
Venta SOAP está disponible sólo con la parte ciclo comercial que corresponde a ventas y a generar una venta de tipo electrónica.
¿Cómo Funciona?
Al cliente, usuario o desarrollador que esté interesado en utilizar el Venta SOAP, se le entregan los datos de conexión a un ambiente de pruebas. Con esto se podrá conectar al Venta SOAP. Al conectarse y establecer la referencia al Venta SOAP, se podrán visualizar los métodos.
¿Qué aplicaciones Puedo Crear?
Se pueden crear todas las aplicaciones que se ocurran, relacionadas almacenar documentos electrónicos y obtener el estado de éste. Desde aplicaciones móviles, hasta de escritorio.
Consideraciones
Sesión
La sesión es manipulada por el servicio mediante un objeto de tipo Sesion (no confundir con el objeto Session) para identificar en todo momento al usuario, la empresa y el cliente que está operando con el sistema. De esta manera el servicio puede validar niveles de acceso de los usuarios a cada método expuesto.
Esta sesión no tiene tiempo de expiración. Solo se expira cuando:
- Se invoca al método Logout.
- Se inicia sesión con el mismo usuario, empresa y cliente desde otra ubicación.
Se recomienda mantener esta sesión a lo largo de todo el ciclo de operación del usuario con el sistema y evitar iniciar una sesión por cada acción realizada por el usuario, lo cual implicaría un deterioro notable en el desempeño del servicio.
Excepciones
Los métodos expuestos por este servicio consideran el flujo normal de ejecución de cada tarea a ejecutar, es por esto que cualquier situación fuera de este flujo normal lanzará una excepción indicando las razones que la provocaron.
Es por esto que se recomienda encerrar la llamada a los métodos en un bloque de control de excepciones (Ej.: try… catch…).
Enumeraciones
| Child pages (Children Display) | ||||
|---|---|---|---|---|
|
Clases
Métodos
| language | vb |
|---|---|
| linenumbers | true |
| Child pages (Children Display) | ||||
|---|---|---|---|---|
|
Modo de Operación
La forma de operar con este webservice simula la forma de operar con el ERP.
1. Se debe crear una referencia al servicio web:
| Code Block | ||||
|---|---|---|---|---|
| ||||
Dim ws As New ServiceClient() |
2. Iniciar una sesión: De la misma forma en que se inicia sesión en el sistema, se debe enviar el código del cliente, del usuario y la contraseña al servidor. El método Login acepta estos parámetros y retorna un objeto de tipo Sesion, el que debe ser usado para invocar todos los métodos.
| Code Block | ||||
|---|---|---|---|---|
| ||||
Dim sesion As Sesion
sesion = ws.Login( "CODIGO_CLIENTE", "CODIGO_USUARIO", "PASSWORD", "IP_ORIGEN") |
3. Finalizar la sesión: