# Transform API v1-beta

The transform endpoint allows you to convert documents from one format to another. This is useful when working with various document standards or when integrating with partners that require specific formats.

# Transform

Upload a file to POST /api/v1-beta/generic/transform1 using a multipart body or xml body upload.

We will detect the source format if possible, if we cannot detect the source format the sourceFormat needs to be supplied as a query parameter. The targetFormat is a required query parameter, this specifies the format you want the document to be transformed into. To transform a document to a Peppol BIS V3 Billing use:

POST /api/v1-beta/generic/transform?targetFormat=urn%3Aoasis%3Anames%3Aspecification%3Aubl%3Aschema%3Axsd%3AInvoice-2%3A%3AInvoice%23%23urn%3Acen.eu%3Aen16931%3A2017%23compliant%23urn%3Afdc%3Apeppol.eu%3A2017%3Apoacc%3Abilling%3A3.0%3A%3A2.1

# Request

POST /api/v1-beta/generic/transform?targetFormat=urn%3Aoasis%3Anames%3Aspecification%3Aubl%3Aschema%3Axsd%3AInvoice-2%3A%3AInvoice%23%23urn%3Acen.eu%3Aen16931%3A2017%23compliant%23urn%3Afdc%3Apeppol.eu%3A2017%3Apoacc%3Abilling%3A3.0%3A%3A2.1 HTTP/1.1
Authorization: Bearer <token>
Content-Type: application/xml

<ubl:Invoice xmlns:ubl="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:ec="urn:econnect.eu:profile:invoice:attention:ver1.0" xmlns:ext="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2">
	<cbc:UBLVersionID>2.1</cbc:UBLVersionID>
	<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0</cbc:CustomizationID>
	<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
	<cbc:ID>123456789</cbc:ID>
	<cbc:IssueDate>2025-03-25</cbc:IssueDate>
	<cbc:DueDate>2025-04-24</cbc:DueDate>
	<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
    ...
</ubl:Invoice>

# Response

<p1:Invoice xmlns:p1="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
  <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
  <cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
  <cbc:ID>123456789</cbc:ID>
  <cbc:IssueDate>2025-03-25</cbc:IssueDate>
  <cbc:DueDate>2025-04-24</cbc:DueDate>
  <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  ...
</p1:Invoice>

Note: This endpoint supports transformation of all standard document types such as invoices, orders, and more. Not all transformations are supported. It is possible that the requested transformation is not supported.

For more detailed information, refer to the Transform API Swagger UI.

← Validate Peppol →