API LaFactura.co:Verificar Factura

De API LaFactura.co
Ir a la navegación Ir a la búsqueda

Objeto:verifyStatus (Verificar Documento)

Si deseas saber como está el proceso de elaboración actual de la factura, y su último status, puedes hacer la consulta usando GET en la URL del servicio e incluir el siguiente objeto.

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 invoiceResult con el resultado de la operación 

 {
   "invoiceResult":{
       "status":{
          "code": 200,
          "text":"Operación realizada con exito",
       },
       "document":{
          "type":"Factura",
          "mode":"Verify",
          "tascode":"fc-54984309jtr0ret90jjrg",
          "document":"FC-2092092",
          "CUFE":"43059843095203948093248093483048039248093403298409328490348903483094",
          "URL":"https://secure.lafactura.co/warehouseX/fc-54984309jtr0ret90jjrg.zip",
          "CHECK":"https://secure.lafactura.co/warehouseX/fc-54984309jtr0ret90jjrg-I.zip",
          "PDF":"https://secure.lafactura.co/warehouseX/fc-54984309jtr0ret90jjrg.pdf",
          "process":2,
          "accepted":"Aceptada"
       }
   }
 }
Explicacion
  • El resultado fue satisfactorio (200)
  • El texto del resultado: Operación realizada con exito
  • El tipo de documento fué: Factura
  • El modolo de respuesta fué el de verificacion
  • El documento interno es el: fc-54984309jtr0ret90jjrg
  • El cufe del documento es: 43059843095203948093248093483048039248093403298409328490348903483094
  • La url para decarga el documento es: https://secure.lafactura.co/warehouseX/fc-54984309jtr0ret90jjrg.zip
  • La url para decarga de las validaciones DIAN es: https://secure.lafactura.co/warehouseX/fc-54984309jtr0ret90jjrg-I.zip
  • La url para decarga del pdf: https://secure.lafactura.co/warehouseX/fc-54984309jtr0ret90jjrg.pdf
  • El estado del documento es: Aceptado DIAN
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
consultar tabla		 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: "Factura" ó "Nota Credito" cadena SI
mode Resultado por "Creation"->Creación / "Verify"->Verificación cadena SI
tascode Código interno del documento generado (Requerido para posteriores acciones) cadena SI
referal Código de documento enlazado (Una nota crédito o factura a este documento) cadena NO
document Número de la Factura o Nota Credito cadena SI
CUFE Código único de la factura DIAN cadena Solo en facturas
CUDE Código único de documento electrónico DIAN cadena Solo en Notas Crédito
process Estado de proceso 0 -> Enviando / 1 -> Verificando / 2 -> Aceptado DIAN // Mayor que 90 -> Rechazado DIAN cadena SI
accepted Estado de aceptacion del documento por el cliente final Desconocida / Aceptada / Rechazada cadena SI
URL Dirección para descarga del Documento aceptado por la DIAN (formato ZIP)
Contiene PDF (Representación gráfica del Documento)
Contiene XML (Attached Document DIAN del Documento)		 cadena Solo si está Aceptado por la DIAN
CHECK Dirección para descarga de los resultados del documento en la DIAN (formato ZIP)
Contiene XXXXXXXXX-DE.xml (Documento firmado enviado a la DIAN)
Contiene XXXXXXXXX-R(1/2).xml (Resultado puro de la transacción en la DIAN)		 cadena Solo si está Aceptado por la DIAN
PDF Dirección para descarga del PDF de la factura generada
Esta opción se agrega para ayudar a algunos sistemas.
Sin embargo, el documento legal a ser almacenado por cualquier interesado es el que se encuentra en URL		 cadena Solo si está Aceptado por la DIAN
(Solo para documentos generados desde Enero 10 - 2021)
A tener presente
  • No se debe considerar un documento como válido por la DIAN, hasta que el resultado de una verificación del documento, muestre a process con: 2
Objetos adicionales empleados

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:Verificar_Factura&oldid=1036»