Arquitectura para autorización masiva de comprobantes SRI con Webhooks y Redis

El desafío de emitir más de 10,000 facturas por hora

Empresas de telecomunicaciones, colegios, servicios de streaming y distribuidores mayoristas necesitan emitir miles de comprobantes tributarios en lapsos muy estrechos de tiempo. Intentar hacerlo con peticiones secuenciales bloqueantes es inviable: 10,000 comprobantes a un promedio de 2 segundos por llamada SOAP tardarían más de 5 horas y colapsarían el servidor web.

La solución: Ingesta Batch + Webhooks de Retorno

Con la API de Invoka, tu sistema puede disparar ráfagas de comprobantes en paralelo. Cada petición recibe un tracking_id inmediato y se procesa en el clúster de Invoka. Al completarse cada autorización ante el SRI, Invoka realiza una llamada HTTP POST a tu Webhook con firma criptográfica X-Invoka-Signature para garantizar la autenticidad.

Ejemplo de Consumo del Webhook en Laravel

Route::post('/webhooks/invoka', function (Request $request) {
    $firma = $request->header('X-Invoka-Signature');
    $payload = $request->getContent();
    
    // Verificar HMAC-SHA256 con tu secreto configurado
    if (!hash_equals($firma, hash_hmac('sha256', $payload, config('services.invoka.webhook_secret')))) {
        return response()->json(['error' => 'Firma inválida'], 403);
    }

    $data = $request->json()->all();
    if ($data['estado'] === 'AUTORIZADO') {
        // Actualizar base de datos local y enviar email al cliente
        Factura::where('clave_acceso', $data['clave_acceso'])->update([
            'autorizada' => true,
            'fecha_autorizacion' => $data['fecha_autorizacion'],
            'pdf_url' => $data['pdf'],
            'xml_url' => $data['xml'],
        ]);
    }

    return response()->json(['status' => 'recibido'], 200);
});