Numeración de facturas
Endpoint: GET /numeration/
¿Para qué sirve?
Esta opción permite consultar las autorizaciones, habilitaciones e inhabilitaciones de facturación de rangos numéricos de facturación de la DIAN, de la empresa a la que iniciaste sesión previamente; en períodos de tiempo específicos.
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. |
type | authorization -> autorización. habilitation -> habilitación. * inhabilitation -> inhabilitación. |
date_start | Fecha de inicio del rango (formato DD/MM/YYYY) |
date_end | Fecha del fin del rango (formato DD/MM/YYYY) |
Respuesta
STATUS | |
---|---|
status | success -> la informacion ha sido accedida correctamente. error -> la sesión o la key es inválida. |
Ejemplos
*Solicitud de numeración de facturas
GET /numeration/ 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&type=authorization&date_start=01%2F01%2F2016&date_end=01%2F01%2F2017
curl -X GET "https://fiscal.sandbox.prometeoapi.com/numeration/" -d "session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75&type=authorization&date_start=01%2F01%2F2016&date_end=01%2F01%2F2017" -H "X-API-Key: <API KEY>"
import requests
requests.get('https://fiscal.sandbox.prometeoapi.com/numeration/', data={
'session_key': 'ce11f66e-ed28-4a4c-acc7-bb28bb899c75',
'type': 'authorization',
'date_start': '01/01/2016',
'date_end': '01/01/2017',
}, headers={
'X-API-Key': '<API KEY>'
})
var request = require('request');
request.get({
"url": "https://fiscal.sandbox.prometeoapi.com/numeration/",
"json": true,
"headers": {
"X-API-Key": "<API KEY>"
},
"form": {
"session_key": "ce11f66e-ed28-4a4c-acc7-bb28bb899c75",
"type": "authorization",
"date_start": "01/01/2016",
"date_end": "01/01/2017"
}
});
Respuesta exitosa
{
"numeration": [
{
"address": "CR 12 A 65",
"country": "Colombia",
"department": "Antioquia",
"dv": "0",
"municipality": "Medellín",
"name": {
"first_name": "",
"first_surname": "",
"other_names": "",
"second_surname": ""
},
"nit": "902202672",
"pdf_url": "/pdf/25ebc593c917786864b9753cffa68b8f.pdf",
"ranges": [
{
"establishment": "Qualia SRL",
"from": 1,
"mode": "COMPUTADOR",
"prefix": "",
"to": 2000,
"type": "AUTORIZACIÓN"
}
],
"reason": "Qualia SRL"
}
],
"status": "success"
}
Respuesta errónea o session_key expirada
{
"message" : "Invalid session key",
"status" : "error"
}
Updated about 2 years ago