POST /api/emisores/software/

POST /api/emisores/software/

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_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ó.

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/" \
  -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
201
400	Error
401	Error
429	Error

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

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