ERP/reference sync

ERP/reference sync#

1. Reference datasets#

  • контрагенты и перевозчики;

  • транспорт и прицепы;

  • справочник грузов;

  • рейсы (trip_reference);

  • внешние документы (external_ref).

2. Входящий reference sync#

  • QR, RFID и ERP import могут заполнить trip_reference, cargo_reference, driver_card_id, trailer_plate;

  • reference sync допускается до первой фазы, между фазами и перед финальным close;

  • отсутствие reference data не блокирует автоматическое взвешивание, но не позволяет считать handover пакет полным.

3. Исходящий export карточки#

  • export unit: одна weigh_session с двумя фазами и ссылками на identity, media и alarm evidence;

  • обязательные поля: session_id, vehicle_plate, lane_id, direction, tare_kg, gross_kg, net_kg, trip_reference, external_ref, close_reason, review_reason;

  • export state фиксируется как erp_state=pending|synced.

4. Ошибки и retry#

  • ошибки ERP sync попадают в offline-queue как session-owned entity;

  • повторный erp-sync остается идемпотентным;

  • при manual_review export допустим только с review_reason и ссылкой на evidence bundle.

5. Owner rule#

  • weighbridge владеет cycle state, interlock и evidence;

  • ERP владеет внешними reference identifiers;

  • конфликт по trip_reference разрешается в пользу последнего подтвержденного external source с audit trail.

Содержание