Technical Guide

Authentifizierung

Auth0-Konfiguration

Für die Authentifizierung wird eine «Infoniqa Cloud Identity» -ID benötigt. Die InfoniqaCloud Identity und REST-API sind basierend auf Auth0. Sie finden Beispiele und weitere Informationen unter https://auth0.com.

Für jeden Applikationstyp (Web Application, Mobile App oder Desktop App) braucht es folgende Auth0-Konfiguration:

Auth0-Parameter	Beschreibung
Domain	Authorization-URL von der Infoniqa Cloud Identity
ClientId	Client-Identität von der Applikation
Audience	Die eindeutige Kennung der Applikation für ein ausgestelltes Token
Scope	Benutzerdefinierter API-Bereich mit Zugriffsrechten Beispiel: readwrite_access Beispiel mit Refresh-Token: readwrite_access offline_access

Verknüpfung ONE 50 Benutzer

Genauere Informationen über die Verknüpfung One 50 Benutzer mit InfoniqaCloud Identity finden Sie im Abschnitt InfoniqaCloud Identity.

Common (Allgemein)

Verfügbare Ressourcen

	GET (Lesen)	POST (Neu Erstellen)	PUT (Aktualisieren)	DELETE (Löschen)
Accounts (Konten)	X
Addresses (Adressen)	X	X
CostCenterCostUnits (Kostenstellen)	X
Currencies (Währungen)	X
ExchangeRates (Kurse)	X
FinancialYears (Geschäftsjahre)	X
PaymentTerms (Zahlungskonditionen)	X
TaxRates (Steuersätze)	X
Tenants (Mandanten)	X
TextTypes (Text-Typen)	X

Accounts (Konten)

Mit dieser Ressource können die Konten aus Infoniqa One 50 ermittelt werden.

Übersicht Daten-Model

Account:

Nummer	DTO-Feldname	True/False Flag	ONE 50 GUI-Feldname
1	AccountId		Kontonummer
2	Name		Bezeichnung
3	CurrencyId		Währung
4	AccountType		Kontotyp
5	CostCenterCostUnitId		KST/KTR Direktverbuchen
6	TaxRateId		Steuersatz
7	IsForeignCurrencyAccount	X	Frendwährungskonto
8	IsDebitAccount	X	Kontotyp (Soll/Haben)
9	IsLockedForDirectBooking	X	Konto für direktbuchungen gesperrt
	ReturnStates

Applikation FINANZ: Funktion «Bearbeiten, Konto»

Addresses (Adressen)

Mit dieser Ressource können die Adressen aus ONE 50 ermittelt werden.

Übersicht Daten-Model

Address:

Nummer	DTO-Feldname	Nur ONE 50	ONE 50 GUI-Feldname
1	AddressId		Nummer
2	MatchCode		Kurzname
3	Title		Anrede
4	TitlePersonal		Briefanrede
5	Name		Firma/Name
6	Address1		Zusatz 1
7	Address2		Zusatz 2
8	Address3		Strasse
9	PostalCode		PLZ
10	City		Ort
11	CountryId		Land
12	LanguageId		Sprachcode *1
13	PhoneNumber1		Tel G
14	PhoneNumber2		Tel P
15	Mobile		Natel
16	Fax		Fax
17	EMail		E-Mail
18	Internet		URL(www)
	ReturnStates

 

*1 Folgende Sprachcodes sind erlaubt

Sprachcode	Sprache
2055	Deutsch Schweiz
1031	Deutsch Deutschland
4108	Französisch Schweiz
2064	Italienisch Schweiz
2057	Englisch Grossbritannien

 

Applikation FINANZ: Funktion «Bearbeiten, Adressen»

 

CostCenterCostUnits (Kostenstellen / Kostenträger)

Mit dieser Ressource können die Kostenstellen / Kostenträger aus ONE 50 ermittelt werden.

Übersicht Daten-Model

CostCenterCostUnit:

Nummer	DTO-Feldname	Nur ONE 50	ONE 50 GUI-Feldname
1	CostCenterCostUnitId		Nummer
2	Name		Bezeichnung
3	CostCenterType		Typ
	ReturnStates

Applikation FINANZ: Funktion «Bearbeiten, Kostenstellen/-träger»

 

Currencies (Währungen)

Mit dieser Ressource können die Währungen aus ONE 50 ermittelt werden.

Übersicht Daten-Model

Currency:

