POST /api/emisores/software/{id}/crear-nomina-prueba/

POST /api/emisores/software/{id}/crear-nomina-prueba/

Crea una nómina de prueba en borrador para este software.

POST /api/emisores/software/{id}/crear-nomina-prueba/, con {"consecutivo": <n>} opcional.

Es la misma que siembra el alta, pero de una en una: sirve para completar un Set de Pruebas al que le faltan nóminas. Solo sobre un software de nómina; los documentos de prueba de facturación se crean desde su resolución, que es quien los numera.

Sin consecutivo toma el siguiente libre del emisor para el prefijo de pruebas. El periodo de liquidación continúa la serie hacia atrás —la regla 90 rechaza dos nóminas del mismo trabajador para el mismo periodo—. La nómina no se edita: si hace falta otro periodo, se borra el borrador y se crea por POST /api/nomina/nomina/ con el que toque.

Solo la crea: no la firma ni la envía. Para eso está emitir de /api/nomina/nomina/{id}/, que firma y envía.

operationId: emisores_software_crear_nomina_prueba_create

Autenticación

Cualquiera de estas credenciales:

• LlaveApi — Llave de API de una integración. El valor completo es Api-Key <prefijo>.<secreto>, tal como lo imprime manage.py crear_llave_api. La llave alcanza exactamente los mismos emisores que la persona a cuyo nombre se creó.

Parámetros

Nombre	En	Tipo	Obligatorio	Descripción
id	path	integer	sí	Un valor de entero único que identifique este software DIAN.

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio.

Campos

Campo	Tipo	Obligatorio	Descripción
emisor	integer	sí
tipo	any	sí	Operación que habilita: facturación, nómina electrónica o documento equivalente. * facturacion - Facturación electrónica * nomina - Nómina electrónica * documento_equivalente - Documento equivalente electrónico
identificador	string	sí	SoftwareID asignado por la DIAN.
pin	string	sí
test_set_id	string	no	TestSetId entregado por la DIAN para la habilitación.
set_pruebas_aceptado	boolean	no	Cuando la DIAN acepta el Set de Pruebas, los envíos pasan a SendBillSync (síncrono) en vez de SendTestSetAsync.
codigo_proveedor_tecnologico	string	no	Los tres dígitos que la DIAN asigna al proveedor tecnológico. Van en el nombre de todos los archivos del documento equivalente (numeral 8.13.5); con software propio suele ser 000.
fabricante_nombre	string	no	Par NombreApellido. Vacío usa DIAN_FABRICANTE_NOMBRE.
fabricante_razon_social	string	no	Par RazonSocial. Vacío usa DIAN_FABRICANTE_RAZON_SOCIAL. No es la razón social del emisor.
fabricante_nombre_software	string	no	Par NombreSoftware. Vacío usa DIAN_FABRICANTE_NOMBRE_SOFTWARE.

Ejemplo

curl -X POST "https://api.rededoc.uk/api/emisores/software/<id>/crear-nomina-prueba/" \
  -H "Authorization: <llaveapi>" \
  -H "Content-Type: application/json" \
  -d '{
    "emisor": 1,
    "tipo": null,
    "identificador": "texto",
    "pin": "texto",
    "test_set_id": "texto",
    "set_pruebas_aceptado": true,
    "codigo_proveedor_tecnologico": "texto",
    "fabricante_nombre": "texto",
    "fabricante_razon_social": "texto",
    "fabricante_nombre_software": "texto"
  }'

Respuestas

Código	Descripción
200
400	Error
401	Error
404	Error
429	Error

200 — cuerpo

