增值税合规的API

提要API

  • 让您将订单数据上传到Lovat

增值税税率API

  • 为您的产品或服务提供准确的税率

请求和回应

所有API请求都必须通过HTTPS发出。通过普通HTTP进行的调用将失败。您必须对所有请求进行身份验证。

发送方式实现了对交易数据的接收,同时也将增值税和系统费用的处理和计算考虑在内。

参考URL

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

呼叫选项

呼叫参数分为两种类型:

  • 路径参数(令牌)
  • 查询参数(交易数据)

令牌是在添加网站的第一阶段中,在商家的内部帐户中产生。您可以通过询问经理获取,或在「店铺-设置」中自行查找。

请求参数由商家生成,并使用POST方法以应用程式/ x-www-form-urlencoded或应用程式/ json格式发送到服务器。

商品查询范例:
来自控制台的样本请求

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",
}'

参数

transaction_id
String/ 555-yyy
交易编号
transaction_datetime
DateTime / 2017-01-09T08:27:22 +00:00
符合ISO 8601 GMT的交易日期和时间
transaction_sum
String / 25
交易金额
currency
String / “GBP”, “EUR”, “RUB”
根据ISO 4217,所有货币均指定为字串
arrival_country
String / "GBR"
根据ISO 3166-1 alpha-3将所有国家/地区指定为字串
transaction_status
String / “Success”, “Charge back”, “Refund”, “Movement own goods”
交易状态
good_code
String / “62160000”
符合欧盟八位数编码系统的商品代码组合命名法(CN)

API指南中提供了完整的参数列表