A

API de Feeds

Instrucciones para la integración técnica con los sistemas LOVAT

 

Términos y Abreviaturas

API Interfaz de Programación de Aplicaciones. Un conjunto de llamadas proporcionadas por el sistema requiere la integración con productos de software externos.

Merchant el propietario de una tienda en línea.

Customer una persona que paga por mercancías o servicios.

Transaction transferencia de fondos por mercancías o servicios recibidos por el cliente del comerciante.

Token un string secreta utilizada por el sistema para identificar al comerciante y el sitio web a través del cual se registra la transacción.

Descripción API

Método de envío.

Descripción del método.

El método ENVIAR implementa la recepción de datos sobre la transacción, teniendo en cuenta el procesamiento y cálculo del IVA y los cargos del sistema.

URL de Referencia

El método está disponible en la siguiente URL:

https://merchant.vatcompliance.co/api/1/

send/{access_token}?if_digital={true/false}&if_vat_calculate={true/false}

Opciones de Llamada

Los parámetros de llamada se dividen en dos tipos:

  • Parámetros de ruta (token)
  • Parámetros de consulta (datos de transacción)

El token se genera en la cuenta interna del comerciante en la primera etapa de agregar el sitio web. Puede obtenerlo de su gerente o encontrarlo en la Sección Tienda – Configuración.

Los parámetros de la solicitud son generados por el comerciante y enviados al servidor mediante el método POST en la aplicación

/ x-www-form-urlencoded or application / json format

Servicios Digitales

Parámetro Tipo/Ejemplo Descripción del Ejemplo Validación
transaction_id String/ 555-yyy ID de transacción Máximo 255 caracteres. No es un valor vacío.
transaction_datetime DateTime / 2017-01-09T08:27:22 +00:00 Fecha y hora de la transacción de acuerdo con ISO 8601 GMT No es un valor vacío.
transaction_sum String / 25 Suma de transacción Máximo 45 caracteres. No es un valor vacío.
customer_ip String / 127.0.0.1 Dirección IP del cliente Máximo 45 caracteres.
currency String / “usd”, “eur”, “rub”, “gbp” Moneda de la transacción Máximo 3 caracteres. No es un valor vacío.
customer_phone_number String / “+7 AAA BBB BB BB” Número de teléfono del cliente Máximo 100 caracteres.
arrival_country String / “GBR” Todos los países se especifican como string de acuerdo con ISO 3166-1 alpha-3 Máximo 3 caracteres.
arrival_city String / “London” Ciudad de Llegada Máximo 255 caracteres.
arrival_address_line String / “Peckham Road” Línea de dirección de llegada Máximo 255 caracteres.
transaction_status String / “Success”, “Charge back”, “refund”, “Movement own goods” Estado de transacción No es un valor vacío.
service_code String / “1” Código del tipo de servicio del comerciante. Si el comerciante no envía datos sobre el tipo de servicio prestado, a la transacción se le asigna el tipo principal nominal de servicio del comerciante que se especificó en el registro Máximo 255 caracteres. No es un valor vacío.
bank_card_number String / “1234-****-****-****” Número de la tarjeta bancaria del comprador Máximo 19 caracteres.
payment_operator String / “payonline” paypal” Operador de Pago Máximo 45 caracteres. No es un valor vacío.
payment_method_country String / “USA” Opción de pago por país. Todos los países se especifican como string de acuerdo con ISO 3166-1 alpha-3 Máximo 3 caracteres. No es un valor vacío.
billing_country String / “USA” País de facturación (dirección del propietario del pago). Todos los países se especifican como string de acuerdo con ISO 3166-1 alpha-3 Máximo 3 caracteres. No es un valor vacío.
billing_address String / “111 First Street,Saratoga, CA 95070, US” Dirección de facturación (dirección del propietario del pago) Máximo 255 caracteres. No es un valor vacío.

Código de Respuesta del Servidor

La respuesta a la consulta utiliza el código HTTP básico

Código Explicación Contenido de Respuesta
200 OK Solicitud procesada  
400 BadRequest Solicitud no válida { error : “Problem with data” }
401 Unauthorized Acceso no autorizado { error : “Token is invalid.” }

Ejemplo de solicitud para servicios digitales:

Ejemplo de comandos de la consola de comandos

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

Mercancías

Parámetro Tipo/Ejemplo Descripción de Ejemplo Validación
transaction_id String/ 555-yyy ID de transacción Máximo 255 caracteres. No es un valor vacío.
transaction_datetime DateTime / 2017-01-09T08:27:22 +00:00 Fecha y hora de la transacción de acuerdo con ISO 8601 GMT No es un valor vacío.
transaction_sum String / 25 Suma de transacción Máximo 45 caracteres. No es un valor vacío.
currency String / “GBP”, “EUR”, “RUB” Todas las monedas se especifican como string de acuerdo con ISO 4217 Máximo 3 caracteres. No es un valor vacío.
arrival_country String / “GBR” Todos los países se especifican como string de acuerdo con ISO 3166-1 alpha-3 Máximo 3 caracteres.
arrival_city String / “London” Ciudad de llegada Máximo 255 caracteres.
arrival_address_line String / “Peckham Road” Línea de dirección de llegada Máximo 255 caracteres.
transaction_status String / “Success”, “Charge back”, “refund”, “Movement own goods” Estado de transacción No es un valor vacío.
good_code String / “62160000” Código de mercancía según el sistema de codificación de ocho dígitos de la UE – la Nomenclatura Combinada Máximo 8 caracteres.
vat_percent Float / 20.00 Porcentaje de IVA Máximo 8 caracteres.
vat Float / 28.73 Importe del IVA Flotador
departure_country String / “AUS” Opción de pago por país. Todos los países se especifican como string de acuerdo con ISO 3166-1 alpha-3 Máximo 3 caracteres. No es un valor vacío.
taxable_jurisdiction String / “GBR” Opción de pago por país. Todos los países se especifican como string de acuerdo con ISO 3166-1 alpha-3 Máximo 3 caracteres.
buyer_vat_number String / “UK123123123” Número de IVA del comprador UE Máximo 255 caracteres.

 

Ejemplo de solicitud de mercancía:

Ejemplo de comandos de la consola de comandos

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

Lista de Códigos de Servicio

contenido audio/visual 1
transmisión en vivo 2
servicios telefónicos 3
servicios telefónicos por internet 4
servicios de gestión de llamadas 5
servicios de radiobúsqueda 6
acceso a Internet 7
imágenes 8
música 9
juegos 10
periódicos electrónicos 11
alojamiento web 12
mantenimiento a distancia de programas 13
espacio publicitario en un sitio web 14
libros electrónicos 15
licencias 16
citas 17
educación a distancia 18
juegos de azar 19
suministro de mercancías 20
otro digital 21