Projects/Integration AuraMuslim.co.id - Revision history

Wikiadmin: /* User Story: AURA push order to ERP */

2022-06-15T07:47:05Z

‎User Story: AURA push order to ERP

Wikiadmin: /* User Story: AURA push Sales Order to ERP */

2022-06-15T07:46:40Z

‎User Story: AURA push Sales Order to ERP

Wikiadmin: /* User Story: ERP push Goods Shipment to AURA */

2022-06-15T07:46:19Z

‎User Story: ERP push Goods Shipment to AURA

Wikiadmin: /* User Story: ERP push product baru ke AURA */

2022-06-15T07:45:44Z

‎User Story: ERP push product baru ke AURA

Wikiadmin: /* User Story: ERP push stock ke AURA */

2022-06-15T07:45:16Z

‎User Story: ERP push stock ke AURA

Wikiadmin: /* Glossary */

2022-06-15T07:44:13Z

‎Glossary

Wikiadmin: /* Meeting Rabu, 15 JUNI 2022 */

2022-06-15T07:43:30Z

‎Meeting Rabu, 15 JUNI 2022

Wikiadmin: /* Meeting Selasa, 14 JUNI 2022 */

2022-06-15T07:43:19Z

‎Meeting Selasa, 14 JUNI 2022

Wikiadmin: /* Meeting Kamis, 19 Mei 2022 */

2022-06-14T06:27:08Z

‎Meeting Kamis, 19 Mei 2022

Wikiadmin: Created page with "= Introduction =
AURA adalah lokal market place yang merupakan salah satu distributor di PT Rahmat Untuk Semua.
Integrasi ini akan menggunakan API untuk komunikasi ant..."

2022-06-14T06:25:53Z

Created page with "= Introduction = AURA adalah lokal market place yang merupakan salah satu distributor di PT Rahmat Untuk Semua. Integrasi ini akan menggunakan API untuk komunikasi ant..."

New page

= Introduction =

AURA adalah lokal market place yang merupakan salah satu distributor di PT Rahmat Untuk Semua. 
Integrasi ini akan menggunakan API untuk komunikasi antar sistem.


=Web Services API=

API main URL :
<pre>
https://HOST/infinite/org.openbravo.service.json.jsonrest/END_POINT
</pre>

Parameter umum penggunaan API yang tersedia:
{| class="wikitable"
|-
! Parameter Name !! Description
|-
| _org|| organization ID
|-
| _noCount|| count only
|-
| _onlyCount||
|-
| _filter ||
|-
| _startRow|| mengambil jumlah baris record start '''(parameter wajib untuk setiap akses endpoint)'''
|-
| _endRow|| mengambil jumlah baris record akhir '''(parameter wajib untuk setiap akses endpoint)'''
|-
| _sortBy || melakukan sorting berdasarkan field tertentu
|-
| _selectedProperties|| untuk menentukan field apa saja yang akan diquery, untuk melihat nama field tersedia, cukup lakukan GET tanpa parameter dan semua field akan tampil by default.
|-
| _where|| melakukan filter data untuk field tertentu, contoh: _where=currency.iSOCode='USD https://HOST/infinite/org.openbravo.service.json.jsonrest/Country?_where=currency.iSOCode='USD'' akan menghasilkan data nama negara yang memiliki mata uang USD
|}

Cara menggunakan parameter:
<pre>
http://HOST/infinite/org.openbravo.service.json.jsonrest/BusinessPartner?_startRow=10&_endRow=50&_sortBy=name&_selectedProperties=id,searchKey,name,description
</pre>
 
 
JSON REST API yang bisa digunakan untuk integrasi ini:

{| class="wikitable"
|-
! API Name!! End Point!! Description
|-
| Sales Order|| /Order|| Sales Order Header adalah informasi transaksi penjualan terkait Pelanggan sebagai pembeli produk
|-
| Sales Order Line|| /OrderLine|| Sales Order Line, dapat berisi lebih dari satu record data product yang dibeli oleh pelanggan
|-
| Product|| /Product||
|-
| Example || Example || Example
|-
| Example || Example || Example
|}

== [[API Sales Order|Sales Order]] ==
== Create Header ==

