Diferencias

Muestra las diferencias entre dos versiones de la página.

--- lenguaje_c [2021/06/15 01:14]
jsojo [PASO 3: Construir el documento electrónico a enviar al servicio web de integración de TFHKA]
+++ lenguaje_c [2022/08/29 19:34] (actual)
lmartinez
@@ Línea 1: / Línea 1: @@
 ====== 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.  ///
+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 //EBI //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.
@@ Línea 7: / Línea 7: @@
 %%Criterios a tomar en cuenta:%%
-  * Establecer una referencia al Servicio Web de Integración de TFHKA
+  * Establecer una referencia al Servicio Web de Integración de EBI
-  * Instanciar el objeto a través del cual se tendrá acceso a los métodos del Servicio Web de TFHKA.
+  * Instanciar el objeto a través del cual se tendrá acceso a los métodos del Servicio Web de EBI.
-  * 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.
+  * Construir / Armar el objeto Documento Electrónico (Factura) que se desea enviar al Servicio Web de Integración de EBI, a través de los objetos respectivos.
-  * Enviar el documento al Servicio Web de Integración de TFHKA para su procesamiento.
+  * Enviar el documento al Servicio Web de Integración de EBIpara su procesamiento.
-  * Recibir y procesar la respuesta del Servicio Web de TFHKA en nuestro proyecto, según sea requerido.
+  * Recibir y procesar la respuesta del Servicio Web de EBIen 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 1: Agregar una nueva Referencia de Servicio en su proyecto, utilizando la URL del Servicio Web de Integración de EBIreferida en este documento.
-PASO 2: Crear una instancia del objeto 'ServiceCliente' del Servicio Wed de Integración de TFHKA, previamente referenciado.
+PASO 2: Crear una instancia del objeto 'ServiceCliente' del Servicio Wed de Integración de EBI, 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 3: Construir el Documento Electrónico a enviar, en base a los objetos provistos por el Servicio Web de Integración de EBI.
-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.
+PASO 4: Enviar el Documento Electrónico construído en  el  paso anterior al Servicio Web de Integración de EBI, 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.
+PASO 5: Recibir y procesar la respuesta del Servicio Web de Integración de EBI.
 **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**
+Para mayor información y detalles sobre el proceso, puede consultar el **Manual de Integración de EBI**
-===== PASO 1: Agregar referencia de servicio con la URL del servicio web de integración de TFHKA =====
+===== PASO 1: Agregar referencia de servicio con la URL del servicio web de integración de EBI =====
 Incluir lo siguiente:
@@ Línea 37: / Línea 37: @@
 <code ->
 using System;
+using EjemploIntegraciondirectaCSharp.EBIPaWebService;
-using EjemploIntegraciondirectaCSharp.TfhkaPaWebService;
 namespace EjemploIntegraciondirectaCSharp
