Límites

Créditos

• Un crédito = un destinatario de una notificación. Se consume cuando el envío se confirma, no al preparar el borrador.
• Un archivo por enlace de descarga cuesta, además, un crédito por cada 10 MB o fracción, por destinatario. Esos créditos deben ser pagados: los de prueba pagan la notificación, no los archivos (vea Archivos por enlace de descarga).
• Al aprobarse su verificación de abogado, su firma recibe los créditos de prueba que indica Precios, con su vigencia. La prueba se da una sola vez por persona, en la primera de sus firmas que aún no haya recibido una prueba, y cada firma recibe una sola.
• Cuando se acaban los de prueba, compre un paquete en Créditos (/creditos); los paquetes y sus precios están en Precios. Ningún asistente puede comprar créditos.

Documentos

Los 6 MB son lo que cabe en un mensaje de 10 MB, el máximo que acepta nuestro proveedor de correo, una vez codificados los adjuntos. Lo que cabe va adjunto al mensaje. Si sus documentos pesan más:

• Envíe el archivo por enlace de descarga, si el asistente se lo ofrece (vea la sección siguiente).
• Comprima los PDF. Un escaneo a 150 ppp en escala de grises pesa mucho menos que uno a color y a mayor resolución; compruebe que siga siendo legible.
• Repártalos en más de una notificación del mismo proceso, a los mismos destinatarios: por ejemplo, la providencia y la demanda en la primera y los anexos en la segunda. Indique en el mensaje de cada una cuántas son y qué lleva cada una. Cada notificación consume un crédito por destinatario y tiene su propia constancia.

Archivos por enlace de descarga

Un archivo que no cabe como adjunto, o que no es PDF, PNG ni JPEG, puede enviarse por enlace de descarga. El mensaje lo lista con su nombre, su tamaño en bytes y su huella SHA-256, y cada destinatario lo descarga desde su enlace individual. El archivo no va adjunto.

• Qué necesita. Un medio de pago registrado en Facturación y créditos pagados (de un paquete o de un plan). Si su firma no tiene medio de pago, el asistente le dice dónde registrarlo. La opción aparece en el asistente solo cuando está disponible para su firma.
• Qué cuesta. Un crédito adicional por cada 10 MB o fracción de los archivos por enlace de la notificación, por destinatario. Un archivo de 25 MB a dos destinatarios cuesta 2 × (1 + 3) = 8 créditos. El asistente muestra el costo antes de enviar, y no deja enviar si los créditos pagados no alcanzan. Se cobra al enviar; si el envío falla, los créditos se devuelven.
• Qué tipos. PDF, PNG, JPEG, TIFF, MP3, WAV, M4A, OGG, MP4, MOV, WEBM, MKV, DOCX, XLSX, PPTX, ODT y ZIP, hasta 2 GB por archivo. El nombre debe terminar en la extensión de su tipo, y el contenido debe corresponder a ella. No se admiten documentos con macros ni archivos comprimidos con contraseña.
• Análisis. Todo archivo se analiza en busca de software malicioso antes de poder enviarse. Uno grande puede tardar varios minutos. Si el análisis lo rechaza, el asistente dice por qué y qué hacer.
• Conservación. Un archivo enviado se conserva 10 años desde el envío y después se elimina, previo aviso a la firma. Su huella SHA-256 permanece en la constancia y en la evidencia de la notificación, así que quien conserve una copia puede comprobar que es el mismo archivo. Un archivo cargado y no enviado se elimina a los 30 días; le avisamos por correo 7 días antes.
• En la constancia. La constancia distingue los documentos adjuntos de los entregados por enlace, y registra cuándo el servidor transmitió el archivo completo. Esa transmisión no prueba que el destinatario lo haya abierto.

Frecuencia (/v1)

Por token y por minuto: 120 solicitudes, sea cual sea la operación. Toda respuesta trae RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset; al superarlo, la respuesta es HTTP 429 X_RATE_LIMITED con retry-after, los segundos que debe esperar. Algunas operaciones suman un límite propio por persona: requestUpload y confirmUpload, 30 por minuto cada una.

Frecuencia (MCP)

Por persona y por minuto, sumando todos sus tokens y réplicas del servidor:

Al superarlo, la respuesta es HTTP 429 X_MCP_RATE_LIMITED con retry-after, los segundos que debe esperar. Las subidas (PUT) no cuentan; requestUpload y confirmUpload sí.

Plazos

Páginas

Todo listado se pagina con _first y _after: responde el sobre { rows, nextCursor, hasMore } cuando se le pide _first, y la página siguiente con _after=<nextCursor> (inicio rápido). Sin _first, responde las filas sin sobre, como antes. Un valor mayor que el máximo se rechaza con 400 X_INPUT_INVALID: nunca se recorta.

Los listados que ya recibían limit y cursor (la última fila de la página anterior como <createdAt>_<id>) los siguen recibiendo; listDeadlines recibe cursor como el identificador de la última fila. Para un cliente nuevo, basta con _first y _after.

exportNotifications no es un listado sino un libro de Excel (.xlsx, en base64 en xlsx): hasta 5.000 líneas por llamada. Si hay más, responde truncated: true y un nextCursor; envíelo como cursor, con los mismos filtros, para el archivo siguiente.