Diferencia entre revisiones de «API LaFactura.co:Informes»

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
 
(No se muestran 5 ediciones intermedias del mismo usuario)
Línea 15: Línea 15:
 
     {
 
     {
 
       "lists":{
 
       "lists":{
−
           "method":"documents",
+
           "year":"2025",
−
           "firstDate":"200230801",
+
           "month":"02",
−
          "lastDate":"20230830",
 
−
          "groups":"invoices",
 
−
          "columns":"fdocumento,documento,clientes,total,doctype,tascode",
 
 
           "email":"[email protected]"
 
           "email":"[email protected]"
 
         }
 
         }
Línea 31: Línea 28:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio !! API
 
! Parámetro !! Descripción !! Tipo !! Obligatorio !! API
 
|-
 
|-
−
| method || Corresponde al tipo de listado. Las posibles opciones son:<br/><small>documents -> detallado documentos generados</small> || cadena || SI || v3.0
+
| year || Año del cual deseas el listado || cadena || SI || v3.0
 
|-
 
|-
−
| firstDate || fecha inicial para el listado<br/><small>(YYYYMMDD) Año Mes Dia. Ejemplo: 20231021</small> || cadena || SI || v3.0
+
| month || Mes del cual deseas el listado || cadena || SI || v3.0
−
|-
 
−
| lastDate || fecha final para el listado<br/><small>(YYYYMMDD) Año Mes Dia. Ejemplo: 20231021</small> || cadena || SI || v3.0
 
−
|-
 
−
| groups<br/>method:documents || Corresponde a los tipos de documentos en el listado. Las posibles opciones son:<br/><small>fc -> Facturas<br/>nc -> Notas Crédito<br/>nd -> Notas Débito<br/>ds -> Documentos Soporte </br/>da -> Documentos de Ajuste<br/>fcncnd -> Facturas Notas Crédito y Débito<br/>dsda -> Documentos Soporte y de Ajuste<br/>all -> Todos</small> || cadena || SI || v3.0
 
−
|-
 
−
| columns<br/>method:documents || Columnas en el listado. Las posibles opciones son:<br/><small>fcreacion -> Fecha de creación en el sistema<br/>fdocumento -> Fecha reportada de creacion del documento a la DIAN<br/>documento -> Documento generado<br/>cliente -> Nombre del cliente<br/>idcliente -> Identificación del cliente<br/>subtotal -> Sobtotal del documento<br/>impuestos -> total de impuestos cobrados<br/>total -> total global del documento<br/>cufe -> Código del documento en la DIAN<br/>tascode -> Código del documento en nuestro sistema<br/>doctype -> Tipo de documento</small> || cadena || SI || v3.0
 
 
|-
 
|-
 
| email || Correo en el cual deseas recibir el archivo || cadena || SI || v3.0
 
| email || Correo en el cual deseas recibir el archivo || cadena || SI || v3.0
Línea 52: Línea 43:
 
               "status":{
 
               "status":{
 
                 "code":200,
 
                 "code":200,
−
                 "text":"Operación realizada con exito"
+
                 "text":"Documento en generación"
−
              },
 
−
              "TRM":{
 
−
                  "legal":{"rate":"3792.13","date":"20200821"},
 
−
                  "next":null,
 
−
                  "last30":[
 
−
                    {"rate":"3792.13","date":"20200821"},{"rate":"3766.73","date":"20200820"},{"rate":"3784.15","date":"20200819"},{"rate":"3783.15","date":"20200815"},
 
−
                    {"rate":"3767.05","date":"20200814"},{"rate":"3755.61","date":"20200813"},{"rate":"3749.3","date":"20200812"},{"rate":"3770.22","date":"20200811"},
 
−
                    {"rate":"3769.67","date":"20200807"},{"rate":"3775.95","date":"20200806"},{"rate":"3792.98","date":"20200805"},{"rate":"3768.39","date":"20200804"},
 
−
                    {"rate":"3733.08","date":"20200801"},{"rate":"3739.49","date":"20200731"},{"rate":"3716.89","date":"20200730"},{"rate":"3718.69","date":"20200729"},
 
−
                    {"rate":"3679.17","date":"20200728"},{"rate":"3690.80","date":"20200725"},{"rate":"3660.15","date":"20200724"},{"rate":"3627.28","date":"20200723"},
 
−
                    {"rate":"3628.20","date":"20200722"},{"rate":"3651.93","date":"20200718"},{"rate":"3627.86","date":"20200717"},{"rate":"3611.61","date":"20200716"},
 
−
                    {"rate":"3638.22","date":"20200715"},{"rate":"3617.22","date":"20200714"},{"rate":"3615.75","date":"20200711"},{"rate":"3633.42","date":"20200710"},
 
−
                    {"rate":"3625.61","date":"20200709"},{"rate":"3631.54","date":"20200708"}
 
−
                  ]
 
 
               }
 
               }
 
           }
 
           }
 
       }
 
       }
  
−
====TRM====
 
−
-----
 
−
Información referente a la TRM:
 
−
 
−
{| class="wikitable"
 
−
|-
 
−
! Parámetro !! Descripción !! Tipo !! Obligatorio !! API
 
−
|-
 
−
| legal || Tasa de cambio vigente.<br/><small>Contiene dos campos: rate->tasa, date->fecha de dicha tasa</small> || objeto || SI || v2.0 / v3.0
 
−
|-
 
−
| next || Siguiente Tasa de cambio. (Permite conocer con antelación la proxima tasa de cambio) <br/><small>Contiene dos campos: rate->tasa, date->fecha de dicha tasa<br/>Normalmente está disponible al final de la tarde del dia anterior<br/>En NULL cuando no está disponible</small>  || objeto || SI|| v2.0 / v3.0
 
−
|-
 
−
| last30 || Arreglo de objetos con las ultimas 30 TRMs publicadas || arreglo || SI|| v2.0 / v3.0
 
−
|}
 
−
<span style="color:#009999"><b>Notas para migrantes de API v2.0 a v3.0:</b></span>
 
−
----
 
−
* No hay cambios en este objeto<br/>
 
−
<br/>
 
−
 
−
====Objetos adicionales empleados====
 
 
-----
 
-----
 
*generalResult: [[API_laFactura.co:generalResult|Resultado General]]
 
*generalResult: [[API_laFactura.co:generalResult|Resultado General]]

Revisión actual del 20:36 14 jul 2025

Informes

Este método en modo beta, te permite descargar informes con relación a documentos almacenados en el sistema. Este servicio consta de una consulta por el método POST y devuelve el resultado a un correo electrónico seleccionado 

    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)


Listados

Obtener un listado específico 

   {
      "lists":{
          "year":"2025",
          "month":"02",
          "email":"[email protected]"
       }
   }

Objeto

Parámetro Descripción Tipo Obligatorio API
year Año del cual deseas el listado cadena SI v3.0
month Mes del cual deseas el listado cadena SI v3.0
email Correo en el cual deseas recibir el archivo cadena SI v3.0

Resultados

Devuelve un objeto generalResult con el resultado de la operación y la información referente al ID 

    {
         "generalResult":{
             "status":{
                "code":200,
                "text":"Documento en generación"
              }
          }
      }

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:Informes&oldid=2849»