Probar la factura electrónica sin certificado: el emisor de pruebas

Respuesta corta: si todavía no tenés el certificado (.p12) de pruebas de Hacienda, igual podés probar. Toda cuenta de Facturaencr trae habilitado un emisor de pruebas de la plataforma, con el identificador EMISORPRUEBA. Lo ponés en emisorLegalId y emitís contra el sandbox real de Hacienda, sin subir ni configurar nada. Recibís clave, consecutivo y el veredicto de Hacienda (aceptado o rechazado), igual que con un emisor propio.

Conseguir la llave criptográfica de pruebas y las credenciales del ambiente de pruebas toma días. Para un desarrollador que está armando la integración, o para alguien que solo quiere ver cómo funciona antes de pedir su certificado, esa espera frena todo. El emisor de pruebas existe para eso: empezás hoy y, cuando tengas tu certificado, cambiás una sola línea.

Para quién es

• Desarrolladores que están integrando un ERP, un punto de venta o una tienda y todavía no tienen la llave de pruebas de su cliente.
• Quien quiere probar antes de decidir: ver un comprobante aceptado por Hacienda, revisar el PDF y entender el flujo sin trámites.
• Equipos que hacen pruebas automáticas y necesitan un emisor de sandbox siempre disponible.

No sirve para facturar de verdad: solo funciona en sandbox, que es el ambiente de pruebas de Hacienda y no tiene valor fiscal. Para producción siempre hace falta tu propio certificado. Si querés entender qué es el sandbox y qué no valida, mirá sandbox de Hacienda.

Cómo se usa

No hay nada que pedir: ya está habilitado en tu cuenta. Aparece en GET /certificates junto a tus emisores, marcado con "shared": true, y en el portal lo ves en la lista de Emisores como emisor de pruebas. Para emitir, ponés su identificador en emisorLegalId:

curl -X POST https://api.facturaencr.com/v2/efactura/documents/tiquete \
  -H "X-API-Key: $EFACTURA_KEY" -H "X-API-Secret: $EFACTURA_SECRET" \
  -H "Idempotency-Key: $(uuidgen)" -H "Content-Type: application/json" \
  -d '{ "emisorLegalId": "EMISORPRUEBA", "condicionVenta": "01",
        "medioPago": ["01"], "detalle": [ … ] }'

EMISORPRUEBA no es una cédula: es el nombre con el que la plataforma publica este emisor. Por dentro se traduce al certificado y se firma con la identidad real. Todo lo demás del cuerpo (líneas, impuestos, receptor, medios de pago) funciona igual que con un emisor tuyo.

La respuesta es un 202 con la clave y el consecutivo, y a los pocos segundos llega el veredicto real de Hacienda: accepted o rejected con su motivo. No es un simulador: es una emisión de verdad contra el sandbox. Lo que pasa acá es lo que va a pasar en producción con los mismos datos.

Qué cambia respecto a tu propio certificado

	Emisor de pruebas	Tu certificado
Ambiente	Solo sandbox	Sandbox y producción
Sucursal, terminal y consecutivo	Los asigna la plataforma	Los elegís vos
Descargar el XML firmado y la respuesta	No	Sí
PDF	Sí, con la identidad del emisor tapada	Completo
Datos del emisor	«Emisor de pruebas»	Los tuyos
codigoActividad	Se ignora: usa la del emisor	La que elijas

La numeración es automática

Todas las cuentas comparten la misma cédula de pruebas, así que cada una recibe su propia sucursal y terminal dentro de ese emisor. Así dos integradores nunca generan el mismo consecutivo. Si mandás branchCode, terminalCode, consecutivoNumero, codigoSeguridad o claveIntegrador, la API responde 400 shared_cert_numbering_is_automatic. Se rechaza a propósito, en vez de ignorarlo, para que no creas que se aplicó.

El XML firmado no se descarga

El XML lleva una firma digital real de la cédula de la plataforma sobre contenido que escribiste vos, por eso no se entrega: la descarga responde 403 shared_test_emisor_no_download. El estado del documento, la respuesta de Hacienda y el PDF sí los tenés.

La identidad del emisor va tapada

En el PDF la razón social sale como «PRUEBA» y la cédula como «Cert de prueba», y no se imprimen la ubicación ni la actividad económica. Tus líneas, impuestos y totales se ven completos. Lo único que no se puede tapar es la clave de 50 dígitos, que por formato de Hacienda lleva la cédula del emisor adentro, y sin ella no podrías consultar tu comprobante.

Cuando tengas tu certificado

Tu certificado siempre manda. Cuando subís el tuyo, la API lo usa y el emisor de pruebas deja de importar: cambiás emisorLegalId por tu cédula y listo. Desde ese momento podés descargar el XML, elegir tu numeración y, con el certificado de producción, emitir comprobantes con valor fiscal. Para conseguirlo, seguí la guía de la llave criptográfica de pruebas y, para producción, la de la llave de producción en TRIBU-CR.

Un consejo práctico: guardá el identificador del emisor en una variable de configuración, no escrito en el código. Así pasar de EMISORPRUEBA a la cédula real es cambiar un valor, no desplegar de nuevo.

Preguntas frecuentes

¿Tengo que pedir que me lo activen?

No. Ya viene habilitado en todas las cuentas. Si alguna cuenta lo usa de forma abusiva, se le puede desactivar puntualmente.

¿Los comprobantes tienen valor fiscal?

No. Se emiten en el sandbox de Hacienda, que es solo para pruebas. Para facturar de verdad necesitás tu propio certificado de producción.

¿Puedo probar notas de crédito y otros comprobantes?

Sí. El cuerpo de cada tipo de comprobante funciona igual que con un emisor propio; lo único distinto es lo de la tabla de arriba.

¿Por qué me da error al mandar mi propio consecutivo?

Porque en el emisor compartido la numeración la asigna la plataforma, para que dos cuentas no choquen. Quitá branchCode, terminalCode, consecutivoNumero, codigoSeguridad y claveIntegrador del cuerpo.

¿Querés probarlo ya? Creá tu cuenta: el sandbox de la API de Facturaencr es gratis, con 100 comprobantes al mes, y el emisor de pruebas viene listo. La referencia completa está en la documentación.