Guía técnica · FactuSOL + tienda online y marketplaces

    Pedidos duplicados en FactuSOL al integrar la tienda online: causas e idempotencia

    Un pedido se duplica cuando la integración lo vuelve a enviar sin saber que ya se grabó: un aviso de la tienda que llega dos veces, un reintento tras un tiempo de espera o un script que no recuerda lo que hizo.

    La solución es la idempotencia: cada pedido guarda la serie y el número que recibió en FactuSOL y no se vuelve a crear si ya los tiene. Además, conviene usar una serie propia para los pedidos web.

    Causa

    Por qué pasa

    Lo que hay detrás del problema, explicado sin rodeos.

    Avisos repetidos de la tienda

    Las tiendas y marketplaces pueden notificar el mismo pedido más de una vez, por ejemplo al cambiar de estado o al reintentar un aviso que no recibió respuesta.

    Reintentos a ciegas

    Si la escritura en FactuSOL tarda y el conector cree que falló, reintenta. Si en realidad se grabó, tienes dos pedidos.

    Sin vínculo entre el pedido web y el de FactuSOL

    Si el sistema no guarda qué número recibió el pedido en FactuSOL, no tiene forma de saber si ya existe.

    Numeración compartida con el mostrador

    Si el conector calcula el siguiente número de la serie mirando el último existente y en ese momento se crea otro documento en la misma serie desde el mostrador, ambos pueden intentar usar el mismo número.

    Síntomas

    Cómo saber si te está pasando

    Si reconoces varias de estas señales, este es tu problema.

    • El mismo pedido web aparece dos veces en FactuSOL con números distintos.
    • Stock descontado dos veces para una sola venta.
    • Errores de clave duplicada al grabar pedidos en horas de mucha venta en tienda.
    • Saltos o choques en la numeración de la serie de pedidos.

    Solución

    Cómo solucionarlo paso a paso

    Pasos que puedes aplicar con cualquier integración, no solo con O2W.

    1. Guarda la referencia del pedido web en FactuSOL

      Lleva el número del pedido de la tienda al campo de referencia del documento. Te permite buscarlo y detectar duplicados a mano.

    2. Guarda en el origen el número que asignó FactuSOL

      Cada pedido debe recordar la serie y el número con el que se grabó. Si ya los tiene, no se vuelve a crear.

    3. Usa una serie propia para pedidos web

      Reserva una serie de pedidos solo para la tienda online. Así la numeración de la web no compite con la del mostrador.

    4. Graba cabecera y líneas juntas

      Un pedido a medias invita a reintentar. Con una sola transacción, o se graba entero o no se graba.

    5. Revisa los duplicados por referencia

      Si sospechas de un duplicado, filtra en FactuSOL por la referencia del pedido web antes de borrar nada, y anula el que no tenga movimientos posteriores.

    O2W Connect

    Cómo lo resuelve O2W Connect

    Solo lo que hace hoy el conector de FactuSOL de O2W Connect.

    Serie y número de FactuSOL guardados en O2W

    Después de escribir un documento, O2W guarda la serie y el número que tiene en FactuSOL y lo marca como sincronizado.

    Lo ya sincronizado no se vuelve a enviar

    Solo se envían documentos validados que no estén marcados como sincronizados, y un documento que ya tiene serie y número de FactuSOL no se vuelve a insertar.

    Referencia del pedido en FactuSOL

    La referencia del documento en O2W se escribe en el campo de referencia del documento de FactuSOL.

    Serie configurable

    La serie se toma del documento o de la configuración del conector; si no hay ninguna, el envío se rechaza en lugar de usar una cualquiera.

    Cabecera y líneas en una transacción

    Cabecera y líneas se envían juntas, lo que evita pedidos a medias que provoquen reintentos.

    Lo que no hace (o no prometemos)
    • El número nuevo se calcula como el último de la serie más uno. Si el mostrador crea a la vez un documento en la misma serie, pueden chocar; por eso recomendamos una serie propia para la web.
    • Si la escritura se completa en FactuSOL pero se pierde la confirmación antes de que O2W la registre, ese documento puede volver a enviarse. Es un caso raro, pero existe; revisa por referencia.
    • No afirmamos una idempotencia «garantizada» en todos los escenarios.

    Preguntas frecuentes

    Preguntas frecuentes

    Respuestas cortas a las dudas más habituales.

    ¿Qué es la idempotencia en una integración con FactuSOL?

    Que enviar el mismo pedido dos veces produzca el mismo resultado que enviarlo una: un único pedido en FactuSOL. Se consigue guardando el número que asignó FactuSOL y no volviendo a crear lo que ya lo tiene.

    ¿Por qué conviene una serie propia para los pedidos web?

    Porque la numeración de la web deja de competir con la del mostrador, y además separas los pedidos web de un vistazo.

    ¿Cómo encuentro un pedido duplicado?

    Busca en FactuSOL por la referencia del pedido de la tienda. Si aparece dos veces, conserva el que tenga albarán o factura y anula el otro.

    ¿Un pedido duplicado descuenta stock dos veces?

    Sí, si la integración descuenta stock al crear el pedido. Por eso los duplicados afectan también a la disponibilidad en la tienda.

    Siguiente paso

    ¿Tu FactuSOL no cuadra con la tienda online?

    Revisamos contigo cómo entran los pedidos, el stock, las tarifas y los impuestos entre tus canales y FactuSOL, y te decimos qué se puede automatizar.

    Cuéntanos cómo trabajas con FactuSOL

    Dinos qué tienda o marketplaces usas, si tienes FactuSOL local o en la nube y qué problema quieres resolver.

    Diagnóstico comercial

    Cuéntanos qué proceso necesitas mejorar

    Con esta información podremos entender mejor tu caso y orientarte desde el primer contacto.

    01Datos básicos
    02Caso a revisar
    03Disponibilidad opcional
    01

    Datos básicos

    Necesitamos estos datos para poder responderte con contexto.

    02

    El caso que quieres revisar

    No necesitas saber todavía qué módulos o conexiones necesitas.

    ¿Qué camino quieres valorar? *
    Añadir contexto para preparar la conversación (opcional)

    Puedes enviarlo sin completar este bloque.

    ERP actual
    Canales y sistemas actuales
    Prioridades
    Pedidos aproximados
    Facturación aproximada
    Contexto fiscal
    03

    ¿Quieres verlo en una reunión?

    Elige un hueco disponible y revisamos tu caso con un especialista de O2W.