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

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
(Página creada con «==Informes== Este método en modo <b>beta</b>, te permite descargar informes con relación a documentos almacenados en el sistema. Este servicio consta de una consulta por…»)
 
 
(No se muestran 8 ediciones intermedias del mismo usuario)
Línea 18: Línea 18:
 
           "firstDate":"200230801",
 
           "firstDate":"200230801",
 
           "lastDate":"20230830",
 
           "lastDate":"20230830",
−
           "groups":"invoices",
+
           "groups":"all",
 +
          "columns":"fdocumento,documento,clientes,total,doctype,tascode",
 
           "email":"[email protected]"
 
           "email":"[email protected]"
 
         }
 
         }
Línea 36: Línea 37:
 
| lastDate || fecha final para el listado<br/><small>(YYYYMMDD) Año Mes Dia. Ejemplo: 20231021</small> || 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 || 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/>fcncdc -> Facturas Notas Crédito y Débito<br/>dsda -> Documentos Soporte y de Ajuste<br/>all -> Todos</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 || 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
+
| 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<br/><br/><b>Puedes enviar varias columnas separadas por coma (,)</b></small> || cadena || SI || v3.0
 +
|-
 +
| email || Correo en el cual deseas recibir el archivo || cadena || SI || v3.0
 
|}
 
|}
  
Línea 49: Línea 52:
 
               "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 21:07 16 nov 2023

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":{
          "method":"documents",
          "firstDate":"200230801",
          "lastDate":"20230830",
          "groups":"all",
          "columns":"fdocumento,documento,clientes,total,doctype,tascode",
          "email":"[email protected]"
       }
   }

Objeto

Parámetro Descripción Tipo Obligatorio API
method Corresponde al tipo de listado. Las posibles opciones son:
documents -> detallado documentos generados		 cadena SI v3.0
firstDate fecha inicial para el listado
(YYYYMMDD) Año Mes Dia. Ejemplo: 20231021		 cadena SI v3.0
lastDate fecha final para el listado
(YYYYMMDD) Año Mes Dia. Ejemplo: 20231021		 cadena SI v3.0
groups
method:documents		 Corresponde a los tipos de documentos en el listado. Las posibles opciones son:
fc -> Facturas
nc -> Notas Crédito
nd -> Notas Débito
ds -> Documentos Soporte
da -> Documentos de Ajuste
fcncnd -> Facturas Notas Crédito y Débito
dsda -> Documentos Soporte y de Ajuste
all -> Todos		 cadena SI v3.0
columns
method:documents		 Columnas en el listado. Las posibles opciones son:
fcreacion -> Fecha de creación en el sistema
fdocumento -> Fecha reportada de creacion del documento a la DIAN
documento -> Documento generado
cliente -> Nombre del cliente
idcliente -> Identificación del cliente
subtotal -> Sobtotal del documento
impuestos -> total de impuestos cobrados
total -> total global del documento
cufe -> Código del documento en la DIAN
tascode -> Código del documento en nuestro sistema
doctype -> Tipo de documento

Puedes enviar varias columnas separadas por coma (,)		 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=2530»