Pasar a producción

Checklist previo

• Completaste el flujo en sandbox (Primeros pasos)
• Certificado digital P12 cargado y vigente en el panel
• Timbrado activo para el tipo de documento que vas a emitir
• RUC habilitado para e-Kuatia (integración API)
• Webhook registrado para factura.approved y factura.rejected
• API Key de producción (dk_live_) guardada en variables de entorno del servidor

Sandbox vs producción

Mismo request, distinto ambiente

El body es idéntico. Solo cambian la key y los headers:

curl https://api.difact.co/v1/facturas \
  -X POST \
  -H "Authorization: Bearer $DIFACT_LIVE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "tipo_documento": 1,
  "receptor": {
    "ruc": "80012345-6",
    "razon_social": "Empresa Ejemplo SRL",
    "email": "pagos@empresa.com"
  },
  "items": [
    {
      "descripcion": "Servicio mensual",
      "cantidad": 1,
      "precio_unitario": 500000,
      "iva": 10
    }
  ]
}'

Qué cambia en el flujo

1. 1Crear factura

   La respuesta inicial suele ser pending o sent. No esperes approved en el mismo request.

2. 2Esperar webhook o consultar estado

   Usá webhooks en lugar de polling agresivo. Consultá con GET /v1/facturas/:id si necesitás reconciliar.

3. 3Entregar KuDE al cliente

   Solo cuando status sea approved, descargá el PDF con GET /v1/facturas/:id/kude.

Errores frecuentes al pasar a prod

Si algo falla, revisá la guía de Errores comunes. Los más habituales:INVALID_TIMBRADO, INVALID_RUC y certificado vencido.