Nummer	DTO-Feldname	Nur ONE 200	ONE 50 GUI-Feldname
1	CurrencyId		ISO
2	Name		Bezeichnung
3	FixedExchangeRate		Kurs
4	UnitFactor		Einheit
6	TypeCurrencyStateId		Status
	ReturnStates

Applikation FINANZ: Funktion «Bearbeiten, Fremdwährungen»

ExchangeRates (Kurse)

Mit dieser Ressource können die Währungskurse aus ONE 50 ermittelt werden.

Übersicht Daten-Model

ExchangeRate:

Nummer	DTO-Feldname	Nur ONE 50	ONE  50 GUI-Feldname
1	CurrencyId		Währung
2	ValidFromDate		Gültig ab
3	ExchangeRateValue		(Geldkurs + Briefkurs)/2
	ReturnStates

Applikation FINANZ: Funktion «Bearbeiten, Fremdwährungen»

FinancialYears (Geschäftsjahre)

Mit dieser Ressource können die Geschäftsjahre aus ONE 50 ermittelt werden.

Übersicht Daten-Model

FinancialYear:

Nummer	DTO-Feldname	Nur ONE 50	ONE 50 GUI-Feldname
1	FinancialYearId		Identifikation
2	FinancialYearFromDate		Datum von
3	FinancialYearToDate		Datum bis
4	BookingPeriodFromDate		Periode von
5	BookingPeriodToDate		Periode bis
6	CurrencyId		Währung
	ReturnStates

Applikation Finanz, Funktion «Extras, Optionen»

 

PaymentTerms (Zahlungskonditionen)

Mit dieser Ressource können die Zahlungskonditionen aus ONE 50 ermittelt werden.

Übersicht Daten-Model

PaymentTerm:

Nummer	DTO-Feldname	Nur ONE 50	ONE 50 GUI-Feldname
1	PaymentTermId		Kürzel
2	Name		Text
	ReturnStates

Alle Applikation: Register DATEN, Funktion «Zahlungskonditionen»

 

TaxRates (Steuersätze)

Mit dieser Ressource können die Steuersätze aus ONE 50 ermittelt werden.

Übersicht Daten-Model

TaxRate:

Nummer	DTO-Feldname	Nur ONE 50	ONE 50 GUI-Feldname
1	TaxId		Schlüssel
2	TaxRatePercent		Prozent
3	AmountType		Eingabeart (Brutto, Netto)
4	TaxAccountId		Gegenkonto
5	ProposedRate		Quote
6	BookingText		Buchungstext
7	TaxType		Typ (immer VAT)
8	ValidFromDate		Gültig ab (immer Beginn Geschäftsjahr)
	ReturnStates

Alle Applikationen: Register DATEN, Funktion «Steuersätze»

 

Tenants (Mandanten)

Mit dieser Ressource können die Mandanten aus ONE 50 ermittelt werden.

Übersicht Daten-Model

Tenant:

Nummer	DTO-Feldname	Nur ONE 200	ONE 50 GUI-Feldname
1	TenantId		Bezeichnung aus Tenant-Konfig-File
2	Name		Name
3	Address		Strasse, Nr.
4	PostalCodeAndCity		PLZ, Ort
	PhoneNumber	X
	Fax	X
5	EMail		E-Mail
	CurrencyId	X
	VatType	X
	IsCostAccountActive	X
	ReturnStates

Applikation Finanz, Funktion «Extras, Optionen»

Finance (Finanz)

Verfügbare Ressourcen

	GET (Lesen)	POST (Neu Erstellen)	PUT (Aktualisieren)	DELETE (Löschen)
CreditorBookings (Kreditor-Buchungen)	X	X
CreditorPaymentDetails (Kreditor-Zahlungsangaben)	X	X
Creditors (Kreditoren)	X	X
DebtorBookings (Debitor-Buchungen)	X	X
Debtors (Debitoren)	X	X
LedgerBookings (Hauptbuch-Buchungen)	X	X
Reminders (Mahnungsinformationen)	X

CreditorBookings (Kreditor-Buchungen)

Mit dieser Ressource können die Kreditor-Buchungen aus ONE 50 ermittelt werden.

Übersicht Daten-Model

CreditorBooking:

Nummer	DTO-Feldname	Nur ONE 200	ONE 50 GUI-Feldname
1	CreditorBookingId
2	CreditorId		Personenkonto
3	CurrencyId		Währung
4	OpenInvoiceValueDate		Valuta Datum
5	OpenInvoiceVoucherDate		Fibu Datum
	voucherIdExternal	X
6	ExpiryDate		Fällig am
	voucherType		Immer «Invoice»
	entryMode		Immer «AccountAllocation
