Para clientes externos
Esta guía ofrece una descripción general de los pasos necesarios para presentar los datos requeridos a las autoridades fiscales de acuerdo con los requisitos legales (§146a (4) AO - Código Tributario alemán). Está destinada a los clientes que no han implementado la API SIGN DE de fiskaly.
Esta API fue creada en cooperación con la administración fiscal del estado de Hessen.
La guía consta de dos partes: Configuración básica y Parte principal — Endpoints SIGN DE x Submission.
Parte 1: Configuración básica
Sección titulada «Parte 1: Configuración básica»Creación de una cuenta
Sección titulada «Creación de una cuenta»Para utilizar los servicios de fiskaly, deberás crear una cuenta a través del fiskaly HUB. Una vez creada la cuenta, se te pedirá que crea su primera organización principal.
Creación de la primera organización
Sección titulada «Creación de la primera organización»La primera organización (principal), que representa al proveedor de TPV, debe crearse a través del fiskaly HUB. Una vez creada, puede proceder a añadir organizaciones gestionadas que representen las ubicaciones individuales del contribuyente. Es posible añadir un nivel adicional a la estructura; puede encontrar una guía aquí.
Eche un vistazo a nuestro vídeo para una explicación paso a paso sobre cómo configurar tu cuenta y tu primera organización.
Una organización principal (organization) representa a un proveedor de TPV o a un comerciante
con tu propio sistema TPV, mientras que una organización gestionada (managed_ organization) representa la ubicación de un comerciante o la ubicación de una tienda de un comerciante.
Ejemplos:
- Si la organización principal es un proveedor de TPV, las organizaciones gestionadas representan la ubicación de cada cliente (contribuyente).
- Si la organización principal es un comerciante con tu propio sistema TPV, las organizaciones gestionadas representan cada tienda.
Creación de la primera clave API
Sección titulada «Creación de la primera clave API»Después de crear una cuenta y tu primera organización a través del HUB, necesita generar una clave API en el HUB (Configuración -> Claves API -> CREAR CLAVE API).
La clave API y el secreto son necesarios para generar un token de acceso a través del endpoint authenticate. Este token se utiliza para todas las llamadas a la API.
POST: Crear organización
Sección titulada «POST: Crear organización»Utiliza este endpoint para crear una organización gestionada. Utiliza el ID de la
organización principal para el campo managed_by_organization_id en el cuerpo de su
solicitud. Recomendamos encarecidamente crear una organización gestionada separada
para cada ubicación. De este modo, se puede crear una estructura en la que una organización
gestionada corresponda a un establecimiento.
Parte 2: Endpoints SIGN DE x Submission
Sección titulada «Parte 2: Endpoints SIGN DE x Submission»POST: Autenticar la API
Sección titulada «POST: Autenticar la API»Para acceder a la API SIGN DE x Submission, necesita un token JWT válido.
Este endpoint crea el token con su api_key y api_secret. Si no
tiene un api_key, puede crear uno a través del endpoint de la Management API
createApiKey o a través del fiskaly HUB. El api_secret se generará para ti
después de crear el api_key. El token debe enviarse con cada solicitud posterior
en el campo del encabezado Authorization utilizando el esquema de autenticación Bearer.
PUT: Crear o actualizar el contribuyente
Sección titulada «PUT: Crear o actualizar el contribuyente»El contribuyente representa a una persona física o a una entidad jurídica como una empresa. Aquí se debe proporcionar información general sobre el contribuyente. Se crea solo una vez y puede actualizarse sin activar una nueva presentación.
Dentro de cada (managed_)organization, solo se puede y debe crear un único contribuyente.
PUT: Crear o actualizar el establecimiento
Sección titulada «PUT: Crear o actualizar el establecimiento»El establecimiento representa cada ubicación física del negocio (Betriebsstätte) y debe crearse aunque los datos del establecimiento sean los mismos que los del contribuyente.
Para los clientes que han creado una managed_organization separada para cada
ubicación, la managed_organization siempre corresponde a un establecimiento específico.
Este es el enfoque recomendado.
En caso de que una managed_organization represente más de una ubicación del mismo
contribuyente, debe crearse un establecimiento separado para cada una de esas ubicaciones.
Cada contribuyente puede tener múltiples establecimientos, pero cada establecimiento solo puede pertenecer a un contribuyente y tener una única dirección.
La creación y las actualizaciones de TSS y clientes asignados a un establecimiento siempre requieren una nueva presentación del establecimiento correspondiente en su totalidad. Otros establecimientos no requieren una nueva presentación en ese caso.
PUT: Crear o actualizar una TSS externa (es decir, una TSS de un fabricante distinto de fiskaly)
Sección titulada «PUT: Crear o actualizar una TSS externa (es decir, una TSS de un fabricante distinto de fiskaly)»Una TSS es un Sistema de Seguridad Técnica. Es un conjunto de componentes utilizados para asegurar, almacenar y gestionar datos fiscales.
Las TSS externas deben añadirse a través de este endpoint.
Este endpoint no es obligatorio para los clientes que han implementado la API fiskaly SIGN DE y no utilizan TSS externas.
PUT: Crear o actualizar un cliente externo (es decir, que utiliza una TSS de un fabricante distinto de fiskaly)
Sección titulada «PUT: Crear o actualizar un cliente externo (es decir, que utiliza una TSS de un fabricante distinto de fiskaly)»Un cliente representa un dispositivo TPV en uso. Los clientes conectados a instancias de TSS externas se añaden a través de este endpoint.
La baja de un cliente debe comunicarse solo una vez, configurando los parámetros correspondientes y activando una nueva presentación para el establecimiento correspondiente. Después, el cliente puede desvincularse del establecimiento y/o reasignarse a otro establecimiento como cliente dado de alta, seguido de una nueva presentación para el establecimiento correspondiente.
Este endpoint no es obligatorio para los clientes que han implementado la API fiskaly SIGN DE y no utilizan TSS externas.
PUT: Crear presentación
Sección titulada «PUT: Crear presentación»Una presentación es el conjunto de información sobre un establecimiento específico con todos sus clientes. No se envía automáticamente a las autoridades fiscales — debe realizarse una solicitud adicional a través del endpoint TriggerTransmission.
Para transmitir una presentación, es necesario descargar y visualizar previamente el PDF de vista previa a través del endpoint GetValidationSuccessfulFile.
Los integradores de la API deben asegurarse de que los contribuyentes reales hayan comprobado que los datos de presentación generados son correctos antes de enviarlos a las autoridades fiscales.
PUT: Activar transmisión
Sección titulada «PUT: Activar transmisión»La transmisión es el proceso por el cual los datos de la presentación se transfieren al servidor de ELSTER (ELektronische STeuer ERklärung). Solo se puede activar una transmisión por presentación.
Una vez activada, una transmisión puede cancelarse siempre que esté siendo procesada en la API SIGN DE x Submission y aún no haya sido transmitida a ELSTER. Como la transmisión suele realizarse en pocos segundos, el margen para una cancelación exitosa es breve. Tras una cancelación exitosa, puede activarse de nuevo una transmisión para la presentación específica.
Utiliza este endpoint para activar la transmisión de una presentación específica a las
autoridades fiscales. Ten en cuenta que esto solo es posible si la presentación se
encuentra en el estado READY_FOR_TRANSMISSION, lo que indica que los datos contenidos en
la presentación han sido verificados en cuanto a su validez sintáctica y completitud. Sin
embargo, esto no es una confirmación de la exactitud factual.
El contribuyente está legalmente obligado a comprobar la exactitud de los datos de presentación antes de activar la transmisión. El acto de activar la presentación indica el consentimiento del contribuyente y la asunción de responsabilidad por la exactitud de los datos transmitidos. En caso de que se hayan incluido datos erróneos en una presentación transmitida, esto puede rectificarse simplemente creando y transmitiendo una nueva presentación con los datos correctos.
Was this page helpful?