# Simple Order Process

## Simple Order Process

This page explains how to use the SCSN messages as defined in the Semantic Treehouse environment (smartconnected.semantic-treehouse.nl). This chapter starts with a simple order process between two organizations, which is the fundamental building block of SCSN. The next pages explain extensions and more advanced processes.

The most fundamental messages of SCSN are the Order and Invoice messages. The Order message is often the start process (but not always as will be shown in the Quotation message Chapter). When just starting to implement SCSN, it is very likely that one would start with implementing the Order and Invoice messages, as these are essential parts of a procurement process. This example describes a simple order process of off-the-shelve parts using these two messages and also includes the Despatch Advice message, which is often implemented next.

In a simple setting, there are only two organizations: one Buyer (i.e. initiator in this process) and one seller (i.e. receiver of the order). Note that in this example we abstract away from the service providers as described in the architecture in order to simplify the scenario.

![](/files/-LriQpA3do5oVcFaNmij)

The buyer starts the process by formulating its demand in the form of a SCSN Order message. This message can contain simple off-the-shelve parts including its item identifier, but also complex custom-made sub-assemblies described using 3D drawings. However, in this example we only describe off-the-shelve items. The Order-message can contain information about the ordered parts, delivery instructions, a requested delivery date, payment terms, additional services, and prices. Below an example of a SCSN Order message including further explanation can be found. For detailed information about the message, the reader is referred to Semantic Treehouse.

