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 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.v30/invoice/
     
    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 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",
          "intID":"1",
          "document":"FC-2092092",
          "process":"2",
          "retries":"0",
          "CUFE":"43059843095203948093248093483048039248093403298409328490348903483094",
          "URL":"https://secure.lafactura.co/warehouseX/fc-54984309jtr0ret90jjrg.zip",
          "PDF":"https://secure.lafactura.co/warehouseX/fc-54984309jtr0ret90jjrg.pdf",
          "ATTACHED":"https://secure.lafactura.co/warehouseX/fc-54984309jtr0ret90jjrg-A.xml",
          "customer":"0",
          "RADIAN":{
             "short":"030;032;033",
             "enhanced":[
                  {
                    "responseCode":"030",
                    "description":"Acuse de recibido de Factura Electrónica de Venta",
                    "date":"20231102",
                    "time":"115810",
                    "UUID":"f025e1aezbaab1f7207974e0dfa27862ba8e2ebb990222d6400fd21547917bdf9c90a2aca11efaa56e38d5e3901826bb"
                  },
                  {
                    "responseCode":"032",
                    "description":"Recibido del bien o prestación del servicio",
                    "date":"20231108",
                    "time":"081812",
                    "UUID":"da403930494ab1f7207974e0dfa27862ba8e2ebb990222d6400fd21547917bdf9c90a2aca11efaa56e38d5e390123012"
                  },
                  {
                    "responseCode":"033",
                    "description":"Aceptación expresa",
                    "date":"20231108",
                    "time":"081832",
                    "UUID":"da4039fx494ab1f7207974e0dfa27862ba8e2ebb990222d6400fd21547917bdf9c90a2aca11efaa56e38d5e390182aaa"
                  }
             ]
          }
       }
   }
 }
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 intID que nos enviaste fué 1
  • 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
  • Se reintentó .. 0 veces
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 API
type Tipo de documento: "Factura" / "Factura Salud" / "Nota Credito" / "Documento Soporte" cadena SI v2.0 / v3.0
mode Resultado por "Creation"->Creación / "Verify"->Verificación cadena SI v2.0 / v3.0
tascode Código interno del documento generado (Requerido para posteriores acciones) cadena SI v2.0 / v3.0
intID Código interno del documento en tu base de datos cadena SI v2.0 / v3.0
referal Código de documento enlazado (Una nota crédito o factura a este documento)
Eliminado de API v3.0		 cadena NO v2.0 / v3.0
document Número del documento cadena SI v2.0 / v3.0
CUFE Código único de la factura DIAN cadena En facturas v2.0 / v3.0
CUDE Código único de documento electrónico DIAN cadena Para cualquier documento diferente a factura v2.0 / v3.0
process Estado de proceso:
0 -> Enviando
1 -> Verificando
2 -> Aceptado DIAN
78 -> Reintentando DIAN (API v3.0)
Mayor que 90 -> Rechazado DIAN		 cadena SI v2.0 / v3.0
retries Reintentos de envio a la DIAN cadena SI v3.0
accepted Estado de aceptacion del documento por el cliente final
Desconocida / Aceptada / Rechazada
(Campo retirado en API v3.0)		 cadena SI v2.0
customer Estado de aceptacion del documento por el cliente final
0->Desconocido, 1->Aceptado, 2->Rechazado
(Nuevo campo en API v3.0)		 cadena SI v3.0
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 v2.0 / v3.0
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 v2.0 / v3.0
PDF Dirección para descarga del PDF de la factura generada
Esta opción se agrega para ayudar a algunos sistemas.
Recomendamos almacenar el resultado de URL		 cadena Solo si está Aceptado por la DIAN
(Solo para documentos generados desde Enero 10 - 2021)		 v2.0 / v3.0
ATTACHED Dirección para descarga del XML del xml enviado al cliente
Esta opción se agrega para ayudar a algunos sistemas.
Recomendamos almacenar el resultado de URL		 cadena Solo si está Aceptado por la DIAN
(Solo para documentos generados desde Enero 10 - 2021)		 v2.0 / v3.0

Notas para migrantes de API v2.0 a v3.0:

  • Puedes saber el nivel de reintentos hechos a un documento
  • Se eliminó el campo de referal


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=2595»