crearFactura (las facturas quedan OFFLINE_PENDING) y cierra el evento al volver la conexión. Mismo flujo que Eventos (REST). Cada ejemplo muestra los params de tools/call y el structuredContent.
“Confirmación” = con una llave de agente piden confirmación humana.
Evento en las respuestas:
id, posId, codigoMotivo, descripcionMotivo, fechaInicio, fechaFin, cufdEvento, codigoEventoSiat, codigoRecepcionSiat, finalizado, createdAt y, al cerrar, paquetes.
verificarConexionSiat
Comprueba si los servicios del SIN responden. Úsala antes de emitir o de cerrar un evento. Sin parámetros.tools/call
structuredContent
obtenerEventoActivo
Devuelve el evento abierto de un punto de venta.active: false significa que emite en línea.
tools/call
structuredContent
abrirEvento
Abre un evento significativo en un punto de venta. Desde ahí,crearFactura emite offline hasta cerrarEvento. Si el punto de venta ya tenía un evento abierto, devuelve ese.
Motivos:
1 corte de internet · 2 inaccesibilidad del SIN · 3 zona sin internet · 4 venta en lugar sin internet · 5 virus o falla de software · 6 cambio de infraestructura o falla de hardware · 7 corte de energía.
tools/call
structuredContent
cerrarEvento
Cierra el evento: el punto de venta vuelve en línea, se renueva el CUFD, el evento se registra en el SIN y se mandan los paquetes offline. Se puede repetir si se corta.tools/call
structuredContent
paquetes[].estado: VALIDATED aceptado, REJECTED rechazado (revisa detalle), SENT recibido sin validar todavía, ERROR falló el envío.
reenviarPaqueteEvento
Reenvía el paquete offline de un evento ya registrado en el SIN, sin registrarlo de nuevo. Destraba las facturas que quedaronOFFLINE_PENDING.
tools/call
structuredContent
facturasAntes: las que viajaron. facturasDespues: las que siguen OFFLINE_PENDING.
regularizarFacturasFueraDeEvento
Para facturas offline emitidas después del fin de un evento cerrado, que el SIN descartó ([924]). Registra un evento nuevo, ya cerrado, que las cubre y manda su paquete. Falla si hay un evento activo o la ventana se superpone con otro.
tools/call
structuredContent
resellarFacturasEvento
Re-sella con el CUFD del evento las facturas offline emitidas con otro CUFD (rechazadas con901) y reenvía el paquete. El número de factura no cambia; el CUF y el QR sí, así que los documentos ya entregados quedan desactualizados.
tools/call
structuredContent
consultarEventosSiat
Eventos significativos que el SIN tiene registrados para un punto de venta en una fecha.tools/call
structuredContent