10	PaymentTermId		Zahlungsbedingung
	Id
	UseDefault
11	ISRNumber		ESR-Nummer
12	EndToEndId		Referenz
13	VoucherText		Text
14	CreditorPaymentDetailId		Zahlungsart/Clearing-Nr. IBAN-Konto
	Id
	UseDefault
15	OwnPaymentId		Interne Bank
	Id
	UseDefault
16	<LedgerBooking>		Siehe Ressource LedgerBookings
	ReturnStates

Applikation Finanz, Funktion «Nebenbücher, Offene Posten Kreditoren»

Bei einer Zahlungsart vom Typ ESR/QR mit Referenz muss eine gültige, 27stellige Referenznummer (ISRNumber) erfasst werden.

Bei einer Kreditorenzahlungsverbindung vom Typ QR- mit Kreditor Referenz muss eine gültige Referenznummer (EndToEndId) eingegeben werden. Die Referenz startet immer mit RF und wird mittels Prüfziffer überprüft.

JSON-Beispiel

Das JSON-Beispiel schreibt eine Kreditorenrechnung im Mandant Demo für Kreditor 40’001.

[
{
"creditorId": 40001,
"currencyId": "CHF",
"openInvoiceValueDate": "2022-03-15",
"openInvoiceVoucherDate": "2022-03-15",
"voucherIdExternal": "",
"expiryDate": "2022-04-14",
"voucherType": "Invoice",
"entryMode": "AccountAllocation",
"paymentTermId": {
"id": "30Tn",
"useDefault": true
},
"isrNumber": "",
"endToEndId": null,
"voucherText": "Neue GmbH, 40317",
"creditorPaymentDetailId": {
"id": "",
"useDefault": true
},
"ownPaymentId": {
"id": "",
"useDefault": true
},
"ledgerBooking": {
"valueDate": "2022-03-15",
"voucherDate": "2022-03-15",
"voucherId": 40000,
"voucherIdOriginal": 0,
"reference": "",
"ledgerTransactions": [
{
"accountId": "2000",
"accountType": "Credit",
"amount": 123.45,
"amountKeyCurrencyGross": 123.45,
"amountKeyCurrencyNet": 123.45,
"amountKeyCurrencyTax": 0,
"costBookings": [],
"counter": 0,
"currencyId": "",
"exchangeRate": 1,
"ledgerTransactionId": 0,
"taxRateId": {
"id": "",
"useDefault": false
},
"text": "Neue GmbH, 40317",
"returnStates": []
},
{
"accountId": "4000",
"accountType": "Debit",
"amount": 114.6,
"amountKeyCurrencyGross": 123.45,
"amountKeyCurrencyNet": 114.6,
"amountKeyCurrencyTax": 8.85,
"costBookings": [],
"counter": 0,
"currencyId": "",
"exchangeRate": 1,
"ledgerTransactionId": 0,
"taxRateId": {
"id": "VSM77",
"useDefault": false
},
"text": "Neue GmbH, 40317",
}
],
"ledgerBookingState": "Definitely",
},
},
] 

CreditorPaymentDetails (Kreditor-Bankverbindung)

Mit dieser Ressource können die Kreditor-Bankverbindungen aus ONE 50 ermittelt werden.

Übersicht Daten-Model

CreditorPaymentDetail:

Nummer	DTO-Feldname	Nur ONE 200	ONE 50 GUI-Feldname
	CreditorPaymentDetailId
2	PaymentType		Zahlungsart (Details s. unten)
3	CreditorId		Personenkonto
	IsActive	X
5	IsDefault		Standard
	CurrencyId	X
7	ClearingNumber		Clearing/BLZ
	AccountNumber		Konto
9	AccountIbanNumber		IBAN
10	ESRParticipant		ESR-Teilnehmernummer
	PostalAccountNumber		PC-Konto
12	ExternalDescription		Name
13	Bic		BIC/SWIFT
14	Name		Bankname
15	Address1		Adresse 1
16	Address2		Adresse 2
17	PostalCode		PLZ
18	City		Ort
	CountryId		Land
	ReturnStates

PaymentType:

- 0 = Manual – Zahlungsart Manuell

- 1 = Bank – Zahlungsart IBAN, Roter Einzahlungsschein (Bank)

- 2 = SwissPost – Roter Einzahlungschein (Post)

- 3 = PostalOrder – nicht unterstützt

- 4 = ISR – ESR (15, 16 oder 27stellig) beim POST wird immer ESR27 gesetzt

