Certificados de Prueba

FiscalAPI pone a tu disposición los Certificados de Sello Digital (CSD) de prueba vigentes para realizar pruebas en el ambiente de integración. Estos certificados, emitidos por la autoridad tributaria (SAT), permiten simular procesos de facturación sin efectos fiscales reales.

Introducción

En México, el sistema fiscal electrónico se sustenta en dos credenciales: la Firma Electrónica Avanzada (FIEL) y el Certificado de Sello Digital (CSD). Aunque ambas son emitidas por el Servicio de Administración Tributaria (SAT) y tienen elementos en común, cumplen funciones diferentes y no deben confundirse.

El Certificado de Sello Digital (CSD) es esencial para la emisión de Comprobantes Fiscales Digitales por Internet (CFDI), comúnmente conocidos como facturas electrónicas. Este certificado garantiza la seguridad, autenticidad y validez de los CFDI mediante la firma digital de los documentos.

Por su parte, la FIEL se utiliza para identificar y autenticar legalmente a los contribuyentes en diversos trámites ante el SAT y otras entidades, pero no tiene la función de firmar facturas electrónicas. Ambos instrumentos son fundamentales, pero su uso es específico y debe comprenderse claramente para cumplir con las obligaciones fiscales.

Un Certificado de Sello Digital es un documento electrónico mediante el cual el Servicio de Administración Tributaria (SAT) garantiza la vinculación entre la identidad de un contribuyente y su clave pública. Su fundamento legal se encuentra en el artículo 17-G del Código Fiscal de la Federación.

Componentes de las credenciales fiscales

Ya sea la FIEL o los certificados de sello digital (CSD), ambos están compuestos por tres elementos:

  • Archivo .cer: Llave pública.
  • Archivo .key: Llave privada.
  • Contraseña de la llave privada.

Diferencias entre un CSD y la FIEL

Aunque el CSD y la FIEL están relacionados, son diferentes y tienen propósitos distintos:

CaracterísticaCSDFIEL
PropósitoFirmar facturas electrónicas (CFDI)Avalar identidad en trámites
RequisitoRequiere FIEL para su tramitaciónNo requiere otro certificado
UsoExclusivo para facturaciónMúltiples trámites excepto facturación

Vigencia y Validez

Tanto la FIEL como los certificados de sello digital (CSD) tienen una vigencia de 4 años. Es importante renovarlos antes de su caducidad, ya que cualquier factura emitida con un certificado vencido carece de validez fiscal y puede ser motivo de sanciones por parte de la autoridad tributaria en México (SAT).


Certificados de Prueba

FiscalAPI pone a tu disposición los Certificados de Sello Digital (CSD) de prueba vigentes para realizar pruebas en el ambiente de integración. Estos certificados, emitidos por la autoridad tributaria (SAT), permiten simular procesos de facturación sin efectos fiscales reales.

  • Contraseña de los CSD de pruebas: 12345678a
  • Nota Importante: Al generar una factura, nunca incluyas el régimen de capital como parte de la razón social del emisor. Siempre utiliza únicamente la razón social del emisor sin el régimen de capital. Por ejemplo, si la razón social del emisor es "MI EMPRESA S.A. DE C.V.", utiliza únicamente "MI EMPRESA".

Validez de Obligaciones

CódigoDescripción
1Habilitado para facturar (IVA exento, tasa 0% y 16%)
2Habilitado para facturar (IVA exento, tasa 0%, 8% y 16%) Zona Fronteriza Norte
3Habilitado para facturar (IVA exento, tasa 0%, 8% y 16%) Zona Fronteriza Sur
4Habilitado para facturar (IVA exento, tasa 0%, 8% y 16%) Zona Fronteriza Norte y Sur

Personas Físicas

RFCSCNFVALIDEZ OBLIGACIONESNOMBRECÓDIGO POSTALRETENCIÓN
CACX7605101P8No2XOCHILT CASAS CHAVEZ362570
FUNK671228PH6No1KARLA FUENTE NOLASCO011600
IAÑL750210963No1LUIS IAN ÑUZCO852560
JUFA7608212V6No1ADRIANA JUAREZ FERNANDEZ011600
KAHO641101B39No1OSCAR KALA HAAK760742
KICR630120NX3No1RODRIGO KITIA CASTRO362461
MISC491214B86No1CECILIA MIRANDA SANCHEZ010100
RAQÑ7701212M3No1ÑEVES RAMIREZ QUEZADA789050
WATM640917J45No1MARIA WATEMBER TORRES435430
WERX631016S30No1XAIME WEIR ROJO012790
XAMA620210DQ5No1ALBA XKARAJAM MENDEZ012190
XIQB891116QE4No4BERENICE XIMO QUEZADA409680
XOJI740919U48No1INGRID XODAR JIMENEZ760280

