Envíos y entregas (Correos — en preparación)

Qué ocurre hoy

Todos los pedidos se recogen en persona en nuestra oficina de Puerto de Santiago (Tenerife). Aún no enviamos a domicilio.

Los precios de la tienda incluyen IGIC. No habrá gastos de envío Correos en el checkout hasta que activemos el envío a domicilio.

Qué estamos preparando (solo Islas Canarias)

Estamos integrando Correos para poder ofrecer envío a domicilio dentro de las Islas Canarias en primer lugar. El alcance, precios y plazos se confirmarán antes de activar la opción en el checkout.

Esta página resume el proceso técnico que seguimos. No es una oferta comercial de Correos; el contrato y las tarifas son siempre con Correos bajo tu cuenta de cliente.

Cómo funciona el acceso a las APIs de Correos

Se solicita acceso en el Exchange / portal de APIs de Correos para cada API (p. ej. Preregister). La solicitud se revisa; al aprobarse, Correos envía credenciales por correo.

Las APIs pueden tener distintos niveles de uso (SLA) y a veces coste. La seguridad puede ser: sin autorización (poco frecuente), Client ID + Client secret en cabeceras HTTP, o tokens JWT Bearer desde CorreosID (ver su documentación).

Nuestra tienda Next.js guardará el client id y el secret solo en variables de entorno del servidor (nunca en el navegador). Los JWT, si aplica, se obtendrán y renovarán en servidor según la documentación de Correos.

API Preregister (envíos)

URL base (ejemplo de documentación): https://api1.correos.es/admissions/preregister/api/v1

Operaciones: preregistrar uno o más envíos (remitente, destinatario, bultos, valores añadidos, aduanas si aplica); consultar datos por códigos de preregistro; anular un envío; modificar datos.

Límite: hasta 100 bultos por solicitud de preregistro online. Para volumen mayor, Correos ofrece flujo masivo (procesamiento masivo).

Ejemplos de rutas (HTTPS): POST /delivery, POST /delivery/cn, POST y PUT /delivery/package, POST /delivery/package/iris, POST /delivery/annulment, POST /delivery/annulment/expedition — los cuerpos exactos están en la especificación técnica de Correos.

• Etiquetas (Labels), seguimiento (Trackpub) y webhooks (Track&TracePush) son APIs distintas que se activan según necesidad.

Códigos de producto (resumen — tabla completa en Anexo I de Correos)

Correos asigna un código a cada “producto” (p. ej. PAGXC Paq Ligero, PAFXB Paq Estándar, PADXA Paq Premium). Cada uno tiene límites de peso, dimensiones y número de bultos. Para piezas y accesorios de bicicleta elegiremos el producto postal que encaje en peso/tamaño y modo de entrega (domicilio, oficina, CityPaq, etc.).

Ejemplos de la tabla oficial: Paq Ligero (PAGXC) hasta 2000 g; Paq Estándar domicilio (PAFXB + DOUAOF) hasta 40 kg por bulto; Paq Premium (PADXA) para niveles de servicio superiores. Piezas muy grandes o palets usan otros productos (p. ej. servicios de palet).

El tipo de mercancía usa códigos numéricos (p. ej. 513 = piezas de bicicleta) para declaración/aduanas cuando corresponda.

Modos de entrega (abreviaturas)

Ejemplos de la documentación de Correos: entrega a domicilio (DOUAOF), en oficina (OFUAOF), oficina de referencia (ORUAOF), CityPaq (CIUAOF), buzón (BUUAOF), devoluciones (DOURUA), en bordillo (PCUAOF), etc. La combinación producto + modo debe ser válida en su catálogo.

Canarias en España

Los códigos de provincia española incluyen 35 (Las Palmas) y 38 (Santa Cruz de Tenerife). La tienda y los flujos Correos usarán direcciones y códigos postales válidos para envíos nacionales dentro de las islas.

URIs de redirección OAuth (opcional)

Si Correos o CorreosID usa un flujo OAuth en navegador, registra URLs como https://www.kudo-shop.com/api/integrations/correos/oauth/callback y http://localhost:3000/api/integrations/correos/oauth/callback para desarrollo. Si la integración es solo servidor (client credentials), puede que no necesites URIs de redirección.

Aviso

Esta página es un resumen informativo. Las reglas vinculantes, precios y comportamiento técnico son siempre los de tu contrato con Correos y la documentación oficial de la API. Hasta que anunciemos envío a domicilio en el checkout, la única opción es la recogida en la oficina.