- 5 = ForeignCurrency - Fremdwährung

- 6 = QRWithReference – QR mit Referenz

- 7 = QRWithoutReference – QR ohne Referenz

- 8 = QRWithCreditorReference – QR mit Kreditor-Referenz

Applikation Finanz, Funktion «Nebenbücher, Personenkonto Kreditoren, Bankverbindungen»

 

Creditors (Kreditoren)

Mit dieser Ressource können die Kreditoren aus ONE 50 ermittelt werden. . Das Addressobject kann optional beim Lesen gefüllt werden. Beim Schreiben von Creditors wird das jedoch nicht unterstützt. Es muss zuerst eine Adresse geschrieben werden und die Adressnummer dann im Feld AddressId gesetzt werden.

Übersicht Daten-Model

Creditor:

Nummer	DTO-Feldname	Nur ONE 200	ONE 50 GUI-Feldname
1	AddressId		Adresse
2	CreditorId		Personenkonto
3	MatchCode		Kürzel
4	Name		Bezeichnung
	CurrencyId		Währung (wird von Fibu-Konto gelesen)
	IsBlocked		Inaktiv (nur verfügbar, wenn mit Auftrag verknüpft)
5	CreditLine		Kreditlimite
6	AccountId		Fibu-Konto
	PreregistryAccountId	X
7	ExpenseAccountId		Gegen-Konto
	ProposedCostCenterId	X
	TypeMarketId	X
	TaxCode	X
8	CustomerNumber		Unsere Kundennummer
9	PaymentTermId		Zahlungsbedingung
10	Balance		aktueller Betrag
	<Address>		Adressobjekt siehe Ressource Addresses
	ReturnStates

Applikation Finanz, Funktion «Nebenbücher, Personenkonto Kreditoren»

 

DebtorBookings (Debitor-Buchungen)

Mit dieser Ressource können die Debitor-Buchungen aus ONE 50 ermittelt werden.

Übersicht Daten-Model

DebtorBooking:

Nummer	DTO-Feldname	Nur ONE 200	ONE 50 GUI-Feldname
1	DebtorBookingId		OP-Nummer
2	DebtorId		Personenkonto
3	CurrencyId		Währung
4	OpenInvoiceValueDate		Valuta Datum
5	OpenInvoiceVoucherDate		Fibu Datum
	VoucherIdExternal	X
6	ExpiryDate		Fällig am
	VoucherType		Immer «Invoice»
7	PaymentTermId		Zahlungsbedingungen
	Id
	UseDefault
8	ISRNumber		ESR-Nummer
	EndToEndId		Referenz
9	VoucherText		Text
10	OwnPaymentId		Interne Bank
	Id
	UseDefault
11	VoucherState		Status
12	<LedgerBooking>		Siehe Ressource LedgerBookings
13	ReminderLevel		Stufe
	ReversalState	X
	ReturnStates

Applikation Finanz, Funktion «Nebenbücher, Offene Posten Debitoren»

 

Debtors (Debitoren)

Mit dieser Ressource können die Debitoren aus ONE 50 ermittelt werden. Das Addressobject kann optional beim Lesen gefüllt werden. Beim Schreiben von Debtors wird das jedoch nicht unterstützt. Es muss zuerst eine Adresse geschrieben werden und die Adressnummer dann im Feld AddressId gesetzt werden.

Übersicht Daten-Model

Debtor:

Nummer	DTO-Feldname	Nur ONE 200	ONE 50 GUI-Feldname
1	AddressId		Adresse
2	DebtorId		Personenkonto
3	MatchCode		Kürzel
4	Name		Bezeichnung
	CurrencyId		Währung (wird von Fibu-Konto gelesen)
	IsBlocked		Inaktiv (nur verfügbar, wenn mit Auftrag verknüpft)
5	CreditLine		Kreditlimite
6	AccountId		Fibu-Konto
7	RevenueAccountId		Gegen-Konto
	ProposedCostCenterId	X
	TypeMarketId	X
	TaxCode	X
8	SupplierNumber		Unsere Kundennummer
9	PaymentTermId		Zahlungsbedingungen
10	ReminderId		Mahnverfahren
11	Balance		Aktueller Betrag
	<Address>		Adressobjekt siehe Ressource Addresses
	ReturnStates

Applikation Finanz, Funktion «Nebenbücher, Personenkonto Debitoren»

 

LedgerBookings (Hauptbuch-Buchungen)