-{
-class DemoIntCSharpTfhka
 {
+    class DemoIntCSharpEBI
+    {
 </code>
@@ Línea 55: / Línea 52: @@
   * 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]]
+URL del Servicio Web de Integración de EBI: [[https://demointegracion.ebi-pac.com/ws/obj/v1.0/Service.svc]]
   * Haga click sobre el botón "Ir" y  espere a que descargue la información del Servicio Web
@@ Línea 61: / Línea 58: @@
   * Coloque la siguiente identificación en el campo "Espacio de nombres:".
-Identificación de la Referencia: "TfhkaPaWebService"
+Identificación de la Referencia: "EBIPaWebService"
 (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)
@@ Línea 67: / Línea 64: @@
 **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
+TOKENS requeridos por el Servicio Web de Integración de EBI para enviar documentos electrónicos, así como para utilizar otros métodos disponibles
 <code ->
-public const string tokenEmpresa = ""; /// Token empresa suministrado por el personal de soporte de TFHKA
+public const string tokenEmpresa = ""; /// Token empresa suministrado por el personal de soporte de EBI
+            public const string tokenPassword = ""; /// Token empresa suministrado por el personal de soporte de EBI
+        static void Main(string[] args)
+        {
+            try
+            {
+</code>
-public const string tokenPassword = ""; /// Token empresa suministrado por el personal de soporte de TFHKA
+===== PASO 2: Crear una instancia del objeto 'ServiceClient' del servicio web de integración de EBI =====
-static void Main(string[] args)
+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)
-try
+<code ->
+ServiceClient webService = new ServiceClient();
-{
+                Consola.mensaje("\r\n - EJEMPLO DE INTEGRACIÓN DIRECTA C# EBI - \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();
+                }
 </code>
-===== PASO 2: Crear una instancia del objeto 'ServiceClient' del servicio web de integración de TFHKA =====
+===== PASO 3: Construir el documento electrónico a enviar al servicio web de integración de EBI =====
-A traves de esta instancia tendremos acceso a los métodos públicos disponibles
+%%Para mayor información y detalles sobre el proceso, puede consultar el %%**Manual de Integración de EBI **
-(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)
+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.
 <code ->
-ServiceClient webService = new ServiceClient();
+DocumentoElectronico documento = Factura.armarFactura(numero);
+</code>
-Consola.mensaje("\r\n - EJEMPLO DE INTEGRACIÓN DIRECTA C# TFHKA - \r\n", 1, 0, 0);
-String numero = "";
+===== PASO 4: Enviar el documento electrónico construido en el paso 3 al servicio web de integración de EBI =====
-while (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
-Consola.mensaje("  Introduzca el Número de Documento Electrónico a enviar:\r\n", 0, 2, 0);
+<code ->
+EnviarResponse respuestaWebService = new EnviarResponse();
-numero = Console.ReadLine();
+Consola.mensaje("\r\n  Enviando el Documento...", 2, 0, 0);
-}
+respuestaWebService = webService.Enviar(tokenEmpresa, tokenPassword, documento);
 </code>
-===== PASO 3: Construir el documento electrónico a enviar al servicio web de integración de TFHKA =====
+===== PASO 5: Recibir y procesar la respuesta del servicio web de integración de EBI =====
-%%Para mayor información y detalles sobre el proceso, puede consultar el %%**Manual de Integración de TFHKA**
+La respuesta del Servicio Web de EBI será enviada inmediatamente.
-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.
+En este ejemplo, la respuesta del Servicio Web se muestra a través de la consola.
-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.
+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 EBI incluye: código de la respuesta, resultado, mensaje, cufe y Qr, entre otros. (ver el Examinador de Objetos de VisualStudio)
 <code ->
-DocumentoElectronico documento = Factura.armarFactura(numero);
+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);
+            }
+        }
+    }
+</code>
+===== Clases para armar el documento electrónico y elementos componentes, en base a los objetos provistos por el servicio web =====
+La definición de estas clases no es obligatoria ni requerida, pero sirven para ordenar la estructura de este documento y mostrar paso a paso la incorporación de los diferentes objetos que componen el objeto Documento Electrónico.
+<code ->
+public class Factura
+    {
+        public static DocumentoElectronico factura = new DocumentoElectronico();
+        public static DocumentoElectronico armarFactura(string numero)
+        {
+            Consola.mensaje("\r\n  Armando el Documento Electrónico:", 3, 0, 0);
+            //DATOS REFERENCIALES CON FINES DE PRUEBA
+            //Consultar Manual de Integracion EBI para ver detalles precisos
+            factura.codigoSucursalEmisor = "0000";
+            factura.tipoSucursal = "1";
+            // Datos de la Transacción
+            DatosFactura datos = new DatosFactura();
+            datosTransaccion datosFactura = datos.crearDatosFactura(numero);
+            factura.datosTransaccion = datosFactura;
+            Consola.mensaje("\r\n  - Añadidos Datos de la Transacción...", 5, 0, 0);
+            // Datos de los Productos / Items
+            factura.listaItems = new listaItems();
+            factura.listaItems.Add(Producto.crearItem());
+            Consola.mensaje("\r\n  - Añadidos los Items / Productos...", 5, 0, 0);
+            // Datos de los Totales y Sub-Totales
+            factura.totalesSubTotales = Totales.generarTotales();
+            Consola.mensaje("\r\n  - Añadidos los Totales y Sub-Totales...", 5, 0, 0);
+            Consola.mensaje("\r\n  Documento Listo !!! ...", 4, 0, 0);
+            return factura;
+        }
+    }
+    public class Cliente
+    {
+        public static cliente cliente = new cliente();
+        public static cliente crearCliente()
+        {
+            //DATOS REFERENCIALES CON FINES DE PRUEBA
+            //Consultar Manual de Integracion EBI para ver detalles precisos
+            cliente.tipoClienteFE = "01";
+            cliente.tipoContribuyente = "2";
+            cliente.numeroRUC = "155596713-2-2015";
+            cliente.digitoVerificadorRUC = "59";
+            cliente.razonSocial = "FE general";
+            cliente.direccion = "Av. Balboa";
+            cliente.codigoUbicacion = "1-2-3";
+            cliente.corregimiento = "Guabito";
+            cliente.distrito = "Changuinola";
+            cliente.provincia = "Bocas del Toro";
+            cliente.telefono1 = "997-8243";
+            cliente.telefono2 = "";
+            cliente.telefono3 = "";
+            cliente.correoElectronico1 = "fep@gmail.com";
+            cliente.pais = "PA";
+            cliente.paisOtro = "";
+            return cliente;
+        }
+    }
+    public class DatosFactura
+    {
+        public static datosTransaccion datosFactura = new datosTransaccion();
+        public datosTransaccion crearDatosFactura(string num)
+        {
+            //DATOS REFERENCIALES CON FINES DE PRUEBA
+            //Consultar Manual de Integracion EBI para ver detalles precisos
+            datosFactura.tipoEmision = "01";
+            datosFactura.tipoDocumento = "01";
+            datosFactura.numeroDocumentoFiscal = num;
+            datosFactura.puntoFacturacionFiscal = "001";
+            //Debe establecerse el formato solicitado para la fecha de emisión "yyyy-MM-ddTHH:mm:ss-05:00"
+            var fechaEmision = Convert.ToDateTime(DateTime.Today.ToString("dd-MM-yyyy")).ToString("yyyy-MM-ddTHH:mm:ss-05:00");
+            datosFactura.fechaEmision = fechaEmision;
+            datosFactura.naturalezaOperacion = "01";
+            datosFactura.tipoOperacion = "1";
+            datosFactura.destinoOperacion = "1";
+            datosFactura.formatoCAFE = "1";
+            datosFactura.entregaCAFE = "1";
+            datosFactura.envioContenedor = "1";
+            datosFactura.procesoGeneracion = "1";
+            datosFactura.tipoVenta = "1";
+            datosFactura.informacionInteres = "Prueba de Información de interés";
+            //Datos del Cliente
+            datosFactura.cliente = Cliente.crearCliente();
+            Consola.mensaje("\r\n  - Añadidos Datos del Cliente...", 5, 0, 0);
+            return datosFactura;
+        }
+    }
+    public class Producto
+    {
+        public static Item item = new Item();
+        public static Item crearItem()
+        {
+            //DATOS REFERENCIALES CON FINES DE PRUEBA
+            //Consultar Manual de Integracion EBI para ver detalles precisos
+            item.descripcion = "Cuadernos";
+            item.codigo = "T";
+            item.unidadMedida = "und";
+            item.cantidad = "2.00";
+            item.fechaFabricacion = "2020-12-25";
+            item.unidadMedidaCPBS = "cm";
+            item.precioUnitario = "69.00";
+            item.precioUnitarioDescuento = "0.00";
+            item.precioAcarreo = "1.01";
+            item.precioSeguro = "12.01";
+            item.precioItem = "138.00";
+            item.valorTotal = "171.72";
+            item.codigoGTIN = "0";
+            item.cantGTINCom = "0.99";
+            item.codigoGTINInv = "0";
+            item.cantGTINComInv = "1.00";
+            item.tasaITBMS = "03";
+            item.valorITBMS = "20.70";
+            item.tasaISC = "0.00";
+            item.valorISC = "0.00";
+            item.codigoCPBS = "1410";
+            return item;
+        }
+    }
+    public class Totales
+    {
+        public static totalesSubTotales TotalesSubTotales = new totalesSubTotales();
+        public static totalesSubTotales generarTotales()
+        {
+            //DATOS REFERENCIALES CON FINES DE PRUEBA
+            //Consultar Manual de Integracion EBI para ver detalles precisos
+            TotalesSubTotales.totalPrecioNeto = "138.00";
+            TotalesSubTotales.totalITBMS = "20.70";
+            TotalesSubTotales.totalISC = "0.00";
+            TotalesSubTotales.totalMontoGravado = "20.70";
+            TotalesSubTotales.totalDescuento = "";
+            TotalesSubTotales.totalAcarreoCobrado = "";
+            TotalesSubTotales.valorSeguroCobrado = "";
+            TotalesSubTotales.totalFactura = "171.72";
+            TotalesSubTotales.totalValorRecibido = "171.72";
+            TotalesSubTotales.vuelto = "0.00";
+            TotalesSubTotales.tiempoPago = "1";
+            TotalesSubTotales.nroItems = "1";
+            TotalesSubTotales.totalTodosItems = "171.72";
+            TotalesSubTotales.listaFormaPago = new listaFormaPago();
+            FormaPago formaPago1 = new FormaPago();
+            formaPago1.formaPagoFact = "02";
+            formaPago1.valorCuotaPagada = "171.72";
+            formaPago1.descFormaPago = "";
+            TotalesSubTotales.listaFormaPago.Add(formaPago1);
+            return TotalesSubTotales;
+        }
+    }
+</code>
+===== Clase para mostrar los mensajes por consola =====
+<code ->
+    public class Consola
+    {
+        //CLASE SÓLO CON FINES ESTÉTICOS PARA LA PRESENTACIÓN DE MENSAJES AL USUARIO A TRAVÉS DE LA CONSOLA. NO OBLIGATORIA
+        public static void mensaje(string mensaje, int colorInicio, int colorFin = 0, int leer = 0)
+        {
+            //Se establece color de la línea actual
+            switch (colorInicio)
+            {
+                case 1:
+                    Console.ForegroundColor = ConsoleColor.Cyan;
+                    break;
+                case 2:
+                    Console.ForegroundColor = ConsoleColor.Yellow;
+                    break;
+                case 3:
+                    Console.ForegroundColor = ConsoleColor.Gray;
+                    break;
+                case 4:
+                    Console.ForegroundColor = ConsoleColor.Green;
+                    break;
+                case 5:
+                    Console.ForegroundColor = ConsoleColor.Blue;
+                    break;
+                case 6:
+                    Console.ForegroundColor = ConsoleColor.Red;
+                    break;
+                default:
+                    Console.ForegroundColor = ConsoleColor.White;
+                    break;
+            }
+            //Se muestra el Mensaje indicado
+            Console.WriteLine(mensaje);
+            //Se establece color de la línea siguiente
+            switch (colorFin)
+            {
+                case 1:
+                    Console.ForegroundColor = ConsoleColor.Cyan;
+                    break;
+                case 2:
+                    Console.ForegroundColor = ConsoleColor.Yellow;
+                    break;
+                case 3:
+                    Console.ForegroundColor = ConsoleColor.Gray;
+                    break;
+                case 4:
+                    Console.ForegroundColor = ConsoleColor.Green;
+                    break;
+                case 5:
+                    Console.ForegroundColor = ConsoleColor.Blue;
+                    break;
+                case 6:
+                    Console.ForegroundColor = ConsoleColor.Red;
+                    break;
+                default:
+                    Console.ForegroundColor = ConsoleColor.White;
+                    break;
+            }
+            if (leer == 1)
+            {
+                //Se espera por la pulsación de una tecla para continuar
+                Console.ReadKey();
+            }
+        }
+    }
+    #endregion
+}
 </code>

Herramientas

menues y búsqueda rápida

búsqueda rápida

estado del sitio

Herramientas de la página

meta data de esta página

Diferencias