Ejemplo en lenguaje CSharp

Tiene como objetivo ejemplificar el proceso de conexión, acceso y uso de las propiedades y métodos ofrecidos por el Servicio Web de Integración de TFHKA a través del lenguaje de programación C Sharp (C#) de la plataforma .Net. /

Independientemente del tipo de proyecto C# con el cual se trabaje: Consola, Winforms o WPF, lo más importante es establecer los pasos necesarios para realizar una integración exitosa.

Criterios a tomar en cuenta:

• Establecer una referencia al Servicio Web de Integración de TFHKA
• Instanciar el objeto a través del cual se tendrá acceso a los métodos del Servicio Web de TFHKA.
• Construir / Armar el objeto Documento Electrónico (Factura) que se desea enviar al Servicio Web de Integración de TFHKA, a través de los objetos respectivos.
• Enviar el documento al Servicio Web de Integración de TFHKA para su procesamiento.
• Recibir y procesar la respuesta del Servicio Web de TFHKA en nuestro proyecto, según sea requerido.

Pasos para realizar la integración:

PASO 1: Agregar una nueva Referencia de Servicio en su proyecto, utilizando la URL del Servicio Web de Integración de TFHKA referida en este documento.

PASO 2: Crear una instancia del objeto 'ServiceCliente' del Servicio Wed de Integración de TFHKA, previamente referenciado.

PASO 3: Construir el Documento Electrónico a enviar, en base a los objetos provistos por el Servicio Web de Integración de TFHKA.

PASO 4: Enviar el Documento Electrónico construído en el paso anterior al Servicio Web de Integración de TFHKA, utilizando los Tokens de Empresa y Password indicados en este documento.

(el Servicio Web procesará su solicitud según las especificaciones de la DGI y retornará de inmediato los resultados).

PASO 5: Recibir y procesar la respuesta del Servicio Web de Integración de TFHKA.

IMPORTANTE: El Documento procesado será almacenado en la NUBE para que pueda ser consultado en cualquier momento según sea requerido.

Para mayor información y detalles sobre el proceso, puede consultar el Manual de Integración de TFHKA

Incluir lo siguiente:

using System;
using EjemploIntegraciondirectaCSharp.TfhkaPaWebService;


namespace EjemploIntegraciondirectaCSharp
{
    class DemoIntCSharpTfhka
    {

• En el Explorador de Soluciones de VisualStudio, haga click con el botón derecho del mouse sobre el nombre de su Proyecto.

• Seleccione la opción “Agregar → Referencia de servicio… ”.

• En la ventana desplegada, ingrese la siguiente URL en el campo 'Dirección:'.

URL del Servicio Web de Integración de TFHKA: http://demoemision.thefactoryhka.com.pa/ws/obj/v1.0/Service.svc

• Haga click sobre el botón “Ir” y espere a que descargue la información del Servicio Web

• Coloque la siguiente identificación en el campo “Espacio de nombres:”.

Identificación de la Referencia: “TfhkaPaWebService”

(Dicho nombre es referencial, pero no obligatorio. El nombre de identificación utilizado debe ser incluido en la sección de Usos de este archivo)

IMPORTANTE: Para que el ejemplo funcione correctamente es necesario agregar la Referencia Web a través de la opción “Agregar Referencia de servicio…”, lo cual generará el archivo “Reference.cs” donde se crearán las clases y objetos requeridos por el 'Data Contract' del SOAP Service.

TOKENS requeridos por el Servicio Web de Integración de TFHKA para enviar documentos electrónicos, así como para utilizar otros métodos disponibles

public const string tokenEmpresa = ""; /// Token empresa suministrado por el personal de soporte de TFHKA
            public const string tokenPassword = ""; /// Token empresa suministrado por el personal de soporte de TFHKA
        static void Main(string[] args)
        {
            try
            {

A traves de esta instancia tendremos acceso a los métodos públicos disponibles

(En este ejemplo, sólo utilizaremos el método 'Enviar'; puede observar todos los métodos disponibles a través del Examinador de objetos de VisualStudio)

ServiceClient webService = new ServiceClient();
                

                Consola.mensaje("\r\n - EJEMPLO DE INTEGRACIÓN DIRECTA C# TFHKA - \r\n", 1, 0, 0);
                String numero = "";
                while (numero == "")
                {
                    Consola.mensaje("  Introduzca el Número de Documento Electrónico a enviar:\r\n", 0, 2, 0);
                    numero = Console.ReadLine();        
                }

Para mayor información y detalles sobre el proceso, puede consultar el Manual de Integración de TFHKA

En este ejemplo utilizaremos Clases, Atributos y Métodos creados con la finalidad de organizar mejor la estructura del archivo y del cuerpo de código fuente en general.

Sin embargo, esta estructura no es obligatoria. El desarrollador puede utilizar su propio estilo, siempre y cuando logre acceder y establecer los valores requeridos para los diferentes objetos que sub-componen al objeto DocumentoElectrónico.

DocumentoElectronico documento = Factura.armarFactura(numero);

Se requiere crear un objeto de tipo EnviarResponse en el cual será utilizado para almacenar la respuesta del Servicio Web

Se utiliza el método Enviar provisto por el Servicio Web, incluyendo como parámetros los tokens de empresa y password referidos anteriormente, así como el documento construido en paso 2

EnviarResponse respuestaWebService = new EnviarResponse();

Consola.mensaje("\r\n  Enviando el Documento...", 2, 0, 0);

respuestaWebService = webService.Enviar(tokenEmpresa, tokenPassword, documento);

La respuesta del Servicio Web de TFHKA será enviada inmediatamente.

En este ejemplo, la respuesta del Servicio Web se muestra a través de la consola.

En caso de recibir una respuesta positiva para el envío del Documento Electrónico (código 200), los detalles serán mostrados a través de la página de Consulta de Facturas por Qr en su navegador de Internet.

La respuesta del Servicio Web de TFHKA incluye: código de la respuesta, resultado, mensaje, cufe y Qr, entre otros. (ver el Examinador de Objetos de VisualStudio)

Consola.mensaje("\r\n  RESPUESTA: " + respuestaWebService.codigo + ". " + respuestaWebService.resultado + ". " + respuestaWebService.mensaje, 0, 0, 0);

                if (respuestaWebService.codigo == "200")
                {
                    Consola.mensaje("\r\n  Ahora, podrá observar el documento enviado en su navegador de internet.\r\n  Presione cualquier tecla para mostrar la Consulta de Facturas por Qr y Finalizar.", 3, 0, 1);

                    System.Diagnostics.Process.Start(respuestaWebService.qr);
                }
                else {
                    Consola.mensaje("\r\n  Presione cualquier tecla para Finalizar...", 0, 0, 1);
                }

            }
            catch (Exception ex)
            {
                Consola.mensaje("\r\n   Se ha producido un error..." + "\r\n " + ex.Message + "\r\n  Presione cualquier tecla para Finalizar...", 0,0,1);                
            }

        }
    }