Datos de prueba
Fiscalapi ofrece datos de prueba para que puedas integrar la API, con estos datos puedes activar una suscripción, comprar timbres y facturar en el ambiente de pruebas.
Tarjetas de prueba
Tarjetas de crédito y débito de prueba para facilitar el proceso de simulación de pagos en el ambiente de pruebas, utilizadas para activar una suscripción y comprar timbres.
Tip: Todos los pagos deben ser realizados desde el dashboard debido a las normas de seguridad PCI DSS.
Marca | Número de Tarjeta | CVC | Fecha de Expiración |
---|---|---|---|
Visa | 4242 4242 4242 4242 | 3 dígitos al azar | Cualquier fecha futura |
Visa (débito) | 4000 0566 5566 5556 | 3 dígitos al azar | Cualquier fecha futura |
Mastercard | 5555 5555 5555 4444 | 3 dígitos al azar | Cualquier fecha futura |
Mastercard (serie 2) | 2223 0031 2200 3222 | 3 dígitos al azar | Cualquier fecha futura |
Mastercard (débito) | 5200 8282 8282 8210 | 3 dígitos al azar | Cualquier fecha futura |
Mastercard (prepaga) | 5105 1051 0510 5100 | 3 dígitos al azar | Cualquier fecha futura |
Personas de prueba
Personas de prueba para facilitar el proceso de facturación en el ambiente de pruebas. El SAT obliga a utilizar estas personas, sus datos fiscales y sus certificados para realizar pruebas de facturación. Utilice cualquier regimen fiscal y uso de CFDI compatible para las personas de prueba.
Tip: Tambien puedes utilizar tus datos fiscales y certificados reales, pero nunca datos inventados.
Personas Físicas
RFC | SCNF | VALIDEZ OBLIGACIONES | NOMBRE | CÓDIGO POSTAL | RETENCIÓN |
---|---|---|---|---|---|
CACX7605101P8 | No | 2 | XOCHILT CASAS CHAVEZ | 36257 | 0 |
FUNK671228PH6 | No | 1 | KARLA FUENTE NOLASCO | 01160 | 0 |
IAÑL750210963 | No | 1 | LUIS IAN ÑUZCO | 85256 | 0 |
JUFA7608212V6 | No | 1 | ADRIANA JUAREZ FERNANDEZ | 01160 | 0 |
KAHO641101B39 | No | 1 | OSCAR KALA HAAK | 76074 | 2 |
KICR630120NX3 | No | 1 | RODRIGO KITIA CASTRO | 36246 | 1 |
MISC491214B86 | No | 1 | CECILIA MIRANDA SANCHEZ | 01010 | 0 |
RAQÑ7701212M3 | No | 1 | ÑEVES RAMIREZ QUEZADA | 78905 | 0 |
WATM640917J45 | No | 1 | MARIA WATEMBER TORRES | 43543 | 0 |
WERX631016S30 | No | 1 | XAIME WEIR ROJO | 01279 | 0 |
XAMA620210DQ5 | No | 1 | ALBA XKARAJAM MENDEZ | 01219 | 0 |
XIQB891116QE4 | No | 4 | BERENICE XIMO QUEZADA | 40968 | 0 |
XOJI740919U48 | No | 1 | INGRID XODAR JIMENEZ | 76028 | 0 |
Personas Morales
RFC | SCNF | VALIDEZ OBLIGACIONES | NOMBRE | CÓDIGO POSTAL | RETENCIÓN |
---|---|---|---|---|---|
EKU9003173C9 | No | 1 | ESCUELA KEMPER URGATE | 42501 | 0 |
IIA040805DZ4 | No | 1 | INDISTRIA ILUMINADORA DE ALMACENES | 62661 | 0 |
H&E951128469 | No | 1 | HERRERIA & ELECTRICOS | 06002 | 0 |
IVD920810GU2 | No | 1 | INNOVACION VALOR Y DESARROLLO | 63901 | 0 |
IXS7607092R5 | No | 1 | INTERNACIONAL XIMBO Y SABORES | 23004 | 0 |
JES900109Q90 | No | 1 | JIMENEZ ESTRADA SALAS | 37161 | 0 |
KIJ0906199R1 | No | 1 | KERNEL INDUSTIA JUGUETERA | 28971 | 0 |
L&O950913MSA | No | 1 | LUCES & OBRAS | 60922 | 0 |
OÑO120726RX3 | Si | 1 | ORGANICOS ÑAVEZ OSORIO | 40501 | 0 |
S&S051221SE2 | No | 1 | S & SOFTWARE | 76022 | 0 |
URE180429TM6 | No | 1 | UNIVERSIDAD ROBOTICA ESPAÑOLA | 86991 | 0 |
XIA190128J61 | No | 1 | XENON INDUSTRIAL ARTICLES | 76343 | 0 |
ZUÑ920208KL4 | No | 1 | ZAPATERIA URTADO ÑERI | 34541 | 0 |
Certificados de prueba
Para facturar en el ambiente de pruebas, cada persona de prueba cuenta con un certificado de sello digital (CSD).
Este consiste en dos archivos: un certificado .cer
y una llave privada .key
que se utiliza para sellar las facturas.
Es indispensable utilizar el par correcto para cada persona. Utilice la contraseña 12345678a
para cualquier llave privada.
Estructura de directorios
Al descomprimir la carpeta de certificados encontrarás la siguiente estructura:
Certificados_Pruebas/
├── Personas Físicas/
│ ├── RFC_PERSONA1_TIMESTAMP/
│ │ └── CSD_RFC_PERSONA1_TIMESTAMP/
│ │ ├── archivo.cer
│ │ ├── archivo.key
│ │ └── contraseña.txt
│ └── ...
└── Personas Morales/
├── RFC_EMPRESA1_TIMESTAMP/
│ └── CSD_RFC_EMPRESA1_TIMESTAMP/
│ ├── archivo.cer
│ ├── archivo.key
│ └── contraseña.txt
└── ...
- Personas Físicas: Carpeta que contiene subcarpetas para cada persona física, identificadas por su RFC.
- Personas Morales: Carpeta que contiene subcarpetas para cada persona moral, identificadas por su RFC.
- Dentro de cada subcarpeta se encuentra otra carpeta llamada
CSD_<RFC>_...
con los archivos.cer
y.key
correspondientes, estos archivos son los que debes subir o enviar en las peticiones http para facturar en el ambiente de pruebas.
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.
Tip: Todos los lenguajes soportan la codificación en base64.
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, es probable en en el futuro
necesites decodificarlo y obtener su representación original, es decir,
obtener el archivo .cer
, .key
, .xml
, .pdf
, etc.
Tip: Todos los lenguajes soportan la decodificación de base64.
Decodificación de archivos codificados en 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 archivos codificados en 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.");
}
}