Съдържание на курса
Урок 21 — Изпратено не значи потвърдено
От Dorian Chávez · съосновател и Chief Executive Officer на Hábil ·
Какво ще постигнеш: каналът на партньора да не се смята за приключен, когато 850-ката остане на неговия SFTP, а когато партньорът отговори със своето потвърждение, 997. Това потвърждение пристига по-късно, в друг файл и без номера на поръчката: твоята работа е да знаеш на кое изпращане отговаря.
Преди да започнеш, ти трябват: завършени уроци 20, 09 (нишката за корелация) и 06 (четене на X12) и
включена средата от урок 00. Този урок използва нова услуга от средата, socio-bot, която играе ролята на системата на
партньора и отговаря с 997. Ако не е вдигната при теб:
docker compose -f infra/compose.yaml up -d --wait
Новото днес, в едно изречение
При API-то и ERP отговорът пристига в същото извикване: питаш, отговарят ти и знаеш. При партньора — не.
Рутерът оставя 850-ката в една папка на SFTP и там извикването свършва. Това, че файлът е там, казва, че си го
оставил, а не че партньорът го е прочел или го е разбрал. Партньорът отговаря, когато системата му обработи файла:
секунди по-късно в този курс, часове в реалния живот. И отговаря по друг път, като оставя един 997 в своята папка
salida/.
Картината: оставяш плик в пощенската кутия на една фирма. Кутията не ти казва дали някой го е отворил. Дни по-късно получаваш по пощата писмо, което казва: „Получихме вашия документ с референтен номер 100000002 и той е пълен“. Писмото не споменава името ти, нито за какво е ставало дума: споменава референтния номер, който ти си сложил на плика. Ако не си записал какво си пратил с този номер, не знаеш какво ти потвърждават.
1. Подготви папката си
cd lecciones/21-enviado-no-es-confirmado
cp -R inicio mio
Рутерът има нов файл, orden-router/acuses.camel.yaml. Отгоре е маршрутът sondeo-acuses, вече готов:
чете всеки 997-<algo>.edi от папката salida/ на партньора, превежда го със своя JSONata мапинг и го подава на
correlacionar-acuse, което е твоята част.
Преди да пишеш, прочети един 997. Отвори
inicio/orden-router/mappings/edi/997/v1/cases/aceptacion/entrada.json. Това е един-единствен ред с \n между
сегментите; разделен изглежда така:
ISA*00* *00* *ZZ*SOCIO01 *ZZ*TIENDANORTE *261113*0100*U*00401*700000001*0*P*>~
GS*FA*SOCIO01*TIENDANORTE*20261113*0100*700000001*X*004010~
ST*997*0001~
AK1*PO*100000002~
AK2*850*0001~
AK5*A~
AK9*A*1*1*1~
SE*6*0001~
GE*1*700000001~
IEA*1*700000001~
| Сегмент | Какво казва | Чий е номерът? |
|---|---|---|
ISA … *700000001* |
Пликът на 997, със своя контролен номер | На партньора. Сложил го е той, когато е пратил потвърждението си |
AK1*PO*100000002 |
„Потвърждавам групата поръчки за покупка (PO) с номер 100000002“ |
Твой. Това е GS06, който прати в 850-ката |
AK2*850*0001 |
„Вътре в тази група — документът 850 с номер 0001“ | Твой. Това е ST02 на 850-ката |
AK5*A |
Документът се приема (A) или се отхвърля (R) |
— |
Сега отвори този за отхвърляне, cases/rechazo/entrada.json. Носи още два сегмента преди AK5*R: AK3*PO1*6**8
казва, че проблемът е в сегмента PO1, шестия в документа; AK4*7*234*7*SKU-9999 казва, че елемент 7
на този сегмент носи SKU-9999, продукт, който партньорът не познава.
И отвори двата esperado.json: това е, което мапингът извлича от всеки 997 и което твоят маршрут получава в тялото.
{"socio": {"control": "700000001"}, "grupo": {"tipo": "PO", "control": "100000002"},
"documento": {"tipo": "850", "control": "0001"}, "acuse": "A", "errores": []}
2. Предвиди
Отговори на лист хартия:
- Остави 850-ката на 4001. Получил ли я е вече партньорът? Как би разбрал?
- 997 не носи номера на поръчката. С кой номер би го свързал с операцията на 4001? Потърси в таблицата
operacionотinfra/postgres/01-estado.sqlкоя колона пази този номер и от кой урок. - Пристига един 997, който цитира група, която никога не си пращал. Какво трябва да стане с него?
Виж какво е положението днес:
./verifica inicio
Първата отметка минава: 850-ката остава оставена и без потвърждение. После партньорът отговаря, рутерът чете 997… и не
прави нищо с него. Каналът на партньора остава в aceptada завинаги, макар партньорът вече да е потвърдил, а за отхвърлянето на
4006 не научава никой.
3. Корелирай потвърждението
Отвори mio/orden-router/acuses.camel.yaml и намери маршрута correlacionar-acuse. Днес той само пише в лога. Има
четири TODO и всички освен последния се побират в една-единствена SQL инструкция:
| TODO | Какво прави | За какво |
|---|---|---|
| 1 | Записва потвърждението в таблицата acuse, независимо дали съответства на нещо |
Нито едно потвърждение да не се губи |
| 2 | Намира операцията на партньора, която е очаквала това потвърждение | Корелацията: единствената трудност днес |
| 3 | Прехвърля я в confirmada (AK5 = A) или rechazada (AK5 = R) и записва в реда на потвърждението на коя операция е съответствало |
Каналът да приключва само с потвърждението |
| 4 | Ако не е съответствало на никоя, съобщава го с WARN, който казва <archivo> no corresponde |
Някой да види потвърждението без собственик |
Формата на инструкцията ти я даваме. Първо един UPDATE … RETURNING вътре във WITH, който променя
операцията и връща коя е променена; после INSERT-ът на потвърждението, който използва върнатото:
- to:
uri: >-
sql:WITH op AS (
UPDATE operacion SET estado = CASE WHEN CAST(:#${body[acuse]} AS text) = 'R' THEN 'rechazada' ELSE 'confirmada' END
WHERE canal = 'edi' AND estado = 'aceptada'
AND … -- TODO 2: tus condiciones
RETURNING id, orden, momento, estado)
INSERT INTO acuse (archivo, control_socio, grupo_tipo, grupo_control, documento_tipo, documento_control,
codigo, errores, operacion)
SELECT :#${variable.archivo}, :#${body[socio][control]}, :#${body[grupo][tipo]}, :#${body[grupo][control]},
:#${body[documento][tipo]}, :#${body[documento][control]}, :#${body[acuse]},
CAST(:#${variable.leido} AS jsonb) -> 'errores', (SELECT id FROM op)
RETURNING COALESCE((SELECT orden || ' ' || momento || ' → ' || estado FROM op), '') AS resultado
variableReceive: correlacion997
parameters:
dataSource: "#estado"
outputType: SelectOne
Ако UPDATE не намери нищо, op остава празно: потвърждението се записва въпреки това, с operacion в NULL, а resultado
излиза като празен текст. Точно това използва TODO 4.
Твоята работа са условията на TODO 2. Операцията, която очаква това потвърждение, е тази, която изпълнява и четирите:
| Условие | В SQL | Защо |
|---|---|---|
| Контролният ѝ номер е този на групата, която цитира AK1 | numero_control = CAST(:#${body[grupo][control]} AS text) |
Това е номерът, който ти сложи в GS06 от урок 15 насам |
| Тя е за събитието, което съответства на документа | momento = CASE CAST(:#${body[documento][tipo]} AS text) WHEN '850' THEN 'creada' WHEN '856' THEN 'embarcada' WHEN '214' THEN 'entregada' END |
Един 850 потвърждава създаването; един 856 — изпращането |
| Типът на групата съвпада с документа | PO върви с 850, SH с 856 и QM с 214 |
Зле сглобено потвърждение не бива да потвърждава нищо |
| Тя е първият документ в групата | CAST(:#${body[documento][control]} AS text) = '0001' |
Всяка наша група носи един-единствен документ, с ST02 0001 |
Третото го напиши ти, с CASE като този във второто.
За TODO 4 — един choice: ако ${variable.correlacion997} == '', един log на ниво WARN със съобщението
El 997 ${variable.archivo} no corresponde a ninguna operación que esperara su acuse; ако не, обикновен log, който
казва коя поръчка е потвърдена.
Обърни внимание какво не използваш: ISA13 на 997, ${body[socio][control]}. Той се записва в control_socio, но не
върши работа за корелиране: това е номерът, който партньорът е сложил на своя плик, а не твоят.
4. Счупи едно нарочно
С всичко завършено промени първото условие така, че да сравнява с номера на партньора:
numero_control = CAST(:#${body[socio][control]} AS text). Пусни ./verifica.
Преди това предвиди: какво става с 4001, когато пристигне нейният 997?
Остава в aceptada. 997 се записва в таблицата acuse без операция, а в лога се появява твоят WARN с no corresponde.
Излиза в червено отметката за потвърждаването. ISA на партньора (7000000…) никога няма да съвпадне с твоя
номер (1000000…): това са две номерации на две различни системи. Ако не го беше записал като потвърждение без собственик,
щеше да се загуби безшумно. Върни grupo.
5. Провери
./verifica
verifica праща 4001 и чака потвърждението ѝ; после 4006, която иска продукт, непознат на партньора; и накрая
оставя на SFTP един 997, който цитира група, която никога не сме пращали. Урокът е завършен, когато видиш седемте зелени отметки:
✅ Arrancaron el router (con el sondeo de los acuses), los tres canales y el sondeo de la bodega
✅ El 850 de la 4001 quedó depositado («aceptada») y todavía no hay acuse: enviado no es confirmado
✅ Llegó el 997 de aceptación: el canal pasó a «confirmada», correlacionado por el GS06 (…) y el ST02, no por el ISA del socio
✅ El 997 que leyó el router pasa el lector X12, y su AK1 cita el grupo (…)
✅ La API y el ERP no esperan un acuse: se quedan en «aceptada» (bd=aceptada rest=aceptada)
✅ La 4006: el 997 de rechazo dejó el canal en «rechazada», con el error que señaló el socio (PO1, SKU-9999)
✅ Un 997 que cita un grupo que no mandamos quedó anotado sin operación, con su WARN, y no confirmó nada más
Отвори 997, който потвърди 4001: verifica го копира в mio/salida/997-<número>.edi. Намери своя номер в AK1, а
този на партньора — в ISA.
Не тръгва? ./verifica solucion тества нашето решение, а
diff mio/orden-router/acuses.camel.yaml solucion/orden-router/acuses.camel.yaml ти казва по какво се различават.
| Какво виждаш | Какво правиш |
|---|---|
Esperaba la 4001 confirmada, а потвърждението е nada |
Липсва INSERT INTO acuse или инструкцията не носи dataSource: "#estado" |
Esperaba la 4001 confirmada, а потвърждение има |
UPDATE не е намерил операцията: провери дали сравняваш с body[grupo][control] и дали CASE за събитието е пълен |
La 4006: esperaba rechazada, а още е aceptada |
SET estado не чете body[acuse] или твоето условие за типа на групата не пропуска PO с 850 |
El 997 sin dueño, а има 0 потвърждения без операция |
Потвърждението без собственик не е записано: INSERT трябва да се изпълни, дори UPDATE да не промени нищо |
El 997 sin dueño и липсва WARN |
choice от TODO 4 не сравнява с '' или log не носи loggingLevel: WARN |
No está arriba socio-bot |
Вдигни средата, както казва „Преди да започнеш“ |
El puerto 8080 está ocupado |
Услугите от друго пускане са останали вдигнати: DONDE=mio docker compose -f compose.yaml down |
Какво учи това извън курса
Да оставиш не значи да доставиш, а да доставиш не значи, че са го разбрали. Един файл на SFTP може да си стои там, без никой да го обработи. В EDI 997 е стандартният начин другият да каже „получих го и успях да го прочета“ или „получих го и е грешен в еди-кой си сегмент“.
Асинхронен отговор се корелира по това, което ти си пратил. 997 не знае нищо за поръчки: знае за контролния номер, който е носил твоят файл. Затова от урок 15 рутерът присвоява уникален номер на всеки документ и го записва. Без този записан номер потвърждението няма към кого да сочи.
Всяка система номерира своето. ISA на 997 е на партньора; GS06, който той цитира, е твой. Объркването им е най-честата грешка при корелиране и тя не се проваля шумно: просто не намира нищо.
Това, което не съответства, се записва и се съобщава. Потвърждение без собственик може да е грешка на партньора, старо изпращане или тест. Ако го изхвърлиш, го скриваш; ако го запишеш, оставяш някой да го разследва.
Упражнение: две потвърждения, два номера
- На хартия, с двата
entrada.jsonот еталонните случаи, отговори за всеки 997: кой контролен номер цитира AK1? Кой е този на ISA? Приема ли, или отхвърля? Ако отхвърля, кой сегмент и коя стойност посочва? - След като пуснеш
./verifica, провери таблицата с потвържденията:SELECT archivo, control_socio, grupo_control, codigo, operacion FROM acuse ORDER BY id;Кой от трите реда няма операция и защо? - От трите канала в курса кой завършва в
aceptadaи кой вconfirmada? Напиши по едно изречение за всеки, което обяснява защо това е неговият край.
Защо е направено така
Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:
- 997 се корелира по групата и документа и само той потвърждава
Преговор
- Какво е 997 и кой го праща?
- Какво цитира AK1 и какво цитира AK2?
- Защо ISA13 на 997 не върши работа за корелиране?
- Какво става с 997, който не съответства на никоя операция? Защо не се изхвърля?
- Заключителният въпрос: „оставено“ и „потвърдено“ не са едно и също. Кой канал в курса кое очаква и защо API-то и ERP не очакват потвърждение?
Следва: в урок 22 SFTP на партньора пада и с повторните опити от урок 19 това спира също API-то и ERP. Как спираш да викаш паднала дестинация, без да спираш останалите?
Предпочитате имейл? Пишете ни на hola@habil.mx