Demande de conteneur et paiement

📦 CONTAINER INQUIRY WORKFLOW
│
├── 🔐 STEP 0: AUTHENTICATION (Pre-requisite)
│   ├── [User Not Authenticated]
│   │   └── → Redirect to Login/Register
│   └── [User Authenticated]
│       └── → Proceed to Step 1
│
├── 🔍 STEP 1: CONTAINER LOOKUP
│   ├── 1.1 Container Number Input
│   │   ├── Format: 4 Letters + 7 Numbers (e.g., TGHU1234567)
│   │   ├── Validation: Regex pattern check
│   │   └── API: GET /api/v1/operation/?container_number={number}
│   │
│   ├── 1.2 Pickup/Deposit Date Selection
│   │   ├── Date cannot be in past
│   │   ├── Validation: JavaScript date check
│   │   └── Storage calculation: Days between arrival & pickup
│   │
│   ├── 1.3 Container Status Check
│   │   ├── [Container Found] → Proceed to Step 2
│   │   ├── [Container Not Found] → Error message + retry
│   │   ├── [Container Already Released] → Warning + contact support
│   │   └── [API Error] → Error handling + retry
│   │
│   └── Decision Point: Continue to Step 2?
│       ├── [Yes] → Open Accordion 2
│       └── [No] → Stay on Step 1
│
├── 📋 STEP 2: STORAGE DETAILS & CHARGES
│   ├── 2.1 Container Information Display
│   │   ├── Container Number (from Step 1)
│   │   ├── Size/Type (20', 40', 40HC, etc.)
│   │   ├── Arrival Date (from TOS API)
│   │   ├── Pickup/Deposit Date (user selected)
│   │   └── Storage Days Calculation
│   │
│   ├── 2.2 Pricing Calculation
│   │   ├── API: GET /api/v1/pricing/?container={number}&days={count}
│   │   ├── Daily Storage Rate ($25/day example)
│   │   ├── Total Storage Charges
│   │   ├── Guarantee Letter Fee (if applicable)
│   │   └── Grand Total
│   │
│   ├── 2.3 Legal Terms & Conditions
│   │   ├── Modal: Termont Legal Notice (Step-33)
│   │   ├── Checkbox: "I accept terms and conditions"
│   │   └── Validation: Must check before proceeding
│   │
│   ├── 2.4 Support Contact Information
│   │   ├── Phone: 1-800-TERMONT
│   │   ├── Email: support@termont.com
│   │   └── Business Hours display
│   │
│   └── Decision Point: Confirm charges & proceed?
│       ├── [Yes] → Open Accordion 3
│       ├── [No - Need Support] → Contact support flow
│       └── [Cancel] → Return to Step 1
│
├── 💳 STEP 3: MULTI-STAKEHOLDER PAYMENT
│   ├── 3.1 Payment Policy Check
│   │   ├── Tier 1/2 Customers (90%)
│   │   │   ├── Payment required within 2 hours
│   │   │   └── All stakeholders must pay before appointment
│   │   │
│   │   └── Contractual Customers (10%)
│   │       ├── Deferred payment (weekly/monthly)
│   │       └── Appointment immediately available
│   │
│   ├── 3.2 Stakeholder Configuration
│   │   ├── Number of Payers (1-5)
│   │   ├── Stakeholder Types:
│   │   │   ├── Forwarder (default)
│   │   │   ├── Shipping Line
│   │   │   ├── Industrial
│   │   │   └── Other
│   │   │
│   │   ├── Payment Split Percentage
│   │   │   ├── Manual allocation (must total 100%)
│   │   │   ├── Validation: Sum = 100%
│   │   │   └── Amount per stakeholder calculated
│   │   │
│   │   └── Contact Information per Stakeholder
│   │       ├── Company Name
│   │       ├── Email (for payment notification)
│   │       └── Phone (optional)
│   │
│   ├── 3.3 Payment Method Selection (per Stakeholder)
│   │   ├── [Credit Card - Moneris]
│   │   │   ├── Card Number (encrypted)
│   │   │   ├── Expiry Date
│   │   │   ├── CVV (not stored)
│   │   │   ├── Billing Address
│   │   │   └── API: POST /api/v1/payment/process/
│   │   │
│   │   ├── [Invoice on Account]
│   │   │   ├── Only for contractual customers
│   │   │   ├── Credit check required
│   │   │   └── Terms: NET 30/60/90 days
│   │   │
│   │   └── [Account Credit]
│   │       ├── Check available balance
│   │       ├── Deduct from wallet
│   │       └── API: POST /api/v1/wallet/deduct/
│   │
│   ├── 3.4 WooCommerce Integration
│   │   ├── Create WooCommerce products (per stakeholder)
│   │   ├── Product SKU: STORAGE-{container}-{stakeholder}
│   │   ├── Product Price: Allocated amount
│   │   ├── Product Category: Container Storage
│   │   └── API: GET /api/v1/woocommerce/products/
│   │
│   ├── 3.5 Payment Processing Flow
│   │   ├── Loop: For each stakeholder
│   │   │   ├── Validate payment method
│   │   │   ├── Process payment (Moneris API)
│   │   │   ├── [Payment Success]
│   │   │   │   ├── Generate receipt PDF
│   │   │   │   ├── Send email confirmation
│   │   │   │   └── Mark stakeholder as "Paid"
│   │   │   │
│   │   │   └── [Payment Failed]
│   │   │       ├── Show error message
│   │   │       ├── Retry option (3 attempts)
│   │   │       └── Alternative payment method
│   │   │
│   │   ├── Validation: All stakeholders paid?
│   │   │   ├── [Yes] → Proceed to Step 4
│   │   │   └── [No] → Cannot proceed (pending payments)
│   │   │
│   │   └── Payment Timeout Handling
│   │       ├── Timer: 2 hours for Tier 1/2
│   │       ├── Warning at 1h 45min
│   │       └── Auto-cancel if timeout
│   │
│   └── Decision Point: All payments complete?
│       ├── [Yes] → Open Accordion 4
│       ├── [No - Pending] → Wait for all stakeholders
│       └── [Failed] → Retry or cancel workflow
│
├── ✍️ STEP 4: GUARANTEE LETTER SIGNATURE
│   ├── 4.1 Generate Guarantee Letter PDF
│   │   ├── Template: Termont standard format
│   │   ├── Data: Container #, dates, charges, stakeholders
│   │   ├── Generate unique document ID
│   │   └── Store in: /uploads/guarantees/{year}/{month}/
│   │
│   ├── 4.2 DocuSign Integration
│   │   ├── API: POST /api/v1/docusign/send-envelope/
│   │   ├── Envelope creation with PDF
│   │   ├── Signer configuration (per container)
│   │   │   ├── Primary signer (workflow initiator)
│   │   │   ├── Additional signers (stakeholders)
│   │   │   └── Email notification sent
│   │   │
│   │   └── Signature workflow tracking
│   │       ├── Status: Sent → Delivered → Viewed → Signed
│   │       ├── Reminders: Auto-send after 24h/48h
│   │       └── Expiration: 7 days default
│   │
│   ├── 4.3 Signature Status Monitoring
│   │   ├── [All Signed] → Proceed to Step 5
│   │   ├── [Partial Signed] → Wait for remaining
│   │   ├── [Declined] → Workflow cancelled
│   │   └── [Expired] → Resend envelope
│   │
│   └── Decision Point: All signatures complete?
│       ├── [Yes] → Open Accordion 5
│       ├── [No - Pending] → Display waiting status
│       └── [Declined/Expired] → Error handling
│
├── ✅ STEP 5: CONFIRMATION & CARRIX SYNC
│   ├── 5.1 Final Summary Display
│   │   ├── Container Information
│   │   ├── Payment Summary (all stakeholders)
│   │   ├── Guarantee Letter (PDF download)
│   │   ├── Signature Status (all signers)
│   │   └── Appointment Details (if scheduled)
│   │
│   ├── 5.2 Carrix System Synchronization
│   │   ├── API: POST /api/v1/carrix/sync-release/
│   │   ├── Release Order Number generation
│   │   ├── Gate Pass creation
│   │   ├── Notification to terminal ops
│   │   └── Status: Approved for pickup
│   │
│   ├── 5.3 Appointment Scheduling (Step-39)
│   │   ├── Available Time Slots query
│   │   ├── Terminal capacity check
│   │   ├── Appointment booking confirmation
│   │   └── SMS/Email confirmation
│   │
│   ├── 5.4 Multi-Party Notifications
│   │   ├── Email to all stakeholders
│   │   │   ├── Payment confirmation
│   │   │   ├── Guarantee letter attached
│   │   │   ├── Appointment details
│   │   │   └── Next steps instructions
│   │   │
│   │   ├── SMS to driver (if provided)
│   │   │   ├── Gate pass number
│   │   │   ├── Appointment time
│   │   │   └── Terminal location
│   │   │
│   │   └── Internal notifications
│   │       ├── Terminal operations team
│   │       ├── Accounting (payment received)
│   │       └── Customer service (workflow complete)
│   │
│   ├── 5.5 Receipt & Documentation
│   │   ├── Combined receipt PDF (all payments)
│   │   ├── Guarantee letter PDF (signed)
│   │   ├── Gate pass document
│   │   ├── Email delivery to all parties
│   │   └── Archive in customer portal
│   │
│   └── Final Outcome
│       ├── [Success] → Workflow complete
│       │   ├── Container approved for release
│       │   ├── All documents delivered
│       │       ├── Appointment confirmed
│       │   └── Carrix system updated
│       │
│       └── [Partial Success] → Manual follow-up
│           ├── Payments complete but Carrix sync failed
│           ├── Alert operations team
│           └── Manual release process
│
└── 🔄 ERROR HANDLING & EDGE CASES
    ├── API Timeouts
    │   ├── Retry logic (3 attempts, exponential backoff)
    │   ├── Fallback to manual process
    │   └── Error logging to admin panel
    │
    ├── Payment Failures
    │   ├── Decline codes handling (insufficient funds, etc.)
    │   ├── Alternative payment methods offered
    │   ├── Wallet credit for failed payments (Step-41)
    │   └── Refund processing if partial failure
    │
    ├── Signature Issues
    │   ├── Email delivery failures (bounce handling)
    │   ├── Signer unavailable (delegate option)
    │   ├── Document amendment requests
    │   └── Manual signature upload option
    │
    ├── Appointment Conflicts
    │   ├── No available slots → Waitlist
    │   ├── Terminal closure → Reschedule
    │   ├── Weather delays → Auto-notification
    │   └── Customer no-show → Cancellation fee
    │
    └── System Integration Failures
        ├── TOS API down → Cached data fallback
        ├── Carrix unreachable → Queue for sync
        ├── DocuSign service disruption → Email fallback
        └── WooCommerce issues → Direct payment gateway