Campo	Tipo	Descripción
id	integer	Solo lectura.
emisor	integer
tipo	any	Operación que habilita: facturación, nómina electrónica o documento equivalente. * facturacion - Facturación electrónica * nomina - Nómina electrónica * documento_equivalente - Documento equivalente electrónico
identificador	string	SoftwareID asignado por la DIAN.
test_set_id	string	TestSetId entregado por la DIAN para la habilitación.
set_pruebas_aceptado	boolean	Cuando la DIAN acepta el Set de Pruebas, los envíos pasan a SendBillSync (síncrono) en vez de SendTestSetAsync.
codigo_proveedor_tecnologico	string	Los tres dígitos que la DIAN asigna al proveedor tecnológico. Van en el nombre de todos los archivos del documento equivalente (numeral 8.13.5); con software propio suele ser 000.
fabricante_nombre	string	Par NombreApellido. Vacío usa DIAN_FABRICANTE_NOMBRE.
fabricante_razon_social	string	Par RazonSocial. Vacío usa DIAN_FABRICANTE_RAZON_SOCIAL. No es la razón social del emisor.
fabricante_nombre_software	string	Par NombreSoftware. Vacío usa DIAN_FABRICANTE_NOMBRE_SOFTWARE.

{
  "id": 1,
  "emisor": 1,
  "tipo": null,
  "identificador": "texto",
  "test_set_id": "texto",
  "set_pruebas_aceptado": true,
  "codigo_proveedor_tecnologico": "texto",
  "fabricante_nombre": "texto",
  "fabricante_razon_social": "texto",
  "fabricante_nombre_software": "texto"
}

400 — cuerpo

Campo	Tipo	Descripción
detail	string	Mensaje para mostrar a la persona.
errores	array<object>	Nunca vacía. Cada error trae codigo, que es lo que el cliente mapea —los de DRF tal cual (required, invalid, does_not_exist, not_found…) y los propios en español (campo_desconocido, solicitud_invalida…)—, y mensaje, para la persona. Si el error es de un campo, su ruta va delante del mensaje: detalles[0].impuestos[0].tributo: Este campo es obligatorio.

{
  "detail": "texto",
  "errores": [
    {
      "codigo": "texto",
      "mensaje": "texto"
    }
  ]
}

401 — cuerpo

Campo	Tipo	Descripción
detail	string	Mensaje para mostrar a la persona.
errores	array<object>	Nunca vacía. Cada error trae codigo, que es lo que el cliente mapea —los de DRF tal cual (required, invalid, does_not_exist, not_found…) y los propios en español (campo_desconocido, solicitud_invalida…)—, y mensaje, para la persona. Si el error es de un campo, su ruta va delante del mensaje: detalles[0].impuestos[0].tributo: Este campo es obligatorio.

{
  "detail": "texto",
  "errores": [
    {
      "codigo": "texto",
      "mensaje": "texto"
    }
  ]
}

404 — cuerpo

Campo	Tipo	Descripción
detail	string	Mensaje para mostrar a la persona.
errores	array<object>	Nunca vacía. Cada error trae codigo, que es lo que el cliente mapea —los de DRF tal cual (required, invalid, does_not_exist, not_found…) y los propios en español (campo_desconocido, solicitud_invalida…)—, y mensaje, para la persona. Si el error es de un campo, su ruta va delante del mensaje: detalles[0].impuestos[0].tributo: Este campo es obligatorio.

{
  "detail": "texto",
  "errores": [
    {
      "codigo": "texto",
      "mensaje": "texto"
    }
  ]
}

429 — cuerpo

Campo	Tipo	Descripción
detail	string	Mensaje para mostrar a la persona.
errores	array<object>	Nunca vacía. Cada error trae codigo, que es lo que el cliente mapea —los de DRF tal cual (required, invalid, does_not_exist, not_found…) y los propios en español (campo_desconocido, solicitud_invalida…)—, y mensaje, para la persona. Si el error es de un campo, su ruta va delante del mensaje: detalles[0].impuestos[0].tributo: Este campo es obligatorio.

{
  "detail": "texto",
  "errores": [
    {
      "codigo": "texto",
      "mensaje": "texto"
    }
  ]
}