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

Урок 21 — Изпратено не значи потвърдено

От · съосновател и 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. Предвиди

Отговори на лист хартия:

  1. Остави 850-ката на 4001. Получил ли я е вече партньорът? Как би разбрал?
  2. 997 не носи номера на поръчката. С кой номер би го свързал с операцията на 4001? Потърси в таблицата operacion от infra/postgres/01-estado.sql коя колона пази този номер и от кой урок.
  3. Пристига един 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, който той цитира, е твой. Объркването им е най-честата грешка при корелиране и тя не се проваля шумно: просто не намира нищо.

Това, което не съответства, се записва и се съобщава. Потвърждение без собственик може да е грешка на партньора, старо изпращане или тест. Ако го изхвърлиш, го скриваш; ако го запишеш, оставяш някой да го разследва.

Упражнение: две потвърждения, два номера

  1. На хартия, с двата entrada.json от еталонните случаи, отговори за всеки 997: кой контролен номер цитира AK1? Кой е този на ISA? Приема ли, или отхвърля? Ако отхвърля, кой сегмент и коя стойност посочва?
  2. След като пуснеш ./verifica, провери таблицата с потвържденията: SELECT archivo, control_socio, grupo_control, codigo, operacion FROM acuse ORDER BY id; Кой от трите реда няма операция и защо?
  3. От трите канала в курса кой завършва в aceptada и кой в confirmada? Напиши по едно изречение за всеки, което обяснява защо това е неговият край.

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

Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:

  • 997 се корелира по групата и документа и само той потвърждава

Преговор

  1. Какво е 997 и кой го праща?
  2. Какво цитира AK1 и какво цитира AK2?
  3. Защо ISA13 на 997 не върши работа за корелиране?
  4. Какво става с 997, който не съответства на никоя операция? Защо не се изхвърля?
  5. Заключителният въпрос: „оставено“ и „потвърдено“ не са едно и също. Кой канал в курса кое очаква и защо API-то и ERP не очакват потвърждение?

Следва: в урок 22 SFTP на партньора пада и с повторните опити от урок 19 това спира също API-то и ERP. Как спираш да викаш паднала дестинация, без да спираш останалите?

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

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