Saltar al contenido principal

Order Webhook for n8n

Un webhook seguro de n8n para pedidos de cualquier app: comprueba tu clave y cada pedido, guarda los válidos en una tabla de datos y responde siempre. Con n8n 2.48.7 en Docker.

  • n8n
  • n8n Webhook node
  • n8n Code node
  • n8n If node
  • n8n Data table node

Capturas de pantalla

Captura 1 de 7: Portada de Order Webhook for n8n: la promesa, las etiquetas de tecnología, una terminal que envía un pedido con curl y recibe el pedido guardado, y el workflow Order webhook publicado.

Portada de Order Webhook for n8n: la promesa, las etiquetas de tecnología, una terminal que envía un pedido con curl y recibe el pedido guardado, y el workflow Order webhook publicado.

Pago único

  • 99 INR+ GST, 116,82 INR en total
  • 2 US$
  • Descárgalo desde tu biblioteca en cuanto se confirme tu pago.
  • Incluye todas las versiones futuras de este proyecto, sin costo adicional.
Última versión
1.0.0 · 21 nov 2026

Descripción general

El código fuente completo de un webhook de pedidos para n8n. Solo acepta llamadas con tu clave secreta, comprueba el cliente, el libro y la cantidad de cada pedido JSON, guarda los válidos en una tabla de datos de n8n y responde con el pedido guardado (201) o una lista de problemas (400). Incluye los dos workflows, la tabla con un clic y Docker Compose con n8n 2.48.7. Probado en macOS.

Las tiendas, los formularios y las apps necesitan un lugar al que enviar sus pedidos. Order Webhook for n8n te da esa dirección lista para usar: un webhook que solo responde a quien tiene tu clave, comprueba cada pedido, guarda los válidos y le dice a cada llamada exactamente qué pasó. Cada respuesta de abajo se probó con llamadas reales en macOS con n8n 2.48.7 y Docker Desktop.

Qué hace

  • Recibe pedidos de cualquier app. Una tienda, un formulario, un script u otro servicio envía cada pedido como JSON a http://localhost:5678/webhook/orders.
  • Solo deja entrar a quien tiene tu clave. Header Auth de n8n comprueba la cabecera X-API-Key en cada llamada. Sin clave o con una clave incorrecta, la respuesta es el estado 403 con Authorization data is wrong!, y el workflow ni siquiera arranca.
  • Comprueba cada pedido. El cliente y el libro deben ser texto, de 100 y 200 caracteres como máximo, y la cantidad un número entero del 1 al 100. Se listan todos los problemas, no solo el primero, y los demás campos nunca se guardan.
  • Guarda los pedidos válidos. Cada pedido válido se convierte en una fila de la tabla de datos Orders, con su propio id y la hora en que se guardó.
  • Responde a cada llamada. Un pedido guardado vuelve con el estado 201 y su nueva fila. Un pedido con problemas recibe el estado 400, no se guarda nada y la respuesta indica cada campo que hay que corregir. Un cuerpo que no es JSON recibe el 422 propio de n8n.
  • Crea su propia tabla. Un workflow de configuración crea la tabla Orders y sus columnas con un clic. Ejecutarlo otra vez no cambia nada.
  • Pone en marcha n8n si lo necesitas. compose.yml inicia n8n 2.48.7 en Docker, accesible solo desde tu ordenador, con un puerto y una zona horaria opcionales en .env.

Instalación

  1. Descomprime el archivo y abre una terminal en su carpeta.
  2. Inicia n8n con docker compose up -d. Sáltate este paso si ya usas n8n 2.
  3. Abre http://localhost:5678, crea tu cuenta de propietario e importa los dos workflows de la carpeta workflows.
  4. Ejecuta Set up the Orders table una vez.
  5. Crea una clave larga y aleatoria, por ejemplo con openssl rand -hex 32, y guárdala en una credencial Header Auth del nodo New order, con el nombre X-API-Key.
  6. Publica Order webhook y envía tu primer pedido.