```markup
<!-- Message header -->
<?xml version="1.0" encoding="UTF-8"?>
<Order xmlns="urn:oasis:names:specification:ubl:schema:xsd:Order-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:oasis:names:specification:ubl:schema:xsd:Order-2 http://docs.oasis-open.org/ubl/os-UBL-2.1/xsd/maindoc/UBL-Order-2.1.xsd">
    <!--General information about the Order -->
    <cbc:ID>123</cbc:ID>
    <cbc:IssueDate>2018-10-06</cbc:IssueDate>
    <cbc:OrderTypeCode>New</cbc:OrderTypeCode>
    <cbc:Note>[Free-form text about the order]</cbc:Note>
    <cac:QuotationDocumentReference>
        <cbc:ID>[Reference to quotation document]</cbc:ID>
    </cac:QuotationDocumentReference>
    <cac:Contract>
        <cac:ContractDocumentReference>
            <cbc:ID>[Reference to contract document]</cbc:ID>
        </cac:ContractDocumentReference>
    </cac:Contract>
<!-- Contact information of the buyer -->
    <cac:BuyerCustomerParty>
        <cac:Party>
            <cac:PartyIdentification>
                <cbc:ID schemeID="GLN">5790001398644</cbc:ID>
            </cac:PartyIdentification>
            <cac:PartyName>
                <cbc:Name>Metal Group Limburg</cbc:Name>
            </cac:PartyName>
            <cac:PhysicalLocation>
                <cbc:ID schemeID="GLN">5790001398644</cbc:ID>
                <cbc:Description>Limburg Campus</cbc:Description>
                <cac:Address>
                    <cbc:StreetName>Antoon Coolenlaan</cbc:StreetName>
                    <cbc:BuildingNumber>1 B</cbc:BuildingNumber>
                    <cbc:CityName>Weert</cbc:CityName>
                    <cbc:PostalZone>6544RX</cbc:PostalZone>
                    <cac:AddressLine>
                        <cbc:Line>Inkoopafdeling</cbc:Line>
                    </cac:AddressLine>
                    <cac:Country>
                        <cbc:IdentificationCode>NL</cbc:IdentificationCode>
                    </cac:Country>
                </cac:Address>
            </cac:PhysicalLocation>
            <cac:PartyTaxScheme>
                <cbc:CompanyID>NL90390210290S01</cbc:CompanyID>
                <cac:TaxScheme/>
            </cac:PartyTaxScheme>
            <cac:PartyLegalEntity>
                <cbc:CompanyID schemeID="NL:KVK">23432123</cbc:CompanyID>
            </cac:PartyLegalEntity>
            <cac:Contact>
                <cbc:Telephone>040-1234567</cbc:Telephone>
                <cbc:Telefax>040-2345678</cbc:Telefax>
                <cbc:ElectronicMail>info@metaalgrouplimburg.nl</cbc:ElectronicMail>
                <cac:OtherCommunication>
                    <cbc:Value>http://www.metaalgrouplimburg.nl</cbc:Value>
                </cac:OtherCommunication>
            </cac:Contact>
            <cac:Person>
                <cbc:FirstName>Maria</cbc:FirstName>
                <cbc:FamilyName>Pietersen</cbc:FamilyName>
                <cbc:Title>Mevr.</cbc:Title>
                <cbc:JobTitle>Inkoop manager</cbc:JobTitle>
                <cbc:OrganizationDepartment>Afdeling</cbc:OrganizationDepartment>
                <cac:Contact>
                    <cbc:Telephone>040-1234567</cbc:Telephone>
                    <cbc:Telefax>040-2345678</cbc:Telefax>
                    <cbc:ElectronicMail>m.pietersen@metaalgrouplimburg.nl</cbc:ElectronicMail>
                    <cac:OtherCommunication>
                        <cbc:Value>http://www.metaalgrouplimburg.nl</cbc:Value>
                    </cac:OtherCommunication>
                </cac:Contact>
            </cac:Person>
        </cac:Party>
    </cac:BuyerCustomerParty>
<!-- Contact information of the seller -->
    <cac:SellerSupplierParty>
        <cac:Party>
            <cac:PartyIdentification>
                <cbc:ID schemeID="GLN">459874568</cbc:ID>
            </cac:PartyIdentification>
            <cac:PartyName>
                <cbc:Name>Steel Parts and Sheets</cbc:Name>
            </cac:PartyName>
            <cac:PostalAddress>
                <cbc:StreetName>Postbus</cbc:StreetName>
                <cbc:BuildingNumber>31</cbc:BuildingNumber>
                <cbc:CityName>Eindhoven</cbc:CityName>
                <cbc:PostalZone>5612AP</cbc:PostalZone>
                <cac:AddressLine>
                    <cbc:Line>Inkoopafdeling</cbc:Line>
                </cac:AddressLine>
                <cac:Country>
                    <cbc:IdentificationCode>NL</cbc:IdentificationCode>
                </cac:Country>
            </cac:PostalAddress>
            <cac:PhysicalLocation>
                <cbc:ID schemeID="GLN">5790001398644</cbc:ID>
                <cbc:Description>Warehouse Eindhoven</cbc:Description>
                <cac:Address>
                    <cbc:StreetName>Rondom</cbc:StreetName>
                    <cbc:BuildingNumber>1 B</cbc:BuildingNumber>
                    <cbc:CityName>Eindhoven</cbc:CityName>
                    <cbc:PostalZone>5612AP</cbc:PostalZone>
                    <cac:Country>
                        <cbc:IdentificationCode>NL</cbc:IdentificationCode>
                    </cac:Country>
                </cac:Address>
            </cac:PhysicalLocation>
            <cac:PartyTaxScheme>
                <cbc:CompanyID>NL3423423480S02</cbc:CompanyID>
                <cac:TaxScheme/>
            </cac:PartyTaxScheme>
            <cac:PartyLegalEntity>
                <cbc:CompanyID schemeID="NL:KVK">23423432</cbc:CompanyID>
            </cac:PartyLegalEntity>
            <cac:Contact>
                <cbc:Telephone>040-1234567</cbc:Telephone>
                <cbc:Telefax>040-2345678</cbc:Telefax>
                <cbc:ElectronicMail>info@sps.nl</cbc:ElectronicMail>
                <cac:OtherCommunication>
                    <cbc:Value>http://www.sps.nl</cbc:Value>
                </cac:OtherCommunication>
            </cac:Contact>
            <cac:Person>
                <cbc:FirstName>Peter</cbc:FirstName>
                <cbc:FamilyName>van Engelen</cbc:FamilyName>
                <cbc:Title>Dhr.</cbc:Title>
                <cbc:JobTitle>Sales manager</cbc:JobTitle>
                <cbc:OrganizationDepartment>Procurement</cbc:OrganizationDepartment>
                <cac:Contact>
                    <cbc:Telephone>040-2233445</cbc:Telephone>
                    <cbc:Telefax>040-2345678</cbc:Telefax>
                    <cbc:ElectronicMail>p.v.engelen@sps.nl</cbc:ElectronicMail>
                    <cac:OtherCommunication>
                        <cbc:Value>http://www.sps.nl/inkoop</cbc:Value>
                    </cac:OtherCommunication>
                </cac:Contact>
            </cac:Person>
        </cac:Party>
    </cac:SellerSupplierParty>
<!-- Contact information of the buyer’s accounting party -->
    <cac:AccountingCustomerParty>
        <cac:Party>
            <cac:PartyIdentification>
                <cbc:ID schemeID="GLN">93804754</cbc:ID>
            </cac:PartyIdentification>
            <cac:PartyName>
                <cbc:Name>Accounting Noord-Brabant</cbc:Name>
            </cac:PartyName>
            <cac:PhysicalLocation>
                <cbc:ID schemeID="GLN">5790001398644</cbc:ID>
                <cbc:Description>HQ</cbc:Description>
                <cac:Address>
                    <cbc:StreetName>Antoon Coolenlaan</cbc:StreetName>
                    <cbc:BuildingNumber>3 B</cbc:BuildingNumber>
                    <cbc:CityName>Eindhoven</cbc:CityName>
                    <cbc:PostalZone>5644RX</cbc:PostalZone>
                    <cac:Country>
                        <cbc:IdentificationCode>NL</cbc:IdentificationCode>
                    </cac:Country>
                </cac:Address>
            </cac:PhysicalLocation>
            <cac:PartyTaxScheme>
                <cbc:CompanyID>NL234324324S02</cbc:CompanyID>
                <cac:TaxScheme/>
            </cac:PartyTaxScheme>
            <cac:PartyLegalEntity>
                <cbc:CompanyID schemeID="NL:KVK">90845456</cbc:CompanyID>
            </cac:PartyLegalEntity>
            <cac:Contact>
                <cbc:Telephone>040-7654321</cbc:Telephone>
                <cbc:Telefax>040-3456789</cbc:Telefax>
                <cbc:ElectronicMail>info@accountingnoordbrabant.nl</cbc:ElectronicMail>
                <cac:OtherCommunication>
                    <cbc:Value>http://www.accountingnoordbrabant.nl</cbc:Value>
                </cac:OtherCommunication>
            </cac:Contact>
            <cac:Person>
                <cbc:FirstName>Hans</cbc:FirstName>
                <cbc:FamilyName>van Hoop</cbc:FamilyName>
                <cbc:Title>Dhr.</cbc:Title>
                <cbc:JobTitle>Accountant</cbc:JobTitle>
                <cbc:OrganizationDepartment>MKB</cbc:OrganizationDepartment>
                <cac:Contact>
                    <cbc:Telephone>040-3344566</cbc:Telephone>
                    <cbc:Telefax>040-3456780</cbc:Telefax>
                    <cbc:ElectronicMail>h.van.hoop@accountingnoordbrabant.nl</cbc:ElectronicMail>
                    <cac:OtherCommunication>
                        <cbc:Value>http://www.accountingnoordbrabant.nl/mkb</cbc:Value>
                    </cac:OtherCommunication>
                </cac:Contact>
            </cac:Person>
        </cac:Party>
    </cac:AccountingCustomerParty>
<!-- Delivery terms, i.e. requirements, such as the INCO terms -->
    <cac:DeliveryTerms>
        <cbc:ID schemeName="INCOTERMS2010">EXW</cbc:ID>
        <cac:DeliveryLocation>
            <cbc:ID schemeID="GLN">5790001398644</cbc:ID>
            <cbc:Description>[Free-form description of the location]</cbc:Description>
            <cac:Address>
                <cbc:StreetName>Antoon Coolenlaan</cbc:StreetName>
                <cbc:BuildingNumber>1 B</cbc:BuildingNumber>
                <cbc:CityName>Eindhoven</cbc:CityName>
                <cbc:PostalZone>5644RX</cbc:PostalZone>
                <cac:AddressLine>
                    <cbc:Line>Inkoopafdeling</cbc:Line>
                </cac:AddressLine>
                <cac:Country>
                    <cbc:IdentificationCode>NL</cbc:IdentificationCode>
                </cac:Country>
            </cac:Address>
        </cac:DeliveryLocation>
    </cac:DeliveryTerms>    
<!-- Payment terms such as a discount and payment period -->
    <cac:PaymentTerms>
        <cbc:ID>124</cbc:ID>
        <cbc:Note>[Additional information on payment terms]</cbc:Note>
        <cbc:SettlementDiscountPercent>5</cbc:SettlementDiscountPercent>
        <cbc:SettlementDiscountAmount currencyID="EUR">100</cbc:SettlementDiscountAmount>
        <cac:SettlementPeriod>
            <cbc:DurationMeasure unitCode="Days">5.0</cbc:DurationMeasure>
        </cac:SettlementPeriod>
    </cac:PaymentTerms>
    <cac:TransactionConditions>
        <cbc:Description>Accept within 5 days</cbc:Description>
    </cac:TransactionConditions>
    <cac:AnticipatedMonetaryTotal>
        <cbc:PayableAmount currencyID="EUR">1000</cbc:PayableAmount>
    </cac:AnticipatedMonetaryTotal>
<!-- The order lines -->
    <cac:OrderLine>
<!-- A single order line-->
        <cac:LineItem>
<!-- High-level description of the item -->
            <cbc:ID>1</cbc:ID>
            <cbc:Note>[Free-form text note on orderline]</cbc:Note>
            <cbc:Quantity unitCode="KGM">50</cbc:Quantity>
            <cbc:LineExtensionAmount currencyID="EUR">175</cbc:LineExtensionAmount>
<!-- Additional delivery terms, e.g. deliver all the items by a certain date -->
            <cac:Delivery>
                <cbc:ID>[delivery reference]</cbc:ID>
                <cbc:Quantity unitCode="KGM">50</cbc:Quantity>
                <cac:DeliveryLocation>
                    <cbc:ID schemeID="GLN">5790001398644</cbc:ID>
                    <cbc:Description>Warehoues </cbc:Description>
                    <cac:Address>
                        <cbc:StreetName>Antoon Coolenlaan</cbc:StreetName>
                        <cbc:BuildingNumber>1 B</cbc:BuildingNumber>
                        <cbc:CityName>Eindhoven</cbc:CityName>
                        <cbc:PostalZone>5644RX</cbc:PostalZone>
                        <cac:AddressLine>
                            <cbc:Line>Inkoopafdeling</cbc:Line>
                        </cac:AddressLine>
                        <cac:Country>
                            <cbc:IdentificationCode>NL</cbc:IdentificationCode>
                        </cac:Country>
                    </cac:Address>
                </cac:DeliveryLocation>
                <cac:RequestedDeliveryPeriod>
                    <cbc:EndDate>2018-10-11</cbc:EndDate>
                </cac:RequestedDeliveryPeriod>
                <cac:Despatch>
                    <cbc:Instructions>[Free-form text instructions for delivery]</cbc:Instructions>
                </cac:Despatch>
            </cac:Delivery>
<!-- Price information-->
            <cac:Price>
                <cbc:PriceAmount currencyID="EUR">4</cbc:PriceAmount>
                <cbc:BaseQuantity unitCode="KGM">1</cbc:BaseQuantity>
                <cbc:PriceType>net</cbc:PriceType>
                <cac:AllowanceCharge>
                    <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
                    <cbc:Amount currencyID="EUR">0.5</cbc:Amount>
                </cac:AllowanceCharge>
            </cac:Price>
<!-- More specific orderline information-->
            <cac:Item>
                <cbc:Description>[Description of the item]</cbc:Description>
                <cbc:Name>[Item name]</cbc:Name>
                <cac:BuyersItemIdentification>
                    <cbc:ID>[Identifier of the item issued by the BuyerCustomer]</cbc:ID>
                </cac:BuyersItemIdentification>
                <cac:SellersItemIdentification>
                    <cbc:ID>AN0000123456</cbc:ID>
                    <cbc:ExtendedID>A1</cbc:ExtendedID>
                </cac:SellersItemIdentification>
                <cac:Dimension>
                    <cbc:AttributeID>Length</cbc:AttributeID>
                    <cbc:Measure unitCode="MMT">220</cbc:Measure>
                </cac:Dimension>
            </cac:Item>
        </cac:LineItem>
    </cac:OrderLine>
</Order>
```

ToDo:

* Explain message
* Add Order response
* Add Despatch Advice
* Add Invoice


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://smart-connected-supplier-network.gitbook.io/processmanual/initial_version/use-cases/simple-order-process.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.