Endpoints de DSFinV-K

Endpoints de DSFinV-K

En esta página encontrará una descripción general de los endpoints más relevantes de DSFinV-K, así como los endpoints opcionales.

Endpoints opcionales

Las Definiciones de IVA y las Agencias de compras se describen como «opcionales», ya que no son relevantes para la mayoría de los contribuyentes. La mayoría de los clientes pueden comenzar directamente con el endpoint Insertar o actualizar un sistema de caja.

Crear o actualizar una definición de IVA (opcional)

Los tipos de IVA de uso general definidos por ley se proporcionan a través de la API en el mismo orden que en los documentos de DSFinV-K emitidos por la Oficina Central Federal de Impuestos de Alemania (Bundeszentralamt für Steuern — BZSt), véase Anlage 2 zur DSFinV-K.

Algunos contribuyentes pueden necesitar crear Definiciones de IVA adicionales con un vat_definition_export_id superior a 1000.

Las Definiciones de IVA individuales adicionales deben definirse para cada organización gestionada y para el entorno correspondiente (LIVE o TEST). Esto significa que una Definición de IVA creada en una organización gestionada solo existirá dentro de esa organización específica y en el entorno para el que fue definida.

Crear o actualizar una agencia de compras (opcional)

Las Agencias de compras no son necesarias para todos los contribuyentes. Se requiere una Agencia de compras cuando se registran importes en nombre de un tercero (p. ej., «tienda dentro de una tienda»).

Para más información, consulta el capítulo Anexo A — Definiciones de términos en el documento DSFinV-K emitido por la Oficina Central Federal de Impuestos de Alemania (BZSt).

Insertar o actualizar un sistema de caja

Para cada dispositivo de sistema de caja en uso, debe crear un Sistema de caja. Los Cierres diarios se realizan a nivel de cada sistema de caja individual. La creación de un sistema de caja no forma parte de las operaciones diarias; sin embargo, los sistemas de caja existentes deben actualizarse en caso de cambios, por ejemplo, actualizaciones de la versión de software del sistema de caja.

Relación maestro-terminal en los sistemas de caja

En la mayoría de los casos, el cash_register_type será ‘MASTER’. Este tipo de sistema de caja se considera un sistema de registro individual que opera de forma independiente. Debe estar directamente conectado a un TSS (véase Cliente en SIGN DE).

En determinados escenarios, se utilizan los denominados sistemas de caja terminales además del sistema de caja ‘MASTER’ descrito anteriormente. Los detalles sobre esta constelación maestro-terminal se encuentran en el documento DSFinV-K emitido por la Oficina Central Federal de Impuestos de Alemania (BZSt) en la página 39. Las Preguntas frecuentes publicadas por el Ministerio Federal de Finanzas alemán también pueden ser de utilidad (concretamente el n.º 7 sobre dispositivos portátiles en la sección Anwendungsbereich).

	Funciona de forma independiente en modo sin conexión	Debe estar directamente conectado a un TSS
Sistema de caja maestro	Sí	Sí
Sistema de caja terminal	No	No

Insertar un cierre diario

Este endpoint forma parte de las operaciones diarias. Un Cierre diario es un resumen de todos los procesos relevantes — véase Tipos de proceso (comprobante) y tipos de transacción comercial — dentro de un sistema de caja (de tipo ‘MASTER’) para un período de tiempo determinado. Debe crearse al menos una vez al día, por ejemplo, al cierre de la tienda.

Desde una perspectiva técnica, algunos campos están marcados como «obligatorios», mientras que otros no lo están. Sin embargo, esto no significa que puedan dejarse vacíos desde una perspectiva legal. Siempre que se hayan realizado transacciones en un día determinado, los datos relevantes deben incluirse en el cierre diario en las secciones de transacciones y cash_statement.

Estructura de un cierre diario

Un Cierre diario consta de 3 partes principales:

• Head: Esta sección establece el alcance del cierre diario indicando el día específico y el rango de transacciones incluidas.

• Cash Statement: Esta parte es la agregación de todas las transacciones representadas en dos bloques:

  • business_cases incluye el flujo de pago total en el sistema de caja, desglosado por caso de negocio.

  • payment_type incluye el flujo de pago total en el sistema de caja, desglosado por tipo de pago.

• Transactions: Esta parte incluye información detallada sobre cada transacción individual dentro del cierre diario:

  • head contiene información esencial sobre la transacción.

  • data proporciona detalles de la transacción.

  • security crea el vínculo con la firma TSS. Si no hay firma TSS correspondiente, se debe proporcionar un mensaje de error.

Activar un archivo de exportación

Use este endpoint para activar un Archivo de exportación de DSFinV-K que incluye Cierres diarios. Aunque también es posible activar archivos de exportación a través del fiskaly HUB, recomendamos implementar este endpoint de manera que el contribuyente pueda obtener los archivos de exportación directamente a través de tu sistema.

Tiene dos opciones para seleccionar qué cierres diarios incluir en el archivo de exportación: ByCreationDate y ByBusinessDate. La fecha de creación hace referencia al día en que los cierres diarios se enviaron a la API de DSFinV-K. La fecha comercial hace referencia al día para el que están destinados los cierres diarios.

Puede elegir TAR o ZIP como formatos de exportación. Recomendamos elegir el formato ZIP, ya que es compatible con las herramientas de validación más comunes.

Dependiendo de la cantidad de datos, la generación de los archivos de exportación puede tardar desde unos pocos segundos hasta una hora.

Descargar directamente un archivo de exportación

Una vez completados los archivos de exportación, se pueden descargar a través del endpoint Descargar directamente un archivo de exportación en el formato especificado en el paso anterior.