NAV Navbar
http

Introduction

Basware Network REST API is your doorway to interacting with a network of over a million business users all over the globe. With our REST API, you can:

You will find detailed descriptions of each of our APIs in this section along with code examples. To get step by step instructions on some of the most commonly used features, have a look at our Guides section.

Business document flows

Sending invoices

The following diagram shows how to send invoices with attachments. Note that the similar flow also applies to credit notes.

Send invoices flow

Receiving invoices

The following diagram shows how to receive invoices. Note that the similar flow also applies to credit notes.

Receive invoices flow

Confirming received documents

Delivery of the received invoices and other business document can be confirmed.

If you are part of the delivery process (typically an operator on the behalf of the customer), you must send one of the following notifications:

In addition, you can send business confirmation of the received business documents. Business confirmation has to be agreed upon with the sender. The following notifications can be sent for business confirmations:

The following diagram shows how to confirm received business documents.

Accept or reject received business documents

Upload invoices to Basware value added services

The following diagram shows you how you can upload invoices to Basware Network. You only need to upload invoices in the following scenario:

Upload invoices to Basware Network flow

Topics

Default formats

JSON is the default data format used by Basware Network REST APIs.

Basware Network REST APIs use UTF-8 character encoding by default. If other encodings are must be used as part of transfers, they will be wrapped in a Base64 encoded data fields.

HTTP headers (both HTTP and MIME) must only contain US-ASCII characters. This affects also the file names which are sent in the headers when uploading file using File API.

Authentication

Basware Network REST API uses basic HTTP authentication to authenticate API clients.

All communication is secured by using the HTTPS protocol (HTTP over SSL). You must make all API requests over HTTPS. API requests made without authentication will fail.

Unique identifiers

A universally unique identifier (UUID) is commonly used in REST API interfaces for identifiers.

For example, each business document has a unique identifier (Basware Unique Message Identifier, BUMID) which must follow the UUID format. BUMID must be given in lowercase format.

Similarly, each request sent to REST API has a unique request identifier X-BW-REQUEST-ID which uses the UUID format.

Document routing

When you send business documents using the Basware Network REST API, you must identify the recipient’s address. The recipient's electronic delivery address is called an endpoint.

Note that the recipient chooses which endpoint(s) they want to use to receive business documents. Large corporations that have multiple automated workflows may use different endpoints to identify the workflow.

Endpoints are published in Basware Network's business directory. The business directory is accessible to registered Basware Network users. The business directory extends to some interoperators.

Recipient endpoints

An endpoint consists of the following fields:

The following rules apply when determining the endpoint:

The endpoint's scheme identifiers are grouped to the following categories:

The following table lists the most common endpoints’ scheme identifiers:

Endpoint schemeId Description Example of endpoint
Recommended, globally unique scheme identifiers
“ISO6523-ACTORID-UPIS” Electronic eInvoicing address which follows country specific format. "003701018798"
“ISO6523-ACTORID-UPIS” PEPPOL endpoint which includes four-digit identifier followed by colon : and the actual endpoint. "0088:5060407170008"
"VAT" European VAT number. For more information about VAT, see European country specific VAT number format (see especially question Q11) and VAT format validator. "FI12345678"
"EMAIL-RFC2822" Email address "[email protected]"
Commercial and common scheme identifiers
"IBAN" International Bank Account Number, without space characters "BE11143061182348"
"DUNS" The Data Universal Numbering System, (DUNS or D-U-N-S) number. The value must contain 9 digits. "123456789"
"GLN" The Global Location Number (GS1) is a unique identifier for locations. The value must contain 13 digits. "1568784515459"
Local tax identifiers and national trade registry identifiers (few selected ones below)
"FI:ORGNR" "FR:ORGNR" etc.  National register number. The scheme identifier consists of a two-letter country identifier (ISO-3166-1 alpha 2) and 'ORGNR'. This endpoint value must contain numbers only.  "12345678" (Finland)

Note! There are non-EU countries that have VAT numbers. For Norway, the schemeId is NO:VAT.

Party identifications

Each party in the business document needs to have a valid party identification. Party refers for example to the following elements in the business document:

The following table lists examples for local tax identifiers and national trade registry identifiers:

schemeId Common name Common format Registry holder + registry links
FI:ORGNR Y-tunnus 1234567-8 Agency: PRH – YTJ / PRH / Virre-tietopalvelu
DE:ORGNR Steuernummer 123/123/12345 Agency: Regional “Bundesland” specific tax office, each of the 16 states in Germany have their own.
SE:ORGNR Organisationsnummer 1234567890 Agency: Bolagsverket
FR:ORGNR SIREN numéro 123 456 789 Agency: Insee
AT:ORGNR Firmenbuchnummer 123456 x Agency: Das Firmenbuch
BE:ORGNR Ondernemingsnummer 0123456789 Agency: Kruispuntbank van Ondernemingen (KBO) - Banque-Carrefour des Entreprises (BCE)
DK:ORGNR CVR 12345678 Agency: Det Centrale Virksomhedsregister (CVR)
NL:ORGNR KvK Nummer 12345678 Agency: Kamer van Koophandel (KvK). Search KvK numbers (in Dutch)
NO:ORGNR Organisasjonsnummer 123456789 Agency: Enhetsregisteret ved Brønnøysundregistrene
NO:VAT VAT number in Norway NO123456789MVA
TIN Tax Identification Number in the United States, ITIN (Individual Taxpayer Identification Number) with optional 'US' country prefix 956-87-8456 US956-87-8456 Agency: Internal Revenue Service (IRS)

Note! There is a separate trade registry in Germany, but Basware has chosen to use the tax number, which is different from the trade registry number. It’s more common to use the Steuernummer than the trade registry number, especially in the context of invoicing.

This is an explicit choice that Basware has made, but it may not be self explanatory by referring to a “local registry number” alone. Note that the common format varies between the German states, even though all call it a Steuernummer. Steuernummer is clearly understood across Germany.

Release notes

Release notes

Invoice API v3 - Summary of changes

API v1 and API v2 continues to be available for use.

Invoice API v3 - Structural changes

Invoice API v3 handles also credit note as the document type

Invoice API v3 handles now both invoice and credit note document types. Invoice API V2 and CreditNote V2 are combined into one Invoice API V3. This means that a separate CreditNote API is no longer required for API v3.

The field documentType has been added as a mandatory element to Invoice API. The valid values for documentType are:

Field names changed from creditNoteLines in CreditNote API v2 to documentLines in Invoice API v3

The creditNoteLines field in the data element in CreditNote v2 has been renamed to documentLines in v3. These changes affect the following elements:

Field name changes for description in document lines

The array 'description' in documentLines has been changed from array of strings to fully qualified JSON element. This allows easier handling of description field as normal JSON field. This change affects the following element:

Field name changes in allowanceCharges

The changeIndicator field in the allowanceCharges element in v2 has been renamed to chargeIndicator in v3 to correct the spelling. These changes affect the following elements:

Invoice API v3 - New features

New document type PaymentReceipt supported for Mexican invoicing

New optional partyLegalEntities array for party element in Invoice

Added the following optional fields to element to identify legal entity for the party:

The new element partyLegalEntities is available in the following party elements:

New optional deliveryNoteReference element in Invoice

Added the following optional fields to data.delivery element:

New optional supplierAssignedAccountId element to accountingCustomerParty in Invoice

Added the following optional field to accountingCustomerParty element:

New optional customerAssignedAccountId element to accountingCustomerParty and accountingSupplierParty in Invoice

Added the following optional field to accountingCustomerParty and accountingSupplierParty elements:

New optional orderReference.issueDate element in Invoice

Added the following optional field to orderReference element:

New optional invoicePeriod element in Invoice

Added the following invoicePeriod element:

New optional taxExchangeRate element in Invoice

Added the following taxExchangeRate element:

New optional roundingAmount element to taxTotal in Invoice

Added the following roundingAmount element:

New optional note element in party elements in Invoice

Added the following note to party elements:

New optional note element to documentLines in Invoice

Added the following optional field to documentLines element:

New optional promisedDeliveryPeriod element to documentLines in Invoice

Added optional promisedDeliveryPeriod element to documentLines.delivery element:

New optional buyersItem element to documentLines in Invoice

Added the following optional fields to documentLines element:

New optional additionalItemProperties array element to documentLines in Invoice

Added the following optional fields to documentLines element:

New optional deliveryAddress element to documentLines in Invoice

Added the following optional element to documentLines element:

The deliveryAddress element includes all the same fields as data.<party>.address element, for example:

New optional taxCategories element to allowanceCharges in Invoice

Added the following optional fields to data.allowanceCharges element:

Added the following optional fields to documentLines.allowanceCharges element:

API v2 - Summary of changes

API v2 continues to be available for use. The documentation can be accessed from API v2 Reference.

API v2 for Invoice and Credit Note API - Structural changes

The field documentCurrencyCode changed from optional to mandatory in Invoice and Credit Note

Field name changed for partyIdentifications in Invoice and Credit Note

The partyIdentification array field in the party element in v1 has been renamed to partyIdentifications in v2 to better reflect the array content. These changes affect the following elements:

Field names changed from singular form to plural form in Invoice and Credit Note

The following array fields file line items in v1 has been renamed in v2 to better reflect the array content. These changes affect the following elements:

Similar renaming has been done for tax total elements:

Similar renaming has been done for financial account elements:

Field name changed for contractDocumentReference in Invoice and Credit Note

The contractDocumentReference field in the data element in v1 has been renamed to contractDocumentReferences in v2 to support multiple references and changed to an array. These changes affect the following element:

Field name changed for externalDocumentIdentifier in Invoice and Credit Note

Invoice identifier field provided by invoice issuer has been renamed:

Content changed for allowanceCharges in Invoice and Credit Note

The allowanceCharge field in v1 has been changed to allowanceCharges array in v2 to better reflect the array content. The fields in allowanceCharges are also changed to allow different types of allowance charges. These changes affect the following elements:

New 'processingPreference' element in Invoice and Credit Note

Added endpoint outside "data" to new "processingPreference" element (applied to POST methods only)

Note! Endpoint still exists for accountingCustomerParty for backwards compatilibity reasons. It is still recommended to provide endpoint in `accountingCustomerParty element.

More details about the endpoint values are available in Topics / Recipient endpoints.

Field deliveryChannelPreference changed to printingPreference

Changed the field deliveryChannelPreference to processingPreference

The values for printingPreference are the following:

Field serviceProviderId changed to operator

Changed the intermediate service provider field serviceProviderId to operator

API v2 for Invoice and Credit Note API - New features

New optional buyerCustomerParty and sellerSupplierParty elements in Invoice and CreditNote

Added the following optional fields to have more party elements for business document:

New optional taxCategory element in Invoice and Credit Note

Added optional element data.taxSubtotals.taxCategory. This element has been added to both data element and line items:

New optional addressLine3 element in Invoice and Credit Note

Added optional field addressLine3 to postalAddress element in the party:

New optional isIssuedAgainstOrder element in Invoice and Credit Note

New optional customFields element in Invoice and Credit Note

Custom fields will have only effect if both the sending and receiving parties agree on the specific custom field names. Basware must be notified beforehand about the custom field usage.

New optional paymentReferenceMessage element in Invoice and Credit Note

Remove 'internalId' and 'amountUninvoiced' fields from Invoice and Credit Note

Remove billingReference from Invoice

Remove version from Invoice and Credit Note

GET /invoices and /creditNotes returns origin in the response

GET /invoices and /creditNotes returns bumId in the response

Upload invoices feature for Invoice

API v2 for File

Support for base64 encoding has been added to File API

File API support by default binary upload and download. Support for base64 has been added to both File API v1 and File API v2.

base64 in POST method

base64 in GET method

File API returns response header fields

2016-09-21 New fields added to Invoices and Credit Notes v1

New fields to postalAddress in Invoice and Credit Note

New fields to paymentMeans in Invoice and Credit Note

New fields to paymentIdentifier in Invoice and Credit Note

2016-09-21 API for Notifications v1.1 released

GET /notifications

POST /notifications

API versioning

Basware Network API has two types of versions

Your application using Basware Network API should be flexible enough to handle backwards compatible changes:

Major version

The endpoint for major version has the format https://api.basware.com/v1.

Major version can include one or more of the following changes:

Minor version

The endpoint for minor version has the format like https://api.basware.com/v1.1.

You can update to higher minor versions without code changes as long as your API usage can handle the mappings. There is no mandatory requirement to update to the higher minor version.

Minor version can include one or more of the following changes:

Error codes

Basware Network REST API uses HTTP response codes to indicate the success or the failure of an API request. In general, REST API returns the following HTTP response codes:

In addition, the response may include additional details about the error situation. The following fields will appear in the error response:

Error response type indicates the type of the error situation:

Business error codes

Type Code Action to solve the error situation
BUSINESS Error.001.0001 Receiver organization does not exist in Basware Network, or registration is not available for receiver organization. No action needed from API caller. Basware Support will take action to solve the issue.
BUSINESS Error.001.0012 The API client requests a service which requires that the service is enabled in Basware Network. For example, in order to use Notification API, notifications must be enabled in Basware Network.

Validation error codes

Type Code Action to solve the error situation
VALIDATION Error.003.0001 The API client requests a business document using a BUMID (business document identifier) that cannot be found from Basware Network. Verify that BUMID references a valid business document.
VALIDATION Error.003.0020 The file type of an attachment that the API client has sent is invalid. Valid file type for attachments are: 'imageFile', 'attachmentFile' and 'dataFile'. Verify that a valid file type is used in the REST API request.
VALIDATION Error.003.0038 The API client requests to create a new business document using a BUMID (business document identifier) that already exists. Verify that the BUMID is unique.
VALIDATION Error.004.0002 Required field is missing from the request sent by the API client, or a field in the request does not match the expected pattern. For example, a date is given in a false format. Verify that a valid request format is used in the REST API request.
VALIDATION Error.004.0003 The format of the BUMID that the API consumer has given is invalid. The supported pattern of the BUMID is: [0-9a-f]{8}- [0-9a-f]{4}-[1-5][0-9a-f] {3}-[89ab][0-9a-f]{3}- [0-9a-f]{12}. Verify that a valid BUMID is referenced in the REST API request.
VALIDATION Error.004.0004 The request that the API client has sent is not in valid JSON format, or a required field like X-BW-REQUEST-ID has incorrect format or is missing from the request. Verify that a valid request format is used in the REST API request.
VALIDATION Error.004.0005 The API client is trying to upload an unsupported file type. Basware Network supports the following file types: CSV, DOC, DOCX, HTM, HTML, JPEG, JPG, ODT, PDF, PNG, PPT, PPTX, RTF, TIF, TIFF, TXT, XLS, XLSX, XML, ZIP. Verify that a valid file type is used in the REST API request.
VALIDATION Error.004.0012 The API client is trying to upload a too large a file to Basware Network.
VALIDATION Error.004.0013 Party identification is not valid. Verify that scheme identifier is valid and the actual identifier follows the pattern expected by the scheme.
VALIDATION Error.004.0014 IBAN format is not valid. Verify that the content is valid and follows the expected pattern.

Technical error codes

Type Code Action to solve the error situation
TECHNICAL Error.001.0006 Basware Network has encountered an unexpected system error. No action needed from API caller. Basware Support will take action to solve the issue.
TECHNICAL Error.001.0010 Basware Network has encountered a technical error. No action needed from API caller. Basware Support will take action to solve the issue.
TECHNICAL Error.003.0032 The API client tries to download or upload a business document attachment, but the operation fails due to a technical error on the Basware Network side. No action needed from API caller. Basware Support will take action to solve the issue.

Security error codes

Type Code Action to solve the error situation
SECURITY Error.002.0004 The API client tries to upload a business document attachment, but the operation fails due to a security violation. For example, the attachment may contain a virus. Make sure that the contents of the business document attachment meets the security requirements.

Notification details

Basware Network communicates changes in business documents' statuses and possible errors related to business document delivery using notifications. You can receive notification from Basware Network using the Notification API.

The responseCode field tells you the the delivery status of a business document:

The actionCode field provides you with more detailed information about a business document's processing status. Notification is a combination of responseCode and actionCode fields.

The following tables describe the cases in which Basware Network will post a notification posted to you.

Clients that send business documents

The following table includes notifications which clients that send business documents can fetch.

Response Code Action Code The reason behind the action code
TechnicalAccept Delivered The business document has been delivered to the recipient.

This is a final status with a time reservation; some interoperability channels may return a rejection after several days.
TechnicalAccept ReceivedForProcessing Basware Network has received the business document for processing.

This is a temporary status.
TechnicalInformation DeliveryDelayed A temporary delivery failure has occurred. Basware Network will automatically retry the delivery. No action is required from your side.

This is a temporary status.
TechnicalReject Undelivered The business document cannot be delivered to the recipient.

This is a final status.
TechnicalReject InvalidContent The business document has been rejected because its content invalid. This can be caused by, for example, if the bank reference number user on the business document is in invalid format. This action code is also used if the service encounters PEPPOL validation errors.
BusinessAccept DocumentAccepted The recipient has accepted the business document.

Note: This notification applies to invoices and credit notes.
BusinessReject DocumentRejected The recipient has rejected the business document.

Note: This notification applies to invoices and credit notes.

Clients that receive business documents

The following table includes notifications which clients that receive business documents can fetch.

Response Code Action Code The reason behind the action code Can be sent by API client?
TechnicalInformation Received The recipient has received the business document. No
TechnicalAccept Delivered The recipient has received the business document, and confirmed the receipt. This notification can be sent only if the recipient is part of the delivery process and needs to provide additional details. Yes
TechnicalReject Undelivered The recipient has received the business document, and rejected the business document. This notification can be sent if recipient is part of the delivery process. Yes
TechnicalReject InvalidContent The business document has been rejected because its content invalid. This can be caused by, for example, if the bank reference number user on the business document is in invalid format. This action code is also used if the service encounters PEPPOL validation errors. Yes
BusinessAccept DocumentAccepted The recipient has accepted the business document.

Note: This notification applies to invoices and credit notes.		 Yes
BusinessReject DocumentRejected The recipient has rejected the business document.

Note: This notification applies to invoices and credit notes.		 Yes

Clients that use Basware value added services

The following table includes notifications which clients that use Basware value added services can fetch.

Response Code Action Code The reason behind the action code
BusinessInformation  EligibleForEarlyPayment The invoice is eligible for early payment. Note: This notification applies to Basware value added services.
BusinessInformation  NotEligibleForEarlyPayment The invoice is not eligible for early payment. Note: This notification applies to Basware value added services.
BusinessAccept  RequestForEarlyPayment The supplier requests invoice to be paid. Note: This notification applies to Basware value added services.
BusinessAccept  ReadyForPayment The invoice is ready for payment.
BusinessInformation DiscountCreditNoteAvailable A discount credit note is available for download. Note: This notification applies to customers who have opted for API delivery of Basware Discount Credit Notes.
BusinessInformation Paid Recipient has initiated the bank payment.

Note: This notification applies to invoices and credit notes.
BusinessInformation TransferredToPayment Business document has been moved to payment processing by the recipient.

Note: This notification applies to invoices and credit notes.
BusinessInformation PaymentInitiated Business document has been moved to payment processing by the recipient.

Note: This notification applies to invoices and credit notes.

Parameter: additionalActionProperties

Notification for some action codes can contain additional properties, which will be included in the additionalActionProperties element. All the additional properties are optional.

Action code Property name of additional action Property value of additional action Remarks
Delivered DeliveryMeansCode ElectronicDelivery, EmailDelivery or MailDelivery Notifications can include the delivery channel of a business document to help estimate the delivery time. However, this information cannot be used for billing purposes.
InvalidContent or Delivered ValidationFileReference <file reference> Notifications can include a reference to a validation file. The validation file will contain more information about why the business document's validation failed. The validation file can be retrieved using the GET /files/{fileReference} method. Currently, the API only returns results from PEPPOL validation.

The validation file can also be returned in successful cases, where the business document's actionCode is Delivered. Currently, the API only returns results from PEPPOL validation.

API for Notifications v1.1

Notifications

API client sends and fetches a list of notifications related to a business document. Each notification is linked to an event in the business document's lifecycle. Basware Network raises events as it processes the business document.

If you send or receive business documents, you can notify Basware Network about a change in a business document’s status. If you send business documents, you can fetch notifications about the business documents that you have sent.

POST

POST /notifications HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Request example 

{
  "bumid" : "7de91997-70de-51b8-84e1-41cc473eeee7",
  "documentType": "Invoice",
  "acknowledgementId" : "7de91997-70de-51b8-84e1-41cc473ebeef",
  "responseCode" : "TechnicalAccept",
  "responseType" : "BCN:responsecode-v1",
  "actionCode" : "Delivered",
  "actionType" : "BCN:actioncode-v1",
  "notificationCreated" : "1334578485000",
  "description" : "The business document has been delivered to the recipient"
}

Request schema 

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Notification",
  "type": "object",
  "properties": {
    "bumid": {
      "description": "Unique UUID for business document",
      "type": "string",
      "pattern" : "^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$"
    },
    "documentType": {
      "description": "Document type the notification relates to. Possible values: Invoice|CreditNode|Order|Catalogue",
      "type": "string"
    },
    "acknowledgementId": {
      "description": "Acknowledgement identifier. Format is UUID",
      "type": "string",
      "pattern" : "^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$"
    },
    "responseCode": {
      "description": "Response code. Possible codes: TechnicalAccept|TechnicalReject|TechnicalInformation|BusinessAccept|BusinessReject|BusinessInformation",
      "type": "string",
      "default": "TechnicalAccept"
    },
    "responseType": {
      "description": "Type for response code. Possible values: BCN:responsecode-v1",
      "type": "string",
      "default": "BCN:responsecode-v1"
    },
    "actionType": {
      "description": "Type for action code. Possible values: BCN:actioncode-v1",
      "type": "string",
      "default": "BCN:actioncode-v1"
    },
    "actionCode": {
      "description": "Action code. Possible values are described in Notification details",
      "type": "string",
      "default": "Delivered"
    },
    "additionalActionProperties": {
      "description": "Additional properties for the notification",
      "type": "array",
      "items" : {
        "type" : "object",
        "properties" : {
          "name" : {
            "type" : "string",
            "description" : "Type of the additional information related to actionCode"
          },
          "value" : {
            "type" : "string",
            "description" : "The actual value for the additional information"
          }
        }
      }
    },
    "notificationCreated": {
      "description": "Notification creation time. The format is Unix time (Epoch time) with millisecond accuracy",
      "type": "string"
    },
    "description": {
      "description": "Description for the notification",
      "type": "string"
    }
  },
  "required":[
    "bumid",
    "responseCode",
    "notificationCreated"
  ],
  "additionalProperties": false
}

You can notify Basware Network about a change in a business document's status by using the POST notification method.

Request URI

https://api.basware.com/v1.1/notifications

Request Headers

Param Name Required Example Description
Content-Type true application/json Specifies media types which are acceptable for the request. Value application/json is supported.
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Responses

Response code Description
201 The request has been fulfilled and resulted in a new resource being created.
400 Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
415 Unsupported Media Type. The server is refusing to service the request because the payload is in a format not supported.

GET

GET /notifications HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Response code 200 - The request has been completed successfully.

Response example for the response code above 

{
  "hasMoreItems": false,
  "notifications": [
    {
      "bumid": "7de91997-70de-51b8-84e1-41cc473eeee7",
      "documentType": "Invoice",
      "acknowledgementId": "7de91997-70de-51b8-84e1-41cc473ebeef",
      "responseCode": "TechnicalAccept",
      "responseType": "BCN:responsecode-v1",
      "actionCode": "Delivered",
      "actionType": "BCN:actioncode-v1",
      "additionalActionProperties": [
        {
        "name": "DeliveryMeansCode",
        "value": "ElectronicDelivery"
        }
      ],
      "notificationCreated": "1334578485000",
      "description": "Document delivered successfully",
      "links": [
        {
          "rel": "businessDocument",
          "href": "https://api.basware.com/v1/invoices/7de91997-70de-51b8-84e1-41cc473eeee7",
          "method": "GET"
        },
        {
          "rel": "notification",
          "href": "https://api.basware.com/v1.1/notifications/7de91997-70de-51b8-84e1-41cc473ebeef",
          "method": "DELETE"
        }
      ]
    },
    {
      "bumid": "19757736-6ddb-47d3-8d35-79b3eb18c20a",
      "documentType": "Invoice",
      "acknowledgementId": "78a25143-68de-5131-a4e2-56756756eeee",
      "responseCode": "BusinessReject",
      "responseType": "BCN:responsecode-v1",
      "actionCode": "RepaymentFailed",
      "actionType": "BCN:actioncode-v1",
      "notificationCreated": "1334578587000",
      "description": "Repayment has failed",
      "links": [
        {
          "rel": "businessDocument",
          "href": "https://api.basware.com/v1.1/invoices/19757736-6ddb-47d3-8d35-79b3eb18c20a",
          "method": "GET"
        },
        {
          "rel": "notification",
          "href": "https://api.basware.com/v1.1/notifications/78a25143-68de-5131-a4e2-56756756eeee",
          "method": "DELETE"
        }
      ]
    }
  ]
}

Response schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Notifications",
  "type": "object",
  "description": "Notifications are related to business document",
  "properties": {
    "hasMoreItems": {
      "type": "boolean",
      "description": "Indicates whether there are additional notifications to return"
    },
    "notifications": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "bumid": {
            "description": "Unique UUID for business document",
            "type": "string",
            "pattern" : "^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$"
          },
          "documentType": {
            "description": "Document type the notification relates to. Possible values: Invoice|CreditNode|Order|OrderCancellation|OrderChange|Catalogue",
            "type": "string",
            "default": "Invoice"
          },
          "acknowledgementId": {
            "description": "Acknowledgement identifier. Format is UUID",
            "type": "string",
            "pattern" : "^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$"
          },
          "responseCode": {
            "description": "Response code. Possible codes: TechnicalAccept|TechnicalReject|TechnicalInformation|BusinessAccept|BusinessReject|BusinessInformation",
            "type": "string",
            "default": "TechnicalAccept"
          },
          "responseType": {
            "description": "Type for response code. Possible values: BCN:responsecode-v1",
            "type": "string",
            "default": "BCN:responsecode-v1"
          },
          "actionType": {
            "description": "Type for action code. Possible values: BCN:actioncode-v1",
            "type": "string",
            "default": "BCN:actioncode-v1"
          },
          "actionCode": {
            "description": "Action code. Possible values described in Notification details",
            "type": "string",
            "default": "Delivered"
          },
          "additionalActionProperties": {
            "description": "Additional properties for the notification",
            "type": "array",
            "items" : {
              "type" : "object",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "Type of the additional information related to actionCode"
                },
                "value" : {
                  "type" : "string",
                  "description" : "The actual value for the additional information"
                }
              }
            }
          },
          "notificationCreated": {
            "description": "Notification creation time. The format is Unix time (Epoch time) with millisecond accuracy",
            "type": "string"
          },
          "description": {
            "description": "Description for the notification",
            "type": "string"
          },
          "links": {
            "type": "array",
            "description": "Links related to the notification",
            "items": {
              "type": "object",
              "description": "Links related to the notification",
              "properties": {
                "rel": {
                  "type": "string",
                  "description": "Relation type for the URL in question. Possible values are notification (default), validationFile or businessDocument.",
                  "default": "notification"
                },
                "href": {
                  "type": "string",
                  "description": "Link between the completed call and a future call. The URI is a fully formed URI, which needs also the method field"
                },
                "method": {
                  "type": "string",
                  "enum": ["GET", "POST", "DELETE"],
                  "description": "HTTP methods required to interact with the provided URL",
                  "default": "GET"
                }
              }
            }
          }
        },
        "additionalProperties": false,
        "required": [
          "bumid",
          "documentType",
          "acknowledgementId",
          "responseCode",
          "actionCode",
          "notificationCreated"
        ]
      }
    }
  },
  "required":[
    "hasMoreItems",
    "notifications"
  ],
  "additionalProperties": false
}

Response code 400 - Bad Request. The server cannot or will not process the request. Request failed due to invalid request syntax or invalid request message framing.

Response example for the response code above 

{
  "error": {
    "id": "c842c9c3-75e5-4c32-ae3f-c1fe250fc186",
    "type": "VALIDATION",
    "message": "Business document identifier bumId does not match the pattern :[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}",
    "code": "Error.004.0003",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

You can fetch a list of notifications related to a business document using the GET notification method.

When you fetch notifications, note that you must acknowledge each notification by deleting it with the DELETE notification method. If the notification is not acknowledged, it will appear again when fetching the notifications the next time. Each notification has a unique acknowledgement identifier (acknowledgementId) that you can use to identify the notification.

Request URI

https://api.basware.com/v1.1/notifications

Request Headers

Param Name Required Example Description
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Query Parameters

Param Name Required Example Description
documentType false Invoice Type of documents to fetch notifications for. This parameter can be used to restrict the notification search to a particular document type. Possible values are Invoice, CreditNode, Order, OrderCancellation, OrderChange, Catalogue.
page true 1 A cursor for pagination. The first request must have value 1. If the response indicated that there are additional notifications to fetch, the subsequent GET method should use value 2.
pageSize true 50 A limit for the number of items to be returned during one request. Limit can range between 1 and 5000 items.

Responses

Response code Description
200 The request has been completed successfully.
400 Bad Request. The server cannot or will not process the request. Request failed due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
415 Unsupported Media Type. The server is refusing to service the request because the payload is in a format not supported.
500 Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

DELETE

DELETE /notifications/{id} HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Use the DELETE notification method to delete notifications related to a business document. Note that you must acknowledge each notification that you receive by deleting it. If the notification is not acknowledged, it will appear again when fetching the notifications the next time.

Request URI

https://api.basware.com/v1.1/notifications/{id}

URI Parameters

Param Name Type Required Example Description
id string true ee52202e-680e-4e55-b8a4-0d9daa7c3ee0 Identifier of the notification to be acknowledged.

Request Headers

Param Name Required Example Description
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Responses

Response code Description
200 The notification has been acknowledged successfully.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
404 Resource could not be found. The server has not found anything matching the request URI.

API for Notifications v2

Notifications

API client sends and fetches a list of notifications related to a business document. Each notification is linked to an event in the business document's lifecycle. Basware Network raises events as it processes the business document.

If you send or receive business documents, you can notify Basware Network about a change in a business document’s status. If you send business documents, you can fetch notifications about the business documents that you have sent.

POST

POST /notifications HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Request example 

{
  "resourceId" : "7de91997-70de-51b8-84e1-41cc473eeee7",
  "notificationType": "BusinessDocument",
  "resourceType": "Invoice",
  "responseType" : "BCN:responsecode-v1",
  "responseCode" : "TechnicalAccept",
  "actionType" : "BCN:actioncode-v1",
  "actionCode" : "Delivered",
  "notificationCreated" : "1334578485000",
  "description" : "The business document has been delivered to the recipient"
}

Request schema 

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Notification",
  "type": "object",
  "properties": {
    "resourceId": {
      "description": "Unique UUID for the resource. For business document the identifier refers to bumId. For trading partner the identifier refers to vendor identifier",
      "type": "string",
      "pattern" : "^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$"
    },
    "notificationType": {
      "description": "Notification type the notification relates to. Possible values: BusinessDocument",
      "type": "string"
    },
    "resourceType": {
      "description": "Resource type the notification relates to. Possible values for BusinessDocument: Invoice|CreditNode|Order|Catalogue. Possible values for TradingPartner: Vendor.",
      "type": "string"
    },
    "responseCode": {
      "description": "Response code. Possible codes: TechnicalAccept|TechnicalReject|TechnicalInformation|BusinessAccept|BusinessReject|BusinessInformation",
      "type": "string"
    },
    "responseType": {
      "description": "Type for response code. Possible values: BCN:responsecode-v1",
      "type": "string",
      "default": "BCN:responsecode-v1"
    },
    "actionType": {
      "description": "Type for action code. Possible values: BCN:actioncode-v1",
      "type": "string",
      "default": "BCN:actioncode-v1"
    },
    "actionCode": {
      "description": "Action code. Possible values are described in Notification details",
      "type": "string"
    },
    "additionalActionProperties": {
      "description": "Additional properties for the notification",
      "type": "array",
      "items" : {
        "type" : "object",
        "properties" : {
          "name" : {
            "type" : "string",
            "description" : "Type of the additional information related to actionCode"
          },
          "value" : {
            "type" : "string",
            "description" : "The actual value for the additional information"
          }
        }
      }
    },
    "notificationCreated": {
      "description": "Notification creation time. The format is Unix time (Epoch time) with millisecond accuracy",
      "type": "string",
      "pattern": "^d{13}$"
    },
    "description": {
      "description": "Description for the notification",
      "type": "string"
    },
    "detailedDescription": {
      "description": "Detailed description for the notification",
      "type": "string"
    }
  },
  "required": [
    "resourceId",
    "notificationType",
    "resourceType",
    "responseCode",
    "actionCode",
    "notificationCreated",
    "description"
  ],
  "additionalProperties": false
}

You can notify Basware Network about a change in a business document's status by using the POST notification method.

Request URI

https://api.basware.com/v2/notifications

Request Headers

Param Name Required Example Description
Content-Type true application/json Specifies media types which are acceptable for the request. Value application/json is supported.
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Responses

Response code Description
201 The request has been fulfilled and resulted in a new resource being created.
400 Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
404 Resource could not be found. The server has not found anything matching the request URI.
415 Unsupported Media Type. The server is refusing to service the request because the payload is in a format not supported.

GET

GET /notifications HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Response code 200 - The request has been completed successfully.

Response example for the response code above 

{
  "hasMoreItems": false,
  "notifications": [
    {
      "resourceId": "7de91997-70de-51b8-84e1-41cc473eeee7",
      "notificationType": "BusinessDocument",
      "resourceType": "Invoice",
      "acknowledgementId": "7de91997-70de-51b8-84e1-41cc473ebeef",
      "responseCode": "TechnicalAccept",
      "responseType": "BCN:responsecode-v1",
      "actionCode": "Delivered",
      "actionType": "BCN:actioncode-v1",
      "additionalActionProperties": [
        {
        "name": "DeliveryMeansCode",
        "value": "ElectronicDelivery"
        }
      ],
      "notificationCreated": "1334578485000",
      "description": "Document delivered successfully",
      "detailedDescription": "Document delivered",
      "links": [
        {
          "rel": "businessDocument",
          "href": "https://api.basware.com/v2/invoices/7de91997-70de-51b8-84e1-41cc473eeee7",
          "method": "GET"
        },
        {
          "rel": "notification",
          "href": "https://api.basware.com/v2/notifications/7de91997-70de-51b8-84e1-41cc473ebeef",
          "method": "DELETE"
        }
      ]
    },
    {
      "resourceId": "19757736-6ddb-47d3-8d35-79b3eb18c20a",
      "notificationType": "BusinessDocument",
      "resourceType": "Invoice",
      "acknowledgementId": "78a25143-68de-5131-a4e2-56756756eeee",
      "responseCode": "BusinessReject",
      "responseType": "BCN:responsecode-v1",
      "actionCode": "RepaymentFailed",
      "actionType": "BCN:actioncode-v1",
      "notificationCreated": "1334578587000",
      "description": "Repayment has failed",
      "links": [
        {
          "rel": "businessDocument",
          "href": "https://api.basware.com/v2/invoices/19757736-6ddb-47d3-8d35-79b3eb18c20a",
          "method": "GET"
        },
        {
          "rel": "notification",
          "href": "https://api.basware.com/v2/notifications/78a25143-68de-5131-a4e2-56756756eeee",
          "method": "DELETE"
        }
      ]
    }
  ]
}

Response schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Notifications",
  "type": "object",
  "description": "Notifications are related to business document",
  "properties": {
    "hasMoreItems": {
      "type": "boolean",
      "description": "Indicates whether there are additional notifications to return"
    },
    "notifications": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "resourceId": {
            "description": "Unique UUID for the resource. For business document the identifier refers to bumId. For trading partner the identifier refers to vendor identifier",
            "type": "string",
            "pattern" : "^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$"
          },
          "notificationType": {
            "description": "Notification type the notification relates to. Possible values: BusinessDocument|TradingPartner",
            "type": "string"
          },
          "resourceType": {
            "description": "Resource type the notification relates to. Possible values for BusinessDocument: Invoice|CreditNode|Order|Catalogue. Possible values for TradingPartner: Vendor.",
            "type": "string"
          },
          "acknowledgementId": {
            "description": "Acknowledgement identifier. Format is UUID",
            "type": "string",
            "pattern" : "^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$"
          },
          "responseCode": {
            "description": "Response code. Possible codes: TechnicalAccept|TechnicalReject|TechnicalInformation|BusinessAccept|BusinessReject|BusinessInformation",
            "type": "string",
            "default": "TechnicalAccept"
          },
          "responseType": {
            "description": "Type for response code. Possible values: BCN:responsecode-v1",
            "type": "string",
            "default": "BCN:responsecode-v1"
          },
          "actionType": {
            "description": "Type for action code. Possible values: BCN:actioncode-v1",
            "type": "string",
            "default": "BCN:actioncode-v1"
          },
          "actionCode": {
            "description": "Action code. Possible values described in Notification details",
            "type": "string",
            "default": "Delivered"
          },
          "additionalActionProperties": {
            "description": "Additional properties for the notification",
            "type": "array",
            "items" : {
              "type" : "object",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "Type of the additional information related to actionCode"
                },
                "value" : {
                  "type" : "string",
                  "description" : "The actual value for the additional information"
                }
              }
            }
          },
          "notificationCreated": {
            "description": "Notification creation time. The format is Unix time (Epoch time) with millisecond accuracy",
            "type": "string",
            "pattern": "^d{13}$"
          },
          "description": {
            "description": "Description for the notification",
            "type": "string"
          },
          "detailedDescription": {
            "description": "Detailed description for the notification",
            "type": "string"
          },
          "links": {
            "type": "array",
            "description": "Links related to the notification",
            "items": {
              "type": "object",
              "description": "Links related to the notification",
              "properties": {
                "rel": {
                  "type": "string",
                  "description": "Relation type for the URL in question. Possible values are notification (default), validationFile or businessDocument.",
                  "default": "notification"
                },
                "href": {
                  "type": "string",
                  "description": "Link between the completed call and a future call. The URI is a fully formed URI, which needs also the method field"
                },
                "method": {
                  "type": "string",
                  "enum": ["GET", "POST", "DELETE"],
                  "description": "HTTP methods required to interact with the provided URL",
                  "default": "GET"
                }
              }
            }
          }
        },
        "additionalProperties": false,
        "required": [
          "resourceId",
          "notificationType",
          "resourceType",
          "acknowledgementId",
          "responseCode",
          "actionCode",
          "notificationCreated"
        ]
      }
    }
  },
  "required":[
    "hasMoreItems",
    "notifications"
  ],
  "additionalProperties": false
}

Response code 400 - Bad Request. The server cannot or will not process the request. Request failed due to invalid request syntax or invalid request message framing.

Response example for the response code above 

{
  "error": {
    "id": "c842c9c3-75e5-4c32-ae3f-c1fe250fc186",
    "type": "VALIDATION",
    "message": "Business document identifier bumId does not match the pattern :[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}",
    "code": "Error.004.0003",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

You can fetch a list of notifications related to a business document using the GET notification method.

When you fetch notifications, note that you must acknowledge each notification by deleting it with the DELETE notification method. If the notification is not acknowledged, it will appear again when fetching the notifications the next time. Each notification has a unique acknowledgement identifier (acknowledgementId) that you can use to identify the notification.

Request URI

https://api.basware.com/v2/notifications

Request Headers

Param Name Required Example Description
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Query Parameters

Param Name Required Example Description
documentType false Invoice Type of documents to fetch notifications for. This parameter can be used to restrict the notification search to a particular document type. Possible values are Invoice, CreditNode, Order, OrderCancellation, OrderChange, Catalogue.
page true 1 A cursor for pagination. The first request must have value 1. If the response indicated that there are additional notifications to fetch, the subsequent GET method should use value 2.
pageSize true 50 A limit for the number of items to be returned during one request. Limit can range between 1 and 5000 items.

Responses

Response code Description
200 The request has been completed successfully.
400 Bad Request. The server cannot or will not process the request. Request failed due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
404 Resource could not be found. The server has not found anything matching the request URI.
415 Unsupported Media Type. The server is refusing to service the request because the payload is in a format not supported.
500 Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

DELETE

DELETE /notifications/{id} HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Use the DELETE notification method to delete notifications related to a business document. Note that you must acknowledge each notification that you receive by deleting it. If the notification is not acknowledged, it will appear again when fetching the notifications the next time.

Request URI

https://api.basware.com/v2/notifications/{id}

URI Parameters

Param Name Type Required Example Description
id string true ee52202e-680e-4e55-b8a4-0d9daa7c3ee0 Identifier of the notification to be acknowledged.

Request Headers

Param Name Required Example Description
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Responses

Response code Description
200 The notification has been acknowledged successfully.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
404 Resource could not be found. The server has not found anything matching the request URI.

API for Invoices v3

Invoices

The Invoice API lets you send invoices through Basware Network to a recipient.

Invoice API supports several invoice like documents, such as Invoice and CreditNote.

If you need to add attachments to your business document, you can deliver those, too, using the File API. The Files API returns a file identifier (fileId) for each file that you send. You can use this identifier to link the business document sent using the Invoice API to the files delivered using the File API.

GET

GET /invoices/{bumId} HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Response code 200 - The request has been completed successfully.

Response example for the response code above 

{
  "bumId": "c6d7067f-eb67-4289-89ec-819446078a3a",
  "documentType": "Invoice",
  "fileRefs": [
    {
      "refId": "539a78446842ed4025464947d",
      "fileType": "imageFile"
    },
    {
      "refId": "539a785684edd4025415947d",
      "fileType": "attachmentFile"
    }
  ],
  "links": [
    {
      "rel": "file",
      "href": "https://api.basware.com/v2/files/539a78446842ed4025464947d",
      "method": "GET"
    },
    {
      "rel": "file",
      "href": "https://api.basware.com/v2/files/539a785684edd4025415947d",
      "method": "GET"
    }
  ],
  "origin": {
    "source": "SendingCustomer",
    "sourceContentCategory": "StructuredData",
    "sourceChannelCategory": "Electronic",
    "processQualityIndicators": [
      "ContentValidation",
      "StructuralValidation"
    ]
  },
  "data": {
    "externalDocumentIdentifier": {
      "id": "56328230"
    },
    "accountingCustomerParty": {
      "endpoint": {
        "id": "0037059254248888",
        "schemeId": "ISO6523-ACTORID-UPIS"
      },
      "partyIdentifications": [
        {
          "id": "05925424",
          "schemeId": "FI:ORGNR"
        }
      ],
      "partyName": "Basware REST API Test Recipient",
      "postalAddress": {
        "addressLine": "Linnoitustie 2",
        "cityName": "Espoo",
        "postalZone": "02600",
        "countryId": "FI"
      }
    },
    "accountingSupplierParty": {
      "endpoint": {
        "id": "114823943023440",
        "schemeId": "ISO6523-ACTORID-UPIS"
      },
      "partyName": "Acme Supplier Inc.",
      "postalAddress": {
        "addressLine": "1800 Main Street",
        "cityName": "Dallas",
        "countryId": "US",
        "countrySubentity": "TX",
        "postalZone": "75201"
      }
    },
    "deliveryParty": {
      "partyName": "Parcels United",
      "postalAddress": {
        "addressLine": "1 Back Lane",
        "locality": "Clayton West",
        "cityName": "HUDDERSFIELD",
        "postalZone": "HD8 9PP",
        "countryId": "UK"
      }
    },
    "buyerReference": {
      "id": "PO-15653345"
    },
    "documentCurrencyCode": "EUR",
    "documentLines": [
      {
        "id": "1",
        "item": {
          "descriptions": [
            {
              "description":"Basic High-Speed HDMI Cable - 25 Feet"
            },
            {
              "description":"Supports Ethernet, 3D, 4K and Audio Return"
            }
          ],
          "name": "High-Speed HDMI Cable",
          "sellersItem": {
            "id": "B-341"
          },
          "taxPercent": 10
        },
        "lineExtension": {
          "amount": 72,
          "currencyId": "EUR"
        },
        "quantity": {
          "amount": 2,
          "unitCode": "PCE"
        },
        "taxTotals": [
          {
            "amount": 17.28,
            "currencyId": "EUR",
            "taxSubtotals": [
              {
                "amount": 17.28,
                "currencyId": "EUR",
                "percent": 24
              }
            ],
            "transactionCurrencyTax": {
              "amount": 0.9
            }
          }
        ]
      },
      {
        "id": "2",
        "item": {
          "sellersItem": {
            "id": "A-532"
          },
          "taxPercent": 10
        },
        "lineExtension": {
          "amount": 23.1,
          "currencyId": "EUR"
        },
        "quantity": {
          "amount": 1,
          "unitCode": "PCE"
        },
        "taxTotals": [
          {
            "amount": 5.54,
            "currencyId": "EUR",
            "taxSubtotals": [
              {
                "amount": 5.54,
                "currencyId": "EUR",
                "percent": 24
              }
            ],
            "transactionCurrencyTax": {
              "amount": 0.9
            }
          }
        ]
      }
    ],
    "issueDate": "2017-05-15",
    "legalMonetaryTotal": {
      "payableAmount": {
        "amount": 462.8,
        "currencyId": "EUR"
      }
    },
    "paymentMeans": {
      "financialAccounts": [
        {
          "financialInstitutionName": "Nordea Bank AB",
          "financialInstitutionId": "NDEAFIHH",
          "ids": [
            {
              "id": "FI2112345600000785",
              "schemeId": "IBAN"
            }
          ]
        }
      ],
      "paymentDueDate": "2017-06-01",
      "paymentIdentifier": {
        "id": "63156783578924",
        "schemeId": "SPY"
      },
      "paymentMeansCode": "31"
    },
    "taxTotal": {
      "amount": 89.56,
      "currencyId": "EUR",
      "taxSubtotals": [
        {
          "amount": 89.56,
          "currencyId": "EUR",
          "percent": 24,
          "taxableAmount": 373.24
        }
      ]
    }
  }
}

Response schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Schema for GET /invoices",
  "description": "Invoice is a business document which can contain attachments.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "bumId": {
      "description": "Identifies the business document (Basware Unique Message Identifier). It is an unique identifier (UUID) that can be used by external systems to identify a business document.",
      "pattern" : "^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$"
    },
    "documentType": {
      "type": "string",
      "enum": ["Invoice", "CreditNote", "PaymentReceipt"],
      "description": "Indicates the business document type. Possible values are Invoice, CreditNote and PaymentReceipt."
    },
    "fileRefs": {
      "items" : {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
          "refId" : {
            "type" : "string",
            "description" : "Unique file identifier received after storing file into Basware Network."
          },
          "fileType" : {
            "type" : "string",
            "description" : "File type. Possible values are imageFile, attachmentFile and dataFile."
          }
        },
        "required" : [ "refId", "fileType" ]
      }
    },
    "links": {
      "items" : {
        "type" : "object",
        "description" : "Links related to the business document",
        "properties" : {
          "rel" : {
            "type" : "string",
            "description" : "Relation type for the URL in question. Possible values are file.",
            "default" : "file"
          },
          "href" : {
            "type" : "string",
            "description" : "Link between the completed call and a future call. The URI is a fully formed URI, which needs also the method field"
          },
          "method" : {
            "type" : "string",
            "enum" : [ "GET", "POST" ],
            "description" : "HTTP methods required to interact with the provided URL",
            "default" : "GET"
          }
        }
      }
    },
    "origin": {
      "additionalProperties" : false,
      "properties" : {
        "source" : {
          "type" : "string",
          "description" : "The originating source of the document. Possible values: SendingCustomer, ReceivingCustomer, ServiceProvider"
        },
        "sourceContentCategory" : {
          "type" : "string",
          "description" : "Indicates the source content. If the content is structured data, the data quality is higher. Possible values: Image, StructuredData, UnstructuredData"
        },
        "sourceChannelCategory" : {
          "type" : "string",
          "description" : "Indicates the source channel of the business document. Possible values: PostalMail, ElectronicMail, Electronic"
        },
        "processQualityIndicators" : {
          "type" : "array",
          "description" : "The quality phases the document has gone through",
          "items" : {
            "type" : "string",
            "description" : "Possible values: HumanSelfValidation, HumanValidation, StructuralValidation, ContentValidation"
          }
        }
      }
    },
    "data": {
      "additionalProperties" : false,
      "properties" : {
        "externalDocumentIdentifier" : {
          "description" : "External system identifier of the business document. Serial number that is issued once only by invoice issuer to identify the invoice.",
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "Identifies the value."
            },
            "schemeId" : {
              "type" : "string",
              "description" : "Identifies the namespace of the id."
            }
          },
          "required" : [ "id" ],
          "additionalProperties" : false
        },
        "issueDate" : {
          "description" : "The date when the invoice was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
          "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
        },
        "documentCurrencyCode" : {
          "type" : "string",
          "description" : "Currency presentation of the Invoice document. Valid values must be ISO 4217 Alpha format."
        },
        "note" : {
          "type" : "string",
          "description" : "Free-form text pertinent to this document, conveying information that is not contained explicitly in other structures."
        },
        "allowanceCharges" : {
          "additionalProperties" : false,
          "items" : {
            "type" : "object",
            "properties" : {
              "chargeIndicator" : {
                "type" : "boolean",
                "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
              },
              "allowanceChargeReasonCode" : {
                "type" : "string",
                "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code"
              },
              "allowanceChargeReason" : {
                "type" : "string",
                "description" : "The reason for this allowance or charge."
              },
              "multiplierFactorNumeric" : {
                "type" : "number",
                "description" : "The factor applied to the base amount to calculate the allowance charge."
              },
              "amount" : {
                "type" : "number",
                "description" : "The allowance charge amount."
              },
              "taxCategories" : {
                "type" : "array",
                "description" : "External identifier of tax category.",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "Identifies the tax category identifier."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "Identifies the namespace of the tax category identifier."
                    },
                    "name" : {
                      "type" : "string",
                      "description" : "Tax category description."
                    },
                    "percent" : {
                      "type" : "number",
                      "description" : "Identifies the tax rate for this category, expressed as a percentage"
                    },
                    "taxExemptionReasonCode" : {
                      "type" : "string",
                      "description" : "Identifies the reason for tax being exempted, expressed as a code."
                    },
                    "taxExemptionReason" : {
                      "type" : "string",
                      "description" : "Identifies the reason for tax being exempted, expressed as text."
                    }
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              }
            }
          },
          "required" : [ "chargeIndicator", "amount" ]
        },
        "isIssuedAgainstOrder" : {
          "type" : "boolean",
          "description" : "Indicates whether the business document is issued against an order."
        },
        "orderReference" : {
          "description" : "Order reference on the business document.",
          "additionalProperties" : false,
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "Order number reference on the business document. Identifies the referenced order assigned by the buyer."
            },
            "schemeId" : {
              "type" : "string",
              "description" : "External system specific identifier of the order system identifier element. If the source business document has any matching element, it should be used."
            },
            "customerReference" : {
              "type" : "string",
              "description" : "Customer Reference Identifier (CRI) when using a purchasing card."
            },
            "salesOrderId" : {
              "type" : "string",
              "description" : "Sales order identifier."
            },
            "issueDate" : {
              "description" : "The date on which the referenced order was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
            }
          },
          "required" : [ "id" ]
        },
        "billingReference" : {
          "description" : "External system identifier object for the billing entity referenced by the business document.",
          "additionalProperties" : false,
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "External system identifier of the billing entity referenced by the Business Document."
            },
            "schemeId" : {
              "type" : "string",
              "description" : "External system specific identifier of the billing reference system identifier element. If the source business document has any matching element, it should be used."
            }
          },
          "required" : [ "id" ]
        },
        "contractDocumentReferences" : {
          "description" : "External system identifier objects for the contract referenced by the business document.",
          "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
              "id" : {
                "type" : "string",
                "description" : "External system identifier of the contract referenced by the Business Document (i.e. buyers contract number). Mandatory field if the customer demands that the goods or services invoiced refer to a contract number defined by the customer to which he wants to assign the Business Document. Is demanded for example in service and maintenance agreements for which there is generally no explicit order."
              },
              "schemeId" : {
                "type" : "string",
                "description" : "External system specific identifier of the contract system identifier element. If the source business document has any matching element, it should be used."
              }
            },
            "required" : [ "id" ]
          }
        },
        "additionalDocumentReference" : {
          "description" : "A reference to an additional document associated with this document. Used for example to reference to an Invoice from Credit Note.",
          "additionalProperties" : false,
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "An identifier for the referenced document (i.e. bumid)."
            },
            "schemeId" : {
              "type" : "string",
              "description" : "External system specific identifier of the invoicing system identifier element. If the source business document has any matching element, it should be used."
            },
            "issueDate" : {
              "type" : "string",
              "description" : "Date when the referenced document was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
            },
            "typeCode" : {
              "type" : "string",
              "description" : "The type of document being referenced, expressed as a code, for example to reference to an Invoice document, code is 380."
            }
          },
          "required" : [ "id" ]
        },
        "accountingSupplierParty" : {
          "description" : "Party that is the accountable supplier of the goods/services in the referred business document.",
          "properties" : {
            "endpoint" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                }
              },
              "required" : [ "id" ]
            },
            "partyIdentifications" : {
              "type" : "array",
              "description" : "An array holding the system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party identification.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "An object holding the system identifier of the party."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Global identifier of namescheme for party identifier."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              }
            },
            "partyName" : {
              "type" : "string",
              "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
            },
            "postalAddress" : {
              "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
              "properties" : {
                "cityName" : {
                  "type" : "string",
                  "description" : "The name of the city, town or village in the postal address of the party."
                },
                "postalZone" : {
                  "type" : "string",
                  "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                },
                "addressLine" : {
                  "type" : "string",
                  "description" : "The address line of the postal address of the party."
                },
                "addressLine2" : {
                  "type" : "string",
                  "description" : "The second address line of the postal address of the party."
                },
                "addressLine3" : {
                  "type" : "string",
                  "description" : "The third address line of the postal address of the party."
                },
                "locality" : {
                  "type" : "string",
                  "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                },
                "countrySubentity" : {
                  "type" : "string",
                  "description" : "The sub-entity of the area in the postal address."
                },
                "countryId" : {
                  "type" : "string",
                  "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                }
              },
              "additionalProperties" : false
            },
            "partyTaxScheme" : {
              "type" : "object",
              "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
              "properties" : {
                "company" : {
                  "type" : "object",
                  "description" : "Information about the company taxes.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "additionalProperties" : false
            },
            "partyLegalEntities" : {
              "type" : "array",
              "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party legal entity.",
                "properties" : {
                  "registrationName" : {
                    "type" : "string",
                    "description" : "Registration name of the legal entity."
                  },
                  "companyIdentifier" : {
                    "description" : "Global legal party identifier, including name scheme",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the value."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the id."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "registrationName", "companyIdentifier" ],
                "additionalProperties" : false
              }
            },
            "contact" : {
              "type" : "object",
              "description" : "An object containing information about contacts. Used for defining the company contact data",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "A contact name of the party."
                },
                "telephone" : {
                  "type" : "string",
                  "description" : "A telephone number of the contact of the party."
                },
                "telefax" : {
                  "type" : "string",
                  "description" : "A fax number of the contact of the party."
                },
                "electronicMail" : {
                  "type" : "string",
                  "description" : "An email of the contact of the party."
                }
              },
              "additionalProperties" : false
            },
            "supplierAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the supplier."
            },
            "customerAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the customer."
            },
            "note" : {
              "type" : "string",
              "description" : "Free-form description of the party not included in other fields"
            }
          },
          "required" : [ "partyName" ],
          "additionalProperties" : false
        },
        "accountingCustomerParty" : {
          "description" : "Party that is the accountable buyer of the goods/services in the referred business document.",
          "properties" : {
            "endpoint" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                }
              },
              "required" : [ "id" ]
            },
            "partyIdentifications" : {
              "type" : "array",
              "description" : "An array holding the system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party identification.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "An object holding the system identifier of the party."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Global identifier of namescheme for party identifier."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              }
            },
            "partyName" : {
              "type" : "string",
              "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
            },
            "postalAddress" : {
              "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
              "properties" : {
                "cityName" : {
                  "type" : "string",
                  "description" : "The name of the city, town or village in the postal address of the party."
                },
                "postalZone" : {
                  "type" : "string",
                  "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                },
                "addressLine" : {
                  "type" : "string",
                  "description" : "The address line of the postal address of the party."
                },
                "addressLine2" : {
                  "type" : "string",
                  "description" : "The second address line of the postal address of the party."
                },
                "addressLine3" : {
                  "type" : "string",
                  "description" : "The third address line of the postal address of the party."
                },
                "locality" : {
                  "type" : "string",
                  "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                },
                "countrySubentity" : {
                  "type" : "string",
                  "description" : "The sub-entity of the area in the postal address."
                },
                "countryId" : {
                  "type" : "string",
                  "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                }
              },
              "additionalProperties" : false
            },
            "partyTaxScheme" : {
              "type" : "object",
              "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
              "properties" : {
                "company" : {
                  "type" : "object",
                  "description" : "Information about the company taxes.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "additionalProperties" : false
            },
            "partyLegalEntities" : {
              "type" : "array",
              "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party legal entity.",
                "properties" : {
                  "registrationName" : {
                    "type" : "string",
                    "description" : "Registration name of the legal entity."
                  },
                  "companyIdentifier" : {
                    "description" : "Global legal party identifier, including name scheme",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the value."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the id."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "registrationName", "companyIdentifier" ],
                "additionalProperties" : false
              }
            },
            "contact" : {
              "type" : "object",
              "description" : "An object containing information about contacts. Used for defining the company contact data",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "A contact name of the party."
                },
                "telephone" : {
                  "type" : "string",
                  "description" : "A telephone number of the contact of the party."
                },
                "telefax" : {
                  "type" : "string",
                  "description" : "A fax number of the contact of the party."
                },
                "electronicMail" : {
                  "type" : "string",
                  "description" : "An email of the contact of the party."
                }
              },
              "additionalProperties" : false
            },
            "supplierAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the supplier."
            },
            "customerAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the customer."
            },
            "note" : {
              "type" : "string",
              "description" : "Free-form description of the party not included in other fields"
            }
          },
          "required" : [ "partyName" ],
          "additionalProperties" : false
        },
        "buyerCustomerParty" : {
          "description" : "Party that is the buyer of the goods/services in the referred business document.",
          "properties" : {
            "endpoint" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                }
              },
              "required" : [ "id" ]
            },
            "partyIdentifications" : {
              "type" : "array",
              "description" : "An array holding the system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party identification.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "An object holding the system identifier of the party."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Global identifier of namescheme for party identifier."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              }
            },
            "partyName" : {
              "type" : "string",
              "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
            },
            "postalAddress" : {
              "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
              "properties" : {
                "cityName" : {
                  "type" : "string",
                  "description" : "The name of the city, town or village in the postal address of the party."
                },
                "postalZone" : {
                  "type" : "string",
                  "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                },
                "addressLine" : {
                  "type" : "string",
                  "description" : "The address line of the postal address of the party."
                },
                "addressLine2" : {
                  "type" : "string",
                  "description" : "The second address line of the postal address of the party."
                },
                "addressLine3" : {
                  "type" : "string",
                  "description" : "The third address line of the postal address of the party."
                },
                "locality" : {
                  "type" : "string",
                  "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                },
                "countrySubentity" : {
                  "type" : "string",
                  "description" : "The sub-entity of the area in the postal address."
                },
                "countryId" : {
                  "type" : "string",
                  "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                }
              },
              "additionalProperties" : false
            },
            "partyTaxScheme" : {
              "type" : "object",
              "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
              "properties" : {
                "company" : {
                  "type" : "object",
                  "description" : "Information about the company taxes.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "additionalProperties" : false
            },
            "partyLegalEntities" : {
              "type" : "array",
              "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party legal entity.",
                "properties" : {
                  "registrationName" : {
                    "type" : "string",
                    "description" : "Registration name of the legal entity."
                  },
                  "companyIdentifier" : {
                    "description" : "Global legal party identifier, including name scheme",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the value."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the id."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "registrationName", "companyIdentifier" ],
                "additionalProperties" : false
              }
            },
            "contact" : {
              "type" : "object",
              "description" : "An object containing information about contacts. Used for defining the company contact data",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "A contact name of the party."
                },
                "telephone" : {
                  "type" : "string",
                  "description" : "A telephone number of the contact of the party."
                },
                "telefax" : {
                  "type" : "string",
                  "description" : "A fax number of the contact of the party."
                },
                "electronicMail" : {
                  "type" : "string",
                  "description" : "An email of the contact of the party."
                }
              },
              "additionalProperties" : false
            },
            "supplierAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the supplier."
            },
            "customerAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the customer."
            },
            "note" : {
              "type" : "string",
              "description" : "Free-form description of the party not included in other fields"
            }
          },
          "required" : [ "partyName" ],
          "additionalProperties" : false
        },
        "sellerSupplierParty" : {
          "description" : "Party that is the supplier of the goods/services in the referred business document.",
          "properties" : {
            "endpoint" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                }
              },
              "required" : [ "id" ]
            },
            "partyIdentifications" : {
              "type" : "array",
              "description" : "An array holding the system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party identification.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "An object holding the system identifier of the party."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Global identifier of namescheme for party identifier."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              }
            },
            "partyName" : {
              "type" : "string",
              "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
            },
            "postalAddress" : {
              "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
              "properties" : {
                "cityName" : {
                  "type" : "string",
                  "description" : "The name of the city, town or village in the postal address of the party."
                },
                "postalZone" : {
                  "type" : "string",
                  "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                },
                "addressLine" : {
                  "type" : "string",
                  "description" : "The address line of the postal address of the party."
                },
                "addressLine2" : {
                  "type" : "string",
                  "description" : "The second address line of the postal address of the party."
                },
                "addressLine3" : {
                  "type" : "string",
                  "description" : "The third address line of the postal address of the party."
                },
                "locality" : {
                  "type" : "string",
                  "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                },
                "countrySubentity" : {
                  "type" : "string",
                  "description" : "The sub-entity of the area in the postal address."
                },
                "countryId" : {
                  "type" : "string",
                  "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                }
              },
              "additionalProperties" : false
            },
            "partyTaxScheme" : {
              "type" : "object",
              "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
              "properties" : {
                "company" : {
                  "type" : "object",
                  "description" : "Information about the company taxes.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "additionalProperties" : false
            },
            "partyLegalEntities" : {
              "type" : "array",
              "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party legal entity.",
                "properties" : {
                  "registrationName" : {
                    "type" : "string",
                    "description" : "Registration name of the legal entity."
                  },
                  "companyIdentifier" : {
                    "description" : "Global legal party identifier, including name scheme",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the value."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the id."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "registrationName", "companyIdentifier" ],
                "additionalProperties" : false
              }
            },
            "contact" : {
              "type" : "object",
              "description" : "An object containing information about contacts. Used for defining the company contact data",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "A contact name of the party."
                },
                "telephone" : {
                  "type" : "string",
                  "description" : "A telephone number of the contact of the party."
                },
                "telefax" : {
                  "type" : "string",
                  "description" : "A fax number of the contact of the party."
                },
                "electronicMail" : {
                  "type" : "string",
                  "description" : "An email of the contact of the party."
                }
              },
              "additionalProperties" : false
            },
            "supplierAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the supplier."
            },
            "customerAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the customer."
            },
            "note" : {
              "type" : "string",
              "description" : "Free-form description of the party not included in other fields"
            }
          },
          "required" : [ "partyName" ],
          "additionalProperties" : false
        },
        "delivery" : {
          "description" : "Delivery details.",
          "additionalProperties" : false,
          "properties" : {
            "actualDeliveryDate" : {
              "type" : "string",
              "description" : "Date when the goods/services are delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
            },
            "deliveryNoteReference" : {
              "description" : "Identifier of the delivery note document.",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Identifies the value."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "Identifies the namespace of the id."
                }
              },
              "required" : [ "id" ],
              "additionalProperties" : false
            }
          }
        },
        "deliveryParty" : {
          "description" : "Party that is responsible for the delivery of the goods/services in the referred business document.",
          "properties" : {
            "endpoint" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                }
              },
              "required" : [ "id" ]
            },
            "partyIdentifications" : {
              "type" : "array",
              "description" : "An array holding the system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party identification.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "An object holding the system identifier of the party."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Global identifier of namescheme for party identifier."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              }
            },
            "partyName" : {
              "type" : "string",
              "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
            },
            "postalAddress" : {
              "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
              "properties" : {
                "cityName" : {
                  "type" : "string",
                  "description" : "The name of the city, town or village in the postal address of the party."
                },
                "postalZone" : {
                  "type" : "string",
                  "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                },
                "addressLine" : {
                  "type" : "string",
                  "description" : "The address line of the postal address of the party."
                },
                "addressLine2" : {
                  "type" : "string",
                  "description" : "The second address line of the postal address of the party."
                },
                "addressLine3" : {
                  "type" : "string",
                  "description" : "The third address line of the postal address of the party."
                },
                "locality" : {
                  "type" : "string",
                  "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                },
                "countrySubentity" : {
                  "type" : "string",
                  "description" : "The sub-entity of the area in the postal address."
                },
                "countryId" : {
                  "type" : "string",
                  "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                }
              },
              "additionalProperties" : false
            },
            "partyTaxScheme" : {
              "type" : "object",
              "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
              "properties" : {
                "company" : {
                  "type" : "object",
                  "description" : "Information about the company taxes.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "additionalProperties" : false
            },
            "partyLegalEntities" : {
              "type" : "array",
              "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party legal entity.",
                "properties" : {
                  "registrationName" : {
                    "type" : "string",
                    "description" : "Registration name of the legal entity."
                  },
                  "companyIdentifier" : {
                    "description" : "Global legal party identifier, including name scheme",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the value."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the id."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "registrationName", "companyIdentifier" ],
                "additionalProperties" : false
              }
            },
            "contact" : {
              "type" : "object",
              "description" : "An object containing information about contacts. Used for defining the company contact data",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "A contact name of the party."
                },
                "telephone" : {
                  "type" : "string",
                  "description" : "A telephone number of the contact of the party."
                },
                "telefax" : {
                  "type" : "string",
                  "description" : "A fax number of the contact of the party."
                },
                "electronicMail" : {
                  "type" : "string",
                  "description" : "An email of the contact of the party."
                }
              },
              "additionalProperties" : false
            },
            "supplierAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the supplier."
            },
            "customerAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the customer."
            },
            "note" : {
              "type" : "string",
              "description" : "Free-form description of the party not included in other fields"
            }
          },
          "required" : [ "partyName" ],
          "additionalProperties" : false
        },
        "paymentMeans" : {
          "description" : "An object holding the available payment means.",
          "additionalProperties" : false,
          "properties" : {
            "paymentMeansCode" : {
              "type" : "string",
              "description" : "A code that identifies how the payment can be done. Valid values: UN/ECE 4461 code represented as string."
            },
            "paymentDueDate" : {
              "type" : "string",
              "description" : "Date when the business document is due for the payment means. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
            },
            "paymentReferenceMessage" : {
              "type" : "string",
              "description" : "A payment reference message. This can be a free text describing the payment."
            },
            "paymentIdentifier" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An identifier for a payment made using this means of payment.",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "The id value of payment identifier."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "Scheme which identifies the type of payment identifier. Possible values are SPY, ISO."
                }
              },
              "required" : [ "id" ]
            },
            "financialAccounts" : {
              "type" : "array",
              "description" : "Array holding the financial account data",
              "items" : {
                "type" : "object",
                "additionalProperties" : false,
                "description" : "Object holding the financial account data",
                "properties" : {
                  "financialInstitutionName" : {
                    "type" : "string",
                    "description" : "The name of financial institution."
                  },
                  "financialInstitutionId" : {
                    "type" : "string",
                    "description" : "Identifier of financial institution."
                  },
                  "financialInstitutionIdSchemeId" : {
                    "type" : "string",
                    "description" : "The external identifier of the financial institution id identifier element."
                  },
                  "financialInstitutionBranchId" : {
                    "type" : "string",
                    "description" : "The identifier of financial institution branch, for example 342-085. This field is typically used by institutions in Australia and New Zealand."
                  },
                  "financialInstitutionBranchSchemeId" : {
                    "type" : "string",
                    "description" : "The scheme identifier of financial institution branch. For example for an Australian institutions, possible scheme is BSB."
                  },
                  "ids" : {
                    "type" : "array",
                    "description" : "Array holding ids",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "Object holding identifier data",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "Identifier."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "External identifier."
                        }
                      },
                      "required" : [ "id" ]
                    }
                  },
                  "accounting" : {
                    "type" : "object",
                    "title" : "Accounting",
                    "description" : "Accounting related content.",
                    "properties" : {
                      "virtualBankBarcode" : {
                        "type" : "object",
                        "title" : "VirtualBankBarcode",
                        "description" : "Virtual bar code can be added to the business document that should be printed.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "title" : "Virtual bank bar code",
                            "description" : "Identifier of the virtual bar code. "
                          },
                          "schemeId" : {
                            "type" : "string",
                            "title" : "SchemeId for virtual bank bar code",
                            "description" : "Scheme identifier of the virtual bank bar code, typically country code according to ISO3166-1 alpha-2. Possible values: FI"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "required" : [ "paymentMeansCode" ]
        },
        "paymentTerms" : {
          "description" : "Available payment terms.",
          "additionalProperties" : false,
          "properties" : {
            "settlementPeriod" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An object holding the settlement period dates.",
              "properties" : {
                "startDate" : {
                  "type" : "string",
                  "description" : "Date when the payment terms starts. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                  "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                },
                "endDate" : {
                  "type" : "string",
                  "description" : "Date when the payment terms ends. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                  "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                }
              }
            },
            "note" : {
              "type" : "string",
              "description" : "Free-form text applying to the payment terms. This field may contain notes or any other similar information that is not contained explicitly in another structure."
            },
            "penaltySurchargePercent" : {
              "type" : "number",
              "description" : "Penalty surcharge percent amount."
            }
          }
        },
        "taxTotal" : {
          "description" : "Tax total details.",
          "additionalProperties" : false,
          "properties" : {
            "currencyId" : {
              "type" : "string",
              "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
            },
            "amount" : {
              "type" : "number",
              "description" : "Total amount of the taxes. The total tax amount for particular tax scheme e.g. VAT; the sum of each of the tax subtotals for each tax category within the tax scheme."
            },
            "roundingAmount" : {
              "type" : "number",
              "description" : "Rounding amount added to the calculated tax total to produce the rounded TotalTaxAmount."
            },
            "taxSubtotals" : {
              "items" : {
                "type" : "object",
                "additionalProperties" : false,
                "description" : "An object holding the information about tax.",
                "properties" : {
                  "currencyId" : {
                    "type" : "string",
                    "description" : "A code that identifies the currency of the tax subtotal. Valid values: ISO 4217 code represented as string."
                  },
                  "amount" : {
                    "type" : "number",
                    "description" : "Total amount of the taxes."
                  },
                  "percent" : {
                    "type" : "number",
                    "description" : "The tax rate for the category, expressed as a percentage."
                  },
                  "taxableAmount" : {
                    "type" : "number",
                    "description" : "Basis of the taxes. The net amount to which the tax percent (rate) is applied to calculate the tax amount."
                  },
                  "taxCategory" : {
                    "type" : "object",
                    "description" : "External identifier of tax category.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the tax category identifier."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the tax category identifier."
                      },
                      "name" : {
                        "type" : "string",
                        "description" : "Tax category description."
                      },
                      "taxExemptionReason" : {
                        "type" : "string",
                        "description" : "The reason for tax being exempted."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "currencyId", "amount" ]
              }
            }
          },
          "required" : [ "currencyId", "amount" ]
        },
        "invoicePeriod" : {
          "description" : "Invoice period of the business document.",
          "additionalProperties" : false,
          "properties" : {
            "startDate" : {
              "description" : "Date when the goods/services are invoiced. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
            },
            "endDate" : {
              "description" : "Date when the goods/services are invoiced. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
            }
          }
        },
        "taxExchangeRate" : {
          "description" : " An association to Exchange Rate between the Document Currency and the Tax Currency.",
          "additionalProperties" : false,
          "properties" : {
            "exchangeRate" : {
              "type" : "number",
              "description" : "The factor applied to the source currency to calculate the target currency."
            }
          }
        },
        "legalMonetaryTotal" : {
          "description" : "Legal monetary details for total amount payable in the business document.",
          "additionalProperties" : false,
          "properties" : {
            "lineExtensionAmount" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An object holding total amount of line extensions.",
              "properties" : {
                "currencyId" : {
                  "type" : "string",
                  "description" : "A code that identifies the currency of the total line extension amount. Valid values: ISO 4217 code represented as string."
                },
                "amount" : {
                  "type" : "number",
                  "description" : "Total amount of line extensions."
                }
              },
              "required" : [ "currencyId", "amount" ]
            },
            "payableAmount" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An object holding total payable amount of line extensions.",
              "properties" : {
                "currencyId" : {
                  "type" : "string",
                  "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                },
                "amount" : {
                  "type" : "number",
                  "description" : "The total amount to be paid."
                }
              },
              "required" : [ "currencyId", "amount" ]
            }
          },
          "required" : [ "payableAmount" ]
        },
        "buyerReference" : {
          "description" : "Buyer reference in the business document.",
          "additionalProperties" : false,
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "The id value of the buyer reference"
            }
          },
          "required" : [ "id" ]
        },
        "customFields" : {
          "description" : "Custom fields in the business document. Disclaimer! Use of a custom field assumes that the recipient can handle the custom fields. Before using custom field Basware needs to be contacted to assure the delivery of these fields. Additional changes may be incurred due to the use of these fields. There is no guarantee that the recipient can handle the specified custom fields.",
          "items" : {
            "type" : "object",
            "description" : "Custom fields in the business document",
            "additionalProperties" : false,
            "properties" : {
              "name" : {
                "type" : "string",
                "description" : "Name of the custom field",
                "default" : "file"
              },
              "value" : {
                "type" : "string",
                "description" : "Value of the custom field"
              },
              "description" : {
                "type" : "string",
                "description" : "The purpose of this field"
              }
            },
            "required" : [ "name", "value" ]
          }
        },
        "documentLines" : {
          "type" : "array",
          "description" : "An array holding the document lines.",
          "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "description" : "A document line",
            "properties" : {
              "id" : {
                "type" : "string",
                "description" : "External system identifier for the document line."
              },
              "note" : {
                "type" : "string",
                "description" : "Free-form text conveying information that is not contained explicitly in other structures."
              },
              "quantity" : {
                "description" : "An object holding the quantity of the target Business Document line item.",
                "additionalProperties" : false,
                "properties" : {
                  "amount" : {
                    "type" : "number",
                    "description" : "The quantity of the target Business Document line items."
                  },
                  "unitCode" : {
                    "type" : "string",
                    "description" : "The unit code of the quantity of the target Business Document line item. Valid values: UN/ECE CEFACT Trade Facilitation Recommendation No.20 common code value represented as string."
                  }
                }
              },
              "serviceIndicator" : {
                "type" : "boolean",
                "description" : "Flag indicating whether the line represents goods or services (true if services, false if goods)."
              },
              "lineExtension" : {
                "description" : "The total amount for the line item, including allowance charges but net of taxes.",
                "additionalProperties" : false,
                "properties" : {
                  "currencyId" : {
                    "type" : "string",
                    "description" : "The currency of the amount."
                  },
                  "amount" : {
                    "type" : "number",
                    "description" : "The total amount for the line item, including allowance charges but net of taxes."
                  }
                },
                "required" : [ "currencyId", "amount" ]
              },
              "item" : {
                "description" : "An object holding an Business Document line item.",
                "additionalProperties" : false,
                "properties" : {
                  "descriptions" : {
                    "type" : "array",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "Business Document line item.",
                      "properties" : {
                        "description" : {
                          "type" : "string",
                          "description" : "Business Document line item."
                        }
                      }
                    }
                  },
                  "name" : {
                    "type" : "string",
                    "description" : "Name of the Business Document line item.  A short name optionally given to an item, such as a name from a catalogue, as distinct from a description."
                  },
                  "taxPercent" : {
                    "type" : "number",
                    "description" : "Tax amount for the item"
                  },
                  "sellersItem" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Identifies the Business Document line item as it is in seller's system.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifier of the business document line item as it is in seller's system."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "System specific identifier of the seller's item identifier element. If the source business document has any matching element, it should be used."
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "buyersItem" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An object holding a identification of the Business Documents line item as it is in buyers system.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifier of the business document line item as it is in buyer's system."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "System specific identifier of the buyer's item identifier element. If the source business document has any matching element, it should be used."
                      }
                    },
                    "required" : [ "id" ]
                  }
                }
              },
              "payment" : {
                "additionalProperties" : false,
                "properties" : {
                  "paymentDate" : {
                    "type" : "string",
                    "description" : "Payment timestamp which includes time."
                  },
                  "paymentMeansCode" : {
                    "type" : "string",
                    "description" : "Payment method."
                  },
                  "currencyCode" : {
                    "type" : "string",
                    "description" : "Currency code."
                  },
                  "exchangeRate" : {
                    "type" : "number",
                    "description" : "Exchange rate. Required, if currency code is different from MXN."
                  },
                  "amount" : {
                    "type" : "number",
                    "description" : "Total amount reported in the payment receipt."
                  },
                  "additionalReference" : {
                    "description" : "Reference to a payment, check or other type of payment.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the value."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the id."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  },
                  "payer" : {
                    "description" : "Payer details.",
                    "additionalProperties" : false,
                    "properties" : {
                      "financialInstitution" : {
                        "type" : "object",
                        "description" : "Financial institution for payer account details.",
                        "properties" : {
                          "taxCode" : {
                            "type" : "string",
                            "description" : "Sender tax code."
                          },
                          "name" : {
                            "type" : "string",
                            "description" : "Financial institution name."
                          },
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the financial institution."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the financial institution."
                          }
                        }
                      },
                      "financialAccount" : {
                        "description" : "Financial account for payer",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the value."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the id."
                          }
                        },
                        "required" : [ "id" ],
                        "additionalProperties" : false
                      }
                    }
                  },
                  "payee" : {
                    "description" : "Payee details.",
                    "additionalProperties" : false,
                    "properties" : {
                      "financialAccount" : {
                        "description" : "Financial account for payee",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the value."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the id."
                          }
                        },
                        "required" : [ "id" ],
                        "additionalProperties" : false
                      }
                    }
                  },
                  "financialInstitutionTransactionType" : {
                    "type" : "string",
                    "description" : "Optional field for financial institution transaction type. Currently only one value supported (SPEI type of transactions)."
                  },
                  "certificateByEinvoicingAuthority" : {
                    "type" : "string",
                    "description" : "The certificate that protects the payment, as a text string in base 64 format. It is required in case the transaction type attribute contains information. This field is related to SPEI."
                  },
                  "paymentReferenceId" : {
                    "type" : "string",
                    "description" : "The original string of the payment voucher generated by the issuing entity of the beneficiary account. It is required in case the transaction type attribute contains information. This field is related to SPEI."
                  },
                  "digitalCompanyCertificate" : {
                    "type" : "string",
                    "description" : "The digital seal that is associated with the payment. This field is related to SPEI."
                  },
                  "documentReferences" : {
                    "description" : "Document references",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "properties" : {
                        "taxAuthorityDocumentId" : {
                          "type" : "string",
                          "description" : "The identifier of the document related to the payment. This data can be a tax identifier of the electronic invoice or the operation number of a digital document."
                        },
                        "documentSerialNumber" : {
                          "type" : "string",
                          "description" : "The series of the voucher for internal control of the taxpayer."
                        },
                        "documentId" : {
                          "type" : "string",
                          "description" : "The folio of the voucher for internal control of the taxpayer."
                        },
                        "currencyCode" : {
                          "type" : "string",
                          "description" : "The currency used in the amounts of the related document, when national currency is used or the related document does not specify the currency is MXN. Conforms to the ISO 4217 specification."
                        },
                        "exchangeRate" : {
                          "type" : "number",
                          "description" : "The exchange rate in accordance with the currency recorded in the related document. It is required when the currency of the related document is different from the currency of payment."
                        },
                        "paymentMethod" : {
                          "type" : "string",
                          "description" : "The key to the payment method that was recorded in the related document."
                        },
                        "installmentCount" : {
                          "type" : "integer",
                          "description" : "The installment number that corresponds to the payment. It is required when payment is in installments or deferred."
                        },
                        "unpaidAmount" : {
                          "type" : "number",
                          "description" : "The amount of the unpaid balance of the previous installment. It is required when payment is in installments or deferred."
                        },
                        "paidAmount" : {
                          "type" : "number",
                          "description" : "The amount paid for the related document. It is mandatory when there is more than one related document or when there is a related document and exchangeRate has a value."
                        },
                        "remainingAmount" : {
                          "type" : "number",
                          "description" : "The difference between the amount of the previous balance and the amount of the payment. It is required when payment is in installments or deferred."
                        }
                      }
                    },
                    "required" : [ "taxAuthorityDocumentId", "currencyCode", "paymentMethod" ]
                  }
                },
                "required" : [ "paymentDate", "paymentMeansCode", "currencyCode", "amount", "documentReferences" ]
              },
              "taxTotals" : {
                "description" : "An array holding the information about the taxes.",
                "items" : {
                  "type" : "object",
                  "additionalProperties" : false,
                  "description" : "An object holding the information about tax.",
                  "properties" : {
                    "amount" : {
                      "type" : "number",
                      "description" : "Total amount of the taxes. The total tax amount for particular tax scheme e.g. VAT; the sum of each of the tax subtotals for each tax category within the tax scheme."
                    },
                    "currencyId" : {
                      "type" : "string",
                      "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                    },
                    "transactionCurrencyTax" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "An object holding transaction tax.",
                      "properties" : {
                        "amount" : {
                          "type" : "number",
                          "description" : "Amount of tax for the transaction."
                        }
                      },
                      "required" : [ "amount" ]
                    },
                    "taxSubtotals" : {
                      "items" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An object holding the information about tax.",
                        "properties" : {
                          "currencyId" : {
                            "type" : "string",
                            "description" : "A code that identifies the currency of the tax subtotal. Valid values: ISO 4217 code represented as string."
                          },
                          "amount" : {
                            "type" : "number",
                            "description" : "Total amount of the taxes."
                          },
                          "percent" : {
                            "type" : "number",
                            "description" : "The tax rate for the category, expressed as a percentage."
                          },
                          "taxableAmount" : {
                            "type" : "number",
                            "description" : "Basis of the taxes. The net amount to which the tax percent (rate) is applied to calculate the tax amount."
                          },
                          "taxCategory" : {
                            "type" : "object",
                            "description" : "External identifier of tax category.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "Identifies the tax category identifier."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "Identifies the namespace of the tax category identifier."
                              },
                              "name" : {
                                "type" : "string",
                                "description" : "Tax category description."
                              },
                              "taxExemptionReason" : {
                                "type" : "string",
                                "description" : "The reason for tax being exempted."
                              }
                            },
                            "required" : [ "id" ],
                            "additionalProperties" : false
                          }
                        },
                        "required" : [ "currencyId", "amount" ]
                      }
                    }
                  },
                  "required" : [ "amount", "currencyId" ]
                }
              },
              "price" : {
                "description" : "An object holding the information about the price of the line item.",
                "additionalProperties" : false,
                "properties" : {
                  "amount" : {
                    "type" : "number",
                    "description" : "The price of the line item."
                  },
                  "currencyId" : {
                    "type" : "string",
                    "description" : "A code that identifies the currency of the line item price. Valid values: ISO 4217 code represented as string."
                  }
                },
                "required" : [ "amount", "currencyId" ]
              },
              "delivery" : {
                "description" : "An object holding delivery data",
                "additionalProperties" : false,
                "properties" : {
                  "actualDeliveryDate" : {
                    "description" : "Date when the goods/services are delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                  },
                  "promisedDeliveryPeriod" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Promised delivery period",
                    "properties" : {
                      "startDate" : {
                        "description" : "Earliest date when the goods/services are promised to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "endDate" : {
                        "description" : "Latest date when the goods/services are promised to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      }
                    }
                  },
                  "deliveryAddress" : {
                    "description" : "An object containing address information. Used for defining delivery address party data.",
                    "properties" : {
                      "cityName" : {
                        "type" : "string",
                        "description" : "The name of the city, town or village in the postal address of the party."
                      },
                      "postalZone" : {
                        "type" : "string",
                        "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                      },
                      "addressLine" : {
                        "type" : "string",
                        "description" : "The address line of the postal address of the party."
                      },
                      "addressLine2" : {
                        "type" : "string",
                        "description" : "The second address line of the postal address of the party."
                      },
                      "addressLine3" : {
                        "type" : "string",
                        "description" : "The third address line of the postal address of the party."
                      },
                      "locality" : {
                        "type" : "string",
                        "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                      },
                      "countrySubentity" : {
                        "type" : "string",
                        "description" : "The sub-entity of the area in the postal address."
                      },
                      "countryId" : {
                        "type" : "string",
                        "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                      }
                    },
                    "additionalProperties" : false
                  }
                }
              },
              "orderLineReference" : {
                "description" : "An object holding order line reference data",
                "additionalProperties" : false,
                "properties" : {
                  "lineId" : {
                    "type" : "string",
                    "description" : "An identifier for the referenced order line, assigned by the buyer."
                  },
                  "orderReference" : {
                    "type" : "string",
                    "description" : "A reference to the order containing the referenced order line."
                  }
                },
                "required" : [ "lineId" ]
              },
              "allowanceCharges" : {
                "description" : "Extra payment or subtraction to Business Document, for example freight or handling fees.",
                "additionalProperties" : false,
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "chargeIndicator" : {
                      "type" : "boolean",
                      "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
                    },
                    "allowanceChargeReasonCode" : {
                      "type" : "string",
                      "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code"
                    },
                    "allowanceChargeReason" : {
                      "type" : "string",
                      "description" : "The reason for this allowance or charge."
                    },
                    "multiplierFactorNumeric" : {
                      "type" : "number",
                      "description" : "The factor applied to the base amount to calculate the allowance charge."
                    },
                    "amount" : {
                      "type" : "number",
                      "description" : "The allowance charge amount."
                    },
                    "taxCategories" : {
                      "type" : "array",
                      "description" : "External identifier of tax category.",
                      "items" : {
                        "type" : "object",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the tax category identifier."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the tax category identifier."
                          },
                          "name" : {
                            "type" : "string",
                            "description" : "Tax category description."
                          },
                          "percent" : {
                            "type" : "number",
                            "description" : "Identifies the tax rate for this category, expressed as a percentage"
                          },
                          "taxExemptionReasonCode" : {
                            "type" : "string",
                            "description" : "Identifies the reason for tax being exempted, expressed as a code."
                          },
                          "taxExemptionReason" : {
                            "type" : "string",
                            "description" : "Identifies the reason for tax being exempted, expressed as text."
                          }
                        }
                      },
                      "required" : [ "id" ],
                      "additionalProperties" : false
                    }
                  }
                },
                "required" : [ "chargeIndicator", "amount" ]
              },
              "customFields" : {
                "description" : "Custom fields in the business document. Disclaimer! Use of a custom field assumes that the recipient can handle the custom fields. Before using custom field Basware needs to be contacted to assure the delivery of these fields. Additional changes may be incurred due to the use of these fields. There is no guarantee that the recipient can handle the specified custom fields.",
                "items" : {
                  "type" : "object",
                  "description" : "Custom fields in the business document",
                  "additionalProperties" : false,
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "Name of the custom field",
                      "default" : "file"
                    },
                    "value" : {
                      "type" : "string",
                      "description" : "Value of the custom field"
                    },
                    "description" : {
                      "type" : "string",
                      "description" : "The purpose of this field"
                    }
                  },
                  "required" : [ "name", "value" ]
                }
              },
              "additionalItemProperties" : {
                "description" : "Associates the item with a set of additional properties.",
                "items" : {
                  "type" : "object",
                  "additionalProperties" : false,
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "The name of the Item Property."
                    },
                    "value" : {
                      "type" : "string",
                      "description" : "The value of the Item Property"
                    }
                  },
                  "required" : [ "name", "value" ]
                }
              }
            },
            "required" : [ "id", "lineExtension", "item" ]
          }
        }
      },
      "required" : [ "externalDocumentIdentifier", "issueDate", "accountingSupplierParty", "accountingCustomerParty", "legalMonetaryTotal", "documentLines" ]
    }
  },
  "required": [
    "bumId",
    "documentType",
    "data"
  ]
}

Response code 400 - Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.

Response example for the response code above 

{
  "error": {
    "id": "c842c9c3-75e5-4c32-ae3f-c1fe250fc186",
    "type": "VALIDATION",
    "message": "Business document identifier bumId does not match the pattern :[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}",
    "code": "Error.004.0003",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

Response code 500 - Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

Response example for the response code above 

{
  "error": {
    "id": "a312a9b3-35e5-1a32-be3f-a5fe250fc121",
    "type": "TECHNICAL",
    "message": "BCN encountered an unexpected system error",
    "code": "Error.001.0006",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

You can retrieve the invoice contents using GET /invoices method. Basware Unique Message Identifier (bumId) defines which invoice you want to retrieve.

Request URI

https://api.basware.com/v3/invoices/{bumId}

URI Parameters

Param Name Type Required Example Description
bumId string true 6741ecc7-848a-443c-83ad-ea95e4df06fa Unique UUID for invoice

Request Headers

Param Name Required Example Description
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Responses

Response code Description
200 The request has been completed successfully.
400 Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
500 Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

POST

POST /invoices/{bumId} HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Request example 

{
  "clientToken": "3ee9b55f-9b08-4936-8c8c-87c7d0ae4114",
  "documentType": "Invoice",
  "fileRefs": [
    {
      "refId": "34a9a23ff33e42a6bc674f1a"
    }
  ],
  "processingPreference": {
    "sendTo": {
      "id": "0037059254248888",
      "schemeId": "ISO6523-ACTORID-UPIS"
    },
    "receiveFrom": {
      "id": "114823943023440",
      "schemeId": "ISO6523-ACTORID-UPIS"
    },
    "printingPreference": "PrintingAllowed"
  },
  "data": {
    "externalDocumentIdentifier": {
      "id": "56328230"
    },
    "issueDate": "2017-05-01",
    "documentCurrencyCode": "EUR",
    "isIssuedAgainstOrder": false,
    "contractDocumentReferences": [
      {
        "id": "147217"
      }
    ],
    "accountingSupplierParty": {
      "partyName": "Acme Supplier Inc.",
      "postalAddress": {
        "addressLine": "1800 Main Street",
        "cityName": "Dallas",
        "postalZone": "75201",
        "countrySubentity": "TX",
        "countryId": "US"
      }
    },
    "accountingCustomerParty": {
      "endpoint": {
        "id": "0037059254248888",
        "schemeId": "ISO6523-ACTORID-UPIS"
      },
      "partyIdentifications": [
        {
          "id": "05925424",
          "schemeId": "FI:ORGNR"
        }
      ],
      "partyName": "Basware REST API Test Recipient",
      "postalAddress": {
        "addressLine": "Linnoitustie 2",
        "cityName": "Espoo",
        "postalZone": "02600",
        "countryId": "FI"
      }
    },
    "deliveryParty": {
      "partyName": "Parcels United",
      "postalAddress": {
        "addressLine": "1 Back Lane",
        "locality": "Clayton West",
        "cityName": "HUDDERSFIELD",
        "postalZone": "HD8 9PP",
        "countryId": "UK"
      }
    },
    "paymentMeans": {
      "financialAccounts": [
        {
          "financialInstitutionName": "Nordea Bank AB",
          "financialInstitutionId": "NDEAFIHH",
          "ids": [
            {
              "id": "FI2112345600000785",
              "schemeId": "IBAN"
            }
          ]
        }
      ],
      "paymentDueDate": "2017-05-15",
      "paymentIdentifier": {
        "id": "63156783578924",
        "schemeId": "SPY"
      },
      "paymentMeansCode": "31"
    },
    "buyerReference": {
      "id": "PO-1563224"
    },
    "taxTotal": {
      "amount": 89.56,
      "currencyId": "EUR",
      "taxSubtotals": [
        {
          "taxableAmount": 373.24,
          "amount": 89.56,
          "currencyId": "EUR",
          "percent": 24
        }
      ]
    },
    "legalMonetaryTotal": {
      "payableAmount": {
        "amount": 462.8,
        "currencyId": "EUR"
      }
    },
    "documentLines": [
      {
        "id": "1",
        "quantity": {
          "amount": 2,
          "unitCode": "PCE"
        },
        "lineExtension": {
          "currencyId": "EUR",
          "amount": 72
        },
        "item": {
          "descriptions": [
            {
              "description": "Basic High-Speed HDMI Cable - 25 Feet"
            },
            {
              "description": "Supports Ethernet, 3D, 4K and Audio Return"
            }
          ],
          "name": "High-Speed HDMI Cable",
          "taxPercent": 10,
          "sellersItem": {
            "id": "B-341"
          }
        },
        "taxTotals": [
          {
            "currencyId": "EUR",
            "amount": 17.28,
            "transactionCurrencyTax": {
              "amount": 0.9
            },
            "taxSubtotals": [
              {
                "currencyId": "EUR",
                "amount": 17.28,
                "percent": 24
              }
            ]
          }
        ]
      },
      {
        "id": "2",
        "quantity": {
          "amount": 1,
          "unitCode": "PCE"
        },
        "lineExtension": {
          "currencyId": "EUR",
          "amount": 23.1
        },
        "item": {
          "sellersItem": {
            "id": "A-532"
          },
          "taxPercent": 10
        },
        "taxTotals": [
          {
            "currencyId": "EUR",
            "amount": 5.54,
            "transactionCurrencyTax": {
              "amount": 0.9
            },
            "taxSubtotals": [
              {
                "currencyId": "EUR",
                "amount": 5.54,
                "percent": 24
              }
            ]
          }
        ]
      }
    ]
  }
}

Request schema 

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "title": "Schema for POST /invoices",
    "description": "Invoice is a business document which can contain attachments.",
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "clientToken": {
            "type": "string",
            "description": "Token generated by client (uuid). Used to verify that specific Invoice is only sent and processed once, if response time-outs, retry should be executed with the same clientToken."
        },
        "documentType": {
            "type": "string",
            "enum": ["Invoice", "CreditNote", "PaymentReceipt"],
            "description": "Indicates the business document type. Possible values are Invoice, CreditNote and PaymentReceipt."
        },
        "fileRefs": {
            "type": "array",
            "description": "Invoice file/attachment reference identifiers.",
            "items": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                    "refId": {
                        "type": "string",
                        "description": "Unique file identifier received after storing file into Basware Network."
                    }
                },
                "required": [
                    "refId"
                ]
            }
        },
        "processingPreference": {
            "additionalProperties" : false,
            "properties" : {
              "sendTo" : {
                "description" : "Identifier for the recipient endpoint. See API documentation for more details about recipient endpoints.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies the value."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Identifies the namespace of the id."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              },
              "receiveFrom" : {
                "description" : "Identifier for the sender endpoint.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies the value."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Identifies the namespace of the id."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              },
              "replyTo" : {
                "description" : "Identifier for the reply to endpoint.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies the value."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Identifies the namespace of the id."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              },
              "sendToServiceProvider" : {
                "type" : "string",
                "description" : "Identifier for the intermediate service provider."
              },
              "printingPreference" : {
                "type" : "string",
                "enum" : [ "PrintingAllowed", "PrintingAlways", "NoPrinting" ],
                "description" : "Indicates the printing preference. This optional field can be specified to allow printing delivery with PrintingAllowed or force the document to be delived by printing with PrintingAlways. If this field is not specified, delivery will be by eInvoicing. Note that this field cannot be used together with sendToServiceProvider. Only one of these two fields can be given at the same time."
              },
              "recipientNotificationPreference" : {
                "type" : "string",
                "description" : "Indicates how the recipient is notified about the business document delivery. Possible values are EmailWithLoginLink, EmailWithSecuredLink, EmailWithContent, NotificationViaThirdParty."
              },
              "isConsumerRecipient" : {
                "type" : "boolean",
                "description" : "Indicates whether the recipient is a consumer recipient."
              }
            },
            "required" : [ "sendTo" ]
        },
        "data": {
            "additionalProperties" : false,
            "properties" : {
              "externalDocumentIdentifier" : {
                "description" : "External system identifier of the business document. Serial number that is issued once only by invoice issuer to identify the invoice.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies the value."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Identifies the namespace of the id."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              },
              "issueDate" : {
                "description" : "The date when the invoice was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
              },
              "documentCurrencyCode" : {
                "type" : "string",
                "description" : "Currency presentation of the Invoice document. Valid values must be ISO 4217 Alpha format."
              },
              "note" : {
                "type" : "string",
                "description" : "Free-form text pertinent to this document, conveying information that is not contained explicitly in other structures."
              },
              "allowanceCharges" : {
                "additionalProperties" : false,
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "chargeIndicator" : {
                      "type" : "boolean",
                      "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
                    },
                    "allowanceChargeReasonCode" : {
                      "type" : "string",
                      "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code"
                    },
                    "allowanceChargeReason" : {
                      "type" : "string",
                      "description" : "The reason for this allowance or charge."
                    },
                    "multiplierFactorNumeric" : {
                      "type" : "number",
                      "description" : "The factor applied to the base amount to calculate the allowance charge."
                    },
                    "amount" : {
                      "type" : "number",
                      "description" : "The allowance charge amount."
                    },
                    "taxCategories" : {
                      "type" : "array",
                      "description" : "External identifier of tax category.",
                      "items" : {
                        "type" : "object",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the tax category identifier."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the tax category identifier."
                          },
                          "name" : {
                            "type" : "string",
                            "description" : "Tax category description."
                          },
                          "percent" : {
                            "type" : "number",
                            "description" : "Identifies the tax rate for this category, expressed as a percentage"
                          },
                          "taxExemptionReasonCode" : {
                            "type" : "string",
                            "description" : "Identifies the reason for tax being exempted, expressed as a code."
                          },
                          "taxExemptionReason" : {
                            "type" : "string",
                            "description" : "Identifies the reason for tax being exempted, expressed as text."
                          }
                        }
                      },
                      "required" : [ "id" ],
                      "additionalProperties" : false
                    }
                  }
                },
                "required" : [ "chargeIndicator", "amount" ]
              },
              "isIssuedAgainstOrder" : {
                "type" : "boolean",
                "description" : "Indicates whether the business document is issued against an order."
              },
              "orderReference" : {
                "description" : "Order reference on the business document.",
                "additionalProperties" : false,
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Order number reference on the business document. Identifies the referenced order assigned by the buyer."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "External system specific identifier of the order system identifier element. If the source business document has any matching element, it should be used."
                  },
                  "customerReference" : {
                    "type" : "string",
                    "description" : "Customer Reference Identifier (CRI) when using a purchasing card."
                  },
                  "salesOrderId" : {
                    "type" : "string",
                    "description" : "Sales order identifier."
                  },
                  "issueDate" : {
                    "description" : "The date on which the referenced order was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                  }
                },
                "required" : [ "id" ]
              },
              "billingReference" : {
                "description" : "External system identifier object for the billing entity referenced by the business document.",
                "additionalProperties" : false,
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "External system identifier of the billing entity referenced by the Business Document."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "External system specific identifier of the billing reference system identifier element. If the source business document has any matching element, it should be used."
                  }
                },
                "required" : [ "id" ]
              },
              "contractDocumentReferences" : {
                "description" : "External system identifier objects for the contract referenced by the business document.",
                "items" : {
                  "type" : "object",
                  "additionalProperties" : false,
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "External system identifier of the contract referenced by the Business Document (i.e. buyers contract number). Mandatory field if the customer demands that the goods or services invoiced refer to a contract number defined by the customer to which he wants to assign the Business Document. Is demanded for example in service and maintenance agreements for which there is generally no explicit order."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External system specific identifier of the contract system identifier element. If the source business document has any matching element, it should be used."
                    }
                  },
                  "required" : [ "id" ]
                }
              },
              "additionalDocumentReference" : {
                "description" : "A reference to an additional document associated with this document. Used for example to reference to an Invoice from Credit Note.",
                "additionalProperties" : false,
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "An identifier for the referenced document (i.e. bumid)."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "External system specific identifier of the invoicing system identifier element. If the source business document has any matching element, it should be used."
                  },
                  "issueDate" : {
                    "type" : "string",
                    "description" : "Date when the referenced document was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                  },
                  "typeCode" : {
                    "type" : "string",
                    "description" : "The type of document being referenced, expressed as a code, for example to reference to an Invoice document, code is 380."
                  }
                },
                "required" : [ "id" ]
              },
              "accountingSupplierParty" : {
                "description" : "Party that is the accountable supplier of the goods/services in the referred business document.",
                "properties" : {
                  "endpoint" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "partyIdentifications" : {
                    "type" : "array",
                    "description" : "An array holding the system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party identification.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "An object holding the system identifier of the party."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "Global identifier of namescheme for party identifier."
                        }
                      },
                      "required" : [ "id" ],
                      "additionalProperties" : false
                    }
                  },
                  "partyName" : {
                    "type" : "string",
                    "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                  },
                  "postalAddress" : {
                    "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                    "properties" : {
                      "cityName" : {
                        "type" : "string",
                        "description" : "The name of the city, town or village in the postal address of the party."
                      },
                      "postalZone" : {
                        "type" : "string",
                        "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                      },
                      "addressLine" : {
                        "type" : "string",
                        "description" : "The address line of the postal address of the party."
                      },
                      "addressLine2" : {
                        "type" : "string",
                        "description" : "The second address line of the postal address of the party."
                      },
                      "addressLine3" : {
                        "type" : "string",
                        "description" : "The third address line of the postal address of the party."
                      },
                      "locality" : {
                        "type" : "string",
                        "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                      },
                      "countrySubentity" : {
                        "type" : "string",
                        "description" : "The sub-entity of the area in the postal address."
                      },
                      "countryId" : {
                        "type" : "string",
                        "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyTaxScheme" : {
                    "type" : "object",
                    "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                    "properties" : {
                      "company" : {
                        "type" : "object",
                        "description" : "Information about the company taxes.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyLegalEntities" : {
                    "type" : "array",
                    "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party legal entity.",
                      "properties" : {
                        "registrationName" : {
                          "type" : "string",
                          "description" : "Registration name of the legal entity."
                        },
                        "companyIdentifier" : {
                          "description" : "Global legal party identifier, including name scheme",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifies the value."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Identifies the namespace of the id."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "required" : [ "registrationName", "companyIdentifier" ],
                      "additionalProperties" : false
                    }
                  },
                  "contact" : {
                    "type" : "object",
                    "description" : "An object containing information about contacts. Used for defining the company contact data",
                    "properties" : {
                      "name" : {
                        "type" : "string",
                        "description" : "A contact name of the party."
                      },
                      "telephone" : {
                        "type" : "string",
                        "description" : "A telephone number of the contact of the party."
                      },
                      "telefax" : {
                        "type" : "string",
                        "description" : "A fax number of the contact of the party."
                      },
                      "electronicMail" : {
                        "type" : "string",
                        "description" : "An email of the contact of the party."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "supplierAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the supplier."
                  },
                  "customerAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the customer."
                  },
                  "note" : {
                    "type" : "string",
                    "description" : "Free-form description of the party not included in other fields"
                  }
                },
                "required" : [ "partyName" ],
                "additionalProperties" : false
              },
              "accountingCustomerParty" : {
                "description" : "Party that is the accountable buyer of the goods/services in the referred business document.",
                "properties" : {
                  "endpoint" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "partyIdentifications" : {
                    "type" : "array",
                    "description" : "An array holding the system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party identification.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "An object holding the system identifier of the party."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "Global identifier of namescheme for party identifier."
                        }
                      },
                      "required" : [ "id" ],
                      "additionalProperties" : false
                    }
                  },
                  "partyName" : {
                    "type" : "string",
                    "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                  },
                  "postalAddress" : {
                    "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                    "properties" : {
                      "cityName" : {
                        "type" : "string",
                        "description" : "The name of the city, town or village in the postal address of the party."
                      },
                      "postalZone" : {
                        "type" : "string",
                        "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                      },
                      "addressLine" : {
                        "type" : "string",
                        "description" : "The address line of the postal address of the party."
                      },
                      "addressLine2" : {
                        "type" : "string",
                        "description" : "The second address line of the postal address of the party."
                      },
                      "addressLine3" : {
                        "type" : "string",
                        "description" : "The third address line of the postal address of the party."
                      },
                      "locality" : {
                        "type" : "string",
                        "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                      },
                      "countrySubentity" : {
                        "type" : "string",
                        "description" : "The sub-entity of the area in the postal address."
                      },
                      "countryId" : {
                        "type" : "string",
                        "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyTaxScheme" : {
                    "type" : "object",
                    "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                    "properties" : {
                      "company" : {
                        "type" : "object",
                        "description" : "Information about the company taxes.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyLegalEntities" : {
                    "type" : "array",
                    "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party legal entity.",
                      "properties" : {
                        "registrationName" : {
                          "type" : "string",
                          "description" : "Registration name of the legal entity."
                        },
                        "companyIdentifier" : {
                          "description" : "Global legal party identifier, including name scheme",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifies the value."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Identifies the namespace of the id."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "required" : [ "registrationName", "companyIdentifier" ],
                      "additionalProperties" : false
                    }
                  },
                  "contact" : {
                    "type" : "object",
                    "description" : "An object containing information about contacts. Used for defining the company contact data",
                    "properties" : {
                      "name" : {
                        "type" : "string",
                        "description" : "A contact name of the party."
                      },
                      "telephone" : {
                        "type" : "string",
                        "description" : "A telephone number of the contact of the party."
                      },
                      "telefax" : {
                        "type" : "string",
                        "description" : "A fax number of the contact of the party."
                      },
                      "electronicMail" : {
                        "type" : "string",
                        "description" : "An email of the contact of the party."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "supplierAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the supplier."
                  },
                  "customerAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the customer."
                  },
                  "note" : {
                    "type" : "string",
                    "description" : "Free-form description of the party not included in other fields"
                  }
                },
                "required" : [ "partyName" ],
                "additionalProperties" : false
              },
              "buyerCustomerParty" : {
                "description" : "Party that is the buyer of the goods/services in the referred business document.",
                "properties" : {
                  "endpoint" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "partyIdentifications" : {
                    "type" : "array",
                    "description" : "An array holding the system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party identification.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "An object holding the system identifier of the party."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "Global identifier of namescheme for party identifier."
                        }
                      },
                      "required" : [ "id" ],
                      "additionalProperties" : false
                    }
                  },
                  "partyName" : {
                    "type" : "string",
                    "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                  },
                  "postalAddress" : {
                    "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                    "properties" : {
                      "cityName" : {
                        "type" : "string",
                        "description" : "The name of the city, town or village in the postal address of the party."
                      },
                      "postalZone" : {
                        "type" : "string",
                        "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                      },
                      "addressLine" : {
                        "type" : "string",
                        "description" : "The address line of the postal address of the party."
                      },
                      "addressLine2" : {
                        "type" : "string",
                        "description" : "The second address line of the postal address of the party."
                      },
                      "addressLine3" : {
                        "type" : "string",
                        "description" : "The third address line of the postal address of the party."
                      },
                      "locality" : {
                        "type" : "string",
                        "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                      },
                      "countrySubentity" : {
                        "type" : "string",
                        "description" : "The sub-entity of the area in the postal address."
                      },
                      "countryId" : {
                        "type" : "string",
                        "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyTaxScheme" : {
                    "type" : "object",
                    "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                    "properties" : {
                      "company" : {
                        "type" : "object",
                        "description" : "Information about the company taxes.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyLegalEntities" : {
                    "type" : "array",
                    "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party legal entity.",
                      "properties" : {
                        "registrationName" : {
                          "type" : "string",
                          "description" : "Registration name of the legal entity."
                        },
                        "companyIdentifier" : {
                          "description" : "Global legal party identifier, including name scheme",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifies the value."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Identifies the namespace of the id."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "required" : [ "registrationName", "companyIdentifier" ],
                      "additionalProperties" : false
                    }
                  },
                  "contact" : {
                    "type" : "object",
                    "description" : "An object containing information about contacts. Used for defining the company contact data",
                    "properties" : {
                      "name" : {
                        "type" : "string",
                        "description" : "A contact name of the party."
                      },
                      "telephone" : {
                        "type" : "string",
                        "description" : "A telephone number of the contact of the party."
                      },
                      "telefax" : {
                        "type" : "string",
                        "description" : "A fax number of the contact of the party."
                      },
                      "electronicMail" : {
                        "type" : "string",
                        "description" : "An email of the contact of the party."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "supplierAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the supplier."
                  },
                  "customerAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the customer."
                  },
                  "note" : {
                    "type" : "string",
                    "description" : "Free-form description of the party not included in other fields"
                  }
                },
                "required" : [ "partyName" ],
                "additionalProperties" : false
              },
              "sellerSupplierParty" : {
                "description" : "Party that is the supplier of the goods/services in the referred business document.",
                "properties" : {
                  "endpoint" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "partyIdentifications" : {
                    "type" : "array",
                    "description" : "An array holding the system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party identification.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "An object holding the system identifier of the party."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "Global identifier of namescheme for party identifier."
                        }
                      },
                      "required" : [ "id" ],
                      "additionalProperties" : false
                    }
                  },
                  "partyName" : {
                    "type" : "string",
                    "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                  },
                  "postalAddress" : {
                    "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                    "properties" : {
                      "cityName" : {
                        "type" : "string",
                        "description" : "The name of the city, town or village in the postal address of the party."
                      },
                      "postalZone" : {
                        "type" : "string",
                        "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                      },
                      "addressLine" : {
                        "type" : "string",
                        "description" : "The address line of the postal address of the party."
                      },
                      "addressLine2" : {
                        "type" : "string",
                        "description" : "The second address line of the postal address of the party."
                      },
                      "addressLine3" : {
                        "type" : "string",
                        "description" : "The third address line of the postal address of the party."
                      },
                      "locality" : {
                        "type" : "string",
                        "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                      },
                      "countrySubentity" : {
                        "type" : "string",
                        "description" : "The sub-entity of the area in the postal address."
                      },
                      "countryId" : {
                        "type" : "string",
                        "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyTaxScheme" : {
                    "type" : "object",
                    "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                    "properties" : {
                      "company" : {
                        "type" : "object",
                        "description" : "Information about the company taxes.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyLegalEntities" : {
                    "type" : "array",
                    "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party legal entity.",
                      "properties" : {
                        "registrationName" : {
                          "type" : "string",
                          "description" : "Registration name of the legal entity."
                        },
                        "companyIdentifier" : {
                          "description" : "Global legal party identifier, including name scheme",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifies the value."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Identifies the namespace of the id."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "required" : [ "registrationName", "companyIdentifier" ],
                      "additionalProperties" : false
                    }
                  },
                  "contact" : {
                    "type" : "object",
                    "description" : "An object containing information about contacts. Used for defining the company contact data",
                    "properties" : {
                      "name" : {
                        "type" : "string",
                        "description" : "A contact name of the party."
                      },
                      "telephone" : {
                        "type" : "string",
                        "description" : "A telephone number of the contact of the party."
                      },
                      "telefax" : {
                        "type" : "string",
                        "description" : "A fax number of the contact of the party."
                      },
                      "electronicMail" : {
                        "type" : "string",
                        "description" : "An email of the contact of the party."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "supplierAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the supplier."
                  },
                  "customerAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the customer."
                  },
                  "note" : {
                    "type" : "string",
                    "description" : "Free-form description of the party not included in other fields"
                  }
                },
                "required" : [ "partyName" ],
                "additionalProperties" : false
              },
              "delivery" : {
                "description" : "Delivery details.",
                "additionalProperties" : false,
                "properties" : {
                  "actualDeliveryDate" : {
                    "type" : "string",
                    "description" : "Date when the goods/services are delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                  },
                  "deliveryNoteReference" : {
                    "description" : "Identifier of the delivery note document.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the value."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the id."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                }
              },
              "deliveryParty" : {
                "description" : "Party that is responsible for the delivery of the goods/services in the referred business document.",
                "properties" : {
                  "endpoint" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "partyIdentifications" : {
                    "type" : "array",
                    "description" : "An array holding the system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party identification.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "An object holding the system identifier of the party."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "Global identifier of namescheme for party identifier."
                        }
                      },
                      "required" : [ "id" ],
                      "additionalProperties" : false
                    }
                  },
                  "partyName" : {
                    "type" : "string",
                    "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                  },
                  "postalAddress" : {
                    "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                    "properties" : {
                      "cityName" : {
                        "type" : "string",
                        "description" : "The name of the city, town or village in the postal address of the party."
                      },
                      "postalZone" : {
                        "type" : "string",
                        "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                      },
                      "addressLine" : {
                        "type" : "string",
                        "description" : "The address line of the postal address of the party."
                      },
                      "addressLine2" : {
                        "type" : "string",
                        "description" : "The second address line of the postal address of the party."
                      },
                      "addressLine3" : {
                        "type" : "string",
                        "description" : "The third address line of the postal address of the party."
                      },
                      "locality" : {
                        "type" : "string",
                        "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                      },
                      "countrySubentity" : {
                        "type" : "string",
                        "description" : "The sub-entity of the area in the postal address."
                      },
                      "countryId" : {
                        "type" : "string",
                        "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyTaxScheme" : {
                    "type" : "object",
                    "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                    "properties" : {
                      "company" : {
                        "type" : "object",
                        "description" : "Information about the company taxes.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyLegalEntities" : {
                    "type" : "array",
                    "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party legal entity.",
                      "properties" : {
                        "registrationName" : {
                          "type" : "string",
                          "description" : "Registration name of the legal entity."
                        },
                        "companyIdentifier" : {
                          "description" : "Global legal party identifier, including name scheme",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifies the value."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Identifies the namespace of the id."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "required" : [ "registrationName", "companyIdentifier" ],
                      "additionalProperties" : false
                    }
                  },
                  "contact" : {
                    "type" : "object",
                    "description" : "An object containing information about contacts. Used for defining the company contact data",
                    "properties" : {
                      "name" : {
                        "type" : "string",
                        "description" : "A contact name of the party."
                      },
                      "telephone" : {
                        "type" : "string",
                        "description" : "A telephone number of the contact of the party."
                      },
                      "telefax" : {
                        "type" : "string",
                        "description" : "A fax number of the contact of the party."
                      },
                      "electronicMail" : {
                        "type" : "string",
                        "description" : "An email of the contact of the party."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "supplierAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the supplier."
                  },
                  "customerAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the customer."
                  },
                  "note" : {
                    "type" : "string",
                    "description" : "Free-form description of the party not included in other fields"
                  }
                },
                "required" : [ "partyName" ],
                "additionalProperties" : false
              },
              "paymentMeans" : {
                "description" : "An object holding the available payment means.",
                "additionalProperties" : false,
                "properties" : {
                  "paymentMeansCode" : {
                    "type" : "string",
                    "description" : "A code that identifies how the payment can be done. Valid values: UN/ECE 4461 code represented as string."
                  },
                  "paymentDueDate" : {
                    "type" : "string",
                    "description" : "Date when the business document is due for the payment means. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                  },
                  "paymentReferenceMessage" : {
                    "type" : "string",
                    "description" : "A payment reference message. This can be a free text describing the payment."
                  },
                  "paymentIdentifier" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An identifier for a payment made using this means of payment.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "The id value of payment identifier."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Scheme which identifies the type of payment identifier. Possible values are SPY, ISO."
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "financialAccounts" : {
                    "type" : "array",
                    "description" : "Array holding the financial account data",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "Object holding the financial account data",
                      "properties" : {
                        "financialInstitutionName" : {
                          "type" : "string",
                          "description" : "The name of financial institution."
                        },
                        "financialInstitutionId" : {
                          "type" : "string",
                          "description" : "Identifier of financial institution."
                        },
                        "financialInstitutionIdSchemeId" : {
                          "type" : "string",
                          "description" : "The external identifier of the financial institution id identifier element."
                        },
                        "financialInstitutionBranchId" : {
                          "type" : "string",
                          "description" : "The identifier of financial institution branch, for example 342-085. This field is typically used by institutions in Australia and New Zealand."
                        },
                        "financialInstitutionBranchSchemeId" : {
                          "type" : "string",
                          "description" : "The scheme identifier of financial institution branch. For example for an Australian institutions, possible scheme is BSB."
                        },
                        "ids" : {
                          "type" : "array",
                          "description" : "Array holding ids",
                          "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "Object holding identifier data",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "Identifier."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "External identifier."
                              }
                            },
                            "required" : [ "id" ]
                          }
                        },
                        "accounting" : {
                          "type" : "object",
                          "title" : "Accounting",
                          "description" : "Accounting related content.",
                          "properties" : {
                            "virtualBankBarcode" : {
                              "type" : "object",
                              "title" : "VirtualBankBarcode",
                              "description" : "Virtual bar code can be added to the business document that should be printed.",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "title" : "Virtual bank bar code",
                                  "description" : "Identifier of the virtual bar code. "
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "title" : "SchemeId for virtual bank bar code",
                                  "description" : "Scheme identifier of the virtual bank bar code, typically country code according to ISO3166-1 alpha-2. Possible values: FI"
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "required" : [ "paymentMeansCode" ]
              },
              "paymentTerms" : {
                "description" : "Available payment terms.",
                "additionalProperties" : false,
                "properties" : {
                  "settlementPeriod" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An object holding the settlement period dates.",
                    "properties" : {
                      "startDate" : {
                        "type" : "string",
                        "description" : "Date when the payment terms starts. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "endDate" : {
                        "type" : "string",
                        "description" : "Date when the payment terms ends. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      }
                    }
                  },
                  "note" : {
                    "type" : "string",
                    "description" : "Free-form text applying to the payment terms. This field may contain notes or any other similar information that is not contained explicitly in another structure."
                  },
                  "penaltySurchargePercent" : {
                    "type" : "number",
                    "description" : "Penalty surcharge percent amount."
                  }
                }
              },
              "taxTotal" : {
                "description" : "Tax total details.",
                "additionalProperties" : false,
                "properties" : {
                  "currencyId" : {
                    "type" : "string",
                    "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                  },
                  "amount" : {
                    "type" : "number",
                    "description" : "Total amount of the taxes. The total tax amount for particular tax scheme e.g. VAT; the sum of each of the tax subtotals for each tax category within the tax scheme."
                  },
                  "roundingAmount" : {
                    "type" : "number",
                    "description" : "Rounding amount added to the calculated tax total to produce the rounded TotalTaxAmount."
                  },
                  "taxSubtotals" : {
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "An object holding the information about tax.",
                      "properties" : {
                        "currencyId" : {
                          "type" : "string",
                          "description" : "A code that identifies the currency of the tax subtotal. Valid values: ISO 4217 code represented as string."
                        },
                        "amount" : {
                          "type" : "number",
                          "description" : "Total amount of the taxes."
                        },
                        "percent" : {
                          "type" : "number",
                          "description" : "The tax rate for the category, expressed as a percentage."
                        },
                        "taxableAmount" : {
                          "type" : "number",
                          "description" : "Basis of the taxes. The net amount to which the tax percent (rate) is applied to calculate the tax amount."
                        },
                        "taxCategory" : {
                          "type" : "object",
                          "description" : "External identifier of tax category.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifies the tax category identifier."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Identifies the namespace of the tax category identifier."
                            },
                            "name" : {
                              "type" : "string",
                              "description" : "Tax category description."
                            },
                            "taxExemptionReason" : {
                              "type" : "string",
                              "description" : "The reason for tax being exempted."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "required" : [ "currencyId", "amount" ]
                    }
                  }
                },
                "required" : [ "currencyId", "amount" ]
              },
              "invoicePeriod" : {
                "description" : "Invoice period of the business document.",
                "additionalProperties" : false,
                "properties" : {
                  "startDate" : {
                    "description" : "Date when the goods/services are invoiced. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                  },
                  "endDate" : {
                    "description" : "Date when the goods/services are invoiced. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                  }
                }
              },
              "taxExchangeRate" : {
                "description" : " An association to Exchange Rate between the Document Currency and the Tax Currency.",
                "additionalProperties" : false,
                "properties" : {
                  "exchangeRate" : {
                    "type" : "number",
                    "description" : "The factor applied to the source currency to calculate the target currency."
                  }
                }
              },
              "legalMonetaryTotal" : {
                "description" : "Legal monetary details for total amount payable in the business document.",
                "additionalProperties" : false,
                "properties" : {
                  "lineExtensionAmount" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An object holding total amount of line extensions.",
                    "properties" : {
                      "currencyId" : {
                        "type" : "string",
                        "description" : "A code that identifies the currency of the total line extension amount. Valid values: ISO 4217 code represented as string."
                      },
                      "amount" : {
                        "type" : "number",
                        "description" : "Total amount of line extensions."
                      }
                    },
                    "required" : [ "currencyId", "amount" ]
                  },
                  "payableAmount" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An object holding total payable amount of line extensions.",
                    "properties" : {
                      "currencyId" : {
                        "type" : "string",
                        "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                      },
                      "amount" : {
                        "type" : "number",
                        "description" : "The total amount to be paid."
                      }
                    },
                    "required" : [ "currencyId", "amount" ]
                  }
                },
                "required" : [ "payableAmount" ]
              },
              "buyerReference" : {
                "description" : "Buyer reference in the business document.",
                "additionalProperties" : false,
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "The id value of the buyer reference"
                  }
                },
                "required" : [ "id" ]
              },
              "customFields" : {
                "description" : "Custom fields in the business document. Disclaimer! Use of a custom field assumes that the recipient can handle the custom fields. Before using custom field Basware needs to be contacted to assure the delivery of these fields. Additional changes may be incurred due to the use of these fields. There is no guarantee that the recipient can handle the specified custom fields.",
                "items" : {
                  "type" : "object",
                  "description" : "Custom fields in the business document",
                  "additionalProperties" : false,
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "Name of the custom field",
                      "default" : "file"
                    },
                    "value" : {
                      "type" : "string",
                      "description" : "Value of the custom field"
                    },
                    "description" : {
                      "type" : "string",
                      "description" : "The purpose of this field"
                    }
                  },
                  "required" : [ "name", "value" ]
                }
              },
              "documentLines" : {
                "type" : "array",
                "description" : "An array holding the document lines.",
                "items" : {
                  "type" : "object",
                  "additionalProperties" : false,
                  "description" : "A document line",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "External system identifier for the document line."
                    },
                    "note" : {
                      "type" : "string",
                      "description" : "Free-form text conveying information that is not contained explicitly in other structures."
                    },
                    "quantity" : {
                      "description" : "An object holding the quantity of the target Business Document line item.",
                      "additionalProperties" : false,
                      "properties" : {
                        "amount" : {
                          "type" : "number",
                          "description" : "The quantity of the target Business Document line items."
                        },
                        "unitCode" : {
                          "type" : "string",
                          "description" : "The unit code of the quantity of the target Business Document line item. Valid values: UN/ECE CEFACT Trade Facilitation Recommendation No.20 common code value represented as string."
                        }
                      }
                    },
                    "serviceIndicator" : {
                      "type" : "boolean",
                      "description" : "Flag indicating whether the line represents goods or services (true if services, false if goods)."
                    },
                    "lineExtension" : {
                      "description" : "The total amount for the line item, including allowance charges but net of taxes.",
                      "additionalProperties" : false,
                      "properties" : {
                        "currencyId" : {
                          "type" : "string",
                          "description" : "The currency of the amount."
                        },
                        "amount" : {
                          "type" : "number",
                          "description" : "The total amount for the line item, including allowance charges but net of taxes."
                        }
                      },
                      "required" : [ "currencyId", "amount" ]
                    },
                    "item" : {
                      "description" : "An object holding an Business Document line item.",
                      "additionalProperties" : false,
                      "properties" : {
                        "descriptions" : {
                          "type" : "array",
                          "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "Business Document line item.",
                            "properties" : {
                              "description" : {
                                "type" : "string",
                                "description" : "Business Document line item."
                              }
                            }
                          }
                        },
                        "name" : {
                          "type" : "string",
                          "description" : "Name of the Business Document line item.  A short name optionally given to an item, such as a name from a catalogue, as distinct from a description."
                        },
                        "taxPercent" : {
                          "type" : "number",
                          "description" : "Tax amount for the item"
                        },
                        "sellersItem" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "Identifies the Business Document line item as it is in seller's system.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifier of the business document line item as it is in seller's system."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "System specific identifier of the seller's item identifier element. If the source business document has any matching element, it should be used."
                            }
                          },
                          "required" : [ "id" ]
                        },
                        "buyersItem" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "An object holding a identification of the Business Documents line item as it is in buyers system.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifier of the business document line item as it is in buyer's system."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "System specific identifier of the buyer's item identifier element. If the source business document has any matching element, it should be used."
                            }
                          },
                          "required" : [ "id" ]
                        }
                      }
                    },
                    "payment" : {
                      "additionalProperties" : false,
                      "properties" : {
                        "paymentDate" : {
                          "type" : "string",
                          "description" : "Payment timestamp which includes time."
                        },
                        "paymentMeansCode" : {
                          "type" : "string",
                          "description" : "Payment method."
                        },
                        "currencyCode" : {
                          "type" : "string",
                          "description" : "Currency code."
                        },
                        "exchangeRate" : {
                          "type" : "number",
                          "description" : "Exchange rate. Required, if currency code is different from MXN."
                        },
                        "amount" : {
                          "type" : "number",
                          "description" : "Total amount reported in the payment receipt."
                        },
                        "additionalReference" : {
                          "description" : "Reference to a payment, check or other type of payment.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifies the value."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Identifies the namespace of the id."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        },
                        "payer" : {
                          "description" : "Payer details.",
                          "additionalProperties" : false,
                          "properties" : {
                            "financialInstitution" : {
                              "type" : "object",
                              "description" : "Financial institution for payer account details.",
                              "properties" : {
                                "taxCode" : {
                                  "type" : "string",
                                  "description" : "Sender tax code."
                                },
                                "name" : {
                                  "type" : "string",
                                  "description" : "Financial institution name."
                                },
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the financial institution."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the financial institution."
                                }
                              }
                            },
                            "financialAccount" : {
                              "description" : "Financial account for payer",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the value."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the id."
                                }
                              },
                              "required" : [ "id" ],
                              "additionalProperties" : false
                            }
                          }
                        },
                        "payee" : {
                          "description" : "Payee details.",
                          "additionalProperties" : false,
                          "properties" : {
                            "financialAccount" : {
                              "description" : "Financial account for payee",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the value."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the id."
                                }
                              },
                              "required" : [ "id" ],
                              "additionalProperties" : false
                            }
                          }
                        },
                        "financialInstitutionTransactionType" : {
                          "type" : "string",
                          "description" : "Optional field for financial institution transaction type. Currently only one value supported (SPEI type of transactions)."
                        },
                        "certificateByEinvoicingAuthority" : {
                          "type" : "string",
                          "description" : "The certificate that protects the payment, as a text string in base 64 format. It is required in case the transaction type attribute contains information. This field is related to SPEI."
                        },
                        "paymentReferenceId" : {
                          "type" : "string",
                          "description" : "The original string of the payment voucher generated by the issuing entity of the beneficiary account. It is required in case the transaction type attribute contains information. This field is related to SPEI."
                        },
                        "digitalCompanyCertificate" : {
                          "type" : "string",
                          "description" : "The digital seal that is associated with the payment. This field is related to SPEI."
                        },
                        "documentReferences" : {
                          "description" : "Document references",
                          "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                              "taxAuthorityDocumentId" : {
                                "type" : "string",
                                "description" : "The identifier of the document related to the payment. This data can be a tax identifier of the electronic invoice or the operation number of a digital document."
                              },
                              "documentSerialNumber" : {
                                "type" : "string",
                                "description" : "The series of the voucher for internal control of the taxpayer."
                              },
                              "documentId" : {
                                "type" : "string",
                                "description" : "The folio of the voucher for internal control of the taxpayer."
                              },
                              "currencyCode" : {
                                "type" : "string",
                                "description" : "The currency used in the amounts of the related document, when national currency is used or the related document does not specify the currency is MXN. Conforms to the ISO 4217 specification."
                              },
                              "exchangeRate" : {
                                "type" : "number",
                                "description" : "The exchange rate in accordance with the currency recorded in the related document. It is required when the currency of the related document is different from the currency of payment."
                              },
                              "paymentMethod" : {
                                "type" : "string",
                                "description" : "The key to the payment method that was recorded in the related document."
                              },
                              "installmentCount" : {
                                "type" : "integer",
                                "description" : "The installment number that corresponds to the payment. It is required when payment is in installments or deferred."
                              },
                              "unpaidAmount" : {
                                "type" : "number",
                                "description" : "The amount of the unpaid balance of the previous installment. It is required when payment is in installments or deferred."
                              },
                              "paidAmount" : {
                                "type" : "number",
                                "description" : "The amount paid for the related document. It is mandatory when there is more than one related document or when there is a related document and exchangeRate has a value."
                              },
                              "remainingAmount" : {
                                "type" : "number",
                                "description" : "The difference between the amount of the previous balance and the amount of the payment. It is required when payment is in installments or deferred."
                              }
                            }
                          },
                          "required" : [ "taxAuthorityDocumentId", "currencyCode", "paymentMethod" ]
                        }
                      },
                      "required" : [ "paymentDate", "paymentMeansCode", "currencyCode", "amount", "documentReferences" ]
                    },
                    "taxTotals" : {
                      "description" : "An array holding the information about the taxes.",
                      "items" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An object holding the information about tax.",
                        "properties" : {
                          "amount" : {
                            "type" : "number",
                            "description" : "Total amount of the taxes. The total tax amount for particular tax scheme e.g. VAT; the sum of each of the tax subtotals for each tax category within the tax scheme."
                          },
                          "currencyId" : {
                            "type" : "string",
                            "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                          },
                          "transactionCurrencyTax" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "An object holding transaction tax.",
                            "properties" : {
                              "amount" : {
                                "type" : "number",
                                "description" : "Amount of tax for the transaction."
                              }
                            },
                            "required" : [ "amount" ]
                          },
                          "taxSubtotals" : {
                            "items" : {
                              "type" : "object",
                              "additionalProperties" : false,
                              "description" : "An object holding the information about tax.",
                              "properties" : {
                                "currencyId" : {
                                  "type" : "string",
                                  "description" : "A code that identifies the currency of the tax subtotal. Valid values: ISO 4217 code represented as string."
                                },
                                "amount" : {
                                  "type" : "number",
                                  "description" : "Total amount of the taxes."
                                },
                                "percent" : {
                                  "type" : "number",
                                  "description" : "The tax rate for the category, expressed as a percentage."
                                },
                                "taxableAmount" : {
                                  "type" : "number",
                                  "description" : "Basis of the taxes. The net amount to which the tax percent (rate) is applied to calculate the tax amount."
                                },
                                "taxCategory" : {
                                  "type" : "object",
                                  "description" : "External identifier of tax category.",
                                  "properties" : {
                                    "id" : {
                                      "type" : "string",
                                      "description" : "Identifies the tax category identifier."
                                    },
                                    "schemeId" : {
                                      "type" : "string",
                                      "description" : "Identifies the namespace of the tax category identifier."
                                    },
                                    "name" : {
                                      "type" : "string",
                                      "description" : "Tax category description."
                                    },
                                    "taxExemptionReason" : {
                                      "type" : "string",
                                      "description" : "The reason for tax being exempted."
                                    }
                                  },
                                  "required" : [ "id" ],
                                  "additionalProperties" : false
                                }
                              },
                              "required" : [ "currencyId", "amount" ]
                            }
                          }
                        },
                        "required" : [ "amount", "currencyId" ]
                      }
                    },
                    "price" : {
                      "description" : "An object holding the information about the price of the line item.",
                      "additionalProperties" : false,
                      "properties" : {
                        "amount" : {
                          "type" : "number",
                          "description" : "The price of the line item."
                        },
                        "currencyId" : {
                          "type" : "string",
                          "description" : "A code that identifies the currency of the line item price. Valid values: ISO 4217 code represented as string."
                        }
                      },
                      "required" : [ "amount", "currencyId" ]
                    },
                    "delivery" : {
                      "description" : "An object holding delivery data",
                      "additionalProperties" : false,
                      "properties" : {
                        "actualDeliveryDate" : {
                          "description" : "Date when the goods/services are delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                          "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                        },
                        "promisedDeliveryPeriod" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "Promised delivery period",
                          "properties" : {
                            "startDate" : {
                              "description" : "Earliest date when the goods/services are promised to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                            },
                            "endDate" : {
                              "description" : "Latest date when the goods/services are promised to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                            }
                          }
                        },
                        "deliveryAddress" : {
                          "description" : "An object containing address information. Used for defining delivery address party data.",
                          "properties" : {
                            "cityName" : {
                              "type" : "string",
                              "description" : "The name of the city, town or village in the postal address of the party."
                            },
                            "postalZone" : {
                              "type" : "string",
                              "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                            },
                            "addressLine" : {
                              "type" : "string",
                              "description" : "The address line of the postal address of the party."
                            },
                            "addressLine2" : {
                              "type" : "string",
                              "description" : "The second address line of the postal address of the party."
                            },
                            "addressLine3" : {
                              "type" : "string",
                              "description" : "The third address line of the postal address of the party."
                            },
                            "locality" : {
                              "type" : "string",
                              "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                            },
                            "countrySubentity" : {
                              "type" : "string",
                              "description" : "The sub-entity of the area in the postal address."
                            },
                            "countryId" : {
                              "type" : "string",
                              "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                            }
                          },
                          "additionalProperties" : false
                        }
                      }
                    },
                    "orderLineReference" : {
                      "description" : "An object holding order line reference data",
                      "additionalProperties" : false,
                      "properties" : {
                        "lineId" : {
                          "type" : "string",
                          "description" : "An identifier for the referenced order line, assigned by the buyer."
                        },
                        "orderReference" : {
                          "type" : "string",
                          "description" : "A reference to the order containing the referenced order line."
                        }
                      },
                      "required" : [ "lineId" ]
                    },
                    "allowanceCharges" : {
                      "description" : "Extra payment or subtraction to Business Document, for example freight or handling fees.",
                      "additionalProperties" : false,
                      "items" : {
                        "type" : "object",
                        "properties" : {
                          "chargeIndicator" : {
                            "type" : "boolean",
                            "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
                          },
                          "allowanceChargeReasonCode" : {
                            "type" : "string",
                            "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code"
                          },
                          "allowanceChargeReason" : {
                            "type" : "string",
                            "description" : "The reason for this allowance or charge."
                          },
                          "multiplierFactorNumeric" : {
                            "type" : "number",
                            "description" : "The factor applied to the base amount to calculate the allowance charge."
                          },
                          "amount" : {
                            "type" : "number",
                            "description" : "The allowance charge amount."
                          },
                          "taxCategories" : {
                            "type" : "array",
                            "description" : "External identifier of tax category.",
                            "items" : {
                              "type" : "object",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the tax category identifier."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the tax category identifier."
                                },
                                "name" : {
                                  "type" : "string",
                                  "description" : "Tax category description."
                                },
                                "percent" : {
                                  "type" : "number",
                                  "description" : "Identifies the tax rate for this category, expressed as a percentage"
                                },
                                "taxExemptionReasonCode" : {
                                  "type" : "string",
                                  "description" : "Identifies the reason for tax being exempted, expressed as a code."
                                },
                                "taxExemptionReason" : {
                                  "type" : "string",
                                  "description" : "Identifies the reason for tax being exempted, expressed as text."
                                }
                              }
                            },
                            "required" : [ "id" ],
                            "additionalProperties" : false
                          }
                        }
                      },
                      "required" : [ "chargeIndicator", "amount" ]
                    },
                    "customFields" : {
                      "description" : "Custom fields in the business document. Disclaimer! Use of a custom field assumes that the recipient can handle the custom fields. Before using custom field Basware needs to be contacted to assure the delivery of these fields. Additional changes may be incurred due to the use of these fields. There is no guarantee that the recipient can handle the specified custom fields.",
                      "items" : {
                        "type" : "object",
                        "description" : "Custom fields in the business document",
                        "additionalProperties" : false,
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "Name of the custom field",
                            "default" : "file"
                          },
                          "value" : {
                            "type" : "string",
                            "description" : "Value of the custom field"
                          },
                          "description" : {
                            "type" : "string",
                            "description" : "The purpose of this field"
                          }
                        },
                        "required" : [ "name", "value" ]
                      }
                    },
                    "additionalItemProperties" : {
                      "description" : "Associates the item with a set of additional properties.",
                      "items" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "The name of the Item Property."
                          },
                          "value" : {
                            "type" : "string",
                            "description" : "The value of the Item Property"
                          }
                        },
                        "required" : [ "name", "value" ]
                      }
                    }
                  },
                  "required" : [ "id", "lineExtension", "item" ]
                }
              }
            },
            "required" : [ "externalDocumentIdentifier", "issueDate", "accountingSupplierParty", "accountingCustomerParty", "legalMonetaryTotal", "documentLines" ]
        }
    },
    "required": [
        "clientToken",
        "documentType",
        "data"
    ]
}

Response code 400 - Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.

Response example for the response code above 

{
  "error": {
    "id": "c842c9c3-75e5-4c32-ae3f-c1fe250fc186",
    "type": "VALIDATION",
    "message": "Business document identifier bumId does not match the pattern :[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}",
    "code": "Error.004.0003",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

Response code 500 - Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

Response example for the response code above 

{
  "error": {
    "id": "a312a9b3-35e5-1a32-be3f-a5fe250fc121",
    "type": "TECHNICAL",
    "message": "BCN encountered an unexpected system error",
    "code": "Error.001.0006",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

You can send invoices to a recipient through Basware Network using the POST invoices method.

Request URI

https://api.basware.com/v3/invoices/{bumId}

URI Parameters

Param Name Type Required Example Description
bumId string true 6741ecc7-848a-443c-83ad-ea95e4df06fa Unique UUID for invoice

Request Headers

Param Name Required Example Description
Content-Type true application/json Specifies media types which are acceptable for the request. Value application/json is supported.
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Query Parameters

Param Name Required Example Description
action false Optional parameter to define what action will be performed. The default action is to the business document will be delivered immediately. Possible values are startDelivery (default), store.

Responses

Response code Description
201 The request has been fulfilled successfully and new resource is created on server.
400 Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
409 Conflict. The request could not be completed due to a conflict with the current state of the target resource.
415 Unsupported Media Type. The server is refusing to service the request because the payload is in an unsupported format.
500 Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

API for Credit Notes v2

CreditNotes

The Credit Note API lets you send credit notes through Basware Network to a recipient. If you need to add attachments to your credit note, you can deliver those, too, using the Files API.

GET

GET /creditNotes/{bumId} HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Response code 200 - The request has been completed successfully.

Response example for the response code above 

{
  "bumId": "fedd8dec-af24-430e-8944-a056474816c2",
  "fileRefs": [
    {
      "refId": "539a583684aed4025464947d",
      "fileType": "imageFile"
    },
    {
      "refId": "516a255684aed4025464947d",
      "fileType": "attachmentFile"
    }
  ],
  "links": [
    {
      "rel": "file",
      "href": "https://api.basware.com/v2/files/539a78446842ed4025464947d",
      "method": "GET"
    },
    {
      "rel": "file",
      "href": "https://api.basware.com/v2/files/516a255684aed4025464947d",
      "method": "GET"
    }
  ],
  "origin": {
    "source": "SendingCustomer",
    "sourceContentCategory": "StructuredData",
    "sourceChannelCategory": "Electronic",
    "processQualityIndicators": [
      "ContentValidation",
      "StructuralValidation"
    ]
  },
  "data": {
    "externalDocumentIdentifier": {
      "id": "56328230"
    },
    "issueDate": "2017-05-01",
    "documentCurrencyCode": "EUR",
    "contractDocumentReferences": [
      {
      "id": "147217"
      }
    ],
    "accountingSupplierParty": {
      "partyName": "Acme Supplier Inc.",
      "postalAddress": {
        "addressLine": "1800 Main Street",
        "cityName": "Dallas",
        "postalZone": "75201",
        "countrySubentity": "TX",
        "countryId": "US"
      }
    },
    "accountingCustomerParty": {
      "partyName": "Acme Buyer N.V.",
      "postalAddress": {
        "addressLine": "Sint Gummarusstraat 53",
        "cityName": "Antwerpen",
        "postalZone": "2060",
        "countryId": "BE"
      }
    },
    "deliveryParty": {
      "partyName": "Parcels United",
      "postalAddress": {
        "addressLine": "1 Back Lane",
        "locality": "Clayton West",
        "cityName": "HUDDERSFIELD",
        "postalZone": "HD8 9PP",
        "countryId": "UK"
      }
    },
    "paymentMeans": {
      "financialAccounts": [
        {
          "financialInstitutionName": "OKOYFIHH",
          "ids": [
            {
              "id": "FI8650000110001238",
              "schemeId": "IBAN"
            }
          ]
        }
      ],
      "paymentDueDate": "2015-06-30",
      "paymentIdentifier": {
        "id": "63156783578924"
      },
      "paymentMeansCode": "31"
    },
    "taxTotal": {
      "amount": 89.56,
      "currencyId": "EUR",
      "taxSubtotals": [
        {
          "taxableAmount": 373.24,
          "amount": 89.56,
          "currencyId": "EUR",
          "percent": 24
        }
      ]
    },
    "buyerReference": {
      "id": "PO-15512324"
    },
    "legalMonetaryTotal": {
      "payableAmount": {
        "amount": 462.8,
        "currencyId": "EUR"
      }
    },
    "creditNoteLines": [
      {
        "id": "1",
        "quantity": {
          "amount": 2,
          "unitCode": "PCE"
        },
        "lineExtension": {
          "currencyId": "EUR",
          "amount": 93
        },
        "item": {
          "description": [
            "Basic High-Speed HDMI Cable - 25 Feet",
            "Supports Ethernet, 3D, 4K and Audio Return"
          ],
          "name": "High-Speed HDMI Cable",
          "taxPercent": 10,
          "sellersItem": {
            "id": "B-341"
          }
        },
        "taxTotals": [
          {
            "currencyId": "EUR",
            "amount": 17.28,
            "transactionCurrencyTax": {
              "amount": 0.9
            },
            "taxSubtotals": [
              {
                "currencyId": "EUR",
                "amount": 17.28,
                "percent": 24
              }
            ]
          }
        ]
      },
      {
        "id": "2",
        "quantity": {
          "amount": 1,
          "unitCode": "PCE"
        },
        "lineExtension": {
          "currencyId": "EUR",
          "amount": 23.1
        },
        "item": {
          "sellersItem": {
            "id": "A-532"
          },
          "taxPercent": 10
        },
        "taxTotals": [
          {
            "currencyId": "EUR",
            "amount": 5.54,
            "transactionCurrencyTax": {
              "amount": 0.9
            },
            "taxSubtotals": [
              {
                "currencyId": "EUR",
                "amount": 5.54,
                "percent": 24
              }
            ]
          }
        ]
      }
    ]
  }
}

Response schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Schema for GET /creditNotes",
  "description": "Credit note is a business document related to an invoice.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "bumId": {
      "description": "Identifies the business document (Basware Unique Message Identifier). It is an unique identifier (UUID) that can be used by external systems to identify a business document.",
      "pattern" : "^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$"
    },
    "fileRefs": {
      "items" : {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
          "refId" : {
            "type" : "string",
            "description" : "Unique file identifier received after storing file into Basware Network."
          },
          "fileType" : {
            "type" : "string",
            "description" : "File type. Possible values are imageFile, attachmentFile and dataFile."
          }
        },
        "required" : [ "refId", "fileType" ]
      }
    },
    "links": {
      "items" : {
        "type" : "object",
        "description" : "Links related to the business document",
        "properties" : {
          "rel" : {
            "type" : "string",
            "description" : "Relation type for the URL in question. Possible values are file.",
            "default" : "file"
          },
          "href" : {
            "type" : "string",
            "description" : "Link between the completed call and a future call. The URI is a fully formed URI, which needs also the method field"
          },
          "method" : {
            "type" : "string",
            "enum" : [ "GET", "POST" ],
            "description" : "HTTP methods required to interact with the provided URL",
            "default" : "GET"
          }
        }
      }
    },
    "origin": {
      "additionalProperties" : false,
      "properties" : {
        "source" : {
          "type" : "string",
          "description" : "The originating source of the document. Possible values: SendingCustomer, ReceivingCustomer, ServiceProvider"
        },
        "sourceContentCategory" : {
          "type" : "string",
          "description" : "Indicates the source content. If the content is structured data, the data quality is higher. Possible values: Image, StructuredData, UnstructuredData"
        },
        "sourceChannelCategory" : {
          "type" : "string",
          "description" : "Indicates the source channel of the business document. Possible values: PostalMail, ElectronicMail, Electronic"
        },
        "processQualityIndicators" : {
          "type" : "array",
          "description" : "The quality phases the document has gone through",
          "items" : {
            "type" : "string",
            "description" : "Possible values: HumanSelfValidation, HumanValidation, StructuralValidation, ContentValidation"
          }
        }
      }
    },
    "data": {
      "type": "object",
      "additionalProperties": false,
      "description": "Object holding the business content of the Credit Note. Content is at some level based on Universal Business Language (UBL) standard version 2.1. It has also been extended by Basware so it is not strictly UBL.",
      "properties": {
        "externalDocumentIdentifier": {
            "description": "External system identifier of the business document. Serial number that is issued once only by invoice issuer to identify the credit note.",
            "properties" : {
              "id" : {
                "type" : "string",
                "description" : "Identifies the value."
              },
              "schemeId" : {
                "type" : "string",
                "description" : "Identifies the namespace of the id."
              }
            },
            "required" : [ "id" ],
            "additionalProperties" : false
        },
        "issueDate": {
          "type": "string",
          "description": "The date when the Credit Note was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
          "pattern": "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
        },
        "documentCurrencyCode": {
          "type": "string",
          "description": "Currency presentation of the Credit Note document. Valid values must be ISO 4217 Alpha format."
        },
        "note": {
          "type": "string",
          "description": "Free-form text pertinent to this document, conveying information that is not contained explicitly in other structures."
        },
        "allowanceCharges": {
          "additionalProperties" : false,
          "items" : {
            "type" : "object",
            "properties" : {
              "changeIndicator" : {
                "type" : "boolean",
                "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
              },
              "allowanceChargeReasonCode" : {
                "type" : "string",
                "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code"
              },
              "allowanceChargeReason" : {
                "type" : "string",
                "description" : "The reason for this allowance or charge."
              },
              "multiplierFactorNumeric" : {
                "type" : "number",
                "description" : "The factor applied to the base amount to calculate the allowance charge."
              },
              "amount" : {
                "type" : "number",
                "description" : "The allowance charge amount."
              }
            },
            "required" : [ "changeIndicator", "amount" ]
          }
        },
        "isIssuedAgainstOrder": {
            "type": "boolean",
            "description": "Indicates whether the business document is issued against an order."
        },
        "orderReference": {
          "description": "Order reference on the business document.",
          "additionalProperties" : false,
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "Order number reference on the business document. Identifies the referenced order assigned by the buyer."
            },
            "schemeId" : {
              "type" : "string",
              "description" : "External system specific identifier of the order system identifier element. If the source business document has any matching element, it should be used."
            },
            "customerReference" : {
              "type" : "string",
              "description" : "Customer Reference Identifier (CRI) when using a purchasing card."
            },
            "salesOrderId" : {
              "type" : "string",
              "description" : "Sales order identifier."
            }
          },
          "required" : [ "id" ]
        },
        "billingReference": {
          "description": "External system identifier object for the billing entity referenced by the business document.",
          "additionalProperties" : false,
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "External system identifier of the billing entity referenced by the Business Document."
            },
            "schemeId" : {
              "type" : "string",
              "description" : "External system specific identifier of the billing reference system identifier element. If the source business document has any matching element, it should be used."
            }
          },
          "required" : [ "id" ]
        },
        "contractDocumentReferences": {
          "description": "External system identifiers for the contracts referenced by the business document.",
          "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
              "id" : {
                "type" : "string",
                "description" : "External system identifier of the contract referenced by the Business Document (i.e. buyers contract number). Mandatory field if the customer demands that the goods or services invoiced refer to a contract number defined by the customer to which he wants to assign the Business Document. Is demanded for example in service and maintenance agreements for which there is generally no explicit order."
              },
              "schemeId" : {
                "type" : "string",
                "description" : "External system specific identifier of the contract system identifier element. If the source business document has any matching element, it should be used."
              }
            },
            "required" : [ "id" ]
          }
        },
        "additionalDocumentReference": {
          "description": "A reference to an additional document associated with this document. Used for example to reference to an Invoice from Credit Note.",
          "additionalProperties" : false,
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "An identifier for the referenced document (i.e. bumid)."
            },
            "schemeId" : {
              "type" : "string",
              "description" : "External system specific identifier of the invoicing system identifier element. If the source business document has any matching element, it should be used."
            },
            "issueDate" : {
              "type" : "string",
              "description" : "Date when the referenced document was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
            },
            "typeCode" : {
              "type" : "string",
              "description" : "The type of document being referenced, expressed as a code, for example to reference to an Invoice document, code is 380."
            }
          },
          "required" : [ "id" ]
        },
        "accountingSupplierParty": {
          "description": "Party that is the accountable supplier of the goods/services in the referred business document.",
          "properties" : {
            "endpoint" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                }
              },
              "required" : [ "id" ]
            },
            "partyIdentifications" : {
              "type" : "array",
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party identification.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "An object holding the external system identifier of the party."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "External global identifier of the id identifier element."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              }
            },
            "partyName" : {
              "type" : "string",
              "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
            },
            "postalAddress" : {
              "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
              "properties" : {
                "cityName" : {
                  "type" : "string",
                  "description" : "The name of the city, town or village in the postal address of the party."
                },
                "postalZone" : {
                  "type" : "string",
                  "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                },
                "addressLine" : {
                  "type" : "string",
                  "description" : "The address line of the postal address of the party."
                },
                "addressLine2" : {
                  "type" : "string",
                  "description" : "The second address line of the postal address of the party."
                },
                "addressLine3" : {
                  "type" : "string",
                  "description" : "The third address line of the postal address of the party."
                },
                "locality" : {
                  "type" : "string",
                  "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                },
                "countrySubentity" : {
                  "type" : "string",
                  "description" : "The sub-entity of the area in the postal address."
                },
                "countryId" : {
                  "type" : "string",
                  "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                }
              },
              "additionalProperties" : false
            },
            "partyTaxScheme" : {
              "type" : "object",
              "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
              "properties" : {
                "company" : {
                  "type" : "object",
                  "description" : "Information about the company taxes.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "additionalProperties" : false
            },
            "contact" : {
              "type" : "object",
              "description" : "An object containing information about contacts. Used for defining the company contact data",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "A contact name of the party."
                },
                "telephone" : {
                  "type" : "string",
                  "description" : "A telephone number of the contact of the party."
                },
                "telefax" : {
                  "type" : "string",
                  "description" : "A fax number of the contact of the party."
                },
                "electronicMail" : {
                  "type" : "string",
                  "description" : "An email of the contact of the party."
                }
              },
              "additionalProperties" : false
            }
          },
          "required" : [ "partyName" ],
          "additionalProperties" : false
        },
        "accountingCustomerParty": {
          "description": "Party that is the accountable buyer of the goods/services in the referred business document.",
          "properties" : {
            "endpoint" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                }
              },
              "required" : [ "id" ]
            },
            "partyIdentifications" : {
              "type" : "array",
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party identification.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "An object holding the external system identifier of the party."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "External global identifier of the id identifier element."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              }
            },
            "partyName" : {
              "type" : "string",
              "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
            },
            "postalAddress" : {
              "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
              "properties" : {
                "cityName" : {
                  "type" : "string",
                  "description" : "The name of the city, town or village in the postal address of the party."
                },
                "postalZone" : {
                  "type" : "string",
                  "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                },
                "addressLine" : {
                  "type" : "string",
                  "description" : "The address line of the postal address of the party."
                },
                "addressLine2" : {
                  "type" : "string",
                  "description" : "The second address line of the postal address of the party."
                },
                "addressLine3" : {
                  "type" : "string",
                  "description" : "The third address line of the postal address of the party."
                },
                "locality" : {
                  "type" : "string",
                  "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                },
                "countrySubentity" : {
                  "type" : "string",
                  "description" : "The sub-entity of the area in the postal address."
                },
                "countryId" : {
                  "type" : "string",
                  "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                }
              },
              "additionalProperties" : false
            },
            "partyTaxScheme" : {
              "type" : "object",
              "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
              "properties" : {
                "company" : {
                  "type" : "object",
                  "description" : "Information about the company taxes.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "additionalProperties" : false
            },
            "contact" : {
              "type" : "object",
              "description" : "An object containing information about contacts. Used for defining the company contact data",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "A contact name of the party."
                },
                "telephone" : {
                  "type" : "string",
                  "description" : "A telephone number of the contact of the party."
                },
                "telefax" : {
                  "type" : "string",
                  "description" : "A fax number of the contact of the party."
                },
                "electronicMail" : {
                  "type" : "string",
                  "description" : "An email of the contact of the party."
                }
              },
              "additionalProperties" : false
            }
          },
          "required" : [ "partyName" ],
          "additionalProperties" : false
        },
        "buyerCustomerParty": {
            "description": "Party that is the buyer of the goods/services in the referred business document.",
            "properties" : {
              "endpoint" : {
                "type" : "object",
                "additionalProperties" : false,
                "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                  }
                },
                "required" : [ "id" ]
              },
              "partyIdentifications" : {
                "type" : "array",
                "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                "items" : {
                  "type" : "object",
                  "description" : "An object holding a party identification.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "An object holding the external system identifier of the party."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External global identifier of the id identifier element."
                    }
                  },
                  "required" : [ "id" ],
                  "additionalProperties" : false
                }
              },
              "partyName" : {
                "type" : "string",
                "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
              },
              "postalAddress" : {
                "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                "properties" : {
                  "cityName" : {
                    "type" : "string",
                    "description" : "The name of the city, town or village in the postal address of the party."
                  },
                  "postalZone" : {
                    "type" : "string",
                    "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                  },
                  "addressLine" : {
                    "type" : "string",
                    "description" : "The address line of the postal address of the party."
                  },
                  "addressLine2" : {
                    "type" : "string",
                    "description" : "The second address line of the postal address of the party."
                  },
                  "addressLine3" : {
                    "type" : "string",
                    "description" : "The third address line of the postal address of the party."
                  },
                  "locality" : {
                    "type" : "string",
                    "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                  },
                  "countrySubentity" : {
                    "type" : "string",
                    "description" : "The sub-entity of the area in the postal address."
                  },
                  "countryId" : {
                    "type" : "string",
                    "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                  }
                },
                "additionalProperties" : false
              },
              "partyTaxScheme" : {
                "type" : "object",
                "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                "properties" : {
                  "company" : {
                    "type" : "object",
                    "description" : "Information about the company taxes.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                      }
                    },
                    "additionalProperties" : false
                  }
                },
                "additionalProperties" : false
              },
              "contact" : {
                "type" : "object",
                "description" : "An object containing information about contacts. Used for defining the company contact data",
                "properties" : {
                  "name" : {
                    "type" : "string",
                    "description" : "A contact name of the party."
                  },
                  "telephone" : {
                    "type" : "string",
                    "description" : "A telephone number of the contact of the party."
                  },
                  "telefax" : {
                    "type" : "string",
                    "description" : "A fax number of the contact of the party."
                  },
                  "electronicMail" : {
                    "type" : "string",
                    "description" : "An email of the contact of the party."
                  }
                },
                "additionalProperties" : false
              }
            },
            "required" : [ "partyName" ],
            "additionalProperties" : false
        },
        "sellerSupplierParty": {
            "description": "Party that is the supplier of the goods/services in the referred business document.",
            "properties" : {
              "endpoint" : {
                "type" : "object",
                "additionalProperties" : false,
                "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                  }
                },
                "required" : [ "id" ]
              },
              "partyIdentifications" : {
                "type" : "array",
                "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                "items" : {
                  "type" : "object",
                  "description" : "An object holding a party identification.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "An object holding the external system identifier of the party."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External global identifier of the id identifier element."
                    }
                  },
                  "required" : [ "id" ],
                  "additionalProperties" : false
                }
              },
              "partyName" : {
                "type" : "string",
                "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
              },
              "postalAddress" : {
                "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                "properties" : {
                  "cityName" : {
                    "type" : "string",
                    "description" : "The name of the city, town or village in the postal address of the party."
                  },
                  "postalZone" : {
                    "type" : "string",
                    "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                  },
                  "addressLine" : {
                    "type" : "string",
                    "description" : "The address line of the postal address of the party."
                  },
                  "addressLine2" : {
                    "type" : "string",
                    "description" : "The second address line of the postal address of the party."
                  },
                  "addressLine3" : {
                    "type" : "string",
                    "description" : "The third address line of the postal address of the party."
                  },
                  "locality" : {
                    "type" : "string",
                    "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                  },
                  "countrySubentity" : {
                    "type" : "string",
                    "description" : "The sub-entity of the area in the postal address."
                  },
                  "countryId" : {
                    "type" : "string",
                    "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                  }
                },
                "additionalProperties" : false
              },
              "partyTaxScheme" : {
                "type" : "object",
                "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                "properties" : {
                  "company" : {
                    "type" : "object",
                    "description" : "Information about the company taxes.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                      }
                    },
                    "additionalProperties" : false
                  }
                },
                "additionalProperties" : false
              },
              "contact" : {
                "type" : "object",
                "description" : "An object containing information about contacts. Used for defining the company contact data",
                "properties" : {
                  "name" : {
                    "type" : "string",
                    "description" : "A contact name of the party."
                  },
                  "telephone" : {
                    "type" : "string",
                    "description" : "A telephone number of the contact of the party."
                  },
                  "telefax" : {
                    "type" : "string",
                    "description" : "A fax number of the contact of the party."
                  },
                  "electronicMail" : {
                    "type" : "string",
                    "description" : "An email of the contact of the party."
                  }
                },
                "additionalProperties" : false
              }
            },
            "required" : [ "partyName" ],
            "additionalProperties" : false
        },
        "delivery": {
          "description": "Delivery details.",
          "additionalProperties" : false,
          "properties" : {
            "actualDeliveryDate" : {
              "type" : "string",
              "description" : "Date when the goods/services are delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
            }
          }
        },
        "deliveryParty": {
          "description": "Party that is responsible for the delivery of the goods/services in the referred business document.",
          "properties" : {
            "endpoint" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                }
              },
              "required" : [ "id" ]
            },
            "partyIdentifications" : {
              "type" : "array",
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party identification.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "An object holding the external system identifier of the party."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "External global identifier of the id identifier element."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              }
            },
            "partyName" : {
              "type" : "string",
              "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
            },
            "postalAddress" : {
              "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
              "properties" : {
                "cityName" : {
                  "type" : "string",
                  "description" : "The name of the city, town or village in the postal address of the party."
                },
                "postalZone" : {
                  "type" : "string",
                  "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                },
                "addressLine" : {
                  "type" : "string",
                  "description" : "The address line of the postal address of the party."
                },
                "addressLine2" : {
                  "type" : "string",
                  "description" : "The second address line of the postal address of the party."
                },
                "addressLine3" : {
                  "type" : "string",
                  "description" : "The third address line of the postal address of the party."
                },
                "locality" : {
                  "type" : "string",
                  "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                },
                "countrySubentity" : {
                  "type" : "string",
                  "description" : "The sub-entity of the area in the postal address."
                },
                "countryId" : {
                  "type" : "string",
                  "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                }
              },
              "additionalProperties" : false
            },
            "partyTaxScheme" : {
              "type" : "object",
              "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
              "properties" : {
                "company" : {
                  "type" : "object",
                  "description" : "Information about the company taxes.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "additionalProperties" : false
            },
            "contact" : {
              "type" : "object",
              "description" : "An object containing information about contacts. Used for defining the company contact data",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "A contact name of the party."
                },
                "telephone" : {
                  "type" : "string",
                  "description" : "A telephone number of the contact of the party."
                },
                "telefax" : {
                  "type" : "string",
                  "description" : "A fax number of the contact of the party."
                },
                "electronicMail" : {
                  "type" : "string",
                  "description" : "An email of the contact of the party."
                }
              },
              "additionalProperties" : false
            }
          },
          "required" : [ "partyName" ],
          "additionalProperties" : false
        },
        "paymentMeans": {
          "description": "An object holding the available payment means.",
          "additionalProperties" : false,
          "properties" : {
            "paymentMeansCode" : {
              "type" : "string",
              "description" : "A code that identifies how the payment can be done. Valid values: UN/ECE 4461 code represented as string."
            },
            "paymentDueDate" : {
              "type" : "string",
              "description" : "Date when the business document is due for the payment means. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
            },
            "paymentReferenceMessage" : {
              "type" : "string",
              "description" : "A payment reference message. This can be a free text describing the payment."
            },
            "paymentIdentifier" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An identifier for a payment made using this means of payment.",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "The id value of payment identifier."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "Scheme which identifies the type of payment identifier. Possible values are SPY, ISO."
                }
              },
              "required" : [ "id" ]
            },
            "financialAccounts" : {
              "type" : "array",
              "description" : "Array holding the financial account data",
              "items" : {
                "type" : "object",
                "additionalProperties" : false,
                "description" : "Object holding the financial account data",
                "properties" : {
                  "financialInstitutionName" : {
                    "type" : "string",
                    "description" : "The name of financial institution."
                  },
                  "financialInstitutionId" : {
                    "type" : "string",
                    "description" : "Identifier of financial institution."
                  },
                  "financialInstitutionIdSchemeId" : {
                    "type" : "string",
                    "description" : "The external identifier of the financial institution id identifier element."
                  },
                  "financialInstitutionBranchId" : {
                    "type" : "string",
                    "description" : "The identifier of financial institution branch, for example 342-085. This field is typically used by institutions in Australia and New Zealand."
                  },
                  "financialInstitutionBranchSchemeId" : {
                    "type" : "string",
                    "description" : "The scheme identifier of financial institution branch. For example for an Australian institutions, possible scheme is BSB."
                  },
                  "ids" : {
                    "type" : "array",
                    "description" : "Array holding ids",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "Object holding identifier data",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "Identifier."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "External identifier."
                        }
                      },
                      "required" : [ "id" ]
                    }
                  },
                  "accounting" : {
                    "type" : "object",
                    "title" : "Accounting",
                    "description" : "Accounting related content.",
                    "properties" : {
                      "virtualBankBarcode" : {
                        "type" : "object",
                        "title" : "VirtualBankBarcode",
                        "description" : "Virtual bar code can be added to the business document that should be printed.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "title" : "Virtual bank bar code",
                            "description" : "Identifier of the virtual bar code. "
                          },
                          "schemeId" : {
                            "type" : "string",
                            "title" : "SchemeId for virtual bank bar code",
                            "description" : "Scheme identifier of the virtual bank bar code, typically country code according to ISO3166-1 alpha-2. Possible values: FI"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "required" : [ "paymentMeansCode" ]
        },
        "paymentTerms": {
          "description": "Available payment terms.",
          "additionalProperties" : false,
          "properties" : {
            "settlementPeriod" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An object holding the settlement period dates.",
              "properties" : {
                "startDate" : {
                  "type" : "string",
                  "description" : "Date when the payment terms starts. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                  "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                },
                "endDate" : {
                  "type" : "string",
                  "description" : "Date when the payment terms ends. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                  "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                }
              }
            },
            "note" : {
              "type" : "string",
              "description" : "Free-form text applying to the payment terms. This field may contain notes or any other similar information that is not contained explicitly in another structure."
            },
            "penaltySurchargePercent" : {
              "type" : "number",
              "description" : "Penalty surcharge percent amount."
            }
          }
        },
        "taxTotal": {
          "additionalProperties" : false,
          "properties" : {
            "currencyId" : {
              "type" : "string",
              "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
            },
            "amount" : {
              "type" : "number",
              "description" : "Total amount of the taxes. The total tax amount for particular tax scheme e.g. VAT; the sum of each of the tax subtotals for each tax category within the tax scheme."
            },
            "taxSubtotals" : {
              "items" : {
                "type" : "object",
                "additionalProperties" : false,
                "description" : "An object holding the information about tax.",
                "properties" : {
                  "currencyId" : {
                    "type" : "string",
                    "description" : "A code that identifies the currency of the tax subtotal. Valid values: ISO 4217 code represented as string."
                  },
                  "amount" : {
                    "type" : "number",
                    "description" : "Total amount of the taxes."
                  },
                  "percent" : {
                    "type" : "number",
                    "description" : "The tax rate for the category, expressed as a percentage."
                  },
                  "taxableAmount" : {
                    "type" : "number",
                    "description" : "Basis of the taxes. The net amount to which the tax percent (rate) is applied to calculate the tax amount."
                  },
                  "taxCategory" : {
                    "type" : "object",
                    "description" : "External identifier of tax category.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the tax category identifier."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the tax category identifier."
                      },
                      "name" : {
                        "type" : "string",
                        "description" : "Tax category description."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "currencyId", "amount" ]
              }
            }
          },
          "required" : [ "currencyId", "amount" ]
        },
        "legalMonetaryTotal": {
          "additionalProperties" : false,
          "properties" : {
            "lineExtensionAmount" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An object holding total amount of line extensions.",
              "properties" : {
                "currencyId" : {
                  "type" : "string",
                  "description" : "A code that identifies the currency of the total line extension amount. Valid values: ISO 4217 code represented as string."
                },
                "amount" : {
                  "type" : "number",
                  "description" : "Total amount of line extensions."
                }
              },
              "required" : [ "currencyId", "amount" ]
            },
            "payableAmount" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An object holding total payable amount of line extensions.",
              "properties" : {
                "currencyId" : {
                  "type" : "string",
                  "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                },
                "amount" : {
                  "type" : "number",
                  "description" : "The total amount to be paid."
                }
              },
              "required" : [ "currencyId", "amount" ]
            }
          },
          "required" : [ "payableAmount" ]
        },
        "buyerReference": {
          "description": "Buyer reference in the business document.",
          "additionalProperties" : false,
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "The id value of the buyer reference"
            }
          },
          "required" : [ "id" ]
        },
        "customFields": {
          "items" : {
            "type" : "object",
            "description" : "Custom fields in the business document",
            "additionalProperties" : false,
            "properties" : {
              "name" : {
                "type" : "string",
                "description" : "Name of the custom field",
                "default" : "file"
              },
              "value" : {
                "type" : "string",
                "description" : "Value of the custom field"
              },
              "description" : {
                "type" : "string",
                "description" : "The purpose of this field"
              }
            },
            "required" : [ "name", "value" ]
          }
        },
        "creditNoteLines": {
          "type": "array",
          "description": "An array holding the Credit Note lines.",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "description": "A credit note line",
            "properties": {
              "id": {
                "type": "string",
                "description": "External system identifier for the Credit Note line."
              },
              "quantity": {
                "additionalProperties" : false,
                "properties" : {
                  "amount" : {
                    "type" : "number",
                    "description" : "The quantity of the target Business Document line items."
                  },
                  "unitCode" : {
                    "type" : "string",
                    "description" : "The unit code of the quantity of the target Business Document line item. Valid values: UN/ECE CEFACT Trade Facilitation Recommendation No.20 common code value represented as string."
                  }
                }
              },
              "serviceIndicator": {
                "type": "boolean",
                "description": "Flag indicating whether the line represents goods or services (true if services, false if goods)."
              },
              "lineExtension": {
                "additionalProperties" : false,
                "properties" : {
                  "currencyId" : {
                    "type" : "string",
                    "description" : "The currency of the amount."
                  },
                  "amount" : {
                    "type" : "number",
                    "description" : "The total amount for the line item, including allowance charges but net of taxes."
                  }
                },
                "required" : [ "currencyId", "amount" ]
              },
              "item": {
                "additionalProperties" : false,
                "properties" : {
                  "description" : {
                    "type" : "array",
                    "description" : "An array holding the descriptions of the Business Document line items.",
                    "items" : {
                      "type" : "string",
                      "description" : "Description of the Business Document line item."
                    }
                  },
                  "name" : {
                    "type" : "string",
                    "description" : "Name of the Business Document line item.  A short name optionally given to an item, such as a name from a catalogue, as distinct from a description."
                  },
                  "taxPercent" : {
                    "type" : "number",
                    "description" : "Tax amount for the item"
                  },
                  "sellersItem" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An object holding a identification of the Business Documents line item as it is in sellers system.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Id of the Business Document line item as it is in sellers system."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External system specific identifier of the sellers item identifier element. If the source business document has any matching element, it should be used."
                      }
                    },
                    "required" : [ "id" ]
                  }
                }
              },
              "taxTotals": {
                "items" : {
                  "type" : "object",
                  "additionalProperties" : false,
                  "description" : "An object holding the information about tax.",
                  "properties" : {
                    "amount" : {
                      "type" : "number",
                      "description" : "Total amount of the taxes. The total tax amount for particular tax scheme e.g. VAT; the sum of each of the tax subtotals for each tax category within the tax scheme."
                    },
                    "currencyId" : {
                      "type" : "string",
                      "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                    },
                    "transactionCurrencyTax" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "An object holding transaction tax.",
                      "properties" : {
                        "amount" : {
                          "type" : "number",
                          "description" : "Amount of tax for the transaction."
                        }
                      },
                      "required" : [ "amount" ]
                    },
                    "taxSubtotals" : {
                      "items" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An object holding the information about tax.",
                        "properties" : {
                          "currencyId" : {
                            "type" : "string",
                            "description" : "A code that identifies the currency of the tax subtotal. Valid values: ISO 4217 code represented as string."
                          },
                          "amount" : {
                            "type" : "number",
                            "description" : "Total amount of the taxes."
                          },
                          "percent" : {
                            "type" : "number",
                            "description" : "The tax rate for the category, expressed as a percentage."
                          },
                          "taxableAmount" : {
                            "type" : "number",
                            "description" : "Basis of the taxes. The net amount to which the tax percent (rate) is applied to calculate the tax amount."
                          },
                          "taxCategory" : {
                            "type" : "object",
                            "description" : "External identifier of tax category.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "Identifies the tax category identifier."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "Identifies the namespace of the tax category identifier."
                              },
                              "name" : {
                                "type" : "string",
                                "description" : "Tax category description."
                              }
                            },
                            "required" : [ "id" ],
                            "additionalProperties" : false
                          }
                        },
                        "required" : [ "currencyId", "amount" ]
                      }
                    }
                  },
                  "required" : [ "amount", "currencyId" ]
                }
              },
              "price": {
                "additionalProperties" : false,
                "properties" : {
                  "amount" : {
                    "type" : "number",
                    "description" : "The price of the line item."
                  },
                  "currencyId" : {
                    "type" : "string",
                    "description" : "A code that identifies the currency of the line item price. Valid values: ISO 4217 code represented as string."
                  }
                },
                "required" : [ "amount", "currencyId" ]
              },
              "delivery": {
                "additionalProperties" : false,
                "properties" : {
                  "actualDeliveryDate" : {
                    "type" : "string",
                    "description" : "Date when the goods/services are delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                  }
                }
              },
              "orderLineReference": {
                "additionalProperties" : false,
                "properties" : {
                  "lineId" : {
                    "type" : "string",
                    "description" : "An identifier for the referenced order line, assigned by the buyer."
                  },
                  "orderReference" : {
                    "type" : "string",
                    "description" : "A reference to the order containing the referenced order line."
                  }
                },
                "required" : [ "lineId" ]
              },
              "allowanceCharges": {
                "additionalProperties" : false,
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "changeIndicator" : {
                      "type" : "boolean",
                      "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
                    },
                    "allowanceChargeReasonCode" : {
                      "type" : "string",
                      "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code"
                    },
                    "allowanceChargeReason" : {
                      "type" : "string",
                      "description" : "The reason for this allowance or charge."
                    },
                    "multiplierFactorNumeric" : {
                      "type" : "number",
                      "description" : "The factor applied to the base amount to calculate the allowance charge."
                    },
                    "amount" : {
                      "type" : "number",
                      "description" : "The allowance charge amount."
                    }
                  },
                  "required" : [ "changeIndicator", "amount" ]
                }
              },
              "customFields": {
                "items" : {
                  "type" : "object",
                  "description" : "Custom fields in the business document",
                  "additionalProperties" : false,
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "Name of the custom field",
                      "default" : "file"
                    },
                    "value" : {
                      "type" : "string",
                      "description" : "Value of the custom field"
                    },
                    "description" : {
                      "type" : "string",
                      "description" : "The purpose of this field"
                    }
                  },
                  "required" : [ "name", "value" ]
                }
              }
            },
            "required": [
              "id",
              "item"
            ]
          }
        }
      },
      "required": [
        "externalDocumentIdentifier",
        "issueDate",
        "accountingSupplierParty",
        "accountingCustomerParty",
        "legalMonetaryTotal",
        "creditNoteLines"
      ]
    }
  },
  "required": [
    "bumId",
    "data"
  ]
}

Response code 400 - Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.

Response example for the response code above 

{
  "error": {
    "id": "c842c9c3-75e5-4c32-ae3f-c1fe250fc186",
    "type": "VALIDATION",
    "message": "Business document identifier bumId does not match the pattern :[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}",
    "code": "Error.004.0003",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

Response code 500 - Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

Response example for the response code above 

{
  "error": {
    "id": "a312a9b3-35e5-1a32-be3f-a5fe250fc121",
    "type": "TECHNICAL",
    "message": "BCN encountered an unexpected system error",
    "code": "Error.001.0006",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

You can retrieve the credit note contents using GET /creditNotes method. Basware Unique Message Identifier (bumid) defines which credit note you want to retrieve.

Request URI

https://api.basware.com/v2/creditNotes/{bumId}

URI Parameters

Param Name Type Required Example Description
bumId string true 8da06e38-6737-48ee-893b-741ff4b22354 Unique UUID for business document

Request Headers

Param Name Required Example Description
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Responses

Response code Description
200 The request has been completed successfully.
400 Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
500 Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

POST

POST /creditNotes/{bumId} HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Request example 

{
  "clientToken": "1bs37857-64fr-34g4-67f0-32dd536fgj32",
  "fileRefs": [
    {
      "refId": "16a2a23ff75e42a6bc673fa3b"
    }
  ],
  "processingPreference": {
    "sendTo": {
      "id": "0612065012",
      "schemeId": "BE:ORGNR"
    },
    "receiveFrom": {
      "id": "114823943023440",
      "schemeId": "ISO6523-ACTORID-UPIS"
    },
    "printingPreference": "PrintingAllowed"
  },
  "data": {
    "externalDocumentIdentifier": {
      "id": "56328230"
    },
    "issueDate": "2017-05-09",
    "documentCurrencyCode": "EUR",
    "contractDocumentReferences": [
      {
        "id": "267212"
      }
    ],
    "accountingSupplierParty": {
      "partyName": "Acme Supplier Inc.",
      "postalAddress": {
        "addressLine": "1800 Main Street",
        "cityName": "Dallas",
        "postalZone": "75201",
        "countrySubentity": "TX",
        "countryId": "US"
      }
    },
    "accountingCustomerParty": {
      "partyName": "Acme Buyer N.V.",
      "postalAddress": {
        "addressLine": "Sint Gummarusstraat 53",
        "cityName": "Antwerpen",
        "postalZone": "2060",
        "countryId": "BE"
      }
    },
    "deliveryParty": {
      "partyName": "Parcels United",
      "postalAddress": {
        "addressLine": "1 Back Lane",
        "locality": "Clayton West",
        "cityName": "HUDDERSFIELD",
        "postalZone": "HD8 9PP",
        "countryId": "UK"
      }
    },
    "paymentMeans": {
      "paymentDueDate": "2017-06-30",
      "paymentIdentifier": {
        "id": "63156783578924"
      },
      "paymentMeansCode": "31",
      "financialAccounts": [
        {
          "financialInstitutionName": "BARCGB22",
          "ids": [
            {
              "id": "GB54BARC20992012345678",
              "schemeId": "IBAN"
            }
          ]
        }
      ]
    },
    "buyerReference": {
      "id": "PO-156345"
    },
    "taxTotal": {
      "amount": 89.56,
      "currencyId": "EUR",
      "taxSubtotals": [
        {
          "taxableAmount": 373.24,
          "amount": 89.56,
          "currencyId": "EUR",
          "percent": 24
        }
      ]
    },
    "legalMonetaryTotal": {
      "payableAmount": {
        "amount": 462.8,
        "currencyId": "EUR"
      }
    },
    "creditNoteLines": [
      {
        "id": "1",
        "quantity": {
          "amount": 2,
          "unitCode": "PCE"
        },
        "lineExtension": {
          "currencyId": "EUR",
          "amount": 93
        },
        "item": {
          "description": [
            "Basic High-Speed HDMI Cable - 25 Feet",
            "Supports Ethernet, 3D, 4K and Audio Return"
          ],
          "name": "High-Speed HDMI Cable",
          "taxPercent": 10,
          "sellersItem": {
            "id": "B-341"
          }
        },
        "taxTotals": [
          {
            "currencyId": "EUR",
            "amount": 17.28,
            "transactionCurrencyTax": {
              "amount": 0.9
            },
            "taxSubtotals": [
              {
                "currencyId": "EUR",
                "amount": 17.28,
                "percent": 24
              }
            ]
          }
        ]
      },
      {
        "id": "2",
        "quantity": {
          "amount": 1,
          "unitCode": "PCE"
        },
        "lineExtension": {
          "currencyId": "EUR",
          "amount": 23.1
        },
        "item": {
          "sellersItem": {
            "id": "A-532"
          },
          "taxPercent": 10
        },
        "taxTotals": [
          {
            "currencyId": "EUR",
            "amount": 5.54,
            "transactionCurrencyTax": {
              "amount": 0.9
            },
            "taxSubtotals": [
              {
                "currencyId": "EUR",
                "amount": 5.54,
                "percent": 24
              }
            ]
          }
        ]
      }
    ]
  }
}

Request schema 

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "title": "Schema for POST /creditNotes",
    "description": "Credit note is a business document related to an invoice.",
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "clientToken": {
            "type": "string",
            "description": "Token generated by client (uuid). Used to verify that specific Credit Note is only sent and processed once, if response time-outs, retry should be executed with the same clientToken."
        },
        "fileRefs": {
            "type": "array",
            "description": "Credit Note file/attachment reference identifiers.",
            "items": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                    "refId": {
                        "type": "string",
                        "description": "Unique file identifier received after storing file into Basware Network."
                    }
                },
                "required": [
                    "refId"
                ]
            }
        },
        "processingPreference": {
            "additionalProperties" : false,
            "properties" : {
              "sendTo" : {
                "description" : "Identifier for the recipient endpoint. See API documentation for more details about recipient endpoints.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies the value."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Identifies the namespace of the id."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              },
              "receiveFrom" : {
                "description" : "Identifier for the sender endpoint.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies the value."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Identifies the namespace of the id."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              },
              "replyTo" : {
                "description" : "Identifier for the reply to endpoint.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies the value."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Identifies the namespace of the id."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              },
              "sendToServiceProvider" : {
                "type" : "string",
                "description" : "Identifier for the intermediate service provider."
              },
              "printingPreference" : {
                "type" : "string",
                "enum" : [ "PrintingAllowed", "PrintingAlways", "NoPrinting" ],
                "description" : "Indicates the printing preference. This optional field can be specified to allow printing delivery with PrintingAllowed or force the document to be delived by printing with PrintingAlways. If this field is not specified, delivery will be by eInvoicing. Note that this field cannot be used together with sendToServiceProvider. Only one of these two fields can be given at the same time."
              },
              "recipientNotificationPreference" : {
                "type" : "string",
                "description" : "Indicates how the recipient is notified about the business document delivery. Possible values are EmailWithLoginLink, EmailWithSecuredLink, EmailWithContent, NotificationViaThirdParty."
              },
              "isConsumerRecipient" : {
                "type" : "boolean",
                "description" : "Indicates whether the recipient is a consumer recipient."
              }
            },
            "required" : [ "sendTo" ]
        },
        "data": {
            "type": "object",
            "additionalProperties": false,
            "description": "Object holding the business content of the Credit Note. Content is at some level based on Universal Business Language (UBL) standard version 2.1. It has also been extended by Basware so it is not strictly UBL.",
            "properties": {
                "externalDocumentIdentifier": {
                    "description": "External system identifier of the business document. Serial number that is issued once only by invoice issuer to identify the credit note.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the value."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the id."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                },
                "issueDate": {
                    "type": "string",
                    "description": "The date when the Credit Note was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                    "pattern": "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                },
                "documentCurrencyCode": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 3,
                    "description": "Currency presentation of the Credit Note document. Valid values must be ISO 4217 Alpha format."
                },
                "note": {
                    "type": "string",
                    "description": "Free-form text pertinent to this document, conveying information that is not contained explicitly in other structures."
                },
                "allowanceCharges": {
                    "additionalProperties" : false,
                    "items" : {
                      "type" : "object",
                      "properties" : {
                        "changeIndicator" : {
                          "type" : "boolean",
                          "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
                        },
                        "allowanceChargeReasonCode" : {
                          "type" : "string",
                          "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code"
                        },
                        "allowanceChargeReason" : {
                          "type" : "string",
                          "description" : "The reason for this allowance or charge."
                        },
                        "multiplierFactorNumeric" : {
                          "type" : "number",
                          "description" : "The factor applied to the base amount to calculate the allowance charge."
                        },
                        "amount" : {
                          "type" : "number",
                          "description" : "The allowance charge amount."
                        }
                      },
                      "required" : [ "changeIndicator", "amount" ]
                    }
                },
                "isIssuedAgainstOrder": {
                    "type": "boolean",
                    "description": "Indicates whether the business document is issued against an order."
                },
                "orderReference": {
                    "description": "Order reference on the business document.",
                    "additionalProperties" : false,
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Order number reference on the business document. Identifies the referenced order assigned by the buyer."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External system specific identifier of the order system identifier element. If the source business document has any matching element, it should be used."
                      },
                      "customerReference" : {
                        "type" : "string",
                        "description" : "Customer Reference Identifier (CRI) when using a purchasing card."
                      },
                      "salesOrderId" : {
                        "type" : "string",
                        "description" : "Sales order identifier."
                      }
                    },
                    "required" : [ "id" ]
                },
                "billingReference": {
                    "description": "External system identifier object for the billing entity referenced by the business document.",
                    "additionalProperties" : false,
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "External system identifier of the billing entity referenced by the Business Document."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External system specific identifier of the billing reference system identifier element. If the source business document has any matching element, it should be used."
                      }
                    },
                    "required" : [ "id" ]
                },
                "contractDocumentReferences": {
                    "description": "External system identifiers for the contracts referenced by the business document.",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "External system identifier of the contract referenced by the Business Document (i.e. buyers contract number). Mandatory field if the customer demands that the goods or services invoiced refer to a contract number defined by the customer to which he wants to assign the Business Document. Is demanded for example in service and maintenance agreements for which there is generally no explicit order."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "External system specific identifier of the contract system identifier element. If the source business document has any matching element, it should be used."
                        }
                      },
                      "required" : [ "id" ]
                    }
                },
                "additionalDocumentReference": {
                  "description": "A reference to an additional document associated with this document. Used for example to reference to an Invoice from Credit Note.",
                    "additionalProperties" : false,
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An identifier for the referenced document (i.e. bumid)."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External system specific identifier of the invoicing system identifier element. If the source business document has any matching element, it should be used."
                      },
                      "issueDate" : {
                        "type" : "string",
                        "description" : "Date when the referenced document was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "typeCode" : {
                        "type" : "string",
                        "description" : "The type of document being referenced, expressed as a code, for example to reference to an Invoice document, code is 380."
                      }
                    },
                    "required" : [ "id" ]
                },
                "accountingSupplierParty": {
                    "description": "Party that is the accountable supplier of the goods/services in the referred business document.",
                    "properties" : {
                      "endpoint" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "type" : "array",
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the external system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "External global identifier of the id identifier element."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "type" : "object",
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "contact" : {
                        "type" : "object",
                        "description" : "An object containing information about contacts. Used for defining the company contact data",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                },
                "accountingCustomerParty": {
                    "description": "Party that is the accountable buyer of the goods/services in the referred business document.",
                    "properties" : {
                      "endpoint" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "type" : "array",
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the external system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "External global identifier of the id identifier element."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "type" : "object",
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "contact" : {
                        "type" : "object",
                        "description" : "An object containing information about contacts. Used for defining the company contact data",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                },
                "buyerCustomerParty": {
                    "description": "Party that is the buyer of the goods/services in the referred business document.",
                    "properties" : {
                      "endpoint" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "type" : "array",
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the external system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "External global identifier of the id identifier element."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "type" : "object",
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "contact" : {
                        "type" : "object",
                        "description" : "An object containing information about contacts. Used for defining the company contact data",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                },
                "sellerSupplierParty": {
                    "description": "Party that is the supplier of the goods/services in the referred business document.",
                    "properties" : {
                      "endpoint" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "type" : "array",
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the external system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "External global identifier of the id identifier element."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "type" : "object",
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "contact" : {
                        "type" : "object",
                        "description" : "An object containing information about contacts. Used for defining the company contact data",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                },
                "delivery": {
                    "description": "Delivery details.",
                    "additionalProperties" : false,
                    "properties" : {
                      "actualDeliveryDate" : {
                        "type" : "string",
                        "description" : "Date when the goods/services are delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      }
                    }
                },
                "deliveryParty": {
                    "description": "Party that is responsible for the delivery of the goods/services in the referred business document.",
                    "properties" : {
                      "endpoint" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "type" : "array",
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the external system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "External global identifier of the id identifier element."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "type" : "object",
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "contact" : {
                        "type" : "object",
                        "description" : "An object containing information about contacts. Used for defining the company contact data",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                },
                "paymentMeans": {
                    "description": "An object holding the available payment means.",
                    "additionalProperties" : false,
                    "properties" : {
                      "paymentMeansCode" : {
                        "type" : "string",
                        "description" : "A code that identifies how the payment can be done. Valid values: UN/ECE 4461 code represented as string."
                      },
                      "paymentDueDate" : {
                        "type" : "string",
                        "description" : "Date when the business document is due for the payment means. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "paymentReferenceMessage" : {
                        "type" : "string",
                        "description" : "A payment reference message. This can be a free text describing the payment."
                      },
                      "paymentIdentifier" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An identifier for a payment made using this means of payment.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "The id value of payment identifier."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Scheme which identifies the type of payment identifier. Possible values are SPY, ISO."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "financialAccounts" : {
                        "type" : "array",
                        "description" : "Array holding the financial account data",
                        "items" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "Object holding the financial account data",
                          "properties" : {
                            "financialInstitutionName" : {
                              "type" : "string",
                              "description" : "The name of financial institution."
                            },
                            "financialInstitutionId" : {
                              "type" : "string",
                              "description" : "Identifier of financial institution."
                            },
                            "financialInstitutionIdSchemeId" : {
                              "type" : "string",
                              "description" : "The external identifier of the financial institution id identifier element."
                            },
                            "financialInstitutionBranchId" : {
                              "type" : "string",
                              "description" : "The identifier of financial institution branch, for example 342-085. This field is typically used by institutions in Australia and New Zealand."
                            },
                            "financialInstitutionBranchSchemeId" : {
                              "type" : "string",
                              "description" : "The scheme identifier of financial institution branch. For example for an Australian institutions, possible scheme is BSB."
                            },
                            "ids" : {
                              "type" : "array",
                              "description" : "Array holding ids",
                              "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "description" : "Object holding identifier data",
                                "properties" : {
                                  "id" : {
                                    "type" : "string",
                                    "description" : "Identifier."
                                  },
                                  "schemeId" : {
                                    "type" : "string",
                                    "description" : "External identifier."
                                  }
                                },
                                "required" : [ "id" ]
                              }
                            },
                            "accounting" : {
                              "type" : "object",
                              "title" : "Accounting",
                              "description" : "Accounting related content.",
                              "properties" : {
                                "virtualBankBarcode" : {
                                  "type" : "object",
                                  "title" : "VirtualBankBarcode",
                                  "description" : "Virtual bar code can be added to the business document that should be printed.",
                                  "properties" : {
                                    "id" : {
                                      "type" : "string",
                                      "title" : "Virtual bank bar code",
                                      "description" : "Identifier of the virtual bar code. "
                                    },
                                    "schemeId" : {
                                      "type" : "string",
                                      "title" : "SchemeId for virtual bank bar code",
                                      "description" : "Scheme identifier of the virtual bank bar code, typically country code according to ISO3166-1 alpha-2. Possible values: FI"
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "required" : [ "paymentMeansCode" ]
                },
                "paymentTerms": {
                    "description": "Available payment terms.",
                    "additionalProperties" : false,
                    "properties" : {
                      "settlementPeriod" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An object holding the settlement period dates.",
                        "properties" : {
                          "startDate" : {
                            "type" : "string",
                            "description" : "Date when the payment terms starts. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                            "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                          },
                          "endDate" : {
                            "type" : "string",
                            "description" : "Date when the payment terms ends. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                            "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                          }
                        }
                      },
                      "note" : {
                        "type" : "string",
                        "description" : "Free-form text applying to the payment terms. This field may contain notes or any other similar information that is not contained explicitly in another structure."
                      },
                      "penaltySurchargePercent" : {
                        "type" : "number",
                        "description" : "Penalty surcharge percent amount."
                      }
                    }
                },
                "taxTotal": {
                    "additionalProperties" : false,
                    "properties" : {
                      "currencyId" : {
                        "type" : "string",
                        "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                      },
                      "amount" : {
                        "type" : "number",
                        "description" : "Total amount of the taxes. The total tax amount for particular tax scheme e.g. VAT; the sum of each of the tax subtotals for each tax category within the tax scheme."
                      },
                      "taxSubtotals" : {
                        "items" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "An object holding the information about tax.",
                          "properties" : {
                            "currencyId" : {
                              "type" : "string",
                              "description" : "A code that identifies the currency of the tax subtotal. Valid values: ISO 4217 code represented as string."
                            },
                            "amount" : {
                              "type" : "number",
                              "description" : "Total amount of the taxes."
                            },
                            "percent" : {
                              "type" : "number",
                              "description" : "The tax rate for the category, expressed as a percentage."
                            },
                            "taxableAmount" : {
                              "type" : "number",
                              "description" : "Basis of the taxes. The net amount to which the tax percent (rate) is applied to calculate the tax amount."
                            },
                            "taxCategory" : {
                              "type" : "object",
                              "description" : "External identifier of tax category.",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the tax category identifier."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the tax category identifier."
                                },
                                "name" : {
                                  "type" : "string",
                                  "description" : "Tax category description."
                                }
                              },
                              "required" : [ "id" ],
                              "additionalProperties" : false
                            }
                          },
                          "required" : [ "currencyId", "amount" ]
                        }
                      }
                    },
                    "required" : [ "currencyId", "amount" ]
                },
                "legalMonetaryTotal": {
                    "additionalProperties" : false,
                    "properties" : {
                      "lineExtensionAmount" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An object holding total amount of line extensions.",
                        "properties" : {
                          "currencyId" : {
                            "type" : "string",
                            "description" : "A code that identifies the currency of the total line extension amount. Valid values: ISO 4217 code represented as string."
                          },
                          "amount" : {
                            "type" : "number",
                            "description" : "Total amount of line extensions."
                          }
                        },
                        "required" : [ "currencyId", "amount" ]
                      },
                      "payableAmount" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An object holding total payable amount of line extensions.",
                        "properties" : {
                          "currencyId" : {
                            "type" : "string",
                            "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                          },
                          "amount" : {
                            "type" : "number",
                            "description" : "The total amount to be paid."
                          }
                        },
                        "required" : [ "currencyId", "amount" ]
                      }
                    },
                    "required" : [ "payableAmount" ]
                },
                "buyerReference": {
                    "description": "Buyer reference in the business document.",
                    "additionalProperties" : false,
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "The id value of the buyer reference"
                      }
                    },
                    "required" : [ "id" ]
                },
                "customFields": {
                    "items" : {
                      "type" : "object",
                      "description" : "Custom fields in the business document",
                      "additionalProperties" : false,
                      "properties" : {
                        "name" : {
                          "type" : "string",
                          "description" : "Name of the custom field",
                          "default" : "file"
                        },
                        "value" : {
                          "type" : "string",
                          "description" : "Value of the custom field"
                        },
                        "description" : {
                          "type" : "string",
                          "description" : "The purpose of this field"
                        }
                      },
                      "required" : [ "name", "value" ]
                    }
                },
                "creditNoteLines": {
                    "type": "array",
                    "description": "An array holding the credit note lines.",
                    "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "description": "A credit note line",
                        "properties": {
                            "id": {
                                "type": "string",
                                "description": "External system identifier for the Credit Note line."
                            },
                            "quantity": {
                                "additionalProperties" : false,
                                "properties" : {
                                  "amount" : {
                                    "type" : "number",
                                    "description" : "The quantity of the target Business Document line items."
                                  },
                                  "unitCode" : {
                                    "type" : "string",
                                    "description" : "The unit code of the quantity of the target Business Document line item. Valid values: UN/ECE CEFACT Trade Facilitation Recommendation No.20 common code value represented as string."
                                  }
                                }
                            },
                            "serviceIndicator": {
                                "type": "boolean",
                                "description": "Flag indicating whether the line represents goods or services (true if services, false if goods)."
                            },
                            "lineExtension": {
                                "additionalProperties" : false,
                                "properties" : {
                                  "currencyId" : {
                                    "type" : "string",
                                    "description" : "The currency of the amount."
                                  },
                                  "amount" : {
                                    "type" : "number",
                                    "description" : "The total amount for the line item, including allowance charges but net of taxes."
                                  }
                                },
                                "required" : [ "currencyId", "amount" ]
                            },
                            "item": {
                                "additionalProperties" : false,
                                "properties" : {
                                  "description" : {
                                    "type" : "array",
                                    "description" : "An array holding the descriptions of the Business Document line items.",
                                    "items" : {
                                      "type" : "string",
                                      "description" : "Description of the Business Document line item."
                                    }
                                  },
                                  "name" : {
                                    "type" : "string",
                                    "description" : "Name of the Business Document line item.  A short name optionally given to an item, such as a name from a catalogue, as distinct from a description."
                                  },
                                  "taxPercent" : {
                                    "type" : "number",
                                    "description" : "Tax amount for the item"
                                  },
                                  "sellersItem" : {
                                    "type" : "object",
                                    "additionalProperties" : false,
                                    "description" : "An object holding a identification of the Business Documents line item as it is in sellers system.",
                                    "properties" : {
                                      "id" : {
                                        "type" : "string",
                                        "description" : "Id of the Business Document line item as it is in sellers system."
                                      },
                                      "schemeId" : {
                                        "type" : "string",
                                        "description" : "External system specific identifier of the sellers item identifier element. If the source business document has any matching element, it should be used."
                                      }
                                    },
                                    "required" : [ "id" ]
                                  }
                                }
                            },
                            "taxTotals": {
                                "items" : {
                                  "type" : "object",
                                  "additionalProperties" : false,
                                  "description" : "An object holding the information about tax.",
                                  "properties" : {
                                    "amount" : {
                                      "type" : "number",
                                      "description" : "Total amount of the taxes. The total tax amount for particular tax scheme e.g. VAT; the sum of each of the tax subtotals for each tax category within the tax scheme."
                                    },
                                    "currencyId" : {
                                      "type" : "string",
                                      "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                                    },
                                    "transactionCurrencyTax" : {
                                      "type" : "object",
                                      "additionalProperties" : false,
                                      "description" : "An object holding transaction tax.",
                                      "properties" : {
                                        "amount" : {
                                          "type" : "number",
                                          "description" : "Amount of tax for the transaction."
                                        }
                                      },
                                      "required" : [ "amount" ]
                                    },
                                    "taxSubtotals" : {
                                      "items" : {
                                        "type" : "object",
                                        "additionalProperties" : false,
                                        "description" : "An object holding the information about tax.",
                                        "properties" : {
                                          "currencyId" : {
                                            "type" : "string",
                                            "description" : "A code that identifies the currency of the tax subtotal. Valid values: ISO 4217 code represented as string."
                                          },
                                          "amount" : {
                                            "type" : "number",
                                            "description" : "Total amount of the taxes."
                                          },
                                          "percent" : {
                                            "type" : "number",
                                            "description" : "The tax rate for the category, expressed as a percentage."
                                          },
                                          "taxableAmount" : {
                                            "type" : "number",
                                            "description" : "Basis of the taxes. The net amount to which the tax percent (rate) is applied to calculate the tax amount."
                                          },
                                          "taxCategory" : {
                                            "type" : "object",
                                            "description" : "External identifier of tax category.",
                                            "properties" : {
                                              "id" : {
                                                "type" : "string",
                                                "description" : "Identifies the tax category identifier."
                                              },
                                              "schemeId" : {
                                                "type" : "string",
                                                "description" : "Identifies the namespace of the tax category identifier."
                                              },
                                              "name" : {
                                                "type" : "string",
                                                "description" : "Tax category description."
                                              }
                                            },
                                            "required" : [ "id" ],
                                            "additionalProperties" : false
                                          }
                                        },
                                        "required" : [ "currencyId", "amount" ]
                                      }
                                    }
                                  },
                                  "required" : [ "amount", "currencyId" ]
                                }
                            },
                            "price": {
                                "additionalProperties" : false,
                                "properties" : {
                                  "amount" : {
                                    "type" : "number",
                                    "description" : "The price of the line item."
                                  },
                                  "currencyId" : {
                                    "type" : "string",
                                    "description" : "A code that identifies the currency of the line item price. Valid values: ISO 4217 code represented as string."
                                  }
                                },
                                "required" : [ "amount", "currencyId" ]
                            },
                            "delivery": {
                                "additionalProperties" : false,
                                "properties" : {
                                  "actualDeliveryDate" : {
                                    "type" : "string",
                                    "description" : "Date when the goods/services are delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                                  }
                                }
                            },
                            "orderLineReference": {
                                "additionalProperties" : false,
                                "properties" : {
                                  "lineId" : {
                                    "type" : "string",
                                    "description" : "An identifier for the referenced order line, assigned by the buyer."
                                  },
                                  "orderReference" : {
                                    "type" : "string",
                                    "description" : "A reference to the order containing the referenced order line."
                                  }
                                },
                                "required" : [ "lineId" ]
                            },
                            "allowanceCharges": {
                                "additionalProperties" : false,
                                "items" : {
                                  "type" : "object",
                                  "properties" : {
                                    "changeIndicator" : {
                                      "type" : "boolean",
                                      "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
                                    },
                                    "allowanceChargeReasonCode" : {
                                      "type" : "string",
                                      "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code"
                                    },
                                    "allowanceChargeReason" : {
                                      "type" : "string",
                                      "description" : "The reason for this allowance or charge."
                                    },
                                    "multiplierFactorNumeric" : {
                                      "type" : "number",
                                      "description" : "The factor applied to the base amount to calculate the allowance charge."
                                    },
                                    "amount" : {
                                      "type" : "number",
                                      "description" : "The allowance charge amount."
                                    }
                                  },
                                  "required" : [ "changeIndicator", "amount" ]
                                }
                            },
                            "customFields": {
                              "items" : {
                                "type" : "object",
                                "description" : "Custom fields in the business document",
                                "additionalProperties" : false,
                                "properties" : {
                                  "name" : {
                                    "type" : "string",
                                    "description" : "Name of the custom field",
                                    "default" : "file"
                                  },
                                  "value" : {
                                    "type" : "string",
                                    "description" : "Value of the custom field"
                                  },
                                  "description" : {
                                    "type" : "string",
                                    "description" : "The purpose of this field"
                                  }
                                },
                                "required" : [ "name", "value" ]
                              }
                            }
                        },
                        "required": [
                            "id",
                            "item"
                        ]
                    }
                }
            },
            "required": [
                "externalDocumentIdentifier",
                "documentCurrencyCode",
                "issueDate",
                "accountingSupplierParty",
                "accountingCustomerParty",
                "legalMonetaryTotal",
                "creditNoteLines"
            ]
        }
    },
    "required": [
        "clientToken",
        "data"
    ]
}

Response code 400 - Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.

Response example for the response code above 

{
  "error": {
    "id": "c842c9c3-75e5-4c32-ae3f-c1fe250fc186",
    "type": "VALIDATION",
    "message": "Business document identifier bumId does not match the pattern :[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}",
    "code": "Error.004.0003",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

Response code 500 - Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

Response example for the response code above 

{
  "error": {
    "id": "a312a9b3-35e5-1a32-be3f-a5fe250fc121",
    "type": "TECHNICAL",
    "message": "BCN encountered an unexpected system error",
    "code": "Error.001.0006",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

Upload an Credit Note document to Basware Network.

Request URI

https://api.basware.com/v2/creditNotes/{bumId}

URI Parameters

Param Name Type Required Example Description
bumId string true 8da06e38-6737-48ee-893b-741ff4b22354 Unique UUID for business document

Request Headers

Param Name Required Example Description
Content-Type true application/json Specifies media types which are acceptable for the request. Value application/json is supported.
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Responses

Response code Description
201 The request has been fulfilled successfully and new resource is created on server.
400 Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
409 Conflict. The request could not be completed due to a conflict with the current state of the target resource.
415 Unsupported Media Type. The server is refusing to service the request because the payload is in an unsupported format.
500 Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

API for Files v2

Files

API for Files lets you send and receive files related to a business document through Basware Network.

POST

POST /files HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Request example 

{
  "bumId": "5dg91997-70dq-51b8-84g1-41cc473naxd7",
  "fileType": "imageFile"
}

Request schema 

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "type": "object",
    "title": "Schema for File.",
    "description": "File is an attachment to a business document.",
    "definitions": {
      "dateType": {
        "type": "string",
        "description": "The date which can optionally include time zone. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
        "pattern": "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
      },
      "timeType": {
        "type": "string",
        "description": "Timestamp. Valid values must be in format: hh:mm:ss. If the timezone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If timezone is not known, it must be left empty.",
        "pattern": "([01][0-9]|2[0-4]):([0-5][0-9]):([0-5][0-9])(?:.([0-9]{1,7}))?(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
      },
      "identifierType": {
          "type": "object",
          "additionalProperties": false,
          "description": "Endpoint identification.",
          "properties": {
              "id": {
                  "type": "string",
                  "description": "An object holding the external system identifier of the endpoint."
              },
              "schemeId": {
                  "type": "string",
                  "description": "Identifies the endpoint scheme. Possible values are for example EMAIL-RFC2822."
              }
          },
          "required": [
              "id",
              "schemeId"
          ]
        }
    },
    "properties": {
      "bumId": {
        "type": "string",
        "description": "Basware Unique Message Identifier (bumid). It is an unique identifier (UUID) that can be used by external systems to identify a business document. The id must have been created before calling this interface. Note that the same bumId must also be used when sending the actual business document to Basware Network."
      },
      "fileType": {
        "type": "string",
        "description": "Allowed file type values: imageFile - image of the document which is human readable, attachmentFile - file related to an invoice which gives extra information, dataFile - invoice in a format which can be programmatically processed."
      },
      "id": {
        "type": "string",
        "description": "External system identifier of the business document."
      },
      "schemeId": {
        "type": "string",
        "description": "External system specific identifier of the system identifier element. If the source business document has any matching element, it should be used."
      },
      "sender": {
         "type": "object",
         "description": "Sender details are normally defined when the files are delivered without creating a separate business document.",
         "properties": {
           "identifier": {
             "description": "Identifies the sender of the business document. This is normally defined when the files are delivered without creating a separate business document.",
             "additionalProperties" : false,
             "properties" : {
               "id" : {
                 "type" : "string",
                 "description" : "An object holding the external system identifier of the endpoint."
               },
               "schemeId" : {
                 "type" : "string",
                 "description" : "Identifies the endpoint scheme. Possible values are for example EMAIL-RFC2822."
               }
             },
             "required" : [ "id", "schemeId" ]
           },
           "dateSent": {
             "type": "string",
             "description": "The date when the file was sent. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
             "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
           },
           "timeSent": {
             "type": "string",
             "description": "The timestamp when the file was sent. Valid values must be in format: hh:mm:ss. If the timezone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If timezone is not known, it must be left empty.",
             "pattern" : "([01][0-9]|2[0-4]):([0-5][0-9]):([0-5][0-9])(?:.([0-9]{1,7}))?(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
           },
           "senderNote": {
             "type": "string",
             "description": "A free-form description."
           }
         }
       },
       "receiver": {
          "type": "object",
          "description": "Receiver details are normally defined when the files are delivered without creating a separate business document.",
          "properties": {
            "identifier": {
              "description": "Identifies the sender of the business document. This is normally defined when the files are delivered without creating a separate business document..",
              "additionalProperties" : false,
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "An object holding the external system identifier of the endpoint."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "Identifies the endpoint scheme. Possible values are for example EMAIL-RFC2822."
                }
              },
              "required" : [ "id", "schemeId" ]
            },
            "dateReceived": {
              "type": "string",
              "description": "The date when the file was received. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
            },
            "timeReceived": {
              "type": "string",
              "description": "The timestamp when the file was received. Valid values must be in format: hh:mm:ss. If the timezone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If timezone is not known, it must be left empty.",
              "pattern" : "([01][0-9]|2[0-4]):([0-5][0-9]):([0-5][0-9])(?:.([0-9]{1,7}))?(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
            }
        }
      }
    },
    "required": [
        "bumId",
        "fileType"
    ],
    "additionalProperties": false
}

Response code 201 - The request has been fulfilled and resulted in a new resource being created.

Response example for the response code above 

{
  "fileId": "539a785684aed4025464647d",
  "links": [
    {
      "rel": "file",
      "href": "https://api.basware.com/v2/files/539a785684aed4025464647d",
      "method": "GET"
    }
  ]
}

Response schema

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "type": "object",
    "properties": {
        "fileId": {
            "type": "string",
            "description": "Identifier for stored file."
        },
        "links": {
            "type": "array",
            "description": "Links related to the files",
            "items": {
                "type": "object",
                "description": "Links related to the file",
                "properties": {
                    "rel": {
                        "type": "string",
                        "description": "Relation type for the URL in question. Possible values are file (default).",
                        "default": "file"
                    },
                    "href": {
                        "type": "string",
                        "description": "Link between the completed call and a future call. The URI is a fully formed URI, which needs also the method field"
                    },
                    "method": {
                        "type": "string",
                        "enum": ["GET", "POST", "DELETE"],
                        "description": "HTTP methods required to interact with the provided URL",
                        "default": "GET"
                    }
                }
            }
        }
    },
    "required": [
        "fileId"
    ]
}

Response code 400 - Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.

Response example for the response code above 

{
  "error": {
    "id": "c842c9c3-75e5-4c32-ae3f-c1fe250fc186",
    "type": "VALIDATION",
    "message": "Business document identifier bumId does not match the pattern :[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}",
    "code": "Error.004.0003",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

Response schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "title": "Error response",
  "description": "Error response for REST API.",
  "properties": {
    "error": {
      "type": "object",
      "title": "Error schema.",
      "description": "An explanation about the purpose of this instance.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Request identifier that was sent as part of request."
        },
        "type": {
          "type": "string",
          "description": "Error type. Possible values are TECHNICAL, BUSINESS, VALIDATION or SECURITY"
        },
        "message": {
          "type": "string",
          "description": "An explanation about the error."
        },
        "code": {
          "type": "string",
          "description": "Error code to identify the error situation."
        },
        "info": {
          "type": "string",
          "description": "An explanation about the purpose of this instance."
        }
      },
      "required": [
        "type",
        "message",
        "code",
        "info"
      ]
    }
  },
  "required": [
    "error"
  ]
}

Response code 500 - Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

Response example for the response code above 

{
  "error": {
    "id": "a312a9b3-35e5-1a32-be3f-a5fe250fc121",
    "type": "TECHNICAL",
    "message": "BCN encountered an unexpected system error",
    "code": "Error.001.0006",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

Response schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "title": "Error response",
  "description": "Error response for REST API.",
  "properties": {
    "error": {
      "type": "object",
      "title": "Error schema.",
      "description": "An explanation about the purpose of this instance.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Request identifier that was sent as part of request."
        },
        "type": {
          "type": "string",
          "description": "Error type. Possible values are TECHNICAL, BUSINESS, VALIDATION or SECURITY"
        },
        "message": {
          "type": "string",
          "description": "An explanation about the error."
        },
        "code": {
          "type": "string",
          "description": "Error code to identify the error situation."
        },
        "info": {
          "type": "string",
          "description": "An explanation about the purpose of this instance."
        }
      },
      "required": [
        "type",
        "message",
        "code",
        "info"
      ]
    }
  },
  "required": [
    "error"
  ]
}

If your business document has files attached to it, you can deliver them, too, using the POST files method.

You must upload the attachments one at a time. You must also link each file to a business document. The files are linked to a business document using the business document’s Basware Unique Message Identifier (BUMID).

Basware starts the delivery of the invoice with files after the API client has called the POST /invoices method. Alternatively, if the files already contain the required business document contents, you can specify action=startDelivery in query parameters of /POST files method. The immediate delivery method is supported for PDF attachments only.

The files that you deliver must follow these rules:

  1. The file must be in a supported format which are .csv, .doc, .docx, .jpeg, .jpg, .odt, .pdf, .png, .ppt, .pptx, .rtf, .tif, .tiff, .txt, .xls, .xlsx, .xml and .zip. Note that business documents which are to be printed only support pdf format.
  2. File name must not be longer than 75 characters.
  3. Size of an individual file must not exceed 5 MB.
  4. Total size of all the attachments must not exceed 25 MB.

File upload works in the following manner:

Request header has a Content-Type parameter that can must have the following values for each part:

  1. Content type defined as "multipart/mixed". This defines the content type for the entire request as multipart.
  2. Content type defined for metadata part as "application/json". Only JSON is supported at the moment.
  3. Content type defined for file part. This defines the content type for the file part of the request.

File upload supports also base64 encoding:

Request URI

https://api.basware.com/v2/files

Request Headers

Param Name Required Example Description
Content-Disposition true attachment; filename=acme-invoice.pdf File name without path. The parameter must be in the format (where FILENAME represents the actual file name) like attachment; filename=FILENAME
Content-Length true Size of the uploaded file in bytes so that the server can verify that it has received the entire file contents
Content-Type true multipart/mixed The MIME type of the body of the request. It should be set to "multipart/mixed".
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Query Parameters

Param Name Required Example Description
action false Defines what action will be performed. If startDelivery is specified, the business document will be delivered immediately. If startTransmission is specified, the business document will be delivered immediately without any processing. Possible values are store (default), startDelivery or startTransmission.
documentType false Defines the business document type the file belongs to. This field can be used when action is to start delivery or transmission immediately. Possible values are ApplicationResponse.

Responses

Response code Description
201 The request has been fulfilled and resulted in a new resource being created.
400 Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
409 Conflict. A similar resource already exists.
413 Request Entity Too Large. The server is refusing to process a request because the request entity is larger than the server is willing or able to process.
415 Unsupported Media Type. The server is refusing to service the request because the payload is in a format not supported.
500 Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.
503 Service Unavailable. The server is currently unable to handle the request due to a temporary overload or scheduled maintenance.

GET

GET /files/{fileId} HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Response code 400 - Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.

Response example for the response code above 

{
  "error": {
    "id": "c842c9c3-75e5-4c32-ae3f-c1fe250fc186",
    "type": "VALIDATION",
    "message": "Business document identifier bumId does not match the pattern :[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}",
    "code": "Error.004.0003",
    "info": "Contact Basware Support http://www.basware.com/contact and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

Response schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "title": "Error response",
  "description": "Error response for REST API.",
  "properties": {
    "error": {
      "type": "object",
      "title": "Error schema.",
      "description": "An explanation about the purpose of this instance.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Request identifier that was sent as part of request."
        },
        "type": {
          "type": "string",
          "description": "Error type. Possible values are TECHNICAL, BUSINESS, VALIDATION or SECURITY"
        },
        "message": {
          "type": "string",
          "description": "An explanation about the error."
        },
        "code": {
          "type": "string",
          "description": "Error code to identify the error situation."
        },
        "info": {
          "type": "string",
          "description": "An explanation about the purpose of this instance."
        }
      },
      "required": [
        "type",
        "message",
        "code",
        "info"
      ]
    }
  },
  "required": [
    "error"
  ]
}

You can fetch a file related to a business document.

The response header will include the following fields:

Possible values for X-BW-FILE-TYPE are the same which are used in POST method:

File download supports also base64 encoding:

Request URI

https://api.basware.com/v2/files/{fileId}

URI Parameters

Param Name Type Required Example Description
fileId string false 5878e54d2d95404381a09f48 File id or attachment id. The identifier was returned when the file was stored into Basware Network.

Request Headers

Param Name Required Example Description
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Responses

Response code Description
200 The request has been completed successfully.
304 Not Modified. The requested resource has not been modified. There is no need to retransmit the resource from server.
400 Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
404 Resource could not be found. The server has not found anything matching the request URI.
415 Unsupported Media Type. The server is refusing to service the request because the payload is in a format not supported.
500 Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

API for Orders v2

Orders

The Order API lets you send and receive orders, order changes, order responses and order cancellations through Basware Network to a recipient.

Order API allows also provisioning of Basware Network services as a service order. Consolidator can provision Basware services for corporate customers.

Note - 1. Incase of "OrderCancellation" if "buyerCustomerParty.partyIdentifications" is provided then value of id and schemeId is mandatory.

  1. Incase of "OrderChange" if "sellerSupplierParty.partyIdentifications" is provided then value of id and schemeId is mandatory.

  2. If "buyerCustomerParty.partyIdentifications" is provided for "OrderChange" then it must have value for id and schemeId.

  3. If "sellerSupplierParty.partyIdentifications" is provided for "OrderCancellation" then it must have value for id and schemeId.

POST

POST /orders/{bumId} HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Request example 

{
  "clientToken": "3ee9b55f-9b08-4936-8c8c-87c7d0ae2311",
  "documentType" : "Order",
  "processingPreference": {
    "sendTo": {
      "id": "0037059254248888",
      "schemeId": "ISO6523-ACTORID-UPIS"
    },
    "receiveFrom": {
      "id": "51-3985026",
      "schemeId": "TIN"
    }
  },
  "data": {
    "externalDocumentIdentifier": {
      "id": "374516341"
    },
    "issueDate": "2019-01-03",
    "issueTime": "14:12:32",
    "orderDocumentReference": [{
      "id": "1"
    }],
    "contractDocumentReferences": [{
      "id": "1"
    }],
    "note" :"Confirm your order within three days",
    "documentCurrencyCode": "USD",
    "buyerCustomerParty": {
      "party": {
        "partyIdentifications": [
          {
            "id": "51-3985026",
            "schemeId": "TIN"
          }
        ],
        "partyName": "Get Tech USA",
        "customerAssignedAccountId" : "444403",
        "partyLegalEntities": [{
          "registrationName": "Get Tech USA"
        }],
        "postalAddress": {
          "addressLine": "362 Hamilton Avenue",
          "cityName": "White Plains",
          "postalZone": "10167",
          "countrySubentity": "NY",
          "countryId": "US",
          "postBox": "NY",
          "streetName": "AVE",
          "additionalStreetName": "APT1A",
          "blockName": "1234",
          "buildingName": "COND ASHFORD PALACE",
          "buildingNumber": "1234",
          "region": "US"
        }
      }
    },
    "sellerSupplierParty": {
      "party": {
        "endpoint": {
          "id": "0037059254248888",
          "schemeId": "ISO6523-ACTORID-UPIS"
        },
        "partyIdentifications": [
          {
            "id": "0527768-2",
            "schemeId": "FI:ORGNR"
          }
        ],
        "partyName": "Moon Travel Oy",
        "customerAssignedAccountId" : "544403",
        "partyLegalEntities": [{
          "registrationName": "Moon Travel Oy"
        }],
        "postalAddress": {
          "addressLine": "Albertinkatu 36 B",
          "cityName": "Helsinki",
          "postalZone": "00180",
          "countryId": "FI",
          "postBox": "HELSINKI",
          "streetName": "Avon Way",
          "additionalStreetName": "Avon Way 1",
          "blockName": "Albertinkatu",
          "buildingName": "Therea bouts",
          "buildingNumber": "org",
          "region": "Bridgtow"
        }
      }
    },
    "accountingCustomerParty": {
      "party": {
        "partyName": "Get Tech Global",
        "customerAssignedAccountId" : "644403",
        "partyLegalEntities": [{
          "registrationName": "Get Tech Global"
        }],
        "partyIdentifications": [
          {
            "id": "52-3985027",
            "schemeId": "TIN"
          }
        ],
        "postalAddress": {
          "addressLine": "362 Hamilton Avenue",
          "cityName": "White Plains",
          "postalZone": "10167",
          "countrySubentity": "NY",
          "countryId": "US",
          "postBox": "NY",
          "streetName": "AVE",
          "additionalStreetName": "APT1A",
          "blockName": "1234",
          "buildingName": "COND ASHFORD PALACE",
          "buildingNumber": "1234",
          "region": "US"
        }
      }
    },
    "copyIndicator": false,
    "customerReference": "WS:21508502",
    "delivery": {
      "requestedDeliveryPeriod": {
        "startDate": "2019-01-05",
        "endDate": "2019-01-05"
      },
      "promisedDeliveryPeriod": {
        "startDate": "2019-01-06",
        "endDate": "2019-01-06"
      },
      "deliveryParty": {
        "partyName": "Moon Travel Oy",
        "partyLegalEntities": [{
          "registrationName": "Moon Travel Oy",
            "companyIdentifier": {
              "id": "0527768-2",
              "schemeId": "Unknown"
            }
        }],
        "postalAddress": {
          "addressLine": "Albertinkatu 36 B",
          "cityName": "Helsinki",
          "postalZone": "00180",
          "countryId": "FI",
          "postBox": "HELSINKI",
          "streetName": "Avon Way",
          "additionalStreetName": "Avon Way 1",
          "blockName": "Albertinkatu",
          "buildingName": "Therea bouts",
          "buildingNumber": "org",
          "region": "Bridgtow"
        },
        "contact": {
          "name": "Matti Järvinen",
          "telephone": "+358401754301",
          "telefax": "+358405430100",
          "electronicMail": "[email protected]"
        }
      }
    },
    "deliveryTerms": {
      "specialTerms": "Incoterms 2010"
    },
    "paymentTerms": {
      "note": "Within 7 days due date net",
      "settlementPeriod": {
        "startDate": "2019-01-05",
        "endDate": "2019-01-16"
      },
      "penaltySurchargePercent": 10
    },
    "paymentMeans": {
      "paymentMeansCode": "31",
      "paymentDueDate": "2019-01-16",
      "paymentReferenceMessage": "142 3223 0034 10",
      "payeeFinancialAccounts": [
        {
          "financialInstitutionName": "Nordea",
          "financialInstitutionId": "NDEAFIHH",
          "financialAccountIdentifiers": [
            {
              "id": "FI8422841800122484",
              "schemeId": "IBAN"
            }
          ]
        }
      ],
      "paymentIdentifier": {
        "id": "63156783578924",
        "schemeId": "SPY"
      }
    },
    "taxTotal": {
      "amount": 54.0,
      "currencyId": "USD",
      "taxSubtotals": [
        {
          "taxableAmount": 225.0,
          "amount": 54.0,
          "currencyId": "USD",
          "percent": 24,
          "taxCategory": {
            "id": "UN/ECE 6315",
            "name": "Transport",
            "taxExemptionReason": "Exempt New Means of Transport",
            "schemeId": "VAT"
          }
        }
      ]
    },
    "anticipatedMonetaryTotal": {
      "lineExtensionAmount": {
        "currencyId": "USD",
        "amount": 225.0
      },
      "payableAmount": {
        "currencyId": "USD",
        "amount": 279.0
      },
      "taxExclusiveAmount": {
        "currencyId": "USD",
        "amount": 279.0
      },
      "taxInclusiveAmount": {
        "currencyId": "USD",
        "amount": 279.0
      },
      "allowanceTotalAmount": {
        "currencyId": "USD",
        "amount": 1279.0
      },
      "chargeTotalAmount": {
        "currencyId": "USD",
        "amount": 2279.0
      }
    },
    "documentLines": [
      {
        "id": "1",
        "partialDeliveryIndicator": "true",
        "note": "Data need to be ordered",
        "item": {
          "descriptions": [
            {
              "description": "Basic High-Speed HDMI Cable - 25 Feet"
            },
            {
              "description": "Supports Ethernet, 3D, 4K and Audio Return"
            }
          ],
          "name": "High-Speed HDMI Cable",
          "taxPercent": 24,
          "taxCategory": {
            "id": "UN/ECE 5315"
          },
          "sellersItem": {
            "id": "B-341"
          },
          "standardItemIdentification": {
            "id": "1234567890124",
            "schemeId": "GT"
          },
          "commodityClassification": {
            "itemClassificationCode": "12344321",
            "listId": "620"
          },
          "additionalItemProperties": [
            {
              "name": "packingMaterial",
              "value": "Box"
            },
            {
              "name": "lineItemType",
              "value": "Package"
            }
          ]
        },
        "quantity": {
          "amount": 25,
          "unitCode": "NMP"
        },
        "price": {
          "amount": 10.0,
          "currencyId": "USD",
          "baseQuantity": {
            "amount": 1,
            "unitCode": "C62"
          }
        },
        "delivery": {
          "requestedDeliveryPeriod": {
            "startDate": "2019-01-05",
            "endDate": "2019-01-05"
          },
          "promisedDeliveryPeriod": {
            "startDate": "2019-01-06",
            "endDate": "2019-01-06"
          },
          "deliveryParty": {
            "partyName": "Get Tech Global",
            "postalAddress": {
              "addressLine": "362 Hamilton Avenue",
              "cityName": "White Plains",
              "postalZone": "10167",
              "countrySubentity": "NY",
              "countryId": "US"
            }
          },
          "deliveryAddress": {
            "addressLine": "29 CHASE RD",
            "cityName": "SCARSDALE",
            "postalZone": "10583",
            "countrySubentity": "NY",
            "countryId": "US"
          }
        },
        "taxTotals": [
          {
            "currencyId": "USD",
            "amount": 54.0,
            "transactionCurrencyTax": {
              "amount": 648.0
            },
            "taxSubtotals": [
              {
                "currencyId": "USD",
                "amount": 54.0,
                "percent": 24,
                "taxCategory": {
                  "id": "UN/ECE 5315",
                  "name": "Kane",
                  "taxExemptionReason": "Exempt from 5 percent tax",
                  "schemeId": "VAT"
                }
              }
            ]
          }
        ],
        "customFields": [
          {
            "name": "storeId",
            "value": "US-2361",
            "description": "Identifier of the store where the purchase incurred"
          },{
            "name": "senderInstructions",
            "value": "Instructions to receiver from Sender",
            "description": "Instructions to receiver from Sender"
          }
        ]
      }
    ]
  }
}

Request schema 

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "title": "Schema for POST /orders",
    "description": "Order is a business document which can contain attachments.",
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "clientToken": {
            "type": "string",
            "description": "Token generated by client (UUID). Used to verify that a specific Order is only sent and processed once, if response time-outs, retry should be executed with the same clientToken."
        },
        "documentType": {
            "type": "string",
            "enum": ["Order", "OrderChange", "OrderCancellation", "OrderResponse"],
            "description": "Indicates the business document type. Possible values are Order, OrderChange, OrderCancellation and OrderResponse."
        },
        "processingPreference": {
            "description": "Processing preferences which guide the processing and routing of the business document",
            "additionalProperties" : false,
            "properties" : {
              "sendTo" : {
                "description" : "Identifier for the recipient endpoint. See API documentation for more details about recipient endpoints.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies the value."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Identifies the namespace of the id."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              },
              "receiveFrom" : {
                "description" : "Identifier for the sender endpoint.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies the value."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Identifies the namespace of the id."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              },
              "replyTo" : {
                "description" : "Identifier for the reply to endpoint.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies the value."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Identifies the namespace of the id."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              }
            },
            "required" : [ "sendTo" ]
        },
        "fileReferences": {
            "description": "References to file which are attached to the business document.",
            "items" : {
              "type" : "array",
              "additionalProperties" : false,
              "properties" : {
                "refId" : {
                  "type" : "string",
                  "description" : "Unique file identifier received after storing file into Basware Network."
                },
                "fileType" : {
                  "type" : "string",
                  "description" : "File type. Possible values are imageFile, attachmentFile and dataFile."
                }
              },
              "required" : [ "refId", "fileType" ]
            }
        },
        "data": {
            "description": "Object holding the business content of the Order. Content is based on Universal Business Language (UBL) standard version 2.1. Content has also been extended by Basware.",
            "additionalProperties" : false,
            "properties" : {
              "externalDocumentIdentifier" : {
                "description" : "Identifier of the business document. Serial number that is issued once only by issuer to identify the business document.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies the value."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Identifies the namespace of the id."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              },
              "documentCurrencyCode" : {
                "type" : "string",
                "description" : "Currency code of the business document. Valid values must be ISO 4217 Alpha format, for example EUR, USD."
              },
              "salesOrderId" : {
                "type" : "string",
                "description" : "An identifier for the Order, assigned by the seller."
              },
              "orderReference" : {
                "type" : "object",
                "description" : "Identifies the order referenced by the Business Document.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies the order document."
                  },
                  "issueDate" : {
                    "type" : "string",
                    "description" : "Issue date."
                  },
                  "issueTime" : {
                    "type" : "string",
                    "description" : "Issue time."
                  },
                  "UUID" : {
                    "type" : "string",
                    "description" : "A universally unique identifier for this order reference."
                  }
                },
                "required" : [ "id" ]
              },
              "orderResponseCode" : {
                "type" : "string",
                "description" : "A code signifying the type of response for this Order.This field is used in OrderResponse only."
              },
              "note" : {
                "type" : "string",
                "description" : "Free-form text. This field may contain notes or any other similar information that is not contained explicitly in another structure."
              },
              "buyerCustomerParty" : {
                "description" : "Party that is the buyer of the goods/services in the referred business document.",
                "properties" : {
                  "party" : {
                    "description" : "Party in the order",
                    "properties" : {
                      "endpoint" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "additionalProperties" : false,
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the external system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "External global identifier of the id identifier element."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "customerAssignedAccountId" : {
                        "type" : "string",
                        "description" : "Account identifier assigned by the customer."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          },
                          "postBox" : {
                            "type" : "string",
                            "description" : "A post office box number registered for postal delivery by a postal service provider."
                          },
                          "streetName" : {
                            "type" : "string",
                            "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                          },
                          "additionalStreetName" : {
                            "type" : "string",
                            "description" : "An additional street name used to further clarify the address."
                          },
                          "region" : {
                            "type" : "string",
                            "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                          },
                          "district" : {
                            "type" : "string",
                            "description" : "The district or geographical division of a country or region in which this address is located."
                          },
                          "blockName" : {
                            "type" : "string",
                            "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                          },
                          "buildingName" : {
                            "type" : "string",
                            "description" : "The name of a building."
                          },
                          "buildingNumber" : {
                            "type" : "string",
                            "description" : "he number of a building within the street."
                          },
                          "department" : {
                            "type" : "string",
                            "description" : "The department of the addressee."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          },
                          "taxScheme" : {
                            "type" : "object",
                            "description" : "The taxation scheme applicable to the party.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "An identifier for this taxation scheme."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "The identification of the identification scheme."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyLegalEntities" : {
                        "type" : "array",
                        "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party legal entity.",
                          "properties" : {
                            "registrationName" : {
                              "type" : "string",
                              "description" : "Registration name of the legal entity."
                            },
                            "companyIdentifier" : {
                              "description" : "Global legal party identifier, including name scheme",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the value."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the id."
                                }
                              },
                              "required" : [ "id" ],
                              "additionalProperties" : false
                            }
                          },
                          "additionalProperties" : false
                        }
                      },
                      "contact" : {
                        "description" : "An object containing information about contacts. Used for defining the company contact data.",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "party" ]
              },
              "originatorCustomerParty" : {
                "description" : "Party that is the originator of the goods/services in the referred business document.",
                "additionalProperties" : false,
                "properties" : {
                  "party" : {
                    "description" : "Party that is the originator of the goods/services in the referred business document.",
                    "properties" : {
                      "endpoint" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "additionalProperties" : false,
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the external system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "External global identifier of the id identifier element."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "customerAssignedAccountId" : {
                        "type" : "string",
                        "description" : "Account identifier assigned by the customer."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          },
                          "postBox" : {
                            "type" : "string",
                            "description" : "A post office box number registered for postal delivery by a postal service provider."
                          },
                          "streetName" : {
                            "type" : "string",
                            "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                          },
                          "additionalStreetName" : {
                            "type" : "string",
                            "description" : "An additional street name used to further clarify the address."
                          },
                          "region" : {
                            "type" : "string",
                            "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                          },
                          "district" : {
                            "type" : "string",
                            "description" : "The district or geographical division of a country or region in which this address is located."
                          },
                          "blockName" : {
                            "type" : "string",
                            "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                          },
                          "buildingName" : {
                            "type" : "string",
                            "description" : "The name of a building."
                          },
                          "buildingNumber" : {
                            "type" : "string",
                            "description" : "he number of a building within the street."
                          },
                          "department" : {
                            "type" : "string",
                            "description" : "The department of the addressee."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          },
                          "taxScheme" : {
                            "type" : "object",
                            "description" : "The taxation scheme applicable to the party.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "An identifier for this taxation scheme."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "The identification of the identification scheme."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyLegalEntities" : {
                        "type" : "array",
                        "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party legal entity.",
                          "properties" : {
                            "registrationName" : {
                              "type" : "string",
                              "description" : "Registration name of the legal entity."
                            },
                            "companyIdentifier" : {
                              "description" : "Global legal party identifier, including name scheme",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the value."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the id."
                                }
                              },
                              "required" : [ "id" ],
                              "additionalProperties" : false
                            }
                          },
                          "additionalProperties" : false
                        }
                      },
                      "contact" : {
                        "description" : "An object containing information about contacts. Used for defining the company contact data.",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                  },
                  "agentParty" : {
                    "description" : "Party that is the originator of the goods/services in the referred business document.",
                    "properties" : {
                      "endpoint" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "additionalProperties" : false,
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the external system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "External global identifier of the id identifier element."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "customerAssignedAccountId" : {
                        "type" : "string",
                        "description" : "Account identifier assigned by the customer."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          },
                          "postBox" : {
                            "type" : "string",
                            "description" : "A post office box number registered for postal delivery by a postal service provider."
                          },
                          "streetName" : {
                            "type" : "string",
                            "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                          },
                          "additionalStreetName" : {
                            "type" : "string",
                            "description" : "An additional street name used to further clarify the address."
                          },
                          "region" : {
                            "type" : "string",
                            "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                          },
                          "district" : {
                            "type" : "string",
                            "description" : "The district or geographical division of a country or region in which this address is located."
                          },
                          "blockName" : {
                            "type" : "string",
                            "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                          },
                          "buildingName" : {
                            "type" : "string",
                            "description" : "The name of a building."
                          },
                          "buildingNumber" : {
                            "type" : "string",
                            "description" : "he number of a building within the street."
                          },
                          "department" : {
                            "type" : "string",
                            "description" : "The department of the addressee."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          },
                          "taxScheme" : {
                            "type" : "object",
                            "description" : "The taxation scheme applicable to the party.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "An identifier for this taxation scheme."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "The identification of the identification scheme."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyLegalEntities" : {
                        "type" : "array",
                        "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party legal entity.",
                          "properties" : {
                            "registrationName" : {
                              "type" : "string",
                              "description" : "Registration name of the legal entity."
                            },
                            "companyIdentifier" : {
                              "description" : "Global legal party identifier, including name scheme",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the value."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the id."
                                }
                              },
                              "required" : [ "id" ],
                              "additionalProperties" : false
                            }
                          },
                          "additionalProperties" : false
                        }
                      },
                      "contact" : {
                        "description" : "An object containing information about contacts. Used for defining the company contact data.",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                  },
                  "supplierAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Supplier assigned account identifier."
                  }
                },
                "required" : [ "party" ]
              },
              "sellerSupplierParty" : {
                "description" : "Party that is the supplier of the goods/services in the referred business document.",
                "properties" : {
                  "party" : {
                    "description" : "Party in the order",
                    "properties" : {
                      "endpoint" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "additionalProperties" : false,
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the external system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "External global identifier of the id identifier element."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "customerAssignedAccountId" : {
                        "type" : "string",
                        "description" : "Account identifier assigned by the customer."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          },
                          "postBox" : {
                            "type" : "string",
                            "description" : "A post office box number registered for postal delivery by a postal service provider."
                          },
                          "streetName" : {
                            "type" : "string",
                            "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                          },
                          "additionalStreetName" : {
                            "type" : "string",
                            "description" : "An additional street name used to further clarify the address."
                          },
                          "region" : {
                            "type" : "string",
                            "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                          },
                          "district" : {
                            "type" : "string",
                            "description" : "The district or geographical division of a country or region in which this address is located."
                          },
                          "blockName" : {
                            "type" : "string",
                            "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                          },
                          "buildingName" : {
                            "type" : "string",
                            "description" : "The name of a building."
                          },
                          "buildingNumber" : {
                            "type" : "string",
                            "description" : "he number of a building within the street."
                          },
                          "department" : {
                            "type" : "string",
                            "description" : "The department of the addressee."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          },
                          "taxScheme" : {
                            "type" : "object",
                            "description" : "The taxation scheme applicable to the party.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "An identifier for this taxation scheme."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "The identification of the identification scheme."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyLegalEntities" : {
                        "type" : "array",
                        "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party legal entity.",
                          "properties" : {
                            "registrationName" : {
                              "type" : "string",
                              "description" : "Registration name of the legal entity."
                            },
                            "companyIdentifier" : {
                              "description" : "Global legal party identifier, including name scheme",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the value."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the id."
                                }
                              },
                              "required" : [ "id" ],
                              "additionalProperties" : false
                            }
                          },
                          "additionalProperties" : false
                        }
                      },
                      "contact" : {
                        "description" : "An object containing information about contacts. Used for defining the company contact data.",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "party" ]
              },
              "accountingCustomerParty" : {
                "description" : "Party that is the buyer of the goods/services in the referred business document.",
                "properties" : {
                  "party" : {
                    "description" : "Party in the order",
                    "properties" : {
                      "endpoint" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "additionalProperties" : false,
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the external system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "External global identifier of the id identifier element."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "customerAssignedAccountId" : {
                        "type" : "string",
                        "description" : "Account identifier assigned by the customer."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          },
                          "postBox" : {
                            "type" : "string",
                            "description" : "A post office box number registered for postal delivery by a postal service provider."
                          },
                          "streetName" : {
                            "type" : "string",
                            "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                          },
                          "additionalStreetName" : {
                            "type" : "string",
                            "description" : "An additional street name used to further clarify the address."
                          },
                          "region" : {
                            "type" : "string",
                            "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                          },
                          "district" : {
                            "type" : "string",
                            "description" : "The district or geographical division of a country or region in which this address is located."
                          },
                          "blockName" : {
                            "type" : "string",
                            "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                          },
                          "buildingName" : {
                            "type" : "string",
                            "description" : "The name of a building."
                          },
                          "buildingNumber" : {
                            "type" : "string",
                            "description" : "he number of a building within the street."
                          },
                          "department" : {
                            "type" : "string",
                            "description" : "The department of the addressee."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          },
                          "taxScheme" : {
                            "type" : "object",
                            "description" : "The taxation scheme applicable to the party.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "An identifier for this taxation scheme."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "The identification of the identification scheme."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyLegalEntities" : {
                        "type" : "array",
                        "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party legal entity.",
                          "properties" : {
                            "registrationName" : {
                              "type" : "string",
                              "description" : "Registration name of the legal entity."
                            },
                            "companyIdentifier" : {
                              "description" : "Global legal party identifier, including name scheme",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the value."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the id."
                                }
                              },
                              "required" : [ "id" ],
                              "additionalProperties" : false
                            }
                          },
                          "additionalProperties" : false
                        }
                      },
                      "contact" : {
                        "description" : "An object containing information about contacts. Used for defining the company contact data.",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "party" ]
              },
              "copyIndicator" : {
                "type" : "boolean",
                "description" : "Indicates whether the referenced business document is a copy (true) or the original (false)."
              },
              "acceptedIndicator" : {
                "type" : "boolean",
                "description" : "Indicates whether the order is accepted (true) or rejected (false). This field applies only to OrderResponse business document."
              },
              "issueDate" : {
                "type" : "string",
                "description" : "The date when the business document was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
              },
              "issueTime" : {
                "type" : "string",
                "description" : "Time when the business document was issued. Valid values must be in format: hh-mm-ss.sss. If the timezone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If timezone is not known, it must be left empty.",
                "pattern" : "([01][0-9]|2[0-4]):([0-5][0-9]):([0-5][0-9])(?:.([0-9]{1,7}))?(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
              },
              "orderDocumentReference" : {
                "description" : "OrderDocumentReference details.",
                "items" : {
                  "type" : "object",
                  "description" : " A reference to another Order.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : " An identifier for the referenced document."
                    }
                  },
                  "required" : [ "id" ],
                  "additionalProperties" : false
                }
              },
              "additionalDocumentReference" : {
                "description" : "A reference to an additional document associated with this document.",
                "items" : {
                  "type" : "object",
                  "description" : " A reference to an additional document associated.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "An identifier for the referenced document."
                    },
                    "documentDescription" : {
                      "description" : "An array Text describing the referenced document.",
                      "items" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                          "description" : {
                            "type" : "string",
                            "description" : "Description of the business document line item."
                          }
                        },
                        "required" : [ "description" ]
                      }
                    }
                  },
                  "required" : [ "id" ],
                  "additionalProperties" : false
                }
              },
              "contractDocumentReferences" : {
                "description" : "External system identifier objects for the contract referenced by the business document.",
                "items" : {
                  "type" : "object",
                  "additionalProperties" : false,
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "External system identifier of the contract referenced by the Business Document (i.e. buyers contract number). Mandatory field if the customer demands that the goods or services invoiced refer to a contract number defined by the customer to which he wants to assign the Business Document. Is demanded for example in service and maintenance agreements for which there is generally no explicit order."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External system specific identifier of the contract system identifier element. If the source business document has any matching element, it should be used."
                    }
                  },
                  "required" : [ "id" ]
                }
              },
              "customerReference" : {
                "type" : "string",
                "description" : "Identifiers the customer related to the business document."
              },
              "orderTypeCode" : {
                "description" : "Specifies the order type.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "Identifies order type. See API documentation for more details about values."
                  },
                  "name" : {
                    "type" : "string",
                    "description" : "Name of the order type. See API documentation for more details about the values."
                  }
                },
                "required" : [ "id" ]
              },
              "delivery" : {
                "description" : "Delivery details.",
                "additionalProperties" : false,
                "properties" : {
                  "promisedDeliveryPeriod" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Promised delivery period",
                    "properties" : {
                      "startDate" : {
                        "description" : "Earliest date when the goods/services are promised to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "startTime" : {
                        "type" : "string",
                        "description" : "The time at which this time period begins."
                      },
                      "endDate" : {
                        "description" : "Latest date when the goods/services are promised to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "endTime" : {
                        "type" : "string",
                        "description" : "The time at which this time period ends."
                      }
                    }
                  },
                  "requestedDeliveryPeriod" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Requested delivery period",
                    "properties" : {
                      "startDate" : {
                        "description" : "Earliest date when the goods/services are requested to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "startTime" : {
                        "type" : "string",
                        "description" : "The time at which this time period begins."
                      },
                      "endDate" : {
                        "description" : "Latest date when the goods/services are requested to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "endTime" : {
                        "type" : "string",
                        "description" : "The time at which this time period ends."
                      }
                    }
                  },
                  "deliveryParty" : {
                    "description" : "Party that is responsible for the delivery of the goods/services in the referred business document.",
                    "properties" : {
                      "endpoint" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "additionalProperties" : false,
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Global identifier of namescheme for party identifier."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          },
                          "postBox" : {
                            "type" : "string",
                            "description" : "A post office box number registered for postal delivery by a postal service provider."
                          },
                          "streetName" : {
                            "type" : "string",
                            "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                          },
                          "additionalStreetName" : {
                            "type" : "string",
                            "description" : "An additional street name used to further clarify the address."
                          },
                          "region" : {
                            "type" : "string",
                            "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                          },
                          "district" : {
                            "type" : "string",
                            "description" : "The district or geographical division of a country or region in which this address is located."
                          },
                          "blockName" : {
                            "type" : "string",
                            "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                          },
                          "buildingName" : {
                            "type" : "string",
                            "description" : "The name of a building."
                          },
                          "buildingNumber" : {
                            "type" : "string",
                            "description" : "he number of a building within the street."
                          },
                          "department" : {
                            "type" : "string",
                            "description" : "The department of the addressee."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyLegalEntities" : {
                        "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party legal entity.",
                          "properties" : {
                            "registrationName" : {
                              "type" : "string",
                              "description" : "Registration name of the legal entity."
                            },
                            "companyIdentifier" : {
                              "description" : "Global legal party identifier, including name scheme",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the value."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the id."
                                }
                              },
                              "required" : [ "id" ],
                              "additionalProperties" : false
                            }
                          },
                          "required" : [ "registrationName", "companyIdentifier" ],
                          "additionalProperties" : false
                        }
                      },
                      "contact" : {
                        "description" : "An object containing information about contacts. Used for defining the company contact data.",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "supplierAssignedAccountId" : {
                        "type" : "string",
                        "description" : "Account identifier assigned by the supplier."
                      },
                      "customerAssignedAccountId" : {
                        "type" : "string",
                        "description" : "Account identifier assigned by the customer."
                      },
                      "note" : {
                        "type" : "string",
                        "description" : "Free-form description of the party not included in other fields"
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                  },
                  "deliveryAddress" : {
                    "description" : "An object containing address information. Used for defining delivery address party data.",
                    "properties" : {
                      "cityName" : {
                        "type" : "string",
                        "description" : "The name of the city, town or village in the postal address of the party."
                      },
                      "postalZone" : {
                        "type" : "string",
                        "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                      },
                      "addressLine" : {
                        "type" : "string",
                        "description" : "The address line of the postal address of the party."
                      },
                      "addressLine2" : {
                        "type" : "string",
                        "description" : "The second address line of the postal address of the party."
                      },
                      "addressLine3" : {
                        "type" : "string",
                        "description" : "The third address line of the postal address of the party."
                      },
                      "locality" : {
                        "type" : "string",
                        "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                      },
                      "countrySubentity" : {
                        "type" : "string",
                        "description" : "The sub-entity of the area in the postal address."
                      },
                      "countryId" : {
                        "type" : "string",
                        "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                      },
                      "postBox" : {
                        "type" : "string",
                        "description" : "A post office box number registered for postal delivery by a postal service provider."
                      },
                      "streetName" : {
                        "type" : "string",
                        "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                      },
                      "additionalStreetName" : {
                        "type" : "string",
                        "description" : "An additional street name used to further clarify the address."
                      },
                      "region" : {
                        "type" : "string",
                        "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                      },
                      "district" : {
                        "type" : "string",
                        "description" : "The district or geographical division of a country or region in which this address is located."
                      },
                      "blockName" : {
                        "type" : "string",
                        "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                      },
                      "buildingName" : {
                        "type" : "string",
                        "description" : "The name of a building."
                      },
                      "buildingNumber" : {
                        "type" : "string",
                        "description" : "he number of a building within the street."
                      },
                      "department" : {
                        "type" : "string",
                        "description" : "The department of the addressee."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "deliveryLocation" : {
                    "additionalProperties" : false,
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An identifier for this location."
                      },
                      "descriptions" : {
                        "description" : "An array holding the descriptions of the Text describing this location.",
                        "items" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "properties" : {
                            "description" : {
                              "type" : "string",
                              "description" : "Description of the business document line item."
                            }
                          },
                          "required" : [ "description" ]
                        }
                      }
                    }
                  }
                }
              },
              "deliveryTerms" : {
                "description" : "Delivery terms.",
                "additionalProperties" : false,
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "If possible, specify 'INCOTERMS'. Otherwise, specify the terms in clear text in the field 'specialTerms'."
                  },
                  "specialTerms" : {
                    "type" : "string",
                    "description" : "A description of special conditions relating to the Delivery Terms."
                  },
                  "allowanceCharge" : {
                    "additionalProperties" : false,
                    "properties" : {
                      "chargeIndicator" : {
                        "type" : "boolean",
                        "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
                      },
                      "allowanceChargeReasonCode" : {
                        "type" : "string",
                        "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code."
                      },
                      "allowanceChargeReason" : {
                        "type" : "string",
                        "description" : "The reason for this allowance or charge."
                      },
                      "multiplierFactorNumeric" : {
                        "type" : "number",
                        "description" : "The factor applied to the base amount to calculate the allowance charge."
                      },
                      "amount" : {
                        "type" : "number",
                        "description" : "The allowance charge amount."
                      },
                      "taxCategories" : {
                        "type" : "array",
                        "description" : "Identifier of tax category.",
                        "items" : {
                          "type" : "object",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Tax category identifier."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Namespace of the tax category identifier."
                            },
                            "name" : {
                              "type" : "string",
                              "description" : "Tax category description."
                            },
                            "percent" : {
                              "type" : "number",
                              "description" : "Tax rate for this category, expressed as a percentage"
                            },
                            "taxExemptionReasonCode" : {
                              "type" : "string",
                              "description" : "Reason for tax being exempted, expressed as a code."
                            },
                            "taxExemptionReason" : {
                              "type" : "string",
                              "description" : "Reason for tax being exempted, expressed as text."
                            }
                          },
                          "required" : [ "id" ]
                        }
                      }
                    },
                    "required" : [ "chargeIndicator", "amount" ]
                  },
                  "deliveryLocation" : {
                    "additionalProperties" : false,
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An identifier for this location."
                      },
                      "descriptions" : {
                        "description" : "An array holding the descriptions of the Text describing this location.",
                        "items" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "properties" : {
                            "description" : {
                              "type" : "string",
                              "description" : "Description of the business document line item."
                            }
                          },
                          "required" : [ "description" ]
                        }
                      }
                    }
                  }
                }
              },
              "paymentTerms" : {
                "description" : "Payment terms.",
                "additionalProperties" : false,
                "properties" : {
                  "settlementPeriod" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An object holding the settlement period dates.",
                    "properties" : {
                      "startDate" : {
                        "type" : "string",
                        "description" : "Date when the payment terms starts. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "endDate" : {
                        "type" : "string",
                        "description" : "Date when the payment terms ends. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      }
                    }
                  },
                  "note" : {
                    "type" : "string",
                    "description" : "Free-form text applying to the payment terms. This field may contain notes or any other similar information that is not contained explicitly in another structure."
                  },
                  "penaltySurchargePercent" : {
                    "type" : "number",
                    "description" : "Penalty surcharge percent amount."
                  }
                }
              },
              "paymentMeans" : {
                "description" : "Expected means of payment.",
                "additionalProperties" : false,
                "properties" : {
                  "paymentMeansCode" : {
                    "type" : "string",
                    "description" : "A code that identifies how the payment can be done. Valid values: UN/ECE 4461 code represented as string."
                  },
                  "paymentDueDate" : {
                    "type" : "string",
                    "description" : "Date when the business document is due for the payment means. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                  },
                  "paymentReferenceMessage" : {
                    "type" : "string",
                    "description" : "A payment reference message. This can be a free text describing the payment."
                  },
                  "paymentIdentifier" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An identifier for a payment made using this means of payment.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Payment identifier."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Scheme which identifies the type of payment identifier. Possible values are SPY, ISO."
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "payerFinancialAccounts" : {
                    "description" : "An array of payer financial accounts",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "Object holding the financial account details",
                      "properties" : {
                        "financialInstitutionName" : {
                          "type" : "string",
                          "description" : "The name of financial institution."
                        },
                        "financialInstitutionId" : {
                          "type" : "string",
                          "description" : "Identifier of financial institution."
                        },
                        "financialInstitutionIdSchemeId" : {
                          "type" : "string",
                          "description" : "The namespace of the financial institution id identifier element."
                        },
                        "financialInstitutionBranchId" : {
                          "type" : "string",
                          "description" : "The identifier of financial institution branch, for example 342-085. This field is typically used by institutions in Australia and New Zealand."
                        },
                        "financialInstitutionBranchSchemeId" : {
                          "type" : "string",
                          "description" : "The namespace of financial institution branch. For example for an Australian institutions, possible scheme is BSB."
                        },
                        "financialAccountIdentifiers" : {
                          "type" : "array",
                          "description" : "Array holding financial account identifiers",
                          "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "Financial account identifier",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "Financial account identifier."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "Identifies the financial account identifier type, for example 'IBAN'."
                              }
                            },
                            "required" : [ "id" ]
                          }
                        }
                      }
                    }
                  },
                  "payeeFinancialAccounts" : {
                    "description" : "An array of payee financial accounts",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "Object holding the financial account details",
                      "properties" : {
                        "financialInstitutionName" : {
                          "type" : "string",
                          "description" : "The name of financial institution."
                        },
                        "financialInstitutionId" : {
                          "type" : "string",
                          "description" : "Identifier of financial institution."
                        },
                        "financialInstitutionIdSchemeId" : {
                          "type" : "string",
                          "description" : "The namespace of the financial institution id identifier element."
                        },
                        "financialInstitutionBranchId" : {
                          "type" : "string",
                          "description" : "The identifier of financial institution branch, for example 342-085. This field is typically used by institutions in Australia and New Zealand."
                        },
                        "financialInstitutionBranchSchemeId" : {
                          "type" : "string",
                          "description" : "The namespace of financial institution branch. For example for an Australian institutions, possible scheme is BSB."
                        },
                        "financialAccountIdentifiers" : {
                          "type" : "array",
                          "description" : "Array holding financial account identifiers",
                          "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "Financial account identifier",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "Financial account identifier."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "Identifies the financial account identifier type, for example 'IBAN'."
                              }
                            },
                            "required" : [ "id" ]
                          }
                        }
                      }
                    }
                  }
                },
                "required" : [ "paymentMeansCode" ]
              },
              "allowanceCharges" : {
                "additionalProperties" : false,
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "chargeIndicator" : {
                      "type" : "boolean",
                      "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
                    },
                    "allowanceChargeReasonCode" : {
                      "type" : "string",
                      "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code"
                    },
                    "allowanceChargeReason" : {
                      "type" : "string",
                      "description" : "The reason for this allowance or charge."
                    },
                    "multiplierFactorNumeric" : {
                      "type" : "number",
                      "description" : "The factor applied to the base amount to calculate the allowance charge."
                    },
                    "baseAmount" : {
                      "type" : "number",
                      "description" : "The monetary amount to which the multiplier factor is applied in calculating the amount of this allowance or charge."
                    },
                    "amount" : {
                      "type" : "number",
                      "description" : "The allowance charge amount."
                    },
                    "taxCategories" : {
                      "type" : "array",
                      "description" : "External identifier of tax category.",
                      "items" : {
                        "type" : "object",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the tax category identifier."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the tax category identifier."
                          },
                          "name" : {
                            "type" : "string",
                            "description" : "Tax category description."
                          },
                          "percent" : {
                            "type" : "number",
                            "description" : "Identifies the tax rate for this category, expressed as a percentage"
                          },
                          "taxExemptionReasonCode" : {
                            "type" : "string",
                            "description" : "Identifies the reason for tax being exempted, expressed as a code."
                          },
                          "taxExemptionReason" : {
                            "type" : "string",
                            "description" : "Identifies the reason for tax being exempted, expressed as text."
                          }
                        }
                      },
                      "required" : [ "id" ],
                      "additionalProperties" : false
                    },
                    "paymentMeans" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "An object holding the available payment means.",
                      "properties" : {
                        "paymentDueDate" : {
                          "type" : "string",
                          "description" : "Date when the business document is due for the payment means. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                          "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                        }
                      }
                    }
                  }
                },
                "required" : [ "chargeIndicator", "amount" ]
              },
              "taxTotal" : {
                "description" : "Tax total details.",
                "additionalProperties" : false,
                "properties" : {
                  "currencyId" : {
                    "type" : "string",
                    "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                  },
                  "amount" : {
                    "type" : "number",
                    "description" : "Total amount of the taxes. The total tax amount for particular tax scheme e.g. VAT; the sum of each of the tax subtotals for each tax category within the tax scheme."
                  },
                  "roundingAmount" : {
                    "type" : "number",
                    "description" : "Rounding amount added to the calculated tax total to produce the rounded TotalTaxAmount."
                  },
                  "taxSubtotals" : {
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "An object holding the information about tax.",
                      "properties" : {
                        "currencyId" : {
                          "type" : "string",
                          "description" : "A code that identifies the currency of the tax subtotal. Valid values: ISO 4217 code represented as string."
                        },
                        "amount" : {
                          "type" : "number",
                          "description" : "Total amount of the taxes."
                        },
                        "percent" : {
                          "type" : "number",
                          "description" : "The tax rate for the category, expressed as a percentage."
                        },
                        "taxableAmount" : {
                          "type" : "number",
                          "description" : "Basis of the taxes. The net amount to which the tax percent (rate) is applied to calculate the tax amount."
                        },
                        "taxCategory" : {
                          "type" : "object",
                          "description" : "External identifier of tax category.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifies the tax category identifier."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Identifies the namespace of the tax category identifier."
                            },
                            "name" : {
                              "type" : "string",
                              "description" : "Tax category description."
                            },
                            "taxExemptionReason" : {
                              "type" : "string",
                              "description" : "The reason for tax being exempted."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "required" : [ "currencyId", "amount" ]
                    }
                  }
                },
                "required" : [ "currencyId", "amount" ]
              },
              "anticipatedMonetaryTotal" : {
                "description" : "Anticipated monetary details for total amount payable in the business document.",
                "additionalProperties" : false,
                "properties" : {
                  "lineExtensionAmount" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Total amount of line extension.",
                    "properties" : {
                      "currencyId" : {
                        "type" : "string",
                        "description" : "Currency code of the total line extension amount. Valid values: ISO 4217 code represented as string, for example EUR."
                      },
                      "amount" : {
                        "type" : "number",
                        "description" : "Total amount of line extensions."
                      }
                    },
                    "required" : [ "currencyId", "amount" ]
                  },
                  "payableAmount" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An object holding total payable amount of line extensions.",
                    "properties" : {
                      "currencyId" : {
                        "type" : "string",
                        "description" : "Currency code of the total payable amount. Valid values: ISO 4217 code represented as string, for example EUR."
                      },
                      "amount" : {
                        "type" : "number",
                        "description" : "The total amount to be paid."
                      }
                    },
                    "required" : [ "currencyId", "amount" ]
                  },
                  "taxExclusiveAmount" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "The monetary amount of an extended transaction line, exclusive of taxes.",
                    "properties" : {
                      "currencyId" : {
                        "type" : "string",
                        "description" : "Currency code of the tax exclusive amount. Valid values: ISO 4217 code represented as string, for example EUR."
                      },
                      "amount" : {
                        "type" : "number",
                        "description" : "The total of tax exclusive amount."
                      }
                    },
                    "required" : [ "amount" ]
                  },
                  "taxInclusiveAmount" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "The monetary amount including taxes; the sum of payable amount and prepaid amount.",
                    "properties" : {
                      "currencyId" : {
                        "type" : "string",
                        "description" : "Currency code of the tax inclusive amount. Valid values: ISO 4217 code represented as string, for example EUR."
                      },
                      "amount" : {
                        "type" : "number",
                        "description" : "The total of tax inclusive amount."
                      }
                    },
                    "required" : [ "amount" ]
                  },
                  "allowanceTotalAmount" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "The total monetary amount of all allowances.",
                    "properties" : {
                      "currencyId" : {
                        "type" : "string",
                        "description" : "Currency code of the allowance total amount. Valid values: ISO 4217 code represented as string, for example EUR."
                      },
                      "amount" : {
                        "type" : "number",
                        "description" : "The allowance total amount to be paid."
                      }
                    },
                    "required" : [ "amount" ]
                  },
                  "chargeTotalAmount" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "The total monetary amount of all allowances.",
                    "properties" : {
                      "currencyId" : {
                        "type" : "string",
                        "description" : "Currency code of the charge total amount. Valid values: ISO 4217 code represented as string, for example EUR."
                      },
                      "amount" : {
                        "type" : "number",
                        "description" : "The charge total amount to be paid."
                      }
                    },
                    "required" : [ "amount" ]
                  }
                },
                "required" : [ "payableAmount" ]
              },
              "documentLines" : {
                "type" : "array",
                "description" : "An array holding the document lines.",
                "items" : {
                  "type" : "object",
                  "additionalProperties" : false,
                  "description" : "A business document line",
                  "properties" : {
                    "id" : {
                      "description" : "Identifier for the document line.",
                      "type" : "string"
                    },
                    "note" : {
                      "type" : "string",
                      "description" : "Free-form text conveying information that is not contained explicitly in other structures."
                    },
                    "lineStatusCode" : {
                      "type" : "string",
                      "description" : "A code signifying the status of this line item with respect to its original state."
                    },
                    "documentReference" : {
                      "description" : "A reference to an additional document associated with this document.",
                      "items" : {
                        "type" : "object",
                        "description" : " A reference to a document associated with this order line.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "An identifier for the referenced document."
                          },
                          "documentDescription" : {
                            "description" : "An array Text describing the referenced document.",
                            "items" : {
                              "type" : "object",
                              "additionalProperties" : false,
                              "properties" : {
                                "description" : {
                                  "type" : "string",
                                  "description" : "Description of the business document line item."
                                }
                              },
                              "required" : [ "description" ]
                            }
                          }
                        },
                        "required" : [ "id" ],
                        "additionalProperties" : false
                      }
                    },
                    "item" : {
                      "description" : "Order item details",
                      "additionalProperties" : false,
                      "properties" : {
                        "descriptions" : {
                          "description" : "An array holding the descriptions of the Business Document line items.",
                          "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                              "description" : {
                                "type" : "string",
                                "description" : "Description of the business document line item."
                              }
                            },
                            "required" : [ "description" ]
                          }
                        },
                        "name" : {
                          "type" : "string",
                          "description" : "Name of the Business Document line item.  A short name optionally given to an item, such as a name from a catalogue which is distinct from a description."
                        },
                        "taxPercent" : {
                          "type" : "number",
                          "description" : "Tax amount for the item"
                        },
                        "taxCategory" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "Identifying information for this item, assigned by the buyer.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An identifier for the item."
                            }
                          }
                        },
                        "buyersItemIdentification" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "Identifying information for this item, assigned by the buyer.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An identifier for the item."
                            }
                          },
                          "required" : [ "id" ]
                        },
                        "sellersItem" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "An object holding a identification of the Business Documents line item as it is in sellers system.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifier of the Business Document line item as it is in sellers system."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Namespace for system specific identifier of the sellers item identifier element. If the source business document has any matching element, it should be used."
                            }
                          },
                          "required" : [ "id" ]
                        },
                        "standardItemIdentification" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "Identifying information for this item, assigned according to a standard system.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An identifier for the item."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "The identification of the identification scheme"
                            }
                          },
                          "required" : [ "id" ]
                        },
                        "commodityClassification" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "A classification of this item according to a specific system for classifying commodities.",
                          "properties" : {
                            "itemClassificationCode" : {
                              "type" : "string",
                              "description" : "A code signifying the trade classification of the commodity."
                            },
                            "listId" : {
                              "type" : "string",
                              "description" : "The identification of a list of codes."
                            }
                          }
                        },
                        "additionalItemProperties" : {
                          "description" : "Additional item properties for the order line item",
                          "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                              "name" : {
                                "type" : "string",
                                "description" : "External system identifier of the contract referenced by the Business Document (i.e. buyers contract number). Mandatory field if the customer demands that the goods or services invoiced refer to a contract number defined by the customer to which he wants to assign the Business Document. Is demanded for example in service and maintenance agreements for which there is generally no explicit order."
                              },
                              "value" : {
                                "type" : "string",
                                "description" : "External system specific identifier of the contract system identifier element. If the source business document has any matching element, it should be used."
                              }
                            },
                            "required" : [ "name", "value" ]
                          }
                        },
                        "classifiedTaxCategory" : {
                          "type" : "array",
                          "description" : "A tax category applicable to this item.",
                          "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : " An identifier for the referenced document."
                              },
                              "percent" : {
                                "type" : "number",
                                "description" : "Tax rate for this category, expressed as a percentage"
                              },
                              "taxScheme" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "description" : "An identifier for this taxation scheme.",
                                "properties" : {
                                  "id" : {
                                    "type" : "string",
                                    "description" : "An identifier for this taxation scheme."
                                  }
                                }
                              }
                            }
                          }
                        }
                      },
                      "required" : [ "name" ]
                    },
                    "quantity" : {
                      "description" : "Quantity of the target Business Document line item.",
                      "additionalProperties" : false,
                      "properties" : {
                        "amount" : {
                          "type" : "number",
                          "description" : "The quantity of the target Business Document line items."
                        },
                        "unitCode" : {
                          "type" : "string",
                          "description" : "The unit code of the quantity of the target Business Document line item. Valid values: UN/ECE CEFACT Trade Facilitation Recommendation No.20 common code value represented as string."
                        }
                      }
                    },
                    "maximumBackOrderQuantity" : {
                      "description" : "The maximum back order quantity of the item associated with this line.",
                      "additionalProperties" : false,
                      "properties" : {
                        "amount" : {
                          "type" : "number",
                          "description" : "The back order quantity of the item associated with this line."
                        },
                        "unitCode" : {
                          "type" : "string",
                          "description" : "The unit code of the maximumBackOrderQuantity of the target Business Document line item."
                        }
                      }
                    },
                    "delivery" : {
                      "description" : "Delivery details",
                      "additionalProperties" : false,
                      "properties" : {
                        "promisedDeliveryPeriod" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "Promised delivery period",
                          "properties" : {
                            "startDate" : {
                              "description" : "Earliest date when the goods/services are promised to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                            },
                            "startTime" : {
                              "type" : "string",
                              "description" : "The time at which this time period begins."
                            },
                            "endDate" : {
                              "description" : "Latest date when the goods/services are promised to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                            },
                            "endTime" : {
                              "type" : "string",
                              "description" : "The time at which this time period ends."
                            }
                          }
                        },
                        "requestedDeliveryPeriod" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "Requested delivery period",
                          "properties" : {
                            "startDate" : {
                              "description" : "Earliest date when the goods/services are requested to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                            },
                            "startTime" : {
                              "type" : "string",
                              "description" : "The time at which this time period begins."
                            },
                            "endDate" : {
                              "description" : "Latest date when the goods/services are requested to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                            },
                            "endTime" : {
                              "type" : "string",
                              "description" : "The time at which this time period ends."
                            }
                          }
                        },
                        "deliveryParty" : {
                          "description" : "Party that is responsible for the delivery of the goods/services in the referred business document.",
                          "properties" : {
                            "endpoint" : {
                              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                              "additionalProperties" : false,
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                                }
                              },
                              "required" : [ "id" ]
                            },
                            "partyIdentifications" : {
                              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                              "items" : {
                                "type" : "object",
                                "description" : "An object holding a party identification.",
                                "properties" : {
                                  "id" : {
                                    "type" : "string",
                                    "description" : "An object holding the system identifier of the party."
                                  },
                                  "schemeId" : {
                                    "type" : "string",
                                    "description" : "Global identifier of namescheme for party identifier."
                                  }
                                },
                                "required" : [ "id" ],
                                "additionalProperties" : false
                              }
                            },
                            "partyName" : {
                              "type" : "string",
                              "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                            },
                            "postalAddress" : {
                              "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                              "properties" : {
                                "cityName" : {
                                  "type" : "string",
                                  "description" : "The name of the city, town or village in the postal address of the party."
                                },
                                "postalZone" : {
                                  "type" : "string",
                                  "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                                },
                                "addressLine" : {
                                  "type" : "string",
                                  "description" : "The address line of the postal address of the party."
                                },
                                "addressLine2" : {
                                  "type" : "string",
                                  "description" : "The second address line of the postal address of the party."
                                },
                                "addressLine3" : {
                                  "type" : "string",
                                  "description" : "The third address line of the postal address of the party."
                                },
                                "locality" : {
                                  "type" : "string",
                                  "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                                },
                                "countrySubentity" : {
                                  "type" : "string",
                                  "description" : "The sub-entity of the area in the postal address."
                                },
                                "countryId" : {
                                  "type" : "string",
                                  "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                                },
                                "postBox" : {
                                  "type" : "string",
                                  "description" : "A post office box number registered for postal delivery by a postal service provider."
                                },
                                "streetName" : {
                                  "type" : "string",
                                  "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                                },
                                "additionalStreetName" : {
                                  "type" : "string",
                                  "description" : "An additional street name used to further clarify the address."
                                },
                                "region" : {
                                  "type" : "string",
                                  "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                                },
                                "district" : {
                                  "type" : "string",
                                  "description" : "The district or geographical division of a country or region in which this address is located."
                                },
                                "blockName" : {
                                  "type" : "string",
                                  "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                                },
                                "buildingName" : {
                                  "type" : "string",
                                  "description" : "The name of a building."
                                },
                                "buildingNumber" : {
                                  "type" : "string",
                                  "description" : "he number of a building within the street."
                                },
                                "department" : {
                                  "type" : "string",
                                  "description" : "The department of the addressee."
                                }
                              },
                              "additionalProperties" : false
                            },
                            "partyTaxScheme" : {
                              "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                              "properties" : {
                                "company" : {
                                  "type" : "object",
                                  "description" : "Information about the company taxes.",
                                  "properties" : {
                                    "id" : {
                                      "type" : "string",
                                      "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                                    },
                                    "schemeId" : {
                                      "type" : "string",
                                      "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                                    }
                                  },
                                  "additionalProperties" : false
                                }
                              },
                              "additionalProperties" : false
                            },
                            "partyLegalEntities" : {
                              "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                              "items" : {
                                "type" : "object",
                                "description" : "An object holding a party legal entity.",
                                "properties" : {
                                  "registrationName" : {
                                    "type" : "string",
                                    "description" : "Registration name of the legal entity."
                                  },
                                  "companyIdentifier" : {
                                    "description" : "Global legal party identifier, including name scheme",
                                    "properties" : {
                                      "id" : {
                                        "type" : "string",
                                        "description" : "Identifies the value."
                                      },
                                      "schemeId" : {
                                        "type" : "string",
                                        "description" : "Identifies the namespace of the id."
                                      }
                                    },
                                    "required" : [ "id" ],
                                    "additionalProperties" : false
                                  }
                                },
                                "required" : [ "registrationName", "companyIdentifier" ],
                                "additionalProperties" : false
                              }
                            },
                            "contact" : {
                              "description" : "An object containing information about contacts. Used for defining the company contact data.",
                              "properties" : {
                                "name" : {
                                  "type" : "string",
                                  "description" : "A contact name of the party."
                                },
                                "telephone" : {
                                  "type" : "string",
                                  "description" : "A telephone number of the contact of the party."
                                },
                                "telefax" : {
                                  "type" : "string",
                                  "description" : "A fax number of the contact of the party."
                                },
                                "electronicMail" : {
                                  "type" : "string",
                                  "description" : "An email of the contact of the party."
                                }
                              },
                              "additionalProperties" : false
                            },
                            "supplierAssignedAccountId" : {
                              "type" : "string",
                              "description" : "Account identifier assigned by the supplier."
                            },
                            "customerAssignedAccountId" : {
                              "type" : "string",
                              "description" : "Account identifier assigned by the customer."
                            },
                            "note" : {
                              "type" : "string",
                              "description" : "Free-form description of the party not included in other fields"
                            }
                          },
                          "required" : [ "partyName" ],
                          "additionalProperties" : false
                        },
                        "deliveryAddress" : {
                          "description" : "An object containing address information. Used for defining delivery address party data.",
                          "properties" : {
                            "cityName" : {
                              "type" : "string",
                              "description" : "The name of the city, town or village in the postal address of the party."
                            },
                            "postalZone" : {
                              "type" : "string",
                              "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                            },
                            "addressLine" : {
                              "type" : "string",
                              "description" : "The address line of the postal address of the party."
                            },
                            "addressLine2" : {
                              "type" : "string",
                              "description" : "The second address line of the postal address of the party."
                            },
                            "addressLine3" : {
                              "type" : "string",
                              "description" : "The third address line of the postal address of the party."
                            },
                            "locality" : {
                              "type" : "string",
                              "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                            },
                            "countrySubentity" : {
                              "type" : "string",
                              "description" : "The sub-entity of the area in the postal address."
                            },
                            "countryId" : {
                              "type" : "string",
                              "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                            },
                            "postBox" : {
                              "type" : "string",
                              "description" : "A post office box number registered for postal delivery by a postal service provider."
                            },
                            "streetName" : {
                              "type" : "string",
                              "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                            },
                            "additionalStreetName" : {
                              "type" : "string",
                              "description" : "An additional street name used to further clarify the address."
                            },
                            "region" : {
                              "type" : "string",
                              "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                            },
                            "district" : {
                              "type" : "string",
                              "description" : "The district or geographical division of a country or region in which this address is located."
                            },
                            "blockName" : {
                              "type" : "string",
                              "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                            },
                            "buildingName" : {
                              "type" : "string",
                              "description" : "The name of a building."
                            },
                            "buildingNumber" : {
                              "type" : "string",
                              "description" : "he number of a building within the street."
                            },
                            "department" : {
                              "type" : "string",
                              "description" : "The department of the addressee."
                            }
                          },
                          "additionalProperties" : false
                        },
                        "deliveryLocation" : {
                          "additionalProperties" : false,
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An identifier for this location."
                            },
                            "descriptions" : {
                              "description" : "An array holding the descriptions of the Text describing this location.",
                              "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "properties" : {
                                  "description" : {
                                    "type" : "string",
                                    "description" : "Description of the business document line item."
                                  }
                                },
                                "required" : [ "description" ]
                              }
                            }
                          }
                        }
                      }
                    },
                    "taxTotals" : {
                      "description" : "An array holding the tax totals.",
                      "items" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An object holding the information about tax.",
                        "properties" : {
                          "amount" : {
                            "type" : "number",
                            "description" : "Total amount of the taxes. The total tax amount for particular tax scheme e.g. VAT; the sum of each of the tax subtotals for each tax category within the tax scheme."
                          },
                          "currencyId" : {
                            "type" : "string",
                            "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                          },
                          "transactionCurrencyTax" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "An object holding transaction tax.",
                            "properties" : {
                              "amount" : {
                                "type" : "number",
                                "description" : "Amount of tax for the transaction."
                              }
                            },
                            "required" : [ "amount" ]
                          },
                          "taxSubtotals" : {
                            "items" : {
                              "type" : "object",
                              "additionalProperties" : false,
                              "description" : "An object holding the information about tax.",
                              "properties" : {
                                "currencyId" : {
                                  "type" : "string",
                                  "description" : "A code that identifies the currency of the tax subtotal. Valid values: ISO 4217 code represented as string."
                                },
                                "amount" : {
                                  "type" : "number",
                                  "description" : "Total amount of the taxes."
                                },
                                "percent" : {
                                  "type" : "number",
                                  "description" : "The tax rate for the category, expressed as a percentage."
                                },
                                "taxableAmount" : {
                                  "type" : "number",
                                  "description" : "Basis of the taxes. The net amount to which the tax percent (rate) is applied to calculate the tax amount."
                                },
                                "taxCategory" : {
                                  "type" : "object",
                                  "description" : "External identifier of tax category.",
                                  "properties" : {
                                    "id" : {
                                      "type" : "string",
                                      "description" : "Identifies the tax category identifier."
                                    },
                                    "schemeId" : {
                                      "type" : "string",
                                      "description" : "Identifies the namespace of the tax category identifier."
                                    },
                                    "name" : {
                                      "type" : "string",
                                      "description" : "Tax category description."
                                    },
                                    "taxExemptionReason" : {
                                      "type" : "string",
                                      "description" : "The reason for tax being exempted."
                                    }
                                  },
                                  "required" : [ "id" ],
                                  "additionalProperties" : false
                                }
                              },
                              "required" : [ "currencyId", "amount" ]
                            }
                          }
                        },
                        "required" : [ "amount", "currencyId" ]
                      }
                    },
                    "price" : {
                      "description" : "Price for the line item",
                      "additionalProperties" : false,
                      "properties" : {
                        "amount" : {
                          "type" : "number",
                          "description" : "The price of the line item."
                        },
                        "currencyId" : {
                          "type" : "string",
                          "description" : "A code that identifies the currency of the line item price. Valid values: ISO 4217 code represented as string."
                        },
                        "baseQuantity" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "The quantity at which this price applies.",
                          "properties" : {
                            "amount" : {
                              "type" : "number",
                              "description" : "The amount at which this price applies."
                            },
                            "unitCode" : {
                              "type" : "string",
                              "description" : "The unit of the quantity."
                            }
                          }
                        }
                      },
                      "required" : [ "amount", "currencyId" ]
                    },
                    "allowanceCharges" : {
                      "description" : "Extra payment or subtraction to Business Document, for example freight or handling fees.",
                      "additionalProperties" : false,
                      "items" : {
                        "type" : "object",
                        "properties" : {
                          "chargeIndicator" : {
                            "type" : "boolean",
                            "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
                          },
                          "allowanceChargeReasonCode" : {
                            "type" : "string",
                            "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code"
                          },
                          "allowanceChargeReason" : {
                            "type" : "string",
                            "description" : "The reason for this allowance or charge."
                          },
                          "multiplierFactorNumeric" : {
                            "type" : "number",
                            "description" : "The factor applied to the base amount to calculate the allowance charge."
                          },
                          "baseAmount" : {
                            "type" : "number",
                            "description" : "The monetary amount to which the multiplier factor is applied in calculating the amount of this allowance or charge."
                          },
                          "amount" : {
                            "type" : "number",
                            "description" : "The allowance charge amount."
                          },
                          "taxCategories" : {
                            "type" : "array",
                            "description" : "External identifier of tax category.",
                            "items" : {
                              "type" : "object",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the tax category identifier."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the tax category identifier."
                                },
                                "name" : {
                                  "type" : "string",
                                  "description" : "Tax category description."
                                },
                                "percent" : {
                                  "type" : "number",
                                  "description" : "Identifies the tax rate for this category, expressed as a percentage"
                                },
                                "taxExemptionReasonCode" : {
                                  "type" : "string",
                                  "description" : "Identifies the reason for tax being exempted, expressed as a code."
                                },
                                "taxExemptionReason" : {
                                  "type" : "string",
                                  "description" : "Identifies the reason for tax being exempted, expressed as text."
                                }
                              }
                            },
                            "required" : [ "id" ],
                            "additionalProperties" : false
                          },
                          "paymentMeans" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "An object holding the available payment means.",
                            "properties" : {
                              "paymentDueDate" : {
                                "type" : "string",
                                "description" : "Date when the business document is due for the payment means. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                                "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                              }
                            }
                          }
                        }
                      },
                      "required" : [ "chargeIndicator", "amount" ]
                    },
                    "partialDeliveryIndicator" : {
                      "type" : "string",
                      "description" : "An indicator that a partial delivery is allowed (true) or not (false)."
                    },
                    "customFields" : {
                      "description" : "Custom fields in the business document. Disclaimer! Use of a custom field assumes that the recipient can handle the custom fields. Before using custom field Basware needs to be contacted to assure the delivery of these fields. Additional changes may be incurred due to the use of these fields. There is no guarantee that the recipient can handle the specified custom fields.",
                      "items" : {
                        "type" : "object",
                        "description" : "Custom fields in the business document",
                        "additionalProperties" : false,
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "Name of the custom field",
                            "default" : "file"
                          },
                          "value" : {
                            "type" : "string",
                            "description" : "Value of the custom field"
                          },
                          "description" : {
                            "type" : "string",
                            "description" : "The purpose of this field"
                          }
                        },
                        "required" : [ "name", "value" ]
                      }
                    },
                    "lineExtension" : {
                      "description" : "The total amount for the line item, including allowance charges but net of taxes.",
                      "additionalProperties" : false,
                      "properties" : {
                        "currencyId" : {
                          "type" : "string",
                          "description" : "The currency of the amount."
                        },
                        "amount" : {
                          "type" : "number",
                          "description" : "The total amount for the line item, including allowance charges but net of taxes."
                        }
                      },
                      "required" : [ "amount" ]
                    },
                    "quotationLineReference" : {
                      "description" : "A reference to a quotation line associated with this order line.",
                      "additionalProperties" : false,
                      "properties" : {
                        "lineId" : {
                          "type" : "string",
                          "description" : "Identifies the referenced line in the document."
                        }
                      },
                      "required" : [ "lineId" ]
                    },
                    "orderLineReference" : {
                      "description" : "A reference to another order line, such as in a replacement order or another line on the same order that is related.",
                      "additionalProperties" : false,
                      "properties" : {
                        "lineId" : {
                          "type" : "string",
                          "description" : "Identifies the referenced line in the document."
                        }
                      },
                      "required" : [ "lineId" ]
                    },
                    "sellerSubstitutedLineItem" : {
                      "description" : "In Order Response, a line item that has replaced the original order line item.",
                      "additionalProperties" : false,
                      "items" : {
                        "type" : "object",
                        "properties" : {
                          "id" : {
                            "description" : "An identifier for this line item, assigned by the buyer.",
                            "type" : "string"
                          },
                          "item" : {
                            "description" : "Order item details",
                            "additionalProperties" : false,
                            "properties" : {
                              "descriptions" : {
                                "description" : "An array holding the descriptions of the Business Document line items.",
                                "items" : {
                                  "type" : "object",
                                  "additionalProperties" : false,
                                  "properties" : {
                                    "description" : {
                                      "type" : "string",
                                      "description" : "Description of the business document line item."
                                    }
                                  },
                                  "required" : [ "description" ]
                                }
                              },
                              "name" : {
                                "type" : "string",
                                "description" : "Name of the Business Document line item.  A short name optionally given to an item, such as a name from a catalogue which is distinct from a description."
                              },
                              "taxPercent" : {
                                "type" : "number",
                                "description" : "Tax amount for the item"
                              },
                              "taxCategory" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "description" : "Identifying information for this item, assigned by the buyer.",
                                "properties" : {
                                  "id" : {
                                    "type" : "string",
                                    "description" : "An identifier for the item."
                                  }
                                }
                              },
                              "buyersItemIdentification" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "description" : "Identifying information for this item, assigned by the buyer.",
                                "properties" : {
                                  "id" : {
                                    "type" : "string",
                                    "description" : "An identifier for the item."
                                  }
                                },
                                "required" : [ "id" ]
                              },
                              "sellersItem" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "description" : "An object holding a identification of the Business Documents line item as it is in sellers system.",
                                "properties" : {
                                  "id" : {
                                    "type" : "string",
                                    "description" : "Identifier of the Business Document line item as it is in sellers system."
                                  },
                                  "schemeId" : {
                                    "type" : "string",
                                    "description" : "Namespace for system specific identifier of the sellers item identifier element. If the source business document has any matching element, it should be used."
                                  }
                                },
                                "required" : [ "id" ]
                              },
                              "standardItemIdentification" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "description" : "Identifying information for this item, assigned according to a standard system.",
                                "properties" : {
                                  "id" : {
                                    "type" : "string",
                                    "description" : "An identifier for the item."
                                  },
                                  "schemeId" : {
                                    "type" : "string",
                                    "description" : "The identification of the identification scheme"
                                  }
                                },
                                "required" : [ "id" ]
                              },
                              "commodityClassification" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "description" : "A classification of this item according to a specific system for classifying commodities.",
                                "properties" : {
                                  "itemClassificationCode" : {
                                    "type" : "string",
                                    "description" : "A code signifying the trade classification of the commodity."
                                  },
                                  "listId" : {
                                    "type" : "string",
                                    "description" : "The identification of a list of codes."
                                  }
                                }
                              },
                              "additionalItemProperties" : {
                                "description" : "Additional item properties for the order line item",
                                "items" : {
                                  "type" : "object",
                                  "additionalProperties" : false,
                                  "properties" : {
                                    "name" : {
                                      "type" : "string",
                                      "description" : "External system identifier of the contract referenced by the Business Document (i.e. buyers contract number). Mandatory field if the customer demands that the goods or services invoiced refer to a contract number defined by the customer to which he wants to assign the Business Document. Is demanded for example in service and maintenance agreements for which there is generally no explicit order."
                                    },
                                    "value" : {
                                      "type" : "string",
                                      "description" : "External system specific identifier of the contract system identifier element. If the source business document has any matching element, it should be used."
                                    }
                                  },
                                  "required" : [ "name", "value" ]
                                }
                              },
                              "classifiedTaxCategory" : {
                                "type" : "array",
                                "description" : "A tax category applicable to this item.",
                                "items" : {
                                  "type" : "object",
                                  "additionalProperties" : false,
                                  "properties" : {
                                    "id" : {
                                      "type" : "string",
                                      "description" : " An identifier for the referenced document."
                                    },
                                    "percent" : {
                                      "type" : "number",
                                      "description" : "Tax rate for this category, expressed as a percentage"
                                    },
                                    "taxScheme" : {
                                      "type" : "object",
                                      "additionalProperties" : false,
                                      "description" : "An identifier for this taxation scheme.",
                                      "properties" : {
                                        "id" : {
                                          "type" : "string",
                                          "description" : "An identifier for this taxation scheme."
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            },
                            "required" : [ "name" ]
                          }
                        }
                      },
                      "required" : [ "id" ]
                    }
                  },
                  "required" : [ "id", "item" ]
                }
              },
              "customFields" : {
                "description" : "Custom fields in the business document. Disclaimer! Use of a custom field assumes that the recipient can handle the custom fields. Before using custom field Basware needs to be contacted to assure the delivery of these fields. Additional changes may be incurred due to the use of these fields. There is no guarantee that the recipient can handle the specified custom fields.",
                "items" : {
                  "type" : "object",
                  "description" : "Custom fields in the business document",
                  "additionalProperties" : false,
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "Name of the custom field",
                      "default" : "file"
                    },
                    "value" : {
                      "type" : "string",
                      "description" : "Value of the custom field"
                    },
                    "description" : {
                      "type" : "string",
                      "description" : "The purpose of this field"
                    }
                  },
                  "required" : [ "name", "value" ]
                }
              }
            },
            "required" : [ "externalDocumentIdentifier", "issueDate", "buyerCustomerParty", "sellerSupplierParty" ]
        }
    },
    "required": [
        "clientToken",
        "documentType",
        "processingPreference",
        "data"
    ]
}

Response code 400 - Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.

Response example for the response code above 

{
  "error": {
    "id": "c842c9c3-75e5-4c32-ae3f-c1fe250fc186",
    "type": "VALIDATION",
    "message": "Business document identifier bumId does not match the pattern :[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}",
    "code": "Error.004.0003",
    "info": "Contact Basware Support http://www.basware.com/utility/contact-us and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

Response code 500 - Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

Response example for the response code above 

{
  "error": {
    "id": "a312a9b3-35e5-1a32-be3f-a5fe250fc121",
    "type": "TECHNICAL",
    "message": "BCN encountered an unexpected system error",
    "code": "Error.001.0006",
    "info": "Contact Basware Support http://www.basware.com/utility/contact-us and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

You can send an order to a recipient through Basware Network using the POST method.

Request URI

https://api.basware.com/v2/orders/{bumId}

URI Parameters

Param Name Type Required Example Description
bumId string true 6741ecc7-848a-443c-83ad-ea95e4df06fa Unique UUID for order

Request Headers

Param Name Required Example Description
Content-Type true application/json Specifies media types which are acceptable for the request. Value application/json is supported.
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Responses

Response code Description
201 The request has been fulfilled successfully and a new resource is created on server.
400 Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
409 Conflict. The request could not be completed due to a conflict with the current state of the target resource.
415 Unsupported Media Type. The server is refusing to service the request because the payload is in an unsupported format.
500 Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

GET

GET /orders/{bumId} HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Response code 200 - The request has been completed successfully.

Response example for the response code above 

{
  "bumId": "c6d7067f-eb67-4289-89ec-819446078a3a",
  "documentType": "OrderResponse",
  "origin": {
    "source": "SendingCustomer",
    "sourceContentCategory": "StructuredData",
    "sourceChannelCategory": "Electronic",
    "processQualityIndicators": [
      "ContentValidation",
      "StructuralValidation"
    ]
  },
  "data": {
    "externalDocumentIdentifier": {
      "id": "374516342"
    },
    "issueDate": "2019-01-03",
    "documentCurrencyCode": "USD",
    "orderReference": {
      "id": "374516341",
      "issueDate": "2019-01-03"
    },
    "salesOrderId": "CON0095678",
    "acceptedIndicator": false,
    "copyIndicator": false,
    "customerReference": "WS:21508502",
    "buyerCustomerParty": {
      "party": {
        "partyName": "Get Tech USA",
        "customerAssignedAccountId" : "444403",
        "partyIdentifications": [
          {
            "id": "51-3985026",
            "schemeId": "TIN"
          }
        ],
        "postalAddress": {
          "addressLine": "362 Hamilton Avenue",
          "cityName": "White Plains",
          "postalZone": "10167",
          "countrySubentity": "NY",
          "countryId": "US"
        }
      }
    },
    "sellerSupplierParty": {
      "party": {
        "partyName": "Moon Travel Oy",
        "customerAssignedAccountId" : "544403",
        "partyIdentifications": [
          {
            "id": "0527768-2",
            "schemeId": "FI:ORGNR"
          }
        ],
        "postalAddress": {
          "addressLine": "Albertinkatu 36 B",
          "cityName": "Helsinki",
          "postalZone": "00180",
          "countryId": "FI"
        }
      }
    },
    "accountingCustomerParty": {
      "party": {
        "partyName": "Get Tech Global",
        "customerAssignedAccountId" : "644403",
        "partyIdentifications": [
          {
            "id": "52-3985027",
            "schemeId": "TIN"
          }
        ],
        "postalAddress": {
          "addressLine": "362 Hamilton Avenue",
          "cityName": "White Plains",
          "postalZone": "10167",
          "countrySubentity": "NY",
          "countryId": "US"
        }
      }
    },
    "delivery": {
      "requestedDeliveryPeriod": {
        "startDate": "2019-01-05",
        "endDate": "2019-01-05"
      },
      "promisedDeliveryPeriod": {
        "startDate": "2019-01-06",
        "endDate": "2019-01-06"
      },
      "deliveryParty": {
        "partyName": "Moon Travel Oy",
        "postalAddress": {
          "addressLine": "Albertinkatu 36 B",
          "cityName": "Helsinki",
          "postalZone": "00180",
          "countryId": "FI"
        },
        "contact": {
          "name": "Matti Järvinen",
          "telephone": "+358401754301",
          "telefax": "+358405430100",
          "electronicMail": "[email protected]"
        }
      }
    },
    "deliveryTerms": {
      "specialTerms": "Incoterms 2010"
    },
    "paymentMeans": {
      "paymentMeansCode": "31",
      "paymentDueDate": "2019-01-16",
      "paymentReferenceMessage": "142 3223 0034 10",
      "payeeFinancialAccounts": [
        {
          "financialInstitutionName": "Nordea",
          "financialInstitutionId": "NDEAFIHH",
          "financialAccountIdentifiers": [
            {
              "id": "FI8422841800122484",
              "schemeId": "IBAN"
            }
          ]
        }
      ],
      "paymentIdentifier": {
        "id": "63156783578924",
        "schemeId": "SPY"
      }
    },
    "taxTotal": {
      "amount": 26.0,
      "currencyId": "USD",
      "taxSubtotals": [
        {
          "amount": 26.0,
          "taxableAmount": 260.0,
          "currencyId": "USD",
          "percent": 10.0,
          "taxCategory": {
            "id": "S",
            "name": "Transport",
            "taxExemptionReason": "Exempt New Means of Transport",
            "schemeId": "VAT"
          }
        }
      ]
    },
    "anticipatedMonetaryTotal": {
      "lineExtensionAmount": {
        "currencyId": "USD",
        "amount": 260.0
      },
      "payableAmount": {
        "currencyId": "USD",
        "amount": 286.0
      },
      "taxExclusiveAmount": {
        "currencyId": "USD",
        "amount": 279.0
      },
      "taxInclusiveAmount": {
        "currencyId": "USD",
        "amount": 279.0
      },
      "allowanceTotalAmount": {
        "currencyId": "USD",
        "amount": 1279.0
      },
      "chargeTotalAmount": {
        "currencyId": "USD",
        "amount": 2279.0
      }
    },
    "documentLines": [
      {
        "id": "1",
        "sellerSubstitutedLineItem": [{
          "id": "2",
          "item": {
            "descriptions": [{
              "description": "Basic High-Speed HDMI Cable - 25 sellerSubstitutedLineItem"
            },
              {
                "description": "sellerSubstitutedLineItem Supports Ethernet, 3D, 4K and Audio Return"
              }
            ],
            "name": "Copy paper",
            "sellersItem": {
              "id": "3249834"
            },
            "standardItemIdentification": {
              "id": "87463294723134124",
              "schemeId": "0160"
            },
            "commodityClassification": {
              "itemClassificationCode": "20.0601",
              "listId": "MP"
            },
            "additionalItemProperties": [{
              "name": "Color",
              "value": "Red"
            }
            ],
            "classifiedTaxCategory": [{
              "id": "S",
              "percent": 25,
              "taxScheme": {
                "id": "VAT"
              }
            }
            ]
          }
        }],
        "item": {
          "descriptions": [
            {
              "description": "Basic High-Speed HDMI Cable - 25 Feet"
            },
            {
              "description": "Supports Ethernet, 3D, 4K and Audio Return"
            }
          ],
          "name": "High-Speed HDMI Cable",
          "sellersItem": {
            "id": "B-341"
          },
          "standardItemIdentification": {
            "id": "1234567890124",
            "schemeId": "GT"
          },
          "commodityClassification": {
            "itemClassificationCode": "12344321",
            "listId": "620"
          },
          "additionalItemProperties": [
            {
              "name": "packingMaterial",
              "value": "Box"
            },
            {
              "name": "lineItemType",
              "value": "Package"
            }
          ]
        },
        "delivery": {
          "requestedDeliveryPeriod": {
            "startDate": "2019-01-05",
            "endDate": "2019-01-05"
          },
          "promisedDeliveryPeriod": {
            "startDate": "2019-01-06",
            "endDate": "2019-01-06"
          },
          "deliveryParty": {
            "partyName": "Get Tech Global",
            "postalAddress": {
              "addressLine": "362 Hamilton Avenue",
              "cityName": "White Plains",
              "postalZone": "10167",
              "countrySubentity": "NY",
              "countryId": "US"
            }
          },
          "deliveryAddress": {
            "addressLine": "29 CHASE RD",
            "cityName": "SCARSDALE",
            "postalZone": "10583",
            "countrySubentity": "NY",
            "countryId": "US"
          }
        },
        "price": {
          "amount": 10.0,
          "currencyId": "USD"
        },
        "quantity": {
          "amount": 26,
          "unitCode": "PCE"
        },
        "orderLineReference": {
          "lineId": "1"
        },
        "taxTotals": [
          {
            "amount": 26.0,
            "currencyId": "USD",
            "taxSubtotals": [
              {
                "amount": 26.0,
                "currencyId": "USD",
                "percent": 10.0,
                "taxCategory": {
                  "id": "UN/ECE 5315",
                  "name": "Kane",
                  "taxExemptionReason": "Exempt from 5 percent tax",
                  "schemeId": "VAT"
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Response schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Schema for GET /orders",
  "description": "Order response is a business document which contains Order .",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "bumId": {
      "description": "Identifies the business document (Basware Unique Message Identifier). It is an unique identifier (UUID) that can be used by external systems to identify a business document.",
      "pattern" : "^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$"
    },
    "documentType": {
      "type": "string",
      "enum": ["Order", "OrderChange", "OrderCancellation", "OrderResponse"],
      "description": "Indicates the business document type. Possible values are Order, OrderChange, OrderCancellation and OrderResponse."
    },
    "origin": {
      "additionalProperties" : false,
      "properties" : {
        "source" : {
          "type" : "string",
          "description" : "The originating source of the document. Possible values: SendingCustomer, ReceivingCustomer, ServiceProvider"
        },
        "sourceContentCategory" : {
          "type" : "string",
          "description" : "Indicates the source content. If the content is structured data, the data quality is higher. Possible values: Image, StructuredData, UnstructuredData"
        },
        "sourceChannelCategory" : {
          "type" : "string",
          "description" : "Indicates the source channel of the business document. Possible values: PostalMail, ElectronicMail, Electronic"
        },
        "processQualityIndicators" : {
          "type" : "array",
          "description" : "The quality phases the document has gone through",
          "items" : {
            "type" : "string",
            "description" : "Possible values: HumanSelfValidation, HumanValidation, StructuralValidation, ContentValidation"
          }
        }
      }
    },
    "fileRefs": {
      "items" : {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
          "refId" : {
            "type" : "string",
            "description" : "Unique file identifier received after storing file into Basware Network."
          },
          "fileType" : {
            "type" : "string",
            "description" : "File type. Possible values are imageFile, attachmentFile and dataFile."
          }
        },
        "required" : [ "refId", "fileType" ]
      }
    },
    "links": {
      "items" : {
        "type" : "object",
        "description" : "Links related to the business document",
        "properties" : {
          "rel" : {
            "type" : "string",
            "description" : "Relation type for the URL in question. Possible values are file.",
            "default" : "file"
          },
          "href" : {
            "type" : "string",
            "description" : "Link between the completed call and a future call. The URI is a fully formed URI, which needs also the method field"
          },
          "method" : {
            "type" : "string",
            "enum" : [ "GET", "POST" ],
            "description" : "HTTP methods required to interact with the provided URL",
            "default" : "GET"
          }
        }
      }
    },
    "data": {
      "additionalProperties" : false,
      "properties" : {
        "externalDocumentIdentifier" : {
          "description" : "Identifier of the business document. Serial number that is issued once only by issuer to identify the business document.",
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "Identifies the value."
            },
            "schemeId" : {
              "type" : "string",
              "description" : "Identifies the namespace of the id."
            }
          },
          "required" : [ "id" ],
          "additionalProperties" : false
        },
        "documentCurrencyCode" : {
          "type" : "string",
          "description" : "Currency code of the business document. Valid values must be ISO 4217 Alpha format, for example EUR, USD."
        },
        "salesOrderId" : {
          "type" : "string",
          "description" : "An identifier for the Order, assigned by the seller."
        },
        "orderReference" : {
          "type" : "object",
          "description" : "Identifies the order referenced by the Business Document.",
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "Identifies the order document."
            },
            "issueDate" : {
              "type" : "string",
              "description" : "Issue date."
            },
            "issueTime" : {
              "type" : "string",
              "description" : "Issue time."
            },
            "UUID" : {
              "type" : "string",
              "description" : "A universally unique identifier for this order reference."
            }
          },
          "required" : [ "id" ]
        },
        "orderResponseCode" : {
          "type" : "string",
          "description" : "A code signifying the type of response for this Order.This field is used in OrderResponse only."
        },
        "note" : {
          "type" : "string",
          "description" : "Free-form text. This field may contain notes or any other similar information that is not contained explicitly in another structure."
        },
        "buyerCustomerParty" : {
          "description" : "Party that is the buyer of the goods/services in the referred business document.",
          "properties" : {
            "party" : {
              "description" : "Party in the order",
              "properties" : {
                "endpoint" : {
                  "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                  "additionalProperties" : false,
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                    }
                  },
                  "required" : [ "id" ]
                },
                "partyIdentifications" : {
                  "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                  "items" : {
                    "type" : "object",
                    "description" : "An object holding a party identification.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An object holding the external system identifier of the party."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the id identifier element."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "partyName" : {
                  "type" : "string",
                  "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                },
                "customerAssignedAccountId" : {
                  "type" : "string",
                  "description" : "Account identifier assigned by the customer."
                },
                "postalAddress" : {
                  "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                  "properties" : {
                    "cityName" : {
                      "type" : "string",
                      "description" : "The name of the city, town or village in the postal address of the party."
                    },
                    "postalZone" : {
                      "type" : "string",
                      "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                    },
                    "addressLine" : {
                      "type" : "string",
                      "description" : "The address line of the postal address of the party."
                    },
                    "addressLine2" : {
                      "type" : "string",
                      "description" : "The second address line of the postal address of the party."
                    },
                    "addressLine3" : {
                      "type" : "string",
                      "description" : "The third address line of the postal address of the party."
                    },
                    "locality" : {
                      "type" : "string",
                      "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                    },
                    "countrySubentity" : {
                      "type" : "string",
                      "description" : "The sub-entity of the area in the postal address."
                    },
                    "countryId" : {
                      "type" : "string",
                      "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                    },
                    "postBox" : {
                      "type" : "string",
                      "description" : "A post office box number registered for postal delivery by a postal service provider."
                    },
                    "streetName" : {
                      "type" : "string",
                      "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                    },
                    "additionalStreetName" : {
                      "type" : "string",
                      "description" : "An additional street name used to further clarify the address."
                    },
                    "region" : {
                      "type" : "string",
                      "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                    },
                    "district" : {
                      "type" : "string",
                      "description" : "The district or geographical division of a country or region in which this address is located."
                    },
                    "blockName" : {
                      "type" : "string",
                      "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                    },
                    "buildingName" : {
                      "type" : "string",
                      "description" : "The name of a building."
                    },
                    "buildingNumber" : {
                      "type" : "string",
                      "description" : "he number of a building within the street."
                    },
                    "department" : {
                      "type" : "string",
                      "description" : "The department of the addressee."
                    }
                  },
                  "additionalProperties" : false
                },
                "partyTaxScheme" : {
                  "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                  "properties" : {
                    "company" : {
                      "type" : "object",
                      "description" : "Information about the company taxes.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                        }
                      },
                      "additionalProperties" : false
                    },
                    "taxScheme" : {
                      "type" : "object",
                      "description" : "The taxation scheme applicable to the party.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "An identifier for this taxation scheme."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "The identification of the identification scheme."
                        }
                      },
                      "additionalProperties" : false
                    }
                  },
                  "additionalProperties" : false
                },
                "partyLegalEntities" : {
                  "type" : "array",
                  "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                  "items" : {
                    "type" : "object",
                    "description" : "An object holding a party legal entity.",
                    "properties" : {
                      "registrationName" : {
                        "type" : "string",
                        "description" : "Registration name of the legal entity."
                      },
                      "companyIdentifier" : {
                        "description" : "Global legal party identifier, including name scheme",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the value."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the id."
                          }
                        },
                        "required" : [ "id" ],
                        "additionalProperties" : false
                      }
                    },
                    "additionalProperties" : false
                  }
                },
                "contact" : {
                  "description" : "An object containing information about contacts. Used for defining the company contact data.",
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "A contact name of the party."
                    },
                    "telephone" : {
                      "type" : "string",
                      "description" : "A telephone number of the contact of the party."
                    },
                    "telefax" : {
                      "type" : "string",
                      "description" : "A fax number of the contact of the party."
                    },
                    "electronicMail" : {
                      "type" : "string",
                      "description" : "An email of the contact of the party."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "required" : [ "partyName" ],
              "additionalProperties" : false
            }
          },
          "required" : [ "party" ]
        },
        "originatorCustomerParty" : {
          "description" : "Party that is the originator of the goods/services in the referred business document.",
          "additionalProperties" : false,
          "properties" : {
            "party" : {
              "description" : "Party that is the originator of the goods/services in the referred business document.",
              "properties" : {
                "endpoint" : {
                  "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                  "additionalProperties" : false,
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                    }
                  },
                  "required" : [ "id" ]
                },
                "partyIdentifications" : {
                  "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                  "items" : {
                    "type" : "object",
                    "description" : "An object holding a party identification.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An object holding the external system identifier of the party."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the id identifier element."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "partyName" : {
                  "type" : "string",
                  "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                },
                "customerAssignedAccountId" : {
                  "type" : "string",
                  "description" : "Account identifier assigned by the customer."
                },
                "postalAddress" : {
                  "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                  "properties" : {
                    "cityName" : {
                      "type" : "string",
                      "description" : "The name of the city, town or village in the postal address of the party."
                    },
                    "postalZone" : {
                      "type" : "string",
                      "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                    },
                    "addressLine" : {
                      "type" : "string",
                      "description" : "The address line of the postal address of the party."
                    },
                    "addressLine2" : {
                      "type" : "string",
                      "description" : "The second address line of the postal address of the party."
                    },
                    "addressLine3" : {
                      "type" : "string",
                      "description" : "The third address line of the postal address of the party."
                    },
                    "locality" : {
                      "type" : "string",
                      "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                    },
                    "countrySubentity" : {
                      "type" : "string",
                      "description" : "The sub-entity of the area in the postal address."
                    },
                    "countryId" : {
                      "type" : "string",
                      "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                    },
                    "postBox" : {
                      "type" : "string",
                      "description" : "A post office box number registered for postal delivery by a postal service provider."
                    },
                    "streetName" : {
                      "type" : "string",
                      "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                    },
                    "additionalStreetName" : {
                      "type" : "string",
                      "description" : "An additional street name used to further clarify the address."
                    },
                    "region" : {
                      "type" : "string",
                      "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                    },
                    "district" : {
                      "type" : "string",
                      "description" : "The district or geographical division of a country or region in which this address is located."
                    },
                    "blockName" : {
                      "type" : "string",
                      "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                    },
                    "buildingName" : {
                      "type" : "string",
                      "description" : "The name of a building."
                    },
                    "buildingNumber" : {
                      "type" : "string",
                      "description" : "he number of a building within the street."
                    },
                    "department" : {
                      "type" : "string",
                      "description" : "The department of the addressee."
                    }
                  },
                  "additionalProperties" : false
                },
                "partyTaxScheme" : {
                  "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                  "properties" : {
                    "company" : {
                      "type" : "object",
                      "description" : "Information about the company taxes.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                        }
                      },
                      "additionalProperties" : false
                    },
                    "taxScheme" : {
                      "type" : "object",
                      "description" : "The taxation scheme applicable to the party.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "An identifier for this taxation scheme."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "The identification of the identification scheme."
                        }
                      },
                      "additionalProperties" : false
                    }
                  },
                  "additionalProperties" : false
                },
                "partyLegalEntities" : {
                  "type" : "array",
                  "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                  "items" : {
                    "type" : "object",
                    "description" : "An object holding a party legal entity.",
                    "properties" : {
                      "registrationName" : {
                        "type" : "string",
                        "description" : "Registration name of the legal entity."
                      },
                      "companyIdentifier" : {
                        "description" : "Global legal party identifier, including name scheme",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the value."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the id."
                          }
                        },
                        "required" : [ "id" ],
                        "additionalProperties" : false
                      }
                    },
                    "additionalProperties" : false
                  }
                },
                "contact" : {
                  "description" : "An object containing information about contacts. Used for defining the company contact data.",
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "A contact name of the party."
                    },
                    "telephone" : {
                      "type" : "string",
                      "description" : "A telephone number of the contact of the party."
                    },
                    "telefax" : {
                      "type" : "string",
                      "description" : "A fax number of the contact of the party."
                    },
                    "electronicMail" : {
                      "type" : "string",
                      "description" : "An email of the contact of the party."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "required" : [ "partyName" ],
              "additionalProperties" : false
            },
            "agentParty" : {
              "description" : "Party that is the originator of the goods/services in the referred business document.",
              "properties" : {
                "endpoint" : {
                  "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                  "additionalProperties" : false,
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                    }
                  },
                  "required" : [ "id" ]
                },
                "partyIdentifications" : {
                  "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                  "items" : {
                    "type" : "object",
                    "description" : "An object holding a party identification.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An object holding the external system identifier of the party."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the id identifier element."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "partyName" : {
                  "type" : "string",
                  "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                },
                "customerAssignedAccountId" : {
                  "type" : "string",
                  "description" : "Account identifier assigned by the customer."
                },
                "postalAddress" : {
                  "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                  "properties" : {
                    "cityName" : {
                      "type" : "string",
                      "description" : "The name of the city, town or village in the postal address of the party."
                    },
                    "postalZone" : {
                      "type" : "string",
                      "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                    },
                    "addressLine" : {
                      "type" : "string",
                      "description" : "The address line of the postal address of the party."
                    },
                    "addressLine2" : {
                      "type" : "string",
                      "description" : "The second address line of the postal address of the party."
                    },
                    "addressLine3" : {
                      "type" : "string",
                      "description" : "The third address line of the postal address of the party."
                    },
                    "locality" : {
                      "type" : "string",
                      "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                    },
                    "countrySubentity" : {
                      "type" : "string",
                      "description" : "The sub-entity of the area in the postal address."
                    },
                    "countryId" : {
                      "type" : "string",
                      "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                    },
                    "postBox" : {
                      "type" : "string",
                      "description" : "A post office box number registered for postal delivery by a postal service provider."
                    },
                    "streetName" : {
                      "type" : "string",
                      "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                    },
                    "additionalStreetName" : {
                      "type" : "string",
                      "description" : "An additional street name used to further clarify the address."
                    },
                    "region" : {
                      "type" : "string",
                      "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                    },
                    "district" : {
                      "type" : "string",
                      "description" : "The district or geographical division of a country or region in which this address is located."
                    },
                    "blockName" : {
                      "type" : "string",
                      "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                    },
                    "buildingName" : {
                      "type" : "string",
                      "description" : "The name of a building."
                    },
                    "buildingNumber" : {
                      "type" : "string",
                      "description" : "he number of a building within the street."
                    },
                    "department" : {
                      "type" : "string",
                      "description" : "The department of the addressee."
                    }
                  },
                  "additionalProperties" : false
                },
                "partyTaxScheme" : {
                  "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                  "properties" : {
                    "company" : {
                      "type" : "object",
                      "description" : "Information about the company taxes.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                        }
                      },
                      "additionalProperties" : false
                    },
                    "taxScheme" : {
                      "type" : "object",
                      "description" : "The taxation scheme applicable to the party.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "An identifier for this taxation scheme."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "The identification of the identification scheme."
                        }
                      },
                      "additionalProperties" : false
                    }
                  },
                  "additionalProperties" : false
                },
                "partyLegalEntities" : {
                  "type" : "array",
                  "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                  "items" : {
                    "type" : "object",
                    "description" : "An object holding a party legal entity.",
                    "properties" : {
                      "registrationName" : {
                        "type" : "string",
                        "description" : "Registration name of the legal entity."
                      },
                      "companyIdentifier" : {
                        "description" : "Global legal party identifier, including name scheme",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the value."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the id."
                          }
                        },
                        "required" : [ "id" ],
                        "additionalProperties" : false
                      }
                    },
                    "additionalProperties" : false
                  }
                },
                "contact" : {
                  "description" : "An object containing information about contacts. Used for defining the company contact data.",
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "A contact name of the party."
                    },
                    "telephone" : {
                      "type" : "string",
                      "description" : "A telephone number of the contact of the party."
                    },
                    "telefax" : {
                      "type" : "string",
                      "description" : "A fax number of the contact of the party."
                    },
                    "electronicMail" : {
                      "type" : "string",
                      "description" : "An email of the contact of the party."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "required" : [ "partyName" ],
              "additionalProperties" : false
            },
            "supplierAssignedAccountId" : {
              "type" : "string",
              "description" : "Supplier assigned account identifier."
            }
          },
          "required" : [ "party" ]
        },
        "sellerSupplierParty" : {
          "description" : "Party that is the supplier of the goods/services in the referred business document.",
          "properties" : {
            "party" : {
              "description" : "Party in the order",
              "properties" : {
                "endpoint" : {
                  "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                  "additionalProperties" : false,
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                    }
                  },
                  "required" : [ "id" ]
                },
                "partyIdentifications" : {
                  "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                  "items" : {
                    "type" : "object",
                    "description" : "An object holding a party identification.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An object holding the external system identifier of the party."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the id identifier element."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "partyName" : {
                  "type" : "string",
                  "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                },
                "customerAssignedAccountId" : {
                  "type" : "string",
                  "description" : "Account identifier assigned by the customer."
                },
                "postalAddress" : {
                  "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                  "properties" : {
                    "cityName" : {
                      "type" : "string",
                      "description" : "The name of the city, town or village in the postal address of the party."
                    },
                    "postalZone" : {
                      "type" : "string",
                      "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                    },
                    "addressLine" : {
                      "type" : "string",
                      "description" : "The address line of the postal address of the party."
                    },
                    "addressLine2" : {
                      "type" : "string",
                      "description" : "The second address line of the postal address of the party."
                    },
                    "addressLine3" : {
                      "type" : "string",
                      "description" : "The third address line of the postal address of the party."
                    },
                    "locality" : {
                      "type" : "string",
                      "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                    },
                    "countrySubentity" : {
                      "type" : "string",
                      "description" : "The sub-entity of the area in the postal address."
                    },
                    "countryId" : {
                      "type" : "string",
                      "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                    },
                    "postBox" : {
                      "type" : "string",
                      "description" : "A post office box number registered for postal delivery by a postal service provider."
                    },
                    "streetName" : {
                      "type" : "string",
                      "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                    },
                    "additionalStreetName" : {
                      "type" : "string",
                      "description" : "An additional street name used to further clarify the address."
                    },
                    "region" : {
                      "type" : "string",
                      "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                    },
                    "district" : {
                      "type" : "string",
                      "description" : "The district or geographical division of a country or region in which this address is located."
                    },
                    "blockName" : {
                      "type" : "string",
                      "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                    },
                    "buildingName" : {
                      "type" : "string",
                      "description" : "The name of a building."
                    },
                    "buildingNumber" : {
                      "type" : "string",
                      "description" : "he number of a building within the street."
                    },
                    "department" : {
                      "type" : "string",
                      "description" : "The department of the addressee."
                    }
                  },
                  "additionalProperties" : false
                },
                "partyTaxScheme" : {
                  "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                  "properties" : {
                    "company" : {
                      "type" : "object",
                      "description" : "Information about the company taxes.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                        }
                      },
                      "additionalProperties" : false
                    },
                    "taxScheme" : {
                      "type" : "object",
                      "description" : "The taxation scheme applicable to the party.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "An identifier for this taxation scheme."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "The identification of the identification scheme."
                        }
                      },
                      "additionalProperties" : false
                    }
                  },
                  "additionalProperties" : false
                },
                "partyLegalEntities" : {
                  "type" : "array",
                  "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                  "items" : {
                    "type" : "object",
                    "description" : "An object holding a party legal entity.",
                    "properties" : {
                      "registrationName" : {
                        "type" : "string",
                        "description" : "Registration name of the legal entity."
                      },
                      "companyIdentifier" : {
                        "description" : "Global legal party identifier, including name scheme",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the value."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the id."
                          }
                        },
                        "required" : [ "id" ],
                        "additionalProperties" : false
                      }
                    },
                    "additionalProperties" : false
                  }
                },
                "contact" : {
                  "description" : "An object containing information about contacts. Used for defining the company contact data.",
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "A contact name of the party."
                    },
                    "telephone" : {
                      "type" : "string",
                      "description" : "A telephone number of the contact of the party."
                    },
                    "telefax" : {
                      "type" : "string",
                      "description" : "A fax number of the contact of the party."
                    },
                    "electronicMail" : {
                      "type" : "string",
                      "description" : "An email of the contact of the party."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "required" : [ "partyName" ],
              "additionalProperties" : false
            }
          },
          "required" : [ "party" ]
        },
        "accountingCustomerParty" : {
          "description" : "Party that is the buyer of the goods/services in the referred business document.",
          "properties" : {
            "party" : {
              "description" : "Party in the order",
              "properties" : {
                "endpoint" : {
                  "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                  "additionalProperties" : false,
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                    }
                  },
                  "required" : [ "id" ]
                },
                "partyIdentifications" : {
                  "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                  "items" : {
                    "type" : "object",
                    "description" : "An object holding a party identification.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An object holding the external system identifier of the party."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the id identifier element."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "partyName" : {
                  "type" : "string",
                  "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                },
                "customerAssignedAccountId" : {
                  "type" : "string",
                  "description" : "Account identifier assigned by the customer."
                },
                "postalAddress" : {
                  "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                  "properties" : {
                    "cityName" : {
                      "type" : "string",
                      "description" : "The name of the city, town or village in the postal address of the party."
                    },
                    "postalZone" : {
                      "type" : "string",
                      "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                    },
                    "addressLine" : {
                      "type" : "string",
                      "description" : "The address line of the postal address of the party."
                    },
                    "addressLine2" : {
                      "type" : "string",
                      "description" : "The second address line of the postal address of the party."
                    },
                    "addressLine3" : {
                      "type" : "string",
                      "description" : "The third address line of the postal address of the party."
                    },
                    "locality" : {
                      "type" : "string",
                      "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                    },
                    "countrySubentity" : {
                      "type" : "string",
                      "description" : "The sub-entity of the area in the postal address."
                    },
                    "countryId" : {
                      "type" : "string",
                      "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                    },
                    "postBox" : {
                      "type" : "string",
                      "description" : "A post office box number registered for postal delivery by a postal service provider."
                    },
                    "streetName" : {
                      "type" : "string",
                      "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                    },
                    "additionalStreetName" : {
                      "type" : "string",
                      "description" : "An additional street name used to further clarify the address."
                    },
                    "region" : {
                      "type" : "string",
                      "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                    },
                    "district" : {
                      "type" : "string",
                      "description" : "The district or geographical division of a country or region in which this address is located."
                    },
                    "blockName" : {
                      "type" : "string",
                      "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                    },
                    "buildingName" : {
                      "type" : "string",
                      "description" : "The name of a building."
                    },
                    "buildingNumber" : {
                      "type" : "string",
                      "description" : "he number of a building within the street."
                    },
                    "department" : {
                      "type" : "string",
                      "description" : "The department of the addressee."
                    }
                  },
                  "additionalProperties" : false
                },
                "partyTaxScheme" : {
                  "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                  "properties" : {
                    "company" : {
                      "type" : "object",
                      "description" : "Information about the company taxes.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "External global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                        }
                      },
                      "additionalProperties" : false
                    },
                    "taxScheme" : {
                      "type" : "object",
                      "description" : "The taxation scheme applicable to the party.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "An identifier for this taxation scheme."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "The identification of the identification scheme."
                        }
                      },
                      "additionalProperties" : false
                    }
                  },
                  "additionalProperties" : false
                },
                "partyLegalEntities" : {
                  "type" : "array",
                  "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                  "items" : {
                    "type" : "object",
                    "description" : "An object holding a party legal entity.",
                    "properties" : {
                      "registrationName" : {
                        "type" : "string",
                        "description" : "Registration name of the legal entity."
                      },
                      "companyIdentifier" : {
                        "description" : "Global legal party identifier, including name scheme",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the value."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the id."
                          }
                        },
                        "required" : [ "id" ],
                        "additionalProperties" : false
                      }
                    },
                    "additionalProperties" : false
                  }
                },
                "contact" : {
                  "description" : "An object containing information about contacts. Used for defining the company contact data.",
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "A contact name of the party."
                    },
                    "telephone" : {
                      "type" : "string",
                      "description" : "A telephone number of the contact of the party."
                    },
                    "telefax" : {
                      "type" : "string",
                      "description" : "A fax number of the contact of the party."
                    },
                    "electronicMail" : {
                      "type" : "string",
                      "description" : "An email of the contact of the party."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "required" : [ "partyName" ],
              "additionalProperties" : false
            }
          },
          "required" : [ "party" ]
        },
        "copyIndicator" : {
          "type" : "boolean",
          "description" : "Indicates whether the referenced business document is a copy (true) or the original (false)."
        },
        "acceptedIndicator" : {
          "type" : "boolean",
          "description" : "Indicates whether the order is accepted (true) or rejected (false). This field applies only to OrderResponse business document."
        },
        "issueDate" : {
          "type" : "string",
          "description" : "The date when the business document was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
          "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
        },
        "issueTime" : {
          "type" : "string",
          "description" : "Time when the business document was issued. Valid values must be in format: hh-mm-ss.sss. If the timezone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If timezone is not known, it must be left empty.",
          "pattern" : "([01][0-9]|2[0-4]):([0-5][0-9]):([0-5][0-9])(?:.([0-9]{1,7}))?(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
        },
        "orderDocumentReference" : {
          "description" : "OrderDocumentReference details.",
          "items" : {
            "type" : "object",
            "description" : " A reference to another Order.",
            "properties" : {
              "id" : {
                "type" : "string",
                "description" : " An identifier for the referenced document."
              }
            },
            "required" : [ "id" ],
            "additionalProperties" : false
          }
        },
        "additionalDocumentReference" : {
          "description" : "A reference to an additional document associated with this document.",
          "items" : {
            "type" : "object",
            "description" : " A reference to an additional document associated.",
            "properties" : {
              "id" : {
                "type" : "string",
                "description" : "An identifier for the referenced document."
              },
              "documentDescription" : {
                "description" : "An array Text describing the referenced document.",
                "items" : {
                  "type" : "object",
                  "additionalProperties" : false,
                  "properties" : {
                    "description" : {
                      "type" : "string",
                      "description" : "Description of the business document line item."
                    }
                  },
                  "required" : [ "description" ]
                }
              }
            },
            "required" : [ "id" ],
            "additionalProperties" : false
          }
        },
        "contractDocumentReferences" : {
          "description" : "External system identifier objects for the contract referenced by the business document.",
          "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
              "id" : {
                "type" : "string",
                "description" : "External system identifier of the contract referenced by the Business Document (i.e. buyers contract number). Mandatory field if the customer demands that the goods or services invoiced refer to a contract number defined by the customer to which he wants to assign the Business Document. Is demanded for example in service and maintenance agreements for which there is generally no explicit order."
              },
              "schemeId" : {
                "type" : "string",
                "description" : "External system specific identifier of the contract system identifier element. If the source business document has any matching element, it should be used."
              }
            },
            "required" : [ "id" ]
          }
        },
        "customerReference" : {
          "type" : "string",
          "description" : "Identifiers the customer related to the business document."
        },
        "orderTypeCode" : {
          "description" : "Specifies the order type.",
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "Identifies order type. See API documentation for more details about values."
            },
            "name" : {
              "type" : "string",
              "description" : "Name of the order type. See API documentation for more details about the values."
            }
          },
          "required" : [ "id" ]
        },
        "delivery" : {
          "description" : "Delivery details.",
          "additionalProperties" : false,
          "properties" : {
            "promisedDeliveryPeriod" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "Promised delivery period",
              "properties" : {
                "startDate" : {
                  "description" : "Earliest date when the goods/services are promised to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                  "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                },
                "startTime" : {
                  "type" : "string",
                  "description" : "The time at which this time period begins."
                },
                "endDate" : {
                  "description" : "Latest date when the goods/services are promised to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                  "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                },
                "endTime" : {
                  "type" : "string",
                  "description" : "The time at which this time period ends."
                }
              }
            },
            "requestedDeliveryPeriod" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "Requested delivery period",
              "properties" : {
                "startDate" : {
                  "description" : "Earliest date when the goods/services are requested to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                  "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                },
                "startTime" : {
                  "type" : "string",
                  "description" : "The time at which this time period begins."
                },
                "endDate" : {
                  "description" : "Latest date when the goods/services are requested to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                  "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                },
                "endTime" : {
                  "type" : "string",
                  "description" : "The time at which this time period ends."
                }
              }
            },
            "deliveryParty" : {
              "description" : "Party that is responsible for the delivery of the goods/services in the referred business document.",
              "properties" : {
                "endpoint" : {
                  "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                  "additionalProperties" : false,
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                    }
                  },
                  "required" : [ "id" ]
                },
                "partyIdentifications" : {
                  "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                  "items" : {
                    "type" : "object",
                    "description" : "An object holding a party identification.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An object holding the system identifier of the party."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Global identifier of namescheme for party identifier."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "partyName" : {
                  "type" : "string",
                  "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                },
                "postalAddress" : {
                  "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                  "properties" : {
                    "cityName" : {
                      "type" : "string",
                      "description" : "The name of the city, town or village in the postal address of the party."
                    },
                    "postalZone" : {
                      "type" : "string",
                      "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                    },
                    "addressLine" : {
                      "type" : "string",
                      "description" : "The address line of the postal address of the party."
                    },
                    "addressLine2" : {
                      "type" : "string",
                      "description" : "The second address line of the postal address of the party."
                    },
                    "addressLine3" : {
                      "type" : "string",
                      "description" : "The third address line of the postal address of the party."
                    },
                    "locality" : {
                      "type" : "string",
                      "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                    },
                    "countrySubentity" : {
                      "type" : "string",
                      "description" : "The sub-entity of the area in the postal address."
                    },
                    "countryId" : {
                      "type" : "string",
                      "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                    },
                    "postBox" : {
                      "type" : "string",
                      "description" : "A post office box number registered for postal delivery by a postal service provider."
                    },
                    "streetName" : {
                      "type" : "string",
                      "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                    },
                    "additionalStreetName" : {
                      "type" : "string",
                      "description" : "An additional street name used to further clarify the address."
                    },
                    "region" : {
                      "type" : "string",
                      "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                    },
                    "district" : {
                      "type" : "string",
                      "description" : "The district or geographical division of a country or region in which this address is located."
                    },
                    "blockName" : {
                      "type" : "string",
                      "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                    },
                    "buildingName" : {
                      "type" : "string",
                      "description" : "The name of a building."
                    },
                    "buildingNumber" : {
                      "type" : "string",
                      "description" : "he number of a building within the street."
                    },
                    "department" : {
                      "type" : "string",
                      "description" : "The department of the addressee."
                    }
                  },
                  "additionalProperties" : false
                },
                "partyTaxScheme" : {
                  "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                  "properties" : {
                    "company" : {
                      "type" : "object",
                      "description" : "Information about the company taxes.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                        }
                      },
                      "additionalProperties" : false
                    }
                  },
                  "additionalProperties" : false
                },
                "partyLegalEntities" : {
                  "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                  "items" : {
                    "type" : "object",
                    "description" : "An object holding a party legal entity.",
                    "properties" : {
                      "registrationName" : {
                        "type" : "string",
                        "description" : "Registration name of the legal entity."
                      },
                      "companyIdentifier" : {
                        "description" : "Global legal party identifier, including name scheme",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the value."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the id."
                          }
                        },
                        "required" : [ "id" ],
                        "additionalProperties" : false
                      }
                    },
                    "required" : [ "registrationName", "companyIdentifier" ],
                    "additionalProperties" : false
                  }
                },
                "contact" : {
                  "description" : "An object containing information about contacts. Used for defining the company contact data.",
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "A contact name of the party."
                    },
                    "telephone" : {
                      "type" : "string",
                      "description" : "A telephone number of the contact of the party."
                    },
                    "telefax" : {
                      "type" : "string",
                      "description" : "A fax number of the contact of the party."
                    },
                    "electronicMail" : {
                      "type" : "string",
                      "description" : "An email of the contact of the party."
                    }
                  },
                  "additionalProperties" : false
                },
                "supplierAssignedAccountId" : {
                  "type" : "string",
                  "description" : "Account identifier assigned by the supplier."
                },
                "customerAssignedAccountId" : {
                  "type" : "string",
                  "description" : "Account identifier assigned by the customer."
                },
                "note" : {
                  "type" : "string",
                  "description" : "Free-form description of the party not included in other fields"
                }
              },
              "required" : [ "partyName" ],
              "additionalProperties" : false
            },
            "deliveryAddress" : {
              "description" : "An object containing address information. Used for defining delivery address party data.",
              "properties" : {
                "cityName" : {
                  "type" : "string",
                  "description" : "The name of the city, town or village in the postal address of the party."
                },
                "postalZone" : {
                  "type" : "string",
                  "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                },
                "addressLine" : {
                  "type" : "string",
                  "description" : "The address line of the postal address of the party."
                },
                "addressLine2" : {
                  "type" : "string",
                  "description" : "The second address line of the postal address of the party."
                },
                "addressLine3" : {
                  "type" : "string",
                  "description" : "The third address line of the postal address of the party."
                },
                "locality" : {
                  "type" : "string",
                  "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                },
                "countrySubentity" : {
                  "type" : "string",
                  "description" : "The sub-entity of the area in the postal address."
                },
                "countryId" : {
                  "type" : "string",
                  "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                },
                "postBox" : {
                  "type" : "string",
                  "description" : "A post office box number registered for postal delivery by a postal service provider."
                },
                "streetName" : {
                  "type" : "string",
                  "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                },
                "additionalStreetName" : {
                  "type" : "string",
                  "description" : "An additional street name used to further clarify the address."
                },
                "region" : {
                  "type" : "string",
                  "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                },
                "district" : {
                  "type" : "string",
                  "description" : "The district or geographical division of a country or region in which this address is located."
                },
                "blockName" : {
                  "type" : "string",
                  "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                },
                "buildingName" : {
                  "type" : "string",
                  "description" : "The name of a building."
                },
                "buildingNumber" : {
                  "type" : "string",
                  "description" : "he number of a building within the street."
                },
                "department" : {
                  "type" : "string",
                  "description" : "The department of the addressee."
                }
              },
              "additionalProperties" : false
            },
            "deliveryLocation" : {
              "additionalProperties" : false,
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "An identifier for this location."
                },
                "descriptions" : {
                  "description" : "An array holding the descriptions of the Text describing this location.",
                  "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                      "description" : {
                        "type" : "string",
                        "description" : "Description of the business document line item."
                      }
                    },
                    "required" : [ "description" ]
                  }
                }
              }
            }
          }
        },
        "deliveryTerms" : {
          "description" : "Delivery terms.",
          "additionalProperties" : false,
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "If possible, specify 'INCOTERMS'. Otherwise, specify the terms in clear text in the field 'specialTerms'."
            },
            "specialTerms" : {
              "type" : "string",
              "description" : "A description of special conditions relating to the Delivery Terms."
            },
            "allowanceCharge" : {
              "additionalProperties" : false,
              "properties" : {
                "chargeIndicator" : {
                  "type" : "boolean",
                  "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
                },
                "allowanceChargeReasonCode" : {
                  "type" : "string",
                  "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code."
                },
                "allowanceChargeReason" : {
                  "type" : "string",
                  "description" : "The reason for this allowance or charge."
                },
                "multiplierFactorNumeric" : {
                  "type" : "number",
                  "description" : "The factor applied to the base amount to calculate the allowance charge."
                },
                "amount" : {
                  "type" : "number",
                  "description" : "The allowance charge amount."
                },
                "taxCategories" : {
                  "type" : "array",
                  "description" : "Identifier of tax category.",
                  "items" : {
                    "type" : "object",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Tax category identifier."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Namespace of the tax category identifier."
                      },
                      "name" : {
                        "type" : "string",
                        "description" : "Tax category description."
                      },
                      "percent" : {
                        "type" : "number",
                        "description" : "Tax rate for this category, expressed as a percentage"
                      },
                      "taxExemptionReasonCode" : {
                        "type" : "string",
                        "description" : "Reason for tax being exempted, expressed as a code."
                      },
                      "taxExemptionReason" : {
                        "type" : "string",
                        "description" : "Reason for tax being exempted, expressed as text."
                      }
                    },
                    "required" : [ "id" ]
                  }
                }
              },
              "required" : [ "chargeIndicator", "amount" ]
            },
            "deliveryLocation" : {
              "additionalProperties" : false,
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "An identifier for this location."
                },
                "descriptions" : {
                  "description" : "An array holding the descriptions of the Text describing this location.",
                  "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                      "description" : {
                        "type" : "string",
                        "description" : "Description of the business document line item."
                      }
                    },
                    "required" : [ "description" ]
                  }
                }
              }
            }
          }
        },
        "paymentTerms" : {
          "description" : "Payment terms.",
          "additionalProperties" : false,
          "properties" : {
            "settlementPeriod" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An object holding the settlement period dates.",
              "properties" : {
                "startDate" : {
                  "type" : "string",
                  "description" : "Date when the payment terms starts. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                  "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                },
                "endDate" : {
                  "type" : "string",
                  "description" : "Date when the payment terms ends. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                  "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                }
              }
            },
            "note" : {
              "type" : "string",
              "description" : "Free-form text applying to the payment terms. This field may contain notes or any other similar information that is not contained explicitly in another structure."
            },
            "penaltySurchargePercent" : {
              "type" : "number",
              "description" : "Penalty surcharge percent amount."
            }
          }
        },
        "paymentMeans" : {
          "description" : "Expected means of payment.",
          "additionalProperties" : false,
          "properties" : {
            "paymentMeansCode" : {
              "type" : "string",
              "description" : "A code that identifies how the payment can be done. Valid values: UN/ECE 4461 code represented as string."
            },
            "paymentDueDate" : {
              "type" : "string",
              "description" : "Date when the business document is due for the payment means. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
              "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
            },
            "paymentReferenceMessage" : {
              "type" : "string",
              "description" : "A payment reference message. This can be a free text describing the payment."
            },
            "paymentIdentifier" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An identifier for a payment made using this means of payment.",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Payment identifier."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "Scheme which identifies the type of payment identifier. Possible values are SPY, ISO."
                }
              },
              "required" : [ "id" ]
            },
            "payerFinancialAccounts" : {
              "description" : "An array of payer financial accounts",
              "items" : {
                "type" : "object",
                "additionalProperties" : false,
                "description" : "Object holding the financial account details",
                "properties" : {
                  "financialInstitutionName" : {
                    "type" : "string",
                    "description" : "The name of financial institution."
                  },
                  "financialInstitutionId" : {
                    "type" : "string",
                    "description" : "Identifier of financial institution."
                  },
                  "financialInstitutionIdSchemeId" : {
                    "type" : "string",
                    "description" : "The namespace of the financial institution id identifier element."
                  },
                  "financialInstitutionBranchId" : {
                    "type" : "string",
                    "description" : "The identifier of financial institution branch, for example 342-085. This field is typically used by institutions in Australia and New Zealand."
                  },
                  "financialInstitutionBranchSchemeId" : {
                    "type" : "string",
                    "description" : "The namespace of financial institution branch. For example for an Australian institutions, possible scheme is BSB."
                  },
                  "financialAccountIdentifiers" : {
                    "type" : "array",
                    "description" : "Array holding financial account identifiers",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "Financial account identifier",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "Financial account identifier."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "Identifies the financial account identifier type, for example 'IBAN'."
                        }
                      },
                      "required" : [ "id" ]
                    }
                  }
                }
              }
            },
            "payeeFinancialAccounts" : {
              "description" : "An array of payee financial accounts",
              "items" : {
                "type" : "object",
                "additionalProperties" : false,
                "description" : "Object holding the financial account details",
                "properties" : {
                  "financialInstitutionName" : {
                    "type" : "string",
                    "description" : "The name of financial institution."
                  },
                  "financialInstitutionId" : {
                    "type" : "string",
                    "description" : "Identifier of financial institution."
                  },
                  "financialInstitutionIdSchemeId" : {
                    "type" : "string",
                    "description" : "The namespace of the financial institution id identifier element."
                  },
                  "financialInstitutionBranchId" : {
                    "type" : "string",
                    "description" : "The identifier of financial institution branch, for example 342-085. This field is typically used by institutions in Australia and New Zealand."
                  },
                  "financialInstitutionBranchSchemeId" : {
                    "type" : "string",
                    "description" : "The namespace of financial institution branch. For example for an Australian institutions, possible scheme is BSB."
                  },
                  "financialAccountIdentifiers" : {
                    "type" : "array",
                    "description" : "Array holding financial account identifiers",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "Financial account identifier",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "Financial account identifier."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "Identifies the financial account identifier type, for example 'IBAN'."
                        }
                      },
                      "required" : [ "id" ]
                    }
                  }
                }
              }
            }
          },
          "required" : [ "paymentMeansCode" ]
        },
        "allowanceCharges" : {
          "additionalProperties" : false,
          "items" : {
            "type" : "object",
            "properties" : {
              "chargeIndicator" : {
                "type" : "boolean",
                "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
              },
              "allowanceChargeReasonCode" : {
                "type" : "string",
                "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code"
              },
              "allowanceChargeReason" : {
                "type" : "string",
                "description" : "The reason for this allowance or charge."
              },
              "multiplierFactorNumeric" : {
                "type" : "number",
                "description" : "The factor applied to the base amount to calculate the allowance charge."
              },
              "baseAmount" : {
                "type" : "number",
                "description" : "The monetary amount to which the multiplier factor is applied in calculating the amount of this allowance or charge."
              },
              "amount" : {
                "type" : "number",
                "description" : "The allowance charge amount."
              },
              "taxCategories" : {
                "type" : "array",
                "description" : "External identifier of tax category.",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "Identifies the tax category identifier."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "Identifies the namespace of the tax category identifier."
                    },
                    "name" : {
                      "type" : "string",
                      "description" : "Tax category description."
                    },
                    "percent" : {
                      "type" : "number",
                      "description" : "Identifies the tax rate for this category, expressed as a percentage"
                    },
                    "taxExemptionReasonCode" : {
                      "type" : "string",
                      "description" : "Identifies the reason for tax being exempted, expressed as a code."
                    },
                    "taxExemptionReason" : {
                      "type" : "string",
                      "description" : "Identifies the reason for tax being exempted, expressed as text."
                    }
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              },
              "paymentMeans" : {
                "type" : "object",
                "additionalProperties" : false,
                "description" : "An object holding the available payment means.",
                "properties" : {
                  "paymentDueDate" : {
                    "type" : "string",
                    "description" : "Date when the business document is due for the payment means. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                  }
                }
              }
            }
          },
          "required" : [ "chargeIndicator", "amount" ]
        },
        "taxTotal" : {
          "description" : "Tax total details.",
          "additionalProperties" : false,
          "properties" : {
            "currencyId" : {
              "type" : "string",
              "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
            },
            "amount" : {
              "type" : "number",
              "description" : "Total amount of the taxes. The total tax amount for particular tax scheme e.g. VAT; the sum of each of the tax subtotals for each tax category within the tax scheme."
            },
            "roundingAmount" : {
              "type" : "number",
              "description" : "Rounding amount added to the calculated tax total to produce the rounded TotalTaxAmount."
            },
            "taxSubtotals" : {
              "items" : {
                "type" : "object",
                "additionalProperties" : false,
                "description" : "An object holding the information about tax.",
                "properties" : {
                  "currencyId" : {
                    "type" : "string",
                    "description" : "A code that identifies the currency of the tax subtotal. Valid values: ISO 4217 code represented as string."
                  },
                  "amount" : {
                    "type" : "number",
                    "description" : "Total amount of the taxes."
                  },
                  "percent" : {
                    "type" : "number",
                    "description" : "The tax rate for the category, expressed as a percentage."
                  },
                  "taxableAmount" : {
                    "type" : "number",
                    "description" : "Basis of the taxes. The net amount to which the tax percent (rate) is applied to calculate the tax amount."
                  },
                  "taxCategory" : {
                    "type" : "object",
                    "description" : "External identifier of tax category.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the tax category identifier."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the tax category identifier."
                      },
                      "name" : {
                        "type" : "string",
                        "description" : "Tax category description."
                      },
                      "taxExemptionReason" : {
                        "type" : "string",
                        "description" : "The reason for tax being exempted."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "currencyId", "amount" ]
              }
            }
          },
          "required" : [ "currencyId", "amount" ]
        },
        "anticipatedMonetaryTotal" : {
          "description" : "Anticipated monetary details for total amount payable in the business document.",
          "additionalProperties" : false,
          "properties" : {
            "lineExtensionAmount" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "Total amount of line extension.",
              "properties" : {
                "currencyId" : {
                  "type" : "string",
                  "description" : "Currency code of the total line extension amount. Valid values: ISO 4217 code represented as string, for example EUR."
                },
                "amount" : {
                  "type" : "number",
                  "description" : "Total amount of line extensions."
                }
              },
              "required" : [ "currencyId", "amount" ]
            },
            "payableAmount" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "An object holding total payable amount of line extensions.",
              "properties" : {
                "currencyId" : {
                  "type" : "string",
                  "description" : "Currency code of the total payable amount. Valid values: ISO 4217 code represented as string, for example EUR."
                },
                "amount" : {
                  "type" : "number",
                  "description" : "The total amount to be paid."
                }
              },
              "required" : [ "currencyId", "amount" ]
            },
            "taxExclusiveAmount" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "The monetary amount of an extended transaction line, exclusive of taxes.",
              "properties" : {
                "currencyId" : {
                  "type" : "string",
                  "description" : "Currency code of the tax exclusive amount. Valid values: ISO 4217 code represented as string, for example EUR."
                },
                "amount" : {
                  "type" : "number",
                  "description" : "The total of tax exclusive amount."
                }
              },
              "required" : [ "amount" ]
            },
            "taxInclusiveAmount" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "The monetary amount including taxes; the sum of payable amount and prepaid amount.",
              "properties" : {
                "currencyId" : {
                  "type" : "string",
                  "description" : "Currency code of the tax inclusive amount. Valid values: ISO 4217 code represented as string, for example EUR."
                },
                "amount" : {
                  "type" : "number",
                  "description" : "The total of tax inclusive amount."
                }
              },
              "required" : [ "amount" ]
            },
            "allowanceTotalAmount" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "The total monetary amount of all allowances.",
              "properties" : {
                "currencyId" : {
                  "type" : "string",
                  "description" : "Currency code of the allowance total amount. Valid values: ISO 4217 code represented as string, for example EUR."
                },
                "amount" : {
                  "type" : "number",
                  "description" : "The allowance total amount to be paid."
                }
              },
              "required" : [ "amount" ]
            },
            "chargeTotalAmount" : {
              "type" : "object",
              "additionalProperties" : false,
              "description" : "The total monetary amount of all allowances.",
              "properties" : {
                "currencyId" : {
                  "type" : "string",
                  "description" : "Currency code of the charge total amount. Valid values: ISO 4217 code represented as string, for example EUR."
                },
                "amount" : {
                  "type" : "number",
                  "description" : "The charge total amount to be paid."
                }
              },
              "required" : [ "amount" ]
            }
          },
          "required" : [ "payableAmount" ]
        },
        "documentLines" : {
          "type" : "array",
          "description" : "An array holding the document lines.",
          "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "description" : "A business document line",
            "properties" : {
              "id" : {
                "description" : "Identifier for the document line.",
                "type" : "string"
              },
              "note" : {
                "type" : "string",
                "description" : "Free-form text conveying information that is not contained explicitly in other structures."
              },
              "lineStatusCode" : {
                "type" : "string",
                "description" : "A code signifying the status of this line item with respect to its original state."
              },
              "documentReference" : {
                "description" : "A reference to an additional document associated with this document.",
                "items" : {
                  "type" : "object",
                  "description" : " A reference to a document associated with this order line.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "An identifier for the referenced document."
                    },
                    "documentDescription" : {
                      "description" : "An array Text describing the referenced document.",
                      "items" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                          "description" : {
                            "type" : "string",
                            "description" : "Description of the business document line item."
                          }
                        },
                        "required" : [ "description" ]
                      }
                    }
                  },
                  "required" : [ "id" ],
                  "additionalProperties" : false
                }
              },
              "item" : {
                "description" : "Order item details",
                "additionalProperties" : false,
                "properties" : {
                  "descriptions" : {
                    "description" : "An array holding the descriptions of the Business Document line items.",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "properties" : {
                        "description" : {
                          "type" : "string",
                          "description" : "Description of the business document line item."
                        }
                      },
                      "required" : [ "description" ]
                    }
                  },
                  "name" : {
                    "type" : "string",
                    "description" : "Name of the Business Document line item.  A short name optionally given to an item, such as a name from a catalogue which is distinct from a description."
                  },
                  "taxPercent" : {
                    "type" : "number",
                    "description" : "Tax amount for the item"
                  },
                  "taxCategory" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Identifying information for this item, assigned by the buyer.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An identifier for the item."
                      }
                    }
                  },
                  "buyersItemIdentification" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Identifying information for this item, assigned by the buyer.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An identifier for the item."
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "sellersItem" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "An object holding a identification of the Business Documents line item as it is in sellers system.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifier of the Business Document line item as it is in sellers system."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Namespace for system specific identifier of the sellers item identifier element. If the source business document has any matching element, it should be used."
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "standardItemIdentification" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Identifying information for this item, assigned according to a standard system.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An identifier for the item."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "The identification of the identification scheme"
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "commodityClassification" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "A classification of this item according to a specific system for classifying commodities.",
                    "properties" : {
                      "itemClassificationCode" : {
                        "type" : "string",
                        "description" : "A code signifying the trade classification of the commodity."
                      },
                      "listId" : {
                        "type" : "string",
                        "description" : "The identification of a list of codes."
                      }
                    }
                  },
                  "additionalItemProperties" : {
                    "description" : "Additional item properties for the order line item",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "properties" : {
                        "name" : {
                          "type" : "string",
                          "description" : "External system identifier of the contract referenced by the Business Document (i.e. buyers contract number). Mandatory field if the customer demands that the goods or services invoiced refer to a contract number defined by the customer to which he wants to assign the Business Document. Is demanded for example in service and maintenance agreements for which there is generally no explicit order."
                        },
                        "value" : {
                          "type" : "string",
                          "description" : "External system specific identifier of the contract system identifier element. If the source business document has any matching element, it should be used."
                        }
                      },
                      "required" : [ "name", "value" ]
                    }
                  },
                  "classifiedTaxCategory" : {
                    "type" : "array",
                    "description" : "A tax category applicable to this item.",
                    "items" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : " An identifier for the referenced document."
                        },
                        "percent" : {
                          "type" : "number",
                          "description" : "Tax rate for this category, expressed as a percentage"
                        },
                        "taxScheme" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "An identifier for this taxation scheme.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An identifier for this taxation scheme."
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "required" : [ "name" ]
              },
              "quantity" : {
                "description" : "Quantity of the target Business Document line item.",
                "additionalProperties" : false,
                "properties" : {
                  "amount" : {
                    "type" : "number",
                    "description" : "The quantity of the target Business Document line items."
                  },
                  "unitCode" : {
                    "type" : "string",
                    "description" : "The unit code of the quantity of the target Business Document line item. Valid values: UN/ECE CEFACT Trade Facilitation Recommendation No.20 common code value represented as string."
                  }
                }
              },
              "maximumBackOrderQuantity" : {
                "description" : "The maximum back order quantity of the item associated with this line.",
                "additionalProperties" : false,
                "properties" : {
                  "amount" : {
                    "type" : "number",
                    "description" : "The back order quantity of the item associated with this line."
                  },
                  "unitCode" : {
                    "type" : "string",
                    "description" : "The unit code of the maximumBackOrderQuantity of the target Business Document line item."
                  }
                }
              },
              "delivery" : {
                "description" : "Delivery details",
                "additionalProperties" : false,
                "properties" : {
                  "promisedDeliveryPeriod" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Promised delivery period",
                    "properties" : {
                      "startDate" : {
                        "description" : "Earliest date when the goods/services are promised to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "startTime" : {
                        "type" : "string",
                        "description" : "The time at which this time period begins."
                      },
                      "endDate" : {
                        "description" : "Latest date when the goods/services are promised to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "endTime" : {
                        "type" : "string",
                        "description" : "The time at which this time period ends."
                      }
                    }
                  },
                  "requestedDeliveryPeriod" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Requested delivery period",
                    "properties" : {
                      "startDate" : {
                        "description" : "Earliest date when the goods/services are requested to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty. ",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "startTime" : {
                        "type" : "string",
                        "description" : "The time at which this time period begins."
                      },
                      "endDate" : {
                        "description" : "Latest date when the goods/services are requested to be delivered. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                        "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                      },
                      "endTime" : {
                        "type" : "string",
                        "description" : "The time at which this time period ends."
                      }
                    }
                  },
                  "deliveryParty" : {
                    "description" : "Party that is responsible for the delivery of the goods/services in the referred business document.",
                    "properties" : {
                      "endpoint" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "additionalProperties" : false,
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Global identifier of namescheme for party identifier."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          },
                          "postBox" : {
                            "type" : "string",
                            "description" : "A post office box number registered for postal delivery by a postal service provider."
                          },
                          "streetName" : {
                            "type" : "string",
                            "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                          },
                          "additionalStreetName" : {
                            "type" : "string",
                            "description" : "An additional street name used to further clarify the address."
                          },
                          "region" : {
                            "type" : "string",
                            "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                          },
                          "district" : {
                            "type" : "string",
                            "description" : "The district or geographical division of a country or region in which this address is located."
                          },
                          "blockName" : {
                            "type" : "string",
                            "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                          },
                          "buildingName" : {
                            "type" : "string",
                            "description" : "The name of a building."
                          },
                          "buildingNumber" : {
                            "type" : "string",
                            "description" : "he number of a building within the street."
                          },
                          "department" : {
                            "type" : "string",
                            "description" : "The department of the addressee."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyLegalEntities" : {
                        "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party legal entity.",
                          "properties" : {
                            "registrationName" : {
                              "type" : "string",
                              "description" : "Registration name of the legal entity."
                            },
                            "companyIdentifier" : {
                              "description" : "Global legal party identifier, including name scheme",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the value."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the id."
                                }
                              },
                              "required" : [ "id" ],
                              "additionalProperties" : false
                            }
                          },
                          "required" : [ "registrationName", "companyIdentifier" ],
                          "additionalProperties" : false
                        }
                      },
                      "contact" : {
                        "description" : "An object containing information about contacts. Used for defining the company contact data.",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "supplierAssignedAccountId" : {
                        "type" : "string",
                        "description" : "Account identifier assigned by the supplier."
                      },
                      "customerAssignedAccountId" : {
                        "type" : "string",
                        "description" : "Account identifier assigned by the customer."
                      },
                      "note" : {
                        "type" : "string",
                        "description" : "Free-form description of the party not included in other fields"
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                  },
                  "deliveryAddress" : {
                    "description" : "An object containing address information. Used for defining delivery address party data.",
                    "properties" : {
                      "cityName" : {
                        "type" : "string",
                        "description" : "The name of the city, town or village in the postal address of the party."
                      },
                      "postalZone" : {
                        "type" : "string",
                        "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                      },
                      "addressLine" : {
                        "type" : "string",
                        "description" : "The address line of the postal address of the party."
                      },
                      "addressLine2" : {
                        "type" : "string",
                        "description" : "The second address line of the postal address of the party."
                      },
                      "addressLine3" : {
                        "type" : "string",
                        "description" : "The third address line of the postal address of the party."
                      },
                      "locality" : {
                        "type" : "string",
                        "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                      },
                      "countrySubentity" : {
                        "type" : "string",
                        "description" : "The sub-entity of the area in the postal address."
                      },
                      "countryId" : {
                        "type" : "string",
                        "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                      },
                      "postBox" : {
                        "type" : "string",
                        "description" : "A post office box number registered for postal delivery by a postal service provider."
                      },
                      "streetName" : {
                        "type" : "string",
                        "description" : "The name of the street, road, avenue, way, etc. to which the number of the building is attached."
                      },
                      "additionalStreetName" : {
                        "type" : "string",
                        "description" : "An additional street name used to further clarify the address."
                      },
                      "region" : {
                        "type" : "string",
                        "description" : "The recognized geographic or economic region or group of countries in which this address is located."
                      },
                      "district" : {
                        "type" : "string",
                        "description" : "The district or geographical division of a country or region in which this address is located."
                      },
                      "blockName" : {
                        "type" : "string",
                        "description" : "The name of the block (an area surrounded by streets and usually containing several buildings) in which this address is located."
                      },
                      "buildingName" : {
                        "type" : "string",
                        "description" : "The name of a building."
                      },
                      "buildingNumber" : {
                        "type" : "string",
                        "description" : "he number of a building within the street."
                      },
                      "department" : {
                        "type" : "string",
                        "description" : "The department of the addressee."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "deliveryLocation" : {
                    "additionalProperties" : false,
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "An identifier for this location."
                      },
                      "descriptions" : {
                        "description" : "An array holding the descriptions of the Text describing this location.",
                        "items" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "properties" : {
                            "description" : {
                              "type" : "string",
                              "description" : "Description of the business document line item."
                            }
                          },
                          "required" : [ "description" ]
                        }
                      }
                    }
                  }
                }
              },
              "taxTotals" : {
                "description" : "An array holding the tax totals.",
                "items" : {
                  "type" : "object",
                  "additionalProperties" : false,
                  "description" : "An object holding the information about tax.",
                  "properties" : {
                    "amount" : {
                      "type" : "number",
                      "description" : "Total amount of the taxes. The total tax amount for particular tax scheme e.g. VAT; the sum of each of the tax subtotals for each tax category within the tax scheme."
                    },
                    "currencyId" : {
                      "type" : "string",
                      "description" : "A code that identifies the currency of the total payable amount. Valid values: ISO 4217 code represented as string."
                    },
                    "transactionCurrencyTax" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "An object holding transaction tax.",
                      "properties" : {
                        "amount" : {
                          "type" : "number",
                          "description" : "Amount of tax for the transaction."
                        }
                      },
                      "required" : [ "amount" ]
                    },
                    "taxSubtotals" : {
                      "items" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "An object holding the information about tax.",
                        "properties" : {
                          "currencyId" : {
                            "type" : "string",
                            "description" : "A code that identifies the currency of the tax subtotal. Valid values: ISO 4217 code represented as string."
                          },
                          "amount" : {
                            "type" : "number",
                            "description" : "Total amount of the taxes."
                          },
                          "percent" : {
                            "type" : "number",
                            "description" : "The tax rate for the category, expressed as a percentage."
                          },
                          "taxableAmount" : {
                            "type" : "number",
                            "description" : "Basis of the taxes. The net amount to which the tax percent (rate) is applied to calculate the tax amount."
                          },
                          "taxCategory" : {
                            "type" : "object",
                            "description" : "External identifier of tax category.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "Identifies the tax category identifier."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "Identifies the namespace of the tax category identifier."
                              },
                              "name" : {
                                "type" : "string",
                                "description" : "Tax category description."
                              },
                              "taxExemptionReason" : {
                                "type" : "string",
                                "description" : "The reason for tax being exempted."
                              }
                            },
                            "required" : [ "id" ],
                            "additionalProperties" : false
                          }
                        },
                        "required" : [ "currencyId", "amount" ]
                      }
                    }
                  },
                  "required" : [ "amount", "currencyId" ]
                }
              },
              "price" : {
                "description" : "Price for the line item",
                "additionalProperties" : false,
                "properties" : {
                  "amount" : {
                    "type" : "number",
                    "description" : "The price of the line item."
                  },
                  "currencyId" : {
                    "type" : "string",
                    "description" : "A code that identifies the currency of the line item price. Valid values: ISO 4217 code represented as string."
                  },
                  "baseQuantity" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "The quantity at which this price applies.",
                    "properties" : {
                      "amount" : {
                        "type" : "number",
                        "description" : "The amount at which this price applies."
                      },
                      "unitCode" : {
                        "type" : "string",
                        "description" : "The unit of the quantity."
                      }
                    }
                  }
                },
                "required" : [ "amount", "currencyId" ]
              },
              "allowanceCharges" : {
                "description" : "Extra payment or subtraction to Business Document, for example freight or handling fees.",
                "additionalProperties" : false,
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "chargeIndicator" : {
                      "type" : "boolean",
                      "description" : "Indicates whether the allowance charge is a charge (true) or a discount (false)."
                    },
                    "allowanceChargeReasonCode" : {
                      "type" : "string",
                      "description" : "A mutually agreed code signifying the reason for this allowance or charge. Valid values are defined in UN/ECE CEFACT Trade Facilitation Recommendation 4465 Adjustment reason description code"
                    },
                    "allowanceChargeReason" : {
                      "type" : "string",
                      "description" : "The reason for this allowance or charge."
                    },
                    "multiplierFactorNumeric" : {
                      "type" : "number",
                      "description" : "The factor applied to the base amount to calculate the allowance charge."
                    },
                    "baseAmount" : {
                      "type" : "number",
                      "description" : "The monetary amount to which the multiplier factor is applied in calculating the amount of this allowance or charge."
                    },
                    "amount" : {
                      "type" : "number",
                      "description" : "The allowance charge amount."
                    },
                    "taxCategories" : {
                      "type" : "array",
                      "description" : "External identifier of tax category.",
                      "items" : {
                        "type" : "object",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifies the tax category identifier."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Identifies the namespace of the tax category identifier."
                          },
                          "name" : {
                            "type" : "string",
                            "description" : "Tax category description."
                          },
                          "percent" : {
                            "type" : "number",
                            "description" : "Identifies the tax rate for this category, expressed as a percentage"
                          },
                          "taxExemptionReasonCode" : {
                            "type" : "string",
                            "description" : "Identifies the reason for tax being exempted, expressed as a code."
                          },
                          "taxExemptionReason" : {
                            "type" : "string",
                            "description" : "Identifies the reason for tax being exempted, expressed as text."
                          }
                        }
                      },
                      "required" : [ "id" ],
                      "additionalProperties" : false
                    },
                    "paymentMeans" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "An object holding the available payment means.",
                      "properties" : {
                        "paymentDueDate" : {
                          "type" : "string",
                          "description" : "Date when the business document is due for the payment means. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                          "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                        }
                      }
                    }
                  }
                },
                "required" : [ "chargeIndicator", "amount" ]
              },
              "partialDeliveryIndicator" : {
                "type" : "string",
                "description" : "An indicator that a partial delivery is allowed (true) or not (false)."
              },
              "customFields" : {
                "description" : "Custom fields in the business document. Disclaimer! Use of a custom field assumes that the recipient can handle the custom fields. Before using custom field Basware needs to be contacted to assure the delivery of these fields. Additional changes may be incurred due to the use of these fields. There is no guarantee that the recipient can handle the specified custom fields.",
                "items" : {
                  "type" : "object",
                  "description" : "Custom fields in the business document",
                  "additionalProperties" : false,
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "Name of the custom field",
                      "default" : "file"
                    },
                    "value" : {
                      "type" : "string",
                      "description" : "Value of the custom field"
                    },
                    "description" : {
                      "type" : "string",
                      "description" : "The purpose of this field"
                    }
                  },
                  "required" : [ "name", "value" ]
                }
              },
              "lineExtension" : {
                "description" : "The total amount for the line item, including allowance charges but net of taxes.",
                "additionalProperties" : false,
                "properties" : {
                  "currencyId" : {
                    "type" : "string",
                    "description" : "The currency of the amount."
                  },
                  "amount" : {
                    "type" : "number",
                    "description" : "The total amount for the line item, including allowance charges but net of taxes."
                  }
                },
                "required" : [ "amount" ]
              },
              "quotationLineReference" : {
                "description" : "A reference to a quotation line associated with this order line.",
                "additionalProperties" : false,
                "properties" : {
                  "lineId" : {
                    "type" : "string",
                    "description" : "Identifies the referenced line in the document."
                  }
                },
                "required" : [ "lineId" ]
              },
              "orderLineReference" : {
                "description" : "A reference to another order line, such as in a replacement order or another line on the same order that is related.",
                "additionalProperties" : false,
                "properties" : {
                  "lineId" : {
                    "type" : "string",
                    "description" : "Identifies the referenced line in the document."
                  }
                },
                "required" : [ "lineId" ]
              },
              "sellerSubstitutedLineItem" : {
                "description" : "In Order Response, a line item that has replaced the original order line item.",
                "additionalProperties" : false,
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "id" : {
                      "description" : "An identifier for this line item, assigned by the buyer.",
                      "type" : "string"
                    },
                    "item" : {
                      "description" : "Order item details",
                      "additionalProperties" : false,
                      "properties" : {
                        "descriptions" : {
                          "description" : "An array holding the descriptions of the Business Document line items.",
                          "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                              "description" : {
                                "type" : "string",
                                "description" : "Description of the business document line item."
                              }
                            },
                            "required" : [ "description" ]
                          }
                        },
                        "name" : {
                          "type" : "string",
                          "description" : "Name of the Business Document line item.  A short name optionally given to an item, such as a name from a catalogue which is distinct from a description."
                        },
                        "taxPercent" : {
                          "type" : "number",
                          "description" : "Tax amount for the item"
                        },
                        "taxCategory" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "Identifying information for this item, assigned by the buyer.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An identifier for the item."
                            }
                          }
                        },
                        "buyersItemIdentification" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "Identifying information for this item, assigned by the buyer.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An identifier for the item."
                            }
                          },
                          "required" : [ "id" ]
                        },
                        "sellersItem" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "An object holding a identification of the Business Documents line item as it is in sellers system.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifier of the Business Document line item as it is in sellers system."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Namespace for system specific identifier of the sellers item identifier element. If the source business document has any matching element, it should be used."
                            }
                          },
                          "required" : [ "id" ]
                        },
                        "standardItemIdentification" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "Identifying information for this item, assigned according to a standard system.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An identifier for the item."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "The identification of the identification scheme"
                            }
                          },
                          "required" : [ "id" ]
                        },
                        "commodityClassification" : {
                          "type" : "object",
                          "additionalProperties" : false,
                          "description" : "A classification of this item according to a specific system for classifying commodities.",
                          "properties" : {
                            "itemClassificationCode" : {
                              "type" : "string",
                              "description" : "A code signifying the trade classification of the commodity."
                            },
                            "listId" : {
                              "type" : "string",
                              "description" : "The identification of a list of codes."
                            }
                          }
                        },
                        "additionalItemProperties" : {
                          "description" : "Additional item properties for the order line item",
                          "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                              "name" : {
                                "type" : "string",
                                "description" : "External system identifier of the contract referenced by the Business Document (i.e. buyers contract number). Mandatory field if the customer demands that the goods or services invoiced refer to a contract number defined by the customer to which he wants to assign the Business Document. Is demanded for example in service and maintenance agreements for which there is generally no explicit order."
                              },
                              "value" : {
                                "type" : "string",
                                "description" : "External system specific identifier of the contract system identifier element. If the source business document has any matching element, it should be used."
                              }
                            },
                            "required" : [ "name", "value" ]
                          }
                        },
                        "classifiedTaxCategory" : {
                          "type" : "array",
                          "description" : "A tax category applicable to this item.",
                          "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : " An identifier for the referenced document."
                              },
                              "percent" : {
                                "type" : "number",
                                "description" : "Tax rate for this category, expressed as a percentage"
                              },
                              "taxScheme" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "description" : "An identifier for this taxation scheme.",
                                "properties" : {
                                  "id" : {
                                    "type" : "string",
                                    "description" : "An identifier for this taxation scheme."
                                  }
                                }
                              }
                            }
                          }
                        }
                      },
                      "required" : [ "name" ]
                    }
                  }
                },
                "required" : [ "id" ]
              }
            },
            "required" : [ "id", "item" ]
          }
        },
        "customFields" : {
          "description" : "Custom fields in the business document. Disclaimer! Use of a custom field assumes that the recipient can handle the custom fields. Before using custom field Basware needs to be contacted to assure the delivery of these fields. Additional changes may be incurred due to the use of these fields. There is no guarantee that the recipient can handle the specified custom fields.",
          "items" : {
            "type" : "object",
            "description" : "Custom fields in the business document",
            "additionalProperties" : false,
            "properties" : {
              "name" : {
                "type" : "string",
                "description" : "Name of the custom field",
                "default" : "file"
              },
              "value" : {
                "type" : "string",
                "description" : "Value of the custom field"
              },
              "description" : {
                "type" : "string",
                "description" : "The purpose of this field"
              }
            },
            "required" : [ "name", "value" ]
          }
        }
      },
      "required" : [ "externalDocumentIdentifier", "issueDate", "buyerCustomerParty", "sellerSupplierParty" ]
    }
  },
  "required": [
    "bumId",
    "documentType",
    "data"
  ]
}

Response code 400 - Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.

Response example for the response code above 

{
  "error": {
    "id": "c842c9c3-75e5-4c32-ae3f-c1fe250fc186",
    "type": "VALIDATION",
    "message": "Business document identifier bumId does not match the pattern :[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}",
    "code": "Error.004.0003",
    "info": "Contact Basware Support http://www.basware.com/utility/contact-us and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

Response code 500 - Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

Response example for the response code above 

{
  "error": {
    "id": "a312a9b3-35e5-1a32-be3f-a5fe250fc121",
    "type": "TECHNICAL",
    "message": "BCN encountered an unexpected system error",
    "code": "Error.001.0006",
    "info": "Contact Basware Support http://www.basware.com/utility/contact-us and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

You can retrieve the order contents using GET /orders method. Basware Unique Message Identifier (bumId) defines which business document you want to retrieve.

Request URI

https://api.basware.com/v2/orders/{bumId}

URI Parameters

Param Name Type Required Example Description
bumId string true 6741ecc7-848a-443c-83ad-ea95e4df06fa Unique UUID for order

Request Headers

Param Name Required Example Description
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Responses

Response code Description
200 The request has been completed successfully.
400 Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
500 Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

API for Vendor Detail v1

VendorDetail

The Vendor Detail API lets you view vendor details for a vendor which has been uploaded to Basware Network.

GET

GET /vendorDetails/{vendorId} HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Response code 200 - The request has been completed successfully.

Response example for the response code above 

{
  "vendorId": "a6d7067f-eb67-4289-89ec-832446078b5a",
  "origin": {
    "creationSource": "Import",
    "partyEnriched": true
  },
  "description": "Parcels United - From SAP US",
  "supplierAssignedAccountId": "15322-12",
  "eligibleForSourcing": false,
  "processingStatus": {
    "status": "Approved",
    "paymentDenied": true
  },
  "contacts": [
    {
      "role": "PrimaryContact",
      "description": "Invoicing support",
      "name": "John Lee",
      "telephone": "442354454",
      "telefax": "442354454",
      "email": "[email protected]"
    },
    {
      "role": "SecondaryContact",
      "description": "Contact only in emergency",
      "name": "Mike Lewis",
      "telephone": "442354452",
      "email": "[email protected]"
    }
  ],
  "orderingDetails": {
    "orderingLanguage": "en-US",
    "orderEmail": "[email protected]",
    "minimumOrderQuantity": 0,
    "hasActiveCatalog": true
  },
  "paymentTerms": {
    "paymentTermsCode": "0021",
    "paymentTermsDescription": "21 days net"
  },
  "deliveryTerms": {
    "deliveryTermsCode": "Free On Board",
    "deliveryTermsDescription": "Postal mail"
  }
}

Response schema

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "title": "Schema for GET /vendorDetails",
    "description": "VendorDetail has details about the vendor including enriched data.",
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "vendorId": {
            "description": "Vendor identifier is an unique identifier (UUID) that can be used to identify the vendor in Basware Network.",
            "pattern" : "^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$"
          },
        "description": {
            "description": "Description of the vendor",
            "type": "string"
        },
        "supplierAssignedAccountId": {
            "description": "Account number that vendor creates for the buyer",
            "type": "string"
        },
        "eligibleForSourcing":{
            "description": "Indicates if the vendor is selected to be invitations for Basware services.",
            "type": "boolean"
        },
        "processingStatus": {
            "description": "Processing status details of the vendor",
            "additionalProperties" : false,
            "properties" : {
              "status" : {
                "type" : "string",
                "description" : "Indicates vendor processing status. Possible values are Approved, Disabled."
              },
              "processOnboarding" : {
                "type" : "string",
                "description" : "Indicates vendor onboarding status. Possible values are Candidate, Invited, InProgress, Confirmed, Completed, Disabled."
              },
              "paymentDenied" : {
                "type" : "boolean",
                "description" : "Indicates whether the payments are denied for this vendor."
              }
            }
        },
        "origin": {
            "description": "Details about the vendor origin",
            "additionalProperties" : false,
            "properties" : {
              "creationSource" : {
                "type" : "string",
                "description" : "Indicate how the vendor was created."
              },
              "partyEnriched" : {
                "type" : "boolean",
                "description" : "Indicates whether the vendor details have been enriched."
              }
            },
            "required" : [ "creationSource", "partyEnriched" ]
        },
        "tags" :{
            "description": "Tag to group a trading partner",
            "items" : {
              "type" : "object",
              "description" : "Tag to group a trading partner.",
              "properties" : {
                "tag" : {
                  "type" : "string",
                  "description" : "Tag to group a trading partner."
                },
                "description" : {
                  "type" : "string",
                  "description" : "Tag description."
                },
                "groupName" : {
                  "type" : "string",
                  "description" : "Grouping for tag."
                }
              },
              "required" : [ "tag" ],
              "additionalProperties" : false
            }
        },
        "paymentTerms": {
            "description": "Processing status details of the vendor",
            "additionalProperties" : false,
            "properties" : {
              "paymentTermsCode" : {
                "type" : "string",
                "description" : "An identifier for this set of payment terms."
              },
              "paymentTermsDescription" : {
                "type" : "string",
                "description" : "Description for this set of payment terms."
              }
            }
        },
        "deliveryTerms": {
            "description": "Processing status details of the vendor",
            "additionalProperties" : false,
            "properties" : {
              "deliveryTermsCode" : {
                "type" : "string",
                "description" : "An identifier this set of delivery terms"
              },
              "deliveryTermsDescription" : {
                "type" : "string",
                "description" : "Description for this set of delivery terms"
              }
            }
        },
        "paymentMeans": {
            "description": "An object holding the available payment means.",
            "additionalProperties" : false,
            "properties" : {
              "paymentMeansCode" : {
                "type" : "string",
                "description" : "A code that identifies how the payment can be done. Valid values: UN/ECE 4461 code represented as string. e.g. (UN/CEFACT Revision 2002A Code List)"
              },
              "description" : {
                "type" : "string",
                "description" : "A payment reference message. This can be a free text describing the payment."
              },
              "currencyCode" : {
                "type" : "string",
                "description" : "A payment reference currency code."
              },
              "default" : {
                "type" : "boolean",
                "description" : "TBD."
              },
              "financialAccounts" : {
                "type" : "array",
                "description" : "Array holding the financial account data",
                "items" : {
                  "type" : "object",
                  "additionalProperties" : false,
                  "description" : "Object holding the financial account data",
                  "properties" : {
                    "financialInstitution" : {
                      "type" : "object",
                      "additionalProperties" : false,
                      "description" : "Object holding financial institution details",
                      "properties" : {
                        "name" : {
                          "type" : "string",
                          "description" : "The name of financial institution."
                        },
                        "id" : {
                          "type" : "string",
                          "description" : "Identifier of financial institution."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "The external identifier of the financial institution id identifier element."
                        },
                        "branchId" : {
                          "type" : "string",
                          "description" : "The identifier of financial institution branch, for example 342-085. This field is typically used by institutions in Australia and New Zealand."
                        },
                        "branchSchemeId" : {
                          "type" : "string",
                          "description" : "The identifier of financial institution branch, for example 342-085. This field is typically used by institutions in Australia and New Zealand."
                        },
                        "additionalId" : {
                          "type" : "string",
                          "description" : "Additional id for the financial institution (for example sort code in UK and Ireland)."
                        },
                        "countryId" : {
                          "type" : "string",
                          "description" : "Country of financial institution."
                        }
                      },
                      "required" : [ "id" ]
                    },
                    "financialAccountIdentifiers" : {
                      "type" : "array",
                      "description" : "Array holding financial account identifiers",
                      "items" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "description" : "Object holding identifier data",
                        "properties" : {
                          "description" : {
                            "type" : "string",
                            "description" : "Identifier."
                          },
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External identifier."
                          },
                          "accountHolderName" : {
                            "type" : "string",
                            "description" : "Account holder name."
                          },
                          "currencyCode" : {
                            "type" : "string",
                            "description" : "Currency Code."
                          },
                          "default" : {
                            "type" : "boolean",
                            "description" : "Indicates the default account to be used."
                          }
                        },
                        "required" : [ "default" ]
                      }
                    }
                  }
                }
              }
            }
        },
        "party": {
            "properties" : {
              "primaryName" : {
                "type" : "string",
                "description" : "Name, exactly as registered in the register of the Primary Identifier."
              },
              "tradingNames" : {
                "type" : "array",
                "additionalProperties" : false,
                "description" : "Array of trading names.",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "name" : {
                      "type" : "string",
                      "description" : "Trading name."
                    }
                  }
                }
              },
              "partyIdentifiers" : {
                "additionalProperties" : false,
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "Identifies the organization, typically a national trade registry number (VAT, etc.) or globally unique identifier (DUNS etc.)"
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "The type of identifier. Can be country specific and issues by regulatory institutions (e.g. VAT, TIN etc.) or global and issued by 3rd party registries (e.g. GLN, DUNS etc.)."
                    },
                    "countryId" : {
                      "type" : "string",
                      "description" : "Country code for the party identifier following ISO3166-1 alpha-2 standard."
                    }
                  },
                  "required" : [ "id" ]
                }
              },
              "isRegisteredAddress" : {
                "type" : "boolean",
                "description" : "Indication whether or not the main address is registered against some authority."
              },
              "businessEntityCode" : {
                "type" : "string",
                "description" : "Indicates the business status of party enriched from external source."
              },
              "operatingStatusCode" : {
                "type" : "string",
                "description" : "Indicates the business status of party enriched from external source."
              },
              "addresses" : {
                "type" : "array",
                "description" : "An object containing address information. Used for defining vendor's address data.",
                "items" : {
                  "properties" : {
                    "addressType" : {
                      "type" : "string",
                      "description" : "Indicates the type of address of vendor (for example PrimaryAddress, MailingAddress, RemittanceAddress, VisitingAddress, AdditionalAddress)."
                    },
                    "name" : {
                      "type" : "string",
                      "description" : "Indicates the name of vendor."
                    },
                    "description" : {
                      "type" : "string",
                      "description" : "Description of the address (for example about the purpose of the address)"
                    },
                    "addressLine1" : {
                      "type" : "string",
                      "description" : "The address line of the mentioned address type of the vendor."
                    },
                    "addressLine2" : {
                      "type" : "string",
                      "description" : "The second address line of the mentioned address type of the vendor."
                    },
                    "addressLine3" : {
                      "type" : "string",
                      "description" : "The third address line of the mentioned address type of the vendor."
                    },
                    "cityName" : {
                      "type" : "string",
                      "description" : "The name of the city, town or village in the mentioned address type of the vendor."
                    },
                    "postalZone" : {
                      "type" : "string",
                      "description" : "The postal code of the area in the mentioned address type of the vendor. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                    },
                    "countryId" : {
                      "type" : "string",
                      "description" : "The country of the mentioned address type of the vendor. Valid values: ISO3166-1 alpha-2 values can be used."
                    },
                    "countrySubEntity" : {
                      "type" : "string",
                      "description" : "The sub-entity of the area in the mentioned address type of the vendor."
                    },
                    "countrySubEntityDescription" : {
                      "type" : "string",
                      "description" : "The sub-entity of the area in the mentioned address type of the vendor."
                    },
                    "locality" : {
                      "type" : "string",
                      "description" : "Specifies a particular area or neighbourhood (often used to express addresses in the UK)."
                    }
                  }
                }
              },
              "telephones" : {
                "type" : "array",
                "description" : "Array of telephones for the vendor organization",
                "additionalProperties" : false,
                "items" : {
                  "type" : "object",
                  "description" : "Telephones available for the party.",
                  "properties" : {
                    "telephone" : {
                      "type" : "string",
                      "description" : "The actual telephone number without international dial code."
                    },
                    "internationalDialCode" : {
                      "type" : "string",
                      "description" : "The country specific dialing prefix."
                    },
                    "isReachable" : {
                      "type" : "boolean",
                      "description" : "Specifies whether or not the number is still active."
                    }
                  }
                }
              },
              "industryCodes" : {
                "type" : "array",
                "description" : "Array of industry codes of the vendor organization",
                "additionalProperties" : false,
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "code" : {
                      "type" : "string",
                      "description" : "Industry code is the classifications of the accompanying standard name."
                    },
                    "description" : {
                      "type" : "string",
                      "description" : "The detailed name the industry code comes from."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "Scheme id of the industry code (for example NACE_REV2, SIC etc.)."
                    },
                    "schemeDescription" : {
                      "type" : "string",
                      "description" : "The detailed description of the scheme id."
                    }
                  }
                }
              }
            },
            "required" : [ "addresses", "partyIdentifiers" ]
        },
        "identifiers":{
            "additionalProperties" : false,
            "items" : {
              "type" : "object",
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Identifies the organization, typically a national trade registry number (VAT, etc.) or globally unique identifier (DUNS etc.)"
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "The type of identifier. Can be country specific and issues by regulatory institutions (e.g. VAT, TIN etc.) or global and issued by 3rd party registries (e.g. GLN, DUNS etc.)."
                },
                "countryId" : {
                  "type" : "string",
                  "description" : "Country code for the party identifier following ISO3166-1 alpha-2 standard."
                }
              },
              "required" : [ "id" ]
            }
        },
        "contacts": {
            "description": "Vendor contacts",
            "items" : {
              "type" : "object",
              "description" : "An array holding contacts for the vendor.",
              "properties" : {
                "role" : {
                  "type" : "string",
                  "description" : "Role for the contact. Possible values are PrimaryContact, SecondaryContact, AdditionalContact."
                },
                "description" : {
                  "type" : "string",
                  "description" : "A textual description of the circumstances under which this contact can be used."
                },
                "name" : {
                  "type" : "string",
                  "description" : "The name of this contact. It is recommended that this be used for a functional name and not a personal name."
                },
                "telephone" : {
                  "type" : "string",
                  "description" : "The primary telephone number of this contact."
                },
                "telefax" : {
                  "type" : "string",
                  "description" : "The primary fax number of this contact."
                },
                "email" : {
                  "type" : "string",
                  "description" : "The primary email address of this contact."
                },
                "website" : {
                  "type" : "string",
                  "description" : "The website address of this contact."
                }
              },
              "required" : [ "role" ],
              "additionalProperties" : false
            }
        },
        "orderingDetails": {
            "description": "Ordering Details",
            "properties" : {
              "orderingLanguage" : {
                "type" : "string"
              },
              "orderEmail" : {
                "type" : "string"
              },
              "minimumOrderQuantity" : {
                "type" : "number"
              },
              "hasActiveCatalog" : {
                "type" : "boolean"
              }
            }
        },
        "customFields": {
            "description": "Vendor custom Fields",
            "items" : {
              "type" : "object",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "Name of the field"
                },
                "value" : {
                  "type" : "string",
                  "description" : "Value of the field"
                },
                "groupName" : {
                  "type" : "string",
                  "description" : "Grouping of custom fields"
                },
                "description" : {
                  "type" : "string",
                  "description" : "Description of the field"
                }
              }
            }
        },
        "fileAssetReferences": {
            "description": "References to file assets of the vendor",
            "items" : {
              "type" : "object",
              "additionalProperties" : false,
              "properties" : {
                "fileAssetId" : {
                  "type" : "string",
                  "description" : "Unique file identifier of the file asset in Basware Network."
                },
                "description" : {
                  "type" : "string",
                  "description" : "Description of the file asset."
                }
              },
              "required" : [ "fileAssetId" ]
            }
        },
        "links": {
            "description": "Links available for this resource",
            "items" : {
              "type" : "object",
              "description" : "Links related to the vendor",
              "properties" : {
                "rel" : {
                  "type" : "string",
                  "description" : "Relation type for the URL in question. Possible values are fileAsset."
                },
                "href" : {
                  "type" : "string",
                  "description" : "Link between the completed call and a future call. The URI is a fully formed URI, which needs also the method field"
                },
                "method" : {
                  "type" : "string",
                  "enum" : [ "GET", "POST" ],
                  "description" : "HTTP methods required to interact with the provided URL",
                  "default" : "GET"
                }
              },
              "required" : [ "rel", "href", "method" ]
            }
        },
        "companyCodes": {
            "description":"Company codes of which vendor belongs",
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "sourceSystem": {
            "description": "SourceSystem of the vendor",
            "type": "string"
        },
        "socialEconomicInformation": {
            "description": "Social Economic information for a vendor",
            "properties" : {
              "isMinorityOwned" : {
                "type" : "boolean",
                "description" : "Company is a own by a minority."
              },
              "isSmallBusiness" : {
                "type" : "boolean",
                "description" : "Indicator of small business entity."
              }
            }
        },
        "globalUltimate": {
            "description": "Global Ultimate information for a vendor",
            "properties" : {
              "partyName" : {
                "type" : "string",
                "description" : "The party name assigned to the Global Ultimate legal entity."
              },
              "countryId" : {
                "type" : "string",
                "description" : "The country id assigned to the Global Ultimate legal entity."
              },
              "duns" : {
                "type" : "string",
                "description" : "The DUNS number assigned to the Domestic Ultimate legal entity."
              }
            }
        },
        "externalRegistersInformation": {
            "description": "External Registers information for a vendor",
            "properties" : {
              "bisnodeRegister" : {
                "type" : "array",
                "description" : "Bisnode Register information.",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "registerName" : {
                      "type" : "string",
                      "description" : "Register Name"
                    },
                    "registered" : {
                      "type" : "boolean",
                      "description" : "Registered"
                    },
                    "startDate" : {
                      "type" : "string",
                      "description" : "Start date of the bisnode register. Value of the date will be in the format: CCYY-MM-DD. .If date contains also hours and minutes will be represented with +hh:mm or -hh:mm or Z (which means UTC).otherwise will be left empty. "
                    },
                    "endDate" : {
                      "type" : "string",
                      "description" : "End date of the bisnode register. Value of the date will be in the format: CCYY-MM-DD.If date contains also hours and minutes will be represented with +hh:mm or -hh:mm or Z (which means UTC).otherwise will be left empty. "
                    }
                  }
                }
              }
            }
        }
    },
    "required": [
        "vendorId",
        "origin",
        "processingStatus"
    ]
}

Response code 400 - Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.

Response example for the response code above 

{
  "error": {
    "id": "c842c9c3-75e5-4c32-ae3f-c1fe250fc186",
    "type": "VALIDATION",
    "message": "Business document identifier bumId does not match the pattern :[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}",
    "code": "Error.004.0003",
    "info": "Contact Basware Support http://www.basware.com/utility/contact-us and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

Response code 500 - Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

Response example for the response code above 

{
  "error": {
    "id": "a312a9b3-35e5-1a32-be3f-a5fe250fc121",
    "type": "TECHNICAL",
    "message": "BCN encountered an unexpected system error",
    "code": "Error.001.0006",
    "info": "Contact Basware Support http://www.basware.com/utility/contact-us and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

You can retrieve the vendor details using GET /vendorDetails method. The parameter vendorId defines which vendor you want to retrieve.

Request URI

https://api.basware.com/v1/vendorDetails/{vendorId}

URI Parameters

Param Name Type Required Example Description
vendorId string true 6741ecc7-848a-443c-83ad-ea95e4df02ac Unique UUID for vendor

Request Headers

Param Name Required Example Description
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Responses

Response code Description
200 The request has been completed successfully.
400 Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
500 Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

API for Application Response v1

Application Responses

The Application Response API lets you receive application response messages from buyers via Basware Network.

GET

GET /applicationResponses/{bumId} HTTP/1.1 
Accept: application/json
Authorization: Basic dXMlbjp1c2Vy
X-BW-REQUEST-ID: 1204edd0-ff8d-11e4-a322-1697f925ec7b

Response code 200 - The request has been completed successfully.

Response example for the response code above 

{
  "bumId": "c6d7067f-eb67-4289-89ec-819446078a3a",
  "origin": {
    "source": "SendingCustomer",
    "sourceContentCategory": "StructuredData",
    "sourceChannelCategory": "Electronic",
    "processQualityIndicators": [
      "StructuralValidation"
    ]
  },
  "data": {
    "externalDocumentIdentifier": {
      "id": "56328230"
    },
    "issueDate": "2021-06-02",
    "senderParty": {
      "endpoint": {
        "id": "0037:05925424",
        "schemeId": "ISO6523-ACTORID-UPIS"
      },
      "partyIdentifications": [
        {
          "id": "05925424",
          "schemeId": "FI:ORGNR"
        }
      ],
      "partyName": "Basware Oyj",
      "postalAddress": {
        "addressLine": "Linnoitustie 2",
        "cityName": "Espoo",
        "postalZone": "02600",
        "countryId": "FI"
      }
    },
    "receiverParty": {
      "endpoint": {
        "id": "9908:6903148000007",
        "schemeId": "ISO6523-ACTORID-UPIS"
      },
      "partyName": "Acme Supplier Inc.",
      "postalAddress": {
        "addressLine": "1800 Main Street",
        "cityName": "Dallas",
        "countryId": "US",
        "countrySubentity": "TX",
        "postalZone": "75201"
      }
    },
    "documentResponse": [
      {
        "response": {
          "referenceId": "1",
          "responseCode": {
            "id" : "RE"
          },
          "description": "Missing field",
          "effectiveDate": "2021-06-02",
          "status": [
            {
              "statusReason": "TAX reference not found",
              "statusReasonCode": {
                "id": "NIN",
                "schemeId": "OPStatusAction"
              },
              "condition": [
                {
                  "attributeId": "BT-48",
                  "description": "EU123456789"
                }
              ]
            }
          ]
        },
        "documentReference": {
          "id": "IN25543",
          "issueDate": "2021-05-23",
          "documentTypeCode": "Invoice"
        }
      }
    ]
  }
}

Response schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Schema for GET /applicationResponses",
  "description": "Application Response is a business document that provides status information on other documents",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "bumId": {
      "description": "Identifies the business document (Basware Unique Message Identifier). It is an unique identifier (UUID) that can be used by external systems to identify a business document.",
      "pattern" : "^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$"
    },
    "links": {
      "items" : {
        "type" : "object",
        "description" : "Links related to the business document",
        "properties" : {
          "rel" : {
            "type" : "string",
            "description" : "Relation type for the URL in question. Possible values are file.",
            "default" : "file"
          },
          "href" : {
            "type" : "string",
            "description" : "Link between the completed call and a future call. The URI is a fully formed URI, which needs also the method field"
          },
          "method" : {
            "type" : "string",
            "enum" : [ "GET", "POST" ],
            "description" : "HTTP methods required to interact with the provided URL",
            "default" : "GET"
          }
        }
      }
    },
    "origin": {
      "additionalProperties" : false,
      "properties" : {
        "source" : {
          "type" : "string",
          "description" : "The originating source of the document. Possible values: SendingCustomer, ReceivingCustomer, ServiceProvider"
        },
        "sourceContentCategory" : {
          "type" : "string",
          "description" : "Indicates the source content. If the content is structured data, the data quality is higher. Possible values: Image, StructuredData, UnstructuredData"
        },
        "sourceChannelCategory" : {
          "type" : "string",
          "description" : "Indicates the source channel of the business document. Possible values: PostalMail, ElectronicMail, Electronic"
        },
        "processQualityIndicators" : {
          "type" : "array",
          "description" : "The quality phases the document has gone through",
          "items" : {
            "type" : "string",
            "description" : "Possible values: HumanSelfValidation, HumanValidation, StructuralValidation, ContentValidation"
          }
        }
      }
    },
    "data": {
      "additionalProperties" : false,
      "properties" : {
        "externalDocumentIdentifier" : {
          "description" : "External system identifier of the business document. An identifier for the Application Response assigned by the sender.",
          "properties" : {
            "id" : {
              "type" : "string",
              "description" : "Identifies the value."
            },
            "schemeId" : {
              "type" : "string",
              "description" : "Identifies the namespace of the id."
            }
          },
          "required" : [ "id" ],
          "additionalProperties" : false
        },
        "issueDate" : {
          "description" : "The date when the application response was issued. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
          "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
        },
        "responseDate" : {
          "type" : "string",
          "description" : "The date at which the information in the response was created. Valid values must be in format: CCYY-MM-DD. If the timezone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If timezone is not known, it must be left empty. Related UBL Element: order.IssueDate. UBL Description: The date at which the information in the response was created.",
          "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
        },
        "note" : {
          "type" : "string",
          "description" : "Free-form text pertinent to this document, conveying information that is not contained explicitly in other structures."
        },
        "senderParty" : {
          "description" : "Party that is the sender of this application response.",
          "properties" : {
            "endpoint" : {
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "additionalProperties" : false,
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                }
              },
              "required" : [ "id" ]
            },
            "partyIdentifications" : {
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party identification.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "An object holding the system identifier of the party."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Global identifier of namescheme for party identifier."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              }
            },
            "partyName" : {
              "type" : "string",
              "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
            },
            "postalAddress" : {
              "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
              "properties" : {
                "cityName" : {
                  "type" : "string",
                  "description" : "The name of the city, town or village in the postal address of the party."
                },
                "postalZone" : {
                  "type" : "string",
                  "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                },
                "addressLine" : {
                  "type" : "string",
                  "description" : "The address line of the postal address of the party."
                },
                "addressLine2" : {
                  "type" : "string",
                  "description" : "The second address line of the postal address of the party."
                },
                "addressLine3" : {
                  "type" : "string",
                  "description" : "The third address line of the postal address of the party."
                },
                "locality" : {
                  "type" : "string",
                  "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                },
                "countrySubentity" : {
                  "type" : "string",
                  "description" : "The sub-entity of the area in the postal address."
                },
                "countryId" : {
                  "type" : "string",
                  "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                }
              },
              "additionalProperties" : false
            },
            "partyTaxScheme" : {
              "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
              "properties" : {
                "company" : {
                  "type" : "object",
                  "description" : "Information about the company taxes.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "additionalProperties" : false
            },
            "partyLegalEntities" : {
              "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party legal entity.",
                "properties" : {
                  "registrationName" : {
                    "type" : "string",
                    "description" : "Registration name of the legal entity."
                  },
                  "companyIdentifier" : {
                    "description" : "Global legal party identifier, including name scheme",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the value."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the id."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "registrationName", "companyIdentifier" ],
                "additionalProperties" : false
              }
            },
            "contact" : {
              "description" : "An object containing information about contacts. Used for defining the company contact data.",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "A contact name of the party."
                },
                "telephone" : {
                  "type" : "string",
                  "description" : "A telephone number of the contact of the party."
                },
                "telefax" : {
                  "type" : "string",
                  "description" : "A fax number of the contact of the party."
                },
                "electronicMail" : {
                  "type" : "string",
                  "description" : "An email of the contact of the party."
                }
              },
              "additionalProperties" : false
            },
            "supplierAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the supplier."
            },
            "customerAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the customer."
            },
            "note" : {
              "type" : "string",
              "description" : "Free-form description of the party not included in other fields"
            }
          },
          "required" : [ "partyName" ],
          "additionalProperties" : false
        },
        "receiverParty" : {
          "description" : "Party that is the receiver of this application response",
          "properties" : {
            "endpoint" : {
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "additionalProperties" : false,
              "properties" : {
                "id" : {
                  "type" : "string",
                  "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                },
                "schemeId" : {
                  "type" : "string",
                  "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                }
              },
              "required" : [ "id" ]
            },
            "partyIdentifications" : {
              "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party identification.",
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "An object holding the system identifier of the party."
                  },
                  "schemeId" : {
                    "type" : "string",
                    "description" : "Global identifier of namescheme for party identifier."
                  }
                },
                "required" : [ "id" ],
                "additionalProperties" : false
              }
            },
            "partyName" : {
              "type" : "string",
              "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
            },
            "postalAddress" : {
              "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
              "properties" : {
                "cityName" : {
                  "type" : "string",
                  "description" : "The name of the city, town or village in the postal address of the party."
                },
                "postalZone" : {
                  "type" : "string",
                  "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                },
                "addressLine" : {
                  "type" : "string",
                  "description" : "The address line of the postal address of the party."
                },
                "addressLine2" : {
                  "type" : "string",
                  "description" : "The second address line of the postal address of the party."
                },
                "addressLine3" : {
                  "type" : "string",
                  "description" : "The third address line of the postal address of the party."
                },
                "locality" : {
                  "type" : "string",
                  "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                },
                "countrySubentity" : {
                  "type" : "string",
                  "description" : "The sub-entity of the area in the postal address."
                },
                "countryId" : {
                  "type" : "string",
                  "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                }
              },
              "additionalProperties" : false
            },
            "partyTaxScheme" : {
              "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
              "properties" : {
                "company" : {
                  "type" : "object",
                  "description" : "Information about the company taxes.",
                  "properties" : {
                    "id" : {
                      "type" : "string",
                      "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                    },
                    "schemeId" : {
                      "type" : "string",
                      "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                    }
                  },
                  "additionalProperties" : false
                }
              },
              "additionalProperties" : false
            },
            "partyLegalEntities" : {
              "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
              "items" : {
                "type" : "object",
                "description" : "An object holding a party legal entity.",
                "properties" : {
                  "registrationName" : {
                    "type" : "string",
                    "description" : "Registration name of the legal entity."
                  },
                  "companyIdentifier" : {
                    "description" : "Global legal party identifier, including name scheme",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the value."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the id."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  }
                },
                "required" : [ "registrationName", "companyIdentifier" ],
                "additionalProperties" : false
              }
            },
            "contact" : {
              "description" : "An object containing information about contacts. Used for defining the company contact data.",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "A contact name of the party."
                },
                "telephone" : {
                  "type" : "string",
                  "description" : "A telephone number of the contact of the party."
                },
                "telefax" : {
                  "type" : "string",
                  "description" : "A fax number of the contact of the party."
                },
                "electronicMail" : {
                  "type" : "string",
                  "description" : "An email of the contact of the party."
                }
              },
              "additionalProperties" : false
            },
            "supplierAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the supplier."
            },
            "customerAssignedAccountId" : {
              "type" : "string",
              "description" : "Account identifier assigned by the customer."
            },
            "note" : {
              "type" : "string",
              "description" : "Free-form description of the party not included in other fields"
            }
          },
          "required" : [ "partyName" ],
          "additionalProperties" : false
        },
        "documentResponse" : {
          "type" : "array",
          "description" : "An array of objects containing responses to a source document such as an invoice.",
          "items" : {
            "type" : "object",
            "description" : "An object containing information about a response to a document.",
            "required" : [ "response", "documentReference" ],
            "properties" : {
              "response" : {
                "type" : "object",
                "description" : "An object containing information about the response to the received document. Related UBL Element: ApplicationResponse.DocumentResponse.Response. UBL Description: The response to the received document.",
                "required" : [ "responseCode" ],
                "properties" : {
                  "referenceId" : {
                    "type" : "string",
                    "description" : "A reference to identify the section (or line) of the document to which the response applies. Related UBL Element: ApplicationResponse.DocumentResponse.Response.ReferenceID. UBL Description: A reference to identify the section (or line) of the document to which the response applies."
                  },
                  "responseCode" : {
                    "description" : "A code for the description of the response to the transaction document. Related UBL Element: ApplicationResponse.DocumentResponse.Response.ResponseCode. UBL Description: A code for the description of the response to the transaction document.",
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifies the value."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "Identifies the namespace of the id."
                      }
                    },
                    "required" : [ "id" ],
                    "additionalProperties" : false
                  },
                  "effectiveDate" : {
                    "description" : "The date when the status became effective. Valid values must be in format: CCYY-MM-DD. If the time zone is known, it must be represented with +hh:mm or -hh:mm or Z (which means UTC). If time zone is not known, it must be left empty.",
                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                  },
                  "description" : {
                    "type" : "string",
                    "description" : "The description of the response to the transaction document. Related UBL Element: ApplicationResponse.DocumentResponse.Response.Description. UBL Description: The description of the response to the transaction document."
                  },
                  "status" : {
                    "type" : "array",
                    "description" : "A status report associated with this response.",
                    "items" : {
                      "type" : "object",
                      "properties" : {
                        "statusReason" : {
                          "type" : "string",
                          "description" : "The reason for this status condition or position, expressed as text."
                        },
                        "statusReasonCode" : {
                          "description" : "The reason for this status condition or position, expressed as a code.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifies the value."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Identifies the namespace of the id."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        },
                        "condition" : {
                          "type" : "array",
                          "description" : "Measurements that quantify the condition of the objects covered by the status.",
                          "items" : {
                            "type" : "object",
                            "properties" : {
                              "attributeId" : {
                                "type" : "string",
                                "description" : "An identifier for the attribute that applies to the condition."
                              },
                              "description" : {
                                "type" : "string",
                                "description" : "Text describing the attribute that applies to the condition."
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              },
              "documentReference" : {
                "type" : "object",
                "description" : "Information about a Document referred to in another Document Related UBL Element: ApplicationResponse.DocumentResponse.DocumentReference. UBL Description: Information about a Document referred to in another Document.",
                "required" : [ "id" ],
                "properties" : {
                  "id" : {
                    "type" : "string",
                    "description" : "The identifier for the Document being referred to. Related UBL Element: ApplicationResponse.DocumentResponse.DocumentReference.ID. UBL Description: The identifier for the Document being referred to."
                  },
                  "copyIndicator" : {
                    "type" : "string",
                    "description" : "Indicates whether the referenced Document is a copy (true) or the original (false). Related UBL Element: ApplicationResponse.DocumentResponse.DocumentReference.CopyIndicator. UBL Description: Indicates whether the referenced Document is a copy (true) or the original (false)."
                  },
                  "uuid" : {
                    "type" : "string",
                    "description" : "A computer-generated universally unique identifier (UUID) for the referenced Document instance. Related UBL Element: ApplicationResponse.DocumentResponse.DocumentReference.UUID. UBL Description: A computer-generated universally unique identifier (UUID) for the referenced Document instance."
                  },
                  "issueDate" : {
                    "type" : "string",
                    "pattern" : "^(-?(?:[1-9][0-9]*)?[0-9]{4})-(1[0-2]|0[1-9])-(3[0-1]|0[1-9]|[1-2][0-9])(Z|[+-](?:2[0-3]|[0-1][0-9]):[0-5][0-9])?$"
                  },
                  "documentTypeCode" : {
                    "type" : "string",
                    "description" : "Business document type represented according to Basware REST API document types. If it cannot be represented as a Basware REST API type it will be passed through as-is. UBL Element: ApplicationResponse.DocumentResponse.DocumentReference.DocumentTypeCode. UBL description: The document type, expressed as a code."
                  },
                  "issuerParty" : {
                    "description" : "The party that issued the document. Related UBL Element: ApplicationResponse.DocumentResponse.DocumentReference.IssuerParty",
                    "properties" : {
                      "endpoint" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "additionalProperties" : false,
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                          }
                        },
                        "required" : [ "id" ]
                      },
                      "partyIdentifications" : {
                        "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party identification.",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "An object holding the system identifier of the party."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Global identifier of namescheme for party identifier."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "partyName" : {
                        "type" : "string",
                        "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                      },
                      "postalAddress" : {
                        "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                        "properties" : {
                          "cityName" : {
                            "type" : "string",
                            "description" : "The name of the city, town or village in the postal address of the party."
                          },
                          "postalZone" : {
                            "type" : "string",
                            "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                          },
                          "addressLine" : {
                            "type" : "string",
                            "description" : "The address line of the postal address of the party."
                          },
                          "addressLine2" : {
                            "type" : "string",
                            "description" : "The second address line of the postal address of the party."
                          },
                          "addressLine3" : {
                            "type" : "string",
                            "description" : "The third address line of the postal address of the party."
                          },
                          "locality" : {
                            "type" : "string",
                            "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                          },
                          "countrySubentity" : {
                            "type" : "string",
                            "description" : "The sub-entity of the area in the postal address."
                          },
                          "countryId" : {
                            "type" : "string",
                            "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyTaxScheme" : {
                        "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                        "properties" : {
                          "company" : {
                            "type" : "object",
                            "description" : "Information about the company taxes.",
                            "properties" : {
                              "id" : {
                                "type" : "string",
                                "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                              },
                              "schemeId" : {
                                "type" : "string",
                                "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                              }
                            },
                            "additionalProperties" : false
                          }
                        },
                        "additionalProperties" : false
                      },
                      "partyLegalEntities" : {
                        "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                        "items" : {
                          "type" : "object",
                          "description" : "An object holding a party legal entity.",
                          "properties" : {
                            "registrationName" : {
                              "type" : "string",
                              "description" : "Registration name of the legal entity."
                            },
                            "companyIdentifier" : {
                              "description" : "Global legal party identifier, including name scheme",
                              "properties" : {
                                "id" : {
                                  "type" : "string",
                                  "description" : "Identifies the value."
                                },
                                "schemeId" : {
                                  "type" : "string",
                                  "description" : "Identifies the namespace of the id."
                                }
                              },
                              "required" : [ "id" ],
                              "additionalProperties" : false
                            }
                          },
                          "required" : [ "registrationName", "companyIdentifier" ],
                          "additionalProperties" : false
                        }
                      },
                      "contact" : {
                        "description" : "An object containing information about contacts. Used for defining the company contact data.",
                        "properties" : {
                          "name" : {
                            "type" : "string",
                            "description" : "A contact name of the party."
                          },
                          "telephone" : {
                            "type" : "string",
                            "description" : "A telephone number of the contact of the party."
                          },
                          "telefax" : {
                            "type" : "string",
                            "description" : "A fax number of the contact of the party."
                          },
                          "electronicMail" : {
                            "type" : "string",
                            "description" : "An email of the contact of the party."
                          }
                        },
                        "additionalProperties" : false
                      },
                      "supplierAssignedAccountId" : {
                        "type" : "string",
                        "description" : "Account identifier assigned by the supplier."
                      },
                      "customerAssignedAccountId" : {
                        "type" : "string",
                        "description" : "Account identifier assigned by the customer."
                      },
                      "note" : {
                        "type" : "string",
                        "description" : "Free-form description of the party not included in other fields"
                      }
                    },
                    "required" : [ "partyName" ],
                    "additionalProperties" : false
                  }
                }
              },
              "issuerParty" : {
                "description" : "The party that issued the document. Related UBL Element: ApplicationResponse.DocumentResponse.IssuerParty",
                "properties" : {
                  "endpoint" : {
                    "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "additionalProperties" : false,
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "partyIdentifications" : {
                    "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party identification.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "An object holding the system identifier of the party."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "Global identifier of namescheme for party identifier."
                        }
                      },
                      "required" : [ "id" ],
                      "additionalProperties" : false
                    }
                  },
                  "partyName" : {
                    "type" : "string",
                    "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                  },
                  "postalAddress" : {
                    "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                    "properties" : {
                      "cityName" : {
                        "type" : "string",
                        "description" : "The name of the city, town or village in the postal address of the party."
                      },
                      "postalZone" : {
                        "type" : "string",
                        "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                      },
                      "addressLine" : {
                        "type" : "string",
                        "description" : "The address line of the postal address of the party."
                      },
                      "addressLine2" : {
                        "type" : "string",
                        "description" : "The second address line of the postal address of the party."
                      },
                      "addressLine3" : {
                        "type" : "string",
                        "description" : "The third address line of the postal address of the party."
                      },
                      "locality" : {
                        "type" : "string",
                        "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                      },
                      "countrySubentity" : {
                        "type" : "string",
                        "description" : "The sub-entity of the area in the postal address."
                      },
                      "countryId" : {
                        "type" : "string",
                        "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyTaxScheme" : {
                    "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                    "properties" : {
                      "company" : {
                        "type" : "object",
                        "description" : "Information about the company taxes.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyLegalEntities" : {
                    "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party legal entity.",
                      "properties" : {
                        "registrationName" : {
                          "type" : "string",
                          "description" : "Registration name of the legal entity."
                        },
                        "companyIdentifier" : {
                          "description" : "Global legal party identifier, including name scheme",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifies the value."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Identifies the namespace of the id."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "required" : [ "registrationName", "companyIdentifier" ],
                      "additionalProperties" : false
                    }
                  },
                  "contact" : {
                    "description" : "An object containing information about contacts. Used for defining the company contact data.",
                    "properties" : {
                      "name" : {
                        "type" : "string",
                        "description" : "A contact name of the party."
                      },
                      "telephone" : {
                        "type" : "string",
                        "description" : "A telephone number of the contact of the party."
                      },
                      "telefax" : {
                        "type" : "string",
                        "description" : "A fax number of the contact of the party."
                      },
                      "electronicMail" : {
                        "type" : "string",
                        "description" : "An email of the contact of the party."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "supplierAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the supplier."
                  },
                  "customerAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the customer."
                  },
                  "note" : {
                    "type" : "string",
                    "description" : "Free-form description of the party not included in other fields"
                  }
                },
                "required" : [ "partyName" ],
                "additionalProperties" : false
              },
              "recipientParty" : {
                "description" : "The party for which the document is intended. Related UBL Element: ApplicationResponse.DocumentResponse.RecipientParty",
                "properties" : {
                  "endpoint" : {
                    "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "additionalProperties" : false,
                    "properties" : {
                      "id" : {
                        "type" : "string",
                        "description" : "Identifier for the endpoint. See API documentation for more details about the endpoints."
                      },
                      "schemeId" : {
                        "type" : "string",
                        "description" : "External global identifier of the id identifier element. See API documentation for more details about the endpoint scheme identifiers."
                      }
                    },
                    "required" : [ "id" ]
                  },
                  "partyIdentifications" : {
                    "description" : "An array holding the external system identifiers of the party. Used for defining customer, supplier and delivery party data.",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party identification.",
                      "properties" : {
                        "id" : {
                          "type" : "string",
                          "description" : "An object holding the system identifier of the party."
                        },
                        "schemeId" : {
                          "type" : "string",
                          "description" : "Global identifier of namescheme for party identifier."
                        }
                      },
                      "required" : [ "id" ],
                      "additionalProperties" : false
                    }
                  },
                  "partyName" : {
                    "type" : "string",
                    "description" : "A name of the party. Used for defining supplier, customer and delivery party names."
                  },
                  "postalAddress" : {
                    "description" : "An object containing address information. Used for defining supplier party, customer party and delivery party address data.",
                    "properties" : {
                      "cityName" : {
                        "type" : "string",
                        "description" : "The name of the city, town or village in the postal address of the party."
                      },
                      "postalZone" : {
                        "type" : "string",
                        "description" : "The postal code of the area in the postal address of the party. The identifier for an addressable group of properties according to the relevant national postal service, such as a ZIP code or Post Code."
                      },
                      "addressLine" : {
                        "type" : "string",
                        "description" : "The address line of the postal address of the party."
                      },
                      "addressLine2" : {
                        "type" : "string",
                        "description" : "The second address line of the postal address of the party."
                      },
                      "addressLine3" : {
                        "type" : "string",
                        "description" : "The third address line of the postal address of the party."
                      },
                      "locality" : {
                        "type" : "string",
                        "description" : "Neighbourhood or district within town or city. Required in UK if a similar road name exists within a post town area."
                      },
                      "countrySubentity" : {
                        "type" : "string",
                        "description" : "The sub-entity of the area in the postal address."
                      },
                      "countryId" : {
                        "type" : "string",
                        "description" : "The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyTaxScheme" : {
                    "description" : "Information about taxes. Notice that only one tax scheme is used, although there could be multiple.",
                    "properties" : {
                      "company" : {
                        "type" : "object",
                        "description" : "Information about the company taxes.",
                        "properties" : {
                          "id" : {
                            "type" : "string",
                            "description" : "A tax identifier for a company. The identifier assigned for tax purposes to a party by the taxation authority."
                          },
                          "schemeId" : {
                            "type" : "string",
                            "description" : "Global identifier of the endpoint identifier element. Valid values: Country specific agency schema, example DK:CVR for Denmark."
                          }
                        },
                        "additionalProperties" : false
                      }
                    },
                    "additionalProperties" : false
                  },
                  "partyLegalEntities" : {
                    "description" : "An array holding the legal entities of the party. Note that currently one legal entity is supported by the API.",
                    "items" : {
                      "type" : "object",
                      "description" : "An object holding a party legal entity.",
                      "properties" : {
                        "registrationName" : {
                          "type" : "string",
                          "description" : "Registration name of the legal entity."
                        },
                        "companyIdentifier" : {
                          "description" : "Global legal party identifier, including name scheme",
                          "properties" : {
                            "id" : {
                              "type" : "string",
                              "description" : "Identifies the value."
                            },
                            "schemeId" : {
                              "type" : "string",
                              "description" : "Identifies the namespace of the id."
                            }
                          },
                          "required" : [ "id" ],
                          "additionalProperties" : false
                        }
                      },
                      "required" : [ "registrationName", "companyIdentifier" ],
                      "additionalProperties" : false
                    }
                  },
                  "contact" : {
                    "description" : "An object containing information about contacts. Used for defining the company contact data.",
                    "properties" : {
                      "name" : {
                        "type" : "string",
                        "description" : "A contact name of the party."
                      },
                      "telephone" : {
                        "type" : "string",
                        "description" : "A telephone number of the contact of the party."
                      },
                      "telefax" : {
                        "type" : "string",
                        "description" : "A fax number of the contact of the party."
                      },
                      "electronicMail" : {
                        "type" : "string",
                        "description" : "An email of the contact of the party."
                      }
                    },
                    "additionalProperties" : false
                  },
                  "supplierAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the supplier."
                  },
                  "customerAssignedAccountId" : {
                    "type" : "string",
                    "description" : "Account identifier assigned by the customer."
                  },
                  "note" : {
                    "type" : "string",
                    "description" : "Free-form description of the party not included in other fields"
                  }
                },
                "required" : [ "partyName" ],
                "additionalProperties" : false
              }
            }
          }
        }
      },
      "required" : [ "externalDocumentIdentifier", "issueDate", "senderParty", "receiverParty", "documentResponse" ]
    }
  },
  "required": [
    "bumId",
    "data"
  ]
}

Response code 400 - Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.

Response example for the response code above 

{
  "error": {
    "id": "c842c9c3-75e5-4c32-ae3f-c1fe250fc186",
    "type": "VALIDATION",
    "message": "Business document identifier bumId does not match the pattern :[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}",
    "code": "Error.004.0003",
    "info": "Contact Basware Support http://www.basware.com/utility/contact-us and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

Response code 500 - Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.

Response example for the response code above 

{
  "error": {
    "id": "a312a9b3-35e5-1a32-be3f-a5fe250fc121",
    "type": "TECHNICAL",
    "message": "BCN encountered an unexpected system error",
    "code": "Error.001.0006",
    "info": "Contact Basware Support http://www.basware.com/utility/contact-us and provide them with the error ID and the error code you encountered. Basware support will investigate the cause of the error."
  }
}

You can retrieve the application response contents using GET /applicationResponses method. Basware Unique Message Identifier (bumId) defines which response you want to retrieve.

Request URI

https://api.basware.com/v1/applicationResponses/{bumId}

URI Parameters

Param Name Type Required Example Description
bumId string true 6741ecc7-848a-443c-83ad-ea95e4df06fa Unique UUID for the application response

Request Headers

Param Name Required Example Description
Accept false application/json Specifies media types which are acceptable for the response. Value application/json is supported.
X-BW-REQUEST-ID false 7fc7d038-4306-4fc5-89c3-7ac8a12a30d0 Client generated UUID value for identifying request-response flow. Disclaimer. This value is highly recommended to be included. Production support for this request is not possible if this value is missing.

Responses

Response code Description
200 The request has been completed successfully.
400 Bad Request. The server cannot or will not process the request. Bad request due to invalid request syntax or invalid request message framing.
401 Unauthorized. The request has not been serviced, the request is unauthorized as it lacks valid authentication credentials (UserName/Password).
403 Forbidden. The server understood the request, but is refusing to fulfill it.
500 Internal Server Error. The server encountered an unexpected condition, which prevented it from fulfilling the request.
http