Amplía Ordering.co con tus propios plugins.

Los plugins amplían Ordering.co. Ordering.co opera la operación.

Un plugin agrega la lógica que hace diferente a tu negocio. Ordering.co te da todo lo que la rodea:

• Tus propios canales. Sitios web, apps y kioscos con tu marca donde tus clientes te piden directamente.
• Más productos y funciones. Más de 20 productos y más de 1,500 funciones en pedidos, lealtad, marketplaces, call centers y delivery.
• Diseño a la medida. Nuestro equipo te ayuda a dar forma a la experiencia que ven tus clientes.
• Hecho para ampliarse. Plugins, API y MCP, y el código fuente de las aplicaciones en los planes que cumplen los requisitos.

Por qué usar Plugins con Ordering.co

• Amplía sin bifurcar. Tu plugin se ejecuta como un servicio independiente, así que tu código se mantiene separado de la plataforma.
• Reacciona en el momento justo. Los hooks se ejecutan cuando cambian los pedidos, los carritos, los menús, los negocios, las entregas y los pagos.
• Cambia los datos, no solo los observes. Los filters devuelven datos transformados y los prehooks pueden detener una solicitud, así que un plugin puede dar forma al comportamiento de Ordering.co.
• Ajustes en el panel de administración. Cada plugin tiene sus propios ajustes, así que los operadores lo configuran sin tocar código.
• Probado en producción. Más de 40 de las integraciones de nuestro catálogo funcionan como plugins, entre ellas pasarelas de pago, sistemas POS, empresas de delivery y marketplaces.

Qué puedes construir

Los plugins declaran lo que son en su manifiesto. Las integraciones de nuestro catálogo muestran los tipos principales:

• Sistemas POS. Envían cada pedido nuevo al POS, mantienen sincronizado el estado del pedido y sincronizan menús y datos del negocio. Ejemplos: Square, Clover, Oracle Simphony, Shopify.
• Métodos de pago. Agregan un método de pago y cobran y confirman cada pago a través del proveedor. Ejemplos: HitPay, Redsys, Mercado Pago, Stripe Terminal.
• Empresas de delivery. Cotizan las entregas en el pago, crean la entrega cuando se hace el pedido y la cancelan cuando el pedido se cancela. Ejemplos: Uber Direct, Shipday, Rappi Cargo, Yango Delivery.
• Canales de venta y middleware. Publican tu menú en un marketplace y mantienen sincronizados sus pedidos. Ejemplos: Uber Eats, Deliverect, Stream.
• Tus propias reglas de negocio. Validan una solicitud, enriquecen datos o mantienen un sistema externo sincronizado con tu operación.

Cómo funciona un plugin

1. El manifiesto

Cada plugin publica un archivo config.json en su URL raíz. Declara:

• Identidad: nombre, llave única, descripción, autor y versión.
• Hooks: los eventos que escucha el plugin, el tipo de cada hook, la ruta a la que Ordering.co debe llamar y un retraso opcional.
• Ajustes: los campos que llenan los operadores, con traducciones para cada idioma.
• Métodos de pago: cualquier método de pago que el plugin agregue a Ordering.co.
• Enlaces de instalación y configuración: una dirección a la que Ordering.co llama justo después de la instalación, y las páginas que el plugin aloja para los ajustes generales y la configuración por negocio.

2. Instalación

Cuando agregas la URL del plugin en el panel de administración, Ordering.co lee el manifiesto y:

1. Registra el plugin y sus hooks.
2. Crea una sección de Plugin settings con los campos declarados.
3. Crea los métodos de pago que el plugin declara.
4. Llama a la dirección de instalación del plugin con tu proyecto, para que el plugin pueda conectarse de vuelta a la API de Ordering.co con su propio acceso.

Update vuelve a leer el manifiesto y aplica los hooks y los ajustes nuevos. Delete elimina el plugin junto con sus ajustes y sus métodos de pago.

3. Hooks

Ordering.co llama a tu plugin de tres maneras:

• Actions se ejecutan después de un evento, en segundo plano, de modo que no retrasan la solicitud que las activó. Úsalas para enviar un pedido a un POS o crear una entrega. Una action puede esperar un número determinado de segundos antes de ejecutarse.
• Filters reciben datos y los devuelven, modificados o no, antes de que Ordering.co los use. Los plugins de pago usan filters para cobrar y confirmar pagos.
• Prehooks se ejecutan antes de que Ordering.co procese una solicitud. Pueden agregarle datos a la solicitud o detenerla con un mensaje de error.

Cada llamada incluye los datos del evento, los detalles de la solicitud, el usuario que la hizo y los ajustes del plugin.

4. Ajustes

Los operadores configuran el plugin en Plugin settings, a partir de los campos que declara su manifiesto. Un plugin también puede abrir su propia página de ajustes dentro del panel de administración. Los plugins de POS, de canales de venta y de delivery se conectan negocio por negocio desde la sección Connect, de modo que cada tienda pueda tener su propia configuración.

Hooks que puedes usar

Ordering.co expone más de 280 hooks con nombre. Estos son los hooks que usan los propios plugins de Ordering.co, agrupados por área:

• Pedidos: orders_register, orders_update, orders_delete, orders_reorder.
• Menú y catálogo: sync_menu, push_menu, products_update.
• Negocios: sync_business, business_update, business_delete, business_configs_update, business_metafields_register, business_third_party_integrations_update, business_third_party_integrations_delete.
• Carrito y pago: cart_add_product, cart_update_product, cart_remove_product, cart_multi_product, cart_change_paymethod, order_options_update.
• Delivery: delivery_create_order, delivery_update_order_status, delivery_cancel_order, driver_company_register.
• Pagos: paymethod_<gateway>_pay, paymethod_<gateway>_confirm, paymethod_<gateway>_group_pay, paymethod_<gateway>_group_confirm, además de user_paymethod_paymethods_register, user_paymethod_paymethods_search y user_paymethod_paymethods_delete para las tarjetas guardadas.
• Clientes y cuentas: users_register, users_update, users_login, addresses_register, code_verification_<channel>_sent.
• Ajustes del proyecto: configs_update.

Configura y sal a producción

Las guías de Deliverect y de Shipday (en inglés) muestran el mismo flujo de instalación:

1. En el panel de administración de Ordering.co, abre Settings > Developers > Plugins.
2. Selecciona Add new plugin, ingresa la URL del plugin y agrégalo. Los plugins que proporciona Ordering.co también se pueden instalar desde la lista de System Plugins de la misma pantalla cuando se muestra.
3. Abre Plugin settings, selecciona el plugin y llena sus ajustes.
4. En los plugins de POS, de canales de venta y de delivery, conecta cada negocio desde Connect.
5. Prueba con el sandbox del proveedor o con un negocio de prueba y luego sal a producción.

Usa Enable para activar o desactivar un plugin, Update para cargar una nueva versión de su manifiesto y Delete para eliminarlo.

Más formas de ampliar Ordering.co

• Los Webhooks envían eventos de Ordering.co a una URL que tú eliges.
• La Ordering API permite que tus aplicaciones trabajen con pedidos, negocios, categorías y productos.
• API y MCP conectan tus sistemas y las herramientas de IA compatibles con Ordering.co.
• Automatización y más enumera las otras formas de conectar y automatizar tu operación.