PATCH /api/emisores/emisor/{id}/

PATCH /api/emisores/emisor/{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_emisor_partial_update

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 emisor.

Cuerpo de la petición

Tipo de contenido: application/json.

Campos

Campo	Tipo	Obligatorio	Descripción
razon_social	string	no
tipo_identificacion	integer	no
numero_identificacion	string	no	NIT sin puntos, sin guiones y sin dígito de verificación.
digito_verificacion	string	no
tipo_organizacion	integer	no
responsabilidades	array<string>	no
pais	string	no
departamento	string	no
municipio	string	no
direccion	string	no
codigo_postal	string	no	cbc:PostalZone de las direcciones del XML.
correo_copia	string	no	Copia de las notificaciones al adquiriente. Varios correos separados por punto y coma. Vacío = no se envía copia.
telefono	string	no
correo	any	no
activo	boolean	no
ambiente_facturacion	any	no	Contra qué servidor de la DIAN salen las facturas, notas y documentos soporte de este emisor. Es por emisor y no del despliegue: unos pueden seguir en habilitación mientras otros ya están en producción. * 1 - Producción * 2 - Habilitación
ambiente_nomina	any	no	Lo mismo para la nómina, que la DIAN habilita aparte: el mismo emisor puede estar en producción para factura y todavía en habilitación para nómina. * 1 - Producción * 2 - Habilitación
ambiente_documento_equivalente	any	no	Y lo mismo para el documento equivalente P.O.S., que tiene su propia habilitación (Res. 000165/2023, numeral 4). Son tres ambientes independientes, no uno del despliegue. * 1 - Producción * 2 - Habilitación

Ejemplo

curl -X PATCH "https://api.rededoc.uk/api/emisores/emisor/<id>/" \
  -H "Authorization: <llaveapi>" \
  -H "Content-Type: application/json" \
  -d '{
    "razon_social": "texto",
    "tipo_identificacion": 1,
    "numero_identificacion": "texto",
    "digito_verificacion": "texto",
    "tipo_organizacion": 1,
    "responsabilidades": [
      "texto"
    ],
    "pais": "texto",
    "departamento": "texto",
    "municipio": "texto",
    "direccion": "texto",
    "codigo_postal": "texto",
    "correo_copia": "texto",
    "telefono": "texto",
    "correo": null,
    "activo": true,
    "ambiente_facturacion": null,
    "ambiente_nomina": null,
    "ambiente_documento_equivalente": null
  }'

Respuestas

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

200 — cuerpo

Campo	Tipo	Descripción
id	integer	Solo lectura.
usuario	integer	Usuario dueño del emisor. Solo lectura.
razon_social	string
tipo_identificacion	integer
numero_identificacion	string	NIT sin puntos, sin guiones y sin dígito de verificación.
digito_verificacion	string
tipo_organizacion	integer
responsabilidades	array<string>
pais	string
departamento	string
municipio	string
direccion	string
codigo_postal	string	cbc:PostalZone de las direcciones del XML.
correo_copia	string	Copia de las notificaciones al adquiriente. Varios correos separados por punto y coma. Vacío = no se envía copia.
telefono	string
correo	any
activo	boolean
habilitado_facturacion	boolean	Solo lectura.
habilitado_nomina	boolean	Solo lectura.
habilitado_documento_equivalente	boolean	Solo lectura.
ambiente_facturacion	any	Contra qué servidor de la DIAN salen las facturas, notas y documentos soporte de este emisor. Es por emisor y no del despliegue: unos pueden seguir en habilitación mientras otros ya están en producción. * 1 - Producción * 2 - Habilitación
ambiente_nomina	any	Lo mismo para la nómina, que la DIAN habilita aparte: el mismo emisor puede estar en producción para factura y todavía en habilitación para nómina. * 1 - Producción * 2 - Habilitación
ambiente_documento_equivalente	any	Y lo mismo para el documento equivalente P.O.S., que tiene su propia habilitación (Res. 000165/2023, numeral 4). Son tres ambientes independientes, no uno del despliegue. * 1 - Producción * 2 - Habilitación
certificado_activo	boolean	Si el emisor tiene un .p12 cargado. No dice que esté vigente: eso lo responde certificado_vence, porque una bandera que dependiera de la fecha quedaría mintiendo el día que el certificado venza, sin que nadie haya escrito nada. Solo lectura.
certificado_vence	string (date)	Fin de la vigencia del .p12 cargado, tal y como viene dentro del propio certificado. Nulo si no hay certificado. Solo lectura. Admite null.
resoluciones	array<Resolucion>	Solo lectura.

{
  "id": 1,
  "usuario": 1,
  "razon_social": "texto",
  "tipo_identificacion": 1,
  "numero_identificacion": "texto",
  "digito_verificacion": "texto",
  "tipo_organizacion": 1,
  "responsabilidades": [
    "texto"
  ],
  "pais": "texto",
  "departamento": "texto",
  "municipio": "texto",
  "direccion": "texto",
  "codigo_postal": "texto",
  "correo_copia": "texto",
  "telefono": "texto",
  "correo": null,
  "activo": true,
  "habilitado_facturacion": true,
  "habilitado_nomina": true,
  "habilitado_documento_equivalente": true,
  "ambiente_facturacion": null,
  "ambiente_nomina": null,
  "ambiente_documento_equivalente": null,
  "certificado_activo": true,
  "certificado_vence": "2026-01-31",
  "resoluciones": [
    {
      "id": 1,
      "emisor": 1,
      "tipo_factura": 1,
      "numero_resolucion": "texto",
      "fecha_resolucion": "2026-01-31",
      "prefijo": "texto",
      "rango_desde": 0,
      "rango_hasta": 0,
      "vigente_desde": "2026-01-31",
      "vigente_hasta": "2026-01-31",
      "activa": true
    }
  ]
}

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