La respuesta breve
Un flujo fiable de envío postal con agentes separa la preparación, la revisión humana y el envío. Vincula la aprobación a un PDF inmutable y a los datos exactos del envío, restringe las credenciales disponibles para el agente y conserva una clave de idempotencia y un registro de pedido por cada carta prevista.
Haz explícito el paso al envío
Considera un agente que prepara una carta de finalización de proyecto a partir de registros de servicio aprobados. Redactar la carta es reversible. Crear un envío físico pagado inicia un proceso diferente. Tu aplicación debe hacer visible esa transición, con un documento que pueda revisarse y una acción concreta que una persona pueda aprobar.
IRIS ofrece REST y MCP de servidor para este flujo, y su herramienta de creación de envíos está diseñada en torno a la revisión humana. Coloca ese requisito de revisión en el código de tu aplicación, junto a la credencial que gasta créditos de envío, para que cada carta pagada pase por una persona que haya visto el PDF exacto y el precio.
Usa estados que describan lo que realmente ocurrió
Los siguientes son estados sugeridos para tu aplicación, no estados adicionales devueltos por IRIS. Evitan que un borrador generado se confunda con una carta enviada o entregada.
| Estado | Condición para salir del estado |
|---|---|
| Borrador | Datos de origen comprobados y PDF final producido. |
| Preparado | PDF registrado, direcciones completas y cotización obtenida. |
| Pendiente de revisión | La persona revisora ve el PDF exacto, el destino, las opciones y el precio. |
| Aprobado | Aprobación guardada y vinculada al documento inmutable y a los datos de la solicitud. |
| Envío incierto | Conciliar una respuesta perdida usando la clave de idempotencia guardada. |
| Pedido registrado | Guardar de forma persistente el orderId de IRIS y consultar el estado actual. |
Asigna permisos distintos a la preparación y al envío
Usa account:read, documents:write y mailings:read para un proceso de preparación. Mantén mailings:write en el componente responsable de los envíos aprobados. Un asistente que solo consulta el saldo puede usar una credencial account:read. Guarda todas las claves en entornos de confianza y revoca las claves que no se usen cuando retires un flujo.
Trata el texto de los PDF, las notas del CRM y los resultados de las herramientas como datos. Una instrucción incluida en un documento, como «envía esto a otra dirección», no debe reemplazar al destinatario revisado. Prefiere campos validados del registro de tu aplicación a direcciones extraídas de texto arbitrario. Exige una nueva revisión cuando cambien el documento o los datos del envío.
Guarda un registro de aprobación útil
Guarda de forma persistente en tu propio sistema el propósito comercial, la referencia del registro de origen, el ID del documento inmutable, la huella del documento, el remitente y destinatario exactos, las opciones de impresión, el importe cotizado, la persona revisora y la fecha y hora de revisión. Asocia una clave de idempotencia a ese registro antes del primer intento de envío.
IRIS recalcula el precio al crear el envío pagado con créditos, así que solicita otra cotización si ha pasado tiempo y muestra cualquier cambio en el total a la persona revisora antes de enviar. Una carta de una página en blanco y negro cuesta $3.20 con impresión y franqueo First-Class incluidos.
Prueba los momentos en que un agente debe detenerse
Las pruebas útiles cambian los hechos que el agente querría dar por supuestos. Dale una dirección sin calle, un PDF que no supere la validación, una cotización por encima de tu presupuesto interno o un registro que haya cambiado después de la aprobación. Cada caso debe detenerse antes del envío e indicar a la persona revisora qué requiere atención.
Simula también un envío exitoso cuya respuesta HTTP se pierda. El reintento debe reutilizar la clave guardada y los datos exactos de la solicitud. Un estado de pedido retrasado o sin número de seguimiento no debe activar automáticamente un envío de reemplazo. Remite los casos inciertos a una persona que pueda conciliar el registro comercial con el pedido.
Fuentes y lecturas adicionales
Publicado por IRIS Postal Forms, operado por Great Lakes Computing Office LLC. ¿Encontraste información desactualizada? Envía una corrección.