API LaFactura.co:ResultadoNomina
Revisión del 12:23 20 ago 2021 de Srvadmin (discusión | contribuciones) (Página creada con «==Objeto: resultadoNomina== Entrega la información básica correspondiente a un documento en el sistema. Es el resultado ante cualquier operacion relacionada con nomina.…»)
Sumario
Objeto: resultadoNomina
Entrega la información básica correspondiente a un documento en el sistema. Es el resultado ante cualquier operacion relacionada con nomina.
Ejemplo
Es el resultado ante los eventos de Generar, Anular o Verificar nomina
{
"resultadoNomina":{
"status":{
"code":200,
"text":"Operación realizada con exito"
},"
documento":{
"type":"nominaIndividual",
"mode":"Creation",
"tascode":"ni-969527772dbe01117b63a3ef6aec715a-v300",
"intID":"ni-20210820121642",
"document":"NOM156",
"CUNE":"b84b1889239498d4b1f34a63bec5290589a3aa880a9eaa5ab36a6837ae66bf649325130500dec0cbacc0b4c513f00df6",
"process":"0",
"retries":"0",
"customer":"0"
}
}
}
Explicacion
- El resultado fue exitoso (200)
- En texto: Operación realizada con exito
- Se trata de un comprobante de nomina
- El resultado fue en la operacion de creacion de nomina
- El codigo interno del documento es: ni-969527772dbe01117b63a3ef6aec715a-v300
- El documento generado es: NOM156
- El CUNE del documento: b84b1889239498d4b1f34a63bec5290589a3aa880a9eaa5ab36a6837ae66bf649325130500dec0cbacc0b4c513f00df6
- El estado actual del documento es: "Enviando"
- El numero de reintentos es 0
status
Entrega la información referente a la operacioón realizada en los siguientes campos:
| Parámetro | Descripción | Tipo | Obligatorio | API |
|---|---|---|---|---|
| code | valor correspondiente al estado: 200 -> OK consultar tabla |
numérico | SI | v2.0 / v3.0 |
| text | texto explicativo del error | cadena | SI | v2.0 / v3.0 |
documento
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 |
| 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 |
| 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:
- Se agregó retries, el cual permite conocer el numero de reintentos de envio de un documento a la DIAN
- Se agredó customer para conocer el estado de aceptacion o rechazo de un documento por pargte del cliente final
- Se eliminó accepted
- Se eliminó referal
A tener presente
- Puede tener objetos adicionales en su respuesta (Verifica el recurso usado para su llamado)
Usado por
Los siguientes recursos:
Temas complementarios
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.