POST /api/emisores/software/{id}/crear-nota-ajuste-prueba/

POST /api/emisores/software/{id}/crear-nota-ajuste-prueba/

Crea 11 notas de ajuste de prueba en borrador para este software.

POST /api/emisores/software/{id}/crear-nota-ajuste-prueba/, sin cuerpo.

Recorre las nóminas del emisor y toma la más reciente que esté aceptada por la DIAN y sin errores; sobre ella crea las once notas, de reemplazo (TipoNota 1) e idénticas a la original. Si no hay ninguna así, responde 400 y no crea nada. Solo sobre un software de nómina, y con el emisor todavía en pruebas.

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

operationId: emisores_software_crear_nota_ajuste_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-nota-ajuste-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"
    }
  ]
}