API LaFactura.co:Rangos Facturacion

De API LaFactura.co
Ir a la navegación Ir a la búsqueda

Objeto:getRanges (Rangos de facturación)

Se utiliza para conocer los rangos de facturacion en el sistema, saber los que estan activos asi como las llaves para ser usadas en peticiones de generar factura. Este servicio es por el método GET 

 {
      "getRanges":{
           "mode":"active",
           "type":"all"
      }
 }
Objeto

Envía la información referente al documento a anular:

Parámetro Descripción Tipo Obligatorio API
mode Que rangos deseo consultar:
active ->Activos
inactive-> Inactivos
reserved-> Reservados		 cadena SI v2.0 / v3.0
type Que tipo de rangos deseo:
all -> Todos
invoice -> Facturas
creditNote -> Nota Credito
debitNote -> Nota Debito
supportDoc -> Documento Soporte (nuevo API v3.0)		 cadena SI v2.0 / v3.0
Resultados

Devuelve un objeto generalResult con el resultado de la operación y la información referente a los rangos 

    {
         "generalResult":{
             "status":{
                "code":200,
                "text":"Operación realizada con exito"
              },
              "ranges":[
                 {
                   "RANGEKEY":"rk-c1acbededb62c3546c19a0676cca4cb85",
                   "type":"invoice",
                   "prefix":"SETP",
                   "from":"990000000",
                   "to":"995000000",
                   "last":"990000102",
                   "remaining":"4999898",
                   "firstDate":"20200223",
                   "lastDate":"20210223",
                   "description":""
                 },
                 {
                   "RANGEKEY":"rk-a009e51a3986e10aa892275fb1e72594a",
                   "type":"creditNote",
                   "prefix":"NCR",
                   "from":"0",
                   "to":"999999999",
                   "last":"17",
                   "remaining":"999999982",
                   "firstDate":"20000101",
                   "lastDate":"29990101",
                   "description":""
                 },
                 {
                    "RANGEKEY":"rk-a66a4ee282763d4f89870b653ac5b90e8",
                    "type":"debitNote",
                    "prefix":"NDE",
                    "from":"0",
                    "to":"999999999",
                    "last":"11",
                    "remaining":"999999988",
                    "firstDate":"20000101",
                    "lastDate":"29990101",
                    "description":""
                  }
             ]

         }
      }
Objeto:ranges

Información referente a los rangos solicitados (Es un arreglo de Objetos):

Parámetro Descripción Tipo Obligatorio API
rangeKey Llave del rango
Es requerido para enviar una factura		 cadena SI v2.0 / v3.0
type Tipo de rango
invoice -> Factura
debitNote -> Nota Debito
creditNote -> Nota Credito
supportDoc -> documento soporte (nuevo API v3.0)		 cadena SI v2.0 / v3.0
prefix Prefijo de facturacion cadena SI v2.0 / v3.0
from Primer numero del rango cadena SI v2.0 / v3.0
to Ultimo numero del rango cadena SI v2.0 / v3.0
last Ultimo numero usado cadena SI v2.0 / v3.0
remaining Documentos disponibles cadena SI v2.0 / v3.0
firstDate Fecha apartir de la cual el rango puede ser utilizado cadena SI v3.0
lastDate Fecha hasta la cual el rango puede ser utilizado cadena SI v3.0
description Campo informativo
Descripcion en base de datos solicitada por algunos usuarios		 cadena SI v2.0 / v3.0
DIANKey Clave técnica DIAN
Requerido por usuarios que llevan su propio control de consecutivo de facturacion
(Solo aparece informacion en este campo si el rango esta diseñado para uso de cosecutivo manual)		 cadena SI v3.0

Notas para migrantes de API v2.0 a v3.0:

  • Se agregó el tipo de documento supportDoc para Documento Soporte DIAN
  • Se agregaron los campos firstDate, lastDate, para tener las fechas iniciales y finales de validez de un rango
  • El objeto DIANKey, contiene la clave tecnica del rango de facturacion, para aquellos usuarios que llevan su propio consecutivo y requieren generar el CUFE/CUDE


A tener presente
  • rangeKey es la llave requerida para enviar solicitud de una factura al sistema
  • Si se solicitan los rangos activos, solamente aparecerá un rango por cada tipo de documento generable

Objetos Empleados

Temas complementarios

Enlaces

Importante

Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.
Si deseas tener un usuario y contraseña , comunícate con nosotros.

Obtenido de «https://wiki.lafactura.co/index.php?title=API_LaFactura.co:Rangos_Facturacion&oldid=1465»