⦃Param⦄
Search…
The Protocol
Developer Resources
Commerce Data Interchange Format
Standard behind the semantic blockchain.
EDI on Blockchain
Enterprises have recognised the need for standardisation of documents that are shared across organisation, to enable process automation. Hence, today standards like EDI is a common practise to share across large enterprises. However EDI solution come with infrastructure overhead and the document shared are flat files.
As ⦃param⦄ provides an EDI like capabilities in the form of permissioned public blockchain network for enterprises of all sizes to collaborate and share documents in a well structured format called JSON-LinkedData, referred as Commerce Data Interchange Format (CDIF).
JSON-LinkedData as CDIF
JSON-LinkedData is originally created as a standard for Semantic web. This is now, can be very well extended for establishing machine-readable data on the commerce blockchain. We can enhance the data links by adding supporting documents such as Catalogues, Booking Tickets, Payments, Shipments, etc...
A valid Invoice described using schema.org's (modified) JSON-LD structure:
1
{
2
"@context": "http://schema.org/",
3
"@type": "Invoice",
4
"provider": { #Optionally details are included for the first time invoices between B2B
5
"@type": "Organization",
6
"@id": "0x131783612317312678316238172376",
7
"address": {
8
"@type": "PostalAddress",
9
"@id": "0x131783612317312678316238172376",
10
"addressLocality": "Seattle",
11
"addressRegion": "WA",
12
"postalCode": "98052",
13
"streetAddress": "20341 Whitworth Institute 405 N. Whitworth"
14
},
15
"employee": {
16
"@type": "Person",
17
"@id": "0x131783612317312678316238172376",
18
"name": "Jane Doe - Point of Contact"
19
},
20
"email": "mailto:[email protected]",
21
"name": "Divum Labs Pvt. Ltd.",
22
"telephone": "(425) 123-4567",
23
"faxNumber":"(425) 123-4569"
24
},
25
"customer": { #Optionally details are included for the first time invoices between B2B
26
"@type": "Organization",
27
"@id": "0x131783612317312678316238172376",
28
"address": {
29
"@type": "PostalAddress",
30
"@id": "0x131783612317312678316238172376",
31
"addressLocality": "Seattle",
32
"addressRegion": "WA",
33
"postalCode": "98052",
34
"streetAddress": "20341 Whitworth Institute 405 N. Whitworth"
35
},
36
"employee": {
37
"@type": "Person",
38
"@id": "0x131783612317312678316238172376",
39
"name": "Jane Doe - Point of Contact"
40
},
41
"email": "mailto:[email protected]",
42
"name": "Customer of this Receipt Inc.",
43
"telephone": "(425) 123-7654",
44
"faxNumber": "(425) 123-7659"
45
},
46
"referencesOrder": {
47
"@type": "Order",
48
"orderDate": "2014-12-01",
49
"orderNumber": "123ABC", # receipt / document id. As it is autogenerated, this field will be missing in txn argument
50
"paymentMethod": "#ByInvoice",
51
"orderedItem": [
52
{
53
"@type": "OrderItem",
54
"@id": "<receiptId>_<index>", // managed by events handler
55
"orderQuantity": 1,
56
"orderedItem": {
57
"@type": "Product",
58
"@id": "0x131783612317312678316238172376",
59
"name": "Sony 101.4 cm TV",
60
"mpn": 101, //Optional
61
"productID": "sony123",
62
"gtin8": "", //Unique id for product....
63
"offers": {
64
"@type": "Offer",
65
"priceCurrency": "USD",
66
"price": 44999,
67
"priceValidUntil": "2020-11-05", //Optinal
68
"itemCondition": "NewCondition", //Optinal
69
"availability": "InStock",//Optinal
70
}
71
}
72
},
73
# Second Item
74
{
75
"@type": "OrderItem",
76
"@id": "<receiptId>_<index>", // managed by events handler
77
"orderQuantity": 2,
78
"orderedItem": {
79
"@type": "Product",
80
"@id": "0x131783612317312678316238172376",
81
"name": "Samsung 101.4 cm TV",
82
"mpn": 101, //Optional
83
"productID": "sam123",
84
"gtin8": "", //Unique id for product....
85
"offers": {
86
"@type": "Offer",
87
"priceCurrency": "USD",
88
"price": 44999,
89
"priceValidUntil": "2020-11-05", //Optinal
90
"itemCondition": "NewCondition" //Optinal
91
}
92
}
93
}
94
]
95
},
96
"minimumPaymentDue": {
97
"@type": "PriceSpecification",
98
"price": 44999000,
99
"priceCurrency": "USD"
100
},
101
"totalPaymentDue": {
102
"@type": "PriceSpecification",
103
"price": 44999000,
104
"priceCurrency": "USD"
105
}
106
}
Copied!
ERP Integration
⦃param⦄ aim to provide standard convertors for direct ERP integration. Where convertors will plugin to systems like SAP, Zoho Books, connect via standard API interfaces to translate the native ERP formats into CDIF compatible to ⦃param⦄ CLI and API.
Knowledge Extension
One could extend the knowledge of the commerce transaction by adding more standard documents. For example:
- Online Travel Agent could add Schema.org complaint Invoice -> Ticket -> Seat Booking by Airline operator.
Each knowledge extension transaction will go through schema validation at the node-level before the transaction is sent on the network.
External References