Electronic Documents Batch Upload Guide

The /DocumentCreationBatches route in the ElectronicDocuments API enables customers to upload new documents to the electronic documents system, similar to the older B2B service documents method.

The documents are then made accessible to the user, both in Landsbankinn online bank and in other banks that use the shared documents system at RB (Reiknistofa bankanna).

To simplify processing and ensure correct document flow, it is recommended to submit data in PDF format.

Documents can be submitted either as a ZIP archive containing PDF files or as XML files.

If your company does not already have a document type registered at RB, or if you are unsure, please contact fyrirtaeki@landsbankinn.is. 

This document type will be linked to the sender company’s national ID (used as the SenderNationalId in the request body).

When submitting a batch:

  • If there are no obvious validation errors, the API will return 202 Accepted to confirm that the upload request has been received.
  • Cross-references to related documents can be included in the request body.
  • If the upload fails during processing for any reason, your company will be contacted with further information.

1. Submitting PDF Files in a ZIP Archive

When submitting PDF documents, a manifest.json file must be included in the ZIP archive. This file describes the metadata of each document.

Example: manifest.json

{
    "entries": [
        {
            "Statement": {
                "Acct": "19097914891503491419",
                "Date": "2025/01/29",
                "User1": "1503491419",
                "User3": "PDF",
                "User4": "190979148915034914192025012910011",
                "XKey": "10011"
            },
            "file": "1909791489_1503491419_20250129_10011.pdf"
        },
        {
            "Statement": {
                "Acct": "19097914891503491419",
                "Date": "2025/01/29",
                "User1": "1503491419",
                "User3": "PDF",
                "User4": "190979148915034914192025012910012",
                "XKey": "10012"
            },
            "file": "1909791489_1503491419_20250129_10012.pdf"
        }
    ]
}

Field Descriptions

  • Statement Acct: Sender national ID (kennitala) + recipient national ID (kennitala). Maximum 35 characters.
  • Date: Publication date (YYYY/MM/DD).
  • User1: Recipient national ID (kennitala).
  • User3: Style name. For PDFs, use "PDF".
  • User4: Composite value containing company national ID, recipient national ID, date, and XKey. Must be unique. Maximum 250 characters.
  • XKey: Running number (e.g. sequence number per day).
  • file: The name of the document file included in the ZIP.

⚠️ If the combination of Acct, Date, User1, and User4 is submitted more than once, the previous record will be overwritten.
To avoid overwriting, ensure that User4 is always unique.

2. Submitting XML Files

As an alternative to ZIP/PDF submission, documents can be uploaded as XML files.

Example: XML Document

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE XML-S SYSTEM "XML-S.dtd">
<XML-S>
  <Statement Acct="19097914891503491419001" Date="2025/09/23" >
    <?bgls.BlueGill.com User1=1503491419?>  <!-- Recipient national ID (kennitala) -->
    <?bgls.BlueGill.com User3=ARKTEST-001?> <!-- Stylesheet name-->
    <?bgls.BlueGill.com User4=1909791489150349141920241023001?>
    <Section Name="BODY" Occ="1">
      <Field Name="Message">This file is used to test XML uploads.</Field>
      <Field Name="YourName">Dummy ID's</Field>
    </Section>
  </Statement>
    <Statement Acct="19097914891503491419002" Date="2024/10/23" >
    <?bgls.BlueGill.com User1=1503491419?>  <!-- Recipient national ID (kennitala) -->
    <?bgls.BlueGill.com User3=ARKTEST-001?> <!-- Stylesheet name -->
    <?bgls.BlueGill.com User4=1909791489150349141920241023002?>
    <Section Name="BODY" Occ="1">
      <Field Name="Message">This file is used to test XML uploads.</Field>
      <Field Name="YourName">Dummy ID's</Field>
    </Section>
  </Statement>
</XML-S>

Rules for XML

  • All tags shown in the example must be present.
  • Content inside <Section Name="BODY"> is flexible and may be customized.

Field Descriptions

  • Statement Acct: Sender national ID (kennitala) + recipient national ID (kennitala). Maximum 35 characters.
  • Date: Publication date (YYYY/MM/DD).
  • XKey: Running number within each day.
  • DefinitionName: Legacy.
  • User1: Recipient national ID (kennitala).
  • User3: Stylesheet name (e.g., ARKTEST-001).
  • User4: Composite value (sender national ID + recipient national ID + date + XKey). Must be unique, max 250 characters.

⚠️ As with ZIP uploads, duplicate combinations of Acct, Date, User1, and User4 will overwrite previous records. Always ensure User4 is unique.

Special Character Restrictions in XML

The following characters cannot be used directly in XML and must be escaped using entity references:

  • < → &lt;
  • > → &gt;
  • ' → &apos;
  • " → &quot;
  • & → &amp;