Primeros pasos como empresa de fulfilment (API)
Esta guía es para empresas de fulfilment (3PL) que embalan y envían para varias tiendas online y quieren ofrecer a esas tiendas Payment on Delivery digital, manteniendo su propio sistema de gestión de almacenes (WMS). Su WMS sigue recibiendo los pedidos como hasta ahora. Para los pedidos con Payment on Delivery, solicita a QrX la etiqueta del transportista y la etiqueta de pago de QrX a través de la API pública de QrX. En la puerta, el comprador escanea el código QR de QrX y paga a través del propio proveedor de pago de la tienda online. QrX nunca retiene el dinero, y este nunca pasa por su empresa.
En PortalX, esta es la ruta de configuración Soy una empresa de logística y conecto mi propio WMS a través de la API de la guía de inicio (Configuración > Negocios > Primeros pasos).
Elija su modelo de cuenta
QrX funciona con canales de venta (canales de comercio). Cada canal tiene su propio proveedor de pago, clave API, marca y transportista predeterminado. Hay dos formas de configurar a sus clientes:
Usted gestiona los clientes (lo más habitual): su empresa tiene una cuenta de QrX con un canal de comercio por cada tienda online cliente. Conecta el proveedor de pago de cada cliente al canal de ese cliente, de modo que los pagos en la puerta se liquidan directamente al cliente. Recibe una sola factura de QrX para todos los clientes.
Los clientes tienen su propia cuenta de QrX: cada tienda online se registra por sí misma, conecta su proveedor de pago y da acceso a su empresa con Acceso de socios (Configuración > Negocios > Acceso de socios, ámbito Reseller operations (operaciones de revendedor) o Carrier operations (operaciones de transportista)). Su WMS usa entonces la clave API del canal del cliente, o se conecta mediante QrX Connect (consulte "QrX Connect: conectar su plataforma con OAuth").
Acuerde con QrX qué modelo utiliza antes de que su primer cliente pase a producción. Las comisiones de socio para empresas de fulfilment se acuerdan por colaboración; consulte "Socios y cómo asociarse con QrX".
1. Configure su empresa
Datos de la empresa. QrX conserva el nombre de la empresa, la dirección y el número de IVA o de la Cámara de Comercio de su registro. Si falta algo o ha cambiado, haga clic en Pregunta a QrX en el paso y QrX lo completa por usted. El paso se marca cuando se conocen todos los datos.
Dirección de remitente del almacén con un código corto para las llamadas a la API: Configuración > Operaciones > Direcciones.
Equipo: invite a sus compañeros de almacén e informática en Configuración > Equipo y acceso > Usuarios, y asígneles roles en Roles y permisos.
2. Añada sus clientes
Un canal por cada tienda online cliente: Configuración > Negocios > Canales para comerciantes. Use el nombre de la tienda del cliente para que los compradores lo reconozcan en la página de pago.
Conecte el proveedor de pago de cada cliente en la pestaña Pagos del canal (Stripe, Mollie o MultiSafePay). El cliente completa el alta con el proveedor con los datos de su propia empresa.
Marca por cliente: logotipo y colores en el canal, una plantilla de Track & Trace (Configuración > Operaciones > Seguimiento) y plantillas de mensajes, para que los compradores vean la tienda online y no el almacén.
3. Conecte transportistas e impresión
Transportistas: Configuración > Operaciones > Proveedores de envíos. Use sus propios contratos con transportistas o la cuenta QrX UPS Payment on Delivery. Vincule una cuenta a todos los canales o al canal de un cliente.
Formato de etiqueta: elija PDF o ZPL y, para UPS, Standard (etiqueta del transportista más etiqueta de pago de QrX) o Extended (una etiqueta combinada). Imprima el juego completo para cada paquete con Payment on Delivery.
Si su WMS imprime por sí mismo, usa las etiquetas que devuelve la API. Si no, conecte PrintNode en Configuración > Preferencias > Impresión.
4. Conecte su WMS
Clave API por canal de cliente: Canales para comerciantes, abra el canal, pestaña Configuración, Regenerar clave API (Regenerate API Key). Guarde las claves cifradas en su servidor, una por cliente.
Token: POST /api/v1/auth/token con la cabecera QrX-MerchantChannel-API-Key.
Consulte los códigos con /api/v1/reference/shipping-methods y /api/v1/reference/senders. Nunca use IDs fijos de otro cliente.
Cree la transacción con su etiqueta en una sola llamada: POST /api/v1/transactions con el tipo Payment para Payment on Delivery, o No payment para pedidos prepagados, más un bloque parcel con CreateCarrierLabel. Guarde el ID de transacción y las etiquetas devueltos antes de notificar el paquete como embalado, para que un reintento nunca compre una segunda etiqueta.
Webhooks: Configuración > Avanzado > Ganchos web. Suscríbase a los eventos de transacción pagada, cancelada y de envío, por canal o para todos los canales. Verifique la cabecera X-QrX-Signature.
Pruebe de principio a fin en modo de prueba para cada cliente antes de pasar a producción: entrada del pedido, etiqueta impresa, pago de prueba en la puerta, webhook recibido.
5. Pase a producción cliente por cliente
Pida a QrX que active el modo real (Chatea con QrX en la guía).
Cambie un cliente cada vez y mantenga el flujo anterior para ese cliente hasta que se confirmen los primeros pagos reales en la puerta.
Conviene saber
Una transacción cancelada ya no se puede pagar, etiquetar ni preparar. Cancele en QrX cuando la tienda online cancele.
Un HTTP 201 al crear no es prueba de pago. Espere al webhook de pagado.
Su comisión de socio se acuerda en su contrato de socio; no existe una tarifa universal publicada.
En esta ruta, el stock y el picking permanecen en su propio WMS. ¿Prefiere gestionar su almacén en QrX? Consulte "Primeros pasos como empresa de fulfilment con el QrX WMS".
Cuándo contactar con nuestro equipo de soporte
Contacte con QrX para acordar su modelo de cuenta y las condiciones de socio, para certificar la salida de etiquetas y su impresora, cuando el alta de un cliente con su proveedor de pago esté bloqueada o cuando los webhooks sigan fallando.