---
title: "Structured Formats Import"
slug: "structured-formats-import"
updated: 2025-10-13T15:21:42Z
published: 2025-10-13T15:21:42Z
canonical: "knowledge-base.rossum.ai/structured-formats-import"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge-base.rossum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Structured Formats Import

Structured formats import allows for importing and processing of non-visual documents such as JSON or XML files. It not only correctly extracts the information from these files, but also renders a minimalistic PDF representation for easier manual reviews.

## Installation

> [!WARNING]
> ⚠️ WARNING ⚠️
> 
> The support for ingesting XML or JSON files needs to be enabled by Rossum team.

Structured formats import is a webhook maintained by Rossum. In order to use it, follow these steps:

1. Login to your Rossum account.
2. Navigate to **Extensions** → **My extensions**.
3. Click on **Create extension**.
4. Fill the following fields:
  1. Name: `Structured formats import`
  2. Trigger events: `Upload - Created`
  3. Extension type: `Webhook`
  4. URL (see below)
5. Click **Create the webhook**.
6. Fill `Configuration` field (see [Configuration examples](/help/docs/configuration-examples-1))
7. Assign an API token user

| Environment | Webhook URL |
| --- | --- |
| EU1 Ireland | [https://elis.task-manager.rossum-ext.app/api/v1/tasks/structured-formats-import](https://elis.task-manager.rossum-ext.app/api/v1/tasks/structured-formats-import) |
| EU2 Frankfurt | [https://shared-eu2.task-manager.rossum-ext.app/api/v1/tasks/structured-formats-import](https://shared-eu2.task-manager.rossum-ext.app/api/v1/tasks/structured-formats-import) |
| US east coast | [https://us.task-manager.rossum-ext.app/api/v1/tasks/structured-formats-import](https://us.task-manager.rossum-ext.app/api/v1/tasks/structured-formats-import) |
| Japan Tokyo | [https://shared-jp.task-manager.rossum-ext.app/api/v1/tasks/structured-formats-import](https://shared-jp.task-manager.rossum-ext.app/api/v1/tasks/structured-formats-import) |

## Basic usage

> [!NOTE]
> ℹ️ NOTE
> 
> The extension supports multiple configurations. Even when using a single configuration, make sure it's defined in an array named `configurations`.

```json
{
  // Various independent configurations that can be conditionally
  // triggered via `trigger_condition`:
  "configurations": [
    {
      "trigger_condition": {
        // supported values: "xml" and "json"
        "file_type": "xml"
      },

      // Fields to be extracted from the source file
      // and assigned to given datapoints:
      "fields": [
        {
          "schema_id": "recipient_name",

          // If many selectors are specified, they serve as a fallback list.
          // Selectors don't need to specify the root element (see sample XML below)
          "selectors": ["Header/Recipient/Name"]
        },
        ...
      ]
    }
  ]
}
```

Sample source file:

```plaintext
<Invoice>
  <Header>
    <Recipient>
      <Name>Hello world</Name>
    </Recipient>
  </Header>
</Invoice>
```

## Available configuration options

```json
{
  // Various independent configurations that can be conditionally triggered via `trigger_condition`:
  "configurations": [
    {
      "trigger_condition": {
        "file_type": "xml"
      },

      // Optional. Whether the original XML/JSON file should be split into smaller ones:
      "split_selectors": ["/RecordLabel/Productions/Production"],

      // Fields to be extracted from the source file and assigned to given datapoints:
      "fields": [
        {
          "schema_id": "document_id",

          // If many selectors are specified, they serve as a fallback list.
          "selectors": ["./Metadata/ID"]
        }
      ],

      // Optional specification of the original PDF file that should be extracted from the source
      // file (base64 encoded):
      "pdf_file": {
        "name_selectors": [
          "cac:AdditionalDocumentReference/cac:Attachment/cbc:EmbeddedDocumentBinaryObject/@filename"
        ],

        // Content should be base64 encoded:
        "content_selectors": [
          "cac:AdditionalDocumentReference/cac:Attachment/cbc:EmbeddedDocumentBinaryObject"
        ]
      }
    }
    // …
  ]
}
```

> [!WARNING]
> 💬 YOUR FEEDBACK MATTERS!
> 
> Help us keep this page accurate and useful. Select **Yes** or **No** below, then use the feedback form to propose a correction, ask for clarification, or request a new article.