API de recepciónRecibos conformes conuna integración
La API de PosDealer permite a los usuarios gestionar derechos, realizar un seguimiento de las instalaciones y proporcionar configuraciones conformes en miles de instalaciones.
La fiskaltrust Receipt-API
La fiskaltrust Receipt-API es la interfaz central para gestionar el ciclo de vida de los recibos. Abarca la creación, firma, emisión, transporte, recuperación y acceso de auditoría de recibos de forma coherente y regulada. Los recibos se tratan como un componente central del sistema, independiente del canal, dispositivo o método de entrega, y funcionan igual en todos los mercados soportados.
La API te permite centrarte en tu sistema mientras fiskaltrust se ocupa de la infraestructura de recepción. En lugar de crear y mantener formatos específicos para cada país, lógica de transporte y casos extremos, confías en una API unificada y de código abierto que se mantiene estable aunque cambien las normativas y los requisitos operativos.
Funcionalidades básicas de la API
Funcionalidades básicas de la API
- crear – Recibo con artículos, pagos y totales.
- firmar – Aplicar reglas fiscales nacionales, firmas y encadenamiento hash.
- emisión – Entrega el recibo en HTML, PDF, código QR o por correo electrónico/SMS.
- Recuperar – Recupera recibos por ID, referencia de pedido o intervalo de tiempo.
- verificar – Validar las firmas y la integridad.
- Revocar – Marcar un recibo como cancelado o corregido.
- diario – Exporta registros de auditoría, cierres e informes.
Características principales
- Flexibilidad de formato: Puedes obtener recibos como visualizaciones o como datos sin procesar. Elige entre formatos como HTML, PDF, PNG o JSON.
- Conformidad: La API garantiza que tus recibos cumplen los requisitos legales.
- Velocidad: Utiliza el Ayudante POS-API para subir recibos instantáneamente. Sin este ayudante, las subidas pueden tardar hasta cinco minutos.
- Recuperación de datos: La API proporciona una forma segura de acceder a los datos de los recibos. Esto te permite integrar los recibos en tus propias aplicaciones.
Cada operación se asigna a los pasos del ciclo de vida del recibo. Un recibo se crea a partir de los datos del pedido y del pago, se firma conforme a la legislación nacional y se emite al consumidor. Puede recuperarse para devoluciones, verificarse para auditorías, revocarse si se corrige y exportarse como parte de un diario. Todo el proceso es determinista, a prueba de manipulaciones y conforme a las normas de cada país.
La Receipt-API proporciona una base resistente para la gestión de recibos, facilitando la integración, reduciendo la complejidad y garantizando la continuidad de la empresa incluso cuando fallan las impresoras, gracias a la recuperación digital compatible.
Por qué los desarrolladores utilizan la API de recepción
La API te permite centrarte en tu sistema mientras fiskaltrust se ocupa de la infraestructura de recibos. En lugar de tratar los recibos como una función secundaria o un complemento para el consumidor, la API de recibos gestiona los recibos como un componente del sistema regulado de primera clase. Lo integras una vez y confías en una API unificada y de código abierto que se mantiene a medida que evolucionan las normativas y los requisitos operativos.
- De código abierto: Implantación transparente, sin dependencia del proveedor y con total auditabilidad.
- Modelo de recibo unificado: Una estructura de datos para artículos, pagos, impuestos, metadatos, firmas y estados del ciclo de vida.
- Gestión híbrida de recibos: Recibos digitales y en papel gestionados a través de la misma API, incluyendo HTML, ESC/POS, PDF y formatos nativos del dispositivo.
- Soporte multimercado: Las mismas cargas útiles y lógica de ciclo de vida en AT, DE, FR, IT, ES, PT y más.
- Lógica de cumplimiento desacoplada: Las normas fiscales, los formatos y los mecanismos de firma evolucionan independientemente del código de tu aplicación.
- Continuidad empresarial: La creación, firma y emisión de recibos siguen siendo deterministas y fiables en escenarios online, offline y de red degradada.
- Tiempo de integración reducido: No hay que mantener en tu propia base de código la representación de recibos, la lógica de impresión o los flujos de transporte específicos de cada país.
- Visualización de recibos incluida: Documentos de recibo HTML estandarizados y compatibles que funcionan en todos los dispositivos y sistemas operativos.
- Canales de transporte integrados: Entrega de recibos mediante código QR, URL, correo electrónico, SMS o transferencia de dispositivo, sin lógica de transporte personalizada.
La API de recibos permite a los desarrolladores y distribuidores crear una capa de recibos omnicanal coherente y exponer los datos de los recibos como un servicio reutilizable.
Los recibos se convierten en una fuente de datos segura y estructurada que puede reutilizarse en las integraciones de fidelización, contabilidad y terceros, convirtiendo las transacciones en puntos de contacto extensibles del sistema, en lugar de eventos aislados.
Opciones de alojamiento
Opciones de alojamiento
- Servicios locales: Windows, Linux, macOS, Android, iOS.
- Centro de datos comercial: Clústeres Kubernetes o despliegue IIS.
- En la nube: Regiones Azure europeas con cumplimiento específico del mercado.
- Fallback sin conexión: El intermediario local de IoT garantiza que las operaciones de recepción continúen durante las interrupciones.
La API de recepción permite un despliegue flexible. Puede integrarse en tu TPV, ejecutarse como un servicio local, desplegarse a escala en un centro de datos o utilizarse a través de servicios en la nube alojados por fiskaltrust. Todos los modelos siguen el mismo contrato API. Los intermediarios offline garantizan que la creación y firma de recibos funcionen incluso si falla la conexión a Internet.
Entorno Sandbox
Puedes probar el sistema en nuestro entorno sandbox. Regístrate como socio en un portal del Mercado fiskaltrust. Amplía tu punto final para llamar a la API. Este proceso te permite recuperar los datos de los recibos en el formato que prefieras y visualizarlos.
Cómo funciona en 3 pasos
1.
Inscríbete en fiskaltrust.Portal.
2.
Crea una caja y conéctala a tu TPV o ERP.
3.
Empieza a crear y emitir recibos con la API de recibos.
Más información - La documentación, los SDK y los entornos de prueba están disponibles aquí