Cómo emitir una factura fiscal (CAFE)
Guía para configurar facturación fiscal en Droka, enviar facturas al PAC (HKA) y descargar el CAFE.
Resumen
Droka no es el PAC: cada organización conecta su propio proveedor fiscal (HKA, WebPOS o Alanube). Desde la lista de Facturas puede enviar una o varias facturas operativas al proveedor activo y obtener el CAFE (Comprobante Auxiliar de Factura Electrónica) cuando la DGI autoriza el documento.
El envío fiscal está disponible solo si un administrador de plataforma habilitó la función Facturación fiscal para su organización y usted completó la configuración en Ajustes → Facturación Fiscal.
Antes de empezar
| Requisito | Detalle |
|---|---|
| Rol en Droka | Administrador o Gerente para enviar facturas fiscales |
| Configuración fiscal | Completada y probada con Probar conexión |
| Proveedor activo para envío | HKA o Alanube (WebPOS: conexión de prueba sí, envío aún no) |
| Facturas elegibles | Estado fiscal Borrador o Rechazada (reintento) |
| Consolidación | Todas las facturas seleccionadas deben ser del mismo cliente |
1. Configuración (Ajustes → Facturación Fiscal)
Solo usuarios con rol Administrador ven esta sección en el menú lateral (Ajustes → Facturación Fiscal).
Elegir proveedor activo
Seleccione HKA, WebPOS o Alanube. Las credenciales de cada proveedor se guardan por separado; al cambiar de proveedor no se borran los perfiles de los demás.
Completar credenciales
HKA (recomendado para envío hoy)
- URL del API (demo:
https://demoemision.thefactoryhka.com.pa/ws/obj/v1.0/Service.svc) - Token empresa → campo Clave API
- Token contraseña → campo Secreto API
- Código sucursal emisor (ej.
0000o0001): debe coincidir con una sucursal activa en su licencia HKA - ID de certificado: opcional para HKA
Alanube
- URL sandbox o producción
- Token JWT Bearer
WebPOS
- CompanyLicCod, usuario, clave, sucursal y POS (solo prueba de conexión por ahora)
Datos del emisor
Complete RUC, DV, razón social, dirección fiscal y punto de facturación. El panel Listo para enviar indica qué campos faltan.
Ambiente
Use Pruebas hasta validar el flujo completo. En Producción se generan documentos fiscales reales ante la DGI.
Guardar y probar
Pulse Guardar configuración, luego Probar conexión. Si falla, revise tokens, URL y código de sucursal HKA antes de intentar emitir facturas.
Si HKA devuelve error relacionado con sucursal o listaPagoPlazo, verifique el código de sucursal emisor y, en facturas a crédito, el plazo y la fecha de vencimiento en el panel de revisión fiscal.
2. Emitir la factura fiscal
El envío se hace desde Facturas, no desde el formulario de creación de factura.
Filtrar pendientes
En la lista de facturas, use el filtro Pendiente fiscal para ver solo facturas que aún no están autorizadas.
Seleccionar facturas
Marque una o más facturas del mismo cliente. El total fiscal seleccionado aparece sobre la tabla.
Enviar a factura fiscal
Pulse Enviar a factura fiscal. El sistema genera una vista previa del payload fiscal y lo envía al PAC.
Contado vs crédito (HKA)
- Contado (factura pagada): el envío suele ser en un clic, sin panel adicional.
- Crédito (factura sin pagar) o cliente sin RUC: se abre el panel Revisión fiscal para confirmar tipo de receptor, forma de pago, plazo en días y fecha de vencimiento de la cuota.
Revisión fiscal (cuando aplica)
En el panel lateral confirme:
- Tipo de cliente (DGI): Contribuyente, Consumidor final, Gobierno o Extranjero
- Forma de pago: Contado o Crédito
- Si es crédito: plazo (días) y fecha de vencimiento (por defecto 30 días; editable)
Luego Confirmar y enviar.
Resultado y CAFE
Tras la autorización, la factura muestra estado fiscal Autorizada y el CUFE. Use Descargar CAFE para obtener el PDF del comprobante auxiliar.
Si el PAC rechaza el envío, el estado pasa a Rechazada con el mensaje de error; puede corregir datos y reenviar las mismas facturas.
Consolidar varias facturas
Puede seleccionar 2 o más facturas del mismo cliente y enviarlas en un solo documento fiscal consolidado. Las mismas reglas aplican: mismo cliente, estados borrador/rechazado, y revisión fiscal HKA si alguna está sin pagar o el cliente no tiene RUC.
Clientes sin RUC
Si el cliente no tiene RUC en su ficha, el sistema puede tratarlo como Consumidor final (no se envía RUC al PAC). En el panel de revisión puede elegir explícitamente el tipo de receptor antes de enviar.
3. Limitaciones actuales
Estas limitaciones reflejan el comportamiento actual de Droka (marzo 2026) y pueden ampliarse en versiones futuras.
| Área | Limitación |
|---|---|
| Roles | Solo admin y manager pueden enviar; bodega y transportista ven estados pero no envían |
| Feature flag | La org debe tener facturación fiscal habilitada por el administrador de plataforma |
| Proveedor WebPOS | Probar conexión sí; envío al PAC aún no implementado |
| Panel de revisión | Solo con proveedor HKA y cuando hay crédito o revisión de receptor |
| Plan de pagos | Una sola cuota por documento (no múltiples cuotas) |
| Selección | Todas las facturas del lote deben ser del mismo cliente |
| Estados | Solo borrador o rechazado fiscal; no re-fiscalizar facturas ya autorizadas |
| Plazo en factura | El plazo de crédito se confirma al emitir, no al crear la factura operativa |
| Anulación / estado | Consultar con su proveedor PAC; no todas las operaciones están en esta guía |
4. Preguntas frecuentes
Menú Ajustes → Facturación Fiscal (solo administradores). Guarde tokens, datos del emisor, código de sucursal y pruebe la conexión antes de emitir.
Verifique: (1) la función está habilitada para su organización, (2) su rol es admin o gerente, (3) completó la configuración fiscal, (4) hay facturas seleccionadas en estado borrador o rechazado fiscal.
No. Todas las facturas del envío deben pertenecer al mismo cliente. Use el filtro Pendiente fiscal y seleccione solo un cliente por lote.
Con HKA, las facturas marcadas como pagadas suelen enviarse sin abrir el panel de revisión, en un solo clic, siempre que la configuración y el cliente sean válidos.
Se abre Revisión fiscal. Debe confirmar crédito, plazo (por defecto 30 días) y fecha de vencimiento. HKA exige enviar el bloque de plazo de pago (listaPagoPlazo) para documentos a crédito.
Sí, como Consumidor final. En revisión fiscal elija ese tipo; no se enviará RUC al PAC. Para contribuyente o gobierno el cliente debe tener RUC en su ficha.
Revise el código de sucursal emisor en Ajustes → Facturación Fiscal. Debe coincidir con una sucursal activa en su licencia The Factory HKA.
Cuando el documento está autorizado, use el botón Descargar CAFE en la fila de la factura. Genera un PDF con el comprobante auxiliar.
Sí. Las facturas en estado Rechazada pueden seleccionarse de nuevo y reenviarse tras corregir configuración, datos del cliente o parámetros de crédito.
WebPOS: solo configuración y prueba de conexión por ahora. Alanube: envío soportado, pero el panel de revisión de crédito/receptor es específico de HKA. Use HKA si necesita el flujo completo de revisión antes de enviar.
Siguiente paso
Preguntas generales de facturación
FAQs sobre crear facturas operativas, manifiestos y envío por correo.