Une API pour la conformité à la TVA

API de flux

  • Vous permet de télécharger des données de commande sur Lovat

API du taux de TVA

  • Vous donner un taux d'imposition précis pour vos produits ou services

Demande et réponse

Toutes les requêtes API doivent être effectuées via HTTPS. Les appels passés via HTTP simple échoueront. Vous devez vous authentifier pour toutes les demandes.

La méthode SEND met en œuvre la réception des données sur la transaction, en tenant compte du traitement et du calcul de la TVA et des charges du système.

https address correct example

URL de référence

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

Options d’appel

Les paramètres d’appel sont divisés en deux types:

  • Paramètres de chemin (jeton).
  • Paramètres de requête (données de transaction).

Le jeton est généré dans le compte interne du commerçant lors de la première étape d’ajout du site Web. Vous pouvez l’obtenir auprès de votre responsable ou le trouver dans la section Store – Paramètres.

Les paramètres de la requête sont générés par le marchand et envoyés au serveur en utilisant la méthode POST au format application/x-www-form-urlencoded ou application/json.

Exemple de requête pour les marchandises:
Exemple de requête depuis la console

curl-v POST
https://merchant.vatcompliance.co/api/1/send/5aae918d97964ff88df64b059c2cc0f8?if_digital=false&if_vat_calcilate=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",
}'

Paramètres

transaction_id
String/ 555-yyy
Identifiant de transaction
transaction_datetime
DateTime / 2017-01-09T08:27:22 +00:00
Date et heure de la transaction conformément à la norme ISO 8601 GMT
transaction_sum
String / 25
Montant de la transaction
currency
String / “GBP”, “EUR”, “RUB”
Toutes les devises sont spécifiées sous forme de chaînes conformément à la norme ISO 4217
arrival_country
String / "GBR"
Tous les pays sont spécifiés sous forme de chaînes conformément à la norme ISO 3166-1 alpha-3
transaction_status
String / “Success”, “Charge back”, “Refund”, “Movement own goods”
État de la transaction
good_code
String / “62160000”
Code d'une marchandise selon le système de codage à huit chiffres de l'UE La nomenclature combinée (NC)

La liste complète des paramètres est disponible dans les guides API