Cada paso con capturas de pantalla: How to Set Up and Run the Order Webhook for n8n (se abre en una pestaña nueva) (en inglés).

Conviene saber

  • Cambia las reglas en un solo sitio. Los límites de la cantidad y de la longitud de los textos están al principio del nodo Check the order.
  • n8n no viene incluido. compose.yml descarga la imagen oficial de n8n, y se aplica la licencia propia de n8n.
  • Probado en macOS con Docker Desktop.

Aprende cómo funciona

El n8n Tutorial for Beginners (se abre en una pestaña nueva) gratuito (en inglés) enseña n8n desde cero. Part 4: Webhooks: Start a Workflow from Any App (se abre en una pestaña nueva) (en inglés) construye la primera versión de este webhook, How to Secure an n8n Webhook with Header Auth (se abre en una pestaña nueva) (en inglés) explica la clave y How to Send a Custom Response from an n8n Webhook (se abre en una pestaña nueva) (en inglés) explica las respuestas.

n8n es una marca de n8n GmbH. Docker es una marca de Docker, Inc. Los demás nombres son marcas de sus respectivos propietarios.

Serie de tutoriales gratuita

n8n Tutorial for Beginners

¿Prefieres aprender construyéndolo? Esta guía gratuita y paso a paso en nuestro blog muestra cómo se hace el proyecto.

Leer la serie (se abre en una pestaña nueva)

Qué te llevas

Todo lo que hay en el archivo, de un vistazo.

  • La versión 1.0.0 del código fuente completo: dos workflows de n8n, un archivo de Docker Compose, un ejemplo de .env y un README
  • El workflow Order webhook: Header Auth en el webhook, un paso que comprueba cada pedido, un paso que guarda los pedidos válidos en una tabla de datos y dos respuestas (201 y 400)
  • Comprobaciones que puedes cambiar: cliente y libro obligatorios, una cantidad entera del 1 al 100 y una lista con cada problema encontrado
  • Un workflow de configuración que crea la tabla de datos Orders con un clic
  • compose.yml con n8n 2.48.7, privado en tu ordenador, con el puerto y la zona horaria en .env
  • Un README con los pasos de configuración, el formato del pedido, cada respuesta, los ajustes, la solución de problemas y la limpieza

Construido con

Los entornos y las versiones exactos con los que se creó y se probó.

  • n8n2.48.7
  • n8n Webhook node2.2
  • n8n Code node2
  • n8n If node2.4
  • n8n Data table node1.1
  • n8n Respond to Webhook node1.5
  • Docker Compose5.7.0
  • Docker Engine29.9.3

Qué contiene el archivo

El árbol de carpetas que obtienes al descomprimirlo.

order-webhook-n8n/

  • .env.example
  • .gitattributes
  • .gitignore
  • README.md
  • compose.yml
  • workflows/
    • order-webhook.json
    • set-up-orders-table.json

Qué necesita de ti

Las cuentas y los servicios que espera encontrar, para que nada te sorprenda.

  • n8n 2 que ejecutes tú mismo (basta con la Community Edition gratuita), o Docker para ejecutar el n8n incluido
  • Docker Desktop en macOS o Windows, o Docker Engine en Linux, para usar compose.yml
  • Un puerto libre en tu ordenador, el 5678 por defecto
  • Una app, un formulario o un script que pueda enviar un POST HTTP con JSON y una cabecera

Versiones

Todas las versiones hasta ahora, de la más reciente a la más antigua.

  1. 1.0.0Más reciente

    Primera versión del código fuente completo.

    • Un Order webhook que solo acepta llamadas con tu clave (Header Auth) y comprueba cada pedido.
    • Los pedidos válidos se guardan en una tabla de datos de n8n y reciben el estado 201; los pedidos con problemas reciben el estado 400 y una lista de lo que hay que corregir.
    • Un workflow de configuración que crea la tabla Orders con un clic.
    • n8n 2.48.7 en Docker con compose.yml, probado en macOS.