Mit dieser Ressource können die Hauptbuch-Buchungen aus ONE 50 ermittelt werden.

Übersicht Daten-Model

LedgerBooking:

Nummer	DTO-Feldname	Nur ONE 200	ONE 50 GUI-Feldname
1	ValueDate		Datum
	VoucherDate	X
2	VoucherId		Beleg-Nr.
	VoucherIdOriginal	X
3	Reference		Barcode
	TotalAmountKeyCurrencyGross
	TotalAmountKeyCurrencyNet
	TotalAmountKeyCurrencyTax
	LedgerTransactions		Siehe LedgerTransactions (Soll/Haben-Buchungen)
	LedgerBookingState
	ReturnStates

LedgerTransactions (Soll/Haben-Buchungen)

Mit dieser Ressource können die Fibu-Buchungszeilen aus ONE 50 ermittelt werden.

Übersicht Daten-Model

LedgerTransactions:

Nummer	DTO-Feldname	Nur ONE 200	ONE 50 GUI-Feldname
	LedgerTransactionId
	Counter
4	AccountId		Konto
5	AccountType		Soll/Haben
	CurrencyId		Währung (wird von Konto gelesen)
6	Amount		Betrag
	ExchangeRate		Kurs
7	TaxRateId		Steuerkonto
8	Text		Text
	AmountKeyCurrencyGross		Bruttobetrag
	AmountKeyCurrencyNet		Nettobetrag
	AmountKeyCurrencyTax		Steuerbetrag
	AmountBookingGross
	AmountBookingNet
	AmountBookingTax
	AmountAccountGross
	AmountAccountNet
	AmountAccountTax
	CostBookings		Siehe CostBookings (KST-Buchungen)

CostBookings (KST-Buchungen)

Mit dieser Ressource können die Kostenstellen-Buchungszeilen aus ONE 50 ermittelt werden.

Übersicht Daten-Model

CostBookings:

Nummer	DTO-Feldname	Nur ONE 200	ONE 50 GUI-Feldname
	CostTypeId	X
9	CostCenterCostUnit1Id		Kostenstelle
	CostCenterCostUnit2Id	X
10	Amount		Betrag
	Text		Buchungstext

 

Applikation Finanz, Funktion «Bearbeiten, Buchen»

JSON-Beispiel

Das JSON-Beispiel schreibt eine Sammelbuchung im Mandant Demo

[
{
  "valueDate": "2022-02-19",
  "voucherId": 1,
  "reference": "",
  "ledgerTransactions": [
    {
      "accountId": "1000",
      "accountType": "Credit",
      "amount": 1000,
      "counter": 0,
      "exchangeRate": 1,
      "ledgerTransactionId": 0,
      "text": "REST-Buchung",
    },
    {
      "accountId": "4200",
      "accountType": "Debit",
      "amount": 185.7,
      "amountKeyCurrencyGross": 200,
      "amountKeyCurrencyNet": 185.7,
      "amountKeyCurrencyTax": 14.3,
      "costBookings": [
        {
          "costCenterCostUnit1Id": "900",
          "text": "REST-Buchung",
          "amount": 185.7,
        }
      ],
      "counter": 0,
      "exchangeRate": 1,
      "ledgerTransactionId": 0,
      "taxRateId": {
        "id": "VSM77",
        "useDefault": false
      },
      "text": "REST-Buchung",
    },
    {
      "accountId": "4400",
      "accountType": "Debit",
      "amount": 742.8,
      "amountKeyCurrencyGross": 800,
      "amountKeyCurrencyNet": 742.8,
      "amountKeyCurrencyTax": 57.2,
      "costBookings": [
        {
          "costCenterCostUnit1Id": "910",
          "text": "REST-Buchung",
          "amount": 742.8,
        }
      ],
      "counter": 0,
      "exchangeRate": 1,
      "ledgerTransactionId": 0,
      "taxRateId": {
        "id": "VSM77",
        "useDefault": false
      },
      "text": "REST-Buchung",
    }
  ],
  "ledgerBookingState": "Definitely",
}
] 

 

 

Reminders (Mahnungsinformationen)

Mit dieser Ressource können die Mahnungsinformationen aus ONE 50 ermittelt werden.

Übersicht Daten-Model

Reminder:

Nummer	DTO-Feldname	Nur ONE 50	ONE 50 GUI-Feldname
	ReminderId		Aufsteigende Zahl 1-xy
2	Name		Bezeichnung
	ReturnStates

Applikation Finanz, Funktion «Auswertung, Debitoren, Mahnung, Mahnliste»