Vendor Invoices — business view

Technical trace: Vendor Invoices

1. Business Summary

Generated from completed/verified tasks. Line items represent tasks with rates, units, taxes, and SAP distribution rules. SAP-synced AP documents.

2. Business Value

Pays vendors; matches cost to revenue.

3. Users / Stakeholders

Finance, vendor managers, vendors.

4. Workflows

  • Eligible tasks (closed/verified) → Vendor Invoice.
  • Internal submit → eligible to sync.
  • SAP sync if within the configured eligibility window and not yet posted.

5. Sub-Features

  • Distribution rules driven by language group/region.
  • Resource type/SAP-employee mapping.
  • Tax-group mapping with default fallback.

6. Business Rules

  • Only verified tasks eligible.
  • Brand-specific behaviors for taxes and templates.
  • Submitted-and-not-yet-posted gating.

7. Data Entities

Vendor Invoice, Vendor Invoice Detail.

8. Entry Points

  • Finance vendor invoice screens; common submit; SAP sync.

9. Inputs & Outputs

  • Inputs: tasks, vendor, rates.
  • Outputs: AP records, SAP postings.

10. Integrations

  • SAP.

11. Calculations / Logic

  • Total = cost × amount; minimum-charge override; discount %; deduction %; extra-fees addition; effective discount % derivation; calculated unit price.

12. Status Lifecycle

  • Draft → submitted → SAP-posted → paid.

13. Permissions

  • Finance, brand-scoped.

14. Reports & KPIs

  • Vendor cost, tax exposure, productivity vs. cost.

15. Risks & Observations

  • Calculation precedence is subtle (min-charge before discount/deduction); a misconfigured parameter quietly shifts vendor pay.
  • SAP date cutoff is hard-coded — historical data excluded.

16. Source Code Evidence

  • app/Plugin/finance/Model/{VendorInvoice, VendorInvoiceDetail}.php.

← Deep dives index