Source Code Licence

Qué puedes hacer con él

What you may and may not do with the source code you buy.

Leer la licencia completa
  1. What this licence covers

This licence governs every file included in a product you buy from Dewiride Store: source code, configuration, database scripts, sample data, documentation and any other file in the download. It takes effect when your payment is confirmed and applies to every release of that product that reaches your library. Files that reach your library through an annual updates membership are governed in exactly the same way.

It forms part of the Terms of Sale and Use. Where a product page states different or additional licence terms for that product, those terms prevail for that product. The membership page may likewise state different or additional licence terms for the files a membership carries, and those terms then prevail for those files.

  1. The licence we grant you

We grant you a perpetual, worldwide, non-exclusive, non-transferable licence to use, reproduce, adapt, translate and modify the files, and to include the result in your own work, on the conditions set out below.

Perpetual means it does not expire. Worldwide means it is not limited to any country. Non-exclusive means we license the same product to other customers. Non-transferable means you cannot pass it on to someone else.

The licence is granted to you — either you personally, or the organisation you identified when buying. Everyone working within that organisation may use the files for that organisation’s projects. Nobody outside it may.

  1. What you may do
  • Use and change the files in your own projects, commercial or otherwise, with no limit on the number of projects.
  • Build a product or a service on them and charge your own customers for it.
  • Deploy the result for a client, as part of work you are doing for that client.
  • Distribute the result in compiled, deployed or otherwise non-source form.
  • Keep as many back-up copies as you reasonably need.
  • Study, observe and test how the code works, and obtain the information you need to make it work with your own software.

The last two are yours by law under sections 52(1)(aa) to (ac) of the Indian Copyright Act, 1957, and nothing in this licence is intended to take them away.

  1. What you may not do
  • Resell, sublicense, redistribute or publish the files themselves, in whole or in substantial part, in source form.
  • Include them in a template, starter kit, course, tutorial repository or component library that you sell or give away, where the code is the thing being supplied.
  • Share your account, your download links or your invoices with anyone outside your organisation.
  • Publish the files in a public repository, or in any other place where they can be obtained without buying them.
  • Remove or obscure the copyright and attribution notices in the source files.
  • Use the files to build something whose main purpose is to compete with Dewiride Store as a supplier of the same code.

The distinction that matters is simple: you may sell what you build with the code; you may not sell the code.

  1. Third-party components

Our products depend on open-source libraries, frameworks and services that we did not write. Those remain under their own licences, which we do not and cannot change. Where a product includes or requires such a component, its licence is named in the product’s documentation, and complying with it is your responsibility.

  1. Releases

Every release of a product you own is covered by this same licence and appears in your library at no extra cost. A release you have already downloaded remains licensed to you even if we later stop publishing the product. A release that reached your library through an annual updates membership is licensed to you on these same terms, and stays licensed after the period that carried it has ended.

  1. Ownership

We keep ownership of the files and of the copyright in them. You own whatever you create with them: your changes, your additions and the product you build are yours.

  1. If this licence ends

This licence ends if you materially breach it and do not put the breach right within thirty days of us asking you to in writing. It also ends if your payment is reversed or refunded, because the purchase it depends on no longer stands. Where a membership period is refunded or reversed, the licence ends for the releases that period carried and for nothing else: anything you bought separately, or that another period carried, is unaffected.

If it ends, you must stop using the files and delete the copies you hold. Work you had already delivered to a client before that point may continue in use, so that ending this licence never breaks something your own customer relies on.

  1. No warranty beyond the description

The warranties and limits in section 19 and section 20 of the Terms of Sale and Use apply to this licence as well.

  1. Governing law

This licence is governed by the law of India, and section 24 of the Terms of Sale and Use applies to any dispute about it. If a translation and the English version differ in meaning, the English version governs.