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.

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.

<!-- 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>[e-mail]</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>[e-mail]</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>[e-mail]</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>[e-mail]</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>[e-mail]</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>[e-mail]</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