Skip to content

Connectors

Here you can find different "connectors" to connect to other data-sources or intelligence-Apps. Currently there is only a connector for bank. But stay tuned we work on way more connectors.

Condition

Here you can find the states of different connectors

  • Methode: GET
  • Path: /api/user/connector/condition
  • Header: X-FINO-Authorization : Bearer <JWT-AccessToken>

expected response:

{
    "status": {
        "message": "OK"
    },
    "data": {
        "states": {
            "XS2A": "bool",
            "GMI": "bool",
            ...
        }
    },
    "code": 200
}

BankAccount

Here you can find all endpoints to interact with the bank-account.

Connect bank-account

Connect a bank-account so that FINUX can help you to find some important information.

  • Methode: POST
  • Path: /api/user/connector/bank/account
  • Header: X-FINO-Authorization : Bearer <JWT-AccessToken>

expected request:

{
  "bankCode": "string",
  "extraSecret": "string",
  "saveSecret": "true",
  "secret": "string",
  "username": "string"
}

expected response:

{
    "status": {
        "message": "OK"
    },
    "code": 200,
    "data": nil
}

custom errors:

{
    {
        "status": {
            "message": "keyToi18nText"
        },
        "data": null,
        "code": 473
    }
}

or provider error:

{
    {
        "status": {
            "message": "ProviderMessage"
        },
        "data": null,
        "code": 422
    }
}

Get all bank-accounts

Get infromations about the connected bank account(s)

  • Methode: GET
  • Path: /api/user/connector/bank/account
  • Header: X-FINO-Authorization : Bearer <JWT-AccessToken> (optional)
  • Query: includeTransactions="bool" default is true with limit of 100 transactions limit="uint" offset="uint"

expected response:

{
    "status": {
        "message": "OK"
    },
    "code": 200,
    "data": {
        "accounts": [
            {
                "accountId": "string",
                "accountNumber": "string",
                "balance": "float64",
                "bankCode": "string",
                "bankLoginId": "string",
                "bankName": "string",
                "bic": "string",
                "creditLine": "float64",
                "currency": "string",
                "iban": "string",
                "icon": "string",
                "monthlySpendingLimit": "float64",
                "name": "string",
                "owner": "string",
                "isActive": "bool",
                "pagination": {
                    "limit": "uint",
                    "offset": "uint",
                    "total": "uint"
                 }
                "tags": [
                    "string"
                ],
                "transactions": [
                    {
                        "accountId": "string",
                        "amount": "float64",
                        "bookingText": "string",
                        "creditorId": "string",
                        "currency": "string",
                        "dateOfTransaction": "int64",
                        "mref": "string",
                        "paymentPartner": {
                            "bic": "string",
                            "creditorId": "string",
                            "iban": "string",
                            "name": "string"
                        },
                        "purpose": "string",
                        "sepaPurposeCode": "string",
                        "transactionCode": "int64",
                        "transactionId": "string",
                        "typeOfDebit": "string",
                        "typeOfTransaction": "string",
                        "tags": [
                            "string"
                        ]
                    }
                ],
                "type": "string"
            }
        ],
        "timestampLastSync": "int",
        "usedProvider": "string"
    }
}

Get specific bank-account

Get information about a specific bank-account. For that you need a accountid.

  • Methode: GET
  • Path: /api/user/connector/bank/account/{accountid}
  • Header: X-FINO-Authorization : Bearer <JWT-AccessToken> (optional)
  • Query: default with limit of 100 transactions limit="uint" offset="uint"

expected response:

{
    "status": {
        "message": "OK"
    },
    "code": 200,
    "data": {
       "account": {
           "accountId": "string",
           "accountNumber": "string",
           "balance": "float64",
           "bankCode": "string",
           "bankLoginId": "string",
           "bankName": "string",
           "bic": "string",
           "creditLine": "float64",
           "currency": "string",
           "iban": "string",
           "icon": "string",
           "monthlySpendingLimit": "float64",
           "name": "string",
           "owner": "string",
           "tags": [
                "string"
            ],
            "pagination": {
                "limit": "uint",
                "offset": "uint",
                "total": "uint"
             }
           "transactions": [
               {
                   "accountId": "string",
                   "amount": "float64",
                   "bookingText": "string",
                   "creditorId": "string",
                   "currency": "string",
                   "dateOfTransaction": "int64",
                   "mref": "string",
                   "paymentPartner": {
                       "bic": "string",
                       "creditorId": "string",
                       "iban": "string",
                       "name": "string"
                   },
                   "purpose": "string",
                   "sepaPurposeCode": "string",
                   "transactionCode": "int64",
                   "transactionId": "string",
                   "typeOfDebit": "string",
                   "typeOfTransaction": "string",
                   "tags": [
                        "string"
                    ]
               }
               "type": "string"
           }
        }
    }
}

custom errors:

