Factura Electrónica Costa Rica

Ejemplo desarrollado en VB.NET y C# para la Factura Electrónica de Costa Rica.

Este proyecto realiza la firma del documento XML, solicita el Token y envía los datos a los servidores del Ministerio de Hacienda.

En la carpeta COMPONENTES estan los dlls necesarios para realizar la firma electrónica XadesEpes en .NET.

FirmaXadesNet es una librería desarrollada en C# para la generación de firmas XAdES realizada por el Dpto. de Nuevas Tecnologías de la Concejalía de Urbanismo del Ayuntamiento de Cartagena en España, la cual está basada en una modificación del XAdES starter kit desarrollado por Microsoft Francia.

La solución de ejemplo para la implementacion de la firma XAdES-EPES en Costa Rica la realizó Roy Rojas (royrojas@dotnetcr.com), en el ejemplo original se agregaban unos nodos de emisor que no son necesarios y el DataFormat cuando se compila para Framework 4.5 daba error al ejecutarlo. La comunicación con el API se trabajó en colaboración con Cristhian Sancho.

Estructura

En la solución están dos proyectos FacturaElectrónica_CS y FacturaElectronica_VB, una para CSharp y otra para Visual Basic .NET. Ambas soluciones hacen lo mismo.

En la carpeta 'Clases' está toda la funcionalidad de la aplicación, y son las que deberías de copiar a tu solución.

• ClasesJson: Contiene las estructuras de los datos que se envían y reciben por parte del API de Hacienda. Tiene 5 clases, Recepcion, Emisor, Receptor, Token y RespuestaHacienda.
• Comunicacion: Contiene el procedimieto para el envío de los datos al API de Hacienda y el procedimiento para consultar el estado de una factura por la clave.
• Firma: Contiene las funciones necesarias para la firma del documento electrónico. Utiliza los dlls BouncyCastle.dll, Microsoft.Xades.dll y FirmaXadesNet.dll, que se encuentra en la carpeta COMPONENTES.
• Funciones: Esta clase contiene unas funciones básicas para convertir de string a Base64 y de Base64 a string, necesario para enviar y recibir los datos en los JSON con el API de Hacienda.
• TokenHacienda: Esta clase se comunica con el API proporcionado por Hacienda para generar el Token necesario para poder entablar la comunicación con el API de facturación y poder enviar y recibir información.

Funcionamiento del ejemplo

En la pantalla se muestran varios campos distribuidos en varios tabs. XML Sin Firmar, XML Firmado, Token Hacienda, JSON Envio, JSON Respuesta, XML Respuesta Hacienda.

Debes ingresar unicamente el XML Sin Firmar, el programa se encarga de leerlo y llenar los datos en la parte inferior como consecutivo, clave, datos de emisor y receptor.

Al lado derecho se debe indicar la ruta donde se guardarán los archivos, paso a paso. También debe indicar con cual certificado se va a firmar el xml. Este certificado debe de estar instalado en el repositorio del usuario en la computadora. Los campos de Usuario y Clave son los proporcionados por Hacienda en el ATV.

Firma XAdES-EPES

Puede descargar los fuentes originales del dll para la Firma en el sitio web y GIT del Dpto. de Nuevas Tecnologías de la Concejalía de Urbanismo del Ayuntamiento de Cartagena en España.

• https://github.com/ctt-gob-es/FirmaXadesNet45
• https://administracionelectronica.gob.es/ctt/firmaxadesnet

Ejemplo de Firma XAdES-EPES

VB.NET

  Dim xadesService As XadesService = New XadesService
  Dim parametros As SignatureParameters = New SignatureParameters

  parametros.SignaturePolicyInfo = New SignaturePolicyInfo()

  parametros.SignaturePolicyInfo.PolicyIdentifier = 
  "https://tribunet.hacienda.go.cr/docs/esquemas/2016/v4.1/Resolucion_Comprobantes_Electronicos_DGT-R-48-2016.pdf"
  ''La propiedad PolicyHash es la misma para todos, es un cálculo en base al archivo pdf indicado en PolicyIdentifier
  parametros.SignaturePolicyInfo.PolicyHash = "Ohixl6upD6av8N7pEvDABhEL6hM="
  parametros.SignaturePackaging = SignaturePackaging.ENVELOPED
  parametros.DataFormat = New DataFormat()

  parametros.Signer = New FirmaXadesNet.Crypto.Signer(cert)
  Dim fs As FileStream = New FileStream(pathXMLSinFirma, FileMode.Open)

  Dim docFirmado As FirmaXadesNet.Signature.SignatureDocument = xadesService.Sign(fs, parametros)
  docFirmado.Save(pathXMLFirmado)

C#.NET

  XadesService xadesService = new XadesService();
  SignatureParameters parametros = new SignatureParameters();
  parametros.SignaturePolicyInfo = new SignaturePolicyInfo();
  parametros.SignaturePolicyInfo.PolicyIdentifier = 
  "https://tribunet.hacienda.go.cr/docs/esquemas/2016/v4.1/Resolucion_Comprobantes_Electronicos_DGT-R-48-2016.pdf";
  parametros.SignaturePolicyInfo.PolicyHash = "Ohixl6upD6av8N7pEvDABhEL6hM=";
  parametros.SignaturePackaging = SignaturePackaging.ENVELOPED;
  parametros.DataFormat = new DataFormat();
  parametros.Signer = new FirmaXadesNet.Crypto.Signer(cert);
  FileStream fs = new FileStream((pathXMLSinFirma), FileMode.Open);
  FirmaXadesNet.Signature.SignatureDocument docFirmado = xadesService.Sign(fs, parametros);
  docFirmado.Save((pathXMLFirmado));

Artículos Facturación Electrónica

Artículos: http://www.royrojas.com/tag/factura-electronica-costa-rica/
Ejemplos: http://www.royrojas.com/ejemplos-de-documentos-electronicos-4-3/
Estructura Clavce: http://www.royrojas.com/numero-consecutivo-y-clave-en-la-factura-electronica-en-costa-rica/
Encabezado XML 4.3: http://www.royrojas.com/encabezados-del-xml-para-los-documentos-de-factura-electronica-costa-rica-4-3/

Contacto

Roy Rojas | royrojas@dotnetcr.com | www.royrojas.com | www.dotnetcr.com | www.royrojas.dev |