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ÁMETROSDESCRIPCIÓ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"
}