Към съдържанието
Съдържание на курса

Урок 04 — Поръчката стига до ERP

От · съосновател и Chief Executive Officer на Hábil ·

Какво ще постигнеш: да регистрираш поръчката в ERP системата на фирмата, която не получава JSON, а редове в таблици: една заглавна част, по един ред от детайла за всяка позиция и накрая процедура, която проверява дали всичко излиза.

Преди да започнеш, ти трябват: завършен урок 03 и включена средата от урок 00:

docker compose -f infra/compose.yaml up -d --wait     # desde la carpeta raíz de la práctica

Новото днес, в едно изречение

Досега дестинацията беше API, който получава цял JSON наведнъж. ERP е различен: пази информацията в таблици, като електронни таблици, и всяка поръчка заема няколко реда в две таблици. Днес твоят маршрут разделя поръчката на парчета и я записва ред по ред.

Три думи, които ще използваш:

Дума Какво е Една картина
ERP Централната система, в която фирмата записва какво продава, купува и фактурира Счетоводната книга на фирмата
SQL Езикът за разговор с база данни: INSERT добавя ред, SELECT ги извлича Указанията, които диктуваш на този, който води книгата
Съхранена процедура Програма, която живее вътре в базата и се вика с CALL Счетоводителят, който преглежда страницата, преди да я подпише

1. Подготви папката си

cd lecciones/04-al-erp
cp -R inicio mio

2. Запознай се с таблиците на ERP

ERP има две таблици. Така би изглеждала поръчка 1001, вече регистрирана:

pedido_cabecera — един ред за поръчка

pedido tienda fecha total estatus
1001 T-014 2026-11-12 10:15:00 428.00 REGISTRADO

pedido_detalle — един ред за всяка позиция от поръчката

pedido posicion sku cantidad precio
1001 1 SKU-0001 2 89.50
1001 2 SKU-0042 1 249.00

Колоната pedido в детайла е това, което свързва всеки ред с неговата заглавна част. Затова заглавната част се записва първа: ERP не приема ред от детайла за поръчка, която още не съществува.

А estatus започва от RECIBIDO. Сменя се на REGISTRADO едва когато процедурата registrar_pedido провери, че сборът на детайла е равен на общата сума в заглавната част. Ако искаш да видиш как е направена, тя е в infra/mariadb/01-erp.sql; не е нужно да я променяш.

3. Прочети мапинга и маршрута

Мапингът вече е готов: mio/mappings/erp/pedido/v1/mapeo.jsonata. Превръща поръчката в JSON с две части, cabecera и detalle, които носят точно имената на колоните. Тествай го както в урок 03:

../../herramientas/probar-mapeo mio/mappings/erp/pedido/v1

Обърни внимание на датата. Магазинът праща 2026-11-12T10:15:00-06:00, а мапингът я оставя като 2026-11-12 10:15:00. Маха часовата зона (-06:00), защото колоната в ERP е от тип DATETIME, който пази дата и час без зона. Уговорката с ERP е, че този час е часът на магазина; типът данни не го знае — знае го този, който го чете.

Маршрутът: отвори mio/orden-al-erp.camel.yaml. Над маршрута има един bean с име erp: това е връзката с базата, с нейния адрес, потребител и парола. Стъпките sql: го използват чрез dataSource: "#erp".

Маршрутът вече прави това:

POST /ordenes  →  traducir  →  guardar cabecera y detalle en variables  →  INSERT de la cabecera  →  (te toca)

Виж INSERT-а на заглавната част:

