Para clientes de SIGN DE
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 han implementado la API SIGN DE de fiskaly.
Esta API fue creada en cooperación con la administración fiscal del estado de Hessen.
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 datos adicionales de un cliente de SIGN DE
Sección titulada «PUT: Crear o actualizar datos adicionales de un cliente de SIGN DE»Un cliente representa un dispositivo TPV en uso. Para crear presentaciones, se debe añadir información adicional sobre los clientes que ya existen en fiskaly SIGN DE.
Un cliente solo puede asignarse a un establecimiento. Para cada establecimiento, el contribuyente debe crear una presentación separada con todos los clientes vinculados a ese establecimiento.
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.
Los datos adicionales solo son necesarios para los clientes de fiskaly SIGN DE. No se necesitan datos adicionales para las instancias de TSS de fiskaly SIGN DE.
Opcional PUT: Crear o actualizar una TSS externa (es decir, una TSS de un fabricante distinto de fiskaly)
Sección titulada «Opcional PUT: Crear o actualizar una TSS externa (es decir, una TSS de un fabricante distinto de fiskaly)»Si un establecimiento utiliza TSS externas además de las TSS de fiskaly SIGN DE, 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.
Opcional PUT: Crear o actualizar un cliente externo (es decir, que utiliza una TSS de un fabricante distinto de fiskaly)
Sección titulada «Opcional PUT: Crear o actualizar un cliente externo (es decir, que utiliza una TSS de un fabricante distinto de fiskaly)»Si se utilizan TSS no fiskaly, los clientes conectados a ellas se añaden a través de este endpoint.
Los clientes externos requieren que existan las TSS externas correspondientes y deben ser asignados a esas TSS.
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 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?