Diferencia entre revisiones de «API LaFactura.co:Estado EC»

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
 
(No se muestran 7 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
−
==Objeto:estado (Verificar Estado de Documento)==
+
==Objeto:verifyStatus (Verificar Estado de Documento)==
 
Si deseas saber como está el proceso de elaboración actual de un documento (Sin importar su tipo), y su último status, puedes hacer la consulta usando '''POST''' en la URL del servicio e incluir el siguiente objeto.
 
Si deseas saber como está el proceso de elaboración actual de un documento (Sin importar su tipo), y su último status, puedes hacer la consulta usando '''POST''' en la URL del servicio e incluir el siguiente objeto.
 
<br><br>
 
<br><br>
Línea 13: Línea 13:
  
 
   {
 
   {
−
       "estado":{
+
       "verifyStatus":{
 
             "tascode":"fc-54984309jtr0ret90jjrg"
 
             "tascode":"fc-54984309jtr0ret90jjrg"
 
       }
 
       }
Línea 30: Línea 30:
 
=====Resultados=====
 
=====Resultados=====
 
----
 
----
−
Devuelve un objeto '''[[API_laFactura.co:invoiceResult|invoiceResult]]''' con el resultado de la operación
+
Devuelve un objeto '''generalResult''' con el resultado de la operación
  
 
   {
 
   {
−
     "invoiceResult":{
+
     "generalResult":{
−
         "estado":{
+
         "status":{
−
           "codigo": 200,
+
           "code": 200,
−
           "error":"Procesado con éxito",
+
           "text":"Procesado con éxito",
 
         },
 
         },
−
         "documento_verificado":{
+
         "document":{
−
           "tipo":"fc",
+
           "type":"invoice",
−
           "estado":"3",
+
           "process":"2",
 
           "tascode":"fc-54984309jtr0ret90jjrg",
 
           "tascode":"fc-54984309jtr0ret90jjrg",
−
           "clave":"2509202501179322705200110010010000001306867832314",
+
           "serial":"2509202501179322705200110010010000001306867832314",
 
           "intID":"2121",
 
           "intID":"2121",
−
           "documento":{
+
           "document":"001-001-000000130",
−
            "estab":"001",
+
          "document_number":{
−
             "punto":"001",
+
             "unit":"001",
−
             "secuencial":"000000130",
+
             "subUnit":"001",
−
             "completo":"001-001-000000130"
+
             "secuence":"000000130",
 
           }
 
           }
−
           "archivos":{
+
           "files":{
 
               "pdf":"https://xxxxx.xxx.com/fc-54984309jtr0ret90jjrg.pdf",
 
               "pdf":"https://xxxxx.xxx.com/fc-54984309jtr0ret90jjrg.pdf",
 
               "zip":"https://xxxxx.xxx.com/fc-54984309jtr0ret90jjrg.zip",
 
               "zip":"https://xxxxx.xxx.com/fc-54984309jtr0ret90jjrg.zip",
Línea 63: Línea 63:
 
*El resultado fue satisfactorio (200)
 
*El resultado fue satisfactorio (200)
 
*El texto del resultado: Procesado con exito
 
*El texto del resultado: Procesado con exito
−
*El tipo de documento fué: fc (factura)
+
*El tipo de documento fué: invoice (factura)
 
*El documento interno es el: fc-54984309jtr0ret90jjrg
 
*El documento interno es el: fc-54984309jtr0ret90jjrg
 
*El intID que nos enviaste fué 2121
 
*El intID que nos enviaste fué 2121
Línea 72: Línea 72:
 
*El estado del documento es: Aceptado SRI
 
*El estado del documento es: Aceptado SRI
  
−
=====estado=====
+
=====status=====
 
----
 
----
 
Entrega la información referente a la operacioón realizada en los siguientes campos:
 
Entrega la información referente a la operacioón realizada en los siguientes campos:
Línea 80: Línea 80:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
|-
 
|-
−
| codigo || valor correspondiente al estado: 200 -> OK || numérico || SI
+
| code || valor correspondiente al estado: 200 -> OK || numérico || SI
 
|-
 
|-
−
| error || texto explicativo del error || cadena || SI
+
| text || texto explicativo del error || cadena || SI
 
|}
 
|}
  
−
=====documento_verificado=====
+
=====document=====
 
----
 
----
 
Información referente al documento al que se hace relación:
 
Información referente al documento al que se hace relación:
Línea 93: Línea 93:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio  
 
! Parámetro !! Descripción !! Tipo !! Obligatorio  
 
|-
 
|-
−
| tipo || Tipo de documento: fc -> factura / nc -> nota crédito / nd -> nota débito || cadena || SI  
+
| type|| Tipo de documento: invoice -> factura / creditNote -> nota crédito / debitNote -> nota débito || cadena || SI  
 
|-
 
|-
−
| estado || Estado actual del documento: 0 -> en cola, 1 -> enviando al sri, 2 -> verificacion, 3-> aprobado || cadena || SI
+
| process || Estado actual del documento: 0 -> en cola, 1 -> enviando al SRI, 2 -> aprobado, mayor o igual a 90 -> En error  (estudio interno) || cadena || SI
 
|-
 
|-
 
| tascode || Código interno del documento generado (Requerido para posteriores acciones)|| cadena || SI
 
| tascode || Código interno del documento generado (Requerido para posteriores acciones)|| cadena || SI
 +
|-
 +
| serial || Clave del documento SRI || cadena || SI
 
|-
 
|-
 
| intID || Código interno del documento en tu base de datos|| cadena || SI
 
| intID || Código interno del documento en tu base de datos|| cadena || SI
 
|-
 
|-
−
| documento || Objeto con la informacion propia del numero del documento || objeto || SI
+
| document || numero del documento || cadena || SI
 +
|-
 +
| document_number || Objeto con la informacion propia del numero del documento desglosada<small><br/>unit -> establecimiento, subUnit -> punto, secuence -> consecutivo</small>|| objeto || SI
 
|-
 
|-
−
| archivos || Enlaces de descarga de los archivos (Si el documento ya está listo)|| cadena || SI/NO
+
| files || Enlaces de descarga de los archivos (Si el documento ya está listo y aprobado)|| cadena || SI/NO
 
|}
 
|}
  
 
==Enlaces==
 
==Enlaces==
−
*LaFactura.co: https://lafactura.co
+
*LaFactura.ec: https://lafactura.ec
−
*GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co
 
  
 
==Importante==
 
==Importante==
 
Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.<br>
 
Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.<br>
 
'''Si deseas tener un usuario y contraseña , comunícate con nosotros.'''
 
'''Si deseas tener un usuario y contraseña , comunícate con nosotros.'''

Revisión actual del 11:28 4 dic 2025

Objeto:verifyStatus (Verificar Estado de Documento)

Si deseas saber como está el proceso de elaboración actual de un documento (Sin importar su tipo), y su último status, puedes hacer la consulta usando POST en la URL del servicio e incluir el siguiente objeto. 

    Ingreso:     
    https://***.tas-la.com/facturacion.ec/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)


IMPORTANTE: Recomendamos ampliamente que utilizes nuestro sistema de WEBHOOKS, para recibir notificaciones en tiempo real. 

 {
      "verifyStatus":{
           "tascode":"fc-54984309jtr0ret90jjrg"
      }
 }
Campos

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

Parámetro Descripción Tipo Obligatorio
tascode Código único en nuestro sistema del documento cadena SI
Resultados

Devuelve un objeto generalResult con el resultado de la operación 

 {
   "generalResult":{
       "status":{
          "code": 200,
          "text":"Procesado con éxito",
       },
       "document":{
          "type":"invoice",
          "process":"2",
          "tascode":"fc-54984309jtr0ret90jjrg",
          "serial":"2509202501179322705200110010010000001306867832314",
          "intID":"2121",
          "document":"001-001-000000130",
          "document_number":{
            "unit":"001",
            "subUnit":"001",
            "secuence":"000000130",
          }
          "files":{
             "pdf":"https://xxxxx.xxx.com/fc-54984309jtr0ret90jjrg.pdf",
             "zip":"https://xxxxx.xxx.com/fc-54984309jtr0ret90jjrg.zip",
             "xml":"https://xxxxx.xxx.com/fc-54984309jtr0ret90jjrg.xml"
          }
       }
    }
 }
Explicacion
  • El resultado fue satisfactorio (200)
  • El texto del resultado: Procesado con exito
  • El tipo de documento fué: invoice (factura)
  • El documento interno es el: fc-54984309jtr0ret90jjrg
  • El intID que nos enviaste fué 2121
  • La clave del documento es: 2509202501179322705200110010010000001306867832314
  • La url para descarga el documento es: https://xxxxx.xxx.com/fc-54984309jtr0ret90jjrg.zip
  • La url para descarga del pdf: https://xxxxx.xxx.com/fc-54984309jtr0ret90jjrg.pdf
  • La url para descarga del xml: https://xxxxx.xxx.com/fc-54984309jtr0ret90jjrg.xml
  • El estado del documento es: Aceptado SRI
status

Entrega la información referente a la operacioón realizada en los siguientes campos:

Parámetro Descripción Tipo Obligatorio
code valor correspondiente al estado: 200 -> OK numérico SI
text texto explicativo del error cadena SI
document

Información referente al documento al que se hace relación:

Parámetro Descripción Tipo Obligatorio
type Tipo de documento: invoice -> factura / creditNote -> nota crédito / debitNote -> nota débito cadena SI
process Estado actual del documento: 0 -> en cola, 1 -> enviando al SRI, 2 -> aprobado, mayor o igual a 90 -> En error (estudio interno) cadena SI
tascode Código interno del documento generado (Requerido para posteriores acciones) cadena SI
serial Clave del documento SRI cadena SI
intID Código interno del documento en tu base de datos cadena SI
document numero del documento cadena SI
document_number Objeto con la informacion propia del numero del documento desglosada
unit -> establecimiento, subUnit -> punto, secuence -> consecutivo		 objeto SI
files Enlaces de descarga de los archivos (Si el documento ya está listo y aprobado) cadena SI/NO

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:Estado_EC&oldid=3098»