Declaración de IVA (VAT)
Endpoint: GET /vat/
¿Para qué sirve?
Mediante esta consulta, podrás obtener la Declaración Jurada de IVA (VAT) de la empresa a la que iniciaste sesión previamente.
A continuación podrás consultar los distintos formatos y campos que tiene la misma.
PARÁMETROS | DESCRIPCIÓN |
---|---|
session_key | Clave de autenticación que deberá ser usada en todas las requests siguientes. |
year | Año. |
periodicity | - q -> cuatrimestral. - b -> bimestral. |
period | - Cuatrimestral: - 1: Enero - Abril - 2: Mayo - Agosto - 3: Septiembre - Diciembre - Bimestral: - 1: Enero - Febrero - 2: Marzo - Abril - 3: Mayo - Junio - 4: Julio - Agosto - 5: Septiembre - Octubre - 6: Noviembre - Diciembre |
Respuesta
STATUS | |
---|---|
status | success -> la informacion ha sido accedida correctamente. error -> la sesión o la key es inválida. |
Ejemplos
Solicitar reporte de IVA (VAT)
GET /vat/ HTTP/1.1
Host: fiscal.sandbox.prometeoapi.com
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-API-Key: <API KEY>
session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75&year=2017&periodicity=q&period=2
curl -X GET "https://fiscal.sandbox.prometeoapi.com/vat/" -d "session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75&year=2017&periodicity=q&period=2" -H "X-API-Key: <API KEY>"
import requests
requests.get('https://fiscal.sandbox.prometeoapi.com/vat/', data={
'session_key': 'ce11f66e-ed28-4a4c-acc7-bb28bb899c75',
'year': '2017',
'periodicity': 'q',
'period': '2',
}, headers={
'X-API-Key': '<API KEY>'
})
var request = require('request');
request.get({
"url": "https://fiscal.sandbox.prometeoapi.com/vat/",
"json": true,
"headers": {
"X-API-Key": "<API KEY>"
},
"form": {
"session_key": "ce11f66e-ed28-4a4c-acc7-bb28bb899c75",
"year": "2017",
"periodicity": "q",
"period": "2"
}
});
Respuesta exitosa
{
"status" : "success",
"declaration" : {
"pdf_url" : "/pdf/8ff21e603a523l0a98c9cc8b0e9b3db1.pdf",
"previous_form" : "",
"form_number" : "3013623041391",
"year" : "2017",
"correction_code" : "",
"direction_code" : "1 1",
"dv" : "0",
"reason" : "Qualia Fintech SRL",
"nit" : "123332211",
"fields" : {
"56" : {
"name" : "Total compras netas realizadas durante el",
"value" : 21530000,
"number" : "56"
},
"83" : {
"value" : 0,
"number" : "83",
"name" : "Retenciones por IVA que le practicaron"
},
"32" : {
"name" : "iPntoer rvneanctiaosn aal sociedades de comercializaci?n",
"value" : 0,
"number" : "32"
},
"31" : {
"name" : "Por exportaci?n de servicios",
"number" : "31",
"value" : 0
},
"66" : {
"number" : "66",
"value" : 0,
"name" : "Por importaciones gravadas a tarifa del 5%"
},
"88" : {
"name" : "Saldo a favor susceptible de devoluci?n y/ocompensaci?n por el presente per?odo",
"value" : 0,
"number" : "88"
}
}
},
"period" : "3",
"name" : {
"other_names" : "",
"first_surname" : "",
"second_surname" : "",
"first_name" : ""
}
}
Respuesta errónea o session_key expirada
{
"message" : "Invalid session key",
"status" : "error"
}
Updated about 2 years ago