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

Did this page help you?