phase, plan, subsystem, tags, requires, provides, affects, tech-stack, key-files, key-decisions, patterns-established, duration, started, completed
| phase |
plan |
subsystem |
tags |
requires |
provides |
affects |
tech-stack |
key-files |
key-decisions |
patterns-established |
duration |
started |
completed |
| 86-apaczka-cod-bank-account |
01 |
shipments |
|
|
| Apaczka COD shipments include bank account number from company settings |
|
|
|
| created |
modified |
|
|
| src/Modules/Shipments/ApaczkaShipmentService.php |
|
|
| Field name `bankaccount` per Apaczka API v2 docs (not `bank_account_number`) |
| Strip all non-digit chars from bank account (handles PL prefix and spaces) |
|
|
~15min |
2026-04-08T00:00:00Z |
2026-04-08T00:00:00Z |
Phase 86 Plan 01: Apaczka COD Bank Account Summary
Naprawiono blad API Apaczka przy tworzeniu przesylki COD — dodano pole bankaccount z numerem konta z ustawien firmy do payloadu COD.
Performance
| Metric |
Value |
| Duration |
~15min |
| Tasks |
1 completed |
| Files modified |
1 |
Acceptance Criteria Results
| Criterion |
Status |
Notes |
| AC-1: Payload COD zawiera numer konta bankowego |
Pass |
Pole bankaccount z 26 cyframi z company_settings |
| AC-2: Brak konta = czytelny blad |
Pass |
ShipmentException z komunikatem o uzupelnieniu konta |
Accomplishments
- Naprawiono blad API Apaczka "Wprowadzono niepoprawny numer konta bankowego w usludze pobranie"
- Payload COD zawiera pole
bankaccount z numerem konta oczyszczonym do samych cyfr
- Brak numeru konta w ustawieniach firmy rzuca czytelny ShipmentException
Files Created/Modified
| File |
Change |
Purpose |
src/Modules/Shipments/ApaczkaShipmentService.php |
Modified |
Dodano bankaccount do payloadu COD + walidacje braku konta |
Decisions Made
| Decision |
Rationale |
Impact |
Pole bankaccount zamiast bank_account_number |
Oficjalna dokumentacja Apaczka API v2 definiuje pole jako bankaccount (bez underscore) |
Poprawne dzialanie COD |
preg_replace('/[^0-9]/', '') do czyszczenia numeru konta |
Numer w bazie zawiera prefix PL i spacje (PL22 2530...), API wymaga 26 cyfr |
Uniwersalne czyszczenie dowolnego formatu IBAN |
Deviations from Plan
Summary
| Type |
Count |
Impact |
| Auto-fixed |
1 |
Krytyczne — bledna nazwa pola API |
Auto-fixed Issues
1. Bledna nazwa pola API bank_account_number -> bankaccount
- Found during: Testowanie na serwerze produkcyjnym
- Issue: Pole
bank_account_number nie jest rozpoznawane przez Apaczka API v2
- Fix: Zmieniono na
bankaccount zgodnie z oficjalna dokumentacja API
- Verification: Uzytkownik potwierdzil poprawne tworzenie przesylki COD
Issues Encountered
| Issue |
Resolution |
uploadOnSave: false — plik nie synchronizowal sie automatycznie z serwerem |
Reczny upload przez FTP curl |
| Numer konta w bazie z prefixem PL i spacjami |
Regex [^0-9] usuwa wszystko poza cyframi |
Nazwa pola API bank_account_number niepoprawna |
Sprawdzono oficjalna dokumentacje — prawidlowe pole to bankaccount |
Next Phase Readiness
Ready:
- Przesylki COD przez Apaczke dzialaja poprawnie
Concerns:
Blockers:
Phase: 86-apaczka-cod-bank-account, Plan: 01
Completed: 2026-04-08
