Transform API: convertir el formato de un documento

Convertir documentos entre formatos de facturación electrónica sin enviarlos a través del endpoint Transform.

La Transform API le permite convertir un documento de un formato de facturación electrónica a otro, sin enviarlo ni almacenarlo en la PSB. Resulta útil para probar transformaciones antes de pasar a producción, o para convertir manualmente documentos destinados a socios que requieren un formato específico.

Endpoint
POST /api/v1/generic/transform?targetFormat={URN}

Envíe el documento fuente en el body con el content-type application/xml. El parámetro targetFormat contiene el URN del formato de destino deseado.

¿Cómo funciona?
  1. Upload: envíe el documento XML al endpoint con el formato de destino deseado
  2. Detección: la PSB detecta automáticamente el formato de origen basándose en el contenido XML
  3. Transformación: el documento se convierte al formato de destino especificado
  4. Respuesta: el documento convertido se devuelve directamente como XML

Si la detección automática del formato de origen no tiene éxito, puede especificarlo explícitamente mediante el parámetro sourceFormat:

POST /api/v1/generic/transform?targetFormat={URN}&sourceFormat={URN}
Ejemplos

De NLCIUS a Peppol BIS Billing V3:

POST /api/v1/generic/transform?targetFormat=urn:cen.eu:en16931:2017%23compliant%23urn:fdc:peppol.eu:2017:poacc:billing:3.0

De UBL a CII (Cross Industry Invoice):

POST /api/v1/generic/transform?targetFormat=urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100

Atención: Codifique los valores URN en los parámetros de consulta. El carácter # debe codificarse como %23.

Transformaciones compatibles

No todas las transformaciones están disponibles. La PSB soporta las mismas transformaciones que al enviar y recibir documentos. Las transformaciones más habituales incluyen conversiones entre UBL y CII, y entre diferentes variantes regionales (NLCIUS, XRechnung, Factur-X).

Las transformaciones exactas disponibles dependen de la tabla de transformación actual de la PSB. Consulte psb.econnect.eu para obtener la información más actualizada.

Gestión de errores
Código de estadoSignificado200 OKTransformación exitosa, documento convertido en el body de la respuesta400 Bad RequestFormato de origen no reconocido o transformación no soportada422 UnprocessableEl documento no se puede convertir (datos faltantes o no válidos)
¿Cuándo utilizarla?
  • Pruebas antes de producción: verifique que sus documentos se transforman correctamente antes de activar la integración en producción
  • Conversión manual: convierta documentos para socios que requieren otro formato
  • Comparación: genere el mismo documento en múltiples formatos para verificar el mapping

Técnico: La Transform API no almacena el documento ni activa webhooks. El documento se transforma en memoria y se devuelve directamente.


Consulte la especificación API completa en psb.econnect.eu para todos los formatos compatibles y valores URN.

Probar en la API

Relacionado
Artículos relacionados