← Volver a las guías

Obtén el token de Openapi (requerimiento por carta certificada)

Crea una cuenta Openapi, recarga el saldo y genera un token con los scopes de cartas certificadas: el requerimiento a quien no recoge el paquete sale por carta certificada desde el pedido.

Actualizada el 3 de noviembre de 2026


Con el token de Openapi, RoyLead envía el requerimiento a quien no ha recogido el paquete por carta certificada italiana, con el servicio Ufficio Postale de Openapi: lo imprimen, lo ensobran y lo entregan a Poste Italiane. Todo funciona en tu cuenta Openapi: las cartas las pagas allí, con tu saldo (desde unos 4 € cada una, más el acuse de recibo si lo quieres).

El token es del equipo: lo añade el propietario o un admin.

Pasos

  1. Ve a console.openapi.com y crea una cuenta (o inicia sesión).

  2. Abre API Library → Postal Service → State. Completa los dos requisitos, Two factor verification y Data processor agreement (el contrato de privacidad sobre los datos que envías, que hay que aceptar), y pulsa Activate.

  3. Recarga el saldo de la cuenta: cada carta se descuenta de ahí.

  4. Abre Authentication en el menú de la izquierda y, en el recuadro Production Token List, pulsa + New token. Ponle un nombre (p. ej. «RoyLead») y una caducidad lejana (Openapi permite como máximo 1 año: ponlo y apunta la fecha, porque cuando el token caduca las cartas dejan de salir y hace falta uno nuevo). Marca Postal Service, o solo estos scopes:

    • POST:ws.ufficiopostale.com/raccomandate
    • GET:ws.ufficiopostale.com/raccomandate
    • PATCH:ws.ufficiopostale.com/raccomandate
    • GET:ws.ufficiopostale.com/dug

    Copia el token (24 caracteres) con el icono de copiar. No la API Key de arriba: esa es solo para Openapi, RoyLead la rechaza.

  5. En RoyLead abre tu equipo → Clientes → Cartas certificadas (Openapi), pega el token y pulsa Guardar. RoyLead lo prueba en Openapi antes de guardarlo.

Cómo se envía

  1. En el pedido, genera el requerimiento como siempre.
  2. Pulsa Enviar por carta certificada: remitente y destinatario ya están rellenados, corrígelos si hace falta.
  3. Preparar y ver el precio: Openapi revisa el PDF y te dice cuánto cuesta.
  4. Enviar la carta: sale. En la misma ventana verás luego el número de la carta y el último estado de Correos.

💡 El token se guarda cifrado y no se vuelve a mostrar (solo las últimas cifras). Si lo quitas, ya no se pueden enviar cartas desde RoyLead.

⚠️ Remitente y destinatario van en el sobre: cada línea tiene un límite de caracteres. Si un campo es demasiado largo, la ventana lo marca en rojo: acórtalo (p. ej. «Via Giuseppe Garibaldi» → «Via G. Garibaldi»).

¿Listo para ponerlo en práctica?

Crea tu cuenta de RoyLead y empieza en pocos minutos.

Empieza gratis ↗