1. Contratar Correos España y solicitar acceso al portal
Correos exige que el negocio tenga un contrato de transporte para integrar sus APIs empresariales. Si todavía no eres cliente, solicita información comercial a Correos. Regístrate en Correos ID y accede al Portal de Desarrolladores con tu cuenta. El contrato es específico del negocio que realiza los envíos: Tiendli no lo sustituye.
2. Qué APIs de Correos necesita una tienda online
Trackpub devuelve la trazabilidad de un envío desde su código. Preregister realiza la validación y el prerregistro de paquetes y puede permitir consultas, modificaciones y cancelaciones. Labels obtiene etiquetas y documentación de envíos previamente registrados, en formatos como PDF y ZPL. Requests permite gestionar recogidas. Estas APIs tienen permisos propios: debes solicitar expresamente acceso a las que quieras utilizar.
3. Obtener las credenciales de Trackpub y CorreosID
Trackpub dispone de una política client_id/client_secret y validación de token Bearer. Por eso puedes necesitar dos pares de credenciales: uno concedido a la aplicación consumidora de Trackpub y otro de CorreosID para obtener un token OAuth. El endpoint documentado para obtener el token de CorreosID es https://apioauthcid.correos.es/api/authorize/token mediante grant_type=client_credentials. El scope debe ser exactamente el aprobado para tu aplicación. Si Correos te ha facilitado un proceso distinto, solicita a su soporte la documentación específica para tu contrato.
4. Configurar Correos en el panel de Tiendli
Entra como propietario o administrador de tu tienda de España. Ve a Negocio → Logística → Operadores logísticos → Correos España. Introduce la URL base de Trackpub proporcionada por Correos (no su web pública), los dos datos client_id y client_secret de Trackpub, el OAuth Client ID y el OAuth Client Secret de CorreosID y, si corresponde, el scope. También puedes registrar un número de contrato. Pulsa Probar OAuth y guardar conexión. Las credenciales se almacenan cifradas y no se muestran posteriormente.
5. Qué comprueba el botón Probar conexión
La prueba solicita un token real al servicio oficial de CorreosID. Esto comprueba el flujo de autenticación de la aplicación, pero NO significa que Correos haya habilitado Trackpub, Preregister o Labels para tu contrato. Para verificar los permisos de Trackpub, debes consultar un código de seguimiento real desde el panel.
6. Consultar y asociar el seguimiento de un pedido
Genera el envío mediante los procedimientos o el portal que Correos haya habilitado para tu contrato. Copia su código y localiza el ID del pedido de entrega en Tiendli. Introduce ambos en Correos España y pulsa Consultar Trackpub y vincular. Tiendli realiza una llamada autenticada de solo lectura a search/{shippingCode}. Si el proveedor devuelve eventos interpretables y no hay otro código vinculado al pedido, se registra la referencia y se muestran los eventos obtenidos. Verifica que el código realmente corresponde al comprador: un código válido no demuestra por sí solo la titularidad.
7. Preparar el borrador completo de Preregister sin crear envíos
En Negocio → Logística → Operadores logísticos → Correos España, completa primero los datos del contrato concedidos por Correos: número de cliente, código etiquetador de cuatro caracteres, producto contratado y código de modalidad de entrega. Introduce también nombre, dirección, localidad, código de provincia de dos dígitos y código postal de cinco dígitos del remitente. Después escribe el ID de un pedido de entrega español y el peso real en kg; pulsa Validar dirección, destinatario y peso. Tiendli comprobará también la provincia del destinatario y preparará un borrador JSON con shipments, sender, addressee y packages. Si faltan datos, la pantalla muestra exactamente cuáles. Si el pedido está completo, puedes inspeccionar el borrador, pero NO se envía a Preregister ni se genera código, etiqueta, cargo o solicitud al proveedor. El documento no se transmite a Correos, por lo que debe revisarse con los permisos y requisitos oficiales antes de una implementación real.
8. Prerregistro, etiquetas PDF y recogidas
Estas tres operaciones se mantienen pendientes de habilitación en Tiendli. No se envían automáticamente paquetes ni se generan etiquetas a través de una API todavía no probada con las credenciales del comercio. Para implementarlas se necesitarán las especificaciones y permisos de Preregister, Labels y Requests, una cuenta española de prueba, las referencias de contrato y, en su caso, códigos de producto y etiquetador. Mientras tanto puedes crear las etiquetas desde las herramientas de Correos para tu contrato.
9. Tarifas, checkout y precauciones
Tiendli no publica precios simulados como tarifas oficiales de Correos España. Para cobrar envíos durante esta fase, configura las tarifas manuales de tu tienda según tu contrato y la modalidad elegida. El seguimiento puede actualizarse mediante la consulta autenticada del propietario, pero no se deben asumir ni calcular estados finales de entrega a partir de descripciones de eventos sin validar la matriz de Correos.