La respuesta breve
Una API de impresión y envío postal permite que tu software presente un documento digital para su entrega física. Con IRIS, tu aplicación carga un PDF terminado, lo registra, obtiene una cotización y crea un envío postal a una dirección de EE. UU. después de que una persona revisa el documento, las direcciones, el precio y el propósito.
Cómo encaja una API de envío postal en tu empresa
Imagina una pequeña empresa de servicios que ya genera una confirmación en PDF para cada proyecto completado. La mayoría de los clientes la reciben electrónicamente, pero uno solicita una copia en papel. La automatización útil consiste en conectar ambos procesos: reutilizar el PDF aprobado y la dirección del cliente, obtener un precio y permitir que un miembro del personal apruebe el envío sin volver a ingresar todos los datos.
Ese es un buen punto de partida para IRIS. Admite cartas y postales individuales mediante REST y MCP de servidor con autenticación. Tu aplicación sigue siendo responsable de decidir por qué debe enviarse un documento, generar su contenido y obtener una revisión. IRIS se encarga de la orden de envío postal admitida una vez que se presenta. Una cotización es un cálculo del precio; no envía el documento por correo.
Los seis pasos del PDF a la orden de envío postal
Mantén cada paso explícito en tu aplicación. Un ID de documento, un ID de orden de envío postal y un número de seguimiento postal identifican cosas distintas. Guárdalos en campos separados.
- Crea y verifica una cuenta de desarrollador de IRIS. Mantén una clave de API vinculada a la cuenta en un entorno de servidor confiable y agrega créditos prepagados para envíos postales antes de presentar una orden.
- Solicita una carga privada con POST /v1/uploads/presign. Carga los bytes del PDF en la URL devuelta usando exactamente los encabezados de carga devueltos.
- Registra el PDF cargado con POST /v1/documents. Guarda el ID inmutable del documento y su huella digital SHA-256.
- Envía el ID del documento, el remitente, el destinatario y las opciones de impresión a POST /v1/mailings/quote. Muestra el precio devuelto en centavos de dólar estadounidense como un importe monetario.
- Pide a una persona que revise el PDF final, ambas direcciones, las opciones de envío postal, el precio y la autorización para enviarlo. Guarda de forma persistente una clave de idempotencia para esa intención de envío aprobada.
- Presenta POST /v1/mailings con ese Idempotency-Key guardado. Guarda el orderId devuelto y consulta GET /v1/mailings/{id} para ver el estado y el seguimiento disponible.
Qué desarrollar alrededor de la API
Una integración confiable necesita un pequeño registro operativo, además de un cliente HTTP. Empieza con un tipo de documento y un equipo antes de ampliarla.
| Tu aplicación | API de IRIS |
|---|---|
| Registros de origen, generación del PDF y versión del documento | Carga privada y registro validado del documento |
| Persona encargada de la revisión, destinatario aprobado e intención de envío | Cotización calculada por el servidor y creación de órdenes con cargo a los créditos |
| Clave de reintento persistente y cola de excepciones | Presentación idempotente y consulta de órdenes pertenecientes a la cuenta |
| Comunicación con los clientes e informes internos | Estado actual de la orden y campos de seguimiento cuando estén disponibles |
Comprueba si se ajusta a tus necesidades antes de programar la integración
IRIS acepta PDF de hasta 26 MiB. Los PDF de cartas deben usar páginas de tamaño carta estadounidense (US Letter); el límite actual es de 60 páginas impresas por una cara o 120 páginas impresas por ambas caras. Las cartas certificadas tienen un límite de seis hojas. El enlace de carga dura diez minutos, así que solicítalo cuando estés listo para transferir el archivo.
Cada envío postal mediante la API se dirige a una sola dirección de EE. UU., lo que resulta adecuado para facturas, avisos, confirmaciones y otros documentos vinculados a un cliente específico. ¿Necesitas enviar a una lista más amplia de forma recurrente? Cuéntanos sobre el volumen y te responderemos con opciones.
Elige un primer flujo de trabajo que puedas medir
Usa un criterio de éxito sencillo: un colega puede revisar un PDF existente, ver la cotización exacta, aprobarlo una sola vez y encontrar la orden resultante más adelante. Mide el tiempo de preparación, las correcciones detectadas antes de presentar la orden y las excepciones que requieren seguimiento. Esas mediciones te indican si la integración ayuda a tu equipo; una mayor cantidad de envíos por sí sola no lo demuestra.
Antes de usarla en producción, prueba PDF no válidos, campos de dirección faltantes, créditos insuficientes y una respuesta perdida mediante datos de prueba locales o respuestas HTTP simuladas. Las claves de desarrollador de IRIS son credenciales para envíos postales con cargo a los créditos; no supongas que existe un prefijo test_ o un modo de entorno de pruebas. La guía de inicio rápido enlazada separa la preparación del comando que crea un envío postal de pago.
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.