Atlar · Schema

CreateDocumentRequest

CompanyFintechTreasuryPaymentsBankingCash ManagementFinancial OperationsERP Integration

Properties

Name	Type	Description
glEntityId	string	The Atlar general ledger entity id that this document is associated with.
type	object	The type of document.
amount	object	The amount of the document.
remainingAmount	object	The remaining (unapplied or unpaid) portion of the document´s total amount. For SOURCE documents, this indicates how much remains to be paid or settled. For example, an unpaid invoice shows the outsta
date	object	The document date (e.g. a due date for an invoice or a transaction date for a payment).
issueDate	object	The date the document was issued in the originating external system (e.g. the invoice issue date). Not necessarily the same as when the document was created (see vendorCreated).
description	string	The description of the document.
reference	string	The reference of the document.
references	object	The references of the document.
counterparty	object	Details about the counterparty (e.g. a customer or vendor).
voided	boolean	Whether the document is voided in the accounting system.
reconciliationMatchId	string	The reconciliation match that this document is associated with.
outgoingDocumentId	string	The Atlar outgoing document that originated this ERP document, when known.
glEntries	array	The general ledger entries for this document.
appliedDocuments	array	The sibling relationship between documents, the documents that are applied to this document (e.g. payments applied to an invoice and vice versa).
provenance	object	Metadata capturing the source and history of this document, including when it was created and its identifier in the originating external system.
vendorCreated	string	When the document was created in the originating external system.
vendorResourceUrl	string	The URL to the document in the originating external system, to help navigate to the document in the originating external system. This differs from the provenance URL, which is the endpoint URL from wh
currencyExchange	object	The currency exchange from the ledger entity's currency to the document's currency. Only present if the document's currency is different from the ledger entity's currency.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/atlar/main/json-schema/atlar-create-document-request-schema.json",
  "title": "CreateDocumentRequest",
  "x-generated": "2026-10-14",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/atlar-api-v2-openapi.yml#/components/schemas/CreateDocumentRequest",
  "type": "object",
  "properties": {
    "glEntityId": {
      "type": "string",
      "description": "The Atlar general ledger entity id that this document is associated with."
    },
    "type": {
      "$ref": "#/$defs/DocumentType",
      "description": "The type of document."
    },
    "amount": {
      "$ref": "#/$defs/MultiCurrencyAmountInput",
      "description": "The amount of the document."
    },
    "remainingAmount": {
      "$ref": "#/$defs/MultiCurrencyAmountInput",
      "description": "The remaining (unapplied or unpaid) portion of the document´s total amount.\nFor SOURCE documents, this indicates how much remains to be paid or settled.\nFor example, an unpaid invoice shows the outstanding amount; for a customer\npayment awaiting deposit, it reflects the undeposited value.\nFor INSTRUCTION documents, this field shows the portion of the payment that\nhas been applied to reduce the remaining amount of the linked SOURCE document.\n"
    },
    "date": {
      "$ref": "#/$defs/Date",
      "description": "The document date (e.g. a due date for an invoice or a transaction date for a payment)."
    },
    "issueDate": {
      "$ref": "#/$defs/Date",
      "description": "The date the document was issued in the originating external system (e.g. the invoice issue date). Not necessarily the same as when the document was created (see vendorCreated).",
      "x-go-type-skip-optional-pointer": true
    },
    "description": {
      "type": "string",
      "description": "The description of the document.",
      "minLength": 1,
      "maxLength": 255
    },
    "reference": {
      "type": "string",
      "description": "The reference of the document.",
      "minLength": 1,
      "maxLength": 255
    },
    "references": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "The references of the document."
    },
    "counterparty": {
      "$ref": "#/$defs/AccountingCounterparty",
      "description": "Details about the counterparty (e.g. a customer or vendor)."
    },
    "voided": {
      "type": "boolean",
      "description": "Whether the document is voided in the accounting system."
    },
    "reconciliationMatchId": {
      "type": "string",
      "description": "The reconciliation match that this document is associated with."
    },
    "outgoingDocumentId": {
      "type": "string",
      "description": "The Atlar outgoing document that originated this ERP document, when known."
    },
    "glEntries": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CreateGLEntryRequest"
      },
      "description": "The general ledger entries for this document.",
      "minItems": 1
    },
    "appliedDocuments": {
      "description": "The sibling relationship between documents, the documents that are applied to this document (e.g. payments applied to an invoice and vice versa).",
      "x-omitempty": true,
      "type": "array",
      "items": {
        "$ref": "#/$defs/CreateAppliedDocumentRequest"
      }
    },
    "provenance": {
      "description": "Metadata capturing the source and history of this document, including when it was created and its identifier in the originating external system.",
      "$ref": "#/$defs/DocumentProvenance"
    },
    "vendorCreated": {
      "type": "string",
      "format": "date-time",
      "description": "When the document was created in the originating external system."
    },
    "vendorResourceUrl": {
      "type": "string",
      "description": "The URL to the document in the originating external system, to help navigate to the document in the originating external system.\nThis differs from the provenance URL, which is the endpoint URL from where it was fetched from.\n"
    },
    "currencyExchange": {
      "description": "The currency exchange from the ledger entity's currency to the document's currency. Only present if the document's currency is different from the ledger entity's currency.",
      "$ref": "#/$defs/CurrencyExchange"
    }
  },
  "required": [
    "glEntityId",
    "type",
    "amount",
    "date",
    "description",
    "references",
    "voided",
    "glEntries",
    "provenance",
    "vendorCreated"
  ],
  "$defs": {
    "AccountingCounterparty": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "type": {
          "$ref": "#/$defs/CounterpartyType"
        },
        "erpId": {
          "description": "The ID of the counterparty in the ERP system.",
          "type": "string"
        }
      },
      "required": [
        "name",
        "type",
        "erpId"
      ]
    },
    "AmountInput": {
      "oneOf": [
        {
          "$ref": "#/$defs/AmountIntegerValueInput"
        },
        {
          "$ref": "#/$defs/AmountStringValueInput"
        }
      ]
    },
    "AmountIntegerValueInput": {
      "type": "object",
      "properties": {
        "currency": {
          "$ref": "#/$defs/CurrencyCode"
        },
        "value": {
          "description": "The amount value as an integer (int64) represented in currency minor units (e.g. 15.02 EUR is represented as the value 1502).",
          "type": "integer",
          "format": "int64"
        }
      },
      "required": [
        "currency",
        "value"
      ]
    },
    "AmountStringValueInput": {
      "type": "object",
      "properties": {
        "currency": {
          "$ref": "#/$defs/CurrencyCode"
        },
        "stringValue": {
          "description": "A string representation of the amount value, which will be a decimal number if the currency has decimals. The number is not formatted for display purposes (e.g. with thousand separator) and always contains the dot `.` character as decimal separator.",
          "type": "string"
        }
      },
      "required": [
        "currency",
        "stringValue"
      ]
    },
    "ContentType": {
      "type": "string",
      "description": "The content type of the data.",
      "enum": [
        "application/vnd.iso20022.pain.001.001.03+xml",
        "application/vnd.iso20022.pain.001.001.03.ch.02+xml",
        "application/vnd.iso20022.pain.001.001.09+xml",
        "application/vnd.iso20022.pain.001.001.09.ch.03+xml",
        "application/vnd.iso20022.pain.002.001.03+xml",
        "application/vnd.iso20022.pain.002.001.10+xml",
        "application/vnd.iso20022.pain.008.001.02+xml",
        "application/vnd.iso20022.pain.008.001.02.ch.03+xml",
        "application/vnd.iso20022.pain.008.001.03+xml",
        "application/vnd.iso20022.pain.008.001.08+xml",
        "application/vnd.iso20022.camt.052.001.02+xml",
        "application/vnd.iso20022.camt.052.001.03+xml",
        "application/vnd.iso20022.camt.052.001.04+xml",
        "application/vnd.iso20022.camt.052.001.08+xml",
        "application/vnd.iso20022.camt.053.001.02+xml",
        "application/vnd.iso20022.camt.053.001.03+xml",
        "application/vnd.iso20022.camt.053.001.04+xml",
        "application/vnd.iso20022.camt.053.001.08+xml",
        "application/vnd.iso20022.camt.053.001.10+xml",
        "application/vnd.iso20022.camt.053.001.11+xml",
        "application/vnd.iso20022.camt.054.001.02+xml",
        "application/vnd.iso20022.pacs.002.001.10+xml",
        "application/vnd.iso20022.pacs.008.001.02+xml",
        "application/vnd.iso20022.pacs.008.001.08+xml",
        "application/vnd.swift.mt.101",
        "application/vnd.swift.mt.103",
        "application/vnd.swift.mt.900",
        "application/vnd.swift.mt.940",
        "application/vnd.swift.mt.942",
        "application/vnd.bai.bai2",
        "application/vnd.bgc.autogiro.payee",
        "application/vnd.bgc.autogiro.payments.rejected",
        "application/vnd.bgc.autogiro.payments.spec",
        "application/vnd.bgc.autogiro.mandate",
        "application/vnd.bgc.payins.bgmax",
        "application/vnd.nacha.ach",
        "application/vnd.atlar.testbank.mandate+json",
        "application/vnd.atlar.testbank.transaction+json",
        "application/vnd.atlar.connectivity.proprietary",
        "application/vnd.atlar.connectivity.proprietary+json",
        "application/vnd.atlar.connectivity.proprietary+xml",
        "application/vnd.atlar.connectivity.proprietary+csv",
        "application/vnd.atlar.connectivity.v2.investment-statement+json",
        "application/vnd.atlar.connectivity.v2.accounting-statement+json",
        "application/vnd.atlar.connectivity.v2.fx-rate-statement+json",
        "application/vnd.atlar.connectivity.v2.benchmark-rate-statement+json",
        "application/vnd.atlar.connectivity.v2.statement+json",
        "application/vnd.atlar.connectivity.v2.statement+csv",
        "application/vnd.deutsche.wealth-online+csv",
        "application/vnd.m2.m006.m001+xml",
        "application/vnd.m2.m006.m005+xml",
        "application/vnd.ebics.htd.v30+xml",
        "application/vnd.ebics.hac.v25+xml",
        "application/vnd.ebics.hac.v30+xml",
        "application/vnd.jpm.daily-feed+zip",
        "application/vnd.jpm.morgan-money.balance-report+csv",
        "application/vnd.jpm.morgan-money.transaction-report+csv",
        "application/vnd.jpm.soci.holdings+csv",
        "application/vnd.jpm.soci.transactions+csv",
        "application/vnd.nordea.investments.abasec.pos+csv",
        "application/vnd.nordea.investments.abasec.tra+csv",
        "application/vnd.ms-excel",
        "application/x-ofx",
        "application/json",
        "application/zip",
        "application/pdf",
        "text/plain",
        "text/csv",
        "application/vnd.edi.820",
        "application/vnd.edi.824",
        "application/vnd.edi.997"
      ]
    },
    "CounterpartyType": {
      "type": "string",
      "enum": [
        "VENDOR",
        "CUSTOMER",
        "EMPLOYEE",
        "GL_ENTITY"
      ]
    },
    "CreateAppliedDocumentRequest": {
      "type": "object",
      "properties": {
        "amount": {
          "$ref": "#/$defs/AmountInput"
        },
        "targetDocumentId": {
          "type": "string",
          "description": "The ID of the document which this aims to net out (e.g. payments applied to an invoice)."
        },
        "targetDocumentType": {
          "$ref": "#/$defs/DocumentType",
          "description": "The type of the target document."
        },
        "targetDocumentExternalId": {
          "type": "string",
          "description": "The ID of the target document in the external ERP system."
        },
        "date": {
          "$ref": "#/$defs/Date",
          "description": "The date of the document application.",
          "x-go-type-skip-optional-pointer": true
        }
      },
      "required": [
        "amount",
        "targetDocumentType",
        "targetDocumentExternalId"
      ]
    },
    "CreateGLEntryRequest": {
      "type": "object",
      "properties": {
        "vendorId": {
          "type": "string"
        },
        "glAccountId": {
          "type": "string"
        },
        "vendorBankAccountId": {
          "$ref": "#/$defs/ResourceID",
          "description": "Optional vendor bank account this entry affects. Only set for entries\nposting against a bank GL account.\n",
          "x-go-type-skip-optional-pointer": true
        },
        "amount": {
          "$ref": "#/$defs/GLEntryAmountInput"
        },
        "type": {
          "$ref": "#/$defs/GLEntryType"
        }
      },
      "required": [
        "vendorId",
        "glAccountId",
        "amount",
        "type"
      ]
    },
    "CurrencyCode": {
      "type": "string",
      "description": "Three-letter ISO 4217 currency code.",
      "minLength": 3,
      "maxLength": 3,
      "pattern": "^[A-Z]{3,3}$"
    },
    "CurrencyExchange": {
      "type": "object",
      "properties": {
        "exchangeRate": {
          "type": "string",
          "description": "The exchange rate that was reported by the bank. Atlar will not try to calculate this in cases where the information isn't present.",
          "readOnly": true
        },
        "sourceCurrency": {
          "description": "The currency from which the amount was converted.",
          "$ref": "#/$defs/CurrencyCode",
          "readOnly": true
        },
        "targetCurrency": {
          "description": "The currency to which the amount was converted.",
          "$ref": "#/$defs/CurrencyCode",
          "readOnly": true
        },
        "unitCurrency": {
          "description": "One unit of this currency multiplied by the exchange rate will equal the target currency.",
          "$ref": "#/$defs/CurrencyCode",
          "readOnly": true
        }
      },
      "required": [
        "sourceCurrency",
        "exchangeRate"
      ]
    },
    "Date": {
      "type": "string",
      "format": "date",
      "description": "`full-date` notation as defined by [RFC 3339, section 5.6](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), for example, `2017-07-21`."
    },
    "DocumentProvenance": {
      "type": "object",
      "properties": {
        "vendorId": {
          "type": "string"
        },
        "vendorTimestamp": {
          "type": "string",
          "format": "date-time"
        },
        "resource": {
          "type": "object",
          "oneOf": [
            {
              "$ref": "#/$defs/DocumentProvenanceResourceFile"
            },
            {
              "$ref": "#/$defs/DocumentProvenanceResourceApi"
            }
          ]
        }
      },
      "required": [
        "vendorId",
        "vendorTimestamp",
        "resource"
      ]
    },
    "DocumentProvenanceResourceApi": {
      "type": "object",
      "properties": {
        "type": {
          "$ref": "#/$defs/DocumentProvenanceResourceType"
        },
        "url": {
          "type": "string",
          "description": "The URL of the API resource."
        },
        "contentType": {
          "$ref": "#/$defs/ContentType"
        },
        "timestamp": {
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "type",
        "url",
        "contentType",
        "timestamp"
      ]
    },
    "DocumentProvenanceResourceFile": {
      "type": "object",
      "properties": {
        "type": {
          "$ref": "#/$defs/DocumentProvenanceResourceType"
        },
        "name": {
          "type": "string",
          "description": "The name of the file."
        },
        "contentType": {
          "$ref": "#/$defs/ContentType"
        },
        "timestamp": {
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "type",
        "name",
        "contentType",
        "timestamp"
      ]
    },
    "DocumentProvenanceResourceType": {
      "type": "string",
      "enum": [
        "FILE",
        "API"
      ]
    },
    "DocumentType": {
      "type": "string",
      "description": "The type of accounting document from the ERP system.",
      "enum": [
        "JOURNAL_ENTRY",
        "PAYMENT",
        "CREDIT_MEMO",
        "INVOICE",
        "PURCHASE_ORDER",
        "TRANSFER",
        "EXPENSE_REPORT"
      ]
    },
    "GLEntryAmountInput": {
      "type": "object",
      "properties": {
        "baseAmount": {
          "description": "The amount in the base currency of the GL Entity.",
          "$ref": "#/$defs/AmountInput"
        },
        "instructedAmount": {
          "description": "The amount in the instruction currency of the document. Optional for GL entries that do not touch a bank account.",
          "$ref": "#/$defs/AmountInput"
        }
      },
      "required": [
        "baseAmount"
      ]
    },
    "GLEntryType": {
      "type": "string",
      "enum": [
        "DEBIT",
        "CREDIT"
      ]
    },
    "MultiCurrencyAmountInput": {
      "type": "object",
      "properties": {
        "baseAmount": {
          "description": "The amount in the base currency of the GL Entity.",
          "$ref": "#/$defs/AmountInput"
        },
        "instructedAmount": {
          "description": "The amount in the instruction currency of the document.",
          "$ref": "#/$defs/AmountInput"
        }
      },
      "required": [
        "baseAmount",
        "instructedAmount"
      ]
    },
    "ResourceID": {
      "type": "string",
      "description": "Unique resource identifier.",
      "minLength": 32,
      "maxLength": 64
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/atlar-create-document-request"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.