Facturación y control

Facturación y control explica cómo Ballista convierte un pedido listo en evidencia fiscal y operativa. La venta no termina cuando alguien crea una orden: termina cuando el cliente, el emisor, las líneas, los impuestos, el documento y el estado quedan claros.

En Costa Rica, la facturación electrónica agrega una capa sensible: certificado, credenciales, ambiente, receptor, actividad económica, XML, PDF, respuesta de Hacienda y trazabilidad. La wiki no necesita convertir a la persona usuaria en especialista fiscal, pero sí debe ayudarle a saber qué revisar antes de emitir y qué hacer cuando algo falla.

Rutas del Flujo

Antes de Emitir

Antes de presionar Issue document, revisa:

Venir Desde un Pedido

El camino más seguro es facturar desde /orders/{id} con Facturar este pedido. Así Facturación recibe contexto real: cliente, líneas, cantidades, descuentos, impuestos y total.

Flujo recomendado:

1. Abrir el pedido en /orders/{id}.
2. Confirmar cliente, receptor, líneas, lotes y totales.
3. Verificar que el pedido realmente esté listo para facturar.
4. Usar Facturar este pedido.
5. Revisar emisor y ambiente en Facturación.
6. Completar o corregir receptor si hace falta.
7. Validar líneas, impuestos y total.
8. Emitir, simular o guardar según ambiente.
9. Revisar resultado en /billing/historial.

Si el pedido cambió después de preparar la factura, vuelve al pedido y confirma cuál es la versión correcta. Facturar datos viejos es peor que detenerse a revisar.

Configuración Fiscal

/billing/configuracion no es una pantalla diaria; es la base fiscal del organización. Debe tocarse con cuidado porque un cambio incorrecto puede afectar todos los comprobantes posteriores.

Nunca pegues certificados, PIN, credenciales ni tokens en un ticket. Para soporte, basta indicar qué bloque falla y el mensaje visible.

Estados y Evidencia

Después de emitir, el historial debe ayudar a responder:

El historial no es solo archivo. Es la forma de demostrar qué se intentó, cuándo, con qué datos y con qué resultado.

Errores Comunes

Demo vs Producción

El tour guiado y algunos flujos de demostración pueden usar datos simulados. Eso sirve para venta consultiva y capacitación, pero no debe confundirse con una emisión fiscal real.

Antes de operar en producción, confirma:

• ambiente activo;
• emisor correcto;
• certificado y credenciales vigentes;
• receptor real;
• impuestos correctos;
• pedido validado;
• permisos de usuario.

Para Soporte

Cuando reportes un problema de facturación, incluye:

• ruta exacta: /billing, /billing/historial, /billing/configuracion u /orders/{id};
• id de pedido, si viene desde Pedidos;
• tipo de documento;
• emisor seleccionado;
• ambiente: pruebas/staging o producción;
• cliente/receptor;
• estado visible del documento;
• mensaje exacto de Hacienda o Ballista;
• si XML/PDF están disponibles;
• nunca incluir .p12, PIN, credenciales ni tokens.

Cómo se Conecta

Facturación se conecta con Pedidos y ventas, porque el pedido aporta líneas, cliente, estado y total. También conecta con Reportes y decisiones, porque ventas, cobros, cuentas por cobrar y operaciones FE dependen de estados correctos. Si el problema requiere seguimiento, crea una tarea o ticket siguiendo Cambios seguros.

Resumen

Facturación y control cierran el ciclo entre pedido, documento y evidencia. Antes de emitir, revisa emisor, ambiente, certificado, receptor, líneas e impuestos. Si algo falla, corrige el dato origen y reintenta con contexto, no con documentos paralelos improvisados.