Cambios de la API¶
Cambios del Gateway (REST /api/v1 y MCP) que pueden afectar a una integración que ya
funciona. Lo más nuevo arriba. La fecha es el día en que el cambio llegó a producción.
04/11/2026 — Rechazar un documento Importado ya no le borra el PDF¶
Afecta a: POST /api/v1/documents/{document_id}/reject, PUT /api/v1/documents/{document_id}/imported-pdf y la tool MCP reject_document.
Versión del Backend/Gateway: 5.9.2.
Qué cambió¶
Un documento Importado no tiene texto: su contenido es el PDF.
| Situación | Antes | Ahora |
|---|---|---|
| Se rechaza un Importado | El PDF se borraba. El documento volvía a edición sin contenido | El documento vuelve a edición con su PDF, sin las firmas ni los adjuntos que GDI le había agregado |
| Se reemplaza el PDF de un Importado rechazado | 409 |
200. El documento sigue en rejected hasta que se lo vuelve a enviar a firma |
La respuesta del rechazo de un Importado trae pdf_cleanup con lo que pasó con el PDF:
{
"success": true,
"message": "Documento rechazado exitosamente",
"document_id": "f6a7b8c9-d0e1-2345-fgab-456789012345",
"new_status": "rejected",
"pdf_cleanup": {
"imported_pdf": "deleted",
"reupload_required": true,
"note": "El documento quedó sin PDF: hay que volver a subirlo con \"Reemplazar PDF\" antes de mandarlo a firmar."
}
}
pdf_cleanup.imported_pdf |
Qué significa |
|---|---|
restored |
GDI volvió a dejar el PDF que se importó |
kept |
Nadie había firmado: el PDF quedó como estaba |
deleted |
El documento se envió a firma antes de este cambio y alguien ya había firmado. No hay copia limpia: hay que volver a subir el PDF |
missing |
No quedó ninguna copia del PDF: hay que volver a subirlo |
error |
No se pudo comprobar el PDF. El rechazo quedó guardado igual |
reupload_required y note vienen solo con deleted y missing.
Por qué¶
Rechazar un Importado lo dejaba vacío. Para corregirlo había que borrarlo e importarlo de nuevo.
Qué tiene que hacer una integración¶
- Si
pdf_cleanup.reupload_requiredestrue, subir el PDF conPUT /api/v1/documents/{document_id}/imported-pdfantes de volver a enviarlo a firma. - Para corregir un Importado rechazado, reemplazar el PDF directamente: ya no hace falta borrar el documento.
02/11/2026 — Cabeceras de seguridad y búsquedas sin comodines¶
Afecta a: todas las respuestas del Gateway; el parámetro search de GET /api/v1/cases/search y GET /api/v1/documents/search, y las tools MCP search_cases y search_documents.
Versión del Backend/Gateway: 5.9.1.
Qué cambió¶
-
Cabeceras de seguridad. Todas las respuestas del Gateway traen estas cabeceras:
Cabecera Valor X-Content-Type-OptionsnosniffReferrer-Policystrict-origin-when-cross-originStrict-Transport-Securitymax-age=31536000; includeSubDomainsX-Frame-OptionsDENY -
%y_ensearchson letras. Antes eran comodines de la base de datos:?search=%%%devolvía todos los expedientes o documentos. Ahora?search=50%busca el texto50%tal cual.
Por qué¶
Las cabeceras ya estaban en el Backend; faltaban en el Gateway. Los comodines dejaban que una búsqueda trajera mucho más de lo que se pedía.
Qué tiene que hacer una integración¶
- Si usaba
%o_ensearchcomo comodín, mandar solo el texto que busca: la búsqueda ya es por "contiene". - No mostrar respuestas del Gateway dentro de un
<iframe>: el navegador lo bloquea porX-Frame-Options: DENY.
02/11/2026 — Errores que daban 500 ahora dan el código correcto¶
Afecta a: rechazo y firma de documentos, rutas /api/v1/records/... y autenticación por API Key.
Versión del Backend/Gateway: 5.9.1.
Qué cambió¶
| Situación | Antes | Ahora |
|---|---|---|
POST /documents/{id}/reject de un documento ya rechazado |
500 |
409 El documento '<id>' ya fue rechazado y no puede ser modificado |
POST /documents/{id}/reject de un documento oficial (ya numerado) |
500 |
409 No se puede rechazar un documento completado |
POST /documents/{id}/reject y el documento se firma en ese mismo momento |
500 |
409: el documento quedó firmado y el rechazo no se aplicó |
POST /documents/{id}/sign de un numerador sin el rango que pide el tipo |
403 Usuario no autorizado para firmar este documento |
403 con el motivo real, por ejemplo Sin permiso de rango para numerar '<tipo>'... |
record_id, relation_id o link_id que no es un UUID, en cualquier ruta /records/{record_id}/... |
500 |
400 record_id inválido (se espera UUID) |
X-API-Key con caracteres no ASCII (por ejemplo, una ñ pegada por error) |
500 en algunas instalaciones |
401, como cualquier API Key inválida |
Por qué¶
Con un 500, la integración no sabe si el pedido falló o si conviene reintentar. Un rechazo
repetido o un id mal copiado terminaban en reintentos que nunca iban a andar.
Qué tiene que hacer una integración¶
- Tratar el
409del rechazo como "ya no hay nada que rechazar": consultar el documento conGET /api/v1/documents/{document_id}para ver su estado. - Con el
403de firma, mostrar el texto deerror: dice qué rango hace falta. - No reintentar un
400ni un401sin cambiar el pedido.
02/11/2026 — Documentos certificados de origen (certified_origin)¶
Afecta a: GET /api/v1/documents/{document_id}, GET /api/v1/cases/{case_id}/documents, POST /api/v1/documents/{document_id}/sign, POST /api/v1/documents/import y las tools MCP get_document y get_case_documents.
Versión del Backend/Gateway: 5.9.1.
Qué cambió¶
Un certificado de origen es un PDF que llega con una firma de certificación (por ejemplo, de un escribano). Si GDI le agrega algo, esa certificación se rompe. Por eso GDI lo guarda sin tocarlo:
- no le agrega la hoja de firma de GDI;
- no le agrega adjuntos;
- el número oficial queda en la base de datos, pero no se imprime en el PDF;
- los firmantes comunes dan conformidad en vez de firmar el PDF;
- el numerador numera sin firmar el PDF.
Campos nuevos (booleano, false por defecto):
| Dónde | Campo |
|---|---|
GET /documents/{id} y tool get_document |
certified_origin en la raíz de la respuesta |
GET /cases/{id}/documents y tool get_case_documents |
certified_origin en cada elemento de official |
Firma por REST: un certificado de origen se firma con POST /documents/{id}/sign aunque el
tipo de documento exija firma digital. Ahí nadie firma el PDF, así que no hace falta token.
| Situación al firmar un certificado de origen | Respuesta |
|---|---|
| GDI no pudo comprobar el PDF en ese momento | 503 con Retry-After: 5 y "code": "CERTIFIED_CHECK_RETRY" |
| El PDF cambió desde que se importó | 409 El PDF cambió desde que se verificó como certificado de origen... |
Al importar (POST /documents/import), GDI rechaza con 400 un PDF cuya certificación no se
puede conservar. Ejemplos del texto de error:
La firma de este PDF está rota o el documento fue modificado después de firmarse...El PDF dice venir certificado, pero ninguna de sus firmas respalda esa certificación...El PDF está protegido con contraseña para abrirse...El PDF trae firmas digitales que no se pudieron leer...
Por qué¶
Antes GDI firmaba encima del PDF certificado y la certificación de origen dejaba de ser válida.
Qué tiene que hacer una integración¶
- No esperar el número oficial impreso en un PDF con
certified_origin: true: leerlo de la respuesta de la API. - Para sumar archivos a un certificado de origen, cargarlos como documento aparte en el mismo expediente.
- Con el
503deCERTIFIED_CHECK_RETRY, reintentar después de los segundos deRetry-After.
26/10/2026 — Buscar dentro de los documentos de un legajo¶
Afecta a: GET /api/v1/records/{record_id}/documents.
Versión del Backend/Gateway: 5.7.0.
Qué cambió¶
Parámetro nuevo search: filtra los documentos vinculados por número oficial o por
referencia. Busca por "contiene" y no distingue mayúsculas.
Sin search, la respuesta es la misma de antes.
Qué tiene que hacer una integración¶
Nada. Es un parámetro opcional.
26/10/2026 — MCP: la identidad se ata al sub, no solo al email¶
Afecta a: todas las tools MCP y list_my_tenants.
Versión del Backend/Gateway: 5.8.0.
Qué cambió¶
Cada usuario de GDI queda atado al sub de su cuenta en el proveedor de autenticación la primera vez que entra. Si
el email del token coincide con un usuario atado a otro sub, el Gateway no lo toma: ese
municipio no aparece para esa cuenta.
Por qué¶
Con el email solo, otra cuenta en el proveedor de autenticación con el mismo email podía entrar como esa persona.
Qué tiene que hacer una integración¶
Nada, si cada persona usa siempre la misma cuenta. Si alguien deja de ver su municipio después de crear una cuenta nueva con el mismo email, el municipio tiene que revisar su usuario.
21/10/2026 — Más errores con su código correcto y API Keys de usuarios dados de baja¶
Afecta a: firma, alta de expedientes, propuestas de documentos y autenticación por API Key. Versión del Backend/Gateway: 5.6.0.
Qué cambió¶
| Situación | Antes | Ahora |
|---|---|---|
POST /documents/{id}/sign con la cola de firma saturada |
500 |
429 con Retry-After |
POST /cases con una plantilla (case_template_id) que no existe |
500 |
400 con el motivo |
POST /cases/{id}/documents/reject-proposal de una propuesta ya procesada |
500 |
400 |
case_id, proposed_id o document_draft_id que no es un UUID, en propose, accept-proposal o reject-proposal |
500 |
400 <campo> inválido (se espera UUID) |
| API Key autorizada para un usuario que el municipio dio de baja | La integración seguía operando como ese usuario | 401 Usuario no autorizado para esta API Key |
Sobre el 429 de la firma:
- Con
Retry-After, la saturación es pasajera: el texto diceReintentá en ~30 segundos. - Sin
Retry-After, la cola necesita que intervenga soporte: el texto diceContactá a soporte. Reintentar no sirve.
Por qué¶
Dar de baja a una persona tiene que cortar también lo que una integración hace en su nombre.
Los 500 de firma y de propuestas eran errores del pedido o esperas pasajeras, no fallas del
servidor.
Qué tiene que hacer una integración¶
- Con
429, esperar los segundos deRetry-Aftery reintentar una sola vez. - Con
401de un usuario que antes andaba, pedirle al municipio que confirme que la persona sigue activa. Si se fue, autorizar a otro usuario para la API Key. - Pedir las plantillas con
GET /api/v1/system/case-templatesen vez de guardar ids fijos.
06/10/2026 — sector_filter inválido ahora responde 400¶
Afecta a: GET /api/v1/cases/search (REST) y la tool MCP search_cases.
Versión del Backend/Gateway: 5.3.0.
Qué cambió¶
sector_filter filtra la búsqueda de expedientes por un sector. Acepta:
- el acrónimo exacto de un sector activo (ej.
HAC,LEGAL); - el formato
DEPT#SECTOR(ej.HAC#PRIV); - el UUID del sector.
| Situación | Antes | Ahora |
|---|---|---|
| El valor resuelve a un sector | 200, lista filtrada | 200, lista filtrada (sin cambios) |
El acrónimo o DEPT#SECTOR no existe (o el sector está inactivo) |
200 con la lista sin filtrar | 400 |
| El valor trae comas (varios sectores) | 200 con la lista sin filtrar | 400 |
| No se manda el parámetro | 200, lista completa | 200, lista completa (sin cambios) |
Por qué¶
Con un valor que no resolvía, la API devolvía todos los expedientes con 200 y la integración creía que había filtrado. Un error de tipeo, o un asistente de IA que inventaba un acrónimo, terminaba mostrando datos que no correspondían al filtro pedido, sin ningún aviso.
Ejemplo de respuesta¶
{
"detail": {
"message": "sector_filter: 'XYZ' no se pudo resolver a un sector (ni como UUID, ni como DEPT#SECTOR, ni como acrónimo de sector activo).",
"type": "ValidationError"
}
}
Con comas el mensaje indica que sector_filter espera un sector único.
Qué tiene que hacer una integración¶
- Mandar solo acrónimos que existan en el municipio: se pueden consultar con
GET /api/v1/system/sectors. - Si el sector no se conoce con certeza, omitir el parámetro en vez de adivinarlo.
- Tratar el 400 como "filtro inválido", no reintentar con el mismo valor.