Diferencia entre revisiones de «API LaFactura.co:Verificar Nomina»

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
Línea 7: Línea 7:
  
 
<br><br>
 
<br><br>
−
 
 
'''IMPORTANTE:''' Recomendamos ampliamente que utilizes nuestro sistema de '''[[API_LaFactura.co:Webhook|WEBHOOKS]]''', para recibir notificaciones en tiempo real.
 
'''IMPORTANTE:''' Recomendamos ampliamente que utilizes nuestro sistema de '''[[API_LaFactura.co:Webhook|WEBHOOKS]]''', para recibir notificaciones en tiempo real.
  

Revisión del 17:16 22 sep 2021

Objeto:verificarEstado (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/nomina.v10/general/



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

 {
      "verificarEstado":{
           "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 resultadoNomina con el resultado de la operación
Importante: Verifica toda la informacion que resultadoNomina devuelve ingresando al objeto. 

 {
   "resultadoGeneral":{
       "status":{
          "code": 200,
          "text":"Operación realizada con exito",
       },
       "document":{
          "type":"Nomina Individual",
          "mode":"Verify",
          "tascode":"ni-54984309jtr0ret90jjrg",
          "intID":"1",
          "document":"NOM-2092092",
          "process":"2",
          "retries":"0",
          "CUNE":"43059843095203948093248093483048039248093403298409328490348903483094",
          "URL":"https://secure.lugar.co/warehouseX/ni-54984309jtr0ret90jjrg.zip",
          "PDF":"https://secure.lugar.co/warehouseX/ni-54984309jtr0ret90jjrg.pdf",
          "ATTACHED":"https://secure.lugar.co/warehouseX/ni-54984309jtr0ret90jjrg-A.xml",
          "customer":"0"
       }
   }
 }
Explicacion
  • El resultado fue satisfactorio (200)
  • El texto del resultado: Operación realizada con exito
  • El tipo de documento fué: Nómina Indivual
  • El modolo de respuesta fué el de verificacion
  • El documento interno es el: ni-54984309jtr0ret90jjrg
  • El intID que nos enviaste fué 1
  • El cufe del documento es: 43059843095203948093248093483048039248093403298409328490348903483094
  • La url para decarga el documento es: https://secure.lugar.co/warehouseX/fc-54984309jtr0ret90jjrg.zip
  • La url para decarga del pdf: https://secure.lugar.co/warehouseX/fc-54984309jtr0ret90jjrg.pdf
  • La url para decarga del xml del documento enviado al cliente: https://secure.lugar.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: "Nomina Individual" / "Nomina Ajuste" cadena SI v1.0
mode Resultado por "Creation"->Creación / "Verify"->Verificación cadena SI v1.0
tascode Código interno del documento generado (Requerido para posteriores acciones) cadena SI v1.0
intID Código interno del documento en tu base de datos cadena SI v1.0
document Número del documento cadena SI v1.0
CUNE Código único del documento en la DIAN cadena SI v1.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 v1.0
retries Reintentos de envio a la DIAN cadena SI v3.0
customer Estado de aceptacion del documento por el trabajador
0->Desconocido, 1->Aceptado, 2->Rechazado		 cadena SI v1.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 v1.0
PDF Dirección para descarga del PDF del documento generado
Esta opción se agrega para ayudar a algunos sistemas.
Recomendamos almacenar el resultado de URL		 cadena Solo si está Aceptado por la DIAN
 v1.0
ATTACHED Dirección para descarga del XML del xml enviado al trabajador
Esta opción se agrega para ayudar a algunos sistemas.
Recomendamos almacenar el resultado de URL		 cadena Solo si está Aceptado por la DIAN v1.0 / v3.0
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 empleados

Usado por

Los siguientes recursos:

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_Nomina&oldid=1929»