uri: sql:INSERT INTO pedido_cabecera (pedido, tienda, fecha, total) VALUES (:#pedido, :#tienda, :#fecha, :#total)

Всяко :#nombre е празно поле, което Camel попълва с полето със същото име, което носи тялото на съобщението. Затова точно преди това маршрутът слага заглавната част като тяло чрез setBody.

Още нещо: драйверът за MariaDB — частта, която учи Camel да говори с тази база — не е включен. Иска го файлът dependencias.txt, а herramientas/camel го сваля при стартиране.

4. Предвиди

Маршрутът от inicio/ записва само заглавната част. Преди да го довършиш, отговори на лист хартия:

  1. Ако пратиш поръчка 1001 с маршрута такъв, какъвто е, какви редове остават във всяка таблица и с какъв статус?
  2. Ако добавиш CALL registrar_pedido, без да запишеш детайла, какво би отговорила процедурата?

Първото можеш да провериш още сега. От mio/ стартирай маршрута:

cd mio
../../../herramientas/camel run orden-al-erp.camel.yaml

В друг терминал, от същата папка mio/, прати поръчката и попитай ERP:

curl -XPOST localhost:8080/ordenes -H 'Content-Type: application/json' -d @../../../datos/ordenes/orden-1001.json

docker compose -f ../../../infra/compose.yaml exec erp \
  mariadb -uintegracion -ppractica erp -e "SELECT * FROM pedido_cabecera; SELECT * FROM pedido_detalle;"

Сравни двата отговора. Твоят маршрут отговори на магазина {"pedido":"1001","erp":"REGISTRADO"}. ERP казва друго: заглавната част е в RECIBIDO, а детайлът е празен. Маршрутът не лъже нарочно: последната му стъпка пише този отговор, без да пита ERP за каквото и да е. Затова в този курс се брои това, което е записала дестинацията, никога това, което казва маршрутът.

Поръчка със заглавна част и без детайл е поръчка наполовина. За ERP тя съществува, но не може нито да се изпълни, нито да се фактурира.

5. Напиши детайла и приключването

Спри маршрута с Ctrl+C. В mio/orden-al-erp.camel.yaml има два коментара, които казват TE TOCA („твой ред е“).

Детайлът. Списъкът с редовете е в ${variable.detalle} и ти трябва по един INSERT за всеки. За това съществува стъпката split: взема списък, разделя го на елементите му и изпълнява стъпките си по веднъж за всеки елемент, като този елемент е тялото.

- split:
    expression:
      simple:
        expression: "${variable.detalle}"
    steps:
      - to:
          uri: sql:INSERT INTO pedido_detalle (…) VALUES (…)
          parameters:
            dataSource: "#erp"

Довърши сам колоните и празните полета. Използвай INSERT-а на заглавната част като образец; колоните на детайла са в таблицата от стъпка 2.

Приключването. След split извикай процедурата:

uri: sql:CALL registrar_pedido(:#pedido)

Внимавай с тялото: какво носи то след split? Празното поле :#pedido има нужда от тяло, което съдържа полето pedido. Коя стъпка от маршрута вече направи това преди INSERT-а на заглавната част?

Този шаблон си има име в EIP: Splitter. Поръчка с няколко позиции се разделя на по-малки съобщения, по едно за позиция, защото така ги получава дестинацията.

6. Сравни с предвиждането си

Пусни маршрута отново и прати поръчка 1001. Преди това изпразни ERP, за да започнеш на чисто:

docker compose -f ../../../infra/compose.yaml exec erp \
  mariadb -uintegracion -ppractica erp -e "DELETE FROM pedido_detalle; DELETE FROM pedido_cabecera;"

Провери двете таблици както в стъпка 4. Сега заглавната част трябва да казва REGISTRADO, а детайлът да има два реда.

А въпрос 2? Ако извикаш процедурата без детайл, тя отговаря El total no cuadra con el detalle (общата сума не съвпада с детайла): сборът на нула реда е 0, а общата сума е 428. ERP не вярва на това, което му пращаш: проверява го. Също като API-то в урок 03 — дестинация, която валидира, е това, което прави една грешка видима.

7. Провери

Спри маршрута с Ctrl+C и от папката на урока:

cd ..
./verifica

⚠️ verifica изпразва таблиците на ERP, преди да тества: това е учебен ERP и така започва от нулата всеки път.

Урокът е завършен, когато видиш шестте зелени отметки:

✅ El mapeo al ERP pasa sus casos dorados
✅ La ruta arrancó
✅ El ERP tiene las 2 cabeceras
✅ El pedido 1001 tiene sus 2 renglones de detalle
✅ El pedido 1003 tiene sus 3 renglones de detalle
✅ El procedimiento marcó los 2 pedidos REGISTRADO

verifica праща две поръчки, 1001 и тази със стотинките (1003), и пита ERP какво е записал. Както винаги, го потвърждава дестинацията, не твоят маршрут.

Не тръгва? ./verifica solucion тества нашето решение, а diff mio/orden-al-erp.camel.yaml solucion/orden-al-erp.camel.yaml ти казва по какво се различават.

Какво виждаш Какво правиш
Al pedido 1001 le faltan renglones de detalle split не се изпълнява или му липсва празно поле: провери дали обхожда ${variable.detalle}
Hay pedidos sin REGISTRADO Липсва CALL или тялото не носи pedido: прегледай стъпка 5
No pude hablar con el ERP: ¿corriste la 00? Включи средата: docker compose -f infra/compose.yaml up -d --wait
El puerto 8080 está ocupado Останал е работещ маршрут: спри го с Ctrl+C

Защо е направено така

Днес записа поръчката в три отделни стъпки. Картата, която обяснява защо това не стига и какво беше решено, е тази на следващия урок: В ERP — всичко или нищо.

Преговор

  1. Защо една поръчка заема редове в две таблици и коя колона ги свързва?
  2. Защо заглавната част се записва преди детайла?
  3. Какво прави split и какво носи тялото при всяко завъртане?
  4. Откъде взема Camel стойността на :#sku?
  5. Какво проверява registrar_pedido, преди да отбележи една поръчка като REGISTRADO?

Следва: какво става, ако някой ред по средата е грешен и ERP го отхвърли? Заглавната част вече е записана, а детайлът е наполовина. В урок 05 ще направиш така, че ERP да записва всичко или нищо.

Да обсъдим вашия проект

Предпочитате имейл? Пишете ни на hola@habil.mx