GET /api/emisores/software/{id}/

GET /api/emisores/software/{id}/

Restringe un ViewSet a los emisores que alcanza el solicitante.

Filtra el queryset en lectura y comprueba el emisor recibido en escritura, de modo que nadie pueda ni ver ni crear datos de un emisor ajeno.

campo_emisor es la ruta ORM del modelo hasta el emisor ("emisor" en casi todos; "id" cuando el propio modelo es el emisor).

operationId: emisores_software_retrieve

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.

Ejemplo

curl "https://api.rededoc.uk/api/emisores/software/<id>/" \
  -H "Authorization: <llaveapi>"

Respuestas

Código	Descripción
200
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"
}

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"
    }
  ]
}