dart_aps_sftp_file_collector

APS sftp file collector.

Project folder: dart_aps_sftp_file_collector/

All relative paths in the documentation are relative to this folder unless stated otherwise.

Documentation

README.md and CHANGELOG.md stay in the project root. All other project documentation lives under doc/.

• CHANGELOG.md
• doc/DPD_TROUBLESHOOTING.md
• doc/IMPLEMENTATION_SUMMARY.md
• doc/DELAYED_UPLOAD_FEATURE.md
• doc/PARCEL_BUNDLING_FEATURE.md
• doc/SFTP_GUARD_FEATURE.md

DPD troubleshooting

When a label PDF is generated but a shipment is hard to find in the DPD portal, check these sources in order:

1. LOCAL_ORDERS_PATH/<orderId>/shipping_labels/ for the generated parcel label number.
2. LOCAL_ORDERS_PATH/<orderId>/dpd_requests/ for the archived outbound storeOrders SOAP request.
3. LOCAL_ORDERS_PATH/<orderId>/logs/ for the order-specific processing log.
4. tool/check_dpd_tracking.dart to query the DPD parcel lifecycle service with a known parcel label number.

Example:

dart run tool/check_dpd_tracking.dart 05162997316739

See doc/DPD_TROUBLESHOOTING.md for the full troubleshooting flow.

Order output structure

For every processed order the app stores a dedicated folder under LOCAL_ORDERS_PATH/<orderId>/.

• xml/: copied source XML for that order.
• artwork/: copied artwork/input files for that order.
• spreadsheet/: generated spreadsheet output.
• shipping_labels/: generated DPD label PDFs.
• confirmation/: generated APS confirmation XML.
• dpd_requests/: archived outbound DPD XML requests for lookup/debugging.
• logs/: the order-specific log excerpt captured from the normal application log for just that order.

Changelog

0.1.2 - 2026-05-12

Added

• Added tool/check_dpd_tracking.dart to query the DPD parcel lifecycle service for a parcel label number using the Akzo production environment configuration.

Changed

• Updated README.md with a troubleshooting section for DPD request archives, order logs, and the parcel tracking lookup helper.
• Added doc/DPD_TROUBLESHOOTING.md with a focused guide for verifying DPD requests, archived labels, order logs, and Insights visibility checks.

0.1.1 - 2026-05-12

Added

• Added per-order archiving of outbound DPD request XML files in dpd_requests/.
• Added per-order log excerpts in logs/ alongside each order for easier troubleshooting.
• Added runtime SFTP environment resolution so the active SFTP connection can be configured independently from the DPD test/live mode.

Changed

• Changed DPD request archiving to capture the final logged SOAP request when available and to preserve the authentication token in archived fallback requests.
• Changed archived DPD request XML output to normalize empty elements to self-closing tags for readability.
• Changed SFTP guard handling to default to the active SFTP environment, allow test-mode guard opt-in explicitly, and include the active host and username in warnings.

0.1.0 - 2026-05-11

Added

• Added delayed confirmation uploads that can be scheduled per client environment.
• Added SFTP safeguard handling for password expiry warnings and circuit-breaker based login blocking.
• Added configurable parcel bundling, including a local bundled-parcel preview runner.

Changed

• Changed bundled DPD parcel references to use the order ID in customerReferenceNumber1, the first item volume for volume, and a summary in customerReferenceNumber4 when more than three items are bundled.
• Changed the DPD parcel logging so the effective references, volume, and weight are visible before the shipment request is sent.

0.0.21 - 2026-05-04

Changed

• Changed excel to excel_cummunity because excel seems unmaintained.

0.0.20 - 2026-04-28

Changed

• Version bump from 0.0.19 to 0.0.20 (test -> 1.31.1 (was 1.31.0)).

0.0.19 - 2026-03-23

Changed

• Version bump from 0.0.18 to 0.0.19 (test -> 1.31.0 (was 1.30.0)).

0.0.18 - 2026-03-23

Changed

• Version bump from 0.0.17 to 0.0.18 (csv -> 8.0.0 (was 6.0.0)).

0.0.17 - 2026-02-27

Changed

• Version bump from 0.0.16 to 0.0.17 (test -> 1.30.0 (was 1.29.0)).

0.0.16 - 2026-02-25

Changed

• Version bump from 0.0.15 to 0.0.16 (mailer -> 7.1.0 (was 6.6.0)).

0.0.15 - 2026-02-02

Changed

• Version bump from 0.0.14 to 0.0.15 (lints -> 6.1.0 (was 6.0.0)).

0.0.14 - 2026-01-08

Changed

• Version bump from 0.0.13 to 0.0.14 (test -> 1.29.0 (was 1.28.0)).

0.0.13 - 2025-11-21

Changed

• Version bump from 0.0.12 to 0.0.13 (test -> 1.28.0 (was 1.27.0)).

0.0.12 - 2025-11-11

Changed

• Version bump from 0.0.11 to 0.0.12 (test -> 1.27.0 (was 1.26.3)).

0.0.11 - 2025-11-10

Changed

• Version bump from 0.0.10 to 0.0.11 (http -> 1.6.0 (was 1.5.0)).

0.0.10 - 2025-10-31

Changed

• Version bump from 0.0.9 to 0.0.10 (mailer -> 6.6.0 (was 6.5.0)).

0.0.9 - 2025-10-10

Added

• Missing executables section in pubspec.yaml.

0.0.8 - 2025-09-16

Changed

• Version bump from 0.0.7 to 0.0.8 (xml -> 6.6.1 (was 6.5.0)).

0.0.7 - 2025-08-08

Changed

• Version bump from 0.0.6 to 0.0.7 (http -> 1.5.0 (was 1.4.0)).

0.0.6 - 2025-07-28

Changed

• Version bump from 0.0.5 to 0.0.6 (mailer -> 6.5.0 (was 6.4.1)).

0.0.5 - 2025-07-23

Changed

• Version bump from 0.0.4 to 0.0.5 (test -> 1.26.3 (was 1.26.2)).

0.0.4 - 2025-06-24

Changed

• Version bump from 0.0.3 to 0.0.4 (xml -> 6.5.0 (was 6.6.0)).

0.0.3 - 2025-05-25

Changed

• Version bump from 0.0.2 to 0.0.3 (lints -> 6.0.0 (was 5.0.0)).

0.0.2 - 2025-05-25

Changed

• Version bump from 0.0.1 to 0.0.2 (test -> 1.26.2 (was 1.24.0)).

0.0.1 - 2025-05-23

• Initial version.