Feed-API

Anleitung zur technischen Integration in die LOVAT-Systeme

Begriffe und Abkürzung

API – Programmierschnittstelle. Eine Reihe von Aufrufen, die vom System bereitgestellt werden, erfordern die Integration in externe Softwareprodukte.

Merchant – der Besitzer eines Online-Shops.

Customer – eine Person, die für Waren oder Dienstleistungen bezahlt.

Transaction – Überweisung von Geldern für Waren oder Dienstleistungen, die der Kunde vom Händler erhalten hat.

Token – Eine geheime Zeichenfolge, die vom System verwendet wird, um den Händler und die Website zu identifizieren, über die die Transaktion registriert wird.

API-Beschreibung

Sendemethode.

Beschreibung der Methode.

Die SEND-Methode implementiert den Empfang von Daten zur Transaktion unter Berücksichtigung der Verarbeitung und Berechnung der Mehrwertsteuer und der Systemgebühren.

Referrer-URL

Die Methode ist unter der folgenden UR verfügbar:

https://merchant.vatcompliance.co/api/1/
send/{access_token}?if_digital={true/false}&if_vat_calculate={true/false}

Anrufoptionen

Anrufparameter werden in zwei Typen unterteilt:

• Pfadparameter (Token)
• Abfrageparameter (Transaktionsdaten)

Das Token wird in der ersten Phase des Hinzufügens der Website im internen Konto des Händlers generiert. Sie können es von Ihrem Manager erhalten oder im Abschnitt Store – Einstellungen finden.

Die Anforderungsparameter werden vom Händler generiert und mithilfe der POST-Methode 
in der Anwendung an den Server gesendet 
/ x-www-form-urlencoded or application / json format

Digitale Dienste

Server-Antwortcode

Die Antwort auf die Abfrage verwendet den grundlegenden HTTP-Code

Beispielabfrage für digitale Dienste:
Beispielanforderung von der Konsole

curl -v POST 'http://https://merchant.vatcompliance.co/api/1/
send/5aae918d97964ff88df64b059c2cc0f8?if_digital=false&if_vat_calculate=true' --header "Content-Type: application/json"
-d '{ 
    "transaction_id": " ttt4565-85546",
    "transaction_datetime": "2017-01-09T08:27:22 +00:00",
    "transaction_sum": 25.99,
    "customer_ip": "127.0.0.1",
    "customer_phone_number": "+7 677 ** * **",
}'

Waren

Beispielabfrage für Waren:
Beispielanforderung von der Konsole

curl-v POST
https://merchant.vatcompliance.co/api/1/send/5aae918d97964ff88df64b059c2cc0f8?if_digital=false&if_vat_calculate=false
--header "Content-Type: application/json" 
-d '{
                "transaction_id ": " ttt4565-85546",
                "transaction_datetime": "2017-01-09T08:27:22 +00:00",
                "transaction_sum ": 158.04,
                "currency": "GBP",
                "arrival_country" : " GBR",
                "arrival_city" : " London",
                "arrival_address_line" : " Peckham Road",
                "transaction_status" : "Success",
                "good_code": "62160000",
                "vat_percent": 20.00,
                "vat": 28.73,
                "departure_country" : "AUS",
}'

Service-Code-Liste