API LaFactura.co:Verificar Factura

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",
          "ATTACHED":"https://secure.lafactura.co/warehouseX/fc-54984309jtr0ret90jjrg-A.xml",
          "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
• La url para decarga del xml del documento enviado al cliente: https://secure.lafactura.co/warehouseX/fc-54984309jtr0ret90jjrg-A.xml
• 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

• invoiceResult: Resultado Factura

Temas complementarios

• Facturación
• Webhooks

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.