Съдържание на курса
Урок 04 — Поръчката стига до ERP
От Dorian Chávez · съосновател и 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/ записва само заглавната част. Преди да го довършиш, отговори на лист хартия:
- Ако пратиш поръчка 1001 с маршрута такъв, какъвто е, какви редове остават във всяка таблица и с какъв статус?
- Ако добавиш
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 — всичко или нищо.
Преговор
- Защо една поръчка заема редове в две таблици и коя колона ги свързва?
- Защо заглавната част се записва преди детайла?
- Какво прави
splitи какво носи тялото при всяко завъртане? - Откъде взема Camel стойността на
:#sku? - Какво проверява
registrar_pedido, преди да отбележи една поръчка катоREGISTRADO?
Следва: какво става, ако някой ред по средата е грешен и ERP го отхвърли? Заглавната част вече е записана, а детайлът е наполовина. В урок 05 ще направиш така, че ERP да записва всичко или нищо.
Предпочитате имейл? Пишете ни на hola@habil.mx