Contoh formas JSON untuk POST/PUT
<pre>
{
"data": [
{
"_entityName": "Order",
"documentType": "0",
"transactionDocument": "5645CA0F00874F1D92502738D06B3BA7",
"businessPartner": "1DF416E52D30419CBAF6C13C8DD27B95",
"partnerAddress": "80537B71C48742219669AF2EEA18DEE7",
"invoiceAddress": "80537B71C48742219669AF2EEA18DEE7",
"priceList": "C8E96B73984E402285D8B0CFF856420C",
"documentNo": "TEST-POSTMAN-003",
"documentStatus": "DR",
"salesTransaction": "true",
"active": "true",
"delivered": "false",
"scheduledDeliveryDate": "2022-02-02",
"orderDate": "2022-02-02",
"accountingDate": "2022-02-02",
"currency": "303",
"formOfPayment": "P",
"paymentMethod": "DACDC69551CF403D9ADBD00F63F8219F",
"paymentTerms": "27BD0BB9FBBA4E5E86F978933FD7F6DC",
"invoiceTerms": "I",
"organization": "7F844AE4060B41CDB7E943F75B76F4B2",
"warehouse": "69B6CC4F386A4BEC93906C53C16C16E5",
"deliveryMethod": "S",
"shippingCompany": "984C01BD749B4C09B618021EB6A5A618",
"description": "test dari postman"
}
]
}
</pre>

== Create Lines ==
Contoh JSON untuk POST/PUT dengan 2 product
<pre>
{
"data": [
{
"_entityName": "OrderLine",
"organization": "7F844AE4060B41CDB7E943F75B76F4B2",
"salesOrder": "ABBA15BDB60848F99D31307677826CBE",
"lineNo": 10,
"product": "2782ECBAAD57441D9E27CB447048E9EE",
"orderedQuantity": 2,
"uOM": "E4D60A0ECD0E4BAA902D9A844327B46D",
"unitPrice":90000,
"priceLimit": 100000,
"listPrice":100000,
"discount": 10000,
"lineNetAmount": 0,
"currency": "303",
"orderDate": "2022-05-28",
"scheduledDeliveryDate": "2022-05-28",
"tax": "F0EBB5B87F484A8298CE62FF87678DF8",
"warehouse": "69B6CC4F386A4BEC93906C53C16C16E5",
"description": "test dari postman"
},
{
"_entityName": "OrderLine",
"organization": "7F844AE4060B41CDB7E943F75B76F4B2",
"salesOrder": "ABBA15BDB60848F99D31307677826CBE",
"lineNo": 99,
"product": "7BA4B0FE132B420DB3222D53F61DEF3F",
"orderedQuantity": 1,
"uOM": "E4D60A0ECD0E4BAA902D9A844327B46D",
"unitPrice":200000,
"priceLimit": 200000,
"listPrice":200000,
"discount": 0,
"lineNetAmount": 0,
"currency": "303",
"orderDate": "2022-05-28",
"scheduledDeliveryDate": "2022-05-28",
"tax": "F0EBB5B87F484A8298CE62FF87678DF8",
"warehouse": "69B6CC4F386A4BEC93906C53C16C16E5",
"description": "test insert ONGKIR"
}
]
}
</pre>

=== Contoh Document Approval Sales Order ===
Contoh penggunaan Document Approval API untuk merubah Document Status di window Sales Order dapat dilihat pada link berikut: 

[[Document Approval API for Sales Order(Sample)|Document Approval API for Sales Order(Sample)]]


== [[API Stock by Storage Bin|Stock by Storage Bin]] ==

==Error Result==
Jika terjadi error, API akan memberikan standard HTTP ERROR code

=== HTTP Error Codes ===

The following HTTP error codes are used to flag different error situations:
* 400: the request uri or parameters are incorrect, for example the request uri did not have a valid entity name.
* 409: the JSON content is invalid
* 404: the object could not be found (applies when a uri points to a single object and that single object can not be found
* 401: if a security exception occurs
* 500: is used for all other exceptions

Contoh situasi umum ketika error terjadi dapat dilihat [https://wiki.infinite-erp.co.id/index.php/JSON_REST_Web_Services#JSON_Error_Result disini]

= Integration Scenario =
== User Story: AURA push order to ERP ==
# Pembeli melakukan Check Out di AURA
# Pembeli menyelesaikan pembayaran
# AURA membuat Sales Order Header di ERP dan mendapatkan response Order ID jika sukses terbentuk. Order ID ini akan digunakan selanjutnya untuk membuat Order Lines
# AURA membuat Order Lines satu per satu atau sekaligus. AURA akan mendapatkan response berupa Order Line ID jika sukses.
##Kode Unik, Diskon dan Ongkir juga dimasukkan ke Order Line di ERP. Product ID untuk ketiganya dapat berbeda di environment DEV dan LIVE
# Setelah data order terbentuk sukses di ERP, AURA memanggil endpoint Document Approval untuk merubah Document Status menjadi COMPLETED sebagai tanda bagi user ERP untuk memproses pengiriman.
##Contoh Document Approval : [[Document Approval API for Sales Order(Sample)|Document Approval API for Sales Order(Sample)]]

== User Story: ERP push Goods Shipment to AURA ==
== User Story: ERP push product baru ke AURA ==
== User Story: ERP push stock ke AURA ==

= Meeting Agreement =
== Minutes Of Meeting ==
=== Meeting Kamis, 19 Mei 2022 ===

==== Integrasi ====
* AURA push order baru ke ERP secara realtime.
* Order dari AURA memiliki beberapa status:
** Booking
** Terbayar
** Cancel
* ERP push Goods Shipment ke AURA
** Cetak Shipment Label dilakukan langsung dari ERP menggunakan ukuran label yang ada saat ini dengan beberapa modifikasi berikut:
** Penambahan Kode Booking dan Resi berbentuk barcode
** Penambahan Product SKU dan Jumlah ( saat ini sudah dibuat )
** Tulisan Disclaimer dibagian bawah "pembeli membuat video unboxing"
* ERP push product baru ke AURA
** Product baru yang push ke AURA harus di setup and assigned ke BP Sabila Mall
** AURA akan menyediakan kolom untuk menampung Product ID dari ERP yang memiliki Lenght 32 digit (data berupa UUID)
* ERP push stock ke AURA.
** Stock yang dikirim stock onhand setelah dikurangi stock di PACKING AREA

=== Struktur data order dari AURA: ===
==== Header ====
*Pembeli
**Nama
**Nomor Kontak
**Alamat | Kelurahan | Kecamatan | Kota | Propinsi | Kode Pos
*Agen
**Nama Agen | Alamat | Nomor Kontak
*Ekspedisi
** Nama Ekpedisi | Kode Booking (jika ada)

==== Line ====
* Product SKU | Jumlah | Harga
* Ongkos Kirim: Nilai ongkos kirim bagian dari Order Line

= Glossary =

* AURA = SabilaMall.co.id
* ERP = Software ERP yang digunakan oleh PT RAHMAT UNTUK SEMUA (RAHNEM)
* BP = Business Partner, istilah master data Customer/Vendor di ERP


= End =

@@ Line 178: / Line 178: @@
 ##Contoh Document Approval : [[Document Approval API for Sales Order(Sample)|Document Approval API for Sales Order(Sample)]]
-== User Story: ERP push Goods Shipment to AURA ==
+== User Story: AURA push Sales Order to ERP ==
 == User Story: AURA get product baru dari ERP ==

@@ Line 179: / Line 179: @@
 == User Story: ERP push Goods Shipment to AURA ==
-== User Story: ERP push product baru ke AURA ==
+== User Story: AURA get product baru dari ERP ==
 == User Story: AURA get stock dari ERP ==

@@ Line 188: / Line 188: @@
 ** Ahmad Nugroho - ERP Consultant
 ** Satrio Singgih - Developer AuraMuslim.id
 <p>

@@ Line 169: / Line 169: @@
 = Integration Scenario =
-== User Story: AURA push order to ERP ==
+== User Story: AURA push sales order to ERP ==
 # Pembeli melakukan Check Out di AURA
 # Pembeli menyelesaikan pembayaran

@@ Line 216: / Line 216: @@
 = Glossary =
 <p>
-* AURA = SabilaMall.co.id
+* AURA = AuraMuslim.id
 * ERP = Software ERP yang digunakan oleh PT RAHMAT UNTUK SEMUA (RAHNEM)
 * BP = Business Partner, istilah master data Customer/Vendor di ERP

@@ Line 184: / Line 184: @@
 = Meeting Agreement =
 == Minutes Of Meeting ==
-=== Meeting Selasa, 14 JUNI 2022 ===
+=== Meeting Rabu, 15 JUNI 2022 ===
-==== Integrasi ====
+<p>
 === Struktur data order dari AURA: ===