API LaFactura.co:Modificar Rangos
Ir a la navegación
Ir a la búsqueda
Sumario
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
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.