API LaFactura.co:Modificar Rangos

Objeto:setRange (Modificar Rangos del sistema)

Se utiliza para cambiar el estado de algunos rangos asi como las descripciones almacenadas. Este servicio es por el método POST

    Ingreso:     
    https://***.tas-la.com/facturacion.v30/general/
     
    Solicita tu usuario y contraseña +57-601-7466664
    No cobramos por el proceso de pruebas o desarrollo
    Y puedes empezar inmediatamente (sin certificados o papeleos)

 {
      "setRange":{
           "rangeKey":"rk-98349384983849384984",
           "setMode":"active",
           "setDescription":"Prueba",
      }
 }

Objeto

Envía la información referente al rango a modificar

Parámetro	Descripción	Tipo	Obligatorio	API
rangeKey	Llave del rango que deseo modificar	cadena	SI	v3.0
setMode	Nuevo modo de operación: active ->Activo reserved-> Reservado	cadena	NO	v3.0
last	Ultimo documento generado Permite correr el consecutivo hacia adelante .. pero NUNCA hacia atrás Febrero 2023	cadena	NO	v3.0
setDescription	Descripcion del rango Texto adicional descriptivo del rango (cadena libre)	cadena	NO	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-98349384983849384984",
                   "type":"invoice",
                   "mode":"active",
                   "prefix":"SETP",
                   "from":"990000000",
                   "to":"995000000",
                   "last":"990000102",
                   "remaining":"4999898",
                   "firstDate":"20200223",
                   "lastDate":"20210223",
                   "description":"Prueba",
                   "DIANKey":"opwqpo0-23912-03921-03912309"
                 }
             ]
         }
      }

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	cadena	SI	v3.0
type	Tipo de rango invoice -> Factura debitNote -> Nota Debito creditNote -> Nota Credito supportDoc -> documento soporte (nuevo API v3.0)	cadena	SI	v3.0
mode	Modo actual del rango active -> activo inactive -> Inactivo reserved -> Reservado	cadena	SI	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	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

• generalResult: Resultado General

Temas complementarios

• Procesos Generales

Enlaces

• LaFactura.co: https://lafactura.co
• GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co

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.