{
    {
        "status": {
            "message": "keyToi18nText"
        },
        "data": null,
        "code": 473
    }
}

or provider error:

{
    {
        "status": {
            "message": "ProviderMessage"
        },
        "data": null,
        "code": 422
    }
}

Disconnect specific bank-account

Disconnect a specific bank-account.

  • Methode: DELETE
  • Path: /api/user/connector/bank/login/{bankloginid}
  • Header: X-FINO-Authorization : Bearer <JWT-AccessToken>

expected response:

{
    "status": {
        "message": "OK"
    },
    "code": 200,
    "data": nil
}

custom errors:

{
    {
        "status": {
            "message": "keyToi18nText"
        },
        "data": null,
        "code": 473
    }
}

or provider error:

{
    {
        "status": {
            "message": "ProviderMessage"
        },
        "data": null,
        "code": 422
    }
}

Change account selection

Changing selection for accounts has impact to forecast, smart-alerts and top-partner and supplier

  • Methode: PATCH
  • Path: /api/user/connector/bank/accountids
  • Header: X-FINO-Authorization : Bearer <JWT-AccessToken>

expected request:

{
    "data" :[
        {
            "accountID": "string",
            "flag": "bool"
        }
    ]
}

expected response:

{
    "status": {
        "message": "OK"
    },
    "code": 200,
    "data": nil
}

custom errors:

{
    {
        "status": {
            "message": "keyToi18nText"
        },
        "data": null,
        "code": 473
    }
}

or provider error:

{
    {
        "status": {
            "message": "ProviderMessage"
        },
        "data": null,
        "code": 422
    }
}

getMyInvoices

get-my-invoices

Use GetMyInvoices to fetch all invoices from users GMI accout.

Add GMI-Account-AccessToken

To add users GMI-Account, the accessToken is needed.

  • Methode: POST
  • Path: /api/user/connector/gmi/account
  • Header: X-FINO-Authorization : Bearer <JWT-AccessToken>

expected request:

{
    "token": "string",
    "name": "string"
}

expected response:

{
    "status": {
        "message": "OK"
    },
    "code": 200,
    "data": nil
}

Delete GMI-Account-AccessToken

To delete a gmi access token

  • Methode: DELETE
  • Path: /api/user/connector/gmi/account/{token}
  • Header: X-FINO-Authorization : Bearer <JWT-AccessToken>

expected response:

{
    "status": {
        "message": "OK"
    },
    "code": 200,
    "data": nil
}

Get All GMI-Account-AccessToken

To get all gmi account token with name

  • Methode: GET
  • Path: /api/user/connector/gmi/account
  • Header: X-FINO-Authorization : Bearer <JWT-AccessToken>

expected response:

{
    "status": {
        "message": "OK"
    },
    "data": {
        "accessToken": [
            {
                "token": "string",
                "name":  "string",
                "valid": "bool"
            }
        ]
    },
    "code": 200
}

Update GMI-Account-AccessToken Name

To update a gmi access token name

  • Methode: PATCH
  • Path: /api/user/connector/gmi/account
  • Header: X-FINO-Authorization : Bearer <JWT-AccessToken>

expected response:

{
    "token": "string",
    "name": "string"
}

Get all invoices

  • Methode: GET
  • Path: /api/user/connector/gmi/invoices
  • Header: X-FINO-Authorization : Bearer <JWT-AccessToken>

expected response:

{
   "status":{
      "message": "OK"
   },
   "code":200,
   "data":[
        {
            "primUid": "string",
            "supplierUid": "string",
            "invoiceNumber": "string",
            "invoiceDate": "string",
            "invoiceDueDate": "string",
            "netAmount": "string",
            "vat": "string",
            "grossAmount": "string",
            "currency": "string",
            "isArchived": "string",
            "isOcrCompleted": "int",
            "tags": "string",
            "note": "string",
            "source": "string",
            "filename": "string",
            "fileSize": "string",
            "paymentStatus": "string",
            "paymentMethod": "string",
            "paymentDetails": {
                "iban": "string",
                "bic": "string",
                "accountHolderName": "string",
                "accountNumber": "string",
                "bankName": "string",
                "bankAddress": "string",
                "sortCode": "string",
                "routingNumber": "string",
                "ifscCode": "string",
                "routingCode": "string"
            },
            "transactions": [
                {
                "accountId": "string",
                "amount": "float64",
                "bookingText": "string",
                "creditorId": "string",
                "currency": "string",
                "dateOfTransaction": "int64",
                "mref": "string",
                "paymentPartner": {
                    "bic": "string",
                    "creditorId": "string",
                    "iban": "string",
                    "name": "string"
                },
                "purpose": "string",
                "sepaPurposeCode": "string",
                "transactionCode": "int64",
                "transactionId": "string",
                "typeOfDebit": "string",
                "typeOfTransaction": "string"
                }
            ],
        }
    ]
}