Personas Morales

RFCSCNFVALIDEZ OBLIGACIONESNOMBRECÓDIGO POSTALRETENCIÓN
EKU9003173C9No1ESCUELA KEMPER URGATE425010
IIA040805DZ4No1INDISTRIA ILUMINADORA DE ALMACENES626610
H&E951128469No1HERRERIA & ELECTRICOS060020
IVD920810GU2No1INNOVACION VALOR Y DESARROLLO639010
IXS7607092R5No1INTERNACIONAL XIMBO Y SABORES230040
JES900109Q90No1JIMENEZ ESTRADA SALAS371610
KIJ0906199R1No1KERNEL INDUSTIA JUGUETERA289710
L&O950913MSANo1LUCES & OBRAS609220
OÑO120726RX3Si1ORGANICOS ÑAVEZ OSORIO405010
S&S051221SE2No1S & SOFTWARE760220
URE180429TM6No1UNIVERSIDAD ROBOTICA ESPAÑOLA869910
XIA190128J61No1XENON INDUSTRIAL ARTICLES763430
ZUÑ920208KL4No1ZAPATERIA URTADO ÑERI345410

Codificación de archivos en base64

Base64 es un esquema de codificación que convierte cualquier archivo en su representación en texto. Este método de codificación es una de las formas más sencillas de transferir archivos a través de internet.

Codificación de archivos CSD a base64

Cuando utilizas el modo de operación por valores en el recurso de facturas, uno de los campos de la petición es taxCredentials que representa los archivos CSD (.cer y .key) del emisor de la factura. Estos archivos se envían codificados en base64.

💡 Busca en google: "Codificar archivo a base64 en <lenguaje>"

Codificación de CSD a base64

using System;
using System.IO;

class Program
{
    static string EncodeFileToBase64(string filePath)
    {
        byte[] fileBytes = File.ReadAllBytes(filePath);
        return Convert.ToBase64String(fileBytes);
    }

    static void Main()
    {
        string cerFilePath = "ruta_del_archivo.cer";
        string keyFilePath = "ruta_del_archivo.key";

        // Codificar archivo .cer
        string cerBase64 = EncodeFileToBase64(cerFilePath);
        Console.WriteLine("Archivo .cer codificado en Base64: " + cerBase64);

        // Codificar archivo .key
        string keyBase64 = EncodeFileToBase64(keyFilePath);
        Console.WriteLine("Archivo .key codificado en Base64: " + keyBase64);
    }
}

Decodificación de base64 a archivos

Una vez codificado un archivo en base64, eventualmente deberás decodificarlo y obtener su representación original.

Decodificación de archivos CSD a base64

Cuando fiscalapi recibe una petición de facturación por valores lo que hacemos es aplicar la decodificación de los archivos CSD codificados en base64 para obtener los archivos originales.

Este mismo proceso lo puedes aplicar en tu lado para obtener los archivos originales de cualquier respuesta que te enviemos en base64, por ejemplo, un XML, un PDF, un Logo, etc.

💡 Busca en google: "Decodificar base64 a archivo original en <lenguaje>"

Decodificación de CSD a base64

using System;
using System.IO;

class Program
{
    // Decodifica una cadena Base64 a un archivo
    static void DecodeBase64ToFile(string fileBase64, string filePath)
    {
        byte[] fileBytes = Convert.FromBase64String(fileBase64);
        File.WriteAllBytes(filePath, fileBytes);
    }

    static void Main()
    {
        // Ejemplo: Decodificar una cadena Base64 a un archivo
        string xmlBase64 = "YXF1aV92YV9lbF9jb250ZW5pZG9fZGVfYmFzZTY0"; // Ejemplo de contenido Base64
        string pdfBase64 = "b3RyYV9jYWRlbmFfZGVfYmFzZTY0X2FxdWk="; // Ejemplo de contenido Base64
        string cerBase64 = "Y29udGVuaWRvX2RlbF9jZXJ0aWZpY2Fkb19lbl9iYXNlNjQ="; // Ejemplo de contenido Base64
        string keyBase64 = "Y29udGVuaWRvX2RlX2xhX2xsYXZlX3ByaXZhZGFfZW5fYmFzZTY0"; // Ejemplo de contenido Base64
        
        DecodeBase64ToFile(xmlBase64, "C:\\archivos\\factura.xml");
        DecodeBase64ToFile(pdfBase64, "C:\\archivos\\factura.pdf");
        DecodeBase64ToFile(cerBase64, "C:\\archivos\\certificado.cer");
        DecodeBase64ToFile(keyBase64, "C:\\archivos\\llave-privada.key");
        
        Console.WriteLine("Archivos decodificados y guardados.");
    }
}

¿Le resultó útil esta página?