POST /transactions/submit-order

Creates a SubmitOrder business transaction from a metadata structure.

The more parameter of the call informs the server whether additional document attachments are expected or not and then updates the message status. If no more documents will be added, the call sets the status of the message to received. Otherwise, the message remains open and the message status is notset.

The following example contains the minimum JSON body required to create a valid order. These elements are mandatory.

{
    "messageHandling": {
        "receiverIdentifier": "KT:2222228899",
        "fallbackEmailAddress": "[email protected]"
    },
    "order": {
        "orderNo": "ORD1234",
        "issueDate": "2019-05-26T10:15:42.774Z",
        "currencyCode": "USD",
        "customer": {
            "name": "Test Party One",
	        "identifier": "KT:1111118899",
	        "address": {
		        "streetNameAndNumber": "42nd Street 1",
		        "city": "New York",
		        "postalZone": "10036",
		        "countryCode": "US"
	        }
        },
        "supplier": {
	        "name": "Test Party Two",
	        "identifier": "KT:2222228899",
	        "address": {
		        "streetNameAndNumber": "14th Street 52",
		        "city": "New York",
		        "postalZone": "10011",
		        "countryCode": "US"
	        }
        },
        "orderLines": [
	      {
	        "name": "Product A",
		    "quantity": 1,
		    "unitOfMeasure": {
    	        "unit": "Rec20",
                "code": "KHZ"
            },
		    "unitPriceAmount": 1000
	      }
        ]
    }
}

The request body schema includes all mandatory and optional elements.

For more information about allowed values for metadata elements, see Metadata.