En Alemania, fiskaly admite el envío y la recepción de facturas electrónicas B2B. La facturación electrónica está regulada por el Ministerio Federal de Finanzas (BMF — Bundesministerium der Finanzen). Todas las facturas electrónicas deben cumplir con la EN 16931, que se satisface mediante formatos como XRechnung, ZUGFeRD o Peppol BIS 3.0 Billing. fiskaly no archiva las facturas electrónicas alemanas: consulte Archivo.
fiskaly genera facturas electrónicas conformes con la EN 16931 y las entrega a través de uno de dos canales. El canal se elige por factura en el destinatario (recipients[].invoicing): por correo electrónico — como ZUGFeRD o XRechnung — o a través de la red PEPPOL, como XRechnung.
Las dos direcciones se configuran de forma distinta:
Envío — B2B
Dos canales de entrega, elegidos por factura en el destinatario: por correo electrónico como ZUGFeRD o XRechnung, o a través de la red PEPPOL como XRechnung. El correo electrónico no requiere ningún registro en la red.
Recepción — B2B
Solo a través de PEPPOL, por lo que requiere el registro opcional en PEPPOL y un Proof of Ownership verificado. Un Taxpayer que solo envía por correo electrónico no puede recibir. Actualmente no se reciben las XRechnung entrantes.
Esta página cubre los requisitos específicos de Alemania que complementan la Integración general paso a paso. Asegúrate de tener a mano la siguiente información del contribuyente antes de continuar:
fiscalization.vat_id_number— Número de identificación fiscal a efectos del IVA (Umsatzsteuer-ID), 9 dígitos sin el prefijoDEfiscalization.tax_id_number— Número de identificación fiscal personal (Steuer-ID), 11 dígitos. Obligatorio para Taxpayers de tipoINDIVIDUAL.name— Nombre legal registrado y nombre comercial de la empresa o de la persona físicaaddress— Domicilio social registrado de la empresa o de la persona física
Un System E_INVOICE_SERVICE alemán no puede ponerse en servicio si el
Taxpayer no tiene un vat_id_number válido. La Steuer-ID indicada en
tax_id_number no basta: las facturas electrónicas alemanas exigen
una identidad fiscal en forma de número de IVA, así que los dos campos no son
intercambiables aquí. Sin él, la puesta en servicio falla con
422 Unprocessable Content.
Envío de facturas electrónicas: requisitos del destinatario
Sección titulada «Envío de facturas electrónicas: requisitos del destinatario»Para enviar una factura electrónica, indicas el destinatario y cómo debe llegarle el documento directamente en el registro de la factura. Cuando creas la factura (TRANSACTION::INVOICE) con createRecord, añades el destinatario a su array recipients.
Como explica la Integración general paso a paso, cada destinatario debe ser de tipo BUSINESS y tener el bloque invoicing completado. Además de los datos estándar de toda factura electrónica (nombre, dirección e identificación fiscal del destinatario, líneas de factura, etc.), en Alemania se añade el canal de entrega en el propio destinatario:
recipients[].type=BUSINESSrecipients[].identification.type=VAT— la factura electrónica alemana identifica al comprador por su número de IVArecipients[].address.country=DE— los destinatarios deben estar en Alemaniarecipients[].invoicing.type=EMAILoPEPPOL— el canal de entregarecipients[].invoicing.email— (solo EMAIL) la dirección de correo electrónico del destinatariorecipients[].invoicing.format— (solo EMAIL, opcional) el formato del documentorecipients[].invoicing.identifier— (solo PEPPOL) el PEPPOL Network Identifier del destinatario, en la forma<código de esquema>:<valor>— normalmente9930:<número de IVA>para una empresa alemana
invoicing.type | También obligatorio | Cómo lo entrega fiskaly |
|---|---|---|
EMAIL | invoicing.email | Por correo electrónico a esa dirección, como ZUGFeRD o XRechnung según invoicing.format. |
PEPPOL | invoicing.identifier | Al punto de acceso PEPPOL del destinatario, como XRechnung — consulte la limitación de XRechnung. |
El canal se elige por factura, no de forma fija para cada destinatario — la misma empresa puede recibir una factura por correo electrónico y la siguiente a través de PEPPOL.
Sin el bloque invoicing, la factura electrónica se crea pero no se entrega
al destinatario.
Pagos en la factura
Sección titulada «Pagos en la factura»Cada entrada de payments es un pago ya recibido (CASH, CARD, ONLINE,
VOUCHER, OTHER) o el importe aún pendiente (OUTSTANDING). Los pagos
recibidos aparecen en la factura como importe ya pagado, y la fecha de la
entrada OUTSTANDING pasa a ser la fecha de vencimiento de la factura. Para una
factura pagada por completo, omita OUTSTANDING.
Todo pago necesita type y details.amount. Algunos tipos necesitan más:
type | También obligatorio |
|---|---|
CASH | — |
CARD | number (número de tarjeta enmascarado, por ejemplo ************1234) y kind |
ONLINE | name, por ejemplo el proveedor de pagos |
VOUCHER | number y kind |
OTHER | — (name es opcional) |
OUTSTANDING | concept (GOOD, SERVICE o INVOICE) y details.date, la fecha de vencimiento |
concept solo se acepta en OUTSTANDING. En cualquier otro tipo de pago, la
solicitud se rechaza con 400.
Si payments contiene más de una entrada OUTSTANDING, solo se utiliza la
primera. Las demás se ignoran sin error, por lo que no se pueden representar
pagos a plazos con varias fechas de vencimiento.
Registro en PEPPOL
Sección titulada «Registro en PEPPOL»En Alemania, el registro en la red PEPPOL es opcional: decides activarlo System por System.
Indícalo en el System E_INVOICE_SERVICE con
createSystem:
{ "content": { "type": "E_INVOICE_SERVICE", "location": { "id": "..." }, "software": { "...": "..." }, "registrations": [{ "type": "PEPPOL" }] }}O añádelo a un System existente con
updateSystem:
{ "content": { "registrations": [{ "type": "PEPPOL" }] }}Lo que se deriva de esa elección:
registrationsomitido — el System solo envía por correo electrónico. No interviene ningún Proof of Ownership y el System pasa directamente al modoOPERATIVE.registrationsincluyePEPPOL— se requiere un Proof of Ownership. Al ponerlo en servicio, elstatedel System pasa aCOMMISSIONEDpero sumodepasa aDEGRADED, y el System incluye una entrada de registro que indica que falta el Proof of Ownership.
Para llevar el System al modo OPERATIVE, sube el Proof of Ownership como se
describe en el paso 11
de la guía general de integración. La verificación tarda hasta 72 horas; cuando
termina, el System cambia de estado automáticamente y la entrada de registro se
elimina. El contenido que debe mostrar el documento se describe en la
sección Proof of Ownership.
Puedes añadir PEPPOL a un System que ya esté en servicio. Eso vuelve a
ejecutar la comprobación del Proof of Ownership, así que un System que nunca
haya aportado el documento regresa al modo DEGRADED hasta que lo haga.
Envío a través de PEPPOL
Sección titulada «Envío a través de PEPPOL»En el destinatario de tu solicitud createRecord, establece:
recipients[].invoicing.type=PEPPOLrecipients[].invoicing.identifier— el PEPPOL Network Identifier del destinatario
Antes de usarlo hacen falta dos cosas: tu System E_INVOICE_SERVICE debe estar registrado en la red PEPPOL (consulta Registro en PEPPOL) y debes disponer del PEPPOL Network Identifier del destinatario. Del esquema del identificador se encarga fiskaly.
Las facturas enviadas por esta vía se generan como XRechnung. recipients[].invoicing.format no interviene aquí: en este canal el formato no es seleccionable.
PEPPOL registra a cada participante para los tipos de documento concretos
que puede recibir, y XRechnung es un tipo de documento propio dentro de la red.
El envío a un destinatario que no está registrado para XRechnung falla con
receiver does not support document type.
Lo determinante aquí no es la conformidad: XRechnung sigue las reglas de Peppol
BIS 3.0, pero eso no la hace entregable a un participante registrado únicamente
para Peppol BIS Billing 3.0. Actualmente fiskaly no genera Peppol BIS Billing
3.0 para Alemania: recipients[].invoicing.format ofrece ZUGFERD_V2 y
XRECHNUNG_V3, y se aplica solo al canal de correo electrónico.
Mientras no sepa que un destinatario está registrado para XRechnung, envíele las facturas por correo electrónico.
El envío a organismos públicos alemanes (B2G) todavía no está disponible, por lo que no se puede utilizar el direccionamiento mediante Leitweg-ID.
Envío por correo electrónico: elegir el formato del documento
Sección titulada «Envío por correo electrónico: elegir el formato del documento»Cuando el canal es EMAIL, decides qué formato de documento genera fiskaly. Indícalo en el mismo destinatario de tu solicitud createRecord, mediante recipients[].invoicing.format:
| Valor | Formato |
|---|---|
ZUGFERD_V2 (predeterminado) | ZUGFeRD — un documento híbrido: un PDF/A-3 legible por personas con el XML estructurado incrustado en su interior. |
XRECHNUNG_V3 | XRechnung — una factura XML puramente estructurada, sin capa PDF. |
El campo es opcional: si lo omites, fiskaly genera ZUGFERD_V2. Ambos formatos cumplen con la EN 16931.
Qué recibe el destinatario
Sección titulada «Qué recibe el destinatario»fiskaly envía el correo en nombre del vendedor, desde
no-reply.e-invoicing@fiskaly.com. El asunto es «Your Invoice» y el texto está
en inglés. El correo indica el vendedor y remite al destinatario al vendedor
para cualquier consulta sobre la factura.
El correo se envía justo después de crear la factura (el procesamiento es
asíncrono, ver más abajo). No hay un disparador de envío
separado: para retrasar la entrega, retrasa la llamada a createRecord.
La factura se adjunta como invoice_<id>.xml (XRechnung) o invoice_<id>.pdf
(ZUGFeRD), donde <id> es el ID del Record E_INVOICE::TRANSMISSION.
En el entorno de TEST, las facturas enviadas por correo se entregan realmente
a la dirección indicada en recipients[].invoicing.email. Utilice direcciones
que usted controle.
Requisitos de XRechnung
Sección titulada «Requisitos de XRechnung»Toda factura enviada por PEPPOL se genera como XRechnung, al igual que toda
factura por correo con XRECHNUNG_V3. XRechnung exige dos campos que ZUGFeRD
no exige:
| Campo | Regla de XRechnung | Valor |
|---|---|---|
document.references.buyer | BR-DE-15 | De 1 a 32 caracteres: letras, dígitos, espacios y . - _ /. Obligatorio en toda factura, no solo para compradores del sector público. |
seller.phone | BR-DE-6 | Teléfono de contacto del vendedor en formato E.164, por ejemplo +49301234567. |
Si falta cualquiera de los dos campos, la solicitud devuelve igualmente 200
y la TRANSACTION::INVOICE termina en COMPLETED, pero con un log ERROR y
sin que se cree ninguna transmisión: no se envía nada. Una referencia del
comprador vacía se rechaza con 400.
Ejemplos de solicitudes
Sección titulada «Ejemplos de solicitudes»Cada factura requiere dos llamadas a createRecord, como
se describe en el paso 12
de la guía de integración general: una INTENTION y después una
TRANSACTION::INVOICE que la referencia. Envíe cada llamada con una nueva clave
de idempotencia. Sustituya los ID y los valores por los suyos.
Intention
{ "content": { "type": "INTENTION", "system": { "id": "<E_INVOICE_SERVICE System ID>" }, "operation": { "type": "TRANSACTION" } }}Factura por correo como ZUGFeRD
{ "content": { "type": "TRANSACTION", "record": { "id": "<INTENTION Record ID>" }, "operation": { "type": "INVOICE", "document": { "number": "RE-2026-0001", "issued_at": "2026-10-05T10:00:00+02:00" }, "entries": [ { "type": "SALE", "data": { "type": "ITEM", "text": "Consulting service", "unit": { "quantity": "2", "price": { "exclusive": "100.00", "inclusive": "119.00" } }, "value": { "base": "200.00" }, "vat": { "type": "VAT_RATE", "code": "STANDARD", "percentage": "19.00", "amount": "38.00", "exclusive": "200.00", "inclusive": "238.00" } }, "details": { "concept": "SERVICE" } } ], "recipients": [ { "type": "BUSINESS", "name": "Beispiel GmbH", "address": { "line": { "type": "STREET_NUMBER", "street": "Alexanderplatz", "number": "1" }, "code": "10178", "city": "Berlin", "country": "DE" }, "identification": { "type": "VAT", "number": "369204173" }, "invoicing": { "type": "EMAIL", "email": "invoices@beispiel-gmbh.de", "format": "ZUGFERD_V2" } } ], "payments": [ { "type": "OUTSTANDING", "details": { "amount": "238.00", "currency": "EUR", "date": "2026-11-04" }, "concept": "SERVICE" } ], "breakdown": [ { "type": "VAT_RATE", "code": "STANDARD", "percentage": "19.00", "amount": "38.00", "exclusive": "200.00", "inclusive": "238.00" } ], "totals": { "vat": { "amount": "38.00", "exclusive": "200.00", "inclusive": "238.00" } } } }}Factura por correo como XRechnung
{ "content": { "type": "TRANSACTION", "record": { "id": "<INTENTION Record ID>" }, "operation": { "type": "INVOICE", "document": { "number": "RE-2026-0001", "issued_at": "2026-10-05T10:00:00+02:00", "references": { "buyer": "PO-4711" } }, "seller": { "name": "Max Mustermann", "phone": "+49301234567", "email": "billing@example-seller.de" }, "entries": [ { "type": "SALE", "data": { "type": "ITEM", "text": "Consulting service", "unit": { "quantity": "2", "price": { "exclusive": "100.00", "inclusive": "119.00" } }, "value": { "base": "200.00" }, "vat": { "type": "VAT_RATE", "code": "STANDARD", "percentage": "19.00", "amount": "38.00", "exclusive": "200.00", "inclusive": "238.00" } }, "details": { "concept": "SERVICE" } } ], "recipients": [ { "type": "BUSINESS", "name": "Beispiel GmbH", "address": { "line": { "type": "STREET_NUMBER", "street": "Alexanderplatz", "number": "1" }, "code": "10178", "city": "Berlin", "country": "DE" }, "identification": { "type": "VAT", "number": "369204173" }, "invoicing": { "type": "EMAIL", "email": "invoices@beispiel-gmbh.de", "format": "XRECHNUNG_V3" } } ], "payments": [ { "type": "OUTSTANDING", "details": { "amount": "238.00", "currency": "EUR", "date": "2026-11-04" }, "concept": "SERVICE" } ], "breakdown": [ { "type": "VAT_RATE", "code": "STANDARD", "percentage": "19.00", "amount": "38.00", "exclusive": "200.00", "inclusive": "238.00" } ], "totals": { "vat": { "amount": "38.00", "exclusive": "200.00", "inclusive": "238.00" } } } }}Factura por PEPPOL (XRechnung)
{ "content": { "type": "TRANSACTION", "record": { "id": "<INTENTION Record ID>" }, "operation": { "type": "INVOICE", "document": { "number": "RE-2026-0001", "issued_at": "2026-10-05T10:00:00+02:00", "references": { "buyer": "PO-4711" } }, "seller": { "name": "Max Mustermann", "phone": "+49301234567", "email": "billing@example-seller.de" }, "entries": [ { "type": "SALE", "data": { "type": "ITEM", "text": "Consulting service", "unit": { "quantity": "2", "price": { "exclusive": "100.00", "inclusive": "119.00" } }, "value": { "base": "200.00" }, "vat": { "type": "VAT_RATE", "code": "STANDARD", "percentage": "19.00", "amount": "38.00", "exclusive": "200.00", "inclusive": "238.00" } }, "details": { "concept": "SERVICE" } } ], "recipients": [ { "type": "BUSINESS", "name": "Beispiel GmbH", "address": { "line": { "type": "STREET_NUMBER", "street": "Alexanderplatz", "number": "1" }, "code": "10178", "city": "Berlin", "country": "DE" }, "identification": { "type": "VAT", "number": "369204173" }, "invoicing": { "type": "PEPPOL", "identifier": "9930:DE369204173" } } ], "payments": [ { "type": "OUTSTANDING", "details": { "amount": "238.00", "currency": "EUR", "date": "2026-11-04" }, "concept": "SERVICE" } ], "breakdown": [ { "type": "VAT_RATE", "code": "STANDARD", "percentage": "19.00", "amount": "38.00", "exclusive": "200.00", "inclusive": "238.00" } ], "totals": { "vat": { "amount": "38.00", "exclusive": "200.00", "inclusive": "238.00" } } } }}Comprobar si una factura se ha enviado
Sección titulada «Comprobar si una factura se ha enviado»El envío es asíncrono. createRecord responde en cuanto se acepta la
TRANSACTION::INVOICE, y la factura y su transmisión se procesan después. No
hay webhooks para esto, así que consulte el estado con
retrieveRecord. Cada Record muestra su progreso en
mode: PROCESSING mientras el procesamiento está en curso y FINISHED cuando
ha terminado. state contiene entonces el resultado.
Cuando la TRANSACTION::INVOICE está en FINISHED, COMPLETED no significa por
sí solo que la factura se haya enviado. Compruebe que sus logs no contengan
ninguna entrada con "severity": "ERROR" y que used_in esté presente.
used_in.id es el Record E_INVOICE::TRANSMISSION. Consúltelo hasta que su
mode sea FINISHED. Su state indica el resultado:
COMPLETED: la factura se ha entregado para su envío.FAILED: la factura no se ha entregado. El motivo figura en loslogsdel Record.
En el caso del correo, COMPLETED significa que la factura se ha entregado a la
pasarela de correo de fiskaly. No es posible confirmar la entrega en el buzón
del destinatario, y los rebotes posteriores no se reflejan en el Record.
Si la pasarela de correo rechaza un correo de forma permanente, la transmisión
termina en FAILED de inmediato. Los errores temporales se reintentan en
segundo plano, por lo que la transmisión puede permanecer en PROCESSING
durante un tiempo. Solo termina en FAILED cuando se agotan todos los
reintentos.
Una factura fallida no se ha emitido. Envíela de nuevo como una nueva
TRANSACTION::INVOICE (nueva INTENTION, nueva clave de idempotencia) con el
mismo número de factura, no como CORRECTION. Para corregir una factura que ya
ha llegado al comprador, emita una nota de crédito.
Para más detalles, consulte el artículo de soporte How to detect and handle failed invoices (en inglés).
Errores frecuentes
Sección titulada «Errores frecuentes»| Qué ve | Causa |
|---|---|
Log ERROR either party.telephones or party.people[0].telephones is required (BR-DE-6), no se envía nada | XRechnung sin seller.phone |
Log ERROR en la TRANSACTION::INVOICE, sin used_in, no se envía nada | XRechnung sin document.references.buyer |
400 en createRecord | document.references.buyer vacío u otro error de esquema |
receiver does not support document type | Destinatario PEPPOL no registrado para XRechnung: consulte Envío por PEPPOL |
422 Unprocessable Content en la puesta en servicio | Taxpayer sin vat_id_number |
Recuperar una factura enviada
Sección titulada «Recuperar una factura enviada»Llame a retrieveRecord
sobre la E_INVOICE::TRANSMISSION (used_in.id) con compliance-artifact para
obtener la factura electrónica generada. La respuesta es un sobre JSON. Para
XRechnung, content.compliance.artifact es:
{ "type": "application/xml", "data": "<base64>" }Para ZUGFeRD, content.compliance.artifact es el PDF/A-3 con el XML incrustado:
{ "type": "application/pdf", "data": "<base64>" }Notas de crédito
Sección titulada «Notas de crédito»La guía Nota de crédito explica cuándo y cómo emitir una nota de crédito. Esta sección solo cubre lo que es específico de Alemania.
Los datos no se copian de la factura
Sección titulada «Los datos no se copian de la factura»Una nota de crédito es un documento completo por sí mismo y no toma ningún dato de la factura original. Envía el mismo destinatario, canal y formato que en la factura. Para XRechnung, vuelve a enviar también seller.phone, seller.email y document.references.buyer. Sin ellos, no se envía nada y el record recibe un log ERROR (BR-DE-6, BR-DE-7, BR-DE-15).
Pagos en notas de crédito y facturas de anulación
Sección titulada «Pagos en notas de crédito y facturas de anulación»En una nota de crédito, y en una factura que anula una nota de crédito (factura de anulación), payments describe lo que sigue pendiente en ese documento:
- Parte liquidada:
type: OTHERcondetails.amountydetails.currency, sin fecha. - Importe pendiente de pago:
type: OUTSTANDINGconconcept,details.amount,details.currencyydetails.date, la fecha de vencimiento (obligatoria).
La factura electrónica muestra la parte liquidada como ya pagada y el resto como pendiente de pago hasta la fecha de vencimiento. Ambos tipos se pueden combinar, tanto en notas de crédito como en facturas.
| Documento | Situación | payments |
|---|---|---|
| Nota de crédito | Reembolso ya pagado al cliente | OTHER = importe abonado |
| Nota de crédito | Reembolso aún por pagar | OUTSTANDING con fecha de vencimiento |
| Nota de crédito | Reembolso parcial | OTHER (parte reembolsada) + OUTSTANDING (resto) |
| Factura de anulación | Reembolso pagado por completo, el cliente lo devuelve | OUTSTANDING = importe total |
| Factura de anulación | Parte del reembolso pagada (p. ej., 50,00 de 119,00) | OTHER 69.00 + OUTSTANDING 50.00 |
| Factura de anulación | No se pagó nada, los documentos se compensan | OTHER = importe total |
Ejemplo: factura de anulación, parte del reembolso pagada
"payments": [ { "type": "OTHER", "details": { "amount": "69.00", "currency": "EUR" } }, { "type": "OUTSTANDING", "concept": "SERVICE", "details": { "amount": "50.00", "currency": "EUR", "date": "2026-11-30" } }]Recepción de facturas electrónicas
Sección titulada «Recepción de facturas electrónicas»La recepción de facturas entrantes se realiza a través de PEPPOL, por lo que depende del mismo registro en PEPPOL que el envío por PEPPOL — incluido un Proof of Ownership verificado. Un Taxpayer que solo envía por correo electrónico no puede recibir.
Cuando registras un Taxpayer alemán en PEPPOL, fiskaly lo registra por defecto
tanto para enviar como para recibir. Las facturas entrantes dirigidas al
PEPPOL Identifier del System se asocian a ese System, y fiskaly crea para cada
una un Record de tipo E_INVOICE::RECEPTION.
El registro para la recepción cubre Peppol BIS Billing 3.0, no XRechnung.
Una factura dirigida a su Taxpayer como XRechnung es rechazada por la red antes
de llegar a fiskaly, por lo que no se crea ningún Record de tipo
E_INVOICE::RECEPTION. Es la misma limitación de tipos de documento
registrados que se describe en
Envío a través de PEPPOL.
Llama a retrieveSystem
para leer compliance.state:
TRANSMISSION_RECEPTION— el System puede enviar y recibir.TRANSMISSION_ONLY— el System solo puede enviar.
Enviar y recibir es el comportamiento por defecto, pero fiskaly recurre a un registro de solo envío si el registro en PEPPOL informa de un conflicto — normalmente porque el PEPPOL Participant Identifier de tu Taxpayer ya está registrado con otro proveedor. El System sigue siendo utilizable para enviar. Si esperabas recibir, ponte en contacto con el equipo de soporte de fiskaly en dev-support@fiskaly.com indicando el número de IVA del Taxpayer.
Recuperación de facturas recibidas
Sección titulada «Recuperación de facturas recibidas»Cada factura dirigida a tu Taxpayer se recibe y se almacena automáticamente como un Record — no hay webhook, así que consulta la API para detectar las nuevas:
- Llama a
listRecordsy filtra porE_INVOICE::RECEPTION. - Para cada Record nuevo, llama a
retrieveRecordconcompliance-artifactpara obtener el XML firmado.
listRecords devuelve los Records más recientes (limit es 10 por defecto, del
más reciente al más antiguo), así que lleva la cuenta de los que ya has
procesado.
Archivo
Sección titulada «Archivo»La legislación alemana exige conservar las facturas electrónicas durante 8 años en su formato electrónico original (§14b UStG). Esto se aplica tanto a las facturas enviadas como a las recibidas. fiskaly no archiva facturas electrónicas para Alemania, por lo que el archivo corresponde al Taxpayer.
Puede recuperar la factura electrónica generada de una factura enviada y el XML de una factura recibida.