Ambiente de pruebas (sandbox)

Antes de emitir un solo CFDI real, construye y prueba tu integración en el ambiente de pruebas de Facty:

https://sandbox.facty.mx

Es la misma aplicación y la misma API que producción, pero timbra contra el sandbox del PAC: los CFDI que emitas ahí no se envían al SAT, no tienen validez fiscal y no tienen ningún efecto ante tus clientes.

Cuenta y API keys

El sandbox es una base de datos distinta a la de producción:

• Crea tu cuenta y tu organización directamente en sandbox.facty.mx.
• Las API keys del sandbox solo funcionan en el sandbox, y las de producción solo en producción. Guarda una llave por ambiente (ver Autenticación y API keys).
• En tu integración, cambia solo el host:

export FACTY_HOST=https://sandbox.facty.mx   # pruebas
# export FACTY_HOST=https://facty.mx         # producción

CSD de prueba

Para timbrar, tu organización necesita un Certificado de Sello Digital (CSD). En el sandbox no uses tu CSD real: usa uno de los certificados de prueba que publica el SAT. Los tenemos todos en un solo archivo:

Descargar CSD de prueba (.zip)

Todas las llaves privadas (.key) usan la misma contraseña:

12345678a

Dentro del zip hay una carpeta por RFC, separadas en Personas Físicas y Personas Morales. Cada una contiene una subcarpeta CSD_<RFC>_… con el certificado (.cer) y la llave privada (.key). Algunos RFC traen más de una sucursal; cualquiera sirve.

Configura tu organización de pruebas

1. En sandbox.facty.mx, ve a Configuración → Datos fiscales.
2. Captura el RFC, nombre fiscal, régimen y código postal exactamente como aparecen en las tablas de abajo, en mayúsculas y sin régimen societario (sin "S.A. de C.V.").
3. Sube el .cer y el .key de ese mismo RFC con la contraseña 12345678a.

Si no sabes cuál elegir, usa el emisor de pruebas más común:

El receptor también tiene que existir

CFDI 4.0 valida al receptor contra el padrón del SAT, también en el sandbox: un RFC inventado o un nombre que no coincide hace que el CFDI se rechace. Para tus clientes de prueba usa otro RFC de las tablas, con su nombre, régimen y código postal exactos. Por ejemplo, con EKU9003173C9 como emisor:

{
  "rfc": "URE180429TM6",
  "legalName": "UNIVERSIDAD ROBOTICA ESPAÑOLA",
  "cp": "86991",
  "regimenFiscal": "603",
  "usoCfdiDefault": "G03"
}

XAXX010101000 (PUBLICO EN GENERAL) también funciona como receptor genérico.

RFC de prueba disponibles

Los nombres se escriben tal como los registró el SAT, incluidos sus errores ("INDISTRIA", "INDUSTIA", "URTADO"): la validación compara contra ese texto exacto. Cuando un RFC tiene más de un régimen, cualquiera de ellos es válido.

Personas físicas

Personas morales

Obligaciones (tasas de IVA)

La columna Obligaciones indica qué tasas de IVA puede facturar cada RFC:

Para probar IVA al 8% (estímulo fronterizo) usa CACX7605101P8 o XIQB891116QE4 como emisor.

Pasar a producción

Cuando tu integración funcione en el sandbox:

1. Crea tu cuenta en https://facty.mx y sube tu CSD real.
2. Genera una API key de producción.
3. Cambia FACTY_HOST a https://facty.mx y confirma que /context responde "stampingMode": "production" antes de emitir.

Desde ese momento cada CFDI es real: consume timbres y tiene efectos fiscales.