Im Fall, dass Sie einen Webshop oder eine Landingpage haben, die noch nicht von MetaKocka unterstützt (integriert) wird, können Sie Dokumente an MetaKocka senden. Diese werden auf die gleiche Weise in Verkaufsaufträge übernommen, wie sie aus Webshops übertragen werden. Weitere Informationen zur API-Schnittstelle finden Sie unter https://github.com/metakocka/metakocka_api_base/. Sie können den untenstehenden Anweisungen folgen.

Allgemeine Anforderungen:

  • Den API-Schlüssel können Sie über die Einstellungsanwendung einrichten – siehe http://blog.metakocka.si/dodatne-nastavitve-api/

  • Alle Anfragen sind vom Typ POST

  • Alle Anfragen müssen den Header-Parameter Content-Type: application/json enthalten

  • Im Fehlerfall enthält die Antwort ein opr_code > 0 und eine Fehlerbeschreibung im Feld opr_desc

  • Bei einem Upgrade von MetaKocka kann es sein, dass der Dienst nicht erreichbar ist, daher muss eine Logik implementiert werden, die bei Nichtverfügbarkeit ein erneutes Senden ermöglicht.

Generierung einer neuen Bestellung

Hinweise:

URL: https://main.metakocka.si/rest/eshop/v1/put_document
Anfrage:

{
"secret_key": "TODO",
"company_id": "16",
"doc_type": "sales_order",
"doc_date": "2017-10-30+02:00",
"title": "#390",
"buyer_order": "#390",
"partner": {
"business_entity": "true",
"taxpayer": "true",
"foreign_county": "false",
"tax_id_number": "SI20000001",
"customer": "API partner 1",
"street": "Street 100",
"post_number": "1000",
"place": "Ljubljana",
"province": "Severna primorska",
"country": "Slovenia",
"partner_contact": {
"name": "Janez Novak",
"phone": "05 320 24 88",
"fax": "05 320 24 84",
"gsm": "071 333 444",
"email": "test@test.co.uk"
}
},
"receiver": {
"business_entity": "true",
"taxpayer": "true",
"foreign_county": "false",
"tax_id_number": "SI20000002",
"customer": "API partner 2",
"street": "Street 200",
"post_number": "1000",
"place": "Ljubljana",
"country": "Slovenia",
"partner_contact": {
"name": "Janez Novak",
"phone": "05 320 24 88",
"fax": "05 320 24 84",
"gsm": "071 333 444",
"email": "test@test.co.uk"
}
},
"currency_code": "EUR",
"delivery_type": "GLS",
"notes": "Custom extra message",
"method_of_payment": "PayPal",
"product_list": [
{
"code": "p1",
"name": "Product with tax 22%",
"name_desc" : "Extra description for product",
"amount": "1",
"price_with_tax": "100",
"unit" : "kos",
"sales" : true,
"tax": "EX4"
},
{
"code": "p2",
"name": "Product with tax 9,5%",
"name_desc" : "Extra description for product",
"amount": "1",
"price_with_tax": "100",
"unit" : "kos",
"sales" : true,
"tax": "EX3"
},
{
"code": "p3",
"name": "Product with tax 0%",
"name_desc" : "Extra description for product",
"amount": "1",
"price_with_tax": "100",
"unit" : "kos",
"sales" : true,
"tax": "000"
},
{
"code": "p4",
"name": "Delivery cost",
"amount": "1",
"price_with_tax": "5",
"unit" : "stor",
"sales" : true,
"service": true,
"tax": "EX4"
}
]
}


Antwort:

{
"opr_code": "0",
"opr_time_ms": "87",
"partner": {
"mk_id": "1600000073"
},
"receiver": {
"mk_id": "1600000076"
},
"mk_id": "1600000100",
"count_code": "2/2017"
}


Zusätzliche Zahlung

Falls Ihre Anwendung prüft, ob eine bestimmte Bestellung bezahlt wurde, können Sie die Information an MK senden, dass die Bestellung bereits bezahlt ist.


Hinweise: 


URL : https://main.metakocka.si/rest/eshop/v1/put_transaction

Anfrage:

{
"secret_key": "TODO",
"company_id": "16",
"doc_type" : "sales_order",
"mk_id":"1600000073",
"payment_mode" : "payment",
"payment_type" : "PayPal",
"date" : "2017-10-30+02:00",
"price" : "305"
}


Antwort:

{
"opr_code": "0",
"opr_time_ms": "0"
}


Bedeutung von Zahlungsart und Zahlungsweise 

Für Zahlungen bei Bestellungen verwenden wir zwei Begriffe:

  • Zahlungsart - wie die Bestellung bezahlt werden soll. Dies ist die Option, die der Kunde normalerweise im Webshop auswählt (z. B. Nachnahme, Karte, PayPal usw.)
  • Zahlungsweise - wie die Bestellung tatsächlich bezahlt wurde (Zahlungsinstrument, Betrag, Datum)


Beide Zahlungsarten können in Einstellungen → Stammdaten eingerichtet werden. Sie heißen "Zahlungsarten" und "Zahlungsweisen".


Bei Zahlungsinstrumenten, bei denen das Geld sofort bei der Bestellung eingeht (z. B. PayPal, Karten), werden zwei API-Aufrufe durchgeführt – put_document (das Feld method_of_payment wird für die Zahlungsart verwendet) und anschließend put_transaction (der Name der Zahlung wird in payment_type eingetragen). Bei Bestellungen, bei denen der Kunde erst bei Lieferung zahlt, wird nur der API-Aufruf put_document ausgeführt und das Feld method_of_payment entsprechend gesetzt.


FAQ


1. Wie kann ich eine gespeicherte Bestellung in MetaKocka einsehen? 


Gespeicherte Bestellungen befinden sich unter Verkaufsaufträgen. Wählen Sie anschließend Liste aktualisieren, damit Ihnen die neuen Bestellungen angezeigt werden.




2. Wie kann ich den bezahlten Betrag bei einem Verkaufsauftrag überprüfen?




3. Ich erhalte den Fehler "Paramether 'payment_type' has invalid value : PayPal. Valid values : Geschäftskonto, Bargeld, Überweisung des Guthabens, Bankkarte"

Es ist erforderlich, ein zusätzliches Zahlungsinstrument mit dem Namen PayPal hinzuzufügen.




Hinweis:

  • Wenn Rechnungen mit diesem Zahlungsmittel an das FURS gesendet werden, kennzeichnen Sie sie mit dem Zahlungstyp = Sonstiges. Wenn Sie nicht möchten, dass sie an das FURS gesendet werden, setzen Sie den Zahlungstyp auf Geschäftskonto.