# API internacional de impresión y envío de cartas para desarrolladores y startups Print and Mail Company ofrece una API REST para apps que necesitan enviar cartas físicas a destinatarios fuera de Estados Unidos. Tu código sube un PDF, crea un borrador con la dirección del destinatario y el precio exacto, y lo envía con cargo al saldo prepago; nosotros imprimimos la carta en Europa y la enviamos al país del destinatario. La misma cuenta funciona con nuestro servidor MCP, así que los agentes de IA también pueden enviar cartas. ## Cuándo es esta API la opción adecuada - **Cartas a Europa:** notificaciones, contratos, facturas y cartas sobre la cuenta para clientes, usuarios o socios en Alemania, Francia, el Reino Unido y el resto de Europa. Se envían dentro de Europa y suelen llegar en 2–4 días hábiles desde el depósito a Alemania, Bélgica, Francia y Países Bajos, y en 3–6 al resto de Europa. - **Cartas a otros países:** destinatarios de todo el mundo, normalmente en 5–15 días hábiles desde el depósito. - **Volumen bajo o irregular:** sin suscripción, cuota mensual ni cargo de alta; pagas por carta con saldo prepago. - **Apps con agentes de IA:** la misma cuenta funciona con nuestro servidor MCP. Para volúmenes de envío dentro de Estados Unidos, un proveedor estadounidense suele ser la mejor opción: nuestras cartas a direcciones de Estados Unidos también viajan desde Europa y suelen tardar 5–15 días hábiles. Son plazos de entrega habituales, no garantizados. ## Cómo funciona la API La URL base es `https://printandmailcompany.com/api/v1`, la especificación OpenAPI está en `/openapi.json`, y las solicitudes se autentican con una clave de API que creas en tu cuenta, en [API y asistentes de IA](/app/developers). 1. **Sube el PDF:** `POST /documents` guarda un PDF en A4 o US Letter y devuelve el resultado de la verificación de impresión. `POST /documents/{id}/fix` reduce o recorta las páginas que no cumplen la regla de márgenes de 9 mm. Como alternativa, `POST /compose` convierte un texto en una carta A4 con formato y crea el borrador. 2. **Crea un borrador:** `POST /letters` con el documento, la dirección del destinatario y las opciones de impresión (color, doble cara, sobre, certificado). Devuelve el precio exacto con IVA incluido; no se cobra nada. 3. **Envíala:** `POST /letters/{id}/send` paga la carta con tu saldo prepago y la libera para su impresión. Si el saldo no alcanza, responde con `402` e indica el importe que falta; para un PDF en US Letter a un país que usa A4, pide `paperSize` (`a4` o `us_letter`, mismo precio). 4. **Síguela:** `GET /letters/{id}` devuelve el estado (pagada, en producción, impresa, enviada, cancelada o devuelta) y, en las cartas certificadas, el número de seguimiento. `GET /letters?status=posted` lista las cartas por estado, y `POST /letters/{id}/cancel` cancela una carta hasta que empieza la producción, y el importe íntegro vuelve a tu saldo. Antes de que se pague la primera carta de una cuenta, esta necesita el nombre completo y la dirección postal del remitente; tu app puede pasarlos una sola vez como `sender`. ## Presupuestos, precios y saldo prepago - **Presupuestos sin clave:** `GET /api/v1/quote` calcula el precio de cualquier carta según las páginas, las opciones de impresión y el destino, por ejemplo `/api/v1/quote?pages=2&country=DE®istered=true`, y `GET /api/v1/destinations` lista los países. - **El precio exacto en cada borrador,** IVA incluido. Una carta de 1 página en blanco y negro a Alemania o Francia cuesta 3,59 €; el correo certificado cuesta 9,80 € (sin IVA) adicionales. - **Saldo prepago:** recargas con tarjeta en tu cuenta (mínimo 10,00 CHF / 10,00 € / 10,00 GBP / 10,00 US$); `GET /balance` muestra el saldo restante. Las tarjetas emitidas fuera del Espacio Económico Europeo (EEE), incluidas las estadounidenses, tienen un recargo, que se muestra antes de pagar. - **Moneda de la cuenta:** USD, EUR, GBP o CHF, a elegir al registrarte. Los precios están fijados en EUR y se convierten al tipo de referencia del BCE más un margen de cambio del 12 %. - **Sin suscripción, cuota mensual ni cargo de alta,** y una factura de cada carta y de cada pago en tu cuenta. La tarifa completa está en la [página de precios](/pricing). ## Servidor MCP para agentes de IA Nuestro servidor MCP en `https://printandmailcompany.com/mcp` ofrece las mismas funciones a los agentes de IA: Claude, ChatGPT, Cursor o tu propio agente pueden calcular precios, comprobar PDF, redactar una carta con `compose_letter`, crear un borrador con `create_letter` y enviarlo con `send_letter`. - **Inicio de sesión:** OAuth 2.1 con PKCE, o una clave de API. - **Aprobación:** `send_letter` requiere la confirmación expresa del usuario, y el pago sale únicamente del saldo prepago; si el saldo no alcanza, el agente recibe un enlace de recarga para el usuario. - **Estado:** `get_letter` y `list_letters` informan del estado y de los números de seguimiento. Encontrarás las instrucciones de configuración en la página de [asistentes de IA](/ai-assistants); consulta también [enviar cartas con IA](/use-cases/send-letters-with-ai). ## Qué se imprime y se envía - **Documentos:** PDF en A4 o US Letter, de hasta 250 páginas y 4 MB, con 9 mm libres en cada lado. Imprimimos en el tamaño que subes; a Estados Unidos, Canadá y los territorios estadounidenses, los PDF en US Letter se imprimen en US Letter. - **Opciones de impresión:** blanco y negro o color, a una o dos caras; sobres DL, C5 o C4, y se elige automáticamente el más pequeño adecuado. - **Dirección:** se imprime directamente en el sobre con el formato postal del país de destino, así que tus plantillas no necesitan ventana para la dirección. La dirección de nuestra empresa figura como remitente, y una carta que vuelve aparece con el estado "Devuelta". - **Correo certificado:** correo certificado internacional con número de seguimiento y firma a la entrega, no el servicio US Certified Mail. - **Producción:** las cartas pagadas antes de las 12:00 (hora de Europa Central) de un día hábil suelen imprimirse y enviarse ese mismo día hábil. - **Datos:** alojados en la UE; los archivos subidos se eliminan 30 días después del envío; si lo solicitas, te facilitamos un [acuerdo de tratamiento de datos](/legal/dpa). Solo imprimimos lo que contiene el PDF, así que no hay encartes, cheques ni mercancías, y cada carta tiene su propio PDF y su propio destinatario. ## FAQ ### ¿Hay una API para enviar cartas a Europa desde Estados Unidos? Sí. Con la API REST en `https://printandmailcompany.com/api/v1` (especificación OpenAPI en `/openapi.json`) subes un PDF, creas un borrador con el precio exacto y lo envías con cargo al saldo prepago. Imprimimos la carta en Europa y la enviamos desde allí; el plazo de entrega habitual desde el depósito es de 2–4 días hábiles a Alemania, Bélgica, Francia y Países Bajos (no garantizado). ### ¿Es esta API una buena opción para el correo dentro de Estados Unidos? Normalmente no. Las cartas a direcciones de Estados Unidos también viajan desde Europa y suelen tardar 5–15 días hábiles desde el depósito, así que para volúmenes de envío dentro de Estados Unidos un proveedor estadounidense suele ser la mejor opción. Nuestra API es adecuada para cartas a Europa y a otros países. ### ¿Cómo puedo saber el precio antes de enviar una carta? `GET /api/v1/quote` devuelve el precio para cualquier número de páginas, opciones de impresión y destino sin clave de API, y cada borrador creado con `POST /letters` muestra el precio exacto con IVA incluido antes de que se cobre nada. ### ¿Cómo puedo seguir las cartas enviadas a través de la API? `GET /letters/{id}` devuelve el estado y, en las cartas certificadas, el número de seguimiento; `GET /letters` permite filtrar por estado. Las cartas ordinarias no tienen número de seguimiento. Además, cada carta pagada se confirma por email al titular de la cuenta. ### ¿Pueden los agentes de IA usar la misma cuenta? Sí. Conéctalos a nuestro servidor MCP en `https://printandmailcompany.com/mcp` con OAuth o con una clave de API. Pueden crear borradores con el precio exacto, y `send_letter` solo envía tras la confirmación expresa del usuario, con cargo al saldo prepago.