Inicio Rápido

Pasa de cero a tu primera factura de prueba en menos de 5 minutos.

1. Obtén tus llaves de API

Regístrate en app.facturacion.srs-ngr.com y copia tu llave de prueba:

sk_test_4eC39HqLyjWDarjtT1zdp7dc

Las llaves de prueba usan el sandbox del PAC — no se crean facturas reales.

2. Crea una organización

Cada factura necesita una organización emisora (emisor). Crea una con tu RFC:

curl https://api.facturacion.srs-ngr.com/v1/organizaciones \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -H "Content-Type: application/json" \
  -d '{
    "rfc": "EKU9003173C9",
    "nombre": "ESCUELA KEMPER URGATE",
    "regimen_fiscal": "601",
    "codigo_postal": "06600"
  }'

3. Sube tu CSD

Sube tu Certificado de Sello Digital (.cer + .key). Puedes descargar los certificados de prueba del SAT para el RFC EKU9003173C9:

curl https://api.facturacion.srs-ngr.com/v1/certificados \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -F "organizacion=EKU9003173C9" \
  -F "cer=@CSD_Sucursal_1_EKU9003173C9_20230517_223850.cer" \
  -F "llave=@CSD_Sucursal_1_EKU9003173C9_20230517_223850.key" \
  -F "contrasena=12345678a"

4. Crea un cliente

curl https://api.facturacion.srs-ngr.com/v1/clientes \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -H "Content-Type: application/json" \
  -d '{
    "organizacion": "EKU9003173C9",
    "rfc": "XAXX010101000",
    "nombre": "PUBLICO EN GENERAL",
    "regimen_fiscal": "616",
    "domicilio_fiscal": "06600",
    "uso_cfdi": "S01"
  }'

5. Crea un producto

curl https://api.facturacion.srs-ngr.com/v1/productos \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -H "Content-Type: application/json" \
  -d '{
    "organizacion": "EKU9003173C9",
    "descripcion": "Servicio de consultoría",
    "valor_unitario": "1000.00",
    "clave_prod_serv": "80101500",
    "clave_unidad": "E48",
    "unidad": "Servicio",
    "no_identificacion": "CONSUL-001",
    "objeto_imp": "02",
    "impuestos_default": {
      "traslados": [
        {"impuesto": "002", "tipo_factor": "Tasa", "tasa_o_cuota": "0.160000"}
      ]
    }
  }'

6. Crea y timbra una factura

curl https://api.facturacion.srs-ngr.com/v1/facturas \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -H "Content-Type: application/json" \
  -d '{
    "organizacion": "EKU9003173C9",
    "tipo": "ingreso",
    "cliente": "XAXX010101000",
    "forma_pago": "03",
    "metodo_pago": "PUE",
    "conceptos": [
      {
        "producto": "CONSUL-001",
        "cantidad": 2
      }
    ]
  }'

La respuesta incluye el id de la factura. Usa ese ID para descargar los archivos.

7. Descarga el PDF y el XML

# Descargar PDF
curl https://api.facturacion.srs-ngr.com/v1/facturas/{id}/pdf \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -o factura.pdf

# Descargar XML
curl https://api.facturacion.srs-ngr.com/v1/facturas/{id}/xml \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -o factura.xml

Reemplaza {id} con el ID de la factura que recibiste en el paso anterior.

Eso es todo — sin UUIDs para crear, y tus archivos fiscales listos para descargar.

Siguientes pasos

Autenticación — Aprende sobre el modo de prueba vs. el modo en vivo
Facturas — Ciclo de vida completo de una factura (crear, timbrar, cancelar)
Referencia de API — Referencia completa de endpoints

Autenticación