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.