Difference between revisions of "Projects/Integration Moota.co"

From InfiniteERP Wiki
Jump to: navigation, search
(Created page with "=Introduction= <p> [https://moota.co Moota] merupakan aplikasi untuk pengecekkan mutasi dan saldo rekening Anda, dimana mutasi rekening Anda kami dapatkan dari akun iBanking A...")
 
(Get Mutasi Rekening)
 
(23 intermediate revisions by the same user not shown)
Line 5: Line 5:
  
 
= Integration overview =
 
= Integration overview =
The focus of this integration is to create a system where [http://www.infinite-erp.co.id InfiniteERP] is the central repository of data. Products, categories and orders are maintained and other application or services has the ability to operate with the products catalog downloaded from InfiniteERP and to upload such as orders or other transaction created through Web Services/API. <br><br>
+
<p>
 +
Fokus dari integrasi ini adalah otomasi proses  sinkronisasi data mutasi rekening bank yang terdaftar di layanan Moota oleh client pengguna InfiniteERP sebagai pemilik rekening.
 +
Data mutasi rekening secara terjadwal akan di dowload dari Moota via API web services dan akan dihubungkan dengan rekening bank yang terdaftar di window Financial Account
 +
</p>
 +
<p>
 +
Pelanggan pengguna ERP harus mendaftarkan akun internet banking di Moota secara langsung dan membuat token yang kemudian digunakan oleh ERP untuk akses ke data mutasi rekening tersebut.
 +
InfiniteERP tidak perlu tahu dan tidak akan meminta informasi user id atau user account termasuk password dan lainnya kecuali hanya token yang di buat oleh Pelanggan ERP. InfiniteERP juga tidak bertanggung jawab atas apa yang terjadi di layanan Moota karena Moota bukan bagian dari InfiniteERP.
 +
</p>
 +
'''Contoh tampilan membuat token di layanan Moota:'''<br>
 +
[[image:Moota_create_token_1.png||600px]]
 +
<br><br>
 +
'''Contoh tampilan mendaftarkan Webhoook di layanan Moota:'''<br>
 +
[[image:Moota_create_webhook_1.png||600px]]
  
This integration has been developed with webservices. [http://www.infinite-erp.co.id InfiniteERP] has two webservice endpoints called ExternalSales and WebService.
+
= Integration Scenario =
 +
<p>
 +
Terdapat 2 metode integrasi yang disediakan oleh Moota:
 +
# Webhook<br>Infinite ERP membuat Webhook dan akan didaftarkan ke Moota, kemudian setiap ada mutasi rekening, Moota akan memberikan notifikasi ke webhook, metode ini lebih mendekati realtime karena Moota akan secara otomatis push notifikasi.
 +
# API<br>Dengan metode ini, InfiniteERP secara terjadwal download dari Moota dengan Background Process
 +
</p>
 +
Saat ini InfiniteERP belum menyediakan Webhook, dan akan menggunakan API untuk integrasi.
 +
 
 +
=API Moota =
 +
== Get Mutasi Rekening ==
 +
 
 +
Endpoint:<br>
 +
<pre>
 +
https://app.moota.co/api/v2/mutation?start_date=2022-06-12&end_date=2022-06-13
 +
</pre>
 +
Response JSON:<br>
 +
 
 +
<pre>
 +
{
 +
    "current_page": 1,
 +
    "data": [
 +
        {
 +
            "account_number": "1090014XXXX",
 +
            "date": "2022-06-12 00:00:00",
 +
            "description": "Payment:1001926 1001926 MCM InhouseTrf CS-CS KE AGUS KURNIAWAN",
 +
            "amount": "452000.00",
 +
            "type": "DB",
 +
            "note": "",
 +
            "balance": "100704307.78",
 +
            "created_at": "2022-06-12 22:55:40",
 +
            "updated_at": "2022-06-12 22:55:40",
 +
            "mutation_id": "1KkLG5GYpWP",
 +
            "token": "1KkLG5GYpWP",
 +
            "bank_id": "epokOpYDzaJ",
 +
            "taggings": [],
 +
            "bank": {
 +
                "corporate_id": "id_perusahaan",
 +
                "username": "user_internet_banking",
 +
                "atas_nama": "ASIA SURYA PERSADA",
 +
                "balance": "100704307.78",
 +
                "account_number": "1090014996540",
 +
                "bank_type": "mandiriBisnisV2",
 +
                "pkg": null,
 +
                "login_retry": 0,
 +
                "date_from": "2022-06-15 00:00:00",
 +
                "date_to": "2022-06-15 00:00:00",
 +
                "meta": {
 +
                    "session_id": "f788c98f-b3f3-492b-835a-ab90126d832d",
 +
                    "activity_summary": "User gagal login"
 +
                },
 +
                "interval_refresh": 15,
 +
                "next_queue": "2022-06-15 08:23:13",
 +
                "is_active": true,
 +
                "in_queue": 0,
 +
                "in_progress": 0,
 +
                "is_crawling": 1,
 +
                "recurred_at": "2022-06-16 00:49:04",
 +
                "created_at": "2022-06-02 09:57:17",
 +
                "token": "epokOpYDzaJ",
 +
                "bank_id": "epokOpYDzaJ",
 +
                "label": "Mandiri Bisnis",
 +
                "last_update": "2022-06-15T01:08:13.000000Z",
 +
                "icon": "https://app.moota.co/images/icon-bank-mandiriBisnisV2.png"
 +
            }
 +
        },
 +
        {
 +
            "account_number": "1090014XXXX",
 +
            "date": "2022-06-12 00:00:00",
 +
            "description": "Payment:1001928 1001928 MCM InhouseTrf CS-CS KE LUQMAN RIJALLUDIEN",
 +
            "amount": "93000.00",
 +
            "type": "DB",
 +
            "note": "",
 +
            "balance": "100704307.78",
 +
            "created_at": "2022-06-12 22:55:40",
 +
            "updated_at": "2022-06-12 22:55:40",
 +
            "mutation_id": "pokOO6OKyka",
 +
            "token": "pokOO6OKyka",
 +
            "bank_id": "epokOpYDzaJ",
 +
            "taggings": [],
 +
            "bank": {
 +
                "corporate_id": "id_perusahaan",
 +
                "username": "user_internet_banking",
 +
                "atas_nama": "ASIA SURYA PERSADA",
 +
                "balance": "100704307.78",
 +
                "account_number": "1090014996540",
 +
                "bank_type": "mandiriBisnisV2",
 +
                "pkg": null,
 +
                "login_retry": 0,
 +
                "date_from": "2022-06-15 00:00:00",
 +
                "date_to": "2022-06-15 00:00:00",
 +
                "meta": {
 +
                    "session_id": "f788c98f-b3f3-492b-835a-ab90126d832d",
 +
                    "activity_summary": "User gagal login"
 +
                },
 +
                "interval_refresh": 15,
 +
                "next_queue": "2022-06-15 08:23:13",
 +
                "is_active": true,
 +
                "in_queue": 0,
 +
                "in_progress": 0,
 +
                "is_crawling": 1,
 +
                "recurred_at": "2022-06-16 00:49:04",
 +
                "created_at": "2022-06-02 09:57:17",
 +
                "token": "epokOpYDzaJ",
 +
                "bank_id": "epokOpYDzaJ",
 +
                "label": "Mandiri Bisnis",
 +
                "last_update": "2022-06-15T01:08:13.000000Z",
 +
                "icon": "https://app.moota.co/images/icon-bank-mandiriBisnisV2.png"
 +
            }
 +
        },
 +
        {
 +
            "account_number": "1090014XXXX",
 +
            "date": "2022-06-12 00:00:00",
 +
            "description": "PAYMENT:1001927 1001927 MCM InhouseTrf CS-CS KE HENDRA NUGRAHA",
 +
            "amount": "526000.00",
 +
            "type": "DB",
 +
            "note": "",
 +
            "balance": "100704307.78",
 +
            "created_at": "2022-06-12 22:55:40",
 +
            "updated_at": "2022-06-12 22:55:40",
 +
            "mutation_id": "eMkboYoKBzY",
 +
            "token": "eMkboYoKBzY",
 +
            "bank_id": "epokOpYDzaJ",
 +
            "taggings": [],
 +
            "bank": {
 +
                "corporate_id": "id_perusahaan",
 +
                "username": "user_internet_banking",
 +
                "atas_nama": "ASIA SURYA PERSADA",
 +
                "balance": "100704307.78",
 +
                "account_number": "1090014996540",
 +
                "bank_type": "mandiriBisnisV2",
 +
                "pkg": null,
 +
                "login_retry": 0,
 +
                "date_from": "2022-06-15 00:00:00",
 +
                "date_to": "2022-06-15 00:00:00",
 +
                "meta": {
 +
                    "session_id": "f788c98f-b3f3-492b-835a-ab90126d832d",
 +
                    "activity_summary": "User gagal login"
 +
                },
 +
                "interval_refresh": 15,
 +
                "next_queue": "2022-06-15 08:23:13",
 +
                "is_active": true,
 +
                "in_queue": 0,
 +
                "in_progress": 0,
 +
                "is_crawling": 1,
 +
                "recurred_at": "2022-06-16 00:49:04",
 +
                "created_at": "2022-06-02 09:57:17",
 +
                "token": "epokOpYDzaJ",
 +
                "bank_id": "epokOpYDzaJ",
 +
                "label": "Mandiri Bisnis",
 +
                "last_update": "2022-06-15T01:08:13.000000Z",
 +
                "icon": "https://app.moota.co/images/icon-bank-mandiriBisnisV2.png"
 +
            }
 +
        }
 +
    ],
 +
    "first_page_url": "https://app.moota.co/api/v2/mutation?page=1",
 +
    "from": 1,
 +
    "last_page": 1,
 +
    "last_page_url": "https://app.moota.co/api/v2/mutation?page=1",
 +
    "links": [
 +
        {
 +
            "url": null,
 +
            "label": "Sebelumnya",
 +
            "active": false
 +
        },
 +
        {
 +
            "url": "https://app.moota.co/api/v2/mutation?page=1",
 +
            "label": "1",
 +
            "active": true
 +
        },
 +
        {
 +
            "url": null,
 +
            "label": "Selanjutnya",
 +
            "active": false
 +
        }
 +
    ],
 +
    "next_page_url": null,
 +
    "path": "https://app.moota.co/api/v2/mutation",
 +
    "per_page": 20,
 +
    "prev_page_url": null,
 +
    "to": 3,
 +
    "total": 3
 +
}
 +
</p>

Latest revision as of 00:40, 20 June 2022

Introduction

Moota merupakan aplikasi untuk pengecekkan mutasi dan saldo rekening Anda, dimana mutasi rekening Anda kami dapatkan dari akun iBanking Anda.

Integration overview

Fokus dari integrasi ini adalah otomasi proses sinkronisasi data mutasi rekening bank yang terdaftar di layanan Moota oleh client pengguna InfiniteERP sebagai pemilik rekening. Data mutasi rekening secara terjadwal akan di dowload dari Moota via API web services dan akan dihubungkan dengan rekening bank yang terdaftar di window Financial Account

Pelanggan pengguna ERP harus mendaftarkan akun internet banking di Moota secara langsung dan membuat token yang kemudian digunakan oleh ERP untuk akses ke data mutasi rekening tersebut. InfiniteERP tidak perlu tahu dan tidak akan meminta informasi user id atau user account termasuk password dan lainnya kecuali hanya token yang di buat oleh Pelanggan ERP. InfiniteERP juga tidak bertanggung jawab atas apa yang terjadi di layanan Moota karena Moota bukan bagian dari InfiniteERP.

Contoh tampilan membuat token di layanan Moota:
Moota create token 1.png

Contoh tampilan mendaftarkan Webhoook di layanan Moota:
Moota create webhook 1.png

Integration Scenario

Terdapat 2 metode integrasi yang disediakan oleh Moota:

  1. Webhook
    Infinite ERP membuat Webhook dan akan didaftarkan ke Moota, kemudian setiap ada mutasi rekening, Moota akan memberikan notifikasi ke webhook, metode ini lebih mendekati realtime karena Moota akan secara otomatis push notifikasi.
  2. API
    Dengan metode ini, InfiniteERP secara terjadwal download dari Moota dengan Background Process

Saat ini InfiniteERP belum menyediakan Webhook, dan akan menggunakan API untuk integrasi.

API Moota

Get Mutasi Rekening

Endpoint:

https://app.moota.co/api/v2/mutation?start_date=2022-06-12&end_date=2022-06-13

Response JSON:

{
    "current_page": 1,
    "data": [
        {
            "account_number": "1090014XXXX",
            "date": "2022-06-12 00:00:00",
            "description": "Payment:1001926 1001926 MCM InhouseTrf CS-CS KE AGUS KURNIAWAN",
            "amount": "452000.00",
            "type": "DB",
            "note": "",
            "balance": "100704307.78",
            "created_at": "2022-06-12 22:55:40",
            "updated_at": "2022-06-12 22:55:40",
            "mutation_id": "1KkLG5GYpWP",
            "token": "1KkLG5GYpWP",
            "bank_id": "epokOpYDzaJ",
            "taggings": [],
            "bank": {
                "corporate_id": "id_perusahaan",
                "username": "user_internet_banking",
                "atas_nama": "ASIA SURYA PERSADA",
                "balance": "100704307.78",
                "account_number": "1090014996540",
                "bank_type": "mandiriBisnisV2",
                "pkg": null,
                "login_retry": 0,
                "date_from": "2022-06-15 00:00:00",
                "date_to": "2022-06-15 00:00:00",
                "meta": {
                    "session_id": "f788c98f-b3f3-492b-835a-ab90126d832d",
                    "activity_summary": "User gagal login"
                },
                "interval_refresh": 15,
                "next_queue": "2022-06-15 08:23:13",
                "is_active": true,
                "in_queue": 0,
                "in_progress": 0,
                "is_crawling": 1,
                "recurred_at": "2022-06-16 00:49:04",
                "created_at": "2022-06-02 09:57:17",
                "token": "epokOpYDzaJ",
                "bank_id": "epokOpYDzaJ",
                "label": "Mandiri Bisnis",
                "last_update": "2022-06-15T01:08:13.000000Z",
                "icon": "https://app.moota.co/images/icon-bank-mandiriBisnisV2.png"
            }
        },
        {
            "account_number": "1090014XXXX",
            "date": "2022-06-12 00:00:00",
            "description": "Payment:1001928 1001928 MCM InhouseTrf CS-CS KE LUQMAN RIJALLUDIEN",
            "amount": "93000.00",
            "type": "DB",
            "note": "",
            "balance": "100704307.78",
            "created_at": "2022-06-12 22:55:40",
            "updated_at": "2022-06-12 22:55:40",
            "mutation_id": "pokOO6OKyka",
            "token": "pokOO6OKyka",
            "bank_id": "epokOpYDzaJ",
            "taggings": [],
            "bank": {
                "corporate_id": "id_perusahaan",
                "username": "user_internet_banking",
                "atas_nama": "ASIA SURYA PERSADA",
                "balance": "100704307.78",
                "account_number": "1090014996540",
                "bank_type": "mandiriBisnisV2",
                "pkg": null,
                "login_retry": 0,
                "date_from": "2022-06-15 00:00:00",
                "date_to": "2022-06-15 00:00:00",
                "meta": {
                    "session_id": "f788c98f-b3f3-492b-835a-ab90126d832d",
                    "activity_summary": "User gagal login"
                },
                "interval_refresh": 15,
                "next_queue": "2022-06-15 08:23:13",
                "is_active": true,
                "in_queue": 0,
                "in_progress": 0,
                "is_crawling": 1,
                "recurred_at": "2022-06-16 00:49:04",
                "created_at": "2022-06-02 09:57:17",
                "token": "epokOpYDzaJ",
                "bank_id": "epokOpYDzaJ",
                "label": "Mandiri Bisnis",
                "last_update": "2022-06-15T01:08:13.000000Z",
                "icon": "https://app.moota.co/images/icon-bank-mandiriBisnisV2.png"
            }
        },
        {
            "account_number": "1090014XXXX",
            "date": "2022-06-12 00:00:00",
            "description": "PAYMENT:1001927 1001927 MCM InhouseTrf CS-CS KE HENDRA NUGRAHA",
            "amount": "526000.00",
            "type": "DB",
            "note": "",
            "balance": "100704307.78",
            "created_at": "2022-06-12 22:55:40",
            "updated_at": "2022-06-12 22:55:40",
            "mutation_id": "eMkboYoKBzY",
            "token": "eMkboYoKBzY",
            "bank_id": "epokOpYDzaJ",
            "taggings": [],
            "bank": {
                "corporate_id": "id_perusahaan",
                "username": "user_internet_banking",
                "atas_nama": "ASIA SURYA PERSADA",
                "balance": "100704307.78",
                "account_number": "1090014996540",
                "bank_type": "mandiriBisnisV2",
                "pkg": null,
                "login_retry": 0,
                "date_from": "2022-06-15 00:00:00",
                "date_to": "2022-06-15 00:00:00",
                "meta": {
                    "session_id": "f788c98f-b3f3-492b-835a-ab90126d832d",
                    "activity_summary": "User gagal login"
                },
                "interval_refresh": 15,
                "next_queue": "2022-06-15 08:23:13",
                "is_active": true,
                "in_queue": 0,
                "in_progress": 0,
                "is_crawling": 1,
                "recurred_at": "2022-06-16 00:49:04",
                "created_at": "2022-06-02 09:57:17",
                "token": "epokOpYDzaJ",
                "bank_id": "epokOpYDzaJ",
                "label": "Mandiri Bisnis",
                "last_update": "2022-06-15T01:08:13.000000Z",
                "icon": "https://app.moota.co/images/icon-bank-mandiriBisnisV2.png"
            }
        }
    ],
    "first_page_url": "https://app.moota.co/api/v2/mutation?page=1",
    "from": 1,
    "last_page": 1,
    "last_page_url": "https://app.moota.co/api/v2/mutation?page=1",
    "links": [
        {
            "url": null,
            "label": "Sebelumnya",
            "active": false
        },
        {
            "url": "https://app.moota.co/api/v2/mutation?page=1",
            "label": "1",
            "active": true
        },
        {
            "url": null,
            "label": "Selanjutnya",
            "active": false
        }
    ],
    "next_page_url": null,
    "path": "https://app.moota.co/api/v2/mutation",
    "per_page": 20,
    "prev_page_url": null,
    "to": 3